Artifact fee246136eaeb3f787647b1b43755abe0b9575a6:
File www/quickstart.html part of check-in [c7438f6dc9] - Fix the fossil repository URL in the quickstart.html document. by drh on 2008-05-05 18:39:36.
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 20 20 </blockquote>. 0480: 20 20 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e .</blockquote> 0490: 3c 68 32 3e 53 74 61 72 74 69 6e 67 20 41 20 4e <h2>Starting A N 04a0: 65 77 20 50 72 6f 6a 65 63 74 3c 2f 68 32 3e 3c ew Project</h2>< 04b0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 blockquote>.. 04c0: 20 3c 70 3e 54 6f 20 73 74 61 72 74 20 61 20 6e <p>To start a n 04d0: 65 77 20 70 72 6f 6a 65 63 74 20 77 69 74 68 20 ew project with 04e0: 66 6f 73 73 69 6c 2c 20 63 72 65 61 74 65 20 61 fossil, create a 04f0: 20 6e 65 77 20 65 6d 70 74 79 20 72 65 70 6f 73 new empty repos 0500: 69 74 6f 72 79 0a 20 20 20 20 74 68 69 73 20 77 itory. this w 0510: 61 79 3a 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 20 ay:</p>. . 0520: 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 <blockquote>. 0530: 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6e 65 77 20 <b>fossil new 0540: 3c 2f 62 3e 3c 69 3e 20 72 65 70 6f 73 69 74 6f </b><i> reposito 0550: 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 0a ry-filename</i>. 0560: 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 </blockquote 0570: 3e 0a 20 20 20 20 0a 3c 2f 62 6c 6f 63 6b 71 75 >. .</blockqu 0580: 6f 74 65 3e 3c 68 32 3e 43 6f 6e 66 69 67 75 72 ote><h2>Configur 0590: 69 6e 67 20 59 6f 75 72 20 4c 6f 63 61 6c 20 52 ing Your Local R 05a0: 65 70 6f 73 69 74 6f 72 79 3c 2f 68 32 3e 3c 62 epository</h2><b 05b0: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 0a lockquote>. . 05c0: 20 20 20 20 3c 70 3e 57 68 65 6e 20 79 6f 75 20 <p>When you 05d0: 63 72 65 61 74 65 20 61 20 6e 65 77 20 72 65 70 create a new rep 05e0: 6f 73 69 74 6f 72 79 2c 20 65 69 74 68 65 72 20 ository, either 05f0: 62 79 20 63 6c 6f 6e 69 6e 67 20 61 6e 20 65 78 by cloning an ex 0600: 69 73 74 69 6e 67 0a 20 20 20 20 70 72 6f 6a 65 isting. proje 0610: 63 74 20 6f 72 20 63 72 65 61 74 65 20 61 20 6e ct or create a n 0620: 65 77 20 70 72 6f 6a 65 63 74 20 6f 66 20 79 6f ew project of yo 0630: 75 72 20 6f 77 6e 2c 20 79 6f 75 20 75 73 75 61 ur own, you usua 0640: 6c 6c 79 20 77 61 6e 74 20 74 6f 20 64 6f 20 73 lly want to do s 0650: 6f 6d 65 0a 20 20 20 20 6c 6f 63 61 6c 20 63 6f ome. local co 0660: 6e 66 69 67 75 72 61 74 69 6f 6e 2e 20 20 54 68 nfiguration. Th 0670: 69 73 20 69 73 20 61 63 63 6f 6d 70 6c 69 73 68 is is accomplish 0680: 65 64 20 75 73 69 6e 67 20 61 20 77 65 62 62 72 ed using a webbr 0690: 6f 77 73 65 72 2e 20 20 46 69 72 73 74 0a 20 20 owser. First. 06a0: 20 20 73 74 61 72 74 20 61 20 66 6f 73 73 69 6c start a fossil 06b0: 20 77 65 62 73 65 72 76 65 72 20 6c 69 6b 65 20 webserver like 06c0: 74 68 69 73 3a 3c 2f 70 3e 0a 20 20 20 20 0a 20 this:</p>. . 06d0: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a <blockquote>. 06e0: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 73 65 <b>fossil se 06f0: 72 76 65 72 20 3c 2f 62 3e 3c 69 3e 20 72 65 70 rver </b><i> rep 0700: 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 ository-filename 0710: 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b </i>. </block 0720: 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 quote>.. <p>T 0730: 68 69 73 20 63 72 65 61 74 65 73 20 61 20 6d 69 his creates a mi 0740: 6e 69 2d 77 65 62 73 65 72 76 65 72 20 6c 69 73 ni-webserver lis 0750: 74 65 6e 69 6e 67 20 6f 6e 20 70 6f 72 74 20 38 tening on port 8 0760: 30 38 30 2e 20 20 59 6f 75 20 63 61 6e 0a 20 20 080. You can. 0770: 20 20 73 70 65 63 69 66 79 20 61 20 64 69 66 66 specify a diff 0780: 65 72 65 6e 74 20 70 6f 72 74 20 75 73 69 6e 67 erent port using 0790: 20 74 68 65 20 3c 62 3e 2d 70 6f 72 74 3c 2f 62 the <b>-port</b 07a0: 3e 20 6f 70 74 69 6f 6e 20 6f 6e 20 74 68 65 20 > option on the 07b0: 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 2e 0a 20 20 command-line.. 07c0: 20 20 41 66 74 65 72 20 74 68 65 20 73 65 72 76 After the serv 07d0: 65 72 20 69 73 20 72 75 6e 6e 69 6e 67 2c 20 70 er is running, p 07e0: 6f 69 6e 74 20 79 6f 75 72 20 77 65 62 62 72 6f oint your webbro 07f0: 77 73 65 72 20 61 74 0a 20 20 20 20 68 74 74 70 wser at. http 0800: 3a 2f 2f 6c 6f 63 61 6c 68 6f 73 74 3a 38 30 38 ://localhost:808 0810: 30 2f 20 61 6e 64 20 73 74 61 72 74 20 63 6f 6e 0/ and start con 0820: 66 69 67 75 72 69 6e 67 2e 3c 2f 70 3e 0a 20 20 figuring.</p>. 0830: 20 20 0a 20 20 20 20 3c 70 3e 42 79 20 64 65 66 . <p>By def 0840: 61 75 6c 74 2c 20 66 6f 73 73 69 6c 20 64 6f 65 ault, fossil doe 0850: 73 20 6e 6f 74 20 72 65 71 75 69 72 65 20 61 20 s not require a 0860: 6c 6f 67 69 6e 20 66 6f 72 20 48 54 54 50 20 63 login for HTTP c 0870: 6f 6e 6e 65 63 74 69 6f 6e 73 0a 20 20 20 20 63 onnections. c 0880: 6f 6d 69 6e 67 20 69 6e 20 66 72 6f 6d 20 74 68 oming in from th 0890: 65 20 49 50 20 6c 6f 6f 70 62 61 63 6b 20 61 64 e IP loopback ad 08a0: 64 72 65 73 73 20 31 32 37 2e 30 2e 30 2e 31 2e dress 127.0.0.1. 08b0: 20 20 59 6f 75 20 63 61 6e 2c 20 61 6e 64 20 70 You can, and p 08c0: 65 72 68 61 70 73 0a 20 20 20 20 73 68 6f 75 6c erhaps. shoul 08d0: 64 2c 20 63 68 61 6e 67 65 20 74 68 69 73 20 61 d, change this a 08e0: 66 74 65 72 20 79 6f 75 20 63 72 65 61 74 65 20 fter you create 08f0: 61 20 66 65 77 20 75 73 65 72 73 2e 3c 2f 70 3e a few users.</p> 0900: 0a 20 20 20 20 0a 20 20 20 20 3c 70 3e 57 68 65 . . <p>Whe 0910: 6e 20 79 6f 75 20 61 72 65 20 66 69 6e 69 73 68 n you are finish 0920: 65 64 20 63 6f 6e 66 69 67 75 72 69 6e 67 2c 20 ed configuring, 0930: 6a 75 73 74 20 70 72 65 73 73 20 43 6f 6e 74 72 just press Contr 0940: 6f 6c 2d 43 20 6f 72 20 75 73 65 0a 20 20 20 20 ol-C or use. 0950: 74 68 65 20 3c 62 3e 6b 69 6c 6c 3c 2f 62 3e 20 the <b>kill</b> 0960: 63 6f 6d 6d 61 6e 64 20 74 6f 20 73 68 75 74 20 command to shut 0970: 64 6f 77 6e 20 74 68 65 20 6d 69 6e 69 2d 73 65 down the mini-se 0980: 72 76 65 72 2e 3c 2f 70 3e 0a 0a 3c 2f 62 6c 6f rver.</p>..</blo 0990: 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 43 68 65 63 ckquote><h2>Chec 09a0: 6b 69 6e 67 20 4f 75 74 20 41 20 4c 6f 63 61 6c king Out A Local 09b0: 20 54 72 65 65 3c 2f 68 32 3e 3c 62 6c 6f 63 6b Tree</h2><block 09c0: 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 quote>.. <p>T 09d0: 6f 20 77 6f 72 6b 20 6f 6e 20 61 20 70 72 6f 6a o work on a proj 09e0: 65 63 74 20 69 6e 20 66 6f 73 73 69 6c 2c 20 79 ect in fossil, y 09f0: 6f 75 20 6e 65 65 64 20 74 6f 20 63 68 65 63 6b ou need to check 0a00: 20 6f 75 74 20 61 20 6c 6f 63 61 6c 0a 20 20 20 out a local. 0a10: 20 63 6f 70 79 20 6f 66 20 74 68 65 20 73 6f 75 copy of the sou 0a20: 72 63 65 20 74 72 65 65 2e 20 20 43 72 65 61 74 rce tree. Creat 0a30: 65 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 20 e the directory 0a40: 79 6f 75 20 77 61 6e 74 20 74 6f 20 62 65 0a 20 you want to be. 0a50: 20 20 20 74 68 65 20 72 6f 6f 74 20 6f 66 20 79 the root of y 0a60: 6f 75 72 20 74 72 65 65 20 61 6e 64 20 63 64 20 our tree and cd 0a70: 69 6e 74 6f 20 74 68 61 74 20 64 69 72 65 63 74 into that direct 0a80: 6f 72 79 2e 20 20 54 68 65 6e 0a 20 20 20 20 74 ory. Then. t 0a90: 6f 20 74 68 69 73 3a 3c 2f 70 3e 0a 20 20 20 20 o this:</p>. 0aa0: 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 . <blockquote 0ab0: 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 >. <b>fossil 0ac0: 6f 70 65 6e 20 3c 2f 62 3e 3c 69 3e 20 72 65 70 open </b><i> rep 0ad0: 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 ository-filename 0ae0: 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b </i>. </block 0af0: 71 75 6f 74 65 3e 0a 20 20 20 20 0a 20 20 20 20 quote>. . 0b00: 3c 70 3e 54 68 69 73 20 6c 65 61 76 65 73 20 79 <p>This leaves y 0b10: 6f 75 20 77 69 74 68 20 74 68 65 20 6f 72 69 67 ou with the orig 0b20: 69 6e 61 6c 20 28 65 6d 70 74 79 29 20 76 65 72 inal (empty) ver 0b30: 73 69 6f 6e 20 6f 66 20 74 68 65 20 74 72 65 65 sion of the tree 0b40: 0a 20 20 20 20 63 68 65 63 6b 65 64 20 6f 75 74 . checked out 0b50: 2e 20 20 54 6f 20 67 65 74 20 74 6f 20 74 68 65 . To get to the 0b60: 20 6c 61 74 65 73 74 20 76 65 72 73 69 6f 6e 2c latest version, 0b70: 20 61 6c 73 6f 20 64 6f 20 74 68 69 73 3a 3c 2f also do this:</ 0b80: 70 3e 0a 20 20 20 20 0a 20 20 20 20 3c 62 6c 6f p>. . <blo 0b90: 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e ckquote>. <b> 0ba0: 66 6f 73 73 69 6c 20 75 70 64 61 74 65 3c 2f 62 fossil update</b 0bb0: 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f >. </blockquo 0bc0: 74 65 3e 0a 20 20 20 20 0a 20 20 20 20 3c 70 3e te>. . <p> 0bd0: 46 72 6f 6d 20 61 6e 79 77 68 65 72 65 20 75 6e From anywhere un 0be0: 64 65 72 6e 65 61 74 68 20 74 68 65 20 72 6f 6f derneath the roo 0bf0: 74 20 6f 66 20 79 6f 75 72 20 6c 6f 63 61 6c 20 t of your local 0c00: 74 72 65 65 2c 20 79 6f 75 0a 20 20 20 20 63 61 tree, you. ca 0c10: 6e 20 74 79 70 65 20 63 6f 6d 6d 61 6e 64 73 20 n type commands 0c20: 6c 69 6b 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69 like the followi 0c30: 6e 67 20 74 6f 20 66 69 6e 64 20 6f 75 74 20 74 ng to find out t 0c40: 68 65 20 73 74 61 74 75 73 20 6f 66 0a 20 20 20 he status of. 0c50: 20 79 6f 75 72 20 6c 6f 63 61 6c 20 74 72 65 65 your local tree 0c60: 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 :</p>.. <bloc 0c70: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 kquote>. <b>f 0c80: 6f 73 73 69 6c 20 69 6e 66 6f 3c 2f 62 3e 3c 62 ossil info</b><b 0c90: 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c r>. <b>fossil 0ca0: 20 73 74 61 74 75 73 3c 2f 62 3e 3c 62 72 3e 0a status</b><br>. 0cb0: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 63 68 <b>fossil ch 0cc0: 61 6e 67 65 73 3c 2f 62 3e 3c 62 72 3e 0a 20 20 anges</b><br>. 0cd0: 20 20 3c 62 3e 66 6f 73 73 69 6c 20 74 69 6d 65 <b>fossil time 0ce0: 6c 69 6e 65 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 line</b><br>. 0cf0: 20 3c 62 3e 66 6f 73 73 69 6c 20 6c 65 61 76 65 <b>fossil leave 0d00: 73 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 s</b><br>. <b 0d10: 3e 66 6f 73 73 69 6c 20 6c 73 3c 2f 62 3e 3c 62 >fossil ls</b><b 0d20: 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c r>. <b>fossil 0d30: 20 62 72 61 6e 63 68 65 73 3c 2f 62 3e 3c 62 72 branches</b><br 0d40: 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f >. </blockquo 0d50: 74 65 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 te>..</blockquot 0d60: 65 3e 3c 68 32 3e 4d 61 6b 69 6e 67 20 43 68 61 e><h2>Making Cha 0d70: 6e 67 65 73 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 nges</h2><blockq 0d80: 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 6f uote>.. <p>To 0d90: 20 61 64 64 20 6e 65 77 20 66 69 6c 65 73 20 74 add new files t 0da0: 6f 20 79 6f 75 72 20 70 72 6f 6a 65 63 74 2c 20 o your project, 0db0: 6f 72 20 72 65 6d 6f 76 65 20 6f 6c 64 20 66 69 or remove old fi 0dc0: 6c 65 73 2c 20 75 73 65 20 74 68 65 73 65 0a 20 les, use these. 0dd0: 20 20 20 63 6f 6d 6d 61 6e 64 73 3a 3c 2f 70 3e commands:</p> 0de0: 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 .. <blockquot 0df0: 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c e>. <b>fossil 0e00: 20 61 64 64 3c 2f 62 3e 20 3c 69 3e 66 69 6c 65 add</b> <i>file 0e10: 2e 2e 2e 3c 2f 69 3e 3c 62 72 3e 0a 20 20 20 20 ...</i><br>. 0e20: 3c 62 3e 66 6f 73 73 69 6c 20 72 6d 3c 2f 62 3e <b>fossil rm</b> 0e30: 20 3c 69 3e 66 69 6c 65 2e 2e 2e 3c 2f 69 3e 0a <i>file...</i>. 0e40: 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 </blockquote 0e50: 3e 0a 0a 20 20 20 20 3c 70 3e 59 6f 75 20 63 61 >.. <p>You ca 0e60: 6e 20 61 6c 73 6f 20 65 64 69 74 20 66 69 6c 65 n also edit file 0e70: 73 20 66 72 65 65 6c 79 2e 20 20 4f 6e 63 65 20 s freely. Once 0e80: 79 6f 75 20 61 72 65 20 72 65 61 64 79 20 74 6f you are ready to 0e90: 20 63 6f 6d 6d 69 74 0a 20 20 20 20 79 6f 75 72 commit. your 0ea0: 20 63 68 61 6e 67 65 73 2c 20 74 79 70 65 3a 3c changes, type:< 0eb0: 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 /p>.. <blockq 0ec0: 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 uote>. <b>fos 0ed0: 73 69 6c 20 63 6f 6d 6d 69 74 3c 2f 62 3e 0a 20 sil commit</b>. 0ee0: 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e </blockquote> 0ef0: 0a 0a 20 20 20 20 3c 70 3e 59 6f 75 20 77 69 6c .. <p>You wil 0f00: 6c 20 62 65 20 70 72 6f 6d 70 74 65 64 20 66 6f l be prompted fo 0f10: 72 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d 6d 65 r check-in comme 0f20: 6e 74 73 20 75 73 69 6e 67 20 77 68 61 74 65 76 nts using whatev 0f30: 65 72 20 65 64 69 74 6f 72 0a 20 20 20 20 69 73 er editor. is 0f40: 20 73 70 65 63 69 66 69 65 64 20 62 79 20 79 6f specified by yo 0f50: 75 72 20 56 49 53 55 41 4c 20 6f 72 20 45 44 49 ur VISUAL or EDI 0f60: 54 4f 52 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 TOR environment 0f70: 76 61 72 69 61 62 6c 65 2e 20 20 49 66 20 79 6f variable. If yo 0f80: 75 0a 20 20 20 20 68 61 76 65 20 47 50 47 20 69 u. have GPG i 0f90: 6e 73 74 61 6c 6c 65 64 2c 20 79 6f 75 20 6d 61 nstalled, you ma 0fa0: 79 20 62 65 20 70 72 6f 6d 70 74 65 64 20 66 6f y be prompted fo 0fb0: 72 20 79 6f 75 72 20 47 50 47 20 70 61 73 73 70 r your GPG passp 0fc0: 68 72 61 73 65 20 73 6f 0a 20 20 20 20 74 68 61 hrase so. tha 0fd0: 74 20 74 68 65 20 63 68 65 63 6b 2d 69 6e 20 63 t the check-in c 0fe0: 61 6e 20 62 65 20 73 69 67 6e 65 64 20 77 69 74 an be signed wit 0ff0: 68 20 79 6f 75 72 20 47 50 47 20 73 69 67 6e 61 h your GPG signa 1000: 74 75 72 65 2e 20 20 41 66 74 65 72 0a 20 20 20 ture. After. 1010: 20 74 68 69 73 20 79 6f 75 72 20 63 68 61 6e 67 this your chang 1020: 65 73 20 77 69 6c 6c 20 62 65 20 63 68 65 63 6b es will be check 1030: 65 64 20 69 6e 2e 3c 2f 70 3e 0a 0a 3c 2f 62 6c ed in.</p>..</bl 1040: 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 53 68 61 ockquote><h2>Sha 1050: 72 69 6e 67 20 43 68 61 6e 67 65 73 3c 2f 68 32 ring Changes</h2 1060: 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 ><blockquote>.. 1070: 20 20 20 3c 70 3e 54 68 65 20 63 68 61 6e 67 65 <p>The change 1080: 73 20 79 6f 75 20 3c 62 3e 63 6f 6d 6d 69 74 3c s you <b>commit< 1090: 2f 62 3e 20 61 72 65 20 6f 6e 6c 79 20 6f 6e 20 /b> are only on 10a0: 79 6f 75 72 20 6c 6f 63 61 6c 20 72 65 70 6f 73 your local repos 10b0: 69 74 6f 72 79 2e 0a 20 20 20 20 54 6f 20 73 68 itory.. To sh 10c0: 61 72 65 20 74 68 6f 73 65 20 63 68 61 6e 67 65 are those change 10d0: 73 20 77 69 74 68 20 6f 74 68 65 72 20 72 65 70 s with other rep 10e0: 6f 73 69 74 6f 72 69 65 73 2c 20 64 6f 3a 3c 2f ositories, do:</ 10f0: 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 p>.. <blockqu 1100: 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 ote>. <b>foss 1110: 69 6c 20 70 75 73 68 3c 2f 62 3e 20 3c 69 3e 55 il push</b> <i>U 1120: 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f RL</i>. </blo 1130: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 ckquote>.. <p 1140: 3e 57 68 65 72 65 20 3c 69 3e 55 52 4c 3c 2f 69 >Where <i>URL</i 1150: 3e 20 69 73 20 74 68 65 20 68 74 74 70 3a 20 55 > is the http: U 1160: 52 4c 20 6f 66 20 74 68 65 20 73 65 72 76 65 72 RL of the server 1170: 20 72 65 70 6f 73 69 74 6f 72 79 20 79 6f 75 0a repository you. 1180: 20 20 20 20 77 61 6e 74 20 74 6f 20 73 68 61 72 want to shar 1190: 65 20 79 6f 75 72 20 63 68 61 6e 67 65 73 20 77 e your changes w 11a0: 69 74 68 2e 20 20 49 66 20 79 6f 75 20 6f 6d 69 ith. If you omi 11b0: 74 20 74 68 65 20 3c 69 3e 55 52 4c 3c 2f 69 3e t the <i>URL</i> 11c0: 20 61 72 67 75 6d 65 6e 74 2c 0a 20 20 20 20 66 argument,. f 11d0: 6f 73 73 69 6c 20 77 69 6c 6c 20 75 73 65 20 77 ossil will use w 11e0: 68 61 74 65 76 65 72 20 73 65 72 76 65 72 20 79 hatever server y 11f0: 6f 75 20 6d 6f 73 74 20 72 65 63 65 6e 74 6c 79 ou most recently 1200: 20 73 79 6e 63 65 64 20 77 69 74 68 2e 3c 2f 70 synced with.</p 1210: 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 3c 62 >.. <p>The <b 1220: 3e 70 75 73 68 3c 2f 62 3e 20 63 6f 6d 6d 61 6e >push</b> comman 1230: 64 20 6f 6e 6c 79 20 73 65 6e 64 73 20 79 6f 75 d only sends you 1240: 72 20 63 68 61 6e 67 65 73 20 74 6f 20 6f 74 68 r changes to oth 1250: 65 72 73 2e 20 20 54 6f 0a 20 20 20 20 52 65 63 ers. To. Rec 1260: 65 69 76 65 20 63 68 61 6e 67 65 73 20 66 72 6f eive changes fro 1270: 6d 20 6f 74 68 65 72 73 2c 20 75 73 65 20 3c 62 m others, use <b 1280: 3e 70 75 6c 6c 3c 2f 62 3e 2e 20 20 4f 72 20 67 >pull</b>. Or g 1290: 6f 20 62 6f 74 68 20 77 61 79 73 20 61 74 0a 20 o both ways at. 12a0: 20 20 20 6f 6e 63 65 20 75 73 69 6e 67 20 3c 62 once using <b 12b0: 3e 73 79 6e 63 3c 2f 62 3e 3a 3c 2f 70 3e 0a 0a >sync</b>:</p>.. 12c0: 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e <blockquote> 12d0: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 70 . <b>fossil p 12e0: 75 6c 6c 3c 2f 62 3e 20 3c 69 3e 55 52 4c 3c 2f ull</b> <i>URL</ 12f0: 69 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f i><br>. <b>fo 1300: 73 73 69 6c 20 73 79 6e 63 3c 2f 62 3e 20 3c 69 ssil sync</b> <i 1310: 3e 55 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 >URL</i>. </b 1320: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 lockquote>.. 1330: 3c 70 3e 57 68 65 6e 20 79 6f 75 20 70 75 6c 6c <p>When you pull 1340: 20 69 6e 20 63 68 61 6e 67 65 73 20 66 72 6f 6d in changes from 1350: 20 6f 74 68 65 72 73 2c 20 74 68 65 79 20 67 6f others, they go 1360: 20 69 6e 74 6f 20 79 6f 75 72 20 72 65 70 6f 73 into your repos 1370: 69 74 6f 72 79 2c 0a 20 20 20 20 6e 6f 74 20 69 itory,. not i 1380: 6e 74 6f 20 79 6f 75 72 20 63 68 65 63 6b 65 64 nto your checked 1390: 2d 6f 75 74 20 6c 6f 63 61 6c 20 74 72 65 65 2e -out local tree. 13a0: 20 20 54 6f 20 67 65 74 20 74 68 65 20 63 68 61 To get the cha 13b0: 6e 67 65 73 20 69 6e 74 6f 20 79 6f 75 72 0a 20 nges into your. 13c0: 20 20 20 6c 6f 63 61 6c 20 74 72 65 65 2c 20 75 local tree, u 13d0: 73 65 20 3c 62 3e 75 70 64 61 74 65 3c 2f 62 3e se <b>update</b> 13e0: 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 :</p>.. <bloc 13f0: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 kquote>. <b>f 1400: 6f 73 73 69 6c 20 75 70 64 61 74 65 3c 2f 62 3e ossil update</b> 1410: 20 3c 69 3e 55 55 49 44 3c 2f 69 3e 0a 20 20 20 <i>UUID</i>. 1420: 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a </blockquote>.. 1430: 20 20 20 20 3c 70 3e 54 68 65 20 3c 69 3e 55 55 <p>The <i>UU 1440: 49 44 3c 2f 69 3e 20 69 73 20 73 6f 6d 65 20 75 ID</i> is some u 1450: 6e 69 71 75 65 20 61 62 62 72 65 76 69 61 74 69 nique abbreviati 1460: 6f 6e 20 74 6f 20 74 68 65 20 34 30 2d 63 68 61 on to the 40-cha 1470: 72 61 63 74 65 72 0a 20 20 20 20 76 65 72 73 69 racter. versi 1480: 6f 6e 20 49 44 2e 20 20 49 66 20 79 6f 75 20 6f on ID. If you o 1490: 6d 69 74 20 74 68 65 20 3c 69 3e 55 55 49 44 3c mit the <i>UUID< 14a0: 2f 69 3e 20 66 6f 73 73 69 6c 20 6d 6f 76 65 73 /i> fossil moves 14b0: 20 79 6f 75 20 74 6f 20 74 68 65 0a 20 20 20 20 you to the. 14c0: 6c 65 61 66 20 76 65 72 73 69 6f 6e 20 6f 66 20 leaf version of 14d0: 74 68 65 20 62 72 61 6e 63 68 20 79 6f 75 72 20 the branch your 14e0: 61 72 65 20 63 75 72 72 65 6e 74 6c 79 20 6f 6e are currently on 14f0: 2e 20 20 49 66 20 79 6f 75 72 20 62 72 61 6e 63 . If your branc 1500: 68 0a 20 20 20 20 68 61 73 20 6d 75 6c 74 69 70 h. has multip 1510: 6c 65 20 6c 65 61 76 65 73 2c 20 79 6f 75 20 67 le leaves, you g 1520: 65 74 20 61 6e 20 65 72 72 6f 72 20 2d 20 79 6f et an error - yo 1530: 75 27 6c 6c 20 68 61 76 65 20 74 6f 20 73 70 65 u'll have to spe 1540: 63 69 66 79 20 74 68 65 0a 20 20 20 20 6c 65 61 cify the. lea 1550: 66 20 79 6f 75 20 77 61 6e 74 20 75 73 69 6e 67 f you want using 1560: 20 61 20 3c 69 3e 55 55 49 44 3c 2f 69 3e 20 61 a <i>UUID</i> a 1570: 72 67 75 6d 65 6e 74 2e 3c 2f 70 3e 0a 0a 3c 2f rgument.</p>..</ 1580: 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 42 blockquote><h2>B 1590: 72 61 6e 63 68 69 6e 67 20 41 6e 64 20 4d 65 72 ranching And Mer 15a0: 67 69 6e 67 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 ging</h2><blockq 15b0: 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 59 6f uote>.. <p>Yo 15c0: 75 20 63 61 6e 20 63 72 65 61 74 65 20 62 72 61 u can create bra 15d0: 6e 63 68 65 73 20 62 79 20 64 6f 69 6e 67 20 6d nches by doing m 15e0: 75 6c 74 69 70 6c 65 20 63 6f 6d 6d 69 74 73 20 ultiple commits 15f0: 6f 66 66 20 6f 66 20 74 68 65 0a 20 20 20 20 73 off of the. s 1600: 61 6d 65 20 62 61 73 65 20 76 65 72 73 69 6f 6e ame base version 1610: 2e 20 20 54 6f 20 6d 65 72 67 65 20 74 6f 20 62 . To merge to b 1620: 72 61 6e 63 68 65 73 20 62 61 63 6b 20 74 6f 67 ranches back tog 1630: 65 74 68 65 72 2c 20 66 69 72 73 74 0a 20 20 20 ether, first. 1640: 20 3c 62 3e 75 70 64 61 74 65 3c 2f 62 3e 20 74 <b>update</b> t 1650: 6f 20 74 68 65 20 6c 65 61 66 20 6f 66 20 6f 6e o the leaf of on 1660: 65 20 62 72 61 6e 63 68 2e 20 20 54 68 65 6e 20 e branch. Then 1670: 64 6f 20 61 20 3c 62 3e 6d 65 72 67 65 3c 2f 62 do a <b>merge</b 1680: 3e 0a 20 20 20 20 6f 66 20 74 68 65 20 6c 65 61 >. of the lea 1690: 66 20 6f 66 20 74 68 65 20 6f 74 68 65 72 20 62 f of the other b 16a0: 72 61 6e 63 68 3a 3c 2f 70 3e 0a 0a 20 20 20 20 ranch:</p>.. 16b0: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 <blockquote>. 16c0: 20 3c 62 3e 66 6f 73 73 69 6c 20 6d 65 72 67 65 <b>fossil merge 16d0: 3c 2f 62 3e 20 3c 69 3e 55 55 49 44 3c 2f 69 3e </b> <i>UUID</i> 16e0: 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 . </blockquot 16f0: 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 65 73 74 20 e>.. <p>Test 1700: 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 79 6f 75 to make sure you 1710: 72 20 6d 65 72 67 65 20 64 69 64 6e 27 74 20 6d r merge didn't m 1720: 65 73 73 20 75 70 20 74 68 65 20 63 6f 64 65 2c ess up the code, 1730: 20 74 68 65 6e 0a 20 20 20 20 3c 62 3e 63 6f 6d then. <b>com 1740: 6d 69 74 3c 2f 62 3e 20 61 6e 64 20 70 6f 73 73 mit</b> and poss 1750: 69 62 6c 79 20 61 6c 73 6f 20 3c 62 3e 70 75 73 ibly also <b>pus 1760: 68 3c 2f 62 3e 20 79 6f 75 72 20 63 68 61 6e 67 h</b> your chang 1770: 65 73 2e 20 20 20 52 65 6d 65 6d 62 65 72 0a 20 es. Remember. 1780: 20 20 20 74 68 61 74 20 6e 6f 62 6f 64 79 20 65 that nobody e 1790: 6c 73 65 20 63 61 6e 20 73 65 65 20 79 6f 75 72 lse can see your 17a0: 20 63 68 61 6e 67 65 73 20 75 6e 74 69 6c 20 79 changes until y 17b0: 6f 75 20 3c 62 3e 63 6f 6d 6d 69 74 3c 2f 62 3e ou <b>commit</b> 17c0: 20 61 6e 64 0a 20 20 20 20 69 66 20 6f 74 68 65 and. if othe 17d0: 72 20 61 72 65 20 75 73 69 6e 67 20 61 20 64 69 r are using a di 17e0: 66 66 65 72 65 6e 74 20 72 65 70 6f 73 69 74 6f fferent reposito 17f0: 72 79 20 79 6f 75 20 77 69 6c 6c 20 61 6c 73 6f ry you will also 1800: 20 6e 65 65 64 20 74 6f 0a 20 20 20 20 3c 62 3e need to. <b> 1810: 70 75 73 68 3c 2f 62 3e 2e 3c 2f 70 3e 0a 0a 3c push</b>.</p>..< 1820: 61 20 6e 61 6d 65 3d 22 73 65 72 76 65 72 73 65 a name="serverse 1830: 74 75 70 22 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f tup">.</blockquo 1840: 74 65 3e 3c 68 32 3e 53 65 74 74 69 6e 67 20 55 te><h2>Setting U 1850: 70 20 41 20 53 65 72 76 65 72 3c 2f 68 32 3e 3c p A Server</h2>< 1860: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 blockquote>.. 1870: 20 3c 70 3e 54 68 65 20 65 61 73 69 65 73 74 20 <p>The easiest 1880: 77 61 79 20 74 6f 20 73 65 74 20 75 70 20 61 20 way to set up a 1890: 73 65 72 76 65 72 20 69 73 3a 3c 2f 70 3e 0a 0a server is:</p>.. 18a0: 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e <blockquote> 18b0: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 73 . <b>fossil s 18c0: 65 72 76 65 72 3c 2f 62 3e 20 3c 69 3e 72 65 70 erver</b> <i>rep 18d0: 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 ository-filename 18e0: 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b </i>. </block 18f0: 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 59 quote>.. <p>Y 1900: 6f 75 20 63 61 6e 20 6f 6d 69 74 20 74 68 65 20 ou can omit the 1910: 3c 69 3e 72 65 70 6f 73 69 74 6f 72 79 2d 66 69 <i>repository-fi 1920: 6c 65 6e 61 6d 65 3c 2f 69 3e 20 69 66 20 79 6f lename</i> if yo 1930: 75 20 61 72 65 20 77 69 74 68 69 6e 0a 20 20 20 u are within. 1940: 20 61 20 63 68 65 63 6b 65 64 2d 6f 75 74 20 6c a checked-out l 1950: 6f 63 61 6c 20 74 72 65 65 2e 20 20 54 68 69 73 ocal tree. This 1960: 20 73 65 72 76 65 72 20 75 73 65 73 20 70 6f 72 server uses por 1970: 74 20 38 30 38 30 20 62 79 20 64 65 66 61 75 6c t 8080 by defaul 1980: 74 0a 20 20 20 20 62 75 74 20 79 6f 75 20 63 61 t. but you ca 1990: 6e 20 73 70 65 63 69 66 79 20 61 20 64 69 66 66 n specify a diff 19a0: 65 72 65 6e 74 20 70 6f 72 74 20 75 73 69 6e 67 erent port using 19b0: 20 74 68 65 20 3c 62 3e 2d 70 6f 72 74 3c 2f 62 the <b>-port</b 19c0: 3e 20 63 6f 6d 6d 61 6e 64 2e 3c 2f 70 3e 0a 0a > command.</p>.. 19d0: 20 20 20 20 3c 70 3e 43 6f 6d 6d 61 6e 64 2d 6c <p>Command-l 19e0: 69 6e 65 20 73 65 72 76 65 72 73 20 6c 69 6b 65 ine servers like 19f0: 20 74 68 69 73 20 61 72 65 20 75 73 65 66 75 6c this are useful 1a00: 20 77 68 65 6e 20 74 77 6f 20 70 65 6f 70 6c 65 when two people 1a10: 20 77 61 6e 74 0a 20 20 20 20 74 6f 20 73 68 61 want. to sha 1a20: 72 65 20 61 20 72 65 70 6f 73 69 74 6f 72 79 20 re a repository 1a30: 6f 6e 20 74 65 6d 70 6f 72 61 72 79 20 6f 72 20 on temporary or 1a40: 61 64 2d 68 6f 63 20 62 61 73 69 73 2e 20 20 46 ad-hoc basis. F 1a50: 6f 72 20 61 20 6d 6f 72 65 0a 20 20 20 20 70 65 or a more. pe 1a60: 72 6d 61 6e 65 6e 74 20 69 6e 73 74 61 6c 6c 61 rmanent installa 1a70: 74 69 6f 6e 2c 20 79 6f 75 20 73 68 6f 75 6c 64 tion, you should 1a80: 20 75 73 65 20 65 69 74 68 65 72 20 74 68 65 20 use either the 1a90: 43 47 49 20 73 65 72 76 65 72 20 6f 72 20 74 68 CGI server or th 1aa0: 65 0a 20 20 20 20 69 6e 65 74 64 20 73 65 72 76 e. inetd serv 1ab0: 65 72 2e 20 20 54 6f 20 75 73 65 20 74 68 65 20 er. To use the 1ac0: 43 47 49 20 73 65 72 76 65 72 2c 20 63 72 65 61 CGI server, crea 1ad0: 74 65 20 61 20 43 47 49 20 73 63 72 69 70 74 20 te a CGI script 1ae0: 74 68 61 74 0a 20 20 20 20 6c 6f 6f 6b 73 20 73 that. looks s 1af0: 6f 6d 65 74 68 69 6e 67 20 6c 69 6b 65 20 74 68 omething like th 1b00: 69 73 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c is:</p>.. <bl 1b10: 6f 63 6b 71 75 6f 74 65 3e 3c 62 3e 0a 20 20 20 ockquote><b>. 1b20: 20 23 21 2f 75 73 72 2f 6c 6f 63 61 6c 2f 62 69 #!/usr/local/bi 1b30: 6e 2f 66 6f 73 73 69 6c 3c 62 72 3e 0a 20 20 20 n/fossil<br>. 1b40: 20 72 65 70 6f 73 69 74 6f 72 79 3a 20 2f 68 6f repository: /ho 1b50: 6d 65 2f 70 72 6f 6a 31 2f 72 65 70 6f 73 31 2e me/proj1/repos1. 1b60: 66 73 6c 0a 20 20 20 20 3c 2f 62 3e 3c 2f 62 6c fsl. </b></bl 1b70: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c ockquote>.. < 1b80: 70 3e 41 64 6a 75 73 74 20 74 68 65 20 70 61 74 p>Adjust the pat 1b90: 68 73 20 69 6e 20 74 68 69 73 20 43 47 49 20 73 hs in this CGI s 1ba0: 63 72 69 70 74 20 74 6f 20 6d 61 74 63 68 20 79 cript to match y 1bb0: 6f 75 72 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e our installation 1bc0: 2e 0a 20 20 20 20 4e 6f 77 20 70 6f 69 6e 74 20 .. Now point 1bd0: 63 6c 69 65 6e 74 73 20 61 74 20 74 68 65 20 43 clients at the C 1be0: 47 49 20 73 63 72 69 70 74 2e 20 20 54 68 61 74 GI script. That 1bf0: 27 73 20 61 6c 6c 20 74 68 65 72 65 20 69 73 20 's all there is 1c00: 74 6f 20 69 74 21 3c 2f 70 3e 0a 0a 20 20 20 20 to it!</p>.. 1c10: 3c 70 3e 59 6f 75 20 63 61 6e 20 61 6c 73 6f 20 <p>You can also 1c20: 72 75 6e 20 66 6f 73 73 69 6c 20 6f 66 66 20 6f run fossil off o 1c30: 66 20 69 6e 65 74 64 20 6f 72 20 78 69 6e 65 74 f inetd or xinet 1c40: 64 2e 20 20 46 6f 72 20 61 6e 20 69 6e 65 74 64 d. For an inetd 1c50: 0a 20 20 20 20 69 6e 73 74 61 6c 6c 61 74 69 6f . installatio 1c60: 6e 2c 20 6d 61 6b 65 20 61 6e 20 65 6e 74 72 79 n, make an entry 1c70: 20 69 6e 20 2f 65 74 63 2f 69 6e 65 74 64 2e 63 in /etc/inetd.c 1c80: 6f 6e 66 20 74 68 61 74 20 6c 6f 6f 6b 73 20 73 onf that looks s 1c90: 6f 6d 65 74 68 69 6e 67 0a 20 20 20 20 6c 69 6b omething. lik 1ca0: 65 20 74 68 69 73 3a 3c 2f 70 3e 0a 0a 20 20 20 e this:</p>.. 1cb0: 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 62 3e <blockquote><b> 1cc0: 0a 20 20 20 20 38 30 20 73 74 72 65 61 6d 20 74 . 80 stream t 1cd0: 63 70 20 6e 6f 77 61 69 74 2e 31 30 30 30 20 72 cp nowait.1000 r 1ce0: 6f 6f 74 20 2f 75 73 72 2f 62 69 6e 2f 66 6f 73 oot /usr/bin/fos 1cf0: 73 69 6c 20 5c 3c 62 72 3e 0a 20 20 20 20 20 20 sil \<br>. 1d00: 20 20 2f 75 73 72 2f 62 69 6e 2f 66 6f 73 73 69 /usr/bin/fossi 1d10: 6c 20 68 74 74 70 20 2f 68 6f 6d 65 2f 70 72 6f l http /home/pro 1d20: 6a 31 2f 72 65 70 6f 73 31 2e 66 73 6c 0a 20 20 j1/repos1.fsl. 1d30: 20 20 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 75 6f </b></blockquo 1d40: 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 41 64 6a 75 te>.. <p>Adju 1d50: 73 74 20 74 68 65 20 70 61 74 68 73 20 74 6f 20 st the paths to 1d60: 73 75 69 74 20 79 6f 75 72 20 69 6e 73 74 61 6c suit your instal 1d70: 6c 61 74 69 6f 6e 2c 20 6f 66 20 63 6f 75 72 73 lation, of cours 1d80: 65 2e 20 20 4e 6f 74 69 63 65 20 74 68 61 74 0a e. Notice that. 1d90: 20 20 20 20 66 6f 73 73 69 6c 20 72 75 6e 73 20 fossil runs 1da0: 61 73 20 72 6f 6f 74 2e 20 20 54 68 69 73 20 69 as root. This i 1db0: 73 20 6e 6f 74 20 72 65 71 75 69 72 65 64 20 2d s not required - 1dc0: 20 79 6f 75 20 63 61 6e 20 72 75 6e 20 69 74 20 you can run it 1dd0: 61 73 20 61 6e 0a 20 20 20 20 75 6e 70 72 69 76 as an. unpriv 1de0: 69 6c 65 67 65 64 20 75 73 65 72 2e 20 20 42 75 ileged user. Bu 1df0: 74 20 69 74 20 69 73 20 6d 6f 72 65 20 73 65 63 t it is more sec 1e00: 75 72 65 20 74 6f 20 72 75 6e 20 66 6f 73 73 69 ure to run fossi 1e10: 6c 20 61 73 20 72 6f 6f 74 2e 0a 20 20 20 20 57 l as root.. W 1e20: 68 65 6e 20 79 6f 75 20 64 6f 20 72 75 6e 20 66 hen you do run f 1e30: 6f 73 73 69 6c 20 61 73 20 72 6f 6f 74 2c 20 69 ossil as root, i 1e40: 74 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 t automatically 1e50: 70 75 74 73 20 69 74 73 65 6c 66 20 69 6e 20 61 puts itself in a 1e60: 0a 20 20 20 20 63 68 72 6f 6f 74 20 6a 61 69 6c . chroot jail 1e70: 20 69 6e 20 74 68 65 20 73 61 6d 65 20 64 69 72 in the same dir 1e80: 65 63 74 6f 72 79 20 61 73 20 74 68 65 20 72 65 ectory as the re 1e90: 70 6f 73 69 74 6f 72 79 2c 20 74 68 65 6e 20 64 pository, then d 1ea0: 72 6f 70 73 0a 20 20 20 20 72 6f 6f 74 20 70 72 rops. root pr 1eb0: 69 76 69 6c 65 67 65 73 20 70 72 69 6f 72 20 74 ivileges prior t 1ec0: 6f 20 72 65 61 64 69 6e 67 20 61 6e 79 20 69 6e o reading any in 1ed0: 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 74 formation from t 1ee0: 68 65 20 72 65 71 75 65 73 74 2e 3c 2f 70 3e 0a he request.</p>. 1ef0: 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 .</blockquote><h 1f00: 32 3e 4d 6f 72 65 20 48 69 6e 74 73 3c 2f 68 32 2>More Hints</h2 1f10: 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 ><blockquote>.. 1f20: 20 20 20 3c 70 3e 54 72 79 20 74 68 65 73 65 20 <p>Try these 1f30: 63 6f 6d 6d 61 6e 64 73 3a 3c 2f 70 3e 0a 0a 20 commands:</p>.. 1f40: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c <blockquote>< 1f50: 62 3e 0a 20 20 20 20 66 6f 73 73 69 6c 20 68 65 b>. fossil he 1f60: 6c 70 3c 62 72 3e 0a 20 20 20 20 66 6f 73 73 69 lp<br>. fossi 1f70: 6c 20 74 65 73 74 2d 63 6f 6d 6d 61 6e 64 73 0a l test-commands. 1f80: 20 20 20 20 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 </b></blockq 1f90: 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 45 78 uote>.. <p>Ex 1fa0: 70 6c 6f 72 65 20 61 6e 64 20 68 61 76 65 20 66 plore and have f 1fb0: 75 6e 21 3c 2f 70 3e 0a 0a 0a 3c 2f 62 6c 6f 63 un!</p>...</bloc 1fc0: 6b 71 75 6f 74 65 3e 3c 2f 62 6f 64 79 3e 3c 2f kquote></body></ 1fd0: 68 74 6d 6c 3e 0a html>.