Artifact 4381e8a48da1fdc3894a251fde0724b7407035b5:
File www/quickstart.wiki part of check-in [d87ca60c58] - initial ports of static .html to static /doc .wiki by stephan on 2008-05-15 20:25:46. Also file www/quickstart.wiki part of check-in [f94f7e5f49] - Merge the fork back together. by drh on 2008-05-16 00:27:49.
0000: 3c 68 31 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65 <h1 align="cente 0010: 72 22 3e 46 6f 73 73 69 6c 20 51 75 69 63 6b 20 r">Fossil Quick 0020: 53 74 61 72 74 3c 2f 68 31 3e 0a 0a 3c 70 3e 54 Start</h1>..<p>T 0030: 68 69 73 20 69 73 20 61 20 67 75 69 64 65 20 74 his is a guide t 0040: 6f 20 67 65 74 20 79 6f 75 20 73 74 61 72 74 65 o get you starte 0050: 64 20 75 73 69 6e 67 20 66 6f 73 73 69 6c 20 71 d using fossil q 0060: 75 69 63 6b 6c 79 0a 61 6e 64 20 70 61 69 6e 6c uickly.and painl 0070: 65 73 73 6c 79 2e 3c 2f 70 3e 0a 0a 3c 68 32 3e essly.</p>..<h2> 0080: 49 6e 73 74 61 6c 6c 69 6e 67 3c 2f 68 32 3e 3c Installing</h2>< 0090: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 blockquote>.. 00a0: 20 3c 70 3e 46 6f 73 73 69 6c 20 69 73 20 61 20 <p>Fossil is a 00b0: 73 69 6e 67 6c 65 20 73 65 6c 66 2d 63 6f 6e 74 single self-cont 00c0: 61 69 6e 65 64 20 43 20 70 72 6f 67 72 61 6d 2e ained C program. 00d0: 20 20 59 6f 75 20 6e 65 65 64 20 74 6f 0a 20 20 You need to. 00e0: 20 20 65 69 74 68 65 72 20 64 6f 77 6e 6c 6f 61 either downloa 00f0: 64 20 61 20 3c 61 20 68 72 65 66 3d 22 64 6f 77 d a <a href="dow 0100: 6e 6c 6f 61 64 2e 77 69 6b 69 22 3e 46 49 58 4d nload.wiki">FIXM 0110: 45 20 70 72 65 63 6f 6d 70 69 6c 65 64 20 62 69 E precompiled bi 0120: 6e 61 72 79 3c 2f 61 3e 0a 20 20 20 20 6f 72 20 nary</a>. or 0130: 3c 61 20 68 72 65 66 3d 22 62 75 69 6c 64 2e 77 <a href="build.w 0140: 69 6b 69 22 3e 62 75 69 6c 64 20 69 74 20 79 6f iki">build it yo 0150: 75 72 73 65 6c 66 3c 2f 61 3e 20 66 72 6f 6d 20 urself</a> from 0160: 73 6f 75 72 63 65 73 2e 0a 20 20 20 20 49 6e 73 sources.. Ins 0170: 74 61 6c 6c 20 66 6f 73 73 69 6c 20 62 79 20 70 tall fossil by p 0180: 75 74 74 69 6e 67 20 74 68 65 20 66 6f 73 73 69 utting the fossi 0190: 6c 20 62 69 6e 61 72 79 0a 20 20 20 20 73 6f 6d l binary. som 01a0: 65 70 6c 61 63 65 20 6f 6e 20 79 6f 75 72 20 50 eplace on your P 01b0: 41 54 48 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 ATH environment 01c0: 76 61 72 69 61 62 6c 65 2e 3c 2f 70 3e 0a 20 20 variable.</p>. 01d0: 20 20 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 . </blockqu 01e0: 6f 74 65 3e 0a 20 20 20 20 3c 68 32 3e 43 6c 6f ote>. <h2>Clo 01f0: 6e 69 6e 67 20 41 20 45 78 69 73 74 69 6e 67 20 ning A Existing 0200: 52 65 70 6f 73 69 74 6f 72 79 3c 2f 68 32 3e 0a Repository</h2>. 0210: 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e <blockquote> 0220: 0a 20 20 20 20 0a 20 20 20 20 3c 70 3e 55 73 65 . . <p>Use 0230: 20 74 68 69 73 20 63 6f 6d 6d 61 6e 64 3a 3c 2f this command:</ 0240: 70 3e 0a 20 20 20 20 0a 20 20 20 20 3c 62 6c 6f p>. . <blo 0250: 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e ckquote>. <b> 0260: 66 6f 73 73 69 6c 20 63 6c 6f 6e 65 3c 2f 62 3e fossil clone</b> 0270: 20 3c 69 3e 55 52 4c 20 20 72 65 70 6f 73 69 74 <i>URL reposit 0280: 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e ory-filename</i> 0290: 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 . </blockquot 02a0: 65 3e 0a 20 20 20 20 0a 20 20 20 20 3c 70 3e 54 e>. . <p>T 02b0: 68 65 20 3c 69 3e 55 52 4c 3c 2f 69 3e 20 61 62 he <i>URL</i> ab 02c0: 6f 76 65 20 69 73 20 74 68 65 20 68 74 74 70 20 ove is the http 02d0: 55 52 4c 20 66 6f 72 20 74 68 65 20 66 6f 73 73 URL for the foss 02e0: 69 6c 20 72 65 70 6f 73 69 74 6f 72 79 0a 20 20 il repository. 02f0: 20 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 63 6c you want to cl 0300: 6f 6e 65 2e 20 20 59 6f 75 20 63 61 6e 20 63 61 one. You can ca 0310: 6c 6c 20 74 68 65 20 6e 65 77 20 72 65 70 6f 73 ll the new repos 0320: 69 74 6f 72 79 20 61 6e 79 74 68 69 6e 67 20 79 itory anything y 0330: 6f 75 0a 20 20 20 20 77 61 6e 74 20 2d 20 74 68 ou. want - th 0340: 65 72 65 20 61 72 65 20 6e 6f 20 6e 61 6d 69 6e ere are no namin 0350: 67 20 72 65 73 74 72 69 63 74 69 6f 6e 73 2e 20 g restrictions. 0360: 20 41 73 20 61 6e 20 65 78 61 6d 70 6c 65 2c 20 As an example, 0370: 79 6f 75 20 63 61 6e 0a 20 20 20 20 63 6c 6f 6e you can. clon 0380: 65 20 74 68 65 20 66 6f 73 73 69 6c 20 72 65 70 e the fossil rep 0390: 6f 73 69 74 6f 72 79 20 74 68 69 73 20 77 61 79 ository this way 03a0: 3a 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 20 20 3c :</p>. . < 03b0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 blockquote>. 03c0: 3c 62 3e 66 6f 73 73 69 6c 20 63 6c 6f 6e 65 20 <b>fossil clone 03d0: 68 74 74 70 3a 2f 2f 77 77 77 2e 66 6f 73 73 69 http://www.fossi 03e0: 6c 2d 73 63 6d 2e 6f 72 67 2f 66 6f 73 73 69 6c l-scm.org/fossil 03f0: 20 6d 79 63 6c 6f 6e 65 2e 66 73 6c 3c 2f 62 3e myclone.fsl</b> 0400: 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 . </blockquot 0410: 65 3e 0a 0a 20 20 20 20 3c 70 3e 4e 6f 74 65 3a e>.. <p>Note: 0420: 20 49 66 20 79 6f 75 20 61 72 65 20 62 65 68 69 If you are behi 0430: 6e 64 20 61 20 72 65 73 74 72 69 63 74 69 76 65 nd a restrictive 0440: 20 66 69 72 65 77 61 6c 6c 2c 20 79 6f 75 20 6d firewall, you m 0450: 69 67 68 74 20 6e 65 65 64 0a 20 20 20 20 74 6f ight need. to 0460: 20 3c 61 20 68 72 65 66 3d 22 23 70 72 6f 78 79 <a href="#proxy 0470: 22 3e 73 70 65 63 69 66 79 20 61 6e 20 48 54 54 ">specify an HTT 0480: 50 20 70 72 6f 78 79 3c 2f 61 3e 20 74 6f 20 75 P proxy</a> to u 0490: 73 65 2e 3c 2f 70 3e 0a 20 20 20 20 0a 3c 2f 62 se.</p>. .</b 04a0: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 53 74 lockquote><h2>St 04b0: 61 72 74 69 6e 67 20 41 20 4e 65 77 20 50 72 6f arting A New Pro 04c0: 6a 65 63 74 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 ject</h2><blockq 04d0: 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 6f uote>.. <p>To 04e0: 20 73 74 61 72 74 20 61 20 6e 65 77 20 70 72 6f start a new pro 04f0: 6a 65 63 74 20 77 69 74 68 20 66 6f 73 73 69 6c ject with fossil 0500: 2c 20 63 72 65 61 74 65 20 61 20 6e 65 77 20 65 , create a new e 0510: 6d 70 74 79 20 72 65 70 6f 73 69 74 6f 72 79 0a mpty repository. 0520: 20 20 20 20 74 68 69 73 20 77 61 79 3a 3c 2f 70 this way:</p 0530: 3e 0a 20 20 20 20 0a 20 20 20 20 3c 62 6c 6f 63 >. . <bloc 0540: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 kquote>. <b>f 0550: 6f 73 73 69 6c 20 6e 65 77 20 3c 2f 62 3e 3c 69 ossil new </b><i 0560: 3e 20 72 65 70 6f 73 69 74 6f 72 79 2d 66 69 6c > repository-fil 0570: 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f ename</i>. </ 0580: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 blockquote>. 0590: 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 .</blockquote><h 05a0: 32 3e 43 6f 6e 66 69 67 75 72 69 6e 67 20 59 6f 2>Configuring Yo 05b0: 75 72 20 4c 6f 63 61 6c 20 52 65 70 6f 73 69 74 ur Local Reposit 05c0: 6f 72 79 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 ory</h2><blockqu 05d0: 6f 74 65 3e 0a 20 20 20 20 0a 20 20 20 20 3c 70 ote>. . <p 05e0: 3e 57 68 65 6e 20 79 6f 75 20 63 72 65 61 74 65 >When you create 05f0: 20 61 20 6e 65 77 20 72 65 70 6f 73 69 74 6f 72 a new repositor 0600: 79 2c 20 65 69 74 68 65 72 20 62 79 20 63 6c 6f y, either by clo 0610: 6e 69 6e 67 20 61 6e 20 65 78 69 73 74 69 6e 67 ning an existing 0620: 0a 20 20 20 20 70 72 6f 6a 65 63 74 20 6f 72 20 . project or 0630: 63 72 65 61 74 65 20 61 20 6e 65 77 20 70 72 6f create a new pro 0640: 6a 65 63 74 20 6f 66 20 79 6f 75 72 20 6f 77 6e ject of your own 0650: 2c 20 79 6f 75 20 75 73 75 61 6c 6c 79 20 77 61 , you usually wa 0660: 6e 74 20 74 6f 20 64 6f 20 73 6f 6d 65 0a 20 20 nt to do some. 0670: 20 20 6c 6f 63 61 6c 20 63 6f 6e 66 69 67 75 72 local configur 0680: 61 74 69 6f 6e 2e 20 20 54 68 69 73 20 69 73 20 ation. This is 0690: 61 63 63 6f 6d 70 6c 69 73 68 65 64 20 75 73 69 accomplished usi 06a0: 6e 67 20 61 20 77 65 62 62 72 6f 77 73 65 72 2e ng a webbrowser. 06b0: 20 20 46 69 72 73 74 0a 20 20 20 20 73 74 61 72 First. star 06c0: 74 20 61 20 66 6f 73 73 69 6c 20 77 65 62 73 65 t a fossil webse 06d0: 72 76 65 72 20 6c 69 6b 65 20 74 68 69 73 3a 3c rver like this:< 06e0: 2f 70 3e 0a 20 20 20 20 0a 20 20 20 20 3c 62 6c /p>. . <bl 06f0: 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 ockquote>. <b 0700: 3e 66 6f 73 73 69 6c 20 73 65 72 76 65 72 20 3c >fossil server < 0710: 2f 62 3e 3c 69 3e 20 72 65 70 6f 73 69 74 6f 72 /b><i> repositor 0720: 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20 y-filename</i>. 0730: 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e </blockquote> 0740: 0a 0a 20 20 20 20 3c 70 3e 54 68 69 73 20 63 72 .. <p>This cr 0750: 65 61 74 65 73 20 61 20 6d 69 6e 69 2d 77 65 62 eates a mini-web 0760: 73 65 72 76 65 72 20 6c 69 73 74 65 6e 69 6e 67 server listening 0770: 20 6f 6e 20 70 6f 72 74 20 38 30 38 30 2e 20 20 on port 8080. 0780: 59 6f 75 20 63 61 6e 0a 20 20 20 20 73 70 65 63 You can. spec 0790: 69 66 79 20 61 20 64 69 66 66 65 72 65 6e 74 20 ify a different 07a0: 70 6f 72 74 20 75 73 69 6e 67 20 74 68 65 20 3c port using the < 07b0: 62 3e 2d 70 6f 72 74 3c 2f 62 3e 20 6f 70 74 69 b>-port</b> opti 07c0: 6f 6e 20 6f 6e 20 74 68 65 20 63 6f 6d 6d 61 6e on on the comman 07d0: 64 2d 6c 69 6e 65 2e 0a 20 20 20 20 41 66 74 65 d-line.. Afte 07e0: 72 20 74 68 65 20 73 65 72 76 65 72 20 69 73 20 r the server is 07f0: 72 75 6e 6e 69 6e 67 2c 20 70 6f 69 6e 74 20 79 running, point y 0800: 6f 75 72 20 77 65 62 62 72 6f 77 73 65 72 20 61 our webbrowser a 0810: 74 0a 20 20 20 20 68 74 74 70 3a 2f 2f 6c 6f 63 t. http://loc 0820: 61 6c 68 6f 73 74 3a 38 30 38 30 2f 20 61 6e 64 alhost:8080/ and 0830: 20 73 74 61 72 74 20 63 6f 6e 66 69 67 75 72 69 start configuri 0840: 6e 67 2e 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 20 ng.</p>. . 0850: 20 3c 70 3e 42 79 20 64 65 66 61 75 6c 74 2c 20 <p>By default, 0860: 66 6f 73 73 69 6c 20 64 6f 65 73 20 6e 6f 74 20 fossil does not 0870: 72 65 71 75 69 72 65 20 61 20 6c 6f 67 69 6e 20 require a login 0880: 66 6f 72 20 48 54 54 50 20 63 6f 6e 6e 65 63 74 for HTTP connect 0890: 69 6f 6e 73 0a 20 20 20 20 63 6f 6d 69 6e 67 20 ions. coming 08a0: 69 6e 20 66 72 6f 6d 20 74 68 65 20 49 50 20 6c in from the IP l 08b0: 6f 6f 70 62 61 63 6b 20 61 64 64 72 65 73 73 20 oopback address 08c0: 31 32 37 2e 30 2e 30 2e 31 2e 20 20 59 6f 75 20 127.0.0.1. You 08d0: 63 61 6e 2c 20 61 6e 64 20 70 65 72 68 61 70 73 can, and perhaps 08e0: 0a 20 20 20 20 73 68 6f 75 6c 64 2c 20 63 68 61 . should, cha 08f0: 6e 67 65 20 74 68 69 73 20 61 66 74 65 72 20 79 nge this after y 0900: 6f 75 20 63 72 65 61 74 65 20 61 20 66 65 77 20 ou create a few 0910: 75 73 65 72 73 2e 3c 2f 70 3e 0a 20 20 20 20 0a users.</p>. . 0920: 20 20 20 20 3c 70 3e 57 68 65 6e 20 79 6f 75 20 <p>When you 0930: 61 72 65 20 66 69 6e 69 73 68 65 64 20 63 6f 6e are finished con 0940: 66 69 67 75 72 69 6e 67 2c 20 6a 75 73 74 20 70 figuring, just p 0950: 72 65 73 73 20 43 6f 6e 74 72 6f 6c 2d 43 20 6f ress Control-C o 0960: 72 20 75 73 65 0a 20 20 20 20 74 68 65 20 3c 62 r use. the <b 0970: 3e 6b 69 6c 6c 3c 2f 62 3e 20 63 6f 6d 6d 61 6e >kill</b> comman 0980: 64 20 74 6f 20 73 68 75 74 20 64 6f 77 6e 20 74 d to shut down t 0990: 68 65 20 6d 69 6e 69 2d 73 65 72 76 65 72 2e 3c he mini-server.< 09a0: 2f 70 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 /p>..</blockquot 09b0: 65 3e 3c 68 32 3e 43 68 65 63 6b 69 6e 67 20 4f e><h2>Checking O 09c0: 75 74 20 41 20 4c 6f 63 61 6c 20 54 72 65 65 3c ut A Local Tree< 09d0: 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e /h2><blockquote> 09e0: 0a 0a 20 20 20 20 3c 70 3e 54 6f 20 77 6f 72 6b .. <p>To work 09f0: 20 6f 6e 20 61 20 70 72 6f 6a 65 63 74 20 69 6e on a project in 0a00: 20 66 6f 73 73 69 6c 2c 20 79 6f 75 20 6e 65 65 fossil, you nee 0a10: 64 20 74 6f 20 63 68 65 63 6b 20 6f 75 74 20 61 d to check out a 0a20: 20 6c 6f 63 61 6c 0a 20 20 20 20 63 6f 70 79 20 local. copy 0a30: 6f 66 20 74 68 65 20 73 6f 75 72 63 65 20 74 72 of the source tr 0a40: 65 65 2e 20 20 43 72 65 61 74 65 20 74 68 65 20 ee. Create the 0a50: 64 69 72 65 63 74 6f 72 79 20 79 6f 75 20 77 61 directory you wa 0a60: 6e 74 20 74 6f 20 62 65 0a 20 20 20 20 74 68 65 nt to be. the 0a70: 20 72 6f 6f 74 20 6f 66 20 79 6f 75 72 20 74 72 root of your tr 0a80: 65 65 20 61 6e 64 20 63 64 20 69 6e 74 6f 20 74 ee and cd into t 0a90: 68 61 74 20 64 69 72 65 63 74 6f 72 79 2e 20 20 hat directory. 0aa0: 54 68 65 6e 0a 20 20 20 20 74 6f 20 74 68 69 73 Then. to this 0ab0: 3a 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 20 20 3c :</p>. . < 0ac0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 blockquote>. 0ad0: 3c 62 3e 66 6f 73 73 69 6c 20 6f 70 65 6e 20 3c <b>fossil open < 0ae0: 2f 62 3e 3c 69 3e 20 72 65 70 6f 73 69 74 6f 72 /b><i> repositor 0af0: 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20 y-filename</i>. 0b00: 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e </blockquote> 0b10: 0a 20 20 20 20 0a 20 20 20 20 3c 70 3e 54 68 69 . . <p>Thi 0b20: 73 20 6c 65 61 76 65 73 20 79 6f 75 20 77 69 74 s leaves you wit 0b30: 68 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 28 h the original ( 0b40: 65 6d 70 74 79 29 20 76 65 72 73 69 6f 6e 20 6f empty) version o 0b50: 66 20 74 68 65 20 74 72 65 65 0a 20 20 20 20 63 f the tree. c 0b60: 68 65 63 6b 65 64 20 6f 75 74 2e 20 20 54 6f 20 hecked out. To 0b70: 67 65 74 20 74 6f 20 74 68 65 20 6c 61 74 65 73 get to the lates 0b80: 74 20 76 65 72 73 69 6f 6e 2c 20 61 6c 73 6f 20 t version, also 0b90: 64 6f 20 74 68 69 73 3a 3c 2f 70 3e 0a 20 20 20 do this:</p>. 0ba0: 20 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 . <blockquot 0bb0: 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c e>. <b>fossil 0bc0: 20 75 70 64 61 74 65 3c 2f 62 3e 0a 20 20 20 20 update</b>. 0bd0: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 </blockquote>. 0be0: 20 20 0a 20 20 20 20 3c 70 3e 46 72 6f 6d 20 61 . <p>From a 0bf0: 6e 79 77 68 65 72 65 20 75 6e 64 65 72 6e 65 61 nywhere undernea 0c00: 74 68 20 74 68 65 20 72 6f 6f 74 20 6f 66 20 79 th the root of y 0c10: 6f 75 72 20 6c 6f 63 61 6c 20 74 72 65 65 2c 20 our local tree, 0c20: 79 6f 75 0a 20 20 20 20 63 61 6e 20 74 79 70 65 you. can type 0c30: 20 63 6f 6d 6d 61 6e 64 73 20 6c 69 6b 65 20 74 commands like t 0c40: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 6f 20 he following to 0c50: 66 69 6e 64 20 6f 75 74 20 74 68 65 20 73 74 61 find out the sta 0c60: 74 75 73 20 6f 66 0a 20 20 20 20 79 6f 75 72 20 tus of. your 0c70: 6c 6f 63 61 6c 20 74 72 65 65 3a 3c 2f 70 3e 0a local tree:</p>. 0c80: 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 . <blockquote 0c90: 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 >. <b>fossil 0ca0: 69 6e 66 6f 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 info</b><br>. 0cb0: 20 3c 62 3e 66 6f 73 73 69 6c 20 73 74 61 74 75 <b>fossil statu 0cc0: 73 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 s</b><br>. <b 0cd0: 3e 66 6f 73 73 69 6c 20 63 68 61 6e 67 65 73 3c >fossil changes< 0ce0: 2f 62 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 /b><br>. <b>f 0cf0: 6f 73 73 69 6c 20 74 69 6d 65 6c 69 6e 65 3c 2f ossil timeline</ 0d00: 62 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f b><br>. <b>fo 0d10: 73 73 69 6c 20 6c 65 61 76 65 73 3c 2f 62 3e 3c ssil leaves</b>< 0d20: 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 br>. <b>fossi 0d30: 6c 20 6c 73 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 l ls</b><br>. 0d40: 20 3c 62 3e 66 6f 73 73 69 6c 20 62 72 61 6e 63 <b>fossil branc 0d50: 68 65 73 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 20 hes</b><br>. 0d60: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c </blockquote>..< 0d70: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e /blockquote><h2> 0d80: 4d 61 6b 69 6e 67 20 43 68 61 6e 67 65 73 3c 2f Making Changes</ 0d90: 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a h2><blockquote>. 0da0: 0a 20 20 20 20 3c 70 3e 54 6f 20 61 64 64 20 6e . <p>To add n 0db0: 65 77 20 66 69 6c 65 73 20 74 6f 20 79 6f 75 72 ew files to your 0dc0: 20 70 72 6f 6a 65 63 74 2c 20 6f 72 20 72 65 6d project, or rem 0dd0: 6f 76 65 20 6f 6c 64 20 66 69 6c 65 73 2c 20 75 ove old files, u 0de0: 73 65 20 74 68 65 73 65 0a 20 20 20 20 63 6f 6d se these. com 0df0: 6d 61 6e 64 73 3a 3c 2f 70 3e 0a 0a 20 20 20 20 mands:</p>.. 0e00: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 <blockquote>. 0e10: 20 3c 62 3e 66 6f 73 73 69 6c 20 61 64 64 3c 2f <b>fossil add</ 0e20: 62 3e 20 3c 69 3e 66 69 6c 65 2e 2e 2e 3c 2f 69 b> <i>file...</i 0e30: 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 ><br>. <b>fos 0e40: 73 69 6c 20 72 6d 3c 2f 62 3e 20 3c 69 3e 66 69 sil rm</b> <i>fi 0e50: 6c 65 2e 2e 2e 3c 2f 69 3e 0a 20 20 20 20 3c 2f le...</i>. </ 0e60: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 blockquote>.. 0e70: 20 3c 70 3e 59 6f 75 20 63 61 6e 20 61 6c 73 6f <p>You can also 0e80: 20 65 64 69 74 20 66 69 6c 65 73 20 66 72 65 65 edit files free 0e90: 6c 79 2e 20 20 4f 6e 63 65 20 79 6f 75 20 61 72 ly. Once you ar 0ea0: 65 20 72 65 61 64 79 20 74 6f 20 63 6f 6d 6d 69 e ready to commi 0eb0: 74 0a 20 20 20 20 79 6f 75 72 20 63 68 61 6e 67 t. your chang 0ec0: 65 73 2c 20 74 79 70 65 3a 3c 2f 70 3e 0a 0a 20 es, type:</p>.. 0ed0: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a <blockquote>. 0ee0: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 63 6f <b>fossil co 0ef0: 6d 6d 69 74 3c 2f 62 3e 0a 20 20 20 20 3c 2f 62 mmit</b>. </b 0f00: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 lockquote>.. 0f10: 3c 70 3e 59 6f 75 20 77 69 6c 6c 20 62 65 20 70 <p>You will be p 0f20: 72 6f 6d 70 74 65 64 20 66 6f 72 20 63 68 65 63 rompted for chec 0f30: 6b 2d 69 6e 20 63 6f 6d 6d 65 6e 74 73 20 75 73 k-in comments us 0f40: 69 6e 67 20 77 68 61 74 65 76 65 72 20 65 64 69 ing whatever edi 0f50: 74 6f 72 0a 20 20 20 20 69 73 20 73 70 65 63 69 tor. is speci 0f60: 66 69 65 64 20 62 79 20 79 6f 75 72 20 56 49 53 fied by your VIS 0f70: 55 41 4c 20 6f 72 20 45 44 49 54 4f 52 20 65 6e UAL or EDITOR en 0f80: 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 vironment variab 0f90: 6c 65 2e 20 20 49 66 20 79 6f 75 0a 20 20 20 20 le. If you. 0fa0: 68 61 76 65 20 47 50 47 20 69 6e 73 74 61 6c 6c have GPG install 0fb0: 65 64 2c 20 79 6f 75 20 6d 61 79 20 62 65 20 70 ed, you may be p 0fc0: 72 6f 6d 70 74 65 64 20 66 6f 72 20 79 6f 75 72 rompted for your 0fd0: 20 47 50 47 20 70 61 73 73 70 68 72 61 73 65 20 GPG passphrase 0fe0: 73 6f 0a 20 20 20 20 74 68 61 74 20 74 68 65 20 so. that the 0ff0: 63 68 65 63 6b 2d 69 6e 20 63 61 6e 20 62 65 20 check-in can be 1000: 73 69 67 6e 65 64 20 77 69 74 68 20 79 6f 75 72 signed with your 1010: 20 47 50 47 20 73 69 67 6e 61 74 75 72 65 2e 20 GPG signature. 1020: 20 41 66 74 65 72 0a 20 20 20 20 74 68 69 73 20 After. this 1030: 79 6f 75 72 20 63 68 61 6e 67 65 73 20 77 69 6c your changes wil 1040: 6c 20 62 65 20 63 68 65 63 6b 65 64 20 69 6e 2e l be checked in. 1050: 3c 2f 70 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f </p>..</blockquo 1060: 74 65 3e 3c 68 32 3e 53 68 61 72 69 6e 67 20 43 te><h2>Sharing C 1070: 68 61 6e 67 65 73 3c 2f 68 32 3e 3c 62 6c 6f 63 hanges</h2><bloc 1080: 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e kquote>.. <p> 1090: 54 68 65 20 63 68 61 6e 67 65 73 20 79 6f 75 20 The changes you 10a0: 3c 62 3e 63 6f 6d 6d 69 74 3c 2f 62 3e 20 61 72 <b>commit</b> ar 10b0: 65 20 6f 6e 6c 79 20 6f 6e 20 79 6f 75 72 20 6c e only on your l 10c0: 6f 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 2e ocal repository. 10d0: 0a 20 20 20 20 54 6f 20 73 68 61 72 65 20 74 68 . To share th 10e0: 6f 73 65 20 63 68 61 6e 67 65 73 20 77 69 74 68 ose changes with 10f0: 20 6f 74 68 65 72 20 72 65 70 6f 73 69 74 6f 72 other repositor 1100: 69 65 73 2c 20 64 6f 3a 3c 2f 70 3e 0a 0a 20 20 ies, do:</p>.. 1110: 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 <blockquote>. 1120: 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 70 75 73 <b>fossil pus 1130: 68 3c 2f 62 3e 20 3c 69 3e 55 52 4c 3c 2f 69 3e h</b> <i>URL</i> 1140: 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 . </blockquot 1150: 65 3e 0a 0a 20 20 20 20 3c 70 3e 57 68 65 72 65 e>.. <p>Where 1160: 20 3c 69 3e 55 52 4c 3c 2f 69 3e 20 69 73 20 74 <i>URL</i> is t 1170: 68 65 20 68 74 74 70 3a 20 55 52 4c 20 6f 66 20 he http: URL of 1180: 74 68 65 20 73 65 72 76 65 72 20 72 65 70 6f 73 the server repos 1190: 69 74 6f 72 79 20 79 6f 75 0a 20 20 20 20 77 61 itory you. wa 11a0: 6e 74 20 74 6f 20 73 68 61 72 65 20 79 6f 75 72 nt to share your 11b0: 20 63 68 61 6e 67 65 73 20 77 69 74 68 2e 20 20 changes with. 11c0: 49 66 20 79 6f 75 20 6f 6d 69 74 20 74 68 65 20 If you omit the 11d0: 3c 69 3e 55 52 4c 3c 2f 69 3e 20 61 72 67 75 6d <i>URL</i> argum 11e0: 65 6e 74 2c 0a 20 20 20 20 66 6f 73 73 69 6c 20 ent,. fossil 11f0: 77 69 6c 6c 20 75 73 65 20 77 68 61 74 65 76 65 will use whateve 1200: 72 20 73 65 72 76 65 72 20 79 6f 75 20 6d 6f 73 r server you mos 1210: 74 20 72 65 63 65 6e 74 6c 79 20 73 79 6e 63 65 t recently synce 1220: 64 20 77 69 74 68 2e 3c 2f 70 3e 0a 0a 20 20 20 d with.</p>.. 1230: 20 3c 70 3e 54 68 65 20 3c 62 3e 70 75 73 68 3c <p>The <b>push< 1240: 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 6f 6e 6c 79 /b> command only 1250: 20 73 65 6e 64 73 20 79 6f 75 72 20 63 68 61 6e sends your chan 1260: 67 65 73 20 74 6f 20 6f 74 68 65 72 73 2e 20 20 ges to others. 1270: 54 6f 0a 20 20 20 20 52 65 63 65 69 76 65 20 63 To. Receive c 1280: 68 61 6e 67 65 73 20 66 72 6f 6d 20 6f 74 68 65 hanges from othe 1290: 72 73 2c 20 75 73 65 20 3c 62 3e 70 75 6c 6c 3c rs, use <b>pull< 12a0: 2f 62 3e 2e 20 20 4f 72 20 67 6f 20 62 6f 74 68 /b>. Or go both 12b0: 20 77 61 79 73 20 61 74 0a 20 20 20 20 6f 6e 63 ways at. onc 12c0: 65 20 75 73 69 6e 67 20 3c 62 3e 73 79 6e 63 3c e using <b>sync< 12d0: 2f 62 3e 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 /b>:</p>.. <b 12e0: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c lockquote>. < 12f0: 62 3e 66 6f 73 73 69 6c 20 70 75 6c 6c 3c 2f 62 b>fossil pull</b 1300: 3e 20 3c 69 3e 55 52 4c 3c 2f 69 3e 3c 62 72 3e > <i>URL</i><br> 1310: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 73 . <b>fossil s 1320: 79 6e 63 3c 2f 62 3e 20 3c 69 3e 55 52 4c 3c 2f ync</b> <i>URL</ 1330: 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 i>. </blockqu 1340: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 57 68 65 ote>.. <p>Whe 1350: 6e 20 79 6f 75 20 70 75 6c 6c 20 69 6e 20 63 68 n you pull in ch 1360: 61 6e 67 65 73 20 66 72 6f 6d 20 6f 74 68 65 72 anges from other 1370: 73 2c 20 74 68 65 79 20 67 6f 20 69 6e 74 6f 20 s, they go into 1380: 79 6f 75 72 20 72 65 70 6f 73 69 74 6f 72 79 2c your repository, 1390: 0a 20 20 20 20 6e 6f 74 20 69 6e 74 6f 20 79 6f . not into yo 13a0: 75 72 20 63 68 65 63 6b 65 64 2d 6f 75 74 20 6c ur checked-out l 13b0: 6f 63 61 6c 20 74 72 65 65 2e 20 20 54 6f 20 67 ocal tree. To g 13c0: 65 74 20 74 68 65 20 63 68 61 6e 67 65 73 20 69 et the changes i 13d0: 6e 74 6f 20 79 6f 75 72 0a 20 20 20 20 6c 6f 63 nto your. loc 13e0: 61 6c 20 74 72 65 65 2c 20 75 73 65 20 3c 62 3e al tree, use <b> 13f0: 75 70 64 61 74 65 3c 2f 62 3e 3a 3c 2f 70 3e 0a update</b>:</p>. 1400: 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 . <blockquote 1410: 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 >. <b>fossil 1420: 75 70 64 61 74 65 3c 2f 62 3e 20 3c 69 3e 55 55 update</b> <i>UU 1430: 49 44 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f ID</i>. </blo 1440: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 ckquote>.. <p 1450: 3e 54 68 65 20 3c 69 3e 55 55 49 44 3c 2f 69 3e >The <i>UUID</i> 1460: 20 69 73 20 73 6f 6d 65 20 75 6e 69 71 75 65 20 is some unique 1470: 61 62 62 72 65 76 69 61 74 69 6f 6e 20 74 6f 20 abbreviation to 1480: 74 68 65 20 34 30 2d 63 68 61 72 61 63 74 65 72 the 40-character 1490: 0a 20 20 20 20 76 65 72 73 69 6f 6e 20 49 44 2e . version ID. 14a0: 20 20 49 66 20 79 6f 75 20 6f 6d 69 74 20 74 68 If you omit th 14b0: 65 20 3c 69 3e 55 55 49 44 3c 2f 69 3e 20 66 6f e <i>UUID</i> fo 14c0: 73 73 69 6c 20 6d 6f 76 65 73 20 79 6f 75 20 74 ssil moves you t 14d0: 6f 20 74 68 65 0a 20 20 20 20 6c 65 61 66 20 76 o the. leaf v 14e0: 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 62 72 ersion of the br 14f0: 61 6e 63 68 20 79 6f 75 72 20 61 72 65 20 63 75 anch your are cu 1500: 72 72 65 6e 74 6c 79 20 6f 6e 2e 20 20 49 66 20 rrently on. If 1510: 79 6f 75 72 20 62 72 61 6e 63 68 0a 20 20 20 20 your branch. 1520: 68 61 73 20 6d 75 6c 74 69 70 6c 65 20 6c 65 61 has multiple lea 1530: 76 65 73 2c 20 79 6f 75 20 67 65 74 20 61 6e 20 ves, you get an 1540: 65 72 72 6f 72 20 2d 20 79 6f 75 27 6c 6c 20 68 error - you'll h 1550: 61 76 65 20 74 6f 20 73 70 65 63 69 66 79 20 74 ave to specify t 1560: 68 65 0a 20 20 20 20 6c 65 61 66 20 79 6f 75 20 he. leaf you 1570: 77 61 6e 74 20 75 73 69 6e 67 20 61 20 3c 69 3e want using a <i> 1580: 55 55 49 44 3c 2f 69 3e 20 61 72 67 75 6d 65 6e UUID</i> argumen 1590: 74 2e 3c 2f 70 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 t.</p>..</blockq 15a0: 75 6f 74 65 3e 3c 68 32 3e 42 72 61 6e 63 68 69 uote><h2>Branchi 15b0: 6e 67 20 41 6e 64 20 4d 65 72 67 69 6e 67 3c 2f ng And Merging</ 15c0: 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a h2><blockquote>. 15d0: 0a 20 20 20 20 3c 70 3e 59 6f 75 20 63 61 6e 20 . <p>You can 15e0: 63 72 65 61 74 65 20 62 72 61 6e 63 68 65 73 20 create branches 15f0: 62 79 20 64 6f 69 6e 67 20 6d 75 6c 74 69 70 6c by doing multipl 1600: 65 20 63 6f 6d 6d 69 74 73 20 6f 66 66 20 6f 66 e commits off of 1610: 20 74 68 65 0a 20 20 20 20 73 61 6d 65 20 62 61 the. same ba 1620: 73 65 20 76 65 72 73 69 6f 6e 2e 20 20 54 6f 20 se version. To 1630: 6d 65 72 67 65 20 74 6f 20 62 72 61 6e 63 68 65 merge to branche 1640: 73 20 62 61 63 6b 20 74 6f 67 65 74 68 65 72 2c s back together, 1650: 20 66 69 72 73 74 0a 20 20 20 20 3c 62 3e 75 70 first. <b>up 1660: 64 61 74 65 3c 2f 62 3e 20 74 6f 20 74 68 65 20 date</b> to the 1670: 6c 65 61 66 20 6f 66 20 6f 6e 65 20 62 72 61 6e leaf of one bran 1680: 63 68 2e 20 20 54 68 65 6e 20 64 6f 20 61 20 3c ch. Then do a < 1690: 62 3e 6d 65 72 67 65 3c 2f 62 3e 0a 20 20 20 20 b>merge</b>. 16a0: 6f 66 20 74 68 65 20 6c 65 61 66 20 6f 66 20 74 of the leaf of t 16b0: 68 65 20 6f 74 68 65 72 20 62 72 61 6e 63 68 3a he other branch: 16c0: 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b </p>.. <block 16d0: 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f quote>. <b>fo 16e0: 73 73 69 6c 20 6d 65 72 67 65 3c 2f 62 3e 20 3c ssil merge</b> < 16f0: 69 3e 55 55 49 44 3c 2f 69 3e 0a 20 20 20 20 3c i>UUID</i>. < 1700: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 /blockquote>.. 1710: 20 20 3c 70 3e 54 65 73 74 20 74 6f 20 6d 61 6b <p>Test to mak 1720: 65 20 73 75 72 65 20 79 6f 75 72 20 6d 65 72 67 e sure your merg 1730: 65 20 64 69 64 6e 27 74 20 6d 65 73 73 20 75 70 e didn't mess up 1740: 20 74 68 65 20 63 6f 64 65 2c 20 74 68 65 6e 0a the code, then. 1750: 20 20 20 20 3c 62 3e 63 6f 6d 6d 69 74 3c 2f 62 <b>commit</b 1760: 3e 20 61 6e 64 20 70 6f 73 73 69 62 6c 79 20 61 > and possibly a 1770: 6c 73 6f 20 3c 62 3e 70 75 73 68 3c 2f 62 3e 20 lso <b>push</b> 1780: 79 6f 75 72 20 63 68 61 6e 67 65 73 2e 20 20 20 your changes. 1790: 52 65 6d 65 6d 62 65 72 0a 20 20 20 20 74 68 61 Remember. tha 17a0: 74 20 6e 6f 62 6f 64 79 20 65 6c 73 65 20 63 61 t nobody else ca 17b0: 6e 20 73 65 65 20 79 6f 75 72 20 63 68 61 6e 67 n see your chang 17c0: 65 73 20 75 6e 74 69 6c 20 79 6f 75 20 3c 62 3e es until you <b> 17d0: 63 6f 6d 6d 69 74 3c 2f 62 3e 20 61 6e 64 0a 20 commit</b> and. 17e0: 20 20 20 69 66 20 6f 74 68 65 72 20 61 72 65 20 if other are 17f0: 75 73 69 6e 67 20 61 20 64 69 66 66 65 72 65 6e using a differen 1800: 74 20 72 65 70 6f 73 69 74 6f 72 79 20 79 6f 75 t repository you 1810: 20 77 69 6c 6c 20 61 6c 73 6f 20 6e 65 65 64 20 will also need 1820: 74 6f 0a 20 20 20 20 3c 62 3e 70 75 73 68 3c 2f to. <b>push</ 1830: 62 3e 2e 3c 2f 70 3e 0a 0a 3c 61 20 6e 61 6d 65 b>.</p>..<a name 1840: 3d 22 73 65 72 76 65 72 73 65 74 75 70 22 3e 0a ="serversetup">. 1850: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 </blockquote><h2 1860: 3e 53 65 74 74 69 6e 67 20 55 70 20 41 20 53 65 >Setting Up A Se 1870: 72 76 65 72 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 rver</h2><blockq 1880: 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 uote>.. <p>Th 1890: 65 20 65 61 73 69 65 73 74 20 77 61 79 20 74 6f e easiest way to 18a0: 20 73 65 74 20 75 70 20 61 20 73 65 72 76 65 72 set up a server 18b0: 20 69 73 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 is:</p>.. <b 18c0: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c lockquote>. < 18d0: 62 3e 66 6f 73 73 69 6c 20 73 65 72 76 65 72 3c b>fossil server< 18e0: 2f 62 3e 20 3c 69 3e 72 65 70 6f 73 69 74 6f 72 /b> <i>repositor 18f0: 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20 y-filename</i>. 1900: 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e </blockquote> 1910: 0a 0a 20 20 20 20 3c 70 3e 59 6f 75 20 63 61 6e .. <p>You can 1920: 20 6f 6d 69 74 20 74 68 65 20 3c 69 3e 72 65 70 omit the <i>rep 1930: 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 ository-filename 1940: 3c 2f 69 3e 20 69 66 20 79 6f 75 20 61 72 65 20 </i> if you are 1950: 77 69 74 68 69 6e 0a 20 20 20 20 61 20 63 68 65 within. a che 1960: 63 6b 65 64 2d 6f 75 74 20 6c 6f 63 61 6c 20 74 cked-out local t 1970: 72 65 65 2e 20 20 54 68 69 73 20 73 65 72 76 65 ree. This serve 1980: 72 20 75 73 65 73 20 70 6f 72 74 20 38 30 38 30 r uses port 8080 1990: 20 62 79 20 64 65 66 61 75 6c 74 0a 20 20 20 20 by default. 19a0: 62 75 74 20 79 6f 75 20 63 61 6e 20 73 70 65 63 but you can spec 19b0: 69 66 79 20 61 20 64 69 66 66 65 72 65 6e 74 20 ify a different 19c0: 70 6f 72 74 20 75 73 69 6e 67 20 74 68 65 20 3c port using the < 19d0: 62 3e 2d 70 6f 72 74 3c 2f 62 3e 20 63 6f 6d 6d b>-port</b> comm 19e0: 61 6e 64 2e 3c 2f 70 3e 0a 0a 20 20 20 20 3c 70 and.</p>.. <p 19f0: 3e 43 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 73 65 >Command-line se 1a00: 72 76 65 72 73 20 6c 69 6b 65 20 74 68 69 73 20 rvers like this 1a10: 61 72 65 20 75 73 65 66 75 6c 20 77 68 65 6e 20 are useful when 1a20: 74 77 6f 20 70 65 6f 70 6c 65 20 77 61 6e 74 0a two people want. 1a30: 20 20 20 20 74 6f 20 73 68 61 72 65 20 61 20 72 to share a r 1a40: 65 70 6f 73 69 74 6f 72 79 20 6f 6e 20 74 65 6d epository on tem 1a50: 70 6f 72 61 72 79 20 6f 72 20 61 64 2d 68 6f 63 porary or ad-hoc 1a60: 20 62 61 73 69 73 2e 20 20 46 6f 72 20 61 20 6d basis. For a m 1a70: 6f 72 65 0a 20 20 20 20 70 65 72 6d 61 6e 65 6e ore. permanen 1a80: 74 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 2c 20 t installation, 1a90: 79 6f 75 20 73 68 6f 75 6c 64 20 75 73 65 20 65 you should use e 1aa0: 69 74 68 65 72 20 74 68 65 20 43 47 49 20 73 65 ither the CGI se 1ab0: 72 76 65 72 20 6f 72 20 74 68 65 0a 20 20 20 20 rver or the. 1ac0: 69 6e 65 74 64 20 73 65 72 76 65 72 2e 20 20 54 inetd server. T 1ad0: 6f 20 75 73 65 20 74 68 65 20 43 47 49 20 73 65 o use the CGI se 1ae0: 72 76 65 72 2c 20 63 72 65 61 74 65 20 61 20 43 rver, create a C 1af0: 47 49 20 73 63 72 69 70 74 20 74 68 61 74 0a 20 GI script that. 1b00: 20 20 20 6c 6f 6f 6b 73 20 73 6f 6d 65 74 68 69 looks somethi 1b10: 6e 67 20 6c 69 6b 65 20 74 68 69 73 3a 3c 2f 70 ng like this:</p 1b20: 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f >.. <blockquo 1b30: 74 65 3e 3c 62 3e 0a 20 20 20 20 23 21 2f 75 73 te><b>. #!/us 1b40: 72 2f 6c 6f 63 61 6c 2f 62 69 6e 2f 66 6f 73 73 r/local/bin/foss 1b50: 69 6c 3c 62 72 3e 0a 20 20 20 20 72 65 70 6f 73 il<br>. repos 1b60: 69 74 6f 72 79 3a 20 2f 68 6f 6d 65 2f 70 72 6f itory: /home/pro 1b70: 6a 31 2f 72 65 70 6f 73 31 2e 66 73 6c 0a 20 20 j1/repos1.fsl. 1b80: 20 20 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 75 6f </b></blockquo 1b90: 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 41 64 6a 75 te>.. <p>Adju 1ba0: 73 74 20 74 68 65 20 70 61 74 68 73 20 69 6e 20 st the paths in 1bb0: 74 68 69 73 20 43 47 49 20 73 63 72 69 70 74 20 this CGI script 1bc0: 74 6f 20 6d 61 74 63 68 20 79 6f 75 72 20 69 6e to match your in 1bd0: 73 74 61 6c 6c 61 74 69 6f 6e 2e 0a 20 20 20 20 stallation.. 1be0: 4e 6f 77 20 70 6f 69 6e 74 20 63 6c 69 65 6e 74 Now point client 1bf0: 73 20 61 74 20 74 68 65 20 43 47 49 20 73 63 72 s at the CGI scr 1c00: 69 70 74 2e 20 20 54 68 61 74 27 73 20 61 6c 6c ipt. That's all 1c10: 20 74 68 65 72 65 20 69 73 20 74 6f 20 69 74 21 there is to it! 1c20: 3c 2f 70 3e 0a 0a 20 20 20 20 3c 70 3e 59 6f 75 </p>.. <p>You 1c30: 20 63 61 6e 20 61 6c 73 6f 20 72 75 6e 20 66 6f can also run fo 1c40: 73 73 69 6c 20 6f 66 66 20 6f 66 20 69 6e 65 74 ssil off of inet 1c50: 64 20 6f 72 20 78 69 6e 65 74 64 2e 20 20 46 6f d or xinetd. Fo 1c60: 72 20 61 6e 20 69 6e 65 74 64 0a 20 20 20 20 69 r an inetd. i 1c70: 6e 73 74 61 6c 6c 61 74 69 6f 6e 2c 20 6d 61 6b nstallation, mak 1c80: 65 20 61 6e 20 65 6e 74 72 79 20 69 6e 20 2f 65 e an entry in /e 1c90: 74 63 2f 69 6e 65 74 64 2e 63 6f 6e 66 20 74 68 tc/inetd.conf th 1ca0: 61 74 20 6c 6f 6f 6b 73 20 73 6f 6d 65 74 68 69 at looks somethi 1cb0: 6e 67 0a 20 20 20 20 6c 69 6b 65 20 74 68 69 73 ng. like this 1cc0: 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 :</p>.. <bloc 1cd0: 6b 71 75 6f 74 65 3e 3c 62 3e 0a 20 20 20 20 38 kquote><b>. 8 1ce0: 30 20 73 74 72 65 61 6d 20 74 63 70 20 6e 6f 77 0 stream tcp now 1cf0: 61 69 74 2e 31 30 30 30 20 72 6f 6f 74 20 2f 75 ait.1000 root /u 1d00: 73 72 2f 62 69 6e 2f 66 6f 73 73 69 6c 20 5c 3c sr/bin/fossil \< 1d10: 62 72 3e 0a 20 20 20 20 20 20 20 20 2f 75 73 72 br>. /usr 1d20: 2f 62 69 6e 2f 66 6f 73 73 69 6c 20 68 74 74 70 /bin/fossil http 1d30: 20 2f 68 6f 6d 65 2f 70 72 6f 6a 31 2f 72 65 70 /home/proj1/rep 1d40: 6f 73 31 2e 66 73 6c 0a 20 20 20 20 3c 2f 62 3e os1.fsl. </b> 1d50: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 </blockquote>.. 1d60: 20 20 20 3c 70 3e 41 64 6a 75 73 74 20 74 68 65 <p>Adjust the 1d70: 20 70 61 74 68 73 20 74 6f 20 73 75 69 74 20 79 paths to suit y 1d80: 6f 75 72 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e our installation 1d90: 2c 20 6f 66 20 63 6f 75 72 73 65 2e 20 20 4e 6f , of course. No 1da0: 74 69 63 65 20 74 68 61 74 0a 20 20 20 20 66 6f tice that. fo 1db0: 73 73 69 6c 20 72 75 6e 73 20 61 73 20 72 6f 6f ssil runs as roo 1dc0: 74 2e 20 20 54 68 69 73 20 69 73 20 6e 6f 74 20 t. This is not 1dd0: 72 65 71 75 69 72 65 64 20 2d 20 79 6f 75 20 63 required - you c 1de0: 61 6e 20 72 75 6e 20 69 74 20 61 73 20 61 6e 0a an run it as an. 1df0: 20 20 20 20 75 6e 70 72 69 76 69 6c 65 67 65 64 unprivileged 1e00: 20 75 73 65 72 2e 20 20 42 75 74 20 69 74 20 69 user. But it i 1e10: 73 20 6d 6f 72 65 20 73 65 63 75 72 65 20 74 6f s more secure to 1e20: 20 72 75 6e 20 66 6f 73 73 69 6c 20 61 73 20 72 run fossil as r 1e30: 6f 6f 74 2e 0a 20 20 20 20 57 68 65 6e 20 79 6f oot.. When yo 1e40: 75 20 64 6f 20 72 75 6e 20 66 6f 73 73 69 6c 20 u do run fossil 1e50: 61 73 20 72 6f 6f 74 2c 20 69 74 20 61 75 74 6f as root, it auto 1e60: 6d 61 74 69 63 61 6c 6c 79 20 70 75 74 73 20 69 matically puts i 1e70: 74 73 65 6c 66 20 69 6e 20 61 0a 20 20 20 20 63 tself in a. c 1e80: 68 72 6f 6f 74 20 6a 61 69 6c 20 69 6e 20 74 68 hroot jail in th 1e90: 65 20 73 61 6d 65 20 64 69 72 65 63 74 6f 72 79 e same directory 1ea0: 20 61 73 20 74 68 65 20 72 65 70 6f 73 69 74 6f as the reposito 1eb0: 72 79 2c 20 74 68 65 6e 20 64 72 6f 70 73 0a 20 ry, then drops. 1ec0: 20 20 20 72 6f 6f 74 20 70 72 69 76 69 6c 65 67 root privileg 1ed0: 65 73 20 70 72 69 6f 72 20 74 6f 20 72 65 61 64 es prior to read 1ee0: 69 6e 67 20 61 6e 79 20 69 6e 66 6f 72 6d 61 74 ing any informat 1ef0: 69 6f 6e 20 66 72 6f 6d 20 74 68 65 20 72 65 71 ion from the req 1f00: 75 65 73 74 2e 3c 2f 70 3e 0a 0a 3c 2f 62 6c 6f uest.</p>..</blo 1f10: 63 6b 71 75 6f 74 65 3e 3c 61 20 6e 61 6d 65 3d ckquote><a name= 1f20: 22 70 72 6f 78 79 22 3e 3c 2f 61 3e 3c 68 32 3e "proxy"></a><h2> 1f30: 48 54 54 50 20 50 72 6f 78 69 65 73 3c 2f 68 32 HTTP Proxies</h2 1f40: 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 ><blockquote>.. 1f50: 20 20 20 3c 70 3e 49 66 20 79 6f 75 20 61 72 65 <p>If you are 1f60: 20 62 65 68 69 6e 64 20 61 20 72 65 73 74 72 69 behind a restri 1f70: 63 74 69 76 65 20 66 69 72 65 77 61 6c 6c 20 74 ctive firewall t 1f80: 68 61 74 20 72 65 71 75 69 72 65 73 20 79 6f 75 hat requires you 1f90: 20 74 6f 20 75 73 65 0a 20 20 20 20 61 6e 20 48 to use. an H 1fa0: 54 54 50 20 70 72 6f 78 79 20 74 6f 20 72 65 61 TTP proxy to rea 1fb0: 63 68 20 74 68 65 20 69 6e 74 65 72 6e 65 74 2c ch the internet, 1fc0: 20 74 68 65 6e 20 79 6f 75 20 63 61 6e 20 63 6f then you can co 1fd0: 6e 66 69 67 75 72 65 20 74 68 65 20 70 72 6f 78 nfigure the prox 1fe0: 79 0a 20 20 20 20 69 6e 20 74 68 72 65 65 20 64 y. in three d 1ff0: 69 66 66 65 72 65 6e 74 20 77 61 79 73 2e 20 20 ifferent ways. 2000: 59 6f 75 20 63 61 6e 20 74 65 6c 6c 20 66 6f 73 You can tell fos 2010: 73 69 6c 20 61 62 6f 75 74 20 79 6f 75 72 20 70 sil about your p 2020: 72 6f 78 79 20 75 73 69 6e 67 0a 20 20 20 20 61 roxy using. a 2030: 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 6f 70 command-line op 2040: 74 69 6f 6e 20 6f 6e 20 63 6f 6d 6d 61 6e 64 73 tion on commands 2050: 20 74 68 61 74 20 75 73 65 20 74 68 65 20 6e 65 that use the ne 2060: 74 77 6f 72 6b 2c 0a 20 20 20 20 3c 62 3e 73 79 twork,. <b>sy 2070: 6e 63 3c 2f 62 3e 2c 20 3c 62 3e 63 6c 6f 6e 65 nc</b>, <b>clone 2080: 3c 2f 62 3e 2c 20 3c 62 3e 70 75 73 68 3c 2f 62 </b>, <b>push</b 2090: 3e 2c 20 61 6e 64 20 3c 62 3e 70 75 6c 6c 3c 2f >, and <b>pull</ 20a0: 62 3e 2e 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c b>.</p>.. <bl 20b0: 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 ockquote>. <b 20c0: 3e 66 6f 73 73 69 6c 20 63 6c 6f 6e 65 20 3c 2f >fossil clone </ 20d0: 62 3e 3c 69 3e 55 52 4c 3c 2f 69 3e 20 20 3c 62 b><i>URL</i> <b 20e0: 3e 2d 2d 70 72 6f 78 79 3c 2f 62 3e 20 3c 69 3e >--proxy</b> <i> 20f0: 50 72 6f 78 79 2d 55 52 4c 3c 2f 69 3e 0a 20 20 Proxy-URL</i>. 2100: 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a </blockquote>. 2110: 0a 20 20 20 20 3c 70 3e 49 74 20 69 73 20 61 6e . <p>It is an 2120: 6e 6f 79 69 6e 67 20 74 6f 20 68 61 76 65 20 74 noying to have t 2130: 6f 20 74 79 70 65 20 69 6e 20 74 68 65 20 70 72 o type in the pr 2140: 6f 78 79 20 55 52 4c 20 65 76 65 72 79 20 74 69 oxy URL every ti 2150: 6d 65 20 79 6f 75 0a 20 20 20 20 73 79 6e 63 20 me you. sync 2160: 79 6f 75 72 20 70 72 6f 6a 65 63 74 2c 20 74 68 your project, th 2170: 6f 75 67 68 2c 20 73 6f 20 79 6f 75 20 63 61 6e ough, so you can 2180: 20 6d 61 6b 65 20 74 68 65 20 70 72 6f 78 79 20 make the proxy 2190: 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 0a 20 20 configuration. 21a0: 20 20 70 65 72 73 69 73 74 65 6e 74 20 75 73 69 persistent usi 21b0: 6e 67 20 74 68 65 20 3c 62 3e 73 65 74 74 69 6e ng the <b>settin 21c0: 67 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 3a 3c 2f g</b> command:</ 21d0: 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 p>.. <blockqu 21e0: 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 ote>. <b>foss 21f0: 69 6c 20 73 65 74 74 69 6e 67 20 70 72 6f 78 79 il setting proxy 2200: 20 3c 2f 62 3e 3c 69 3e 50 72 6f 78 79 2d 55 52 </b><i>Proxy-UR 2210: 4c 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 L</i>. </bloc 2220: 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e kquote>.. <p> 2230: 4f 72 2c 20 79 6f 75 20 63 61 6e 20 73 65 74 20 Or, you can set 2240: 74 68 65 20 22 3c 62 3e 68 74 74 70 5f 70 72 6f the "<b>http_pro 2250: 78 79 3c 2f 62 3e 22 20 65 6e 76 69 72 6f 6e 6d xy</b>" environm 2260: 65 6e 74 20 76 61 72 69 61 62 6c 65 3a 3c 2f 70 ent variable:</p 2270: 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f >.. <blockquo 2280: 74 65 3e 0a 20 20 20 20 3c 62 3e 65 78 70 6f 72 te>. <b>expor 2290: 74 20 68 74 74 70 5f 70 72 6f 78 79 3d 3c 2f 62 t http_proxy=</b 22a0: 3e 3c 69 3e 50 72 6f 78 79 2d 55 52 4c 3c 2f 69 ><i>Proxy-URL</i 22b0: 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f >. </blockquo 22c0: 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 6f 20 73 te>.. <p>To s 22d0: 74 6f 70 20 75 73 69 6e 67 20 74 68 65 20 70 72 top using the pr 22e0: 6f 78 79 2c 20 64 6f 3a 3c 2f 70 3e 0a 0a 20 20 oxy, do:</p>.. 22f0: 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 <blockquote>. 2300: 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 73 65 74 <b>fossil set 2310: 74 69 6e 67 20 70 72 6f 78 79 20 6f 66 66 3c 2f ting proxy off</ 2320: 62 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 b>. </blockqu 2330: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 4f 72 20 ote>.. <p>Or 2340: 75 6e 73 65 74 20 74 68 65 20 65 6e 76 69 72 6f unset the enviro 2350: 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 2e 20 nment variable. 2360: 20 54 68 65 20 66 6f 73 73 69 6c 20 73 65 74 74 The fossil sett 2370: 69 6e 67 20 66 6f 72 20 74 68 65 0a 20 20 20 20 ing for the. 2380: 48 54 54 50 20 70 72 6f 78 79 20 74 61 6b 65 73 HTTP proxy takes 2390: 20 70 72 65 63 65 64 65 6e 63 65 20 6f 76 65 72 precedence over 23a0: 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 the environment 23b0: 20 76 61 72 69 61 62 6c 65 20 61 6e 64 20 74 68 variable and th 23c0: 65 0a 20 20 20 20 63 6f 6d 6d 61 6e 64 2d 6c 69 e. command-li 23d0: 6e 65 20 6f 70 74 69 6f 6e 20 6f 76 65 72 72 69 ne option overri 23e0: 64 65 73 20 62 6f 74 68 2e 20 20 49 66 20 79 6f des both. If yo 23f0: 75 20 68 61 76 65 20 61 6e 20 70 65 72 73 69 73 u have an persis 2400: 74 65 6e 74 0a 20 20 20 20 70 72 6f 78 79 20 73 tent. proxy s 2410: 65 74 74 69 6e 67 20 74 68 61 74 20 79 6f 75 20 etting that you 2420: 77 61 6e 74 20 74 6f 20 6f 76 65 72 72 69 64 65 want to override 2430: 20 66 6f 72 20 61 20 6f 6e 65 2d 74 69 6d 65 20 for a one-time 2440: 73 79 6e 63 2c 20 74 68 61 74 0a 20 20 20 20 69 sync, that. i 2450: 73 20 65 61 73 69 6c 79 20 64 6f 6e 65 20 6f 6e s easily done on 2460: 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e the command-lin 2470: 65 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c e. For example, 2480: 20 74 6f 20 73 79 6e 63 20 77 69 74 68 0a 20 20 to sync with. 2490: 20 20 61 20 63 6f 2d 77 6f 72 6b 65 72 73 20 72 a co-workers r 24a0: 65 70 6f 73 69 74 6f 72 79 20 6f 6e 20 79 6f 75 epository on you 24b0: 72 20 4c 41 4e 2c 20 79 6f 75 20 6d 69 67 68 74 r LAN, you might 24c0: 20 74 79 70 65 3a 3c 2f 70 3e 20 20 20 0a 0a 20 type:</p> .. 24d0: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a <blockquote>. 24e0: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 73 79 <b>fossil sy 24f0: 6e 63 20 68 74 74 70 3a 2f 2f 31 39 32 2e 31 36 nc http://192.16 2500: 38 2e 31 2e 33 36 3a 38 30 38 30 2f 20 2d 2d 70 8.1.36:8080/ --p 2510: 72 6f 78 79 20 6f 66 66 3c 2f 62 3e 0a 20 20 20 roxy off</b>. 2520: 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a </blockquote>.. 2530: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 </blockquote><h2 2540: 3e 4d 6f 72 65 20 48 69 6e 74 73 3c 2f 68 32 3e >More Hints</h2> 2550: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 <blockquote>.. 2560: 20 20 3c 70 3e 54 72 79 20 74 68 65 73 65 20 63 <p>Try these c 2570: 6f 6d 6d 61 6e 64 73 3a 3c 2f 70 3e 0a 0a 20 20 ommands:</p>.. 2580: 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 62 <blockquote><b 2590: 3e 0a 20 20 20 20 66 6f 73 73 69 6c 20 68 65 6c >. fossil hel 25a0: 70 3c 62 72 3e 0a 20 20 20 20 66 6f 73 73 69 6c p<br>. fossil 25b0: 20 74 65 73 74 2d 63 6f 6d 6d 61 6e 64 73 0a 20 test-commands. 25c0: 20 20 20 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 75 </b></blockqu 25d0: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 45 78 70 ote>.. <p>Exp 25e0: 6c 6f 72 65 20 61 6e 64 20 68 61 76 65 20 66 75 lore and have fu 25f0: 6e 21 3c 2f 70 3e 0a 0a 0a 3c 2f 62 6c 6f 63 6b n!</p>...</block 2600: 71 75 6f 74 65 3e 0a 0a quote>..