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 65 73 >fossil branches
1110: 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 20 3c 2f 62 </b><br>. </b
1120: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 2f 62 6c lockquote>..</bl
1130: 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 4d 61 6b ockquote><h2>Mak
1140: 69 6e 67 20 43 68 61 6e 67 65 73 3c 2f 68 32 3e ing Changes</h2>
1150: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 <blockquote>..
1160: 20 20 3c 70 3e 54 6f 20 61 64 64 20 6e 65 77 20 <p>To add new
1170: 66 69 6c 65 73 20 74 6f 20 79 6f 75 72 20 70 72 files to your pr
1180: 6f 6a 65 63 74 2c 20 6f 72 20 72 65 6d 6f 76 65 oject, or remove
1190: 20 6f 6c 64 20 66 69 6c 65 73 2c 20 75 73 65 20 old files, use
11a0: 74 68 65 73 65 0a 20 20 20 20 63 6f 6d 6d 61 6e these. comman
11b0: 64 73 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c ds:</p>.. <bl
11c0: 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 ockquote>. <b
11d0: 3e 66 6f 73 73 69 6c 20 61 64 64 3c 2f 62 3e 20 >fossil add</b>
11e0: 3c 69 3e 66 69 6c 65 2e 2e 2e 3c 2f 69 3e 3c 62 <i>file...</i><b
11f0: 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c r>. <b>fossil
1200: 20 72 6d 3c 2f 62 3e 20 3c 69 3e 66 69 6c 65 2e rm</b> <i>file.
1210: 2e 2e 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f ..</i>. </blo
1220: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 ckquote>.. <p
1230: 3e 59 6f 75 20 63 61 6e 20 61 6c 73 6f 20 65 64 >You can also ed
1240: 69 74 20 66 69 6c 65 73 20 66 72 65 65 6c 79 2e it files freely.
1250: 20 20 4f 6e 63 65 20 79 6f 75 20 61 72 65 20 72 Once you are r
1260: 65 61 64 79 20 74 6f 20 63 6f 6d 6d 69 74 0a 20 eady to commit.
1270: 20 20 20 79 6f 75 72 20 63 68 61 6e 67 65 73 2c your changes,
1280: 20 74 79 70 65 3a 3c 2f 70 3e 0a 0a 20 20 20 20 type:</p>..
1290: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 <blockquote>.
12a0: 20 3c 62 3e 66 6f 73 73 69 6c 20 63 6f 6d 6d 69 <b>fossil commi
12b0: 74 3c 2f 62 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 t</b>. </bloc
12c0: 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e kquote>.. <p>
12d0: 59 6f 75 20 77 69 6c 6c 20 62 65 20 70 72 6f 6d You will be prom
12e0: 70 74 65 64 20 66 6f 72 20 63 68 65 63 6b 2d 69 pted for check-i
12f0: 6e 20 63 6f 6d 6d 65 6e 74 73 20 75 73 69 6e 67 n comments using
1300: 20 77 68 61 74 65 76 65 72 20 65 64 69 74 6f 72 whatever editor
1310: 0a 20 20 20 20 69 73 20 73 70 65 63 69 66 69 65 . is specifie
1320: 64 20 62 79 20 79 6f 75 72 20 56 49 53 55 41 4c d by your VISUAL
1330: 20 6f 72 20 45 44 49 54 4f 52 20 65 6e 76 69 72 or EDITOR envir
1340: 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 2e onment variable.
1350: 20 20 49 66 20 79 6f 75 0a 20 20 20 20 68 61 76 If you. hav
1360: 65 20 47 50 47 20 69 6e 73 74 61 6c 6c 65 64 2c e GPG installed,
1370: 20 79 6f 75 20 6d 61 79 20 62 65 20 70 72 6f 6d you may be prom
1380: 70 74 65 64 20 66 6f 72 20 79 6f 75 72 20 47 50 pted for your GP
1390: 47 20 70 61 73 73 70 68 72 61 73 65 20 73 6f 0a G passphrase so.
13a0: 20 20 20 20 74 68 61 74 20 74 68 65 20 63 68 65 that the che
13b0: 63 6b 2d 69 6e 20 63 61 6e 20 62 65 20 73 69 67 ck-in can be sig
13c0: 6e 65 64 20 77 69 74 68 20 79 6f 75 72 20 47 50 ned with your GP
13d0: 47 20 73 69 67 6e 61 74 75 72 65 2e 20 20 41 66 G signature. Af
13e0: 74 65 72 0a 20 20 20 20 74 68 69 73 20 79 6f 75 ter. this you
13f0: 72 20 63 68 61 6e 67 65 73 20 77 69 6c 6c 20 62 r changes will b
1400: 65 20 63 68 65 63 6b 65 64 20 69 6e 2e 3c 2f 70 e checked in.</p
1410: 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e >..</blockquote>
1420: 3c 68 32 3e 53 68 61 72 69 6e 67 20 43 68 61 6e <h2>Sharing Chan
1430: 67 65 73 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 ges</h2><blockqu
1440: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 ote>.. <p>The
1450: 20 63 68 61 6e 67 65 73 20 79 6f 75 20 3c 62 3e changes you <b>
1460: 63 6f 6d 6d 69 74 3c 2f 62 3e 20 61 72 65 20 6f commit</b> are o
1470: 6e 6c 79 20 6f 6e 20 79 6f 75 72 20 6c 6f 63 61 nly on your loca
1480: 6c 20 72 65 70 6f 73 69 74 6f 72 79 2e 0a 20 20 l repository..
1490: 20 20 54 6f 20 73 68 61 72 65 20 74 68 6f 73 65 To share those
14a0: 20 63 68 61 6e 67 65 73 20 77 69 74 68 20 6f 74 changes with ot
14b0: 68 65 72 20 72 65 70 6f 73 69 74 6f 72 69 65 73 her repositories
14c0: 2c 20 64 6f 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c , do:</p>.. <
14d0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 blockquote>.
14e0: 3c 62 3e 66 6f 73 73 69 6c 20 70 75 73 68 3c 2f <b>fossil push</
14f0: 62 3e 20 3c 69 3e 55 52 4c 3c 2f 69 3e 0a 20 20 b> <i>URL</i>.
1500: 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a </blockquote>.
1510: 0a 20 20 20 20 3c 70 3e 57 68 65 72 65 20 3c 69 . <p>Where <i
1520: 3e 55 52 4c 3c 2f 69 3e 20 69 73 20 74 68 65 20 >URL</i> is the
1530: 68 74 74 70 3a 20 55 52 4c 20 6f 66 20 74 68 65 http: URL of the
1540: 20 73 65 72 76 65 72 20 72 65 70 6f 73 69 74 6f server reposito
1550: 72 79 20 79 6f 75 0a 20 20 20 20 77 61 6e 74 20 ry you. want
1560: 74 6f 20 73 68 61 72 65 20 79 6f 75 72 20 63 68 to share your ch
1570: 61 6e 67 65 73 20 77 69 74 68 2e 20 20 49 66 20 anges with. If
1580: 79 6f 75 20 6f 6d 69 74 20 74 68 65 20 3c 69 3e you omit the <i>
1590: 55 52 4c 3c 2f 69 3e 20 61 72 67 75 6d 65 6e 74 URL</i> argument
15a0: 2c 0a 20 20 20 20 66 6f 73 73 69 6c 20 77 69 6c ,. fossil wil
15b0: 6c 20 75 73 65 20 77 68 61 74 65 76 65 72 20 73 l use whatever s
15c0: 65 72 76 65 72 20 79 6f 75 20 6d 6f 73 74 20 72 erver you most r
15d0: 65 63 65 6e 74 6c 79 20 73 79 6e 63 65 64 20 77 ecently synced w
15e0: 69 74 68 2e 3c 2f 70 3e 0a 0a 20 20 20 20 3c 70 ith.</p>.. <p
15f0: 3e 54 68 65 20 3c 62 3e 70 75 73 68 3c 2f 62 3e >The <b>push</b>
1600: 20 63 6f 6d 6d 61 6e 64 20 6f 6e 6c 79 20 73 65 command only se
1610: 6e 64 73 20 79 6f 75 72 20 63 68 61 6e 67 65 73 nds your changes
1620: 20 74 6f 20 6f 74 68 65 72 73 2e 20 20 54 6f 0a to others. To.
1630: 20 20 20 20 52 65 63 65 69 76 65 20 63 68 61 6e Receive chan
1640: 67 65 73 20 66 72 6f 6d 20 6f 74 68 65 72 73 2c ges from others,
1650: 20 75 73 65 20 3c 62 3e 70 75 6c 6c 3c 2f 62 3e use <b>pull</b>
1660: 2e 20 20 4f 72 20 67 6f 20 62 6f 74 68 20 77 61 . Or go both wa
1670: 79 73 20 61 74 0a 20 20 20 20 6f 6e 63 65 20 75 ys at. once u
1680: 73 69 6e 67 20 3c 62 3e 73 79 6e 63 3c 2f 62 3e sing <b>sync</b>
1690: 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 :</p>.. <bloc
16a0: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 kquote>. <b>f
16b0: 6f 73 73 69 6c 20 70 75 6c 6c 3c 2f 62 3e 20 3c ossil pull</b> <
16c0: 69 3e 55 52 4c 3c 2f 69 3e 3c 62 72 3e 0a 20 20 i>URL</i><br>.
16d0: 20 20 3c 62 3e 66 6f 73 73 69 6c 20 73 79 6e 63 <b>fossil sync
16e0: 3c 2f 62 3e 20 3c 69 3e 55 52 4c 3c 2f 69 3e 0a </b> <i>URL</i>.
16f0: 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 </blockquote
1700: 3e 0a 0a 20 20 20 20 3c 70 3e 57 68 65 6e 20 79 >.. <p>When y
1710: 6f 75 20 70 75 6c 6c 20 69 6e 20 63 68 61 6e 67 ou pull in chang
1720: 65 73 20 66 72 6f 6d 20 6f 74 68 65 72 73 2c 20 es from others,
1730: 74 68 65 79 20 67 6f 20 69 6e 74 6f 20 79 6f 75 they go into you
1740: 72 20 72 65 70 6f 73 69 74 6f 72 79 2c 0a 20 20 r repository,.
1750: 20 20 6e 6f 74 20 69 6e 74 6f 20 79 6f 75 72 20 not into your
1760: 63 68 65 63 6b 65 64 2d 6f 75 74 20 6c 6f 63 61 checked-out loca
1770: 6c 20 74 72 65 65 2e 20 20 54 6f 20 67 65 74 20 l tree. To get
1780: 74 68 65 20 63 68 61 6e 67 65 73 20 69 6e 74 6f the changes into
1790: 20 79 6f 75 72 0a 20 20 20 20 6c 6f 63 61 6c 20 your. local
17a0: 74 72 65 65 2c 20 75 73 65 20 3c 62 3e 75 70 64 tree, use <b>upd
17b0: 61 74 65 3c 2f 62 3e 3a 3c 2f 70 3e 0a 0a 20 20 ate</b>:</p>..
17c0: 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 <blockquote>.
17d0: 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 75 70 64 <b>fossil upd
17e0: 61 74 65 3c 2f 62 3e 20 3c 69 3e 41 49 44 3c 2f ate</b> <i>AID</
17f0: 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 i>. </blockqu
1800: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 ote>.. <p>The
1810: 20 3c 69 3e 41 49 44 3c 2f 69 3e 20 69 73 20 73 <i>AID</i> is s
1820: 6f 6d 65 20 75 6e 69 71 75 65 20 61 62 62 72 65 ome unique abbre
1830: 76 69 61 74 69 6f 6e 20 74 6f 20 74 68 65 20 34 viation to the 4
1840: 30 2d 63 68 61 72 61 63 74 65 72 0a 20 20 20 20 0-character.
1850: 61 72 74 69 66 61 63 74 20 69 64 65 6e 74 69 66 artifact identif
1860: 69 65 72 20 28 41 49 44 29 20 66 6f 72 20 61 20 ier (AID) for a
1870: 70 61 72 74 69 63 75 6c 61 72 20 63 68 65 63 6b particular check
1880: 2d 69 6e 2e 20 20 49 66 20 79 6f 75 20 6f 6d 69 -in. If you omi
1890: 74 0a 20 20 20 20 74 68 65 20 3c 69 3e 41 49 44 t. the <i>AID
18a0: 3c 2f 69 3e 20 66 6f 73 73 69 6c 20 6d 6f 76 65 </i> fossil move
18b0: 73 20 79 6f 75 20 74 6f 20 74 68 65 0a 20 20 20 s you to the.
18c0: 20 6c 65 61 66 20 76 65 72 73 69 6f 6e 20 6f 66 leaf version of
18d0: 20 74 68 65 20 62 72 61 6e 63 68 20 79 6f 75 72 the branch your
18e0: 20 61 72 65 20 63 75 72 72 65 6e 74 6c 79 20 6f are currently o
18f0: 6e 2e 20 20 49 66 20 79 6f 75 72 20 62 72 61 6e n. If your bran
1900: 63 68 0a 20 20 20 20 68 61 73 20 6d 75 6c 74 69 ch. has multi
1910: 70 6c 65 20 6c 65 61 76 65 73 2c 20 79 6f 75 20 ple leaves, you
1920: 67 65 74 20 61 6e 20 65 72 72 6f 72 20 2d 20 79 get an error - y
1930: 6f 75 27 6c 6c 20 68 61 76 65 20 74 6f 20 73 70 ou'll have to sp
1940: 65 63 69 66 79 20 74 68 65 0a 20 20 20 20 6c 65 ecify the. le
1950: 61 66 20 79 6f 75 20 77 61 6e 74 20 75 73 69 6e af you want usin
1960: 67 20 61 20 3c 69 3e 41 49 44 3c 2f 69 3e 20 61 g a <i>AID</i> a
1970: 72 67 75 6d 65 6e 74 2e 3c 2f 70 3e 0a 0a 3c 2f rgument.</p>..</
1980: 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 42 blockquote><h2>B
1990: 72 61 6e 63 68 69 6e 67 20 41 6e 64 20 4d 65 72 ranching And Mer
19a0: 67 69 6e 67 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 ging</h2><blockq
19b0: 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 59 6f uote>.. <p>Yo
19c0: 75 20 63 61 6e 20 63 72 65 61 74 65 20 62 72 61 u can create bra
19d0: 6e 63 68 65 73 20 62 79 20 64 6f 69 6e 67 20 6d nches by doing m
19e0: 75 6c 74 69 70 6c 65 20 63 6f 6d 6d 69 74 73 20 ultiple commits
19f0: 6f 66 66 20 6f 66 20 74 68 65 0a 20 20 20 20 73 off of the. s
1a00: 61 6d 65 20 62 61 73 65 20 76 65 72 73 69 6f 6e ame base version
1a10: 2e 20 20 54 6f 20 6d 65 72 67 65 20 74 6f 20 62 . To merge to b
1a20: 72 61 6e 63 68 65 73 20 62 61 63 6b 20 74 6f 67 ranches back tog
1a30: 65 74 68 65 72 2c 20 66 69 72 73 74 0a 20 20 20 ether, first.
1a40: 20 3c 62 3e 75 70 64 61 74 65 3c 2f 62 3e 20 74 <b>update</b> t
1a50: 6f 20 74 68 65 20 6c 65 61 66 20 6f 66 20 6f 6e o the leaf of on
1a60: 65 20 62 72 61 6e 63 68 2e 20 20 54 68 65 6e 20 e branch. Then
1a70: 64 6f 20 61 20 3c 62 3e 6d 65 72 67 65 3c 2f 62 do a <b>merge</b
1a80: 3e 0a 20 20 20 20 6f 66 20 74 68 65 20 6c 65 61 >. of the lea
1a90: 66 20 6f 66 20 74 68 65 20 6f 74 68 65 72 20 62 f of the other b
1aa0: 72 61 6e 63 68 3a 3c 2f 70 3e 0a 0a 20 20 20 20 ranch:</p>..
1ab0: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 <blockquote>.
1ac0: 20 3c 62 3e 66 6f 73 73 69 6c 20 6d 65 72 67 65 <b>fossil merge
1ad0: 3c 2f 62 3e 20 3c 69 3e 41 49 44 3c 2f 69 3e 0a </b> <i>AID</i>.
1ae0: 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 </blockquote
1af0: 3e 0a 0a 20 20 20 20 3c 70 3e 54 65 73 74 20 74 >.. <p>Test t
1b00: 6f 20 6d 61 6b 65 20 73 75 72 65 20 79 6f 75 72 o make sure your
1b10: 20 6d 65 72 67 65 20 64 69 64 6e 27 74 20 6d 65 merge didn't me
1b20: 73 73 20 75 70 20 74 68 65 20 63 6f 64 65 2c 20 ss up the code,
1b30: 74 68 65 6e 0a 20 20 20 20 3c 62 3e 63 6f 6d 6d then. <b>comm
1b40: 69 74 3c 2f 62 3e 20 61 6e 64 20 70 6f 73 73 69 it</b> and possi
1b50: 62 6c 79 20 61 6c 73 6f 20 3c 62 3e 70 75 73 68 bly also <b>push
1b60: 3c 2f 62 3e 20 79 6f 75 72 20 63 68 61 6e 67 65 </b> your change
1b70: 73 2e 20 20 20 52 65 6d 65 6d 62 65 72 0a 20 20 s. Remember.
1b80: 20 20 74 68 61 74 20 6e 6f 62 6f 64 79 20 65 6c that nobody el
1b90: 73 65 20 63 61 6e 20 73 65 65 20 79 6f 75 72 20 se can see your
1ba0: 63 68 61 6e 67 65 73 20 75 6e 74 69 6c 20 79 6f changes until yo
1bb0: 75 20 3c 62 3e 63 6f 6d 6d 69 74 3c 2f 62 3e 20 u <b>commit</b>
1bc0: 61 6e 64 0a 20 20 20 20 69 66 20 6f 74 68 65 72 and. if other
1bd0: 20 61 72 65 20 75 73 69 6e 67 20 61 20 64 69 66 are using a dif
1be0: 66 65 72 65 6e 74 20 72 65 70 6f 73 69 74 6f 72 ferent repositor
1bf0: 79 20 79 6f 75 20 77 69 6c 6c 20 61 6c 73 6f 20 y you will also
1c00: 6e 65 65 64 20 74 6f 0a 20 20 20 20 3c 62 3e 70 need to. <b>p
1c10: 75 73 68 3c 2f 62 3e 2e 3c 2f 70 3e 0a 0a 3c 61 ush</b>.</p>..<a
1c20: 20 6e 61 6d 65 3d 22 73 65 72 76 65 72 73 65 74 name="serverset
1c30: 75 70 22 3e 3c 2f 61 3e 0a 3c 2f 62 6c 6f 63 6b up"></a>.</block
1c40: 71 75 6f 74 65 3e 3c 68 32 3e 53 65 74 74 69 6e quote><h2>Settin
1c50: 67 20 55 70 20 41 20 53 65 72 76 65 72 3c 2f 68 g Up A Server</h
1c60: 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 2><blockquote>..
1c70: 20 20 20 20 3c 70 3e 54 68 65 20 65 61 73 69 65 <p>The easie
1c80: 73 74 20 77 61 79 20 74 6f 20 73 65 74 20 75 70 st way to set up
1c90: 20 61 20 73 65 72 76 65 72 20 69 73 3a 3c 2f 70 a server is:</p
1ca0: 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f >.. <blockquo
1cb0: 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 te>. <b>fossi
1cc0: 6c 20 73 65 72 76 65 72 3c 2f 62 3e 20 3c 69 3e l server</b> <i>
1cd0: 72 65 70 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e repository-filen
1ce0: 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c ame</i>. </bl
1cf0: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c ockquote>.. <
1d00: 70 3e 4f 72 3c 2f 62 3e 0a 0a 20 20 20 20 3c 62 p>Or</b>.. <b
1d10: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c lockquote>. <
1d20: 62 3e 66 6f 73 73 69 6c 20 75 69 3c 2f 62 3e 20 b>fossil ui</b>
1d30: 3c 69 3e 72 65 70 6f 73 69 74 6f 72 79 2d 66 69 <i>repository-fi
1d40: 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c lename</i>. <
1d50: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 /blockquote>..
1d60: 20 20 3c 70 3e 54 68 65 20 64 69 66 66 65 72 65 <p>The differe
1d70: 6e 63 65 20 62 65 74 77 65 65 6e 20 74 68 65 73 nce between thes
1d80: 65 20 74 77 6f 20 63 6f 6d 6d 61 6e 64 20 69 73 e two command is
1d90: 20 74 68 61 74 20 3c 62 3e 75 69 3c 2f 62 3e 0a that <b>ui</b>.
1da0: 20 20 20 20 61 74 74 65 6d 70 74 73 20 74 6f 20 attempts to
1db0: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 73 74 automatically st
1dc0: 61 72 74 20 79 6f 75 72 20 77 65 62 20 62 72 6f art your web bro
1dd0: 77 73 65 72 20 70 6f 69 6e 74 69 6e 67 20 61 74 wser pointing at
1de0: 20 74 68 65 0a 20 20 20 20 73 65 72 76 65 72 20 the. server
1df0: 77 68 65 72 65 61 73 20 3c 62 3e 73 65 72 76 65 whereas <b>serve
1e00: 72 3c 2f 62 3e 20 64 6f 65 73 20 6e 6f 74 2e 0a r</b> does not..
1e10: 20 20 20 20 59 6f 75 20 63 61 6e 20 6f 6d 69 74 You can omit
1e20: 20 74 68 65 20 3c 69 3e 72 65 70 6f 73 69 74 6f the <i>reposito
1e30: 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 20 ry-filename</i>
1e40: 69 66 20 79 6f 75 20 61 72 65 20 77 69 74 68 69 if you are withi
1e50: 6e 0a 20 20 20 20 61 20 63 68 65 63 6b 65 64 2d n. a checked-
1e60: 6f 75 74 20 6c 6f 63 61 6c 20 74 72 65 65 2e 20 out local tree.
1e70: 20 54 68 69 73 20 73 65 72 76 65 72 20 75 73 65 This server use
1e80: 73 20 70 6f 72 74 20 38 30 38 30 20 62 79 20 64 s port 8080 by d
1e90: 65 66 61 75 6c 74 0a 20 20 20 20 62 75 74 20 79 efault. but y
1ea0: 6f 75 20 63 61 6e 20 73 70 65 63 69 66 79 20 61 ou can specify a
1eb0: 20 64 69 66 66 65 72 65 6e 74 20 70 6f 72 74 20 different port
1ec0: 75 73 69 6e 67 20 74 68 65 20 3c 62 3e 2d 70 6f using the <b>-po
1ed0: 72 74 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 2e 3c rt</b> command.<
1ee0: 2f 70 3e 0a 0a 20 20 20 20 3c 70 3e 43 6f 6d 6d /p>.. <p>Comm
1ef0: 61 6e 64 2d 6c 69 6e 65 20 73 65 72 76 65 72 73 and-line servers
1f00: 20 6c 69 6b 65 20 74 68 69 73 20 61 72 65 20 75 like this are u
1f10: 73 65 66 75 6c 20 77 68 65 6e 20 74 77 6f 20 70 seful when two p
1f20: 65 6f 70 6c 65 20 77 61 6e 74 0a 20 20 20 20 74 eople want. t
1f30: 6f 20 73 68 61 72 65 20 61 20 72 65 70 6f 73 69 o share a reposi
1f40: 74 6f 72 79 20 6f 6e 20 74 65 6d 70 6f 72 61 72 tory on temporar
1f50: 79 20 6f 72 20 61 64 2d 68 6f 63 20 62 61 73 69 y or ad-hoc basi
1f60: 73 2e 20 20 46 6f 72 20 61 20 6d 6f 72 65 0a 20 s. For a more.
1f70: 20 20 20 70 65 72 6d 61 6e 65 6e 74 20 69 6e 73 permanent ins
1f80: 74 61 6c 6c 61 74 69 6f 6e 2c 20 79 6f 75 20 73 tallation, you s
1f90: 68 6f 75 6c 64 20 75 73 65 20 65 69 74 68 65 72 hould use either
1fa0: 20 74 68 65 20 43 47 49 20 73 65 72 76 65 72 20 the CGI server
1fb0: 6f 72 20 74 68 65 0a 20 20 20 20 69 6e 65 74 64 or the. inetd
1fc0: 20 73 65 72 76 65 72 2e 0a 20 20 20 20 3c 61 20 server.. <a
1fd0: 6e 61 6d 65 3d 22 63 67 69 73 65 72 76 65 72 22 name="cgiserver"
1fe0: 3e 3c 2f 61 3e 0a 20 20 20 20 54 6f 20 75 73 65 ></a>. To use
1ff0: 20 74 68 65 20 43 47 49 20 73 65 72 76 65 72 2c the CGI server,
2000: 20 63 72 65 61 74 65 20 61 20 43 47 49 20 73 63 create a CGI sc
2010: 72 69 70 74 20 74 68 61 74 0a 20 20 20 20 6c 6f ript that. lo
2020: 6f 6b 73 20 73 6f 6d 65 74 68 69 6e 67 20 6c 69 oks something li
2030: 6b 65 20 74 68 69 73 3a 3c 2f 70 3e 0a 0a 20 20 ke this:</p>..
2040: 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 62 <blockquote><b
2050: 3e 0a 20 20 20 20 23 21 2f 75 73 72 2f 6c 6f 63 >. #!/usr/loc
2060: 61 6c 2f 62 69 6e 2f 66 6f 73 73 69 6c 3c 62 72 al/bin/fossil<br
2070: 3e 0a 20 20 20 20 72 65 70 6f 73 69 74 6f 72 79 >. repository
2080: 3a 20 2f 68 6f 6d 65 2f 70 72 6f 6a 31 2f 72 65 : /home/proj1/re
2090: 70 6f 73 31 2e 66 6f 73 73 69 6c 0a 20 20 20 20 pos1.fossil.
20a0: 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 </b></blockquote
20b0: 3e 0a 0a 20 20 20 20 3c 70 3e 41 64 6a 75 73 74 >.. <p>Adjust
20c0: 20 74 68 65 20 70 61 74 68 73 20 69 6e 20 74 68 the paths in th
20d0: 69 73 20 43 47 49 20 73 63 72 69 70 74 20 74 6f is CGI script to
20e0: 20 6d 61 74 63 68 20 79 6f 75 72 20 69 6e 73 74 match your inst
20f0: 61 6c 6c 61 74 69 6f 6e 0a 20 20 20 20 61 6e 64 allation. and
2100: 20 6d 61 6b 65 20 73 75 72 65 20 74 68 61 74 20 make sure that
2110: 72 65 70 6f 73 69 74 6f 72 79 20 66 69 6c 65 20 repository file
2120: 61 74 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 at the directory
2130: 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 69 that contains i
2140: 74 0a 20 20 20 20 61 72 65 20 62 6f 74 68 20 72 t. are both r
2150: 65 61 64 61 62 6c 65 20 61 6e 64 20 77 72 69 74 eadable and writ
2160: 61 62 6c 65 20 62 79 20 74 68 65 20 75 73 65 72 able by the user
2170: 20 74 68 61 74 20 43 47 49 20 73 63 72 69 70 74 that CGI script
2180: 73 20 72 75 6e 20 61 73 2e 0a 20 20 20 20 54 68 s run as.. Th
2190: 65 6e 20 70 6f 69 6e 74 20 63 6c 69 65 6e 74 73 en point clients
21a0: 20 61 74 20 74 68 65 20 43 47 49 20 73 63 72 69 at the CGI scri
21b0: 70 74 2e 20 20 54 68 61 74 27 73 20 61 6c 6c 20 pt. That's all
21c0: 74 68 65 72 65 20 69 73 20 74 6f 20 69 74 21 3c there is to it!<
21d0: 2f 70 3e 0a 0a 20 20 20 20 3c 61 20 6e 61 6d 65 /p>.. <a name
21e0: 3d 22 69 6e 65 74 64 73 65 72 76 65 72 22 3e 3c ="inetdserver"><
21f0: 2f 61 3e 0a 20 20 20 20 3c 70 3e 59 6f 75 20 63 /a>. <p>You c
2200: 61 6e 20 61 6c 73 6f 20 72 75 6e 20 66 6f 73 73 an also run foss
2210: 69 6c 20 6f 66 66 20 6f 66 20 69 6e 65 74 64 20 il off of inetd
2220: 6f 72 20 78 69 6e 65 74 64 2e 20 20 46 6f 72 20 or xinetd. For
2230: 61 6e 20 69 6e 65 74 64 0a 20 20 20 20 69 6e 73 an inetd. ins
2240: 74 61 6c 6c 61 74 69 6f 6e 2c 20 6d 61 6b 65 20 tallation, make
2250: 61 6e 20 65 6e 74 72 79 20 69 6e 20 2f 65 74 63 an entry in /etc
2260: 2f 69 6e 65 74 64 2e 63 6f 6e 66 20 74 68 61 74 /inetd.conf that
2270: 20 6c 6f 6f 6b 73 20 73 6f 6d 65 74 68 69 6e 67 looks something
2280: 0a 20 20 20 20 6c 69 6b 65 20 74 68 69 73 3a 3c . like this:<
2290: 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 /p>.. <blockq
22a0: 75 6f 74 65 3e 3c 62 3e 0a 20 20 20 20 38 30 20 uote><b>. 80
22b0: 73 74 72 65 61 6d 20 74 63 70 20 6e 6f 77 61 69 stream tcp nowai
22c0: 74 2e 31 30 30 30 20 72 6f 6f 74 20 2f 75 73 72 t.1000 root /usr
22d0: 2f 62 69 6e 2f 66 6f 73 73 69 6c 20 5c 3c 62 72 /bin/fossil \<br
22e0: 3e 0a 20 20 20 20 20 20 20 20 2f 75 73 72 2f 62 >. /usr/b
22f0: 69 6e 2f 66 6f 73 73 69 6c 20 68 74 74 70 20 2f in/fossil http /
2300: 68 6f 6d 65 2f 70 72 6f 6a 31 2f 72 65 70 6f 73 home/proj1/repos
2310: 31 2e 66 6f 73 73 69 6c 0a 20 20 20 20 3c 2f 62 1.fossil. </b
2320: 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a ></blockquote>..
2330: 20 20 20 20 3c 70 3e 41 64 6a 75 73 74 20 74 68 <p>Adjust th
2340: 65 20 70 61 74 68 73 20 74 6f 20 73 75 69 74 20 e paths to suit
2350: 79 6f 75 72 20 69 6e 73 74 61 6c 6c 61 74 69 6f your installatio
2360: 6e 2c 20 6f 66 20 63 6f 75 72 73 65 2e 20 20 4e n, of course. N
2370: 6f 74 69 63 65 20 74 68 61 74 0a 20 20 20 20 66 otice that. f
2380: 6f 73 73 69 6c 20 72 75 6e 73 20 61 73 20 72 6f ossil runs as ro
2390: 6f 74 2e 20 20 54 68 69 73 20 69 73 20 6e 6f 74 ot. This is not
23a0: 20 72 65 71 75 69 72 65 64 20 2d 20 79 6f 75 20 required - you
23b0: 63 61 6e 20 72 75 6e 20 69 74 20 61 73 20 61 6e can run it as an
23c0: 0a 20 20 20 20 75 6e 70 72 69 76 69 6c 65 67 65 . unprivilege
23d0: 64 20 75 73 65 72 2e 20 20 42 75 74 20 69 74 20 d user. But it
23e0: 69 73 20 6d 6f 72 65 20 73 65 63 75 72 65 20 74 is more secure t
23f0: 6f 20 72 75 6e 20 66 6f 73 73 69 6c 20 61 73 20 o run fossil as
2400: 72 6f 6f 74 2e 0a 20 20 20 20 57 68 65 6e 20 79 root.. When y
2410: 6f 75 20 64 6f 20 72 75 6e 20 66 6f 73 73 69 6c ou do run fossil
2420: 20 61 73 20 72 6f 6f 74 2c 20 69 74 20 61 75 74 as root, it aut
2430: 6f 6d 61 74 69 63 61 6c 6c 79 20 70 75 74 73 20 omatically puts
2440: 69 74 73 65 6c 66 20 69 6e 20 61 0a 20 20 20 20 itself in a.
2450: 63 68 72 6f 6f 74 20 6a 61 69 6c 20 69 6e 20 74 chroot jail in t
2460: 68 65 20 73 61 6d 65 20 64 69 72 65 63 74 6f 72 he same director
2470: 79 20 61 73 20 74 68 65 20 72 65 70 6f 73 69 74 y as the reposit
2480: 6f 72 79 2c 20 74 68 65 6e 20 64 72 6f 70 73 0a ory, then drops.
2490: 20 20 20 20 72 6f 6f 74 20 70 72 69 76 69 6c 65 root privile
24a0: 67 65 73 20 70 72 69 6f 72 20 74 6f 20 72 65 61 ges prior to rea
24b0: 64 69 6e 67 20 61 6e 79 20 69 6e 66 6f 72 6d 61 ding any informa
24c0: 74 69 6f 6e 20 66 72 6f 6d 20 74 68 65 20 72 65 tion from the re
24d0: 71 75 65 73 74 2e 3c 2f 70 3e 0a 0a 3c 2f 62 6c quest.</p>..</bl
24e0: 6f 63 6b 71 75 6f 74 65 3e 3c 61 20 6e 61 6d 65 ockquote><a name
24f0: 3d 22 70 72 6f 78 79 22 3e 3c 2f 61 3e 3c 68 32 ="proxy"></a><h2
2500: 3e 48 54 54 50 20 50 72 6f 78 69 65 73 3c 2f 68 >HTTP Proxies</h
2510: 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 2><blockquote>..
2520: 20 20 20 20 3c 70 3e 49 66 20 79 6f 75 20 61 72 <p>If you ar
2530: 65 20 62 65 68 69 6e 64 20 61 20 72 65 73 74 72 e behind a restr
2540: 69 63 74 69 76 65 20 66 69 72 65 77 61 6c 6c 20 ictive firewall
2550: 74 68 61 74 20 72 65 71 75 69 72 65 73 20 79 6f that requires yo
2560: 75 20 74 6f 20 75 73 65 0a 20 20 20 20 61 6e 20 u to use. an
2570: 48 54 54 50 20 70 72 6f 78 79 20 74 6f 20 72 65 HTTP proxy to re
2580: 61 63 68 20 74 68 65 20 69 6e 74 65 72 6e 65 74 ach the internet
2590: 2c 20 74 68 65 6e 20 79 6f 75 20 63 61 6e 20 63 , then you can c
25a0: 6f 6e 66 69 67 75 72 65 20 74 68 65 20 70 72 6f onfigure the pro
25b0: 78 79 0a 20 20 20 20 69 6e 20 74 68 72 65 65 20 xy. in three
25c0: 64 69 66 66 65 72 65 6e 74 20 77 61 79 73 2e 20 different ways.
25d0: 20 59 6f 75 20 63 61 6e 20 74 65 6c 6c 20 66 6f You can tell fo
25e0: 73 73 69 6c 20 61 62 6f 75 74 20 79 6f 75 72 20 ssil about your
25f0: 70 72 6f 78 79 20 75 73 69 6e 67 0a 20 20 20 20 proxy using.
2600: 61 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 6f a command-line o
2610: 70 74 69 6f 6e 20 6f 6e 20 63 6f 6d 6d 61 6e 64 ption on command
2620: 73 20 74 68 61 74 20 75 73 65 20 74 68 65 20 6e s that use the n
2630: 65 74 77 6f 72 6b 2c 0a 20 20 20 20 3c 62 3e 73 etwork,. <b>s
2640: 79 6e 63 3c 2f 62 3e 2c 20 3c 62 3e 63 6c 6f 6e ync</b>, <b>clon
2650: 65 3c 2f 62 3e 2c 20 3c 62 3e 70 75 73 68 3c 2f e</b>, <b>push</
2660: 62 3e 2c 20 61 6e 64 20 3c 62 3e 70 75 6c 6c 3c b>, and <b>pull<
2670: 2f 62 3e 2e 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 /b>.</p>.. <b
2680: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c lockquote>. <
2690: 62 3e 66 6f 73 73 69 6c 20 63 6c 6f 6e 65 20 3c b>fossil clone <
26a0: 2f 62 3e 3c 69 3e 55 52 4c 3c 2f 69 3e 20 20 3c /b><i>URL</i> <
26b0: 62 3e 2d 2d 70 72 6f 78 79 3c 2f 62 3e 20 3c 69 b>--proxy</b> <i
26c0: 3e 50 72 6f 78 79 2d 55 52 4c 3c 2f 69 3e 0a 20 >Proxy-URL</i>.
26d0: 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e </blockquote>
26e0: 0a 0a 20 20 20 20 3c 70 3e 49 74 20 69 73 20 61 .. <p>It is a
26f0: 6e 6e 6f 79 69 6e 67 20 74 6f 20 68 61 76 65 20 nnoying to have
2700: 74 6f 20 74 79 70 65 20 69 6e 20 74 68 65 20 70 to type in the p
2710: 72 6f 78 79 20 55 52 4c 20 65 76 65 72 79 20 74 roxy URL every t
2720: 69 6d 65 20 79 6f 75 0a 20 20 20 20 73 79 6e 63 ime you. sync
2730: 20 79 6f 75 72 20 70 72 6f 6a 65 63 74 2c 20 74 your project, t
2740: 68 6f 75 67 68 2c 20 73 6f 20 79 6f 75 20 63 61 hough, so you ca
2750: 6e 20 6d 61 6b 65 20 74 68 65 20 70 72 6f 78 79 n make the proxy
2760: 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 0a 20 configuration.
2770: 20 20 20 70 65 72 73 69 73 74 65 6e 74 20 75 73 persistent us
2780: 69 6e 67 20 74 68 65 20 3c 62 3e 73 65 74 74 69 ing the <b>setti
2790: 6e 67 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 3a 3c ng</b> command:<
27a0: 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 /p>.. <blockq
27b0: 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 uote>. <b>fos
27c0: 73 69 6c 20 73 65 74 74 69 6e 67 20 70 72 6f 78 sil setting prox
27d0: 79 20 3c 2f 62 3e 3c 69 3e 50 72 6f 78 79 2d 55 y </b><i>Proxy-U
27e0: 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f RL</i>. </blo
27f0: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 ckquote>.. <p
2800: 3e 4f 72 2c 20 79 6f 75 20 63 61 6e 20 73 65 74 >Or, you can set
2810: 20 74 68 65 20 22 3c 62 3e 68 74 74 70 5f 70 72 the "<b>http_pr
2820: 6f 78 79 3c 2f 62 3e 22 20 65 6e 76 69 72 6f 6e oxy</b>" environ
2830: 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 3a 3c 2f ment variable:</
2840: 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 p>.. <blockqu
2850: 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 65 78 70 6f ote>. <b>expo
2860: 72 74 20 68 74 74 70 5f 70 72 6f 78 79 3d 3c 2f rt http_proxy=</
2870: 62 3e 3c 69 3e 50 72 6f 78 79 2d 55 52 4c 3c 2f b><i>Proxy-URL</
2880: 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 i>. </blockqu
2890: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 6f 20 ote>.. <p>To
28a0: 73 74 6f 70 20 75 73 69 6e 67 20 74 68 65 20 70 stop using the p
28b0: 72 6f 78 79 2c 20 64 6f 3a 3c 2f 70 3e 0a 0a 20 roxy, do:</p>..
28c0: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a <blockquote>.
28d0: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 73 65 <b>fossil se
28e0: 74 74 69 6e 67 20 70 72 6f 78 79 20 6f 66 66 3c tting proxy off<
28f0: 2f 62 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 /b>. </blockq
2900: 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 4f 72 uote>.. <p>Or
2910: 20 75 6e 73 65 74 20 74 68 65 20 65 6e 76 69 72 unset the envir
2920: 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 2e onment variable.
2930: 20 20 54 68 65 20 66 6f 73 73 69 6c 20 73 65 74 The fossil set
2940: 74 69 6e 67 20 66 6f 72 20 74 68 65 0a 20 20 20 ting for the.
2950: 20 48 54 54 50 20 70 72 6f 78 79 20 74 61 6b 65 HTTP proxy take
2960: 73 20 70 72 65 63 65 64 65 6e 63 65 20 6f 76 65 s precedence ove
2970: 72 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e r the environmen
2980: 74 20 76 61 72 69 61 62 6c 65 20 61 6e 64 20 74 t variable and t
2990: 68 65 0a 20 20 20 20 63 6f 6d 6d 61 6e 64 2d 6c he. command-l
29a0: 69 6e 65 20 6f 70 74 69 6f 6e 20 6f 76 65 72 72 ine option overr
29b0: 69 64 65 73 20 62 6f 74 68 2e 20 20 49 66 20 79 ides both. If y
29c0: 6f 75 20 68 61 76 65 20 61 6e 20 70 65 72 73 69 ou have an persi
29d0: 73 74 65 6e 74 0a 20 20 20 20 70 72 6f 78 79 20 stent. proxy
29e0: 73 65 74 74 69 6e 67 20 74 68 61 74 20 79 6f 75 setting that you
29f0: 20 77 61 6e 74 20 74 6f 20 6f 76 65 72 72 69 64 want to overrid
2a00: 65 20 66 6f 72 20 61 20 6f 6e 65 2d 74 69 6d 65 e for a one-time
2a10: 20 73 79 6e 63 2c 20 74 68 61 74 0a 20 20 20 20 sync, that.
2a20: 69 73 20 65 61 73 69 6c 79 20 64 6f 6e 65 20 6f is easily done o
2a30: 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2d 6c 69 n the command-li
2a40: 6e 65 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 ne. For example
2a50: 2c 20 74 6f 20 73 79 6e 63 20 77 69 74 68 0a 20 , to sync with.
2a60: 20 20 20 61 20 63 6f 2d 77 6f 72 6b 65 72 73 20 a co-workers
2a70: 72 65 70 6f 73 69 74 6f 72 79 20 6f 6e 20 79 6f repository on yo
2a80: 75 72 20 4c 41 4e 2c 20 79 6f 75 20 6d 69 67 68 ur LAN, you migh
2a90: 74 20 74 79 70 65 3a 3c 2f 70 3e 20 20 20 0a 0a t type:</p> ..
2aa0: 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e <blockquote>
2ab0: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 73 . <b>fossil s
2ac0: 79 6e 63 20 68 74 74 70 3a 2f 2f 31 39 32 2e 31 ync http://192.1
2ad0: 36 38 2e 31 2e 33 36 3a 38 30 38 30 2f 20 2d 2d 68.1.36:8080/ --
2ae0: 70 72 6f 78 79 20 6f 66 66 3c 2f 62 3e 0a 20 20 proxy off</b>.
2af0: 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a </blockquote>.
2b00: 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 .</blockquote><h
2b10: 32 3e 4d 6f 72 65 20 48 69 6e 74 73 3c 2f 68 32 2>More Hints</h2
2b20: 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 ><blockquote>..
2b30: 20 20 20 3c 70 3e 54 72 79 20 74 68 65 73 65 20 <p>Try these
2b40: 63 6f 6d 6d 61 6e 64 73 3a 3c 2f 70 3e 0a 0a 20 commands:</p>..
2b50: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c <blockquote><
2b60: 62 3e 0a 20 20 20 20 66 6f 73 73 69 6c 20 68 65 b>. fossil he
2b70: 6c 70 3c 62 72 3e 0a 20 20 20 20 66 6f 73 73 69 lp<br>. fossi
2b80: 6c 20 74 65 73 74 2d 63 6f 6d 6d 61 6e 64 73 0a l test-commands.
2b90: 20 20 20 20 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 </b></blockq
2ba0: 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 45 78 uote>.. <p>Ex
2bb0: 70 6c 6f 72 65 20 61 6e 64 20 68 61 76 65 20 66 plore and have f
2bc0: 75 6e 21 3c 2f 70 3e 0a 0a 0a 3c 2f 62 6c 6f 63 un!</p>...</bloc
2bd0: 6b 71 75 6f 74 65 3e 0a 3c 2f 6e 6f 77 69 6b 69 kquote>.</nowiki
2be0: 3e 0a >.