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