Artifact 93353cd4196d1ff302d035ba7153e926102ca2d3:
File www/quickstart.html part of check-in [bbbee5fc37] - Update the website to include links to the download page. by drh on 2008-03-17 21:21:18.
0000: 3c 68 74 6d 6c 3e 0a 3c 74 69 74 6c 65 3e 46 6f <html>.<title>Fo 0010: 73 73 69 6c 20 2d 20 51 75 69 63 6b 20 53 74 61 ssil - Quick Sta 0020: 72 74 3c 2f 74 69 74 6c 65 3e 0a 3c 62 6f 64 79 rt</title>.<body 0030: 20 62 67 63 6f 6c 6f 72 3d 22 77 68 69 74 65 22 bgcolor="white" 0040: 3e 0a 3c 70 3e 5b 20 3c 61 20 68 72 65 66 3d 22 >.<p>[ <a href=" 0050: 69 6e 64 65 78 2e 68 74 6d 6c 22 3e 49 6e 64 65 index.html">Inde 0060: 78 3c 2f 61 3e 20 5d 3c 2f 70 3e 0a 3c 68 72 3e x</a> ]</p>.<hr> 0070: 0a 3c 68 31 20 61 6c 69 67 6e 3d 22 63 65 6e 74 .<h1 align="cent 0080: 65 72 22 3e 46 6f 73 73 69 6c 20 51 75 69 63 6b er">Fossil Quick 0090: 20 53 74 61 72 74 3c 2f 68 31 3e 0a 0a 3c 70 3e Start</h1>..<p> 00a0: 54 68 69 73 20 69 73 20 61 20 67 75 69 64 65 20 This is a guide 00b0: 74 6f 20 67 65 74 20 79 6f 75 20 73 74 61 72 74 to get you start 00c0: 65 64 20 75 73 69 6e 67 20 66 6f 73 73 69 6c 20 ed using fossil 00d0: 71 75 69 63 6b 6c 79 0a 61 6e 64 20 70 61 69 6e quickly.and pain 00e0: 6c 65 73 73 6c 79 2e 3c 2f 70 3e 0a 0a 3c 68 32 lessly.</p>..<h2 00f0: 3e 49 6e 73 74 61 6c 6c 69 6e 67 3c 2f 68 32 3e >Installing</h2> 0100: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 <blockquote>.. 0110: 20 20 3c 70 3e 46 6f 73 73 69 6c 20 69 73 20 61 <p>Fossil is a 0120: 20 73 69 6e 67 6c 65 20 73 65 6c 66 2d 63 6f 6e single self-con 0130: 74 61 69 6e 65 64 20 43 20 70 72 6f 67 72 61 6d tained C program 0140: 2e 20 20 59 6f 75 20 6e 65 65 64 20 74 6f 0a 20 . You need to. 0150: 20 20 20 65 69 74 68 65 72 20 64 6f 77 6e 6c 6f either downlo 0160: 61 64 20 61 20 3c 61 20 68 72 65 66 3d 22 64 6f ad a <a href="do 0170: 77 6e 6c 6f 61 64 2e 68 74 6d 6c 22 3e 70 72 65 wnload.html">pre 0180: 63 6f 6d 70 69 6c 65 64 20 62 69 6e 61 72 79 3c compiled binary< 0190: 2f 61 3e 0a 20 20 20 20 6f 72 20 3c 61 20 68 72 /a>. or <a hr 01a0: 65 66 3d 22 62 75 69 6c 64 2e 68 74 6d 6c 22 3e ef="build.html"> 01b0: 62 75 69 6c 64 20 69 74 20 79 6f 75 72 73 65 6c build it yoursel 01c0: 66 3c 2f 61 3e 20 66 72 6f 6d 20 73 6f 75 72 63 f</a> from sourc 01d0: 65 73 2e 0a 20 20 20 20 49 6e 73 74 61 6c 6c 20 es.. Install 01e0: 66 6f 73 73 69 6c 20 62 79 20 70 75 74 74 69 6e fossil by puttin 01f0: 67 20 74 68 65 20 66 6f 73 73 69 6c 20 62 69 6e g the fossil bin 0200: 61 72 79 0a 20 20 20 20 73 6f 6d 65 70 6c 61 63 ary. someplac 0210: 65 20 6f 6e 20 79 6f 75 72 20 50 41 54 48 20 65 e on your PATH e 0220: 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 nvironment varia 0230: 62 6c 65 2e 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 ble.</p>. . 0240: 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a </blockquote>. 0250: 20 20 20 20 3c 68 32 3e 43 6c 6f 6e 69 6e 67 20 <h2>Cloning 0260: 41 20 45 78 69 73 74 69 6e 67 20 52 65 70 6f 73 A Existing Repos 0270: 69 74 6f 72 79 3c 2f 68 32 3e 0a 20 20 20 20 3c itory</h2>. < 0280: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 blockquote>. 0290: 0a 20 20 20 20 3c 70 3e 55 73 65 20 74 68 69 73 . <p>Use this 02a0: 20 63 6f 6d 6d 61 6e 64 3a 3c 2f 70 3e 0a 20 20 command:</p>. 02b0: 20 20 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f . <blockquo 02c0: 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 te>. <b>fossi 02d0: 6c 20 63 6c 6f 6e 65 3c 2f 62 3e 20 3c 69 3e 55 l clone</b> <i>U 02e0: 52 4c 20 20 72 65 70 6f 73 69 74 6f 72 79 2d 66 RL repository-f 02f0: 69 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 ilename</i>. 0300: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 </blockquote>. 0310: 20 20 0a 20 20 20 20 3c 70 3e 54 68 65 20 3c 69 . <p>The <i 0320: 3e 55 52 4c 3c 2f 69 3e 20 61 62 6f 76 65 20 69 >URL</i> above i 0330: 73 20 74 68 65 20 68 74 74 70 20 55 52 4c 20 66 s the http URL f 0340: 6f 72 20 74 68 65 20 66 6f 73 73 69 6c 20 72 65 or the fossil re 0350: 70 6f 73 69 74 6f 72 79 0a 20 20 20 20 79 6f 75 pository. you 0360: 20 77 61 6e 74 20 74 6f 20 63 6c 6f 6e 65 2e 20 want to clone. 0370: 20 59 6f 75 20 63 61 6e 20 63 61 6c 6c 20 74 68 You can call th 0380: 65 20 6e 65 77 20 72 65 70 6f 73 69 74 6f 72 79 e new repository 0390: 20 61 6e 79 74 68 69 6e 67 20 79 6f 75 0a 20 20 anything you. 03a0: 20 20 77 61 6e 74 20 2d 20 74 68 65 72 65 20 61 want - there a 03b0: 72 65 20 6e 6f 20 6e 61 6d 69 6e 67 20 72 65 73 re no naming res 03c0: 74 72 69 63 74 69 6f 6e 73 2e 20 20 41 73 20 61 trictions. As a 03d0: 6e 20 65 78 61 6d 70 6c 65 2c 20 79 6f 75 20 63 n example, you c 03e0: 61 6e 0a 20 20 20 20 63 6c 6f 6e 65 20 74 68 65 an. clone the 03f0: 20 66 6f 73 73 69 6c 20 72 65 70 6f 73 69 74 6f fossil reposito 0400: 72 79 20 74 68 69 73 20 77 61 79 3a 3c 2f 70 3e ry this way:</p> 0410: 0a 20 20 20 20 0a 20 20 20 20 3c 62 6c 6f 63 6b . . <block 0420: 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f quote>. <b>fo 0430: 73 73 69 6c 20 63 6c 6f 6e 65 20 68 74 74 70 3a ssil clone http: 0440: 2f 2f 66 6f 73 73 69 6c 2d 73 63 6d 2e 68 77 61 //fossil-scm.hwa 0450: 63 69 2e 63 6f 6d 2f 66 6f 73 73 69 6c 20 6d 79 ci.com/fossil my 0460: 63 6c 6f 6e 65 2e 66 73 6c 3c 2f 62 3e 0a 20 20 clone.fsl</b>. 0470: 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a </blockquote>. 0480: 20 20 20 20 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 .</blockquot 0490: 65 3e 3c 68 32 3e 53 74 61 72 74 69 6e 67 20 41 e><h2>Starting A 04a0: 20 4e 65 77 20 50 72 6f 6a 65 63 74 3c 2f 68 32 New Project</h2 04b0: 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 ><blockquote>.. 04c0: 20 20 20 3c 70 3e 54 6f 20 73 74 61 72 74 20 61 <p>To start a 04d0: 20 6e 65 77 20 70 72 6f 6a 65 63 74 20 77 69 74 new project wit 04e0: 68 20 66 6f 73 73 69 6c 2c 20 63 72 65 61 74 65 h fossil, create 04f0: 20 61 20 6e 65 77 20 65 6d 70 74 79 20 72 65 70 a new empty rep 0500: 6f 73 69 74 6f 72 79 0a 20 20 20 20 74 68 69 73 ository. this 0510: 20 77 61 79 3a 3c 2f 70 3e 0a 20 20 20 20 0a 20 way:</p>. . 0520: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a <blockquote>. 0530: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6e 65 <b>fossil ne 0540: 77 20 3c 2f 62 3e 3c 69 3e 20 72 65 70 6f 73 69 w </b><i> reposi 0550: 74 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 tory-filename</i 0560: 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f >. </blockquo 0570: 74 65 3e 0a 20 20 20 20 0a 3c 2f 62 6c 6f 63 6b te>. .</block 0580: 71 75 6f 74 65 3e 3c 68 32 3e 43 6f 6e 66 69 67 quote><h2>Config 0590: 75 72 69 6e 67 20 59 6f 75 72 20 4c 6f 63 61 6c uring Your Local 05a0: 20 52 65 70 6f 73 69 74 6f 72 79 3c 2f 68 32 3e Repository</h2> 05b0: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 <blockquote>. 05c0: 20 0a 20 20 20 20 3c 70 3e 57 68 65 6e 20 79 6f . <p>When yo 05d0: 75 20 63 72 65 61 74 65 20 61 20 6e 65 77 20 72 u create a new r 05e0: 65 70 6f 73 69 74 6f 72 79 2c 20 65 69 74 68 65 epository, eithe 05f0: 72 20 62 79 20 63 6c 6f 6e 69 6e 67 20 61 6e 20 r by cloning an 0600: 65 78 69 73 74 69 6e 67 0a 20 20 20 20 70 72 6f existing. pro 0610: 6a 65 63 74 20 6f 72 20 63 72 65 61 74 65 20 61 ject or create a 0620: 20 6e 65 77 20 70 72 6f 6a 65 63 74 20 6f 66 20 new project of 0630: 79 6f 75 72 20 6f 77 6e 2c 20 79 6f 75 20 75 73 your own, you us 0640: 75 61 6c 6c 79 20 77 61 6e 74 20 74 6f 20 64 6f ually want to do 0650: 20 73 6f 6d 65 0a 20 20 20 20 6c 6f 63 61 6c 20 some. local 0660: 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 20 20 configuration. 0670: 54 68 69 73 20 69 73 20 61 63 63 6f 6d 70 6c 69 This is accompli 0680: 73 68 65 64 20 75 73 69 6e 67 20 61 20 77 65 62 shed using a web 0690: 62 72 6f 77 73 65 72 2e 20 20 46 69 72 73 74 0a browser. First. 06a0: 20 20 20 20 73 74 61 72 74 20 61 20 66 6f 73 73 start a foss 06b0: 69 6c 20 77 65 62 73 65 72 76 65 72 20 6c 69 6b il webserver lik 06c0: 65 20 74 68 69 73 3a 3c 2f 70 3e 0a 20 20 20 20 e this:</p>. 06d0: 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 . <blockquote 06e0: 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 >. <b>fossil 06f0: 73 65 72 76 65 72 20 3c 2f 62 3e 3c 69 3e 20 72 server </b><i> r 0700: 65 70 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e 61 epository-filena 0710: 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f me</i>. </blo 0720: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 ckquote>.. <p 0730: 3e 54 68 69 73 20 63 72 65 61 74 65 73 20 61 20 >This creates a 0740: 6d 69 6e 69 2d 77 65 62 73 65 72 76 65 72 20 6c mini-webserver l 0750: 69 73 74 65 6e 69 6e 67 20 6f 6e 20 70 6f 72 74 istening on port 0760: 20 38 30 38 30 2e 20 20 59 6f 75 20 63 61 6e 0a 8080. You can. 0770: 20 20 20 20 73 70 65 63 69 66 79 20 61 20 64 69 specify a di 0780: 66 66 65 72 65 6e 74 20 70 6f 72 74 20 75 73 69 fferent port usi 0790: 6e 67 20 74 68 65 20 3c 62 3e 2d 70 6f 72 74 3c ng the <b>-port< 07a0: 2f 62 3e 20 6f 70 74 69 6f 6e 20 6f 6e 20 74 68 /b> option on th 07b0: 65 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 2e 0a e command-line.. 07c0: 20 20 20 20 41 66 74 65 72 20 74 68 65 20 73 65 After the se 07d0: 72 76 65 72 20 69 73 20 72 75 6e 6e 69 6e 67 2c rver is running, 07e0: 20 70 6f 69 6e 74 20 79 6f 75 72 20 77 65 62 62 point your webb 07f0: 72 6f 77 73 65 72 20 61 74 0a 20 20 20 20 68 74 rowser at. ht 0800: 74 70 3a 2f 2f 6c 6f 63 61 6c 68 6f 73 74 3a 38 tp://localhost:8 0810: 30 38 30 2f 20 61 6e 64 20 73 74 61 72 74 20 63 080/ and start c 0820: 6f 6e 66 69 67 75 72 69 6e 67 2e 3c 2f 70 3e 0a onfiguring.</p>. 0830: 20 20 20 20 0a 20 20 20 20 3c 70 3e 42 79 20 64 . <p>By d 0840: 65 66 61 75 6c 74 2c 20 66 6f 73 73 69 6c 20 64 efault, fossil d 0850: 6f 65 73 20 6e 6f 74 20 72 65 71 75 69 72 65 20 oes not require 0860: 61 20 6c 6f 67 69 6e 20 66 6f 72 20 48 54 54 50 a login for HTTP 0870: 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 0a 20 20 20 connections. 0880: 20 63 6f 6d 69 6e 67 20 69 6e 20 66 72 6f 6d 20 coming in from 0890: 74 68 65 20 49 50 20 6c 6f 6f 70 62 61 63 6b 20 the IP loopback 08a0: 61 64 64 72 65 73 73 20 31 32 37 2e 30 2e 30 2e address 127.0.0. 08b0: 31 2e 20 20 59 6f 75 20 63 61 6e 2c 20 61 6e 64 1. You can, and 08c0: 20 70 65 72 68 61 70 73 0a 20 20 20 20 73 68 6f perhaps. sho 08d0: 75 6c 64 2c 20 63 68 61 6e 67 65 20 74 68 69 73 uld, change this 08e0: 20 61 66 74 65 72 20 79 6f 75 20 63 72 65 61 74 after you creat 08f0: 65 20 61 20 66 65 77 20 75 73 65 72 73 2e 3c 2f e a few users.</ 0900: 70 3e 0a 20 20 20 20 0a 20 20 20 20 3c 70 3e 57 p>. . <p>W 0910: 68 65 6e 20 79 6f 75 20 61 72 65 20 66 69 6e 69 hen you are fini 0920: 73 68 65 64 20 63 6f 6e 66 69 67 75 72 69 6e 67 shed configuring 0930: 2c 20 6a 75 73 74 20 70 72 65 73 73 20 43 6f 6e , just press Con 0940: 74 72 6f 6c 2d 43 20 6f 72 20 75 73 65 0a 20 20 trol-C or use. 0950: 20 20 74 68 65 20 3c 62 3e 6b 69 6c 6c 3c 2f 62 the <b>kill</b 0960: 3e 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 73 68 75 > command to shu 0970: 74 20 64 6f 77 6e 20 74 68 65 20 6d 69 6e 69 2d t down the mini- 0980: 73 65 72 76 65 72 2e 3c 2f 70 3e 0a 0a 3c 2f 62 server.</p>..</b 0990: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 43 68 lockquote><h2>Ch 09a0: 65 63 6b 69 6e 67 20 4f 75 74 20 41 20 4c 6f 63 ecking Out A Loc 09b0: 61 6c 20 54 72 65 65 3c 2f 68 32 3e 3c 62 6c 6f al Tree</h2><blo 09c0: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 ckquote>.. <p 09d0: 3e 54 6f 20 77 6f 72 6b 20 6f 6e 20 61 20 70 72 >To work on a pr 09e0: 6f 6a 65 63 74 20 69 6e 20 66 6f 73 73 69 6c 2c oject in fossil, 09f0: 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 63 68 65 you need to che 0a00: 63 6b 20 6f 75 74 20 61 20 6c 6f 63 61 6c 0a 20 ck out a local. 0a10: 20 20 20 63 6f 70 79 20 6f 66 20 74 68 65 20 73 copy of the s 0a20: 6f 75 72 63 65 20 74 72 65 65 2e 20 20 43 72 65 ource tree. Cre 0a30: 61 74 65 20 74 68 65 20 64 69 72 65 63 74 6f 72 ate the director 0a40: 79 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 62 65 y you want to be 0a50: 0a 20 20 20 20 74 68 65 20 72 6f 6f 74 20 6f 66 . the root of 0a60: 20 79 6f 75 72 20 74 72 65 65 20 61 6e 64 20 63 your tree and c 0a70: 64 20 69 6e 74 6f 20 74 68 61 74 20 64 69 72 65 d into that dire 0a80: 63 74 6f 72 79 2e 20 20 54 68 65 6e 0a 20 20 20 ctory. Then. 0a90: 20 74 6f 20 74 68 69 73 3a 3c 2f 70 3e 0a 20 20 to this:</p>. 0aa0: 20 20 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f . <blockquo 0ab0: 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 te>. <b>fossi 0ac0: 6c 20 6f 70 65 6e 20 3c 2f 62 3e 3c 69 3e 20 72 l open </b><i> r 0ad0: 65 70 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e 61 epository-filena 0ae0: 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f me</i>. </blo 0af0: 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 0a 20 20 ckquote>. . 0b00: 20 20 3c 70 3e 54 68 69 73 20 6c 65 61 76 65 73 <p>This leaves 0b10: 20 79 6f 75 20 77 69 74 68 20 74 68 65 20 6f 72 you with the or 0b20: 69 67 69 6e 61 6c 20 28 65 6d 70 74 79 29 20 76 iginal (empty) v 0b30: 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 74 72 ersion of the tr 0b40: 65 65 0a 20 20 20 20 63 68 65 63 6b 65 64 20 6f ee. checked o 0b50: 75 74 2e 20 20 54 6f 20 67 65 74 20 74 6f 20 74 ut. To get to t 0b60: 68 65 20 6c 61 74 65 73 74 20 76 65 72 73 69 6f he latest versio 0b70: 6e 2c 20 61 6c 73 6f 20 64 6f 20 74 68 69 73 3a n, also do this: 0b80: 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 20 20 3c 62 </p>. . <b 0b90: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c lockquote>. < 0ba0: 62 3e 66 6f 73 73 69 6c 20 75 70 64 61 74 65 3c b>fossil update< 0bb0: 2f 62 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 /b>. </blockq 0bc0: 75 6f 74 65 3e 0a 20 20 20 20 0a 20 20 20 20 3c uote>. . < 0bd0: 70 3e 46 72 6f 6d 20 61 6e 79 77 68 65 72 65 20 p>From anywhere 0be0: 75 6e 64 65 72 6e 65 61 74 68 20 74 68 65 20 72 underneath the r 0bf0: 6f 6f 74 20 6f 66 20 79 6f 75 72 20 6c 6f 63 61 oot of your loca 0c00: 6c 20 74 72 65 65 2c 20 79 6f 75 0a 20 20 20 20 l tree, you. 0c10: 63 61 6e 20 74 79 70 65 20 63 6f 6d 6d 61 6e 64 can type command 0c20: 73 20 6c 69 6b 65 20 74 68 65 20 66 6f 6c 6c 6f s like the follo 0c30: 77 69 6e 67 20 74 6f 20 66 69 6e 64 20 6f 75 74 wing to find out 0c40: 20 74 68 65 20 73 74 61 74 75 73 20 6f 66 0a 20 the status of. 0c50: 20 20 20 79 6f 75 72 20 6c 6f 63 61 6c 20 74 72 your local tr 0c60: 65 65 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c ee:</p>.. <bl 0c70: 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 ockquote>. <b 0c80: 3e 66 6f 73 73 69 6c 20 69 6e 66 6f 3c 2f 62 3e >fossil info</b> 0c90: 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 <br>. <b>foss 0ca0: 69 6c 20 73 74 61 74 75 73 3c 2f 62 3e 3c 62 72 il status</b><br 0cb0: 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 >. <b>fossil 0cc0: 63 68 61 6e 67 65 73 3c 2f 62 3e 3c 62 72 3e 0a changes</b><br>. 0cd0: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 74 69 <b>fossil ti 0ce0: 6d 65 6c 69 6e 65 3c 2f 62 3e 3c 62 72 3e 0a 20 meline</b><br>. 0cf0: 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6c 65 61 <b>fossil lea 0d00: 76 65 73 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 20 ves</b><br>. 0d10: 3c 62 3e 66 6f 73 73 69 6c 20 6c 73 3c 2f 62 3e <b>fossil ls</b> 0d20: 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 <br>. <b>foss 0d30: 69 6c 20 62 72 61 6e 63 68 65 73 3c 2f 62 3e 3c il branches</b>< 0d40: 62 72 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 br>. </blockq 0d50: 75 6f 74 65 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 uote>..</blockqu 0d60: 6f 74 65 3e 3c 68 32 3e 4d 61 6b 69 6e 67 20 43 ote><h2>Making C 0d70: 68 61 6e 67 65 73 3c 2f 68 32 3e 3c 62 6c 6f 63 hanges</h2><bloc 0d80: 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e kquote>.. <p> 0d90: 54 6f 20 61 64 64 20 6e 65 77 20 66 69 6c 65 73 To add new files 0da0: 20 74 6f 20 79 6f 75 72 20 70 72 6f 6a 65 63 74 to your project 0db0: 2c 20 6f 72 20 72 65 6d 6f 76 65 20 6f 6c 64 20 , or remove old 0dc0: 66 69 6c 65 73 2c 20 75 73 65 20 74 68 65 73 65 files, use these 0dd0: 0a 20 20 20 20 63 6f 6d 6d 61 6e 64 73 3a 3c 2f . commands:</ 0de0: 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 p>.. <blockqu 0df0: 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 ote>. <b>foss 0e00: 69 6c 20 61 64 64 3c 2f 62 3e 20 3c 69 3e 66 69 il add</b> <i>fi 0e10: 6c 65 2e 2e 2e 3c 2f 69 3e 3c 62 72 3e 0a 20 20 le...</i><br>. 0e20: 20 20 3c 62 3e 66 6f 73 73 69 6c 20 72 6d 3c 2f <b>fossil rm</ 0e30: 62 3e 20 3c 69 3e 66 69 6c 65 2e 2e 2e 3c 2f 69 b> <i>file...</i 0e40: 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f >. </blockquo 0e50: 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 59 6f 75 20 te>.. <p>You 0e60: 63 61 6e 20 61 6c 73 6f 20 65 64 69 74 20 66 69 can also edit fi 0e70: 6c 65 73 20 66 72 65 65 6c 79 2e 20 20 4f 6e 63 les freely. Onc 0e80: 65 20 79 6f 75 20 61 72 65 20 72 65 61 64 79 20 e you are ready 0e90: 74 6f 20 63 6f 6d 6d 69 74 0a 20 20 20 20 79 6f to commit. yo 0ea0: 75 72 20 63 68 61 6e 67 65 73 2c 20 74 79 70 65 ur changes, type 0eb0: 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 :</p>.. <bloc 0ec0: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 kquote>. <b>f 0ed0: 6f 73 73 69 6c 20 63 6f 6d 6d 69 74 3c 2f 62 3e ossil commit</b> 0ee0: 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 . </blockquot 0ef0: 65 3e 0a 0a 20 20 20 20 3c 70 3e 59 6f 75 20 77 e>.. <p>You w 0f00: 69 6c 6c 20 62 65 20 70 72 6f 6d 70 74 65 64 20 ill be prompted 0f10: 66 6f 72 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d for check-in com 0f20: 6d 65 6e 74 73 20 75 73 69 6e 67 20 77 68 61 74 ments using what 0f30: 65 76 65 72 20 65 64 69 74 6f 72 0a 20 20 20 20 ever editor. 0f40: 69 73 20 73 70 65 63 69 66 69 65 64 20 62 79 20 is specified by 0f50: 79 6f 75 72 20 56 49 53 55 41 4c 20 6f 72 20 45 your VISUAL or E 0f60: 44 49 54 4f 52 20 65 6e 76 69 72 6f 6e 6d 65 6e DITOR environmen 0f70: 74 20 76 61 72 69 61 62 6c 65 2e 20 20 49 66 20 t variable. If 0f80: 79 6f 75 0a 20 20 20 20 68 61 76 65 20 47 50 47 you. have GPG 0f90: 20 69 6e 73 74 61 6c 6c 65 64 2c 20 79 6f 75 20 installed, you 0fa0: 6d 61 79 20 62 65 20 70 72 6f 6d 70 74 65 64 20 may be prompted 0fb0: 66 6f 72 20 79 6f 75 72 20 47 50 47 20 70 61 73 for your GPG pas 0fc0: 73 70 68 72 61 73 65 20 73 6f 0a 20 20 20 20 74 sphrase so. t 0fd0: 68 61 74 20 74 68 65 20 63 68 65 63 6b 2d 69 6e hat the check-in 0fe0: 20 63 61 6e 20 62 65 20 73 69 67 6e 65 64 20 77 can be signed w 0ff0: 69 74 68 20 79 6f 75 72 20 47 50 47 20 73 69 67 ith your GPG sig 1000: 6e 61 74 75 72 65 2e 20 20 41 66 74 65 72 0a 20 nature. After. 1010: 20 20 20 74 68 69 73 20 79 6f 75 72 20 63 68 61 this your cha 1020: 6e 67 65 73 20 77 69 6c 6c 20 62 65 20 63 68 65 nges will be che 1030: 63 6b 65 64 20 69 6e 2e 3c 2f 70 3e 0a 0a 3c 2f cked in.</p>..</ 1040: 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 53 blockquote><h2>S 1050: 68 61 72 69 6e 67 20 43 68 61 6e 67 65 73 3c 2f haring Changes</ 1060: 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a h2><blockquote>. 1070: 0a 20 20 20 20 3c 70 3e 54 68 65 20 63 68 61 6e . <p>The chan 1080: 67 65 73 20 79 6f 75 20 3c 62 3e 63 6f 6d 6d 69 ges you <b>commi 1090: 74 3c 2f 62 3e 20 61 72 65 20 6f 6e 6c 79 20 6f t</b> are only o 10a0: 6e 20 79 6f 75 72 20 6c 6f 63 61 6c 20 72 65 70 n your local rep 10b0: 6f 73 69 74 6f 72 79 2e 0a 20 20 20 20 54 6f 20 ository.. To 10c0: 73 68 61 72 65 20 74 68 6f 73 65 20 63 68 61 6e share those chan 10d0: 67 65 73 20 77 69 74 68 20 6f 74 68 65 72 20 72 ges with other r 10e0: 65 70 6f 73 69 74 6f 72 69 65 73 2c 20 64 6f 3a epositories, do: 10f0: 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b </p>.. <block 1100: 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f quote>. <b>fo 1110: 73 73 69 6c 20 70 75 73 68 3c 2f 62 3e 20 3c 69 ssil push</b> <i 1120: 3e 55 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 >URL</i>. </b 1130: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 lockquote>.. 1140: 3c 70 3e 57 68 65 72 65 20 3c 69 3e 55 52 4c 3c <p>Where <i>URL< 1150: 2f 69 3e 20 69 73 20 74 68 65 20 68 74 74 70 3a /i> is the http: 1160: 20 55 52 4c 20 6f 66 20 74 68 65 20 73 65 72 76 URL of the serv 1170: 65 72 20 72 65 70 6f 73 69 74 6f 72 79 20 79 6f er repository yo 1180: 75 0a 20 20 20 20 77 61 6e 74 20 74 6f 20 73 68 u. want to sh 1190: 61 72 65 20 79 6f 75 72 20 63 68 61 6e 67 65 73 are your changes 11a0: 20 77 69 74 68 2e 20 20 49 66 20 79 6f 75 20 6f with. If you o 11b0: 6d 69 74 20 74 68 65 20 3c 69 3e 55 52 4c 3c 2f mit the <i>URL</ 11c0: 69 3e 20 61 72 67 75 6d 65 6e 74 2c 0a 20 20 20 i> argument,. 11d0: 20 66 6f 73 73 69 6c 20 77 69 6c 6c 20 75 73 65 fossil will use 11e0: 20 77 68 61 74 65 76 65 72 20 73 65 72 76 65 72 whatever server 11f0: 20 79 6f 75 20 6d 6f 73 74 20 72 65 63 65 6e 74 you most recent 1200: 6c 79 20 73 79 6e 63 65 64 20 77 69 74 68 2e 3c ly synced with.< 1210: 2f 70 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 /p>.. <p>The 1220: 3c 62 3e 70 75 73 68 3c 2f 62 3e 20 63 6f 6d 6d <b>push</b> comm 1230: 61 6e 64 20 6f 6e 6c 79 20 73 65 6e 64 73 20 79 and only sends y 1240: 6f 75 72 20 63 68 61 6e 67 65 73 20 74 6f 20 6f our changes to o 1250: 74 68 65 72 73 2e 20 20 54 6f 0a 20 20 20 20 52 thers. To. R 1260: 65 63 65 69 76 65 20 63 68 61 6e 67 65 73 20 66 eceive changes f 1270: 72 6f 6d 20 6f 74 68 65 72 73 2c 20 75 73 65 20 rom others, use 1280: 3c 62 3e 70 75 6c 6c 3c 2f 62 3e 2e 20 20 4f 72 <b>pull</b>. Or 1290: 20 67 6f 20 62 6f 74 68 20 77 61 79 73 20 61 74 go both ways at 12a0: 0a 20 20 20 20 6f 6e 63 65 20 75 73 69 6e 67 20 . once using 12b0: 3c 62 3e 73 79 6e 63 3c 2f 62 3e 3a 3c 2f 70 3e <b>sync</b>:</p> 12c0: 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 .. <blockquot 12d0: 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c e>. <b>fossil 12e0: 20 70 75 6c 6c 3c 2f 62 3e 20 3c 69 3e 55 52 4c pull</b> <i>URL 12f0: 3c 2f 69 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e </i><br>. <b> 1300: 66 6f 73 73 69 6c 20 73 79 6e 63 3c 2f 62 3e 20 fossil sync</b> 1310: 3c 69 3e 55 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c <i>URL</i>. < 1320: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 /blockquote>.. 1330: 20 20 3c 70 3e 57 68 65 6e 20 79 6f 75 20 70 75 <p>When you pu 1340: 6c 6c 20 69 6e 20 63 68 61 6e 67 65 73 20 66 72 ll in changes fr 1350: 6f 6d 20 6f 74 68 65 72 73 2c 20 74 68 65 79 20 om others, they 1360: 67 6f 20 69 6e 74 6f 20 79 6f 75 72 20 72 65 70 go into your rep 1370: 6f 73 69 74 6f 72 79 2c 0a 20 20 20 20 6e 6f 74 ository,. not 1380: 20 69 6e 74 6f 20 79 6f 75 72 20 63 68 65 63 6b into your check 1390: 65 64 2d 6f 75 74 20 6c 6f 63 61 6c 20 74 72 65 ed-out local tre 13a0: 65 2e 20 20 54 6f 20 67 65 74 20 74 68 65 20 63 e. To get the c 13b0: 68 61 6e 67 65 73 20 69 6e 74 6f 20 79 6f 75 72 hanges into your 13c0: 0a 20 20 20 20 6c 6f 63 61 6c 20 74 72 65 65 2c . local tree, 13d0: 20 75 73 65 20 3c 62 3e 75 70 64 61 74 65 3c 2f use <b>update</ 13e0: 62 3e 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c b>:</p>.. <bl 13f0: 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 ockquote>. <b 1400: 3e 66 6f 73 73 69 6c 20 75 70 64 61 74 65 3c 2f >fossil update</ 1410: 62 3e 20 3c 69 3e 55 55 49 44 3c 2f 69 3e 0a 20 b> <i>UUID</i>. 1420: 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e </blockquote> 1430: 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 3c 69 3e .. <p>The <i> 1440: 55 55 49 44 3c 2f 69 3e 20 69 73 20 73 6f 6d 65 UUID</i> is some 1450: 20 75 6e 69 71 75 65 20 61 62 62 72 65 76 69 61 unique abbrevia 1460: 74 69 6f 6e 20 74 6f 20 74 68 65 20 34 30 2d 63 tion to the 40-c 1470: 68 61 72 61 63 74 65 72 0a 20 20 20 20 76 65 72 haracter. ver 1480: 73 69 6f 6e 20 49 44 2e 20 20 49 66 20 79 6f 75 sion ID. If you 1490: 20 6f 6d 69 74 20 74 68 65 20 3c 69 3e 55 55 49 omit the <i>UUI 14a0: 44 3c 2f 69 3e 20 66 6f 73 73 69 6c 20 6d 6f 76 D</i> fossil mov 14b0: 65 73 20 79 6f 75 20 74 6f 20 74 68 65 0a 20 20 es you to the. 14c0: 20 20 6c 65 61 66 20 76 65 72 73 69 6f 6e 20 6f leaf version o 14d0: 66 20 74 68 65 20 62 72 61 6e 63 68 20 79 6f 75 f the branch you 14e0: 72 20 61 72 65 20 63 75 72 72 65 6e 74 6c 79 20 r are currently 14f0: 6f 6e 2e 20 20 49 66 20 79 6f 75 72 20 62 72 61 on. If your bra 1500: 6e 63 68 0a 20 20 20 20 68 61 73 20 6d 75 6c 74 nch. has mult 1510: 69 70 6c 65 20 6c 65 61 76 65 73 2c 20 79 6f 75 iple leaves, you 1520: 20 67 65 74 20 61 6e 20 65 72 72 6f 72 20 2d 20 get an error - 1530: 79 6f 75 27 6c 6c 20 68 61 76 65 20 74 6f 20 73 you'll have to s 1540: 70 65 63 69 66 79 20 74 68 65 0a 20 20 20 20 6c pecify the. l 1550: 65 61 66 20 79 6f 75 20 77 61 6e 74 20 75 73 69 eaf you want usi 1560: 6e 67 20 61 20 3c 69 3e 55 55 49 44 3c 2f 69 3e ng a <i>UUID</i> 1570: 20 61 72 67 75 6d 65 6e 74 2e 3c 2f 70 3e 0a 0a argument.</p>.. 1580: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 </blockquote><h2 1590: 3e 42 72 61 6e 63 68 69 6e 67 20 41 6e 64 20 4d >Branching And M 15a0: 65 72 67 69 6e 67 3c 2f 68 32 3e 3c 62 6c 6f 63 erging</h2><bloc 15b0: 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e kquote>.. <p> 15c0: 59 6f 75 20 63 61 6e 20 63 72 65 61 74 65 20 62 You can create b 15d0: 72 61 6e 63 68 65 73 20 62 79 20 64 6f 69 6e 67 ranches by doing 15e0: 20 6d 75 6c 74 69 70 6c 65 20 63 6f 6d 6d 69 74 multiple commit 15f0: 73 20 6f 66 66 20 6f 66 20 74 68 65 0a 20 20 20 s off of the. 1600: 20 73 61 6d 65 20 62 61 73 65 20 76 65 72 73 69 same base versi 1610: 6f 6e 2e 20 20 54 6f 20 6d 65 72 67 65 20 74 6f on. To merge to 1620: 20 62 72 61 6e 63 68 65 73 20 62 61 63 6b 20 74 branches back t 1630: 6f 67 65 74 68 65 72 2c 20 66 69 72 73 74 0a 20 ogether, first. 1640: 20 20 20 3c 62 3e 75 70 64 61 74 65 3c 2f 62 3e <b>update</b> 1650: 20 74 6f 20 74 68 65 20 6c 65 61 66 20 6f 66 20 to the leaf of 1660: 6f 6e 65 20 62 72 61 6e 63 68 2e 20 20 54 68 65 one branch. The 1670: 6e 20 64 6f 20 61 20 3c 62 3e 6d 65 72 67 65 3c n do a <b>merge< 1680: 2f 62 3e 0a 20 20 20 20 6f 66 20 74 68 65 20 6c /b>. of the l 1690: 65 61 66 20 6f 66 20 74 68 65 20 6f 74 68 65 72 eaf of the other 16a0: 20 62 72 61 6e 63 68 3a 3c 2f 70 3e 0a 0a 20 20 branch:</p>.. 16b0: 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 <blockquote>. 16c0: 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6d 65 72 <b>fossil mer 16d0: 67 65 3c 2f 62 3e 20 3c 69 3e 55 55 49 44 3c 2f ge</b> <i>UUID</ 16e0: 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 i>. </blockqu 16f0: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 65 73 ote>.. <p>Tes 1700: 74 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 79 t to make sure y 1710: 6f 75 72 20 6d 65 72 67 65 20 64 69 64 6e 27 74 our merge didn't 1720: 20 6d 65 73 73 20 75 70 20 74 68 65 20 63 6f 64 mess up the cod 1730: 65 2c 20 74 68 65 6e 0a 20 20 20 20 3c 62 3e 63 e, then. <b>c 1740: 6f 6d 6d 69 74 3c 2f 62 3e 20 61 6e 64 20 70 6f ommit</b> and po 1750: 73 73 69 62 6c 79 20 61 6c 73 6f 20 3c 62 3e 70 ssibly also <b>p 1760: 75 73 68 3c 2f 62 3e 20 79 6f 75 72 20 63 68 61 ush</b> your cha 1770: 6e 67 65 73 2e 20 20 20 52 65 6d 65 6d 62 65 72 nges. Remember 1780: 0a 20 20 20 20 74 68 61 74 20 6e 6f 62 6f 64 79 . that nobody 1790: 20 65 6c 73 65 20 63 61 6e 20 73 65 65 20 79 6f else can see yo 17a0: 75 72 20 63 68 61 6e 67 65 73 20 75 6e 74 69 6c ur changes until 17b0: 20 79 6f 75 20 3c 62 3e 63 6f 6d 6d 69 74 3c 2f you <b>commit</ 17c0: 62 3e 20 61 6e 64 0a 20 20 20 20 69 66 20 6f 74 b> and. if ot 17d0: 68 65 72 20 61 72 65 20 75 73 69 6e 67 20 61 20 her are using a 17e0: 64 69 66 66 65 72 65 6e 74 20 72 65 70 6f 73 69 different reposi 17f0: 74 6f 72 79 20 79 6f 75 20 77 69 6c 6c 20 61 6c tory you will al 1800: 73 6f 20 6e 65 65 64 20 74 6f 0a 20 20 20 20 3c so need to. < 1810: 62 3e 70 75 73 68 3c 2f 62 3e 2e 3c 2f 70 3e 0a b>push</b>.</p>. 1820: 0a 3c 61 20 6e 61 6d 65 3d 22 73 65 72 76 65 72 .<a name="server 1830: 73 65 74 75 70 22 3e 0a 3c 2f 62 6c 6f 63 6b 71 setup">.</blockq 1840: 75 6f 74 65 3e 3c 68 32 3e 53 65 74 74 69 6e 67 uote><h2>Setting 1850: 20 55 70 20 41 20 53 65 72 76 65 72 3c 2f 68 32 Up A Server</h2 1860: 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 ><blockquote>.. 1870: 20 20 20 3c 70 3e 54 68 65 20 65 61 73 69 65 73 <p>The easies 1880: 74 20 77 61 79 20 74 6f 20 73 65 74 20 75 70 20 t way to set up 1890: 61 20 73 65 72 76 65 72 20 69 73 3a 3c 2f 70 3e a server is:</p> 18a0: 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 .. <blockquot 18b0: 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c e>. <b>fossil 18c0: 20 73 65 72 76 65 72 3c 2f 62 3e 20 3c 69 3e 72 server</b> <i>r 18d0: 65 70 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e 61 epository-filena 18e0: 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f me</i>. </blo 18f0: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 ckquote>.. <p 1900: 3e 59 6f 75 20 63 61 6e 20 6f 6d 69 74 20 74 68 >You can omit th 1910: 65 20 3c 69 3e 72 65 70 6f 73 69 74 6f 72 79 2d e <i>repository- 1920: 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 20 69 66 20 filename</i> if 1930: 79 6f 75 20 61 72 65 20 77 69 74 68 69 6e 0a 20 you are within. 1940: 20 20 20 61 20 63 68 65 63 6b 65 64 2d 6f 75 74 a checked-out 1950: 20 6c 6f 63 61 6c 20 74 72 65 65 2e 20 20 54 68 local tree. Th 1960: 69 73 20 73 65 72 76 65 72 20 75 73 65 73 20 70 is server uses p 1970: 6f 72 74 20 38 30 38 30 20 62 79 20 64 65 66 61 ort 8080 by defa 1980: 75 6c 74 0a 20 20 20 20 62 75 74 20 79 6f 75 20 ult. but you 1990: 63 61 6e 20 73 70 65 63 69 66 79 20 61 20 64 69 can specify a di 19a0: 66 66 65 72 65 6e 74 20 70 6f 72 74 20 75 73 69 fferent port usi 19b0: 6e 67 20 74 68 65 20 3c 62 3e 2d 70 6f 72 74 3c ng the <b>-port< 19c0: 2f 62 3e 20 63 6f 6d 6d 61 6e 64 2e 3c 2f 70 3e /b> command.</p> 19d0: 0a 0a 20 20 20 20 3c 70 3e 43 6f 6d 6d 61 6e 64 .. <p>Command 19e0: 2d 6c 69 6e 65 20 73 65 72 76 65 72 73 20 6c 69 -line servers li 19f0: 6b 65 20 74 68 69 73 20 61 72 65 20 75 73 65 66 ke this are usef 1a00: 75 6c 20 77 68 65 6e 20 74 77 6f 20 70 65 6f 70 ul when two peop 1a10: 6c 65 20 77 61 6e 74 0a 20 20 20 20 74 6f 20 73 le want. to s 1a20: 68 61 72 65 20 61 20 72 65 70 6f 73 69 74 6f 72 hare a repositor 1a30: 79 20 6f 6e 20 74 65 6d 70 6f 72 61 72 79 20 6f y on temporary o 1a40: 72 20 61 64 2d 68 6f 63 20 62 61 73 69 73 2e 20 r ad-hoc basis. 1a50: 20 46 6f 72 20 61 20 6d 6f 72 65 0a 20 20 20 20 For a more. 1a60: 70 65 72 6d 61 6e 65 6e 74 20 69 6e 73 74 61 6c permanent instal 1a70: 6c 61 74 69 6f 6e 2c 20 79 6f 75 20 73 68 6f 75 lation, you shou 1a80: 6c 64 20 75 73 65 20 65 69 74 68 65 72 20 74 68 ld use either th 1a90: 65 20 43 47 49 20 73 65 72 76 65 72 20 6f 72 20 e CGI server or 1aa0: 74 68 65 0a 20 20 20 20 69 6e 65 74 64 20 73 65 the. inetd se 1ab0: 72 76 65 72 2e 20 20 54 6f 20 75 73 65 20 74 68 rver. To use th 1ac0: 65 20 43 47 49 20 73 65 72 76 65 72 2c 20 63 72 e CGI server, cr 1ad0: 65 61 74 65 20 61 20 43 47 49 20 73 63 72 69 70 eate a CGI scrip 1ae0: 74 20 74 68 61 74 0a 20 20 20 20 6c 6f 6f 6b 73 t that. looks 1af0: 20 73 6f 6d 65 74 68 69 6e 67 20 6c 69 6b 65 20 something like 1b00: 74 68 69 73 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c this:</p>.. < 1b10: 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 62 3e 0a 20 blockquote><b>. 1b20: 20 20 20 23 21 2f 75 73 72 2f 6c 6f 63 61 6c 2f #!/usr/local/ 1b30: 62 69 6e 2f 66 6f 73 73 69 6c 3c 62 72 3e 0a 20 bin/fossil<br>. 1b40: 20 20 20 72 65 70 6f 73 69 74 6f 72 79 3a 20 2f repository: / 1b50: 68 6f 6d 65 2f 70 72 6f 6a 31 2f 72 65 70 6f 73 home/proj1/repos 1b60: 31 2e 66 73 6c 0a 20 20 20 20 3c 2f 62 3e 3c 2f 1.fsl. </b></ 1b70: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 blockquote>.. 1b80: 20 3c 70 3e 41 64 6a 75 73 74 20 74 68 65 20 70 <p>Adjust the p 1b90: 61 74 68 73 20 69 6e 20 74 68 69 73 20 43 47 49 aths in this CGI 1ba0: 20 73 63 72 69 70 74 20 74 6f 20 6d 61 74 63 68 script to match 1bb0: 20 79 6f 75 72 20 69 6e 73 74 61 6c 6c 61 74 69 your installati 1bc0: 6f 6e 2e 0a 20 20 20 20 4e 6f 77 20 70 6f 69 6e on.. Now poin 1bd0: 74 20 63 6c 69 65 6e 74 73 20 61 74 20 74 68 65 t clients at the 1be0: 20 43 47 49 20 73 63 72 69 70 74 2e 20 20 54 68 CGI script. Th 1bf0: 61 74 27 73 20 61 6c 6c 20 74 68 65 72 65 20 69 at's all there i 1c00: 73 20 74 6f 20 69 74 21 3c 2f 70 3e 0a 0a 20 20 s to it!</p>.. 1c10: 20 20 3c 70 3e 59 6f 75 20 63 61 6e 20 61 6c 73 <p>You can als 1c20: 6f 20 72 75 6e 20 66 6f 73 73 69 6c 20 6f 66 66 o run fossil off 1c30: 20 6f 66 20 69 6e 65 74 64 20 6f 72 20 78 69 6e of inetd or xin 1c40: 65 74 64 2e 20 20 46 6f 72 20 61 6e 20 69 6e 65 etd. For an ine 1c50: 74 64 0a 20 20 20 20 69 6e 73 74 61 6c 6c 61 74 td. installat 1c60: 69 6f 6e 2c 20 6d 61 6b 65 20 61 6e 20 65 6e 74 ion, make an ent 1c70: 72 79 20 69 6e 20 2f 65 74 63 2f 69 6e 65 74 64 ry in /etc/inetd 1c80: 2e 63 6f 6e 66 20 74 68 61 74 20 6c 6f 6f 6b 73 .conf that looks 1c90: 20 73 6f 6d 65 74 68 69 6e 67 0a 20 20 20 20 6c something. l 1ca0: 69 6b 65 20 74 68 69 73 3a 3c 2f 70 3e 0a 0a 20 ike this:</p>.. 1cb0: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c <blockquote>< 1cc0: 62 3e 0a 20 20 20 20 38 30 20 73 74 72 65 61 6d b>. 80 stream 1cd0: 20 74 63 70 20 6e 6f 77 61 69 74 2e 31 30 30 30 tcp nowait.1000 1ce0: 20 72 6f 6f 74 20 2f 75 73 72 2f 62 69 6e 2f 66 root /usr/bin/f 1cf0: 6f 73 73 69 6c 20 5c 3c 62 72 3e 0a 20 20 20 20 ossil \<br>. 1d00: 20 20 20 20 2f 75 73 72 2f 62 69 6e 2f 66 6f 73 /usr/bin/fos 1d10: 73 69 6c 20 68 74 74 70 20 2f 68 6f 6d 65 2f 70 sil http /home/p 1d20: 72 6f 6a 31 2f 72 65 70 6f 73 31 2e 66 73 6c 0a roj1/repos1.fsl. 1d30: 20 20 20 20 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 </b></blockq 1d40: 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 41 64 uote>.. <p>Ad 1d50: 6a 75 73 74 20 74 68 65 20 70 61 74 68 73 20 74 just the paths t 1d60: 6f 20 73 75 69 74 20 79 6f 75 72 20 69 6e 73 74 o suit your inst 1d70: 61 6c 6c 61 74 69 6f 6e 2c 20 6f 66 20 63 6f 75 allation, of cou 1d80: 72 73 65 2e 20 20 4e 6f 74 69 63 65 20 74 68 61 rse. Notice tha 1d90: 74 0a 20 20 20 20 66 6f 73 73 69 6c 20 72 75 6e t. fossil run 1da0: 73 20 61 73 20 72 6f 6f 74 2e 20 20 54 68 69 73 s as root. This 1db0: 20 69 73 20 6e 6f 74 20 72 65 71 75 69 72 65 64 is not required 1dc0: 20 2d 20 79 6f 75 20 63 61 6e 20 72 75 6e 20 69 - you can run i 1dd0: 74 20 61 73 20 61 6e 0a 20 20 20 20 75 6e 70 72 t as an. unpr 1de0: 69 76 69 6c 65 67 65 64 20 75 73 65 72 2e 20 20 ivileged user. 1df0: 42 75 74 20 69 74 20 69 73 20 6d 6f 72 65 20 73 But it is more s 1e00: 65 63 75 72 65 20 74 6f 20 72 75 6e 20 66 6f 73 ecure to run fos 1e10: 73 69 6c 20 61 73 20 72 6f 6f 74 2e 0a 20 20 20 sil as root.. 1e20: 20 57 68 65 6e 20 79 6f 75 20 64 6f 20 72 75 6e When you do run 1e30: 20 66 6f 73 73 69 6c 20 61 73 20 72 6f 6f 74 2c fossil as root, 1e40: 20 69 74 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c it automaticall 1e50: 79 20 70 75 74 73 20 69 74 73 65 6c 66 20 69 6e y puts itself in 1e60: 20 61 0a 20 20 20 20 63 68 72 6f 6f 74 20 6a 61 a. chroot ja 1e70: 69 6c 20 69 6e 20 74 68 65 20 73 61 6d 65 20 64 il in the same d 1e80: 69 72 65 63 74 6f 72 79 20 61 73 20 74 68 65 20 irectory as the 1e90: 72 65 70 6f 73 69 74 6f 72 79 2c 20 74 68 65 6e repository, then 1ea0: 20 64 72 6f 70 73 0a 20 20 20 20 72 6f 6f 74 20 drops. root 1eb0: 70 72 69 76 69 6c 65 67 65 73 20 70 72 69 6f 72 privileges prior 1ec0: 20 74 6f 20 72 65 61 64 69 6e 67 20 61 6e 79 20 to reading any 1ed0: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d information from 1ee0: 20 74 68 65 20 72 65 71 75 65 73 74 2e 3c 2f 70 the request.</p 1ef0: 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e >..</blockquote> 1f00: 3c 68 32 3e 4d 6f 72 65 20 48 69 6e 74 73 3c 2f <h2>More Hints</ 1f10: 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a h2><blockquote>. 1f20: 0a 20 20 20 20 3c 70 3e 54 72 79 20 74 68 65 73 . <p>Try thes 1f30: 65 20 63 6f 6d 6d 61 6e 64 73 3a 3c 2f 70 3e 0a e commands:</p>. 1f40: 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 . <blockquote 1f50: 3e 3c 62 3e 0a 20 20 20 20 66 6f 73 73 69 6c 20 ><b>. fossil 1f60: 68 65 6c 70 3c 62 72 3e 0a 20 20 20 20 66 6f 73 help<br>. fos 1f70: 73 69 6c 20 74 65 73 74 2d 63 6f 6d 6d 61 6e 64 sil test-command 1f80: 73 0a 20 20 20 20 3c 2f 62 3e 3c 2f 62 6c 6f 63 s. </b></bloc 1f90: 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e kquote>.. <p> 1fa0: 45 78 70 6c 6f 72 65 20 61 6e 64 20 68 61 76 65 Explore and have 1fb0: 20 66 75 6e 21 3c 2f 70 3e 0a 0a 0a 3c 2f 62 6c fun!</p>...</bl 1fc0: 6f 63 6b 71 75 6f 74 65 3e 3c 2f 62 6f 64 79 3e ockquote></body> 1fd0: 3c 2f 68 74 6d 6c 3e 0a </html>.