Artifact 02bea354bebce26c6d9d7fd5d07df08d1342a4e0:
File www/quickstart.html part of check-in [0cd202a86e] - Website updates. Change the message for unrecognized commands to refer the user to "help". by drh on 2007-08-23 23:10:56. Also file www/quickstart.html part of check-in [424d47e453] - Attempting the same merge that aku tried and got empty files with. by drh on 2007-08-25 18:58:16.
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 68 31 20 61 6c 69 67 6e 3d 22 63 65 6e >.<h1 align="cen 0050: 74 65 72 22 3e 46 6f 73 73 69 6c 20 51 75 69 63 ter">Fossil Quic 0060: 6b 20 53 74 61 72 74 3c 2f 68 31 3e 0a 0a 3c 70 k Start</h1>..<p 0070: 3e 54 68 69 73 20 69 73 20 61 20 67 75 69 64 65 >This is a guide 0080: 20 74 6f 20 67 65 74 20 79 6f 75 20 73 74 61 72 to get you star 0090: 74 65 64 20 75 73 69 6e 67 20 66 6f 73 73 69 6c ted using fossil 00a0: 20 71 75 69 63 6b 6c 79 0a 61 6e 64 20 70 61 69 quickly.and pai 00b0: 6e 6c 65 73 73 6c 79 2e 3c 2f 70 3e 0a 0a 3c 68 nlessly.</p>..<h 00c0: 32 3e 49 6e 73 74 61 6c 6c 69 6e 67 3c 2f 68 32 2>Installing</h2 00d0: 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 ><blockquote>.. 00e0: 20 20 20 3c 70 3e 46 6f 73 73 69 6c 20 69 73 20 <p>Fossil is 00f0: 61 20 73 69 6e 67 6c 65 20 73 65 6c 66 2d 63 6f a single self-co 0100: 6e 74 61 69 6e 65 64 20 43 20 70 72 6f 67 72 61 ntained C progra 0110: 6d 20 74 68 61 74 20 79 6f 75 20 6e 65 65 64 20 m that you need 0120: 74 6f 0a 20 20 20 20 3c 61 20 68 72 65 66 3d 22 to. <a href=" 0130: 62 75 69 6c 64 2e 68 74 6d 6c 22 3e 69 6e 73 74 build.html">inst 0140: 61 6c 6c 3c 2f 61 3e 20 62 65 66 6f 72 65 20 75 all</a> before u 0150: 73 69 6e 67 2e 20 20 42 75 69 6c 64 20 74 68 65 sing. Build the 0160: 20 62 69 6e 61 72 79 0a 20 20 20 20 61 6e 64 20 binary. and 0170: 70 75 74 20 69 74 20 73 6f 6d 65 70 6c 61 63 65 put it someplace 0180: 20 6f 6e 20 79 6f 75 72 20 50 41 54 48 20 65 6e on your PATH en 0190: 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 vironment variab 01a0: 6c 65 2e 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 20 le.</p>. . 01b0: 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 </blockquote>. 01c0: 20 20 20 3c 68 32 3e 43 6c 6f 6e 69 6e 67 20 41 <h2>Cloning A 01d0: 20 45 78 69 73 74 69 6e 67 20 52 65 70 6f 73 69 Existing Reposi 01e0: 74 6f 72 79 3c 2f 68 32 3e 0a 20 20 20 20 3c 62 tory</h2>. <b 01f0: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 0a lockquote>. . 0200: 20 20 20 20 3c 70 3e 55 73 65 20 74 68 69 73 20 <p>Use this 0210: 63 6f 6d 6d 61 6e 64 3a 3c 2f 70 3e 0a 20 20 20 command:</p>. 0220: 20 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 . <blockquot 0230: 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c e>. <b>fossil 0240: 20 63 6c 6f 6e 65 3c 2f 62 3e 20 3c 69 3e 55 52 clone</b> <i>UR 0250: 4c 20 20 72 65 70 6f 73 69 74 6f 72 79 2d 66 69 L repository-fi 0260: 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c lename</i>. < 0270: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 /blockquote>. 0280: 20 0a 20 20 20 20 3c 70 3e 54 68 65 20 3c 69 3e . <p>The <i> 0290: 55 52 4c 3c 2f 69 3e 20 61 62 6f 76 65 20 69 73 URL</i> above is 02a0: 20 74 68 65 20 68 74 74 70 20 55 52 4c 20 66 6f the http URL fo 02b0: 72 20 74 68 65 20 66 6f 73 73 69 6c 20 72 65 70 r the fossil rep 02c0: 6f 73 69 74 6f 72 79 0a 20 20 20 20 79 6f 75 20 ository. you 02d0: 77 61 6e 74 20 74 6f 20 63 6c 6f 6e 65 2e 20 20 want to clone. 02e0: 59 6f 75 20 63 61 6e 20 63 61 6c 6c 20 74 68 65 You can call the 02f0: 20 6e 65 77 20 72 65 70 6f 73 69 74 6f 72 79 20 new repository 0300: 61 6e 79 74 68 69 6e 67 20 79 6f 75 0a 20 20 20 anything you. 0310: 20 77 61 6e 74 20 2d 20 74 68 65 72 65 20 61 72 want - there ar 0320: 65 20 6e 6f 20 6e 61 6d 69 6e 67 20 72 65 73 74 e no naming rest 0330: 72 69 63 74 69 6f 6e 73 2e 20 20 41 73 20 61 6e rictions. As an 0340: 20 65 78 61 6d 70 6c 65 2c 20 79 6f 75 20 63 61 example, you ca 0350: 6e 0a 20 20 20 20 63 6c 6f 6e 65 20 74 68 65 20 n. clone the 0360: 66 6f 73 73 69 6c 20 72 65 70 6f 73 69 74 6f 72 fossil repositor 0370: 79 20 74 68 69 73 20 77 61 79 3a 3c 2f 70 3e 0a y this way:</p>. 0380: 20 20 20 20 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 . <blockq 0390: 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 uote>. <b>fos 03a0: 73 69 6c 20 63 6c 6f 6e 65 20 68 74 74 70 3a 2f sil clone http:/ 03b0: 2f 66 6f 73 73 69 6c 2d 73 63 6d 2e 68 77 61 63 /fossil-scm.hwac 03c0: 69 2e 63 6f 6d 2f 66 6f 73 73 69 6c 20 6d 79 63 i.com/fossil myc 03d0: 6c 6f 6e 65 2e 66 73 6c 3c 2f 62 3e 0a 20 20 20 lone.fsl</b>. 03e0: 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 </blockquote>. 03f0: 20 20 20 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 .</blockquote 0400: 3e 3c 68 32 3e 53 74 61 72 74 69 6e 67 20 41 20 ><h2>Starting A 0410: 4e 65 77 20 50 72 6f 6a 65 63 74 3c 2f 68 32 3e New Project</h2> 0420: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 <blockquote>.. 0430: 20 20 3c 70 3e 54 6f 20 73 74 61 72 74 20 61 20 <p>To start a 0440: 6e 65 77 20 70 72 6f 6a 65 63 74 20 77 69 74 68 new project with 0450: 20 66 6f 73 73 69 6c 2c 20 63 72 65 61 74 65 20 fossil, create 0460: 61 20 6e 65 77 20 65 6d 70 74 79 20 72 65 70 6f a new empty repo 0470: 73 69 74 6f 72 79 0a 20 20 20 20 74 68 69 73 20 sitory. this 0480: 77 61 79 3a 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 way:</p>. . 0490: 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 <blockquote>. 04a0: 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6e 65 77 <b>fossil new 04b0: 20 3c 2f 62 3e 3c 69 3e 20 72 65 70 6f 73 69 74 </b><i> reposit 04c0: 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e ory-filename</i> 04d0: 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 . </blockquot 04e0: 65 3e 0a 20 20 20 20 0a 3c 2f 62 6c 6f 63 6b 71 e>. .</blockq 04f0: 75 6f 74 65 3e 3c 68 32 3e 43 6f 6e 66 69 67 75 uote><h2>Configu 0500: 72 69 6e 67 20 59 6f 75 72 20 4c 6f 63 61 6c 20 ring Your Local 0510: 52 65 70 6f 73 69 74 6f 72 79 3c 2f 68 32 3e 3c Repository</h2>< 0520: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 blockquote>. 0530: 0a 20 20 20 20 3c 70 3e 57 68 65 6e 20 79 6f 75 . <p>When you 0540: 20 63 72 65 61 74 65 20 61 20 6e 65 77 20 72 65 create a new re 0550: 70 6f 73 69 74 6f 72 79 2c 20 65 69 74 68 65 72 pository, either 0560: 20 62 79 20 63 6c 6f 6e 69 6e 67 20 61 6e 20 65 by cloning an e 0570: 78 69 73 74 69 6e 67 0a 20 20 20 20 70 72 6f 6a xisting. proj 0580: 65 63 74 20 6f 72 20 63 72 65 61 74 65 20 61 20 ect or create a 0590: 6e 65 77 20 70 72 6f 6a 65 63 74 20 6f 66 20 79 new project of y 05a0: 6f 75 72 20 6f 77 6e 2c 20 79 6f 75 20 75 73 75 our own, you usu 05b0: 61 6c 6c 79 20 77 61 6e 74 20 74 6f 20 64 6f 20 ally want to do 05c0: 73 6f 6d 65 0a 20 20 20 20 6c 6f 63 61 6c 20 63 some. local c 05d0: 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 20 20 54 onfiguration. T 05e0: 68 69 73 20 69 73 20 61 63 63 6f 6d 70 6c 69 73 his is accomplis 05f0: 68 65 64 20 75 73 69 6e 67 20 61 20 77 65 62 62 hed using a webb 0600: 72 6f 77 73 65 72 2e 20 20 46 69 72 73 74 0a 20 rowser. First. 0610: 20 20 20 73 74 61 72 74 20 61 20 66 6f 73 73 69 start a fossi 0620: 6c 20 77 65 62 73 65 72 76 65 72 20 6c 69 6b 65 l webserver like 0630: 20 74 68 69 73 3a 3c 2f 70 3e 0a 20 20 20 20 0a this:</p>. . 0640: 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e <blockquote> 0650: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 73 . <b>fossil s 0660: 65 72 76 65 72 20 3c 2f 62 3e 3c 69 3e 20 72 65 erver </b><i> re 0670: 70 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e 61 6d pository-filenam 0680: 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 e</i>. </bloc 0690: 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e kquote>.. <p> 06a0: 54 68 69 73 20 63 72 65 61 74 65 73 20 61 20 6d This creates a m 06b0: 69 6e 69 2d 77 65 62 73 65 72 76 65 72 20 6c 69 ini-webserver li 06c0: 73 74 65 6e 69 6e 67 20 6f 6e 20 70 6f 72 74 20 stening on port 06d0: 38 30 38 30 2e 20 20 59 6f 75 20 63 61 6e 0a 20 8080. You can. 06e0: 20 20 20 73 70 65 63 69 66 79 20 61 20 64 69 66 specify a dif 06f0: 66 65 72 65 6e 74 20 70 6f 72 74 20 75 73 69 6e ferent port usin 0700: 67 20 74 68 65 20 3c 62 3e 2d 70 6f 72 74 3c 2f g the <b>-port</ 0710: 62 3e 20 6f 70 74 69 6f 6e 20 6f 6e 20 74 68 65 b> option on the 0720: 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 2e 0a 20 command-line.. 0730: 20 20 20 41 66 74 65 72 20 74 68 65 20 73 65 72 After the ser 0740: 76 65 72 20 69 73 20 72 75 6e 6e 69 6e 67 2c 20 ver is running, 0750: 70 6f 69 6e 74 20 79 6f 75 72 20 77 65 62 62 72 point your webbr 0760: 6f 77 73 65 72 20 61 74 0a 20 20 20 20 68 74 74 owser at. htt 0770: 70 3a 2f 2f 6c 6f 63 61 6c 68 6f 73 74 3a 38 30 p://localhost:80 0780: 38 30 2f 20 61 6e 64 20 73 74 61 72 74 20 63 6f 80/ and start co 0790: 6e 66 69 67 75 72 69 6e 67 2e 3c 2f 70 3e 0a 20 nfiguring.</p>. 07a0: 20 20 20 0a 20 20 20 20 3c 70 3e 42 79 20 64 65 . <p>By de 07b0: 66 61 75 6c 74 2c 20 66 6f 73 73 69 6c 20 64 6f fault, fossil do 07c0: 65 73 20 6e 6f 74 20 72 65 71 75 69 72 65 20 61 es not require a 07d0: 20 6c 6f 67 69 6e 20 66 6f 72 20 48 54 54 50 20 login for HTTP 07e0: 63 6f 6e 6e 65 63 74 69 6f 6e 73 0a 20 20 20 20 connections. 07f0: 63 6f 6d 69 6e 67 20 69 6e 20 66 72 6f 6d 20 74 coming in from t 0800: 68 65 20 49 50 20 6c 6f 6f 70 62 61 63 6b 20 61 he IP loopback a 0810: 64 64 72 65 73 73 20 31 32 37 2e 30 2e 30 2e 31 ddress 127.0.0.1 0820: 2e 20 20 59 6f 75 20 63 61 6e 2c 20 61 6e 64 20 . You can, and 0830: 70 65 72 68 61 70 73 0a 20 20 20 20 73 68 6f 75 perhaps. shou 0840: 6c 64 2c 20 63 68 61 6e 67 65 20 74 68 69 73 20 ld, change this 0850: 61 66 74 65 72 20 79 6f 75 20 63 72 65 61 74 65 after you create 0860: 20 61 20 66 65 77 20 75 73 65 72 73 2e 3c 2f 70 a few users.</p 0870: 3e 0a 20 20 20 20 0a 20 20 20 20 3c 70 3e 57 68 >. . <p>Wh 0880: 65 6e 20 79 6f 75 20 61 72 65 20 66 69 6e 69 73 en you are finis 0890: 68 65 64 20 63 6f 6e 66 69 67 75 72 69 6e 67 2c hed configuring, 08a0: 20 6a 75 73 74 20 70 72 65 73 73 20 43 6f 6e 74 just press Cont 08b0: 72 6f 6c 2d 43 20 6f 72 20 75 73 65 0a 20 20 20 rol-C or use. 08c0: 20 74 68 65 20 3c 62 3e 6b 69 6c 6c 3c 2f 62 3e the <b>kill</b> 08d0: 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 73 68 75 74 command to shut 08e0: 20 64 6f 77 6e 20 74 68 65 20 6d 69 6e 69 2d 73 down the mini-s 08f0: 65 72 76 65 72 2e 3c 2f 70 3e 0a 0a 3c 2f 62 6c erver.</p>..</bl 0900: 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 43 68 65 ockquote><h2>Che 0910: 63 6b 69 6e 67 20 4f 75 74 20 41 20 4c 6f 63 61 cking Out A Loca 0920: 6c 20 54 72 65 65 3c 2f 68 32 3e 3c 62 6c 6f 63 l Tree</h2><bloc 0930: 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e kquote>.. <p> 0940: 54 6f 20 77 6f 72 6b 20 6f 6e 20 61 20 70 72 6f To work on a pro 0950: 6a 65 63 74 20 69 6e 20 66 6f 73 73 69 6c 2c 20 ject in fossil, 0960: 79 6f 75 20 6e 65 65 64 20 74 6f 20 63 68 65 63 you need to chec 0970: 6b 20 6f 75 74 20 61 20 6c 6f 63 61 6c 0a 20 20 k out a local. 0980: 20 20 63 6f 70 79 20 6f 66 20 74 68 65 20 73 6f copy of the so 0990: 75 72 63 65 20 74 72 65 65 2e 20 20 43 72 65 61 urce tree. Crea 09a0: 74 65 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 te the directory 09b0: 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 62 65 0a you want to be. 09c0: 20 20 20 20 74 68 65 20 72 6f 6f 74 20 6f 66 20 the root of 09d0: 79 6f 75 72 20 74 72 65 65 20 61 6e 64 20 63 64 your tree and cd 09e0: 20 69 6e 74 6f 20 74 68 61 74 20 64 69 72 65 63 into that direc 09f0: 74 6f 72 79 2e 20 20 54 68 65 6e 0a 20 20 20 20 tory. Then. 0a00: 74 6f 20 74 68 69 73 3a 3c 2f 70 3e 0a 20 20 20 to this:</p>. 0a10: 20 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 . <blockquot 0a20: 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c e>. <b>fossil 0a30: 20 6f 70 65 6e 20 3c 2f 62 3e 3c 69 3e 20 72 65 open </b><i> re 0a40: 70 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e 61 6d pository-filenam 0a50: 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 e</i>. </bloc 0a60: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 0a 20 20 20 kquote>. . 0a70: 20 3c 70 3e 54 68 69 73 20 6c 65 61 76 65 73 20 <p>This leaves 0a80: 79 6f 75 20 77 69 74 68 20 74 68 65 20 6f 72 69 you with the ori 0a90: 67 69 6e 61 6c 20 28 65 6d 70 74 79 29 20 76 65 ginal (empty) ve 0aa0: 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 74 72 65 rsion of the tre 0ab0: 65 0a 20 20 20 20 63 68 65 63 6b 65 64 20 6f 75 e. checked ou 0ac0: 74 2e 20 20 54 6f 20 67 65 74 20 74 6f 20 74 68 t. To get to th 0ad0: 65 20 6c 61 74 65 73 74 20 76 65 72 73 69 6f 6e e latest version 0ae0: 2c 20 61 6c 73 6f 20 64 6f 20 74 68 69 73 3a 3c , also do this:< 0af0: 2f 70 3e 0a 20 20 20 20 0a 20 20 20 20 3c 62 6c /p>. . <bl 0b00: 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 ockquote>. <b 0b10: 3e 66 6f 73 73 69 6c 20 75 70 64 61 74 65 3c 2f >fossil update</ 0b20: 62 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 b>. </blockqu 0b30: 6f 74 65 3e 0a 20 20 20 20 0a 20 20 20 20 3c 70 ote>. . <p 0b40: 3e 46 72 6f 6d 20 61 6e 79 77 68 65 72 65 20 75 >From anywhere u 0b50: 6e 64 65 72 6e 65 61 74 68 20 74 68 65 20 72 6f nderneath the ro 0b60: 6f 74 20 6f 66 20 79 6f 75 72 20 6c 6f 63 61 6c ot of your local 0b70: 20 74 72 65 65 2c 20 79 6f 75 0a 20 20 20 20 63 tree, you. c 0b80: 61 6e 20 74 79 70 65 20 63 6f 6d 6d 61 6e 64 73 an type commands 0b90: 20 6c 69 6b 65 20 74 68 65 20 66 6f 6c 6c 6f 77 like the follow 0ba0: 69 6e 67 20 74 6f 20 66 69 6e 64 20 6f 75 74 20 ing to find out 0bb0: 74 68 65 20 73 74 61 74 75 73 20 6f 66 0a 20 20 the status of. 0bc0: 20 20 79 6f 75 72 20 6c 6f 63 61 6c 20 74 72 65 your local tre 0bd0: 65 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f e:</p>.. <blo 0be0: 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e ckquote>. <b> 0bf0: 66 6f 73 73 69 6c 20 69 6e 66 6f 3c 2f 62 3e 3c fossil info</b>< 0c00: 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 br>. <b>fossi 0c10: 6c 20 73 74 61 74 75 73 3c 2f 62 3e 3c 62 72 3e l status</b><br> 0c20: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 63 . <b>fossil c 0c30: 68 61 6e 67 65 73 3c 2f 62 3e 3c 62 72 3e 0a 20 hanges</b><br>. 0c40: 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 74 69 6d <b>fossil tim 0c50: 65 6c 69 6e 65 3c 2f 62 3e 3c 62 72 3e 0a 20 20 eline</b><br>. 0c60: 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6c 65 61 76 <b>fossil leav 0c70: 65 73 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 20 3c es</b><br>. < 0c80: 62 3e 66 6f 73 73 69 6c 20 6c 73 3c 2f 62 3e 3c b>fossil ls</b>< 0c90: 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 br>. <b>fossi 0ca0: 6c 20 62 72 61 6e 63 68 65 73 3c 2f 62 3e 3c 62 l branches</b><b 0cb0: 72 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 r>. </blockqu 0cc0: 6f 74 65 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f ote>..</blockquo 0cd0: 74 65 3e 3c 68 32 3e 4d 61 6b 69 6e 67 20 43 68 te><h2>Making Ch 0ce0: 61 6e 67 65 73 3c 2f 68 32 3e 3c 62 6c 6f 63 6b anges</h2><block 0cf0: 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 quote>.. <p>T 0d00: 6f 20 61 64 64 20 6e 65 77 20 66 69 6c 65 73 20 o add new files 0d10: 74 6f 20 79 6f 75 72 20 70 72 6f 6a 65 63 74 2c to your project, 0d20: 20 6f 72 20 72 65 6d 6f 76 65 20 6f 6c 64 20 66 or remove old f 0d30: 69 6c 65 73 2c 20 75 73 65 20 74 68 65 73 65 0a iles, use these. 0d40: 20 20 20 20 63 6f 6d 6d 61 6e 64 73 3a 3c 2f 70 commands:</p 0d50: 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f >.. <blockquo 0d60: 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 te>. <b>fossi 0d70: 6c 20 61 64 64 3c 2f 62 3e 20 3c 69 3e 66 69 6c l add</b> <i>fil 0d80: 65 2e 2e 2e 3c 2f 69 3e 3c 62 72 3e 0a 20 20 20 e...</i><br>. 0d90: 20 3c 62 3e 66 6f 73 73 69 6c 20 72 6d 3c 2f 62 <b>fossil rm</b 0da0: 3e 20 3c 69 3e 66 69 6c 65 2e 2e 2e 3c 2f 69 3e > <i>file...</i> 0db0: 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 . </blockquot 0dc0: 65 3e 0a 0a 20 20 20 20 3c 70 3e 59 6f 75 20 63 e>.. <p>You c 0dd0: 61 6e 20 61 6c 73 6f 20 65 64 69 74 20 66 69 6c an also edit fil 0de0: 65 73 20 66 72 65 65 6c 79 2e 20 20 4f 6e 63 65 es freely. Once 0df0: 20 79 6f 75 20 61 72 65 20 72 65 61 64 79 20 74 you are ready t 0e00: 6f 20 63 6f 6d 6d 69 74 0a 20 20 20 20 79 6f 75 o commit. you 0e10: 72 20 63 68 61 6e 67 65 73 2c 20 74 79 70 65 3a r changes, type: 0e20: 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b </p>.. <block 0e30: 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f quote>. <b>fo 0e40: 73 73 69 6c 20 63 6f 6d 6d 69 74 3c 2f 62 3e 0a ssil commit</b>. 0e50: 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 </blockquote 0e60: 3e 0a 0a 20 20 20 20 3c 70 3e 59 6f 75 20 77 69 >.. <p>You wi 0e70: 6c 6c 20 62 65 20 70 72 6f 6d 70 74 65 64 20 66 ll be prompted f 0e80: 6f 72 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d 6d or check-in comm 0e90: 65 6e 74 73 20 75 73 69 6e 67 20 77 68 61 74 65 ents using whate 0ea0: 76 65 72 20 65 64 69 74 6f 72 0a 20 20 20 20 69 ver editor. i 0eb0: 73 20 73 70 65 63 69 66 69 65 64 20 62 79 20 79 s specified by y 0ec0: 6f 75 72 20 56 49 53 55 41 4c 20 6f 72 20 45 44 our VISUAL or ED 0ed0: 49 54 4f 52 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 ITOR environment 0ee0: 20 76 61 72 69 61 62 6c 65 2e 20 20 49 66 20 79 variable. If y 0ef0: 6f 75 0a 20 20 20 20 68 61 76 65 20 47 50 47 20 ou. have GPG 0f00: 69 6e 73 74 61 6c 6c 65 64 2c 20 79 6f 75 20 6d installed, you m 0f10: 61 79 20 62 65 20 70 72 6f 6d 70 74 65 64 20 66 ay be prompted f 0f20: 6f 72 20 79 6f 75 72 20 47 50 47 20 70 61 73 73 or your GPG pass 0f30: 70 68 72 61 73 65 20 73 6f 0a 20 20 20 20 74 68 phrase so. th 0f40: 61 74 20 74 68 65 20 63 68 65 63 6b 2d 69 6e 20 at the check-in 0f50: 63 61 6e 20 62 65 20 73 69 67 6e 65 64 20 77 69 can be signed wi 0f60: 74 68 20 79 6f 75 72 20 47 50 47 20 73 69 67 6e th your GPG sign 0f70: 61 74 75 72 65 2e 20 20 41 66 74 65 72 0a 20 20 ature. After. 0f80: 20 20 74 68 69 73 20 79 6f 75 72 20 63 68 61 6e this your chan 0f90: 67 65 73 20 77 69 6c 6c 20 62 65 20 63 68 65 63 ges will be chec 0fa0: 6b 65 64 20 69 6e 2e 3c 2f 70 3e 0a 0a 3c 2f 62 ked in.</p>..</b 0fb0: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 53 68 lockquote><h2>Sh 0fc0: 61 72 69 6e 67 20 43 68 61 6e 67 65 73 3c 2f 68 aring Changes</h 0fd0: 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 2><blockquote>.. 0fe0: 20 20 20 20 3c 70 3e 54 68 65 20 63 68 61 6e 67 <p>The chang 0ff0: 65 73 20 79 6f 75 20 3c 62 3e 63 6f 6d 6d 69 74 es you <b>commit 1000: 3c 2f 62 3e 20 61 72 65 20 6f 6e 6c 79 20 6f 6e </b> are only on 1010: 20 79 6f 75 72 20 6c 6f 63 61 6c 20 72 65 70 6f your local repo 1020: 73 69 74 6f 72 79 2e 0a 20 20 20 20 54 6f 20 73 sitory.. To s 1030: 68 61 72 65 20 74 68 6f 73 65 20 63 68 61 6e 67 hare those chang 1040: 65 73 20 77 69 74 68 20 6f 74 68 65 72 20 72 65 es with other re 1050: 70 6f 73 69 74 6f 72 69 65 73 2c 20 64 6f 3a 3c positories, do:< 1060: 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 /p>.. <blockq 1070: 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 uote>. <b>fos 1080: 73 69 6c 20 70 75 73 68 3c 2f 62 3e 20 3c 69 3e sil push</b> <i> 1090: 55 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c URL</i>. </bl 10a0: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c ockquote>.. < 10b0: 70 3e 57 68 65 72 65 20 3c 69 3e 55 52 4c 3c 2f p>Where <i>URL</ 10c0: 69 3e 20 69 73 20 74 68 65 20 68 74 74 70 3a 20 i> is the http: 10d0: 55 52 4c 20 6f 66 20 74 68 65 20 73 65 72 76 65 URL of the serve 10e0: 72 20 72 65 70 6f 73 69 74 6f 72 79 20 79 6f 75 r repository you 10f0: 0a 20 20 20 20 77 61 6e 74 20 74 6f 20 73 68 61 . want to sha 1100: 72 65 20 79 6f 75 72 20 63 68 61 6e 67 65 73 20 re your changes 1110: 77 69 74 68 2e 20 20 49 66 20 79 6f 75 20 6f 6d with. If you om 1120: 69 74 20 74 68 65 20 3c 69 3e 55 52 4c 3c 2f 69 it the <i>URL</i 1130: 3e 20 61 72 67 75 6d 65 6e 74 2c 0a 20 20 20 20 > argument,. 1140: 66 6f 73 73 69 6c 20 77 69 6c 6c 20 75 73 65 20 fossil will use 1150: 77 68 61 74 65 76 65 72 20 73 65 72 76 65 72 20 whatever server 1160: 79 6f 75 20 6d 6f 73 74 20 72 65 63 65 6e 74 6c you most recentl 1170: 79 20 73 79 6e 63 65 64 20 77 69 74 68 2e 3c 2f y synced with.</ 1180: 70 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 3c p>.. <p>The < 1190: 62 3e 70 75 73 68 3c 2f 62 3e 20 63 6f 6d 6d 61 b>push</b> comma 11a0: 6e 64 20 6f 6e 6c 79 20 73 65 6e 64 73 20 79 6f nd only sends yo 11b0: 75 72 20 63 68 61 6e 67 65 73 20 74 6f 20 6f 74 ur changes to ot 11c0: 68 65 72 73 2e 20 20 54 6f 0a 20 20 20 20 52 65 hers. To. Re 11d0: 63 65 69 76 65 20 63 68 61 6e 67 65 73 20 66 72 ceive changes fr 11e0: 6f 6d 20 6f 74 68 65 72 73 2c 20 75 73 65 20 3c om others, use < 11f0: 62 3e 70 75 6c 6c 3c 2f 62 3e 2e 20 20 4f 72 20 b>pull</b>. Or 1200: 67 6f 20 62 6f 74 68 20 77 61 79 73 20 61 74 0a go both ways at. 1210: 20 20 20 20 6f 6e 63 65 20 75 73 69 6e 67 20 3c once using < 1220: 62 3e 73 79 6e 63 3c 2f 62 3e 3a 3c 2f 70 3e 0a b>sync</b>:</p>. 1230: 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 . <blockquote 1240: 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 >. <b>fossil 1250: 70 75 6c 6c 3c 2f 62 3e 20 3c 69 3e 55 52 4c 3c pull</b> <i>URL< 1260: 2f 69 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 /i><br>. <b>f 1270: 6f 73 73 69 6c 20 73 79 6e 63 3c 2f 62 3e 20 3c ossil sync</b> < 1280: 69 3e 55 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c 2f i>URL</i>. </ 1290: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 blockquote>.. 12a0: 20 3c 70 3e 57 68 65 6e 20 79 6f 75 20 70 75 6c <p>When you pul 12b0: 6c 20 69 6e 20 63 68 61 6e 67 65 73 20 66 72 6f l in changes fro 12c0: 6d 20 6f 74 68 65 72 73 2c 20 74 68 65 79 20 67 m others, they g 12d0: 6f 20 69 6e 74 6f 20 79 6f 75 72 20 72 65 70 6f o into your repo 12e0: 73 69 74 6f 72 79 2c 0a 20 20 20 20 6e 6f 74 20 sitory,. not 12f0: 69 6e 74 6f 20 79 6f 75 72 20 63 68 65 63 6b 65 into your checke 1300: 64 2d 6f 75 74 20 6c 6f 63 61 6c 20 74 72 65 65 d-out local tree 1310: 2e 20 20 54 6f 20 67 65 74 20 74 68 65 20 63 68 . To get the ch 1320: 61 6e 67 65 73 20 69 6e 74 6f 20 79 6f 75 72 0a anges into your. 1330: 20 20 20 20 6c 6f 63 61 6c 20 74 72 65 65 2c 20 local tree, 1340: 75 73 65 20 3c 62 3e 75 70 64 61 74 65 3c 2f 62 use <b>update</b 1350: 3e 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f >:</p>.. <blo 1360: 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e ckquote>. <b> 1370: 66 6f 73 73 69 6c 20 75 70 64 61 74 65 3c 2f 62 fossil update</b 1380: 3e 20 3c 69 3e 55 55 49 44 3c 2f 69 3e 0a 20 20 > <i>UUID</i>. 1390: 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a </blockquote>. 13a0: 0a 20 20 20 20 3c 70 3e 54 68 65 20 3c 69 3e 55 . <p>The <i>U 13b0: 55 49 44 3c 2f 69 3e 20 69 73 20 73 6f 6d 65 20 UID</i> is some 13c0: 75 6e 69 71 75 65 20 61 62 62 72 65 76 69 61 74 unique abbreviat 13d0: 69 6f 6e 20 74 6f 20 74 68 65 20 34 30 2d 63 68 ion to the 40-ch 13e0: 61 72 61 63 74 65 72 0a 20 20 20 20 76 65 72 73 aracter. vers 13f0: 69 6f 6e 20 49 44 2e 20 20 49 66 20 79 6f 75 20 ion ID. If you 1400: 6f 6d 69 74 20 74 68 65 20 3c 69 3e 55 55 49 44 omit the <i>UUID 1410: 3c 2f 69 3e 20 66 6f 73 73 69 6c 20 6d 6f 76 65 </i> fossil move 1420: 73 20 79 6f 75 20 74 6f 20 74 68 65 0a 20 20 20 s you to the. 1430: 20 6c 65 61 66 20 76 65 72 73 69 6f 6e 20 6f 66 leaf version of 1440: 20 74 68 65 20 62 72 61 6e 63 68 20 79 6f 75 72 the branch your 1450: 20 61 72 65 20 63 75 72 72 65 6e 74 6c 79 20 6f are currently o 1460: 6e 2e 20 20 49 66 20 79 6f 75 72 20 62 72 61 6e n. If your bran 1470: 63 68 0a 20 20 20 20 68 61 73 20 6d 75 6c 74 69 ch. has multi 1480: 70 6c 65 20 6c 65 61 76 65 73 2c 20 79 6f 75 20 ple leaves, you 1490: 67 65 74 20 61 6e 20 65 72 72 6f 72 20 2d 20 79 get an error - y 14a0: 6f 75 27 6c 6c 20 68 61 76 65 20 74 6f 20 73 70 ou'll have to sp 14b0: 65 63 69 66 79 20 74 68 65 0a 20 20 20 20 6c 65 ecify the. le 14c0: 61 66 20 79 6f 75 20 77 61 6e 74 20 75 73 69 6e af you want usin 14d0: 67 20 61 20 3c 69 3e 55 55 49 44 3c 2f 69 3e 20 g a <i>UUID</i> 14e0: 61 72 67 75 6d 65 6e 74 2e 3c 2f 70 3e 0a 0a 3c argument.</p>..< 14f0: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e /blockquote><h2> 1500: 42 72 61 6e 63 68 69 6e 67 20 41 6e 64 20 4d 65 Branching And Me 1510: 72 67 69 6e 67 3c 2f 68 32 3e 3c 62 6c 6f 63 6b rging</h2><block 1520: 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 59 quote>.. <p>Y 1530: 6f 75 20 63 61 6e 20 63 72 65 61 74 65 20 62 72 ou can create br 1540: 61 6e 63 68 65 73 20 62 79 20 64 6f 69 6e 67 20 anches by doing 1550: 6d 75 6c 74 69 70 6c 65 20 63 6f 6d 6d 69 74 73 multiple commits 1560: 20 6f 66 66 20 6f 66 20 74 68 65 0a 20 20 20 20 off of the. 1570: 73 61 6d 65 20 62 61 73 65 20 76 65 72 73 69 6f same base versio 1580: 6e 2e 20 20 54 6f 20 6d 65 72 67 65 20 74 6f 20 n. To merge to 1590: 62 72 61 6e 63 68 65 73 20 62 61 63 6b 20 74 6f branches back to 15a0: 67 65 74 68 65 72 2c 20 66 69 72 73 74 0a 20 20 gether, first. 15b0: 20 20 3c 62 3e 75 70 64 61 74 65 3c 2f 62 3e 20 <b>update</b> 15c0: 74 6f 20 74 68 65 20 6c 65 61 66 20 6f 66 20 6f to the leaf of o 15d0: 6e 65 20 62 72 61 6e 63 68 2e 20 20 54 68 65 6e ne branch. Then 15e0: 20 64 6f 20 61 20 3c 62 3e 6d 65 72 67 65 3c 2f do a <b>merge</ 15f0: 62 3e 0a 20 20 20 20 6f 66 20 74 68 65 20 6c 65 b>. of the le 1600: 61 66 20 6f 66 20 74 68 65 20 6f 74 68 65 72 20 af of the other 1610: 62 72 61 6e 63 68 3a 3c 2f 70 3e 0a 0a 20 20 20 branch:</p>.. 1620: 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 <blockquote>. 1630: 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6d 65 72 67 <b>fossil merg 1640: 65 3c 2f 62 3e 20 3c 69 3e 55 55 49 44 3c 2f 69 e</b> <i>UUID</i 1650: 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f >. </blockquo 1660: 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 65 73 74 te>.. <p>Test 1670: 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 79 6f to make sure yo 1680: 75 72 20 6d 65 72 67 65 20 64 69 64 6e 27 74 20 ur merge didn't 1690: 6d 65 73 73 20 75 70 20 74 68 65 20 63 6f 64 65 mess up the code 16a0: 2c 20 74 68 65 6e 0a 20 20 20 20 3c 62 3e 63 6f , then. <b>co 16b0: 6d 6d 69 74 3c 2f 62 3e 20 61 6e 64 20 70 6f 73 mmit</b> and pos 16c0: 73 69 62 6c 79 20 61 6c 73 6f 20 3c 62 3e 70 75 sibly also <b>pu 16d0: 73 68 3c 2f 62 3e 20 79 6f 75 72 20 63 68 61 6e sh</b> your chan 16e0: 67 65 73 2e 20 20 20 52 65 6d 65 6d 62 65 72 0a ges. Remember. 16f0: 20 20 20 20 74 68 61 74 20 6e 6f 62 6f 64 79 20 that nobody 1700: 65 6c 73 65 20 63 61 6e 20 73 65 65 20 79 6f 75 else can see you 1710: 72 20 63 68 61 6e 67 65 73 20 75 6e 74 69 6c 20 r changes until 1720: 79 6f 75 20 3c 62 3e 63 6f 6d 6d 69 74 3c 2f 62 you <b>commit</b 1730: 3e 20 61 6e 64 0a 20 20 20 20 69 66 20 6f 74 68 > and. if oth 1740: 65 72 20 61 72 65 20 75 73 69 6e 67 20 61 20 64 er are using a d 1750: 69 66 66 65 72 65 6e 74 20 72 65 70 6f 73 69 74 ifferent reposit 1760: 6f 72 79 20 79 6f 75 20 77 69 6c 6c 20 61 6c 73 ory you will als 1770: 6f 20 6e 65 65 64 20 74 6f 0a 20 20 20 20 3c 62 o need to. <b 1780: 3e 70 75 73 68 3c 2f 62 3e 2e 3c 2f 70 3e 0a 0a >push</b>.</p>.. 1790: 3c 61 20 6e 61 6d 65 3d 22 73 65 72 76 65 72 73 <a name="servers 17a0: 65 74 75 70 22 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 etup">.</blockqu 17b0: 6f 74 65 3e 3c 68 32 3e 53 65 74 74 69 6e 67 20 ote><h2>Setting 17c0: 55 70 20 41 20 53 65 72 76 65 72 3c 2f 68 32 3e Up A Server</h2> 17d0: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 <blockquote>.. 17e0: 20 20 3c 70 3e 54 68 65 20 65 61 73 69 65 73 74 <p>The easiest 17f0: 20 77 61 79 20 74 6f 20 73 65 74 20 75 70 20 61 way to set up a 1800: 20 73 65 72 76 65 72 20 69 73 3a 3c 2f 70 3e 0a server is:</p>. 1810: 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 . <blockquote 1820: 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 >. <b>fossil 1830: 73 65 72 76 65 72 3c 2f 62 3e 20 3c 69 3e 72 65 server</b> <i>re 1840: 70 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e 61 6d pository-filenam 1850: 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 e</i>. </bloc 1860: 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e kquote>.. <p> 1870: 59 6f 75 20 63 61 6e 20 6f 6d 69 74 20 74 68 65 You can omit the 1880: 20 3c 69 3e 72 65 70 6f 73 69 74 6f 72 79 2d 66 <i>repository-f 1890: 69 6c 65 6e 61 6d 65 3c 2f 69 3e 20 69 66 20 79 ilename</i> if y 18a0: 6f 75 20 61 72 65 20 77 69 74 68 69 6e 0a 20 20 ou are within. 18b0: 20 20 61 20 63 68 65 63 6b 65 64 2d 6f 75 74 20 a checked-out 18c0: 6c 6f 63 61 6c 20 74 72 65 65 2e 20 20 54 68 69 local tree. Thi 18d0: 73 20 73 65 72 76 65 72 20 75 73 65 73 20 70 6f s server uses po 18e0: 72 74 20 38 30 38 30 20 62 79 20 64 65 66 61 75 rt 8080 by defau 18f0: 6c 74 0a 20 20 20 20 62 75 74 20 79 6f 75 20 63 lt. but you c 1900: 61 6e 20 73 70 65 63 69 66 79 20 61 20 64 69 66 an specify a dif 1910: 66 65 72 65 6e 74 20 70 6f 72 74 20 75 73 69 6e ferent port usin 1920: 67 20 74 68 65 20 3c 62 3e 2d 70 6f 72 74 3c 2f g the <b>-port</ 1930: 62 3e 20 63 6f 6d 6d 61 6e 64 2e 3c 2f 70 3e 0a b> command.</p>. 1940: 0a 20 20 20 20 3c 70 3e 43 6f 6d 6d 61 6e 64 2d . <p>Command- 1950: 6c 69 6e 65 20 73 65 72 76 65 72 73 20 6c 69 6b line servers lik 1960: 65 20 74 68 69 73 20 61 72 65 20 75 73 65 66 75 e this are usefu 1970: 6c 20 77 68 65 6e 20 74 77 6f 20 70 65 6f 70 6c l when two peopl 1980: 65 20 77 61 6e 74 0a 20 20 20 20 74 6f 20 73 68 e want. to sh 1990: 61 72 65 20 61 20 72 65 70 6f 73 69 74 6f 72 79 are a repository 19a0: 20 6f 6e 20 74 65 6d 70 6f 72 61 72 79 20 6f 72 on temporary or 19b0: 20 61 64 2d 68 6f 63 20 62 61 73 69 73 2e 20 20 ad-hoc basis. 19c0: 46 6f 72 20 61 20 6d 6f 72 65 0a 20 20 20 20 70 For a more. p 19d0: 65 72 6d 61 6e 65 6e 74 20 69 6e 73 74 61 6c 6c ermanent install 19e0: 61 74 69 6f 6e 2c 20 79 6f 75 20 73 68 6f 75 6c ation, you shoul 19f0: 64 20 75 73 65 20 65 69 74 68 65 72 20 74 68 65 d use either the 1a00: 20 43 47 49 20 73 65 72 76 65 72 20 6f 72 20 74 CGI server or t 1a10: 68 65 0a 20 20 20 20 69 6e 65 74 64 20 73 65 72 he. inetd ser 1a20: 76 65 72 2e 20 20 54 6f 20 75 73 65 20 74 68 65 ver. To use the 1a30: 20 43 47 49 20 73 65 72 76 65 72 2c 20 63 72 65 CGI server, cre 1a40: 61 74 65 20 61 20 43 47 49 20 73 63 72 69 70 74 ate a CGI script 1a50: 20 74 68 61 74 0a 20 20 20 20 6c 6f 6f 6b 73 20 that. looks 1a60: 73 6f 6d 65 74 68 69 6e 67 20 6c 69 6b 65 20 74 something like t 1a70: 68 69 73 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 his:</p>.. <b 1a80: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 62 3e 0a 20 20 lockquote><b>. 1a90: 20 20 23 21 2f 75 73 72 2f 6c 6f 63 61 6c 2f 62 #!/usr/local/b 1aa0: 69 6e 2f 66 6f 73 73 69 6c 3c 62 72 3e 0a 20 20 in/fossil<br>. 1ab0: 20 20 72 65 70 6f 73 69 74 6f 72 79 3a 20 2f 68 repository: /h 1ac0: 6f 6d 65 2f 70 72 6f 6a 31 2f 72 65 70 6f 73 31 ome/proj1/repos1 1ad0: 2e 66 73 6c 0a 20 20 20 20 3c 2f 62 3e 3c 2f 62 .fsl. </b></b 1ae0: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 lockquote>.. 1af0: 3c 70 3e 41 64 6a 75 73 74 20 74 68 65 20 70 61 <p>Adjust the pa 1b00: 74 68 73 20 69 6e 20 74 68 69 73 20 43 47 49 20 ths in this CGI 1b10: 73 63 72 69 70 74 20 74 6f 20 6d 61 74 63 68 20 script to match 1b20: 79 6f 75 72 20 69 6e 73 74 61 6c 6c 61 74 69 6f your installatio 1b30: 6e 2e 0a 20 20 20 20 4e 6f 77 20 70 6f 69 6e 74 n.. Now point 1b40: 20 63 6c 69 65 6e 74 73 20 61 74 20 74 68 65 20 clients at the 1b50: 43 47 49 20 73 63 72 69 70 74 2e 20 20 54 68 61 CGI script. Tha 1b60: 74 27 73 20 61 6c 6c 20 74 68 65 72 65 20 69 73 t's all there is 1b70: 20 74 6f 20 69 74 21 3c 2f 70 3e 0a 0a 20 20 20 to it!</p>.. 1b80: 20 3c 70 3e 59 6f 75 20 63 61 6e 20 61 6c 73 6f <p>You can also 1b90: 20 72 75 6e 20 66 6f 73 73 69 6c 20 6f 66 66 20 run fossil off 1ba0: 6f 66 20 69 6e 65 74 64 20 6f 72 20 78 69 6e 65 of inetd or xine 1bb0: 74 64 2e 20 20 46 6f 72 20 61 6e 20 69 6e 65 74 td. For an inet 1bc0: 64 0a 20 20 20 20 69 6e 73 74 61 6c 6c 61 74 69 d. installati 1bd0: 6f 6e 2c 20 6d 61 6b 65 20 61 6e 20 65 6e 74 72 on, make an entr 1be0: 79 20 69 6e 20 2f 65 74 63 2f 69 6e 65 74 64 2e y in /etc/inetd. 1bf0: 63 6f 6e 66 20 74 68 61 74 20 6c 6f 6f 6b 73 20 conf that looks 1c00: 73 6f 6d 65 74 68 69 6e 67 0a 20 20 20 20 6c 69 something. li 1c10: 6b 65 20 74 68 69 73 3a 3c 2f 70 3e 0a 0a 20 20 ke this:</p>.. 1c20: 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 62 <blockquote><b 1c30: 3e 0a 20 20 20 20 38 30 20 73 74 72 65 61 6d 20 >. 80 stream 1c40: 74 63 70 20 6e 6f 77 61 69 74 2e 31 30 30 30 20 tcp nowait.1000 1c50: 72 6f 6f 74 20 2f 75 73 72 2f 62 69 6e 2f 66 6f root /usr/bin/fo 1c60: 73 73 69 6c 20 5c 3c 62 72 3e 0a 20 20 20 20 20 ssil \<br>. 1c70: 20 20 20 2f 75 73 72 2f 62 69 6e 2f 66 6f 73 73 /usr/bin/foss 1c80: 69 6c 20 68 74 74 70 20 2f 68 6f 6d 65 2f 70 72 il http /home/pr 1c90: 6f 6a 31 2f 72 65 70 6f 73 31 2e 66 73 6c 0a 20 oj1/repos1.fsl. 1ca0: 20 20 20 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 75 </b></blockqu 1cb0: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 41 64 6a ote>.. <p>Adj 1cc0: 75 73 74 20 74 68 65 20 70 61 74 68 73 20 74 6f ust the paths to 1cd0: 20 73 75 69 74 20 79 6f 75 72 20 69 6e 73 74 61 suit your insta 1ce0: 6c 6c 61 74 69 6f 6e 2c 20 6f 66 20 63 6f 75 72 llation, of cour 1cf0: 73 65 2e 20 20 4e 6f 74 69 63 65 20 74 68 61 74 se. Notice that 1d00: 0a 20 20 20 20 66 6f 73 73 69 6c 20 72 75 6e 73 . fossil runs 1d10: 20 61 73 20 72 6f 6f 74 2e 20 20 54 68 69 73 20 as root. This 1d20: 69 73 20 6e 6f 74 20 72 65 71 75 69 72 65 64 20 is not required 1d30: 2d 20 79 6f 75 20 63 61 6e 20 72 75 6e 20 69 74 - you can run it 1d40: 20 61 73 20 61 6e 0a 20 20 20 20 75 6e 70 72 69 as an. unpri 1d50: 76 69 6c 65 67 65 64 20 75 73 65 72 2e 20 20 42 vileged user. B 1d60: 75 74 20 69 74 20 69 73 20 6d 6f 72 65 20 73 65 ut it is more se 1d70: 63 75 72 65 20 74 6f 20 72 75 6e 20 66 6f 73 73 cure to run foss 1d80: 69 6c 20 61 73 20 72 6f 6f 74 2e 0a 20 20 20 20 il as root.. 1d90: 57 68 65 6e 20 79 6f 75 20 64 6f 20 72 75 6e 20 When you do run 1da0: 66 6f 73 73 69 6c 20 61 73 20 72 6f 6f 74 2c 20 fossil as root, 1db0: 69 74 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 it automatically 1dc0: 20 70 75 74 73 20 69 74 73 65 6c 66 20 69 6e 20 puts itself in 1dd0: 61 0a 20 20 20 20 63 68 72 6f 6f 74 20 6a 61 69 a. chroot jai 1de0: 6c 20 69 6e 20 74 68 65 20 73 61 6d 65 20 64 69 l in the same di 1df0: 72 65 63 74 6f 72 79 20 61 73 20 74 68 65 20 72 rectory as the r 1e00: 65 70 6f 73 69 74 6f 72 79 2c 20 74 68 65 6e 20 epository, then 1e10: 64 72 6f 70 73 0a 20 20 20 20 72 6f 6f 74 20 70 drops. root p 1e20: 72 69 76 69 6c 65 67 65 73 20 70 72 69 6f 72 20 rivileges prior 1e30: 74 6f 20 72 65 61 64 69 6e 67 20 61 6e 79 20 69 to reading any i 1e40: 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 nformation from 1e50: 74 68 65 20 72 65 71 75 65 73 74 2e 3c 2f 70 3e the request.</p> 1e60: 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c ..</blockquote>< 1e70: 68 32 3e 4d 6f 72 65 20 48 69 6e 74 73 3c 2f 68 h2>More Hints</h 1e80: 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 2><blockquote>.. 1e90: 20 20 20 20 3c 70 3e 54 72 79 20 74 68 65 73 65 <p>Try these 1ea0: 20 63 6f 6d 6d 61 6e 64 73 3a 3c 2f 70 3e 0a 0a commands:</p>.. 1eb0: 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e <blockquote> 1ec0: 3c 62 3e 0a 20 20 20 20 66 6f 73 73 69 6c 20 68 <b>. fossil h 1ed0: 65 6c 70 3c 62 72 3e 0a 20 20 20 20 66 6f 73 73 elp<br>. foss 1ee0: 69 6c 20 63 6f 6d 6d 61 6e 64 73 3c 62 72 3e 0a il commands<br>. 1ef0: 20 20 20 20 66 6f 73 73 69 6c 20 74 65 73 74 2d fossil test- 1f00: 63 6f 6d 6d 61 6e 64 73 0a 20 20 20 20 3c 2f 62 commands. </b 1f10: 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a ></blockquote>.. 1f20: 20 20 20 20 3c 70 3e 45 78 70 6c 6f 72 65 20 61 <p>Explore a 1f30: 6e 64 20 68 61 76 65 20 66 75 6e 21 3c 2f 70 3e nd have fun!</p> 1f40: 0a 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e ...</blockquote> 1f50: 3c 2f 62 6f 64 79 3e 3c 2f 68 74 6d 6c 3e 0a </body></html>.