0000: 3c 74 69 74 6c 65 3e 46 6f 73 73 69 6c 20 51 75 <title>Fossil Qu
0010: 69 63 6b 20 53 74 61 72 74 20 47 75 69 64 65 3c ick Start Guide<
0020: 2f 74 69 74 6c 65 3e 0a 3c 6e 6f 77 69 6b 69 3e /title>.<nowiki>
0030: 0a 3c 68 31 20 61 6c 69 67 6e 3d 22 63 65 6e 74 .<h1 align="cent
0040: 65 72 22 3e 46 6f 73 73 69 6c 20 51 75 69 63 6b er">Fossil Quick
0050: 20 53 74 61 72 74 3c 2f 68 31 3e 0a 0a 3c 70 3e Start</h1>..<p>
0060: 54 68 69 73 20 69 73 20 61 20 67 75 69 64 65 20 This is a guide
0070: 74 6f 20 67 65 74 20 79 6f 75 20 73 74 61 72 74 to get you start
0080: 65 64 20 75 73 69 6e 67 20 66 6f 73 73 69 6c 20 ed using fossil
0090: 71 75 69 63 6b 6c 79 0a 61 6e 64 20 70 61 69 6e quickly.and pain
00a0: 6c 65 73 73 6c 79 2e 3c 2f 70 3e 0a 0a 3c 68 32 lessly.</p>..<h2
00b0: 3e 49 6e 73 74 61 6c 6c 69 6e 67 3c 2f 68 32 3e >Installing</h2>
00c0: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 <blockquote>..
00d0: 20 20 3c 70 3e 46 6f 73 73 69 6c 20 69 73 20 61 <p>Fossil is a
00e0: 20 73 69 6e 67 6c 65 20 73 65 6c 66 2d 63 6f 6e single self-con
00f0: 74 61 69 6e 65 64 20 43 20 70 72 6f 67 72 61 6d tained C program
0100: 2e 20 20 59 6f 75 20 6e 65 65 64 20 74 6f 0a 20 . You need to.
0110: 20 20 20 65 69 74 68 65 72 20 64 6f 77 6e 6c 6f either downlo
0120: 61 64 20 61 20 0a 20 20 20 20 3c 61 20 68 72 65 ad a . <a hre
0130: 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e 66 6f f="http://www.fo
0140: 73 73 69 6c 2d 73 63 6d 2e 6f 72 67 2f 64 6f 77 ssil-scm.org/dow
0150: 6e 6c 6f 61 64 2e 68 74 6d 6c 22 3e 70 72 65 63 nload.html">prec
0160: 6f 6d 70 69 6c 65 64 20 62 69 6e 61 72 79 3c 2f ompiled binary</
0170: 61 3e 0a 20 20 20 20 6f 72 20 3c 61 20 68 72 65 a>. or <a hre
0180: 66 3d 22 62 75 69 6c 64 2e 77 69 6b 69 22 3e 62 f="build.wiki">b
0190: 75 69 6c 64 20 69 74 20 79 6f 75 72 73 65 6c 66 uild it yourself
01a0: 3c 2f 61 3e 20 66 72 6f 6d 20 73 6f 75 72 63 65 </a> from source
01b0: 73 2e 0a 20 20 20 20 49 6e 73 74 61 6c 6c 20 66 s.. Install f
01c0: 6f 73 73 69 6c 20 62 79 20 70 75 74 74 69 6e 67 ossil by putting
01d0: 20 74 68 65 20 66 6f 73 73 69 6c 20 62 69 6e 61 the fossil bina
01e0: 72 79 0a 20 20 20 20 73 6f 6d 65 70 6c 61 63 65 ry. someplace
01f0: 20 6f 6e 20 79 6f 75 72 20 50 41 54 48 20 65 6e on your PATH en
0200: 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 vironment variab
0210: 6c 65 2e 3c 2f 70 3e 0a 20 20 20 20 0a 3c 2f 62 le.</p>. .</b
0220: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 61 20 6e 61 lockquote>.<a na
0230: 6d 65 3d 22 66 73 6c 63 6c 6f 6e 65 22 3e 3c 2f me="fslclone"></
0240: 61 3e 0a 3c 68 32 3e 43 6c 6f 6e 69 6e 67 20 41 a>.<h2>Cloning A
0250: 6e 20 45 78 69 73 74 69 6e 67 20 52 65 70 6f 73 n Existing Repos
0260: 69 74 6f 72 79 3c 2f 68 32 3e 3c 62 6c 6f 63 6b itory</h2><block
0270: 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 4d quote>.. <p>M
0280: 6f 73 74 20 66 6f 73 73 69 6c 20 6f 70 65 72 61 ost fossil opera
0290: 74 69 6f 6e 73 20 69 6e 74 65 72 61 63 74 20 77 tions interact w
02a0: 69 74 68 20 61 20 72 65 70 6f 73 69 74 6f 72 79 ith a repository
02b0: 20 74 68 61 74 20 69 73 20 6f 6e 20 74 68 65 0a that is on the.
02c0: 20 20 20 20 6c 6f 63 61 6c 20 64 69 73 6b 20 64 local disk d
02d0: 72 69 76 65 2c 20 6e 6f 74 20 6f 6e 20 61 20 72 rive, not on a r
02e0: 65 6d 6f 74 65 20 73 79 73 74 65 6d 2e 20 20 48 emote system. H
02f0: 65 6e 63 65 2c 20 62 65 66 6f 72 65 20 61 63 63 ence, before acc
0300: 65 73 73 69 6e 67 0a 20 20 20 20 61 20 72 65 6d essing. a rem
0310: 6f 74 65 20 72 65 70 6f 73 69 74 6f 72 79 20 69 ote repository i
0320: 74 20 69 73 20 6e 65 63 65 73 73 61 72 79 20 74 t is necessary t
0330: 6f 20 6d 61 6b 65 20 61 20 6c 6f 63 61 6c 20 63 o make a local c
0340: 6f 70 79 20 6f 66 20 74 68 61 74 0a 20 20 20 20 opy of that.
0350: 72 65 70 6f 73 69 74 6f 72 79 2e 20 20 4d 61 6b repository. Mak
0360: 69 6e 67 20 61 20 6c 6f 63 61 6c 20 63 6f 70 79 ing a local copy
0370: 20 6f 66 20 61 20 72 65 6d 6f 74 65 20 72 65 70 of a remote rep
0380: 6f 73 69 74 6f 72 79 20 69 73 20 63 61 6c 6c 65 ository is calle
0390: 64 0a 20 20 20 20 22 63 6c 6f 6e 69 6e 67 22 2e d. "cloning".
03a0: 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 20 20 3c 70 </p>. . <p
03b0: 3e 43 6c 6f 6e 65 20 61 20 72 65 6d 6f 74 65 20 >Clone a remote
03c0: 72 65 70 6f 73 69 74 6f 72 79 20 61 73 20 66 6f repository as fo
03d0: 6c 6c 6f 77 73 3a 3c 2f 70 3e 0a 20 20 20 20 0a llows:</p>. .
03e0: 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e <blockquote>
03f0: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 63 . <b>fossil c
0400: 6c 6f 6e 65 3c 2f 62 3e 20 3c 69 3e 55 52 4c 20 lone</b> <i>URL
0410: 20 72 65 70 6f 73 69 74 6f 72 79 2d 66 69 6c 65 repository-file
0420: 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 name</i>. </b
0430: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 0a lockquote>. .
0440: 20 20 20 20 3c 70 3e 54 68 65 20 3c 69 3e 55 52 <p>The <i>UR
0450: 4c 3c 2f 69 3e 20 61 62 6f 76 65 20 69 73 20 74 L</i> above is t
0460: 68 65 20 68 74 74 70 20 55 52 4c 20 66 6f 72 20 he http URL for
0470: 74 68 65 20 66 6f 73 73 69 6c 20 72 65 70 6f 73 the fossil repos
0480: 69 74 6f 72 79 0a 20 20 20 20 79 6f 75 20 77 61 itory. you wa
0490: 6e 74 20 74 6f 20 63 6c 6f 6e 65 2c 20 61 6e 64 nt to clone, and
04a0: 20 69 74 20 6d 61 79 20 69 6e 63 6c 75 64 65 20 it may include
04b0: 61 20 22 75 73 65 72 3a 70 61 73 73 77 6f 72 64 a "user:password
04c0: 22 20 70 61 72 74 2c 20 65 2e 67 2e 0a 20 20 20 " part, e.g..
04d0: 20 3c 74 74 3e 68 74 74 70 3a 2f 2f 64 72 68 3a <tt>http://drh:
04e0: 73 65 63 72 65 74 40 77 77 77 2e 66 6f 73 73 69 secret@www.fossi
04f0: 6c 2d 73 63 6d 2e 6f 72 67 2f 66 6f 73 73 69 6c l-scm.org/fossil
0500: 3c 2f 74 74 3e 2e 20 59 6f 75 20 63 61 6e 0a 20 </tt>. You can.
0510: 20 20 20 63 61 6c 6c 20 74 68 65 20 6e 65 77 20 call the new
0520: 72 65 70 6f 73 69 74 6f 72 79 20 61 6e 79 74 68 repository anyth
0530: 69 6e 67 20 79 6f 75 20 77 61 6e 74 20 2d 20 74 ing you want - t
0540: 68 65 72 65 20 61 72 65 20 6e 6f 20 6e 61 6d 69 here are no nami
0550: 6e 67 0a 20 20 20 20 72 65 73 74 72 69 63 74 69 ng. restricti
0560: 6f 6e 73 2e 20 20 41 73 20 61 6e 20 65 78 61 6d ons. As an exam
0570: 70 6c 65 2c 20 79 6f 75 20 63 61 6e 20 63 6c 6f ple, you can clo
0580: 6e 65 20 74 68 65 20 66 6f 73 73 69 6c 20 72 65 ne the fossil re
0590: 70 6f 73 69 74 6f 72 79 0a 20 20 20 20 74 68 69 pository. thi
05a0: 73 20 77 61 79 3a 3c 2f 70 3e 0a 20 20 20 20 0a s way:</p>. .
05b0: 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e <blockquote>
05c0: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 63 . <b>fossil c
05d0: 6c 6f 6e 65 20 68 74 74 70 3a 2f 2f 77 77 77 2e lone http://www.
05e0: 66 6f 73 73 69 6c 2d 73 63 6d 2e 6f 72 67 2f 20 fossil-scm.org/
05f0: 6d 79 63 6c 6f 6e 65 2e 66 6f 73 73 69 6c 3c 2f myclone.fossil</
0600: 62 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 b>. </blockqu
0610: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 ote>.. <p>The
0620: 20 6e 65 77 20 6c 6f 63 61 6c 20 63 6f 70 79 20 new local copy
0630: 6f 66 20 74 68 65 20 72 65 73 70 6f 73 69 74 6f of the resposito
0640: 72 79 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 ry is stored in
0650: 61 20 73 69 6e 67 6c 65 20 66 69 6c 65 2c 0a 20 a single file,.
0660: 20 20 20 77 68 69 63 68 20 69 6e 20 74 68 65 20 which in the
0670: 65 78 61 6d 70 6c 65 20 61 62 6f 76 65 20 69 73 example above is
0680: 20 6e 61 6d 65 64 20 22 6d 79 63 6c 6f 6e 65 2e named "myclone.
0690: 66 6f 73 73 69 6c 22 2e 0a 20 20 20 20 59 6f 75 fossil".. You
06a0: 20 63 61 6e 20 6e 61 6d 65 20 79 6f 75 72 20 72 can name your r
06b0: 65 70 6f 73 69 74 6f 72 69 65 73 20 61 6e 79 74 epositories anyt
06c0: 68 69 6e 67 20 79 6f 75 20 77 61 6e 74 2e 20 20 hing you want.
06d0: 54 68 65 20 22 2e 66 6f 73 73 69 6c 22 20 73 75 The ".fossil" su
06e0: 66 66 69 78 0a 20 20 20 20 69 73 20 6e 6f 74 20 ffix. is not
06f0: 72 65 71 75 69 72 65 64 2e 3c 2f 70 3e 0a 0a 20 required.</p>..
0700: 20 20 20 3c 70 3e 4e 6f 74 65 3a 20 49 66 20 79 <p>Note: If y
0710: 6f 75 20 61 72 65 20 62 65 68 69 6e 64 20 61 20 ou are behind a
0720: 72 65 73 74 72 69 63 74 69 76 65 20 66 69 72 65 restrictive fire
0730: 77 61 6c 6c 2c 20 79 6f 75 20 6d 69 67 68 74 20 wall, you might
0740: 6e 65 65 64 0a 20 20 20 20 74 6f 20 3c 61 20 68 need. to <a h
0750: 72 65 66 3d 22 23 70 72 6f 78 79 22 3e 73 70 65 ref="#proxy">spe
0760: 63 69 66 79 20 61 6e 20 48 54 54 50 20 70 72 6f cify an HTTP pro
0770: 78 79 3c 2f 61 3e 20 74 6f 20 75 73 65 2e 3c 2f xy</a> to use.</
0780: 70 3e 0a 20 20 20 20 0a 3c 2f 62 6c 6f 63 6b 71 p>. .</blockq
0790: 75 6f 74 65 3e 3c 68 32 3e 53 74 61 72 74 69 6e uote><h2>Startin
07a0: 67 20 41 20 4e 65 77 20 50 72 6f 6a 65 63 74 3c g A New Project<
07b0: 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e /h2><blockquote>
07c0: 0a 0a 20 20 20 20 3c 70 3e 54 6f 20 73 74 61 72 .. <p>To star
07d0: 74 20 61 20 6e 65 77 20 70 72 6f 6a 65 63 74 20 t a new project
07e0: 77 69 74 68 20 66 6f 73 73 69 6c 2c 20 63 72 65 with fossil, cre
07f0: 61 74 65 20 61 20 6e 65 77 20 65 6d 70 74 79 20 ate a new empty
0800: 72 65 70 6f 73 69 74 6f 72 79 0a 20 20 20 20 74 repository. t
0810: 68 69 73 20 77 61 79 3a 3c 2f 70 3e 0a 20 20 20 his way:</p>.
0820: 20 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 . <blockquot
0830: 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c e>. <b>fossil
0840: 20 6e 65 77 20 3c 2f 62 3e 3c 69 3e 20 72 65 70 new </b><i> rep
0850: 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 ository-filename
0860: 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b </i>. </block
0870: 71 75 6f 74 65 3e 0a 20 20 20 20 0a 3c 2f 62 6c quote>. .</bl
0880: 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 43 6f 6e ockquote><h2>Con
0890: 66 69 67 75 72 69 6e 67 20 59 6f 75 72 20 4c 6f figuring Your Lo
08a0: 63 61 6c 20 52 65 70 6f 73 69 74 6f 72 79 3c 2f cal Repository</
08b0: 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a h2><blockquote>.
08c0: 20 20 20 20 0a 20 20 20 20 3c 70 3e 57 68 65 6e . <p>When
08d0: 20 79 6f 75 20 63 72 65 61 74 65 20 61 20 6e 65 you create a ne
08e0: 77 20 72 65 70 6f 73 69 74 6f 72 79 2c 20 65 69 w repository, ei
08f0: 74 68 65 72 20 62 79 20 63 6c 6f 6e 69 6e 67 20 ther by cloning
0900: 61 6e 20 65 78 69 73 74 69 6e 67 0a 20 20 20 20 an existing.
0910: 70 72 6f 6a 65 63 74 20 6f 72 20 63 72 65 61 74 project or creat
0920: 65 20 61 20 6e 65 77 20 70 72 6f 6a 65 63 74 20 e a new project
0930: 6f 66 20 79 6f 75 72 20 6f 77 6e 2c 20 79 6f 75 of your own, you
0940: 20 75 73 75 61 6c 6c 79 20 77 61 6e 74 20 74 6f usually want to
0950: 20 64 6f 20 73 6f 6d 65 0a 20 20 20 20 6c 6f 63 do some. loc
0960: 61 6c 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e al configuration
0970: 2e 20 20 54 68 69 73 20 69 73 20 65 61 73 69 6c . This is easil
0980: 79 20 61 63 63 6f 6d 70 6c 69 73 68 65 64 20 75 y accomplished u
0990: 73 69 6e 67 20 74 68 65 20 77 65 62 73 65 72 76 sing the webserv
09a0: 65 72 0a 20 20 20 20 74 68 61 74 20 69 73 20 62 er. that is b
09b0: 75 69 6c 74 20 69 6e 74 6f 20 66 6f 73 73 69 6c uilt into fossil
09c0: 2e 20 20 53 74 61 72 74 20 74 68 65 20 66 6f 73 . Start the fos
09d0: 73 69 6c 20 77 65 62 73 65 72 76 65 72 20 6c 69 sil webserver li
09e0: 6b 65 20 74 68 69 73 3a 3c 2f 70 3e 0a 20 20 20 ke this:</p>.
09f0: 20 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 . <blockquot
0a00: 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c e>. <b>fossil
0a10: 20 75 69 20 3c 2f 62 3e 3c 69 3e 20 72 65 70 6f ui </b><i> repo
0a20: 73 69 74 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 3c sitory-filename<
0a30: 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 /i>. </blockq
0a40: 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 uote>.. <p>Th
0a50: 69 73 20 73 74 61 72 74 73 20 61 20 77 65 62 73 is starts a webs
0a60: 65 72 76 65 72 20 6c 69 73 74 65 6e 69 6e 67 20 erver listening
0a70: 6f 6e 20 70 6f 72 74 20 38 30 38 30 2e 20 20 59 on port 8080. Y
0a80: 6f 75 20 63 61 6e 0a 20 20 20 20 73 70 65 63 69 ou can. speci
0a90: 66 79 20 61 20 64 69 66 66 65 72 65 6e 74 20 70 fy a different p
0aa0: 6f 72 74 20 75 73 69 6e 67 20 74 68 65 20 3c 62 ort using the <b
0ab0: 3e 2d 70 6f 72 74 3c 2f 62 3e 20 6f 70 74 69 6f >-port</b> optio
0ac0: 6e 20 6f 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 64 n on the command
0ad0: 2d 6c 69 6e 65 2e 0a 20 20 20 20 41 66 74 65 72 -line.. After
0ae0: 20 74 68 65 20 73 65 72 76 65 72 20 69 73 20 72 the server is r
0af0: 75 6e 6e 69 6e 67 2c 20 66 6f 73 73 69 6c 20 77 unning, fossil w
0b00: 69 6c 6c 20 74 68 65 6e 20 61 74 74 65 6d 70 74 ill then attempt
0b10: 20 74 6f 20 6c 61 75 6e 63 68 20 79 6f 75 72 0a to launch your.
0b20: 20 20 20 20 77 65 62 20 62 72 6f 77 73 65 72 20 web browser
0b30: 61 6e 64 20 6d 61 6b 65 20 69 74 20 70 6f 69 6e and make it poin
0b40: 74 20 74 6f 20 74 68 69 73 20 77 65 62 20 73 65 t to this web se
0b50: 72 76 65 72 2e 20 20 49 66 20 79 6f 75 72 20 73 rver. If your s
0b60: 79 73 74 65 6d 0a 20 20 20 20 68 61 73 20 61 6e ystem. has an
0b70: 20 75 6e 75 73 75 61 6c 20 63 6f 6e 66 69 67 75 unusual configu
0b80: 72 61 74 69 6f 6e 2c 20 66 6f 73 73 69 6c 20 6d ration, fossil m
0b90: 69 67 68 74 20 6e 6f 74 20 62 65 20 61 62 6c 65 ight not be able
0ba0: 20 74 6f 20 66 69 67 75 72 65 20 6f 75 74 0a 20 to figure out.
0bb0: 20 20 20 68 6f 77 20 74 6f 20 73 74 61 72 74 20 how to start
0bc0: 79 6f 75 72 20 77 65 62 20 62 72 6f 77 73 65 72 your web browser
0bd0: 2e 20 20 49 6e 20 74 68 61 74 20 63 61 73 65 2c . In that case,
0be0: 20 73 74 61 72 74 20 74 68 65 20 77 65 62 20 62 start the web b
0bf0: 72 6f 77 73 65 72 0a 20 20 20 20 79 6f 75 72 73 rowser. yours
0c00: 65 6c 66 20 61 6e 64 20 70 6f 69 6e 74 20 69 74 elf and point it
0c10: 20 61 74 20 68 74 74 70 3a 2f 2f 6c 6f 63 61 6c at http://local
0c20: 68 6f 73 74 3a 38 30 38 30 2f 2e 20 20 43 6c 69 host:8080/. Cli
0c30: 63 6b 20 6f 6e 20 74 68 65 0a 20 20 20 20 22 41 ck on the. "A
0c40: 64 6d 69 6e 22 20 6c 69 6e 6b 20 6f 6e 20 74 68 dmin" link on th
0c50: 65 20 6d 65 6e 75 20 62 61 72 20 74 6f 20 73 74 e menu bar to st
0c60: 61 72 74 20 63 6f 6e 66 69 67 75 72 69 6e 67 20 art configuring
0c70: 79 6f 75 72 20 72 65 70 6f 73 69 74 6f 72 79 2e your repository.
0c80: 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 20 20 3c 70 </p>. . <p
0c90: 3e 42 79 20 64 65 66 61 75 6c 74 2c 20 66 6f 73 >By default, fos
0ca0: 73 69 6c 20 64 6f 65 73 20 6e 6f 74 20 72 65 71 sil does not req
0cb0: 75 69 72 65 20 61 20 6c 6f 67 69 6e 20 66 6f 72 uire a login for
0cc0: 20 48 54 54 50 20 63 6f 6e 6e 65 63 74 69 6f 6e HTTP connection
0cd0: 73 0a 20 20 20 20 63 6f 6d 69 6e 67 20 69 6e 20 s. coming in
0ce0: 66 72 6f 6d 20 74 68 65 20 49 50 20 6c 6f 6f 70 from the IP loop
0cf0: 62 61 63 6b 20 61 64 64 72 65 73 73 20 31 32 37 back address 127
0d00: 2e 30 2e 30 2e 31 2e 20 20 59 6f 75 20 63 61 6e .0.0.1. You can
0d10: 2c 20 61 6e 64 20 70 65 72 68 61 70 73 0a 20 20 , and perhaps.
0d20: 20 20 73 68 6f 75 6c 64 2c 20 63 68 61 6e 67 65 should, change
0d30: 20 74 68 69 73 20 61 66 74 65 72 20 79 6f 75 20 this after you
0d40: 63 72 65 61 74 65 20 61 20 66 65 77 20 75 73 65 create a few use
0d50: 72 73 2e 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 20 rs.</p>. .
0d60: 20 3c 70 3e 57 68 65 6e 20 79 6f 75 20 61 72 65 <p>When you are
0d70: 20 66 69 6e 69 73 68 65 64 20 63 6f 6e 66 69 67 finished config
0d80: 75 72 69 6e 67 2c 20 6a 75 73 74 20 70 72 65 73 uring, just pres
0d90: 73 20 43 6f 6e 74 72 6f 6c 2d 43 20 6f 72 20 75 s Control-C or u
0da0: 73 65 0a 20 20 20 20 74 68 65 20 3c 62 3e 6b 69 se. the <b>ki
0db0: 6c 6c 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 74 ll</b> command t
0dc0: 6f 20 73 68 75 74 20 64 6f 77 6e 20 74 68 65 20 o shut down the
0dd0: 6d 69 6e 69 2d 73 65 72 76 65 72 2e 3c 2f 70 3e mini-server.</p>
0de0: 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c ..</blockquote><
0df0: 68 32 3e 43 68 65 63 6b 69 6e 67 20 4f 75 74 20 h2>Checking Out
0e00: 41 20 4c 6f 63 61 6c 20 54 72 65 65 3c 2f 68 32 A Local Tree</h2
0e10: 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 ><blockquote>..
0e20: 20 20 20 3c 70 3e 54 6f 20 77 6f 72 6b 20 6f 6e <p>To work on
0e30: 20 61 20 70 72 6f 6a 65 63 74 20 69 6e 20 66 6f a project in fo
0e40: 73 73 69 6c 2c 20 79 6f 75 20 6e 65 65 64 20 74 ssil, you need t
0e50: 6f 20 63 68 65 63 6b 20 6f 75 74 20 61 20 6c 6f o check out a lo
0e60: 63 61 6c 0a 20 20 20 20 63 6f 70 79 20 6f 66 20 cal. copy of
0e70: 74 68 65 20 73 6f 75 72 63 65 20 74 72 65 65 2e the source tree.
0e80: 20 20 43 72 65 61 74 65 20 74 68 65 20 64 69 72 Create the dir
0e90: 65 63 74 6f 72 79 20 79 6f 75 20 77 61 6e 74 20 ectory you want
0ea0: 74 6f 20 62 65 0a 20 20 20 20 74 68 65 20 72 6f to be. the ro
0eb0: 6f 74 20 6f 66 20 79 6f 75 72 20 74 72 65 65 20 ot of your tree
0ec0: 61 6e 64 20 63 64 20 69 6e 74 6f 20 74 68 61 74 and cd into that
0ed0: 20 64 69 72 65 63 74 6f 72 79 2e 20 20 54 68 65 directory. The
0ee0: 6e 0a 20 20 20 20 64 6f 20 74 68 69 73 3a 3c 2f n. do this:</
0ef0: 70 3e 0a 20 20 20 20 0a 20 20 20 20 3c 62 6c 6f p>. . <blo
0f00: 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e ckquote>. <b>
0f10: 66 6f 73 73 69 6c 20 6f 70 65 6e 20 3c 2f 62 3e fossil open </b>
0f20: 3c 69 3e 20 72 65 70 6f 73 69 74 6f 72 79 2d 66 <i> repository-f
0f30: 69 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 ilename</i>.
0f40: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 </blockquote>.
0f50: 20 20 0a 20 20 20 20 3c 70 3e 54 68 69 73 20 6c . <p>This l
0f60: 65 61 76 65 73 20 79 6f 75 20 77 69 74 68 20 74 eaves you with t
0f70: 68 65 20 6e 65 77 65 73 74 20 76 65 72 73 69 6f he newest versio
0f80: 6e 20 6f 66 20 74 68 65 20 74 72 65 65 0a 20 20 n of the tree.
0f90: 20 20 63 68 65 63 6b 65 64 20 6f 75 74 2e 20 20 checked out.
0fa0: 20 20 0a 20 20 20 20 46 72 6f 6d 20 61 6e 79 77 . From anyw
0fb0: 68 65 72 65 20 75 6e 64 65 72 6e 65 61 74 68 20 here underneath
0fc0: 74 68 65 20 72 6f 6f 74 20 6f 66 20 79 6f 75 72 the root of your
0fd0: 20 6c 6f 63 61 6c 20 74 72 65 65 2c 20 79 6f 75 local tree, you
0fe0: 0a 20 20 20 20 63 61 6e 20 74 79 70 65 20 63 6f . can type co
0ff0: 6d 6d 61 6e 64 73 20 6c 69 6b 65 20 74 68 65 20 mmands like the
1000: 66 6f 6c 6c 6f 77 69 6e 67 20 74 6f 20 66 69 6e following to fin
1010: 64 20 6f 75 74 20 74 68 65 20 73 74 61 74 75 73 d out the status
1020: 20 6f 66 0a 20 20 20 20 79 6f 75 72 20 6c 6f 63 of. your loc
1030: 61 6c 20 74 72 65 65 3a 3c 2f 70 3e 0a 0a 20 20 al tree:</p>..
1040: 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 <blockquote>.
1050: 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 69 6e 66 <b>fossil inf
1060: 6f 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 o</b><br>. <b
1070: 3e 66 6f 73 73 69 6c 20 73 74 61 74 75 73 3c 2f >fossil status</
1080: 62 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f b><br>. <b>fo
1090: 73 73 69 6c 20 63 68 61 6e 67 65 73 3c 2f 62 3e ssil changes</b>
10a0: 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 <br>. <b>foss
10b0: 69 6c 20 74 69 6d 65 6c 69 6e 65 3c 2f 62 3e 3c il timeline</b><
10c0: 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 br>. <b>fossi
10d0: 6c 20 6c 65 61 76 65 73 3c 2f 62 3e 3c 62 72 3e l leaves</b><br>
10e0: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6c . <b>fossil l
10f0: 73 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 s</b><br>. <b
1100: 3e 66 6f 73 73 69 6c 20 62 72 61 6e 63 68 20 6c >fossil branch l
1110: 69 73 74 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 20 ist</b><br>.
1120: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c </blockquote>..<
1130: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e /blockquote><h2>
1140: 4d 61 6b 69 6e 67 20 43 68 61 6e 67 65 73 3c 2f Making Changes</
1150: 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a h2><blockquote>.
1160: 0a 20 20 20 20 3c 70 3e 54 6f 20 61 64 64 20 6e . <p>To add n
1170: 65 77 20 66 69 6c 65 73 20 74 6f 20 79 6f 75 72 ew files to your
1180: 20 70 72 6f 6a 65 63 74 2c 20 6f 72 20 72 65 6d project, or rem
1190: 6f 76 65 20 6f 6c 64 20 66 69 6c 65 73 2c 20 75 ove old files, u
11a0: 73 65 20 74 68 65 73 65 0a 20 20 20 20 63 6f 6d se these. com
11b0: 6d 61 6e 64 73 3a 3c 2f 70 3e 0a 0a 20 20 20 20 mands:</p>..
11c0: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 <blockquote>.
11d0: 20 3c 62 3e 66 6f 73 73 69 6c 20 61 64 64 3c 2f <b>fossil add</
11e0: 62 3e 20 3c 69 3e 66 69 6c 65 2e 2e 2e 3c 2f 69 b> <i>file...</i
11f0: 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 ><br>. <b>fos
1200: 73 69 6c 20 72 6d 3c 2f 62 3e 20 3c 69 3e 66 69 sil rm</b> <i>fi
1210: 6c 65 2e 2e 2e 3c 2f 69 3e 0a 20 20 20 20 3c 2f le...</i>. </
1220: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 blockquote>..
1230: 20 3c 70 3e 59 6f 75 20 63 61 6e 20 61 6c 73 6f <p>You can also
1240: 20 65 64 69 74 20 66 69 6c 65 73 20 66 72 65 65 edit files free
1250: 6c 79 2e 20 20 4f 6e 63 65 20 79 6f 75 20 61 72 ly. Once you ar
1260: 65 20 72 65 61 64 79 20 74 6f 20 63 6f 6d 6d 69 e ready to commi
1270: 74 0a 20 20 20 20 79 6f 75 72 20 63 68 61 6e 67 t. your chang
1280: 65 73 2c 20 74 79 70 65 3a 3c 2f 70 3e 0a 0a 20 es, type:</p>..
1290: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a <blockquote>.
12a0: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 63 6f <b>fossil co
12b0: 6d 6d 69 74 3c 2f 62 3e 0a 20 20 20 20 3c 2f 62 mmit</b>. </b
12c0: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 lockquote>..
12d0: 3c 70 3e 59 6f 75 20 77 69 6c 6c 20 62 65 20 70 <p>You will be p
12e0: 72 6f 6d 70 74 65 64 20 66 6f 72 20 63 68 65 63 rompted for chec
12f0: 6b 2d 69 6e 20 63 6f 6d 6d 65 6e 74 73 20 75 73 k-in comments us
1300: 69 6e 67 20 77 68 61 74 65 76 65 72 20 65 64 69 ing whatever edi
1310: 74 6f 72 0a 20 20 20 20 69 73 20 73 70 65 63 69 tor. is speci
1320: 66 69 65 64 20 62 79 20 79 6f 75 72 20 56 49 53 fied by your VIS
1330: 55 41 4c 20 6f 72 20 45 44 49 54 4f 52 20 65 6e UAL or EDITOR en
1340: 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 vironment variab
1350: 6c 65 2e 20 20 49 66 20 79 6f 75 0a 20 20 20 20 le. If you.
1360: 68 61 76 65 20 47 50 47 20 69 6e 73 74 61 6c 6c have GPG install
1370: 65 64 2c 20 79 6f 75 20 6d 61 79 20 62 65 20 70 ed, you may be p
1380: 72 6f 6d 70 74 65 64 20 66 6f 72 20 79 6f 75 72 rompted for your
1390: 20 47 50 47 20 70 61 73 73 70 68 72 61 73 65 20 GPG passphrase
13a0: 73 6f 0a 20 20 20 20 74 68 61 74 20 74 68 65 20 so. that the
13b0: 63 68 65 63 6b 2d 69 6e 20 63 61 6e 20 62 65 20 check-in can be
13c0: 73 69 67 6e 65 64 20 77 69 74 68 20 79 6f 75 72 signed with your
13d0: 20 47 50 47 20 73 69 67 6e 61 74 75 72 65 2e 20 GPG signature.
13e0: 20 41 66 74 65 72 0a 20 20 20 20 74 68 69 73 20 After. this
13f0: 79 6f 75 72 20 63 68 61 6e 67 65 73 20 77 69 6c your changes wil
1400: 6c 20 62 65 20 63 68 65 63 6b 65 64 20 69 6e 2e l be checked in.
1410: 3c 2f 70 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f </p>..</blockquo
1420: 74 65 3e 3c 68 32 3e 53 68 61 72 69 6e 67 20 43 te><h2>Sharing C
1430: 68 61 6e 67 65 73 3c 2f 68 32 3e 3c 62 6c 6f 63 hanges</h2><bloc
1440: 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e kquote>.. <p>
1450: 54 68 65 20 63 68 61 6e 67 65 73 20 79 6f 75 20 The changes you
1460: 3c 62 3e 63 6f 6d 6d 69 74 3c 2f 62 3e 20 61 72 <b>commit</b> ar
1470: 65 20 6f 6e 6c 79 20 6f 6e 20 79 6f 75 72 20 6c e only on your l
1480: 6f 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 2e ocal repository.
1490: 0a 20 20 20 20 54 6f 20 73 68 61 72 65 20 74 68 . To share th
14a0: 6f 73 65 20 63 68 61 6e 67 65 73 20 77 69 74 68 ose changes with
14b0: 20 6f 74 68 65 72 20 72 65 70 6f 73 69 74 6f 72 other repositor
14c0: 69 65 73 2c 20 64 6f 3a 3c 2f 70 3e 0a 0a 20 20 ies, do:</p>..
14d0: 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 <blockquote>.
14e0: 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 70 75 73 <b>fossil pus
14f0: 68 3c 2f 62 3e 20 3c 69 3e 55 52 4c 3c 2f 69 3e h</b> <i>URL</i>
1500: 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 . </blockquot
1510: 65 3e 0a 0a 20 20 20 20 3c 70 3e 57 68 65 72 65 e>.. <p>Where
1520: 20 3c 69 3e 55 52 4c 3c 2f 69 3e 20 69 73 20 74 <i>URL</i> is t
1530: 68 65 20 68 74 74 70 3a 20 55 52 4c 20 6f 66 20 he http: URL of
1540: 74 68 65 20 73 65 72 76 65 72 20 72 65 70 6f 73 the server repos
1550: 69 74 6f 72 79 20 79 6f 75 0a 20 20 20 20 77 61 itory you. wa
1560: 6e 74 20 74 6f 20 73 68 61 72 65 20 79 6f 75 72 nt to share your
1570: 20 63 68 61 6e 67 65 73 20 77 69 74 68 2e 20 20 changes with.
1580: 49 66 20 79 6f 75 20 6f 6d 69 74 20 74 68 65 20 If you omit the
1590: 3c 69 3e 55 52 4c 3c 2f 69 3e 20 61 72 67 75 6d <i>URL</i> argum
15a0: 65 6e 74 2c 0a 20 20 20 20 66 6f 73 73 69 6c 20 ent,. fossil
15b0: 77 69 6c 6c 20 75 73 65 20 77 68 61 74 65 76 65 will use whateve
15c0: 72 20 73 65 72 76 65 72 20 79 6f 75 20 6d 6f 73 r server you mos
15d0: 74 20 72 65 63 65 6e 74 6c 79 20 73 79 6e 63 65 t recently synce
15e0: 64 20 77 69 74 68 2e 3c 2f 70 3e 0a 0a 20 20 20 d with.</p>..
15f0: 20 3c 70 3e 54 68 65 20 3c 62 3e 70 75 73 68 3c <p>The <b>push<
1600: 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 6f 6e 6c 79 /b> command only
1610: 20 73 65 6e 64 73 20 79 6f 75 72 20 63 68 61 6e sends your chan
1620: 67 65 73 20 74 6f 20 6f 74 68 65 72 73 2e 20 20 ges to others.
1630: 54 6f 0a 20 20 20 20 52 65 63 65 69 76 65 20 63 To. Receive c
1640: 68 61 6e 67 65 73 20 66 72 6f 6d 20 6f 74 68 65 hanges from othe
1650: 72 73 2c 20 75 73 65 20 3c 62 3e 70 75 6c 6c 3c rs, use <b>pull<
1660: 2f 62 3e 2e 20 20 4f 72 20 67 6f 20 62 6f 74 68 /b>. Or go both
1670: 20 77 61 79 73 20 61 74 0a 20 20 20 20 6f 6e 63 ways at. onc
1680: 65 20 75 73 69 6e 67 20 3c 62 3e 73 79 6e 63 3c e using <b>sync<
1690: 2f 62 3e 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 /b>:</p>.. <b
16a0: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c lockquote>. <
16b0: 62 3e 66 6f 73 73 69 6c 20 70 75 6c 6c 3c 2f 62 b>fossil pull</b
16c0: 3e 20 3c 69 3e 55 52 4c 3c 2f 69 3e 3c 62 72 3e > <i>URL</i><br>
16d0: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 73 . <b>fossil s
16e0: 79 6e 63 3c 2f 62 3e 20 3c 69 3e 55 52 4c 3c 2f ync</b> <i>URL</
16f0: 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 i>. </blockqu
1700: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 57 68 65 ote>.. <p>Whe
1710: 6e 20 79 6f 75 20 70 75 6c 6c 20 69 6e 20 63 68 n you pull in ch
1720: 61 6e 67 65 73 20 66 72 6f 6d 20 6f 74 68 65 72 anges from other
1730: 73 2c 20 74 68 65 79 20 67 6f 20 69 6e 74 6f 20 s, they go into
1740: 79 6f 75 72 20 72 65 70 6f 73 69 74 6f 72 79 2c your repository,
1750: 0a 20 20 20 20 6e 6f 74 20 69 6e 74 6f 20 79 6f . not into yo
1760: 75 72 20 63 68 65 63 6b 65 64 2d 6f 75 74 20 6c ur checked-out l
1770: 6f 63 61 6c 20 74 72 65 65 2e 20 20 54 6f 20 67 ocal tree. To g
1780: 65 74 20 74 68 65 20 63 68 61 6e 67 65 73 20 69 et the changes i
1790: 6e 74 6f 20 79 6f 75 72 0a 20 20 20 20 6c 6f 63 nto your. loc
17a0: 61 6c 20 74 72 65 65 2c 20 75 73 65 20 3c 62 3e al tree, use <b>
17b0: 75 70 64 61 74 65 3c 2f 62 3e 3a 3c 2f 70 3e 0a update</b>:</p>.
17c0: 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 . <blockquote
17d0: 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 >. <b>fossil
17e0: 75 70 64 61 74 65 3c 2f 62 3e 20 3c 69 3e 41 49 update</b> <i>AI
17f0: 44 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 D</i>. </bloc
1800: 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e kquote>.. <p>
1810: 54 68 65 20 3c 69 3e 41 49 44 3c 2f 69 3e 20 69 The <i>AID</i> i
1820: 73 20 73 6f 6d 65 20 75 6e 69 71 75 65 20 61 62 s some unique ab
1830: 62 72 65 76 69 61 74 69 6f 6e 20 74 6f 20 74 68 breviation to th
1840: 65 20 34 30 2d 63 68 61 72 61 63 74 65 72 0a 20 e 40-character.
1850: 20 20 20 61 72 74 69 66 61 63 74 20 69 64 65 6e artifact iden
1860: 74 69 66 69 65 72 20 28 41 49 44 29 20 66 6f 72 tifier (AID) for
1870: 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 63 68 a particular ch
1880: 65 63 6b 2d 69 6e 2e 20 20 49 66 20 79 6f 75 20 eck-in. If you
1890: 6f 6d 69 74 0a 20 20 20 20 74 68 65 20 3c 69 3e omit. the <i>
18a0: 41 49 44 3c 2f 69 3e 20 66 6f 73 73 69 6c 20 6d AID</i> fossil m
18b0: 6f 76 65 73 20 79 6f 75 20 74 6f 20 74 68 65 0a oves you to the.
18c0: 20 20 20 20 6c 65 61 66 20 76 65 72 73 69 6f 6e leaf version
18d0: 20 6f 66 20 74 68 65 20 62 72 61 6e 63 68 20 79 of the branch y
18e0: 6f 75 72 20 61 72 65 20 63 75 72 72 65 6e 74 6c our are currentl
18f0: 79 20 6f 6e 2e 20 20 49 66 20 79 6f 75 72 20 62 y on. If your b
1900: 72 61 6e 63 68 0a 20 20 20 20 68 61 73 20 6d 75 ranch. has mu
1910: 6c 74 69 70 6c 65 20 6c 65 61 76 65 73 2c 20 79 ltiple leaves, y
1920: 6f 75 20 67 65 74 20 61 6e 20 65 72 72 6f 72 20 ou get an error
1930: 2d 20 79 6f 75 27 6c 6c 20 68 61 76 65 20 74 6f - you'll have to
1940: 20 73 70 65 63 69 66 79 20 74 68 65 0a 20 20 20 specify the.
1950: 20 6c 65 61 66 20 79 6f 75 20 77 61 6e 74 20 75 leaf you want u
1960: 73 69 6e 67 20 61 20 3c 69 3e 41 49 44 3c 2f 69 sing a <i>AID</i
1970: 3e 20 61 72 67 75 6d 65 6e 74 2e 3c 2f 70 3e 0a > argument.</p>.
1980: 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 .</blockquote><h
1990: 32 3e 42 72 61 6e 63 68 69 6e 67 20 41 6e 64 20 2>Branching And
19a0: 4d 65 72 67 69 6e 67 3c 2f 68 32 3e 3c 62 6c 6f Merging</h2><blo
19b0: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 ckquote>.. <p
19c0: 3e 59 6f 75 20 63 61 6e 20 63 72 65 61 74 65 20 >You can create
19d0: 62 72 61 6e 63 68 65 73 20 62 79 20 64 6f 69 6e branches by doin
19e0: 67 20 6d 75 6c 74 69 70 6c 65 20 63 6f 6d 6d 69 g multiple commi
19f0: 74 73 20 6f 66 66 20 6f 66 20 74 68 65 0a 20 20 ts off of the.
1a00: 20 20 73 61 6d 65 20 62 61 73 65 20 76 65 72 73 same base vers
1a10: 69 6f 6e 2e 20 20 54 6f 20 6d 65 72 67 65 20 74 ion. To merge t
1a20: 6f 20 62 72 61 6e 63 68 65 73 20 62 61 63 6b 20 o branches back
1a30: 74 6f 67 65 74 68 65 72 2c 20 66 69 72 73 74 0a together, first.
1a40: 20 20 20 20 3c 62 3e 75 70 64 61 74 65 3c 2f 62 <b>update</b
1a50: 3e 20 74 6f 20 74 68 65 20 6c 65 61 66 20 6f 66 > to the leaf of
1a60: 20 6f 6e 65 20 62 72 61 6e 63 68 2e 20 20 54 68 one branch. Th
1a70: 65 6e 20 64 6f 20 61 20 3c 62 3e 6d 65 72 67 65 en do a <b>merge
1a80: 3c 2f 62 3e 0a 20 20 20 20 6f 66 20 74 68 65 20 </b>. of the
1a90: 6c 65 61 66 20 6f 66 20 74 68 65 20 6f 74 68 65 leaf of the othe
1aa0: 72 20 62 72 61 6e 63 68 3a 3c 2f 70 3e 0a 0a 20 r branch:</p>..
1ab0: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a <blockquote>.
1ac0: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6d 65 <b>fossil me
1ad0: 72 67 65 3c 2f 62 3e 20 3c 69 3e 41 49 44 3c 2f rge</b> <i>AID</
1ae0: 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 i>. </blockqu
1af0: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 65 73 ote>.. <p>Tes
1b00: 74 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 79 t to make sure y
1b10: 6f 75 72 20 6d 65 72 67 65 20 64 69 64 6e 27 74 our merge didn't
1b20: 20 6d 65 73 73 20 75 70 20 74 68 65 20 63 6f 64 mess up the cod
1b30: 65 2c 20 74 68 65 6e 0a 20 20 20 20 3c 62 3e 63 e, then. <b>c
1b40: 6f 6d 6d 69 74 3c 2f 62 3e 20 61 6e 64 20 70 6f ommit</b> and po
1b50: 73 73 69 62 6c 79 20 61 6c 73 6f 20 3c 62 3e 70 ssibly also <b>p
1b60: 75 73 68 3c 2f 62 3e 20 79 6f 75 72 20 63 68 61 ush</b> your cha
1b70: 6e 67 65 73 2e 20 20 20 52 65 6d 65 6d 62 65 72 nges. Remember
1b80: 0a 20 20 20 20 74 68 61 74 20 6e 6f 62 6f 64 79 . that nobody
1b90: 20 65 6c 73 65 20 63 61 6e 20 73 65 65 20 79 6f else can see yo
1ba0: 75 72 20 63 68 61 6e 67 65 73 20 75 6e 74 69 6c ur changes until
1bb0: 20 79 6f 75 20 3c 62 3e 63 6f 6d 6d 69 74 3c 2f you <b>commit</
1bc0: 62 3e 20 61 6e 64 0a 20 20 20 20 69 66 20 6f 74 b> and. if ot
1bd0: 68 65 72 20 61 72 65 20 75 73 69 6e 67 20 61 20 her are using a
1be0: 64 69 66 66 65 72 65 6e 74 20 72 65 70 6f 73 69 different reposi
1bf0: 74 6f 72 79 20 79 6f 75 20 77 69 6c 6c 20 61 6c tory you will al
1c00: 73 6f 20 6e 65 65 64 20 74 6f 0a 20 20 20 20 3c so need to. <
1c10: 62 3e 70 75 73 68 3c 2f 62 3e 2e 3c 2f 70 3e 0a b>push</b>.</p>.
1c20: 0a 3c 61 20 6e 61 6d 65 3d 22 73 65 72 76 65 72 .<a name="server
1c30: 73 65 74 75 70 22 3e 3c 2f 61 3e 0a 3c 2f 62 6c setup"></a>.</bl
1c40: 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 53 65 74 ockquote><h2>Set
1c50: 74 69 6e 67 20 55 70 20 41 20 53 65 72 76 65 72 ting Up A Server
1c60: 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 </h2><blockquote
1c70: 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 65 61 >.. <p>The ea
1c80: 73 69 65 73 74 20 77 61 79 20 74 6f 20 73 65 74 siest way to set
1c90: 20 75 70 20 61 20 73 65 72 76 65 72 20 69 73 3a up a server is:
1ca0: 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b </p>.. <block
1cb0: 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f quote>. <b>fo
1cc0: 73 73 69 6c 20 73 65 72 76 65 72 3c 2f 62 3e 20 ssil server</b>
1cd0: 3c 69 3e 72 65 70 6f 73 69 74 6f 72 79 2d 66 69 <i>repository-fi
1ce0: 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c lename</i>. <
1cf0: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 /blockquote>..
1d00: 20 20 3c 70 3e 4f 72 3c 2f 62 3e 0a 0a 20 20 20 <p>Or</b>..
1d10: 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 <blockquote>.
1d20: 20 20 3c 62 3e 66 6f 73 73 69 6c 20 75 69 3c 2f <b>fossil ui</
1d30: 62 3e 20 3c 69 3e 72 65 70 6f 73 69 74 6f 72 79 b> <i>repository
1d40: 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 -filename</i>.
1d50: 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a </blockquote>.
1d60: 0a 20 20 20 20 3c 70 3e 54 68 65 20 64 69 66 66 . <p>The diff
1d70: 65 72 65 6e 63 65 20 62 65 74 77 65 65 6e 20 74 erence between t
1d80: 68 65 73 65 20 74 77 6f 20 63 6f 6d 6d 61 6e 64 hese two command
1d90: 20 69 73 20 74 68 61 74 20 3c 62 3e 75 69 3c 2f is that <b>ui</
1da0: 62 3e 0a 20 20 20 20 61 74 74 65 6d 70 74 73 20 b>. attempts
1db0: 74 6f 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 to automatically
1dc0: 20 73 74 61 72 74 20 79 6f 75 72 20 77 65 62 20 start your web
1dd0: 62 72 6f 77 73 65 72 20 70 6f 69 6e 74 69 6e 67 browser pointing
1de0: 20 61 74 20 74 68 65 0a 20 20 20 20 73 65 72 76 at the. serv
1df0: 65 72 20 77 68 65 72 65 61 73 20 3c 62 3e 73 65 er whereas <b>se
1e00: 72 76 65 72 3c 2f 62 3e 20 64 6f 65 73 20 6e 6f rver</b> does no
1e10: 74 2e 0a 20 20 20 20 59 6f 75 20 63 61 6e 20 6f t.. You can o
1e20: 6d 69 74 20 74 68 65 20 3c 69 3e 72 65 70 6f 73 mit the <i>repos
1e30: 69 74 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f itory-filename</
1e40: 69 3e 20 69 66 20 79 6f 75 20 61 72 65 20 77 69 i> if you are wi
1e50: 74 68 69 6e 0a 20 20 20 20 61 20 63 68 65 63 6b thin. a check
1e60: 65 64 2d 6f 75 74 20 6c 6f 63 61 6c 20 74 72 65 ed-out local tre
1e70: 65 2e 20 20 54 68 69 73 20 73 65 72 76 65 72 20 e. This server
1e80: 75 73 65 73 20 70 6f 72 74 20 38 30 38 30 20 62 uses port 8080 b
1e90: 79 20 64 65 66 61 75 6c 74 0a 20 20 20 20 62 75 y default. bu
1ea0: 74 20 79 6f 75 20 63 61 6e 20 73 70 65 63 69 66 t you can specif
1eb0: 79 20 61 20 64 69 66 66 65 72 65 6e 74 20 70 6f y a different po
1ec0: 72 74 20 75 73 69 6e 67 20 74 68 65 20 3c 62 3e rt using the <b>
1ed0: 2d 70 6f 72 74 3c 2f 62 3e 20 63 6f 6d 6d 61 6e -port</b> comman
1ee0: 64 2e 3c 2f 70 3e 0a 0a 20 20 20 20 3c 70 3e 43 d.</p>.. <p>C
1ef0: 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 73 65 72 76 ommand-line serv
1f00: 65 72 73 20 6c 69 6b 65 20 74 68 69 73 20 61 72 ers like this ar
1f10: 65 20 75 73 65 66 75 6c 20 77 68 65 6e 20 74 77 e useful when tw
1f20: 6f 20 70 65 6f 70 6c 65 20 77 61 6e 74 0a 20 20 o people want.
1f30: 20 20 74 6f 20 73 68 61 72 65 20 61 20 72 65 70 to share a rep
1f40: 6f 73 69 74 6f 72 79 20 6f 6e 20 74 65 6d 70 6f ository on tempo
1f50: 72 61 72 79 20 6f 72 20 61 64 2d 68 6f 63 20 62 rary or ad-hoc b
1f60: 61 73 69 73 2e 20 20 46 6f 72 20 61 20 6d 6f 72 asis. For a mor
1f70: 65 0a 20 20 20 20 70 65 72 6d 61 6e 65 6e 74 20 e. permanent
1f80: 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 2c 20 79 6f installation, yo
1f90: 75 20 73 68 6f 75 6c 64 20 75 73 65 20 65 69 74 u should use eit
1fa0: 68 65 72 20 74 68 65 20 43 47 49 20 73 65 72 76 her the CGI serv
1fb0: 65 72 20 6f 72 20 74 68 65 0a 20 20 20 20 69 6e er or the. in
1fc0: 65 74 64 20 73 65 72 76 65 72 2e 0a 20 20 20 20 etd server..
1fd0: 3c 61 20 6e 61 6d 65 3d 22 63 67 69 73 65 72 76 <a name="cgiserv
1fe0: 65 72 22 3e 3c 2f 61 3e 0a 20 20 20 20 54 6f 20 er"></a>. To
1ff0: 75 73 65 20 74 68 65 20 43 47 49 20 73 65 72 76 use the CGI serv
2000: 65 72 2c 20 63 72 65 61 74 65 20 61 20 43 47 49 er, create a CGI
2010: 20 73 63 72 69 70 74 20 74 68 61 74 0a 20 20 20 script that.
2020: 20 6c 6f 6f 6b 73 20 73 6f 6d 65 74 68 69 6e 67 looks something
2030: 20 6c 69 6b 65 20 74 68 69 73 3a 3c 2f 70 3e 0a like this:</p>.
2040: 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 . <blockquote
2050: 3e 3c 62 3e 0a 20 20 20 20 23 21 2f 75 73 72 2f ><b>. #!/usr/
2060: 6c 6f 63 61 6c 2f 62 69 6e 2f 66 6f 73 73 69 6c local/bin/fossil
2070: 3c 62 72 3e 0a 20 20 20 20 72 65 70 6f 73 69 74 <br>. reposit
2080: 6f 72 79 3a 20 2f 68 6f 6d 65 2f 70 72 6f 6a 31 ory: /home/proj1
2090: 2f 72 65 70 6f 73 31 2e 66 6f 73 73 69 6c 0a 20 /repos1.fossil.
20a0: 20 20 20 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 75 </b></blockqu
20b0: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 41 64 6a ote>.. <p>Adj
20c0: 75 73 74 20 74 68 65 20 70 61 74 68 73 20 69 6e ust the paths in
20d0: 20 74 68 69 73 20 43 47 49 20 73 63 72 69 70 74 this CGI script
20e0: 20 74 6f 20 6d 61 74 63 68 20 79 6f 75 72 20 69 to match your i
20f0: 6e 73 74 61 6c 6c 61 74 69 6f 6e 0a 20 20 20 20 nstallation.
2100: 61 6e 64 20 6d 61 6b 65 20 73 75 72 65 20 74 68 and make sure th
2110: 61 74 20 72 65 70 6f 73 69 74 6f 72 79 20 66 69 at repository fi
2120: 6c 65 20 61 74 20 74 68 65 20 64 69 72 65 63 74 le at the direct
2130: 6f 72 79 20 74 68 61 74 20 63 6f 6e 74 61 69 6e ory that contain
2140: 73 20 69 74 0a 20 20 20 20 61 72 65 20 62 6f 74 s it. are bot
2150: 68 20 72 65 61 64 61 62 6c 65 20 61 6e 64 20 77 h readable and w
2160: 72 69 74 61 62 6c 65 20 62 79 20 74 68 65 20 75 ritable by the u
2170: 73 65 72 20 74 68 61 74 20 43 47 49 20 73 63 72 ser that CGI scr
2180: 69 70 74 73 20 72 75 6e 20 61 73 2e 0a 20 20 20 ipts run as..
2190: 20 54 68 65 6e 20 70 6f 69 6e 74 20 63 6c 69 65 Then point clie
21a0: 6e 74 73 20 61 74 20 74 68 65 20 43 47 49 20 73 nts at the CGI s
21b0: 63 72 69 70 74 2e 20 20 54 68 61 74 27 73 20 61 cript. That's a
21c0: 6c 6c 20 74 68 65 72 65 20 69 73 20 74 6f 20 69 ll there is to i
21d0: 74 21 3c 2f 70 3e 0a 0a 20 20 20 20 3c 61 20 6e t!</p>.. <a n
21e0: 61 6d 65 3d 22 69 6e 65 74 64 73 65 72 76 65 72 ame="inetdserver
21f0: 22 3e 3c 2f 61 3e 0a 20 20 20 20 3c 70 3e 59 6f "></a>. <p>Yo
2200: 75 20 63 61 6e 20 61 6c 73 6f 20 72 75 6e 20 66 u can also run f
2210: 6f 73 73 69 6c 20 6f 66 66 20 6f 66 20 69 6e 65 ossil off of ine
2220: 74 64 20 6f 72 20 78 69 6e 65 74 64 2e 20 20 46 td or xinetd. F
2230: 6f 72 20 61 6e 20 69 6e 65 74 64 0a 20 20 20 20 or an inetd.
2240: 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 2c 20 6d 61 installation, ma
2250: 6b 65 20 61 6e 20 65 6e 74 72 79 20 69 6e 20 2f ke an entry in /
2260: 65 74 63 2f 69 6e 65 74 64 2e 63 6f 6e 66 20 74 etc/inetd.conf t
2270: 68 61 74 20 6c 6f 6f 6b 73 20 73 6f 6d 65 74 68 hat looks someth
2280: 69 6e 67 0a 20 20 20 20 6c 69 6b 65 20 74 68 69 ing. like thi
2290: 73 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f s:</p>.. <blo
22a0: 63 6b 71 75 6f 74 65 3e 3c 62 3e 0a 20 20 20 20 ckquote><b>.
22b0: 38 30 20 73 74 72 65 61 6d 20 74 63 70 20 6e 6f 80 stream tcp no
22c0: 77 61 69 74 2e 31 30 30 30 20 72 6f 6f 74 20 2f wait.1000 root /
22d0: 75 73 72 2f 62 69 6e 2f 66 6f 73 73 69 6c 20 5c usr/bin/fossil \
22e0: 3c 62 72 3e 0a 20 20 20 20 20 20 20 20 2f 75 73 <br>. /us
22f0: 72 2f 62 69 6e 2f 66 6f 73 73 69 6c 20 68 74 74 r/bin/fossil htt
2300: 70 20 2f 68 6f 6d 65 2f 70 72 6f 6a 31 2f 72 65 p /home/proj1/re
2310: 70 6f 73 31 2e 66 6f 73 73 69 6c 0a 20 20 20 20 pos1.fossil.
2320: 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 </b></blockquote
2330: 3e 0a 0a 20 20 20 20 3c 70 3e 41 64 6a 75 73 74 >.. <p>Adjust
2340: 20 74 68 65 20 70 61 74 68 73 20 74 6f 20 73 75 the paths to su
2350: 69 74 20 79 6f 75 72 20 69 6e 73 74 61 6c 6c 61 it your installa
2360: 74 69 6f 6e 2c 20 6f 66 20 63 6f 75 72 73 65 2e tion, of course.
2370: 20 20 4e 6f 74 69 63 65 20 74 68 61 74 0a 20 20 Notice that.
2380: 20 20 66 6f 73 73 69 6c 20 72 75 6e 73 20 61 73 fossil runs as
2390: 20 72 6f 6f 74 2e 20 20 54 68 69 73 20 69 73 20 root. This is
23a0: 6e 6f 74 20 72 65 71 75 69 72 65 64 20 2d 20 79 not required - y
23b0: 6f 75 20 63 61 6e 20 72 75 6e 20 69 74 20 61 73 ou can run it as
23c0: 20 61 6e 0a 20 20 20 20 75 6e 70 72 69 76 69 6c an. unprivil
23d0: 65 67 65 64 20 75 73 65 72 2e 20 20 42 75 74 20 eged user. But
23e0: 69 74 20 69 73 20 6d 6f 72 65 20 73 65 63 75 72 it is more secur
23f0: 65 20 74 6f 20 72 75 6e 20 66 6f 73 73 69 6c 20 e to run fossil
2400: 61 73 20 72 6f 6f 74 2e 0a 20 20 20 20 57 68 65 as root.. Whe
2410: 6e 20 79 6f 75 20 64 6f 20 72 75 6e 20 66 6f 73 n you do run fos
2420: 73 69 6c 20 61 73 20 72 6f 6f 74 2c 20 69 74 20 sil as root, it
2430: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 70 75 automatically pu
2440: 74 73 20 69 74 73 65 6c 66 20 69 6e 20 61 0a 20 ts itself in a.
2450: 20 20 20 63 68 72 6f 6f 74 20 6a 61 69 6c 20 69 chroot jail i
2460: 6e 20 74 68 65 20 73 61 6d 65 20 64 69 72 65 63 n the same direc
2470: 74 6f 72 79 20 61 73 20 74 68 65 20 72 65 70 6f tory as the repo
2480: 73 69 74 6f 72 79 2c 20 74 68 65 6e 20 64 72 6f sitory, then dro
2490: 70 73 0a 20 20 20 20 72 6f 6f 74 20 70 72 69 76 ps. root priv
24a0: 69 6c 65 67 65 73 20 70 72 69 6f 72 20 74 6f 20 ileges prior to
24b0: 72 65 61 64 69 6e 67 20 61 6e 79 20 69 6e 66 6f reading any info
24c0: 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 74 68 65 rmation from the
24d0: 20 72 65 71 75 65 73 74 2e 3c 2f 70 3e 0a 0a 3c request.</p>..<
24e0: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 61 20 6e /blockquote><a n
24f0: 61 6d 65 3d 22 70 72 6f 78 79 22 3e 3c 2f 61 3e ame="proxy"></a>
2500: 3c 68 32 3e 48 54 54 50 20 50 72 6f 78 69 65 73 <h2>HTTP Proxies
2510: 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 </h2><blockquote
2520: 3e 0a 0a 20 20 20 20 3c 70 3e 49 66 20 79 6f 75 >.. <p>If you
2530: 20 61 72 65 20 62 65 68 69 6e 64 20 61 20 72 65 are behind a re
2540: 73 74 72 69 63 74 69 76 65 20 66 69 72 65 77 61 strictive firewa
2550: 6c 6c 20 74 68 61 74 20 72 65 71 75 69 72 65 73 ll that requires
2560: 20 79 6f 75 20 74 6f 20 75 73 65 0a 20 20 20 20 you to use.
2570: 61 6e 20 48 54 54 50 20 70 72 6f 78 79 20 74 6f an HTTP proxy to
2580: 20 72 65 61 63 68 20 74 68 65 20 69 6e 74 65 72 reach the inter
2590: 6e 65 74 2c 20 74 68 65 6e 20 79 6f 75 20 63 61 net, then you ca
25a0: 6e 20 63 6f 6e 66 69 67 75 72 65 20 74 68 65 20 n configure the
25b0: 70 72 6f 78 79 0a 20 20 20 20 69 6e 20 74 68 72 proxy. in thr
25c0: 65 65 20 64 69 66 66 65 72 65 6e 74 20 77 61 79 ee different way
25d0: 73 2e 20 20 59 6f 75 20 63 61 6e 20 74 65 6c 6c s. You can tell
25e0: 20 66 6f 73 73 69 6c 20 61 62 6f 75 74 20 79 6f fossil about yo
25f0: 75 72 20 70 72 6f 78 79 20 75 73 69 6e 67 0a 20 ur proxy using.
2600: 20 20 20 61 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e a command-lin
2610: 65 20 6f 70 74 69 6f 6e 20 6f 6e 20 63 6f 6d 6d e option on comm
2620: 61 6e 64 73 20 74 68 61 74 20 75 73 65 20 74 68 ands that use th
2630: 65 20 6e 65 74 77 6f 72 6b 2c 0a 20 20 20 20 3c e network,. <
2640: 62 3e 73 79 6e 63 3c 2f 62 3e 2c 20 3c 62 3e 63 b>sync</b>, <b>c
2650: 6c 6f 6e 65 3c 2f 62 3e 2c 20 3c 62 3e 70 75 73 lone</b>, <b>pus
2660: 68 3c 2f 62 3e 2c 20 61 6e 64 20 3c 62 3e 70 75 h</b>, and <b>pu
2670: 6c 6c 3c 2f 62 3e 2e 3c 2f 70 3e 0a 0a 20 20 20 ll</b>.</p>..
2680: 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 <blockquote>.
2690: 20 20 3c 62 3e 66 6f 73 73 69 6c 20 63 6c 6f 6e <b>fossil clon
26a0: 65 20 3c 2f 62 3e 3c 69 3e 55 52 4c 3c 2f 69 3e e </b><i>URL</i>
26b0: 20 20 3c 62 3e 2d 2d 70 72 6f 78 79 3c 2f 62 3e <b>--proxy</b>
26c0: 20 3c 69 3e 50 72 6f 78 79 2d 55 52 4c 3c 2f 69 <i>Proxy-URL</i
26d0: 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f >. </blockquo
26e0: 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 49 74 20 69 te>.. <p>It i
26f0: 73 20 61 6e 6e 6f 79 69 6e 67 20 74 6f 20 68 61 s annoying to ha
2700: 76 65 20 74 6f 20 74 79 70 65 20 69 6e 20 74 68 ve to type in th
2710: 65 20 70 72 6f 78 79 20 55 52 4c 20 65 76 65 72 e proxy URL ever
2720: 79 20 74 69 6d 65 20 79 6f 75 0a 20 20 20 20 73 y time you. s
2730: 79 6e 63 20 79 6f 75 72 20 70 72 6f 6a 65 63 74 ync your project
2740: 2c 20 74 68 6f 75 67 68 2c 20 73 6f 20 79 6f 75 , though, so you
2750: 20 63 61 6e 20 6d 61 6b 65 20 74 68 65 20 70 72 can make the pr
2760: 6f 78 79 20 63 6f 6e 66 69 67 75 72 61 74 69 6f oxy configuratio
2770: 6e 0a 20 20 20 20 70 65 72 73 69 73 74 65 6e 74 n. persistent
2780: 20 75 73 69 6e 67 20 74 68 65 20 3c 62 3e 73 65 using the <b>se
2790: 74 74 69 6e 67 3c 2f 62 3e 20 63 6f 6d 6d 61 6e tting</b> comman
27a0: 64 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f d:</p>.. <blo
27b0: 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e ckquote>. <b>
27c0: 66 6f 73 73 69 6c 20 73 65 74 74 69 6e 67 20 70 fossil setting p
27d0: 72 6f 78 79 20 3c 2f 62 3e 3c 69 3e 50 72 6f 78 roxy </b><i>Prox
27e0: 79 2d 55 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c 2f y-URL</i>. </
27f0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 blockquote>..
2800: 20 3c 70 3e 4f 72 2c 20 79 6f 75 20 63 61 6e 20 <p>Or, you can
2810: 73 65 74 20 74 68 65 20 22 3c 62 3e 68 74 74 70 set the "<b>http
2820: 5f 70 72 6f 78 79 3c 2f 62 3e 22 20 65 6e 76 69 _proxy</b>" envi
2830: 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 ronment variable
2840: 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 :</p>.. <bloc
2850: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 65 kquote>. <b>e
2860: 78 70 6f 72 74 20 68 74 74 70 5f 70 72 6f 78 79 xport http_proxy
2870: 3d 3c 2f 62 3e 3c 69 3e 50 72 6f 78 79 2d 55 52 =</b><i>Proxy-UR
2880: 4c 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 L</i>. </bloc
2890: 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e kquote>.. <p>
28a0: 54 6f 20 73 74 6f 70 20 75 73 69 6e 67 20 74 68 To stop using th
28b0: 65 20 70 72 6f 78 79 2c 20 64 6f 3a 3c 2f 70 3e e proxy, do:</p>
28c0: 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 .. <blockquot
28d0: 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c e>. <b>fossil
28e0: 20 73 65 74 74 69 6e 67 20 70 72 6f 78 79 20 6f setting proxy o
28f0: 66 66 3c 2f 62 3e 0a 20 20 20 20 3c 2f 62 6c 6f ff</b>. </blo
2900: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 ckquote>.. <p
2910: 3e 4f 72 20 75 6e 73 65 74 20 74 68 65 20 65 6e >Or unset the en
2920: 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 vironment variab
2930: 6c 65 2e 20 20 54 68 65 20 66 6f 73 73 69 6c 20 le. The fossil
2940: 73 65 74 74 69 6e 67 20 66 6f 72 20 74 68 65 0a setting for the.
2950: 20 20 20 20 48 54 54 50 20 70 72 6f 78 79 20 74 HTTP proxy t
2960: 61 6b 65 73 20 70 72 65 63 65 64 65 6e 63 65 20 akes precedence
2970: 6f 76 65 72 20 74 68 65 20 65 6e 76 69 72 6f 6e over the environ
2980: 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20 61 6e ment variable an
2990: 64 20 74 68 65 0a 20 20 20 20 63 6f 6d 6d 61 6e d the. comman
29a0: 64 2d 6c 69 6e 65 20 6f 70 74 69 6f 6e 20 6f 76 d-line option ov
29b0: 65 72 72 69 64 65 73 20 62 6f 74 68 2e 20 20 49 errides both. I
29c0: 66 20 79 6f 75 20 68 61 76 65 20 61 6e 20 70 65 f you have an pe
29d0: 72 73 69 73 74 65 6e 74 0a 20 20 20 20 70 72 6f rsistent. pro
29e0: 78 79 20 73 65 74 74 69 6e 67 20 74 68 61 74 20 xy setting that
29f0: 79 6f 75 20 77 61 6e 74 20 74 6f 20 6f 76 65 72 you want to over
2a00: 72 69 64 65 20 66 6f 72 20 61 20 6f 6e 65 2d 74 ride for a one-t
2a10: 69 6d 65 20 73 79 6e 63 2c 20 74 68 61 74 0a 20 ime sync, that.
2a20: 20 20 20 69 73 20 65 61 73 69 6c 79 20 64 6f 6e is easily don
2a30: 65 20 6f 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 64 e on the command
2a40: 2d 6c 69 6e 65 2e 20 20 46 6f 72 20 65 78 61 6d -line. For exam
2a50: 70 6c 65 2c 20 74 6f 20 73 79 6e 63 20 77 69 74 ple, to sync wit
2a60: 68 0a 20 20 20 20 61 20 63 6f 2d 77 6f 72 6b 65 h. a co-worke
2a70: 72 73 20 72 65 70 6f 73 69 74 6f 72 79 20 6f 6e rs repository on
2a80: 20 79 6f 75 72 20 4c 41 4e 2c 20 79 6f 75 20 6d your LAN, you m
2a90: 69 67 68 74 20 74 79 70 65 3a 3c 2f 70 3e 20 20 ight type:</p>
2aa0: 20 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f .. <blockquo
2ab0: 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 te>. <b>fossi
2ac0: 6c 20 73 79 6e 63 20 68 74 74 70 3a 2f 2f 31 39 l sync http://19
2ad0: 32 2e 31 36 38 2e 31 2e 33 36 3a 38 30 38 30 2f 2.168.1.36:8080/
2ae0: 20 2d 2d 70 72 6f 78 79 20 6f 66 66 3c 2f 62 3e --proxy off</b>
2af0: 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 . </blockquot
2b00: 65 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 e>..</blockquote
2b10: 3e 3c 68 32 3e 4d 6f 72 65 20 48 69 6e 74 73 3c ><h2>More Hints<
2b20: 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e /h2><blockquote>
2b30: 0a 0a 20 20 20 20 3c 70 3e 54 72 79 20 74 68 65 .. <p>Try the
2b40: 73 65 20 63 6f 6d 6d 61 6e 64 73 3a 3c 2f 70 3e se commands:</p>
2b50: 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 .. <blockquot
2b60: 65 3e 3c 62 3e 0a 20 20 20 20 66 6f 73 73 69 6c e><b>. fossil
2b70: 20 68 65 6c 70 3c 62 72 3e 0a 20 20 20 20 66 6f help<br>. fo
2b80: 73 73 69 6c 20 74 65 73 74 2d 63 6f 6d 6d 61 6e ssil test-comman
2b90: 64 73 0a 20 20 20 20 3c 2f 62 3e 3c 2f 62 6c 6f ds. </b></blo
2ba0: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 ckquote>.. <p
2bb0: 3e 45 78 70 6c 6f 72 65 20 61 6e 64 20 68 61 76 >Explore and hav
2bc0: 65 20 66 75 6e 21 3c 2f 70 3e 0a 0a 0a 3c 2f 62 e fun!</p>...</b
2bd0: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 2f 6e 6f 77 lockquote>.</now
2be0: 69 6b 69 3e 0a iki>.