Artifact ce3d352b11f8a8f7cb19d638dd57030b75a5d0be:
File www/quickstart.html part of check-in [f652599003] - Add the --proxy command-line option that can be used to enable or disable an http proxy on a case by case basis. by drh on 2008-05-06 12:24:22.
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 77 77 77 2e 66 6f 73 73 69 6c 2d 73 63 6d //www.fossil-scm 0450: 2e 6f 72 67 2f 66 6f 73 73 69 6c 20 6d 79 63 6c .org/fossil mycl 0460: 6f 6e 65 2e 66 73 6c 3c 2f 62 3e 0a 20 20 20 20 one.fsl</b>. 0470: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 </blockquote>.. 0480: 20 20 20 3c 70 3e 4e 6f 74 65 3a 20 49 66 20 79 <p>Note: If y 0490: 6f 75 20 61 72 65 20 62 65 68 69 6e 64 20 61 20 ou are behind a 04a0: 72 65 73 74 72 69 63 74 69 76 65 20 66 69 72 65 restrictive fire 04b0: 77 61 6c 6c 2c 20 79 6f 75 20 6d 69 67 68 74 20 wall, you might 04c0: 6e 65 65 64 0a 20 20 20 20 74 6f 20 3c 61 20 68 need. to <a h 04d0: 72 65 66 3d 22 23 70 72 6f 78 79 22 3e 73 70 65 ref="#proxy">spe 04e0: 63 69 66 79 20 61 6e 20 48 54 54 50 20 70 72 6f cify an HTTP pro 04f0: 78 79 3c 2f 61 3e 20 74 6f 20 75 73 65 2e 3c 2f xy</a> to use.</ 0500: 70 3e 0a 20 20 20 20 0a 3c 2f 62 6c 6f 63 6b 71 p>. .</blockq 0510: 75 6f 74 65 3e 3c 68 32 3e 53 74 61 72 74 69 6e uote><h2>Startin 0520: 67 20 41 20 4e 65 77 20 50 72 6f 6a 65 63 74 3c g A New Project< 0530: 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e /h2><blockquote> 0540: 0a 0a 20 20 20 20 3c 70 3e 54 6f 20 73 74 61 72 .. <p>To star 0550: 74 20 61 20 6e 65 77 20 70 72 6f 6a 65 63 74 20 t a new project 0560: 77 69 74 68 20 66 6f 73 73 69 6c 2c 20 63 72 65 with fossil, cre 0570: 61 74 65 20 61 20 6e 65 77 20 65 6d 70 74 79 20 ate a new empty 0580: 72 65 70 6f 73 69 74 6f 72 79 0a 20 20 20 20 74 repository. t 0590: 68 69 73 20 77 61 79 3a 3c 2f 70 3e 0a 20 20 20 his way:</p>. 05a0: 20 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 . <blockquot 05b0: 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c e>. <b>fossil 05c0: 20 6e 65 77 20 3c 2f 62 3e 3c 69 3e 20 72 65 70 new </b><i> rep 05d0: 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 ository-filename 05e0: 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b </i>. </block 05f0: 71 75 6f 74 65 3e 0a 20 20 20 20 0a 3c 2f 62 6c quote>. .</bl 0600: 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 43 6f 6e ockquote><h2>Con 0610: 66 69 67 75 72 69 6e 67 20 59 6f 75 72 20 4c 6f figuring Your Lo 0620: 63 61 6c 20 52 65 70 6f 73 69 74 6f 72 79 3c 2f cal Repository</ 0630: 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a h2><blockquote>. 0640: 20 20 20 20 0a 20 20 20 20 3c 70 3e 57 68 65 6e . <p>When 0650: 20 79 6f 75 20 63 72 65 61 74 65 20 61 20 6e 65 you create a ne 0660: 77 20 72 65 70 6f 73 69 74 6f 72 79 2c 20 65 69 w repository, ei 0670: 74 68 65 72 20 62 79 20 63 6c 6f 6e 69 6e 67 20 ther by cloning 0680: 61 6e 20 65 78 69 73 74 69 6e 67 0a 20 20 20 20 an existing. 0690: 70 72 6f 6a 65 63 74 20 6f 72 20 63 72 65 61 74 project or creat 06a0: 65 20 61 20 6e 65 77 20 70 72 6f 6a 65 63 74 20 e a new project 06b0: 6f 66 20 79 6f 75 72 20 6f 77 6e 2c 20 79 6f 75 of your own, you 06c0: 20 75 73 75 61 6c 6c 79 20 77 61 6e 74 20 74 6f usually want to 06d0: 20 64 6f 20 73 6f 6d 65 0a 20 20 20 20 6c 6f 63 do some. loc 06e0: 61 6c 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e al configuration 06f0: 2e 20 20 54 68 69 73 20 69 73 20 61 63 63 6f 6d . This is accom 0700: 70 6c 69 73 68 65 64 20 75 73 69 6e 67 20 61 20 plished using a 0710: 77 65 62 62 72 6f 77 73 65 72 2e 20 20 46 69 72 webbrowser. Fir 0720: 73 74 0a 20 20 20 20 73 74 61 72 74 20 61 20 66 st. start a f 0730: 6f 73 73 69 6c 20 77 65 62 73 65 72 76 65 72 20 ossil webserver 0740: 6c 69 6b 65 20 74 68 69 73 3a 3c 2f 70 3e 0a 20 like this:</p>. 0750: 20 20 20 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 . <blockqu 0760: 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 ote>. <b>foss 0770: 69 6c 20 73 65 72 76 65 72 20 3c 2f 62 3e 3c 69 il server </b><i 0780: 3e 20 72 65 70 6f 73 69 74 6f 72 79 2d 66 69 6c > repository-fil 0790: 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f ename</i>. </ 07a0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 blockquote>.. 07b0: 20 3c 70 3e 54 68 69 73 20 63 72 65 61 74 65 73 <p>This creates 07c0: 20 61 20 6d 69 6e 69 2d 77 65 62 73 65 72 76 65 a mini-webserve 07d0: 72 20 6c 69 73 74 65 6e 69 6e 67 20 6f 6e 20 70 r listening on p 07e0: 6f 72 74 20 38 30 38 30 2e 20 20 59 6f 75 20 63 ort 8080. You c 07f0: 61 6e 0a 20 20 20 20 73 70 65 63 69 66 79 20 61 an. specify a 0800: 20 64 69 66 66 65 72 65 6e 74 20 70 6f 72 74 20 different port 0810: 75 73 69 6e 67 20 74 68 65 20 3c 62 3e 2d 70 6f using the <b>-po 0820: 72 74 3c 2f 62 3e 20 6f 70 74 69 6f 6e 20 6f 6e rt</b> option on 0830: 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e the command-lin 0840: 65 2e 0a 20 20 20 20 41 66 74 65 72 20 74 68 65 e.. After the 0850: 20 73 65 72 76 65 72 20 69 73 20 72 75 6e 6e 69 server is runni 0860: 6e 67 2c 20 70 6f 69 6e 74 20 79 6f 75 72 20 77 ng, point your w 0870: 65 62 62 72 6f 77 73 65 72 20 61 74 0a 20 20 20 ebbrowser at. 0880: 20 68 74 74 70 3a 2f 2f 6c 6f 63 61 6c 68 6f 73 http://localhos 0890: 74 3a 38 30 38 30 2f 20 61 6e 64 20 73 74 61 72 t:8080/ and star 08a0: 74 20 63 6f 6e 66 69 67 75 72 69 6e 67 2e 3c 2f t configuring.</ 08b0: 70 3e 0a 20 20 20 20 0a 20 20 20 20 3c 70 3e 42 p>. . <p>B 08c0: 79 20 64 65 66 61 75 6c 74 2c 20 66 6f 73 73 69 y default, fossi 08d0: 6c 20 64 6f 65 73 20 6e 6f 74 20 72 65 71 75 69 l does not requi 08e0: 72 65 20 61 20 6c 6f 67 69 6e 20 66 6f 72 20 48 re a login for H 08f0: 54 54 50 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 0a TTP connections. 0900: 20 20 20 20 63 6f 6d 69 6e 67 20 69 6e 20 66 72 coming in fr 0910: 6f 6d 20 74 68 65 20 49 50 20 6c 6f 6f 70 62 61 om the IP loopba 0920: 63 6b 20 61 64 64 72 65 73 73 20 31 32 37 2e 30 ck address 127.0 0930: 2e 30 2e 31 2e 20 20 59 6f 75 20 63 61 6e 2c 20 .0.1. You can, 0940: 61 6e 64 20 70 65 72 68 61 70 73 0a 20 20 20 20 and perhaps. 0950: 73 68 6f 75 6c 64 2c 20 63 68 61 6e 67 65 20 74 should, change t 0960: 68 69 73 20 61 66 74 65 72 20 79 6f 75 20 63 72 his after you cr 0970: 65 61 74 65 20 61 20 66 65 77 20 75 73 65 72 73 eate a few users 0980: 2e 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 20 20 3c .</p>. . < 0990: 70 3e 57 68 65 6e 20 79 6f 75 20 61 72 65 20 66 p>When you are f 09a0: 69 6e 69 73 68 65 64 20 63 6f 6e 66 69 67 75 72 inished configur 09b0: 69 6e 67 2c 20 6a 75 73 74 20 70 72 65 73 73 20 ing, just press 09c0: 43 6f 6e 74 72 6f 6c 2d 43 20 6f 72 20 75 73 65 Control-C or use 09d0: 0a 20 20 20 20 74 68 65 20 3c 62 3e 6b 69 6c 6c . the <b>kill 09e0: 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 </b> command to 09f0: 73 68 75 74 20 64 6f 77 6e 20 74 68 65 20 6d 69 shut down the mi 0a00: 6e 69 2d 73 65 72 76 65 72 2e 3c 2f 70 3e 0a 0a ni-server.</p>.. 0a10: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 </blockquote><h2 0a20: 3e 43 68 65 63 6b 69 6e 67 20 4f 75 74 20 41 20 >Checking Out A 0a30: 4c 6f 63 61 6c 20 54 72 65 65 3c 2f 68 32 3e 3c Local Tree</h2>< 0a40: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 blockquote>.. 0a50: 20 3c 70 3e 54 6f 20 77 6f 72 6b 20 6f 6e 20 61 <p>To work on a 0a60: 20 70 72 6f 6a 65 63 74 20 69 6e 20 66 6f 73 73 project in foss 0a70: 69 6c 2c 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 il, you need to 0a80: 63 68 65 63 6b 20 6f 75 74 20 61 20 6c 6f 63 61 check out a loca 0a90: 6c 0a 20 20 20 20 63 6f 70 79 20 6f 66 20 74 68 l. copy of th 0aa0: 65 20 73 6f 75 72 63 65 20 74 72 65 65 2e 20 20 e source tree. 0ab0: 43 72 65 61 74 65 20 74 68 65 20 64 69 72 65 63 Create the direc 0ac0: 74 6f 72 79 20 79 6f 75 20 77 61 6e 74 20 74 6f tory you want to 0ad0: 20 62 65 0a 20 20 20 20 74 68 65 20 72 6f 6f 74 be. the root 0ae0: 20 6f 66 20 79 6f 75 72 20 74 72 65 65 20 61 6e of your tree an 0af0: 64 20 63 64 20 69 6e 74 6f 20 74 68 61 74 20 64 d cd into that d 0b00: 69 72 65 63 74 6f 72 79 2e 20 20 54 68 65 6e 0a irectory. Then. 0b10: 20 20 20 20 74 6f 20 74 68 69 73 3a 3c 2f 70 3e to this:</p> 0b20: 0a 20 20 20 20 0a 20 20 20 20 3c 62 6c 6f 63 6b . . <block 0b30: 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f quote>. <b>fo 0b40: 73 73 69 6c 20 6f 70 65 6e 20 3c 2f 62 3e 3c 69 ssil open </b><i 0b50: 3e 20 72 65 70 6f 73 69 74 6f 72 79 2d 66 69 6c > repository-fil 0b60: 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f ename</i>. </ 0b70: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 blockquote>. 0b80: 0a 20 20 20 20 3c 70 3e 54 68 69 73 20 6c 65 61 . <p>This lea 0b90: 76 65 73 20 79 6f 75 20 77 69 74 68 20 74 68 65 ves you with the 0ba0: 20 6f 72 69 67 69 6e 61 6c 20 28 65 6d 70 74 79 original (empty 0bb0: 29 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 ) version of the 0bc0: 20 74 72 65 65 0a 20 20 20 20 63 68 65 63 6b 65 tree. checke 0bd0: 64 20 6f 75 74 2e 20 20 54 6f 20 67 65 74 20 74 d out. To get t 0be0: 6f 20 74 68 65 20 6c 61 74 65 73 74 20 76 65 72 o the latest ver 0bf0: 73 69 6f 6e 2c 20 61 6c 73 6f 20 64 6f 20 74 68 sion, also do th 0c00: 69 73 3a 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 20 is:</p>. . 0c10: 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 <blockquote>. 0c20: 20 20 3c 62 3e 66 6f 73 73 69 6c 20 75 70 64 61 <b>fossil upda 0c30: 74 65 3c 2f 62 3e 0a 20 20 20 20 3c 2f 62 6c 6f te</b>. </blo 0c40: 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 0a 20 20 ckquote>. . 0c50: 20 20 3c 70 3e 46 72 6f 6d 20 61 6e 79 77 68 65 <p>From anywhe 0c60: 72 65 20 75 6e 64 65 72 6e 65 61 74 68 20 74 68 re underneath th 0c70: 65 20 72 6f 6f 74 20 6f 66 20 79 6f 75 72 20 6c e root of your l 0c80: 6f 63 61 6c 20 74 72 65 65 2c 20 79 6f 75 0a 20 ocal tree, you. 0c90: 20 20 20 63 61 6e 20 74 79 70 65 20 63 6f 6d 6d can type comm 0ca0: 61 6e 64 73 20 6c 69 6b 65 20 74 68 65 20 66 6f ands like the fo 0cb0: 6c 6c 6f 77 69 6e 67 20 74 6f 20 66 69 6e 64 20 llowing to find 0cc0: 6f 75 74 20 74 68 65 20 73 74 61 74 75 73 20 6f out the status o 0cd0: 66 0a 20 20 20 20 79 6f 75 72 20 6c 6f 63 61 6c f. your local 0ce0: 20 74 72 65 65 3a 3c 2f 70 3e 0a 0a 20 20 20 20 tree:</p>.. 0cf0: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 <blockquote>. 0d00: 20 3c 62 3e 66 6f 73 73 69 6c 20 69 6e 66 6f 3c <b>fossil info< 0d10: 2f 62 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 /b><br>. <b>f 0d20: 6f 73 73 69 6c 20 73 74 61 74 75 73 3c 2f 62 3e ossil status</b> 0d30: 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 <br>. <b>foss 0d40: 69 6c 20 63 68 61 6e 67 65 73 3c 2f 62 3e 3c 62 il changes</b><b 0d50: 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c r>. <b>fossil 0d60: 20 74 69 6d 65 6c 69 6e 65 3c 2f 62 3e 3c 62 72 timeline</b><br 0d70: 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 >. <b>fossil 0d80: 6c 65 61 76 65 73 3c 2f 62 3e 3c 62 72 3e 0a 20 leaves</b><br>. 0d90: 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6c 73 3c <b>fossil ls< 0da0: 2f 62 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 /b><br>. <b>f 0db0: 6f 73 73 69 6c 20 62 72 61 6e 63 68 65 73 3c 2f ossil branches</ 0dc0: 62 3e 3c 62 72 3e 0a 20 20 20 20 3c 2f 62 6c 6f b><br>. </blo 0dd0: 63 6b 71 75 6f 74 65 3e 0a 0a 3c 2f 62 6c 6f 63 ckquote>..</bloc 0de0: 6b 71 75 6f 74 65 3e 3c 68 32 3e 4d 61 6b 69 6e kquote><h2>Makin 0df0: 67 20 43 68 61 6e 67 65 73 3c 2f 68 32 3e 3c 62 g Changes</h2><b 0e00: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 lockquote>.. 0e10: 3c 70 3e 54 6f 20 61 64 64 20 6e 65 77 20 66 69 <p>To add new fi 0e20: 6c 65 73 20 74 6f 20 79 6f 75 72 20 70 72 6f 6a les to your proj 0e30: 65 63 74 2c 20 6f 72 20 72 65 6d 6f 76 65 20 6f ect, or remove o 0e40: 6c 64 20 66 69 6c 65 73 2c 20 75 73 65 20 74 68 ld files, use th 0e50: 65 73 65 0a 20 20 20 20 63 6f 6d 6d 61 6e 64 73 ese. commands 0e60: 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 :</p>.. <bloc 0e70: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 kquote>. <b>f 0e80: 6f 73 73 69 6c 20 61 64 64 3c 2f 62 3e 20 3c 69 ossil add</b> <i 0e90: 3e 66 69 6c 65 2e 2e 2e 3c 2f 69 3e 3c 62 72 3e >file...</i><br> 0ea0: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 72 . <b>fossil r 0eb0: 6d 3c 2f 62 3e 20 3c 69 3e 66 69 6c 65 2e 2e 2e m</b> <i>file... 0ec0: 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b </i>. </block 0ed0: 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 59 quote>.. <p>Y 0ee0: 6f 75 20 63 61 6e 20 61 6c 73 6f 20 65 64 69 74 ou can also edit 0ef0: 20 66 69 6c 65 73 20 66 72 65 65 6c 79 2e 20 20 files freely. 0f00: 4f 6e 63 65 20 79 6f 75 20 61 72 65 20 72 65 61 Once you are rea 0f10: 64 79 20 74 6f 20 63 6f 6d 6d 69 74 0a 20 20 20 dy to commit. 0f20: 20 79 6f 75 72 20 63 68 61 6e 67 65 73 2c 20 74 your changes, t 0f30: 79 70 65 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 ype:</p>.. <b 0f40: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c lockquote>. < 0f50: 62 3e 66 6f 73 73 69 6c 20 63 6f 6d 6d 69 74 3c b>fossil commit< 0f60: 2f 62 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 /b>. </blockq 0f70: 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 59 6f uote>.. <p>Yo 0f80: 75 20 77 69 6c 6c 20 62 65 20 70 72 6f 6d 70 74 u will be prompt 0f90: 65 64 20 66 6f 72 20 63 68 65 63 6b 2d 69 6e 20 ed for check-in 0fa0: 63 6f 6d 6d 65 6e 74 73 20 75 73 69 6e 67 20 77 comments using w 0fb0: 68 61 74 65 76 65 72 20 65 64 69 74 6f 72 0a 20 hatever editor. 0fc0: 20 20 20 69 73 20 73 70 65 63 69 66 69 65 64 20 is specified 0fd0: 62 79 20 79 6f 75 72 20 56 49 53 55 41 4c 20 6f by your VISUAL o 0fe0: 72 20 45 44 49 54 4f 52 20 65 6e 76 69 72 6f 6e r EDITOR environ 0ff0: 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 2e 20 20 ment variable. 1000: 49 66 20 79 6f 75 0a 20 20 20 20 68 61 76 65 20 If you. have 1010: 47 50 47 20 69 6e 73 74 61 6c 6c 65 64 2c 20 79 GPG installed, y 1020: 6f 75 20 6d 61 79 20 62 65 20 70 72 6f 6d 70 74 ou may be prompt 1030: 65 64 20 66 6f 72 20 79 6f 75 72 20 47 50 47 20 ed for your GPG 1040: 70 61 73 73 70 68 72 61 73 65 20 73 6f 0a 20 20 passphrase so. 1050: 20 20 74 68 61 74 20 74 68 65 20 63 68 65 63 6b that the check 1060: 2d 69 6e 20 63 61 6e 20 62 65 20 73 69 67 6e 65 -in can be signe 1070: 64 20 77 69 74 68 20 79 6f 75 72 20 47 50 47 20 d with your GPG 1080: 73 69 67 6e 61 74 75 72 65 2e 20 20 41 66 74 65 signature. Afte 1090: 72 0a 20 20 20 20 74 68 69 73 20 79 6f 75 72 20 r. this your 10a0: 63 68 61 6e 67 65 73 20 77 69 6c 6c 20 62 65 20 changes will be 10b0: 63 68 65 63 6b 65 64 20 69 6e 2e 3c 2f 70 3e 0a checked in.</p>. 10c0: 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 .</blockquote><h 10d0: 32 3e 53 68 61 72 69 6e 67 20 43 68 61 6e 67 65 2>Sharing Change 10e0: 73 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 s</h2><blockquot 10f0: 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 63 e>.. <p>The c 1100: 68 61 6e 67 65 73 20 79 6f 75 20 3c 62 3e 63 6f hanges you <b>co 1110: 6d 6d 69 74 3c 2f 62 3e 20 61 72 65 20 6f 6e 6c mmit</b> are onl 1120: 79 20 6f 6e 20 79 6f 75 72 20 6c 6f 63 61 6c 20 y on your local 1130: 72 65 70 6f 73 69 74 6f 72 79 2e 0a 20 20 20 20 repository.. 1140: 54 6f 20 73 68 61 72 65 20 74 68 6f 73 65 20 63 To share those c 1150: 68 61 6e 67 65 73 20 77 69 74 68 20 6f 74 68 65 hanges with othe 1160: 72 20 72 65 70 6f 73 69 74 6f 72 69 65 73 2c 20 r repositories, 1170: 64 6f 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c do:</p>.. <bl 1180: 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 ockquote>. <b 1190: 3e 66 6f 73 73 69 6c 20 70 75 73 68 3c 2f 62 3e >fossil push</b> 11a0: 20 3c 69 3e 55 52 4c 3c 2f 69 3e 0a 20 20 20 20 <i>URL</i>. 11b0: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 </blockquote>.. 11c0: 20 20 20 3c 70 3e 57 68 65 72 65 20 3c 69 3e 55 <p>Where <i>U 11d0: 52 4c 3c 2f 69 3e 20 69 73 20 74 68 65 20 68 74 RL</i> is the ht 11e0: 74 70 3a 20 55 52 4c 20 6f 66 20 74 68 65 20 73 tp: URL of the s 11f0: 65 72 76 65 72 20 72 65 70 6f 73 69 74 6f 72 79 erver repository 1200: 20 79 6f 75 0a 20 20 20 20 77 61 6e 74 20 74 6f you. want to 1210: 20 73 68 61 72 65 20 79 6f 75 72 20 63 68 61 6e share your chan 1220: 67 65 73 20 77 69 74 68 2e 20 20 49 66 20 79 6f ges with. If yo 1230: 75 20 6f 6d 69 74 20 74 68 65 20 3c 69 3e 55 52 u omit the <i>UR 1240: 4c 3c 2f 69 3e 20 61 72 67 75 6d 65 6e 74 2c 0a L</i> argument,. 1250: 20 20 20 20 66 6f 73 73 69 6c 20 77 69 6c 6c 20 fossil will 1260: 75 73 65 20 77 68 61 74 65 76 65 72 20 73 65 72 use whatever ser 1270: 76 65 72 20 79 6f 75 20 6d 6f 73 74 20 72 65 63 ver you most rec 1280: 65 6e 74 6c 79 20 73 79 6e 63 65 64 20 77 69 74 ently synced wit 1290: 68 2e 3c 2f 70 3e 0a 0a 20 20 20 20 3c 70 3e 54 h.</p>.. <p>T 12a0: 68 65 20 3c 62 3e 70 75 73 68 3c 2f 62 3e 20 63 he <b>push</b> c 12b0: 6f 6d 6d 61 6e 64 20 6f 6e 6c 79 20 73 65 6e 64 ommand only send 12c0: 73 20 79 6f 75 72 20 63 68 61 6e 67 65 73 20 74 s your changes t 12d0: 6f 20 6f 74 68 65 72 73 2e 20 20 54 6f 0a 20 20 o others. To. 12e0: 20 20 52 65 63 65 69 76 65 20 63 68 61 6e 67 65 Receive change 12f0: 73 20 66 72 6f 6d 20 6f 74 68 65 72 73 2c 20 75 s from others, u 1300: 73 65 20 3c 62 3e 70 75 6c 6c 3c 2f 62 3e 2e 20 se <b>pull</b>. 1310: 20 4f 72 20 67 6f 20 62 6f 74 68 20 77 61 79 73 Or go both ways 1320: 20 61 74 0a 20 20 20 20 6f 6e 63 65 20 75 73 69 at. once usi 1330: 6e 67 20 3c 62 3e 73 79 6e 63 3c 2f 62 3e 3a 3c ng <b>sync</b>:< 1340: 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 /p>.. <blockq 1350: 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 uote>. <b>fos 1360: 73 69 6c 20 70 75 6c 6c 3c 2f 62 3e 20 3c 69 3e sil pull</b> <i> 1370: 55 52 4c 3c 2f 69 3e 3c 62 72 3e 0a 20 20 20 20 URL</i><br>. 1380: 3c 62 3e 66 6f 73 73 69 6c 20 73 79 6e 63 3c 2f <b>fossil sync</ 1390: 62 3e 20 3c 69 3e 55 52 4c 3c 2f 69 3e 0a 20 20 b> <i>URL</i>. 13a0: 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a </blockquote>. 13b0: 0a 20 20 20 20 3c 70 3e 57 68 65 6e 20 79 6f 75 . <p>When you 13c0: 20 70 75 6c 6c 20 69 6e 20 63 68 61 6e 67 65 73 pull in changes 13d0: 20 66 72 6f 6d 20 6f 74 68 65 72 73 2c 20 74 68 from others, th 13e0: 65 79 20 67 6f 20 69 6e 74 6f 20 79 6f 75 72 20 ey go into your 13f0: 72 65 70 6f 73 69 74 6f 72 79 2c 0a 20 20 20 20 repository,. 1400: 6e 6f 74 20 69 6e 74 6f 20 79 6f 75 72 20 63 68 not into your ch 1410: 65 63 6b 65 64 2d 6f 75 74 20 6c 6f 63 61 6c 20 ecked-out local 1420: 74 72 65 65 2e 20 20 54 6f 20 67 65 74 20 74 68 tree. To get th 1430: 65 20 63 68 61 6e 67 65 73 20 69 6e 74 6f 20 79 e changes into y 1440: 6f 75 72 0a 20 20 20 20 6c 6f 63 61 6c 20 74 72 our. local tr 1450: 65 65 2c 20 75 73 65 20 3c 62 3e 75 70 64 61 74 ee, use <b>updat 1460: 65 3c 2f 62 3e 3a 3c 2f 70 3e 0a 0a 20 20 20 20 e</b>:</p>.. 1470: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 <blockquote>. 1480: 20 3c 62 3e 66 6f 73 73 69 6c 20 75 70 64 61 74 <b>fossil updat 1490: 65 3c 2f 62 3e 20 3c 69 3e 55 55 49 44 3c 2f 69 e</b> <i>UUID</i 14a0: 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f >. </blockquo 14b0: 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 te>.. <p>The 14c0: 3c 69 3e 55 55 49 44 3c 2f 69 3e 20 69 73 20 73 <i>UUID</i> is s 14d0: 6f 6d 65 20 75 6e 69 71 75 65 20 61 62 62 72 65 ome unique abbre 14e0: 76 69 61 74 69 6f 6e 20 74 6f 20 74 68 65 20 34 viation to the 4 14f0: 30 2d 63 68 61 72 61 63 74 65 72 0a 20 20 20 20 0-character. 1500: 76 65 72 73 69 6f 6e 20 49 44 2e 20 20 49 66 20 version ID. If 1510: 79 6f 75 20 6f 6d 69 74 20 74 68 65 20 3c 69 3e you omit the <i> 1520: 55 55 49 44 3c 2f 69 3e 20 66 6f 73 73 69 6c 20 UUID</i> fossil 1530: 6d 6f 76 65 73 20 79 6f 75 20 74 6f 20 74 68 65 moves you to the 1540: 0a 20 20 20 20 6c 65 61 66 20 76 65 72 73 69 6f . leaf versio 1550: 6e 20 6f 66 20 74 68 65 20 62 72 61 6e 63 68 20 n of the branch 1560: 79 6f 75 72 20 61 72 65 20 63 75 72 72 65 6e 74 your are current 1570: 6c 79 20 6f 6e 2e 20 20 49 66 20 79 6f 75 72 20 ly on. If your 1580: 62 72 61 6e 63 68 0a 20 20 20 20 68 61 73 20 6d branch. has m 1590: 75 6c 74 69 70 6c 65 20 6c 65 61 76 65 73 2c 20 ultiple leaves, 15a0: 79 6f 75 20 67 65 74 20 61 6e 20 65 72 72 6f 72 you get an error 15b0: 20 2d 20 79 6f 75 27 6c 6c 20 68 61 76 65 20 74 - you'll have t 15c0: 6f 20 73 70 65 63 69 66 79 20 74 68 65 0a 20 20 o specify the. 15d0: 20 20 6c 65 61 66 20 79 6f 75 20 77 61 6e 74 20 leaf you want 15e0: 75 73 69 6e 67 20 61 20 3c 69 3e 55 55 49 44 3c using a <i>UUID< 15f0: 2f 69 3e 20 61 72 67 75 6d 65 6e 74 2e 3c 2f 70 /i> argument.</p 1600: 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e >..</blockquote> 1610: 3c 68 32 3e 42 72 61 6e 63 68 69 6e 67 20 41 6e <h2>Branching An 1620: 64 20 4d 65 72 67 69 6e 67 3c 2f 68 32 3e 3c 62 d Merging</h2><b 1630: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 lockquote>.. 1640: 3c 70 3e 59 6f 75 20 63 61 6e 20 63 72 65 61 74 <p>You can creat 1650: 65 20 62 72 61 6e 63 68 65 73 20 62 79 20 64 6f e branches by do 1660: 69 6e 67 20 6d 75 6c 74 69 70 6c 65 20 63 6f 6d ing multiple com 1670: 6d 69 74 73 20 6f 66 66 20 6f 66 20 74 68 65 0a mits off of the. 1680: 20 20 20 20 73 61 6d 65 20 62 61 73 65 20 76 65 same base ve 1690: 72 73 69 6f 6e 2e 20 20 54 6f 20 6d 65 72 67 65 rsion. To merge 16a0: 20 74 6f 20 62 72 61 6e 63 68 65 73 20 62 61 63 to branches bac 16b0: 6b 20 74 6f 67 65 74 68 65 72 2c 20 66 69 72 73 k together, firs 16c0: 74 0a 20 20 20 20 3c 62 3e 75 70 64 61 74 65 3c t. <b>update< 16d0: 2f 62 3e 20 74 6f 20 74 68 65 20 6c 65 61 66 20 /b> to the leaf 16e0: 6f 66 20 6f 6e 65 20 62 72 61 6e 63 68 2e 20 20 of one branch. 16f0: 54 68 65 6e 20 64 6f 20 61 20 3c 62 3e 6d 65 72 Then do a <b>mer 1700: 67 65 3c 2f 62 3e 0a 20 20 20 20 6f 66 20 74 68 ge</b>. of th 1710: 65 20 6c 65 61 66 20 6f 66 20 74 68 65 20 6f 74 e leaf of the ot 1720: 68 65 72 20 62 72 61 6e 63 68 3a 3c 2f 70 3e 0a her branch:</p>. 1730: 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 . <blockquote 1740: 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 >. <b>fossil 1750: 6d 65 72 67 65 3c 2f 62 3e 20 3c 69 3e 55 55 49 merge</b> <i>UUI 1760: 44 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 D</i>. </bloc 1770: 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e kquote>.. <p> 1780: 54 65 73 74 20 74 6f 20 6d 61 6b 65 20 73 75 72 Test to make sur 1790: 65 20 79 6f 75 72 20 6d 65 72 67 65 20 64 69 64 e your merge did 17a0: 6e 27 74 20 6d 65 73 73 20 75 70 20 74 68 65 20 n't mess up the 17b0: 63 6f 64 65 2c 20 74 68 65 6e 0a 20 20 20 20 3c code, then. < 17c0: 62 3e 63 6f 6d 6d 69 74 3c 2f 62 3e 20 61 6e 64 b>commit</b> and 17d0: 20 70 6f 73 73 69 62 6c 79 20 61 6c 73 6f 20 3c possibly also < 17e0: 62 3e 70 75 73 68 3c 2f 62 3e 20 79 6f 75 72 20 b>push</b> your 17f0: 63 68 61 6e 67 65 73 2e 20 20 20 52 65 6d 65 6d changes. Remem 1800: 62 65 72 0a 20 20 20 20 74 68 61 74 20 6e 6f 62 ber. that nob 1810: 6f 64 79 20 65 6c 73 65 20 63 61 6e 20 73 65 65 ody else can see 1820: 20 79 6f 75 72 20 63 68 61 6e 67 65 73 20 75 6e your changes un 1830: 74 69 6c 20 79 6f 75 20 3c 62 3e 63 6f 6d 6d 69 til you <b>commi 1840: 74 3c 2f 62 3e 20 61 6e 64 0a 20 20 20 20 69 66 t</b> and. if 1850: 20 6f 74 68 65 72 20 61 72 65 20 75 73 69 6e 67 other are using 1860: 20 61 20 64 69 66 66 65 72 65 6e 74 20 72 65 70 a different rep 1870: 6f 73 69 74 6f 72 79 20 79 6f 75 20 77 69 6c 6c ository you will 1880: 20 61 6c 73 6f 20 6e 65 65 64 20 74 6f 0a 20 20 also need to. 1890: 20 20 3c 62 3e 70 75 73 68 3c 2f 62 3e 2e 3c 2f <b>push</b>.</ 18a0: 70 3e 0a 0a 3c 61 20 6e 61 6d 65 3d 22 73 65 72 p>..<a name="ser 18b0: 76 65 72 73 65 74 75 70 22 3e 0a 3c 2f 62 6c 6f versetup">.</blo 18c0: 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 53 65 74 74 ckquote><h2>Sett 18d0: 69 6e 67 20 55 70 20 41 20 53 65 72 76 65 72 3c ing Up A Server< 18e0: 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e /h2><blockquote> 18f0: 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 65 61 73 .. <p>The eas 1900: 69 65 73 74 20 77 61 79 20 74 6f 20 73 65 74 20 iest way to set 1910: 75 70 20 61 20 73 65 72 76 65 72 20 69 73 3a 3c up a server is:< 1920: 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 /p>.. <blockq 1930: 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 uote>. <b>fos 1940: 73 69 6c 20 73 65 72 76 65 72 3c 2f 62 3e 20 3c sil server</b> < 1950: 69 3e 72 65 70 6f 73 69 74 6f 72 79 2d 66 69 6c i>repository-fil 1960: 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f ename</i>. </ 1970: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 blockquote>.. 1980: 20 3c 70 3e 59 6f 75 20 63 61 6e 20 6f 6d 69 74 <p>You can omit 1990: 20 74 68 65 20 3c 69 3e 72 65 70 6f 73 69 74 6f the <i>reposito 19a0: 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 20 ry-filename</i> 19b0: 69 66 20 79 6f 75 20 61 72 65 20 77 69 74 68 69 if you are withi 19c0: 6e 0a 20 20 20 20 61 20 63 68 65 63 6b 65 64 2d n. a checked- 19d0: 6f 75 74 20 6c 6f 63 61 6c 20 74 72 65 65 2e 20 out local tree. 19e0: 20 54 68 69 73 20 73 65 72 76 65 72 20 75 73 65 This server use 19f0: 73 20 70 6f 72 74 20 38 30 38 30 20 62 79 20 64 s port 8080 by d 1a00: 65 66 61 75 6c 74 0a 20 20 20 20 62 75 74 20 79 efault. but y 1a10: 6f 75 20 63 61 6e 20 73 70 65 63 69 66 79 20 61 ou can specify a 1a20: 20 64 69 66 66 65 72 65 6e 74 20 70 6f 72 74 20 different port 1a30: 75 73 69 6e 67 20 74 68 65 20 3c 62 3e 2d 70 6f using the <b>-po 1a40: 72 74 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 2e 3c rt</b> command.< 1a50: 2f 70 3e 0a 0a 20 20 20 20 3c 70 3e 43 6f 6d 6d /p>.. <p>Comm 1a60: 61 6e 64 2d 6c 69 6e 65 20 73 65 72 76 65 72 73 and-line servers 1a70: 20 6c 69 6b 65 20 74 68 69 73 20 61 72 65 20 75 like this are u 1a80: 73 65 66 75 6c 20 77 68 65 6e 20 74 77 6f 20 70 seful when two p 1a90: 65 6f 70 6c 65 20 77 61 6e 74 0a 20 20 20 20 74 eople want. t 1aa0: 6f 20 73 68 61 72 65 20 61 20 72 65 70 6f 73 69 o share a reposi 1ab0: 74 6f 72 79 20 6f 6e 20 74 65 6d 70 6f 72 61 72 tory on temporar 1ac0: 79 20 6f 72 20 61 64 2d 68 6f 63 20 62 61 73 69 y or ad-hoc basi 1ad0: 73 2e 20 20 46 6f 72 20 61 20 6d 6f 72 65 0a 20 s. For a more. 1ae0: 20 20 20 70 65 72 6d 61 6e 65 6e 74 20 69 6e 73 permanent ins 1af0: 74 61 6c 6c 61 74 69 6f 6e 2c 20 79 6f 75 20 73 tallation, you s 1b00: 68 6f 75 6c 64 20 75 73 65 20 65 69 74 68 65 72 hould use either 1b10: 20 74 68 65 20 43 47 49 20 73 65 72 76 65 72 20 the CGI server 1b20: 6f 72 20 74 68 65 0a 20 20 20 20 69 6e 65 74 64 or the. inetd 1b30: 20 73 65 72 76 65 72 2e 20 20 54 6f 20 75 73 65 server. To use 1b40: 20 74 68 65 20 43 47 49 20 73 65 72 76 65 72 2c the CGI server, 1b50: 20 63 72 65 61 74 65 20 61 20 43 47 49 20 73 63 create a CGI sc 1b60: 72 69 70 74 20 74 68 61 74 0a 20 20 20 20 6c 6f ript that. lo 1b70: 6f 6b 73 20 73 6f 6d 65 74 68 69 6e 67 20 6c 69 oks something li 1b80: 6b 65 20 74 68 69 73 3a 3c 2f 70 3e 0a 0a 20 20 ke this:</p>.. 1b90: 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 62 <blockquote><b 1ba0: 3e 0a 20 20 20 20 23 21 2f 75 73 72 2f 6c 6f 63 >. #!/usr/loc 1bb0: 61 6c 2f 62 69 6e 2f 66 6f 73 73 69 6c 3c 62 72 al/bin/fossil<br 1bc0: 3e 0a 20 20 20 20 72 65 70 6f 73 69 74 6f 72 79 >. repository 1bd0: 3a 20 2f 68 6f 6d 65 2f 70 72 6f 6a 31 2f 72 65 : /home/proj1/re 1be0: 70 6f 73 31 2e 66 73 6c 0a 20 20 20 20 3c 2f 62 pos1.fsl. </b 1bf0: 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a ></blockquote>.. 1c00: 20 20 20 20 3c 70 3e 41 64 6a 75 73 74 20 74 68 <p>Adjust th 1c10: 65 20 70 61 74 68 73 20 69 6e 20 74 68 69 73 20 e paths in this 1c20: 43 47 49 20 73 63 72 69 70 74 20 74 6f 20 6d 61 CGI script to ma 1c30: 74 63 68 20 79 6f 75 72 20 69 6e 73 74 61 6c 6c tch your install 1c40: 61 74 69 6f 6e 2e 0a 20 20 20 20 4e 6f 77 20 70 ation.. Now p 1c50: 6f 69 6e 74 20 63 6c 69 65 6e 74 73 20 61 74 20 oint clients at 1c60: 74 68 65 20 43 47 49 20 73 63 72 69 70 74 2e 20 the CGI script. 1c70: 20 54 68 61 74 27 73 20 61 6c 6c 20 74 68 65 72 That's all ther 1c80: 65 20 69 73 20 74 6f 20 69 74 21 3c 2f 70 3e 0a e is to it!</p>. 1c90: 0a 20 20 20 20 3c 70 3e 59 6f 75 20 63 61 6e 20 . <p>You can 1ca0: 61 6c 73 6f 20 72 75 6e 20 66 6f 73 73 69 6c 20 also run fossil 1cb0: 6f 66 66 20 6f 66 20 69 6e 65 74 64 20 6f 72 20 off of inetd or 1cc0: 78 69 6e 65 74 64 2e 20 20 46 6f 72 20 61 6e 20 xinetd. For an 1cd0: 69 6e 65 74 64 0a 20 20 20 20 69 6e 73 74 61 6c inetd. instal 1ce0: 6c 61 74 69 6f 6e 2c 20 6d 61 6b 65 20 61 6e 20 lation, make an 1cf0: 65 6e 74 72 79 20 69 6e 20 2f 65 74 63 2f 69 6e entry in /etc/in 1d00: 65 74 64 2e 63 6f 6e 66 20 74 68 61 74 20 6c 6f etd.conf that lo 1d10: 6f 6b 73 20 73 6f 6d 65 74 68 69 6e 67 0a 20 20 oks something. 1d20: 20 20 6c 69 6b 65 20 74 68 69 73 3a 3c 2f 70 3e like this:</p> 1d30: 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 .. <blockquot 1d40: 65 3e 3c 62 3e 0a 20 20 20 20 38 30 20 73 74 72 e><b>. 80 str 1d50: 65 61 6d 20 74 63 70 20 6e 6f 77 61 69 74 2e 31 eam tcp nowait.1 1d60: 30 30 30 20 72 6f 6f 74 20 2f 75 73 72 2f 62 69 000 root /usr/bi 1d70: 6e 2f 66 6f 73 73 69 6c 20 5c 3c 62 72 3e 0a 20 n/fossil \<br>. 1d80: 20 20 20 20 20 20 20 2f 75 73 72 2f 62 69 6e 2f /usr/bin/ 1d90: 66 6f 73 73 69 6c 20 68 74 74 70 20 2f 68 6f 6d fossil http /hom 1da0: 65 2f 70 72 6f 6a 31 2f 72 65 70 6f 73 31 2e 66 e/proj1/repos1.f 1db0: 73 6c 0a 20 20 20 20 3c 2f 62 3e 3c 2f 62 6c 6f sl. </b></blo 1dc0: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 ckquote>.. <p 1dd0: 3e 41 64 6a 75 73 74 20 74 68 65 20 70 61 74 68 >Adjust the path 1de0: 73 20 74 6f 20 73 75 69 74 20 79 6f 75 72 20 69 s to suit your i 1df0: 6e 73 74 61 6c 6c 61 74 69 6f 6e 2c 20 6f 66 20 nstallation, of 1e00: 63 6f 75 72 73 65 2e 20 20 4e 6f 74 69 63 65 20 course. Notice 1e10: 74 68 61 74 0a 20 20 20 20 66 6f 73 73 69 6c 20 that. fossil 1e20: 72 75 6e 73 20 61 73 20 72 6f 6f 74 2e 20 20 54 runs as root. T 1e30: 68 69 73 20 69 73 20 6e 6f 74 20 72 65 71 75 69 his is not requi 1e40: 72 65 64 20 2d 20 79 6f 75 20 63 61 6e 20 72 75 red - you can ru 1e50: 6e 20 69 74 20 61 73 20 61 6e 0a 20 20 20 20 75 n it as an. u 1e60: 6e 70 72 69 76 69 6c 65 67 65 64 20 75 73 65 72 nprivileged user 1e70: 2e 20 20 42 75 74 20 69 74 20 69 73 20 6d 6f 72 . But it is mor 1e80: 65 20 73 65 63 75 72 65 20 74 6f 20 72 75 6e 20 e secure to run 1e90: 66 6f 73 73 69 6c 20 61 73 20 72 6f 6f 74 2e 0a fossil as root.. 1ea0: 20 20 20 20 57 68 65 6e 20 79 6f 75 20 64 6f 20 When you do 1eb0: 72 75 6e 20 66 6f 73 73 69 6c 20 61 73 20 72 6f run fossil as ro 1ec0: 6f 74 2c 20 69 74 20 61 75 74 6f 6d 61 74 69 63 ot, it automatic 1ed0: 61 6c 6c 79 20 70 75 74 73 20 69 74 73 65 6c 66 ally puts itself 1ee0: 20 69 6e 20 61 0a 20 20 20 20 63 68 72 6f 6f 74 in a. chroot 1ef0: 20 6a 61 69 6c 20 69 6e 20 74 68 65 20 73 61 6d jail in the sam 1f00: 65 20 64 69 72 65 63 74 6f 72 79 20 61 73 20 74 e directory as t 1f10: 68 65 20 72 65 70 6f 73 69 74 6f 72 79 2c 20 74 he repository, t 1f20: 68 65 6e 20 64 72 6f 70 73 0a 20 20 20 20 72 6f hen drops. ro 1f30: 6f 74 20 70 72 69 76 69 6c 65 67 65 73 20 70 72 ot privileges pr 1f40: 69 6f 72 20 74 6f 20 72 65 61 64 69 6e 67 20 61 ior to reading a 1f50: 6e 79 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 ny information f 1f60: 72 6f 6d 20 74 68 65 20 72 65 71 75 65 73 74 2e rom the request. 1f70: 3c 2f 70 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f </p>..</blockquo 1f80: 74 65 3e 3c 61 20 6e 61 6d 65 3d 22 70 72 6f 78 te><a name="prox 1f90: 79 22 3e 3c 2f 61 3e 3c 68 32 3e 48 54 54 50 20 y"></a><h2>HTTP 1fa0: 50 72 6f 78 69 65 73 3c 2f 68 32 3e 3c 62 6c 6f Proxies</h2><blo 1fb0: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 ckquote>.. <p 1fc0: 3e 49 66 20 79 6f 75 20 61 72 65 20 62 65 68 69 >If you are behi 1fd0: 6e 64 20 61 20 72 65 73 74 72 69 63 74 69 76 65 nd a restrictive 1fe0: 20 66 69 72 65 77 61 6c 6c 20 74 68 61 74 20 72 firewall that r 1ff0: 65 71 75 69 72 65 73 20 79 6f 75 20 74 6f 20 75 equires you to u 2000: 73 65 0a 20 20 20 20 61 6e 20 48 54 54 50 20 70 se. an HTTP p 2010: 72 6f 78 79 20 74 6f 20 72 65 61 63 68 20 74 68 roxy to reach th 2020: 65 20 69 6e 74 65 72 6e 65 74 2c 20 74 68 65 6e e internet, then 2030: 20 79 6f 75 20 63 61 6e 20 63 6f 6e 66 69 67 75 you can configu 2040: 72 65 20 74 68 65 20 70 72 6f 78 79 0a 20 20 20 re the proxy. 2050: 20 69 6e 20 74 68 72 65 65 20 64 69 66 66 65 72 in three differ 2060: 65 6e 74 20 77 61 79 73 2e 20 20 59 6f 75 20 63 ent ways. You c 2070: 61 6e 20 74 65 6c 6c 20 66 6f 73 73 69 6c 20 61 an tell fossil a 2080: 62 6f 75 74 20 79 6f 75 72 20 70 72 6f 78 79 20 bout your proxy 2090: 75 73 69 6e 67 0a 20 20 20 20 61 20 63 6f 6d 6d using. a comm 20a0: 61 6e 64 2d 6c 69 6e 65 20 6f 70 74 69 6f 6e 20 and-line option 20b0: 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 on commands that 20c0: 20 75 73 65 20 74 68 65 20 6e 65 74 77 6f 72 6b use the network 20d0: 2c 0a 20 20 20 20 3c 62 3e 73 79 6e 63 3c 2f 62 ,. <b>sync</b 20e0: 3e 2c 20 3c 62 3e 63 6c 6f 6e 65 3c 2f 62 3e 2c >, <b>clone</b>, 20f0: 20 3c 62 3e 70 75 73 68 3c 2f 62 3e 2c 20 61 6e <b>push</b>, an 2100: 64 20 3c 62 3e 70 75 6c 6c 3c 2f 62 3e 2e 3c 2f d <b>pull</b>.</ 2110: 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 p>.. <blockqu 2120: 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 ote>. <b>foss 2130: 69 6c 20 63 6c 6f 6e 65 20 3c 2f 62 3e 3c 69 3e il clone </b><i> 2140: 55 52 4c 3c 2f 69 3e 20 20 3c 62 3e 2d 2d 70 72 URL</i> <b>--pr 2150: 6f 78 79 3c 2f 62 3e 20 3c 69 3e 50 72 6f 78 79 oxy</b> <i>Proxy 2160: 2d 55 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 -URL</i>. </b 2170: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 lockquote>.. 2180: 3c 70 3e 49 74 20 69 73 20 61 6e 6e 6f 79 69 6e <p>It is annoyin 2190: 67 20 74 6f 20 68 61 76 65 20 74 6f 20 74 79 70 g to have to typ 21a0: 65 20 69 6e 20 74 68 65 20 70 72 6f 78 79 20 55 e in the proxy U 21b0: 52 4c 20 65 76 65 72 79 20 74 69 6d 65 20 79 6f RL every time yo 21c0: 75 0a 20 20 20 20 73 79 6e 63 20 79 6f 75 72 20 u. sync your 21d0: 70 72 6f 6a 65 63 74 2c 20 74 68 6f 75 67 68 2c project, though, 21e0: 20 73 6f 20 79 6f 75 20 63 61 6e 20 6d 61 6b 65 so you can make 21f0: 20 74 68 65 20 70 72 6f 78 79 20 63 6f 6e 66 69 the proxy confi 2200: 67 75 72 61 74 69 6f 6e 0a 20 20 20 20 70 65 72 guration. per 2210: 73 69 73 74 65 6e 74 20 75 73 69 6e 67 20 74 68 sistent using th 2220: 65 20 3c 62 3e 73 65 74 74 69 6e 67 3c 2f 62 3e e <b>setting</b> 2230: 20 63 6f 6d 6d 61 6e 64 3a 3c 2f 70 3e 0a 0a 20 command:</p>.. 2240: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a <blockquote>. 2250: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 73 65 <b>fossil se 2260: 74 74 69 6e 67 20 70 72 6f 78 79 20 3c 2f 62 3e tting proxy </b> 2270: 3c 69 3e 50 72 6f 78 79 2d 55 52 4c 3c 2f 69 3e <i>Proxy-URL</i> 2280: 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 . </blockquot 2290: 65 3e 0a 0a 20 20 20 20 3c 70 3e 4f 72 2c 20 79 e>.. <p>Or, y 22a0: 6f 75 20 63 61 6e 20 73 65 74 20 74 68 65 20 22 ou can set the " 22b0: 3c 62 3e 68 74 74 70 5f 70 72 6f 78 79 3c 2f 62 <b>http_proxy</b 22c0: 3e 22 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 >" environment v 22d0: 61 72 69 61 62 6c 65 3a 3c 2f 70 3e 0a 0a 20 20 ariable:</p>.. 22e0: 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 <blockquote>. 22f0: 20 20 20 3c 62 3e 65 78 70 6f 72 74 20 68 74 74 <b>export htt 2300: 70 5f 70 72 6f 78 79 3d 3c 2f 62 3e 3c 69 3e 50 p_proxy=</b><i>P 2310: 72 6f 78 79 2d 55 52 4c 3c 2f 69 3e 0a 20 20 20 roxy-URL</i>. 2320: 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a </blockquote>.. 2330: 20 20 20 20 3c 70 3e 54 6f 20 73 74 6f 70 20 75 <p>To stop u 2340: 73 69 6e 67 20 74 68 65 20 70 72 6f 78 79 2c 20 sing the proxy, 2350: 64 6f 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c do:</p>.. <bl 2360: 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 ockquote>. <b 2370: 3e 66 6f 73 73 69 6c 20 73 65 74 74 69 6e 67 20 >fossil setting 2380: 70 72 6f 78 79 20 6f 66 66 3c 2f 62 3e 0a 20 20 proxy off</b>. 2390: 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a </blockquote>. 23a0: 0a 20 20 20 20 3c 70 3e 4f 72 20 75 6e 73 65 74 . <p>Or unset 23b0: 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 the environment 23c0: 20 76 61 72 69 61 62 6c 65 2e 20 20 54 68 65 20 variable. The 23d0: 66 6f 73 73 69 6c 20 73 65 74 74 69 6e 67 20 66 fossil setting f 23e0: 6f 72 20 74 68 65 0a 20 20 20 20 48 54 54 50 20 or the. HTTP 23f0: 70 72 6f 78 79 20 74 61 6b 65 73 20 70 72 65 63 proxy takes prec 2400: 65 64 65 6e 63 65 20 6f 76 65 72 20 74 68 65 20 edence over the 2410: 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 environment vari 2420: 61 62 6c 65 20 61 6e 64 20 74 68 65 0a 20 20 20 able and the. 2430: 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 6f 70 command-line op 2440: 74 69 6f 6e 20 6f 76 65 72 72 69 64 65 73 20 62 tion overrides b 2450: 6f 74 68 2e 20 20 49 66 20 79 6f 75 20 68 61 76 oth. If you hav 2460: 65 20 61 6e 20 70 65 72 73 69 73 74 65 6e 74 0a e an persistent. 2470: 20 20 20 20 70 72 6f 78 79 20 73 65 74 74 69 6e proxy settin 2480: 67 20 74 68 61 74 20 79 6f 75 20 77 61 6e 74 20 g that you want 2490: 74 6f 20 6f 76 65 72 72 69 64 65 20 66 6f 72 20 to override for 24a0: 61 20 6f 6e 65 2d 74 69 6d 65 20 73 79 6e 63 2c a one-time sync, 24b0: 20 74 68 61 74 0a 20 20 20 20 69 73 20 65 61 73 that. is eas 24c0: 69 6c 79 20 64 6f 6e 65 20 6f 6e 20 74 68 65 20 ily done on the 24d0: 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 2e 20 20 46 command-line. F 24e0: 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74 6f 20 73 or example, to s 24f0: 79 6e 63 20 77 69 74 68 0a 20 20 20 20 61 20 63 ync with. a c 2500: 6f 2d 77 6f 72 6b 65 72 73 20 72 65 70 6f 73 69 o-workers reposi 2510: 74 6f 72 79 20 6f 6e 20 79 6f 75 72 20 4c 41 4e tory on your LAN 2520: 2c 20 79 6f 75 20 6d 69 67 68 74 20 74 79 70 65 , you might type 2530: 3a 3c 2f 70 3e 20 20 20 0a 0a 20 20 20 20 3c 62 :</p> .. <b 2540: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c lockquote>. < 2550: 62 3e 66 6f 73 73 69 6c 20 73 79 6e 63 20 68 74 b>fossil sync ht 2560: 74 70 3a 2f 2f 31 39 32 2e 31 36 38 2e 31 2e 33 tp://192.168.1.3 2570: 36 3a 38 30 38 30 2f 20 2d 2d 70 72 6f 78 79 20 6:8080/ --proxy 2580: 6f 66 66 3c 2f 62 3e 0a 20 20 20 20 3c 2f 62 6c off</b>. </bl 2590: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 2f 62 6c 6f ockquote>..</blo 25a0: 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 4d 6f 72 65 ckquote><h2>More 25b0: 20 48 69 6e 74 73 3c 2f 68 32 3e 3c 62 6c 6f 63 Hints</h2><bloc 25c0: 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e kquote>.. <p> 25d0: 54 72 79 20 74 68 65 73 65 20 63 6f 6d 6d 61 6e Try these comman 25e0: 64 73 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c ds:</p>.. <bl 25f0: 6f 63 6b 71 75 6f 74 65 3e 3c 62 3e 0a 20 20 20 ockquote><b>. 2600: 20 66 6f 73 73 69 6c 20 68 65 6c 70 3c 62 72 3e fossil help<br> 2610: 0a 20 20 20 20 66 6f 73 73 69 6c 20 74 65 73 74 . fossil test 2620: 2d 63 6f 6d 6d 61 6e 64 73 0a 20 20 20 20 3c 2f -commands. </ 2630: 62 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a b></blockquote>. 2640: 0a 20 20 20 20 3c 70 3e 45 78 70 6c 6f 72 65 20 . <p>Explore 2650: 61 6e 64 20 68 61 76 65 20 66 75 6e 21 3c 2f 70 and have fun!</p 2660: 3e 0a 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 >...</blockquote 2670: 3e 3c 2f 62 6f 64 79 3e 3c 2f 68 74 6d 6c 3e 0a ></body></html>.