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 20 20 20 le.</p>. .
0220: 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 </blockquote>.
0230: 20 20 20 3c 61 20 6e 61 6d 65 3d 22 23 66 73 6c <a name="#fsl
0240: 63 6c 6f 6e 65 22 3e 3c 68 32 3e 43 6c 6f 6e 69 clone"><h2>Cloni
0250: 6e 67 20 41 6e 20 45 78 69 73 74 69 6e 67 20 52 ng An Existing R
0260: 65 70 6f 73 69 74 6f 72 79 3c 2f 68 32 3e 3c 2f epository</h2></
0270: 61 3e 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f a>. <blockquo
0280: 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 4d 6f 73 74 te>.. <p>Most
0290: 20 66 6f 73 73 69 6c 20 6f 70 65 72 61 74 69 6f fossil operatio
02a0: 6e 73 20 69 6e 74 65 72 61 63 74 20 77 69 74 68 ns interact with
02b0: 20 61 20 72 65 70 6f 73 69 74 6f 72 79 20 74 68 a repository th
02c0: 61 74 20 69 73 20 6f 6e 20 74 68 65 0a 20 20 20 at is on the.
02d0: 20 6c 6f 63 61 6c 20 64 69 73 6b 20 64 72 69 76 local disk driv
02e0: 65 2c 20 6e 6f 74 20 6f 6e 20 61 20 72 65 6d 6f e, not on a remo
02f0: 74 65 20 73 79 73 74 65 6d 2e 20 20 48 65 6e 63 te system. Henc
0300: 65 2c 20 62 65 66 6f 72 65 20 61 63 63 65 73 73 e, before access
0310: 69 6e 67 0a 20 20 20 20 61 20 72 65 6d 6f 74 65 ing. a remote
0320: 20 72 65 70 6f 73 69 74 6f 72 79 20 69 74 20 69 repository it i
0330: 73 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 6d s necessary to m
0340: 61 6b 65 20 61 20 6c 6f 63 61 6c 20 63 6f 70 79 ake a local copy
0350: 20 6f 66 20 74 68 61 74 0a 20 20 20 20 72 65 70 of that. rep
0360: 6f 73 69 74 6f 72 79 2e 20 20 4d 61 6b 69 6e 67 ository. Making
0370: 20 61 20 6c 6f 63 61 6c 20 63 6f 70 79 20 6f 66 a local copy of
0380: 20 61 20 72 65 6d 6f 74 65 20 72 65 70 6f 73 69 a remote reposi
0390: 74 6f 72 79 20 69 73 20 63 61 6c 6c 65 64 0a 20 tory is called.
03a0: 20 20 20 22 63 6c 6f 6e 69 6e 67 22 2e 3c 2f 70 "cloning".</p
03b0: 3e 0a 20 20 20 20 0a 20 20 20 20 3c 70 3e 43 6c >. . <p>Cl
03c0: 6f 6e 65 20 61 20 72 65 6d 6f 74 65 20 72 65 70 one a remote rep
03d0: 6f 73 69 74 6f 72 79 20 61 73 20 66 6f 6c 6c 6f ository as follo
03e0: 77 73 3a 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 20 ws:</p>. .
03f0: 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 <blockquote>.
0400: 20 20 3c 62 3e 66 6f 73 73 69 6c 20 63 6c 6f 6e <b>fossil clon
0410: 65 3c 2f 62 3e 20 3c 69 3e 55 52 4c 20 20 72 65 e</b> <i>URL re
0420: 70 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e 61 6d pository-filenam
0430: 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 e</i>. </bloc
0440: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 0a 20 20 20 kquote>. .
0450: 20 3c 70 3e 54 68 65 20 3c 69 3e 55 52 4c 3c 2f <p>The <i>URL</
0460: 69 3e 20 61 62 6f 76 65 20 69 73 20 74 68 65 20 i> above is the
0470: 68 74 74 70 20 55 52 4c 20 66 6f 72 20 74 68 65 http URL for the
0480: 20 66 6f 73 73 69 6c 20 72 65 70 6f 73 69 74 6f fossil reposito
0490: 72 79 0a 20 20 20 20 79 6f 75 20 77 61 6e 74 20 ry. you want
04a0: 74 6f 20 63 6c 6f 6e 65 2c 20 61 6e 64 20 69 74 to clone, and it
04b0: 20 6d 61 79 20 69 6e 63 6c 75 64 65 20 61 20 22 may include a "
04c0: 75 73 65 72 3a 70 61 73 73 77 6f 72 64 22 20 70 user:password" p
04d0: 61 72 74 2c 20 65 2e 67 2e 0a 20 20 20 20 3c 74 art, e.g.. <t
04e0: 74 3e 68 74 74 70 3a 2f 2f 64 72 68 3a 73 65 63 t>http://drh:sec
04f0: 72 65 74 40 77 77 77 2e 66 6f 73 73 69 6c 2d 73 ret@www.fossil-s
0500: 63 6d 2e 6f 72 67 2f 66 6f 73 73 69 6c 3c 2f 74 cm.org/fossil</t
0510: 74 3e 2e 20 59 6f 75 20 63 61 6e 0a 20 20 20 20 t>. You can.
0520: 63 61 6c 6c 20 74 68 65 20 6e 65 77 20 72 65 70 call the new rep
0530: 6f 73 69 74 6f 72 79 20 61 6e 79 74 68 69 6e 67 ository anything
0540: 20 79 6f 75 20 77 61 6e 74 20 2d 20 74 68 65 72 you want - ther
0550: 65 20 61 72 65 20 6e 6f 20 6e 61 6d 69 6e 67 0a e are no naming.
0560: 20 20 20 20 72 65 73 74 72 69 63 74 69 6f 6e 73 restrictions
0570: 2e 20 20 41 73 20 61 6e 20 65 78 61 6d 70 6c 65 . As an example
0580: 2c 20 79 6f 75 20 63 61 6e 20 63 6c 6f 6e 65 20 , you can clone
0590: 74 68 65 20 66 6f 73 73 69 6c 20 72 65 70 6f 73 the fossil repos
05a0: 69 74 6f 72 79 0a 20 20 20 20 74 68 69 73 20 77 itory. this w
05b0: 61 79 3a 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 20 ay:</p>. .
05c0: 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 <blockquote>.
05d0: 20 20 3c 62 3e 66 6f 73 73 69 6c 20 63 6c 6f 6e <b>fossil clon
05e0: 65 20 68 74 74 70 3a 2f 2f 77 77 77 2e 66 6f 73 e http://www.fos
05f0: 73 69 6c 2d 73 63 6d 2e 6f 72 67 2f 20 6d 79 63 sil-scm.org/ myc
0600: 6c 6f 6e 65 2e 66 6f 73 73 69 6c 3c 2f 62 3e 0a lone.fossil</b>.
0610: 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 </blockquote
0620: 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 6e 65 >.. <p>The ne
0630: 77 20 6c 6f 63 61 6c 20 63 6f 70 79 20 6f 66 20 w local copy of
0640: 74 68 65 20 72 65 73 70 6f 73 69 74 6f 72 79 20 the respository
0650: 69 73 20 73 74 6f 72 65 64 20 69 6e 20 61 20 73 is stored in a s
0660: 69 6e 67 6c 65 20 66 69 6c 65 2c 0a 20 20 20 20 ingle file,.
0670: 77 68 69 63 68 20 69 6e 20 74 68 65 20 65 78 61 which in the exa
0680: 6d 70 6c 65 20 61 62 6f 76 65 20 69 73 20 6e 61 mple above is na
0690: 6d 65 64 20 22 6d 79 63 6c 6f 6e 65 2e 66 6f 73 med "myclone.fos
06a0: 73 69 6c 22 2e 0a 20 20 20 20 59 6f 75 20 63 61 sil".. You ca
06b0: 6e 20 6e 61 6d 65 20 79 6f 75 72 20 72 65 70 6f n name your repo
06c0: 73 69 74 6f 72 69 65 73 20 61 6e 79 74 68 69 6e sitories anythin
06d0: 67 20 79 6f 75 20 77 61 6e 74 2e 20 20 54 68 65 g you want. The
06e0: 20 22 2e 66 6f 73 73 69 6c 22 20 73 75 66 66 69 ".fossil" suffi
06f0: 78 0a 20 20 20 20 69 73 20 6e 6f 74 20 72 65 71 x. is not req
0700: 75 69 72 65 64 2e 3c 2f 70 3e 0a 0a 20 20 20 20 uired.</p>..
0710: 3c 70 3e 4e 6f 74 65 3a 20 49 66 20 79 6f 75 20 <p>Note: If you
0720: 61 72 65 20 62 65 68 69 6e 64 20 61 20 72 65 73 are behind a res
0730: 74 72 69 63 74 69 76 65 20 66 69 72 65 77 61 6c trictive firewal
0740: 6c 2c 20 79 6f 75 20 6d 69 67 68 74 20 6e 65 65 l, you might nee
0750: 64 0a 20 20 20 20 74 6f 20 3c 61 20 68 72 65 66 d. to <a href
0760: 3d 22 23 70 72 6f 78 79 22 3e 73 70 65 63 69 66 ="#proxy">specif
0770: 79 20 61 6e 20 48 54 54 50 20 70 72 6f 78 79 3c y an HTTP proxy<
0780: 2f 61 3e 20 74 6f 20 75 73 65 2e 3c 2f 70 3e 0a /a> to use.</p>.
0790: 20 20 20 20 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 .</blockquot
07a0: 65 3e 3c 68 32 3e 53 74 61 72 74 69 6e 67 20 41 e><h2>Starting A
07b0: 20 4e 65 77 20 50 72 6f 6a 65 63 74 3c 2f 68 32 New Project</h2
07c0: 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 ><blockquote>..
07d0: 20 20 20 3c 70 3e 54 6f 20 73 74 61 72 74 20 61 <p>To start a
07e0: 20 6e 65 77 20 70 72 6f 6a 65 63 74 20 77 69 74 new project wit
07f0: 68 20 66 6f 73 73 69 6c 2c 20 63 72 65 61 74 65 h fossil, create
0800: 20 61 20 6e 65 77 20 65 6d 70 74 79 20 72 65 70 a new empty rep
0810: 6f 73 69 74 6f 72 79 0a 20 20 20 20 74 68 69 73 ository. this
0820: 20 77 61 79 3a 3c 2f 70 3e 0a 20 20 20 20 0a 20 way:</p>. .
0830: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a <blockquote>.
0840: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6e 65 <b>fossil ne
0850: 77 20 3c 2f 62 3e 3c 69 3e 20 72 65 70 6f 73 69 w </b><i> reposi
0860: 74 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 tory-filename</i
0870: 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f >. </blockquo
0880: 74 65 3e 0a 20 20 20 20 0a 3c 2f 62 6c 6f 63 6b te>. .</block
0890: 71 75 6f 74 65 3e 3c 68 32 3e 43 6f 6e 66 69 67 quote><h2>Config
08a0: 75 72 69 6e 67 20 59 6f 75 72 20 4c 6f 63 61 6c uring Your Local
08b0: 20 52 65 70 6f 73 69 74 6f 72 79 3c 2f 68 32 3e Repository</h2>
08c0: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 <blockquote>.
08d0: 20 0a 20 20 20 20 3c 70 3e 57 68 65 6e 20 79 6f . <p>When yo
08e0: 75 20 63 72 65 61 74 65 20 61 20 6e 65 77 20 72 u create a new r
08f0: 65 70 6f 73 69 74 6f 72 79 2c 20 65 69 74 68 65 epository, eithe
0900: 72 20 62 79 20 63 6c 6f 6e 69 6e 67 20 61 6e 20 r by cloning an
0910: 65 78 69 73 74 69 6e 67 0a 20 20 20 20 70 72 6f existing. pro
0920: 6a 65 63 74 20 6f 72 20 63 72 65 61 74 65 20 61 ject or create a
0930: 20 6e 65 77 20 70 72 6f 6a 65 63 74 20 6f 66 20 new project of
0940: 79 6f 75 72 20 6f 77 6e 2c 20 79 6f 75 20 75 73 your own, you us
0950: 75 61 6c 6c 79 20 77 61 6e 74 20 74 6f 20 64 6f ually want to do
0960: 20 73 6f 6d 65 0a 20 20 20 20 6c 6f 63 61 6c 20 some. local
0970: 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 20 20 configuration.
0980: 54 68 69 73 20 69 73 20 65 61 73 69 6c 79 20 61 This is easily a
0990: 63 63 6f 6d 70 6c 69 73 68 65 64 20 75 73 69 6e ccomplished usin
09a0: 67 20 74 68 65 20 77 65 62 73 65 72 76 65 72 0a g the webserver.
09b0: 20 20 20 20 74 68 61 74 20 69 73 20 62 75 69 6c that is buil
09c0: 74 20 69 6e 74 6f 20 66 6f 73 73 69 6c 2e 20 20 t into fossil.
09d0: 53 74 61 72 74 20 74 68 65 20 66 6f 73 73 69 6c Start the fossil
09e0: 20 77 65 62 73 65 72 76 65 72 20 6c 69 6b 65 20 webserver like
09f0: 74 68 69 73 3a 3c 2f 70 3e 0a 20 20 20 20 0a 20 this:</p>. .
0a00: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a <blockquote>.
0a10: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 75 69 <b>fossil ui
0a20: 20 3c 2f 62 3e 3c 69 3e 20 72 65 70 6f 73 69 74 </b><i> reposit
0a30: 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e ory-filename</i>
0a40: 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 . </blockquot
0a50: 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 69 73 20 e>.. <p>This
0a60: 73 74 61 72 74 73 20 61 20 77 65 62 73 65 72 76 starts a webserv
0a70: 65 72 20 6c 69 73 74 65 6e 69 6e 67 20 6f 6e 20 er listening on
0a80: 70 6f 72 74 20 38 30 38 30 2e 20 20 59 6f 75 20 port 8080. You
0a90: 63 61 6e 0a 20 20 20 20 73 70 65 63 69 66 79 20 can. specify
0aa0: 61 20 64 69 66 66 65 72 65 6e 74 20 70 6f 72 74 a different port
0ab0: 20 75 73 69 6e 67 20 74 68 65 20 3c 62 3e 2d 70 using the <b>-p
0ac0: 6f 72 74 3c 2f 62 3e 20 6f 70 74 69 6f 6e 20 6f ort</b> option o
0ad0: 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2d 6c 69 n the command-li
0ae0: 6e 65 2e 0a 20 20 20 20 41 66 74 65 72 20 74 68 ne.. After th
0af0: 65 20 73 65 72 76 65 72 20 69 73 20 72 75 6e 6e e server is runn
0b00: 69 6e 67 2c 20 66 6f 73 73 69 6c 20 77 69 6c 6c ing, fossil will
0b10: 20 74 68 65 6e 20 61 74 74 65 6d 70 74 20 74 6f then attempt to
0b20: 20 6c 61 75 6e 63 68 20 79 6f 75 72 0a 20 20 20 launch your.
0b30: 20 77 65 62 20 62 72 6f 77 73 65 72 20 61 6e 64 web browser and
0b40: 20 6d 61 6b 65 20 69 74 20 70 6f 69 6e 74 20 74 make it point t
0b50: 6f 20 74 68 69 73 20 77 65 62 20 73 65 72 76 65 o this web serve
0b60: 72 2e 20 20 49 66 20 79 6f 75 72 20 73 79 73 74 r. If your syst
0b70: 65 6d 0a 20 20 20 20 68 61 73 20 61 6e 20 75 6e em. has an un
0b80: 75 73 75 61 6c 20 63 6f 6e 66 69 67 75 72 61 74 usual configurat
0b90: 69 6f 6e 2c 20 66 6f 73 73 69 6c 20 6d 69 67 68 ion, fossil migh
0ba0: 74 20 6e 6f 74 20 62 65 20 61 62 6c 65 20 74 6f t not be able to
0bb0: 20 66 69 67 75 72 65 20 6f 75 74 0a 20 20 20 20 figure out.
0bc0: 68 6f 77 20 74 6f 20 73 74 61 72 74 20 79 6f 75 how to start you
0bd0: 72 20 77 65 62 20 62 72 6f 77 73 65 72 2e 20 20 r web browser.
0be0: 49 6e 20 74 68 61 74 20 63 61 73 65 2c 20 73 74 In that case, st
0bf0: 61 72 74 20 74 68 65 20 77 65 62 20 62 72 6f 77 art the web brow
0c00: 73 65 72 0a 20 20 20 20 79 6f 75 72 73 65 6c 66 ser. yourself
0c10: 20 61 6e 64 20 70 6f 69 6e 74 20 69 74 20 61 74 and point it at
0c20: 20 68 74 74 70 3a 2f 2f 6c 6f 63 61 6c 68 6f 73 http://localhos
0c30: 74 3a 38 30 38 30 2f 2e 20 20 43 6c 69 63 6b 20 t:8080/. Click
0c40: 6f 6e 20 74 68 65 0a 20 20 20 20 22 41 64 6d 69 on the. "Admi
0c50: 6e 22 20 6c 69 6e 6b 20 6f 6e 20 74 68 65 20 6d n" link on the m
0c60: 65 6e 75 20 62 61 72 20 74 6f 20 73 74 61 72 74 enu bar to start
0c70: 20 63 6f 6e 66 69 67 75 72 69 6e 67 20 79 6f 75 configuring you
0c80: 72 20 72 65 70 6f 73 69 74 6f 72 79 2e 3c 2f 70 r repository.</p
0c90: 3e 0a 20 20 20 20 0a 20 20 20 20 3c 70 3e 42 79 >. . <p>By
0ca0: 20 64 65 66 61 75 6c 74 2c 20 66 6f 73 73 69 6c default, fossil
0cb0: 20 64 6f 65 73 20 6e 6f 74 20 72 65 71 75 69 72 does not requir
0cc0: 65 20 61 20 6c 6f 67 69 6e 20 66 6f 72 20 48 54 e a login for HT
0cd0: 54 50 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 0a 20 TP connections.
0ce0: 20 20 20 63 6f 6d 69 6e 67 20 69 6e 20 66 72 6f coming in fro
0cf0: 6d 20 74 68 65 20 49 50 20 6c 6f 6f 70 62 61 63 m the IP loopbac
0d00: 6b 20 61 64 64 72 65 73 73 20 31 32 37 2e 30 2e k address 127.0.
0d10: 30 2e 31 2e 20 20 59 6f 75 20 63 61 6e 2c 20 61 0.1. You can, a
0d20: 6e 64 20 70 65 72 68 61 70 73 0a 20 20 20 20 73 nd perhaps. s
0d30: 68 6f 75 6c 64 2c 20 63 68 61 6e 67 65 20 74 68 hould, change th
0d40: 69 73 20 61 66 74 65 72 20 79 6f 75 20 63 72 65 is after you cre
0d50: 61 74 65 20 61 20 66 65 77 20 75 73 65 72 73 2e ate a few users.
0d60: 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 20 20 3c 70 </p>. . <p
0d70: 3e 57 68 65 6e 20 79 6f 75 20 61 72 65 20 66 69 >When you are fi
0d80: 6e 69 73 68 65 64 20 63 6f 6e 66 69 67 75 72 69 nished configuri
0d90: 6e 67 2c 20 6a 75 73 74 20 70 72 65 73 73 20 43 ng, just press C
0da0: 6f 6e 74 72 6f 6c 2d 43 20 6f 72 20 75 73 65 0a ontrol-C or use.
0db0: 20 20 20 20 74 68 65 20 3c 62 3e 6b 69 6c 6c 3c the <b>kill<
0dc0: 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 73 /b> command to s
0dd0: 68 75 74 20 64 6f 77 6e 20 74 68 65 20 6d 69 6e hut down the min
0de0: 69 2d 73 65 72 76 65 72 2e 3c 2f 70 3e 0a 0a 3c i-server.</p>..<
0df0: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e /blockquote><h2>
0e00: 43 68 65 63 6b 69 6e 67 20 4f 75 74 20 41 20 4c Checking Out A L
0e10: 6f 63 61 6c 20 54 72 65 65 3c 2f 68 32 3e 3c 62 ocal Tree</h2><b
0e20: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 lockquote>..
0e30: 3c 70 3e 54 6f 20 77 6f 72 6b 20 6f 6e 20 61 20 <p>To work on a
0e40: 70 72 6f 6a 65 63 74 20 69 6e 20 66 6f 73 73 69 project in fossi
0e50: 6c 2c 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 63 l, you need to c
0e60: 68 65 63 6b 20 6f 75 74 20 61 20 6c 6f 63 61 6c heck out a local
0e70: 0a 20 20 20 20 63 6f 70 79 20 6f 66 20 74 68 65 . copy of the
0e80: 20 73 6f 75 72 63 65 20 74 72 65 65 2e 20 20 43 source tree. C
0e90: 72 65 61 74 65 20 74 68 65 20 64 69 72 65 63 74 reate the direct
0ea0: 6f 72 79 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 ory you want to
0eb0: 62 65 0a 20 20 20 20 74 68 65 20 72 6f 6f 74 20 be. the root
0ec0: 6f 66 20 79 6f 75 72 20 74 72 65 65 20 61 6e 64 of your tree and
0ed0: 20 63 64 20 69 6e 74 6f 20 74 68 61 74 20 64 69 cd into that di
0ee0: 72 65 63 74 6f 72 79 2e 20 20 54 68 65 6e 0a 20 rectory. Then.
0ef0: 20 20 20 64 6f 20 74 68 69 73 3a 3c 2f 70 3e 0a do this:</p>.
0f00: 20 20 20 20 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 . <blockq
0f10: 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 uote>. <b>fos
0f20: 73 69 6c 20 6f 70 65 6e 20 3c 2f 62 3e 3c 69 3e sil open </b><i>
0f30: 20 72 65 70 6f 73 69 74 6f 72 79 2d 66 69 6c 65 repository-file
0f40: 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 name</i>. </b
0f50: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 0a lockquote>. .
0f60: 20 20 20 20 3c 70 3e 54 68 69 73 20 6c 65 61 76 <p>This leav
0f70: 65 73 20 79 6f 75 20 77 69 74 68 20 74 68 65 20 es you with the
0f80: 6e 65 77 65 73 74 20 76 65 72 73 69 6f 6e 20 6f newest version o
0f90: 66 20 74 68 65 20 74 72 65 65 0a 20 20 20 20 63 f the tree. c
0fa0: 68 65 63 6b 65 64 20 6f 75 74 2e 20 20 20 20 0a hecked out. .
0fb0: 20 20 20 20 46 72 6f 6d 20 61 6e 79 77 68 65 72 From anywher
0fc0: 65 20 75 6e 64 65 72 6e 65 61 74 68 20 74 68 65 e underneath the
0fd0: 20 72 6f 6f 74 20 6f 66 20 79 6f 75 72 20 6c 6f root of your lo
0fe0: 63 61 6c 20 74 72 65 65 2c 20 79 6f 75 0a 20 20 cal tree, you.
0ff0: 20 20 63 61 6e 20 74 79 70 65 20 63 6f 6d 6d 61 can type comma
1000: 6e 64 73 20 6c 69 6b 65 20 74 68 65 20 66 6f 6c nds like the fol
1010: 6c 6f 77 69 6e 67 20 74 6f 20 66 69 6e 64 20 6f lowing to find o
1020: 75 74 20 74 68 65 20 73 74 61 74 75 73 20 6f 66 ut the status of
1030: 0a 20 20 20 20 79 6f 75 72 20 6c 6f 63 61 6c 20 . your local
1040: 74 72 65 65 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c tree:</p>.. <
1050: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 blockquote>.
1060: 3c 62 3e 66 6f 73 73 69 6c 20 69 6e 66 6f 3c 2f <b>fossil info</
1070: 62 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f b><br>. <b>fo
1080: 73 73 69 6c 20 73 74 61 74 75 73 3c 2f 62 3e 3c ssil status</b><
1090: 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 br>. <b>fossi
10a0: 6c 20 63 68 61 6e 67 65 73 3c 2f 62 3e 3c 62 72 l changes</b><br
10b0: 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 >. <b>fossil
10c0: 74 69 6d 65 6c 69 6e 65 3c 2f 62 3e 3c 62 72 3e timeline</b><br>
10d0: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6c . <b>fossil l
10e0: 65 61 76 65 73 3c 2f 62 3e 3c 62 72 3e 0a 20 20 eaves</b><br>.
10f0: 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6c 73 3c 2f <b>fossil ls</
1100: 62 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f b><br>. <b>fo
1110: 73 73 69 6c 20 62 72 61 6e 63 68 20 6c 69 73 74 ssil branch list
1120: 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 20 3c 2f 62 </b><br>. </b
1130: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 2f 62 6c lockquote>..</bl
1140: 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 4d 61 6b ockquote><h2>Mak
1150: 69 6e 67 20 43 68 61 6e 67 65 73 3c 2f 68 32 3e ing Changes</h2>
1160: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 <blockquote>..
1170: 20 20 3c 70 3e 54 6f 20 61 64 64 20 6e 65 77 20 <p>To add new
1180: 66 69 6c 65 73 20 74 6f 20 79 6f 75 72 20 70 72 files to your pr
1190: 6f 6a 65 63 74 2c 20 6f 72 20 72 65 6d 6f 76 65 oject, or remove
11a0: 20 6f 6c 64 20 66 69 6c 65 73 2c 20 75 73 65 20 old files, use
11b0: 74 68 65 73 65 0a 20 20 20 20 63 6f 6d 6d 61 6e these. comman
11c0: 64 73 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c ds:</p>.. <bl
11d0: 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 ockquote>. <b
11e0: 3e 66 6f 73 73 69 6c 20 61 64 64 3c 2f 62 3e 20 >fossil add</b>
11f0: 3c 69 3e 66 69 6c 65 2e 2e 2e 3c 2f 69 3e 3c 62 <i>file...</i><b
1200: 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c r>. <b>fossil
1210: 20 72 6d 3c 2f 62 3e 20 3c 69 3e 66 69 6c 65 2e rm</b> <i>file.
1220: 2e 2e 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f ..</i>. </blo
1230: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 ckquote>.. <p
1240: 3e 59 6f 75 20 63 61 6e 20 61 6c 73 6f 20 65 64 >You can also ed
1250: 69 74 20 66 69 6c 65 73 20 66 72 65 65 6c 79 2e it files freely.
1260: 20 20 4f 6e 63 65 20 79 6f 75 20 61 72 65 20 72 Once you are r
1270: 65 61 64 79 20 74 6f 20 63 6f 6d 6d 69 74 0a 20 eady to commit.
1280: 20 20 20 79 6f 75 72 20 63 68 61 6e 67 65 73 2c your changes,
1290: 20 74 79 70 65 3a 3c 2f 70 3e 0a 0a 20 20 20 20 type:</p>..
12a0: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 <blockquote>.
12b0: 20 3c 62 3e 66 6f 73 73 69 6c 20 63 6f 6d 6d 69 <b>fossil commi
12c0: 74 3c 2f 62 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 t</b>. </bloc
12d0: 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e kquote>.. <p>
12e0: 59 6f 75 20 77 69 6c 6c 20 62 65 20 70 72 6f 6d You will be prom
12f0: 70 74 65 64 20 66 6f 72 20 63 68 65 63 6b 2d 69 pted for check-i
1300: 6e 20 63 6f 6d 6d 65 6e 74 73 20 75 73 69 6e 67 n comments using
1310: 20 77 68 61 74 65 76 65 72 20 65 64 69 74 6f 72 whatever editor
1320: 0a 20 20 20 20 69 73 20 73 70 65 63 69 66 69 65 . is specifie
1330: 64 20 62 79 20 79 6f 75 72 20 56 49 53 55 41 4c d by your VISUAL
1340: 20 6f 72 20 45 44 49 54 4f 52 20 65 6e 76 69 72 or EDITOR envir
1350: 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 2e onment variable.
1360: 20 20 49 66 20 79 6f 75 0a 20 20 20 20 68 61 76 If you. hav
1370: 65 20 47 50 47 20 69 6e 73 74 61 6c 6c 65 64 2c e GPG installed,
1380: 20 79 6f 75 20 6d 61 79 20 62 65 20 70 72 6f 6d you may be prom
1390: 70 74 65 64 20 66 6f 72 20 79 6f 75 72 20 47 50 pted for your GP
13a0: 47 20 70 61 73 73 70 68 72 61 73 65 20 73 6f 0a G passphrase so.
13b0: 20 20 20 20 74 68 61 74 20 74 68 65 20 63 68 65 that the che
13c0: 63 6b 2d 69 6e 20 63 61 6e 20 62 65 20 73 69 67 ck-in can be sig
13d0: 6e 65 64 20 77 69 74 68 20 79 6f 75 72 20 47 50 ned with your GP
13e0: 47 20 73 69 67 6e 61 74 75 72 65 2e 20 20 41 66 G signature. Af
13f0: 74 65 72 0a 20 20 20 20 74 68 69 73 20 79 6f 75 ter. this you
1400: 72 20 63 68 61 6e 67 65 73 20 77 69 6c 6c 20 62 r changes will b
1410: 65 20 63 68 65 63 6b 65 64 20 69 6e 2e 3c 2f 70 e checked in.</p
1420: 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e >..</blockquote>
1430: 3c 68 32 3e 53 68 61 72 69 6e 67 20 43 68 61 6e <h2>Sharing Chan
1440: 67 65 73 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 ges</h2><blockqu
1450: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 ote>.. <p>The
1460: 20 63 68 61 6e 67 65 73 20 79 6f 75 20 3c 62 3e changes you <b>
1470: 63 6f 6d 6d 69 74 3c 2f 62 3e 20 61 72 65 20 6f commit</b> are o
1480: 6e 6c 79 20 6f 6e 20 79 6f 75 72 20 6c 6f 63 61 nly on your loca
1490: 6c 20 72 65 70 6f 73 69 74 6f 72 79 2e 0a 20 20 l repository..
14a0: 20 20 54 6f 20 73 68 61 72 65 20 74 68 6f 73 65 To share those
14b0: 20 63 68 61 6e 67 65 73 20 77 69 74 68 20 6f 74 changes with ot
14c0: 68 65 72 20 72 65 70 6f 73 69 74 6f 72 69 65 73 her repositories
14d0: 2c 20 64 6f 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c , do:</p>.. <
14e0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 blockquote>.
14f0: 3c 62 3e 66 6f 73 73 69 6c 20 70 75 73 68 3c 2f <b>fossil push</
1500: 62 3e 20 3c 69 3e 55 52 4c 3c 2f 69 3e 0a 20 20 b> <i>URL</i>.
1510: 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a </blockquote>.
1520: 0a 20 20 20 20 3c 70 3e 57 68 65 72 65 20 3c 69 . <p>Where <i
1530: 3e 55 52 4c 3c 2f 69 3e 20 69 73 20 74 68 65 20 >URL</i> is the
1540: 68 74 74 70 3a 20 55 52 4c 20 6f 66 20 74 68 65 http: URL of the
1550: 20 73 65 72 76 65 72 20 72 65 70 6f 73 69 74 6f server reposito
1560: 72 79 20 79 6f 75 0a 20 20 20 20 77 61 6e 74 20 ry you. want
1570: 74 6f 20 73 68 61 72 65 20 79 6f 75 72 20 63 68 to share your ch
1580: 61 6e 67 65 73 20 77 69 74 68 2e 20 20 49 66 20 anges with. If
1590: 79 6f 75 20 6f 6d 69 74 20 74 68 65 20 3c 69 3e you omit the <i>
15a0: 55 52 4c 3c 2f 69 3e 20 61 72 67 75 6d 65 6e 74 URL</i> argument
15b0: 2c 0a 20 20 20 20 66 6f 73 73 69 6c 20 77 69 6c ,. fossil wil
15c0: 6c 20 75 73 65 20 77 68 61 74 65 76 65 72 20 73 l use whatever s
15d0: 65 72 76 65 72 20 79 6f 75 20 6d 6f 73 74 20 72 erver you most r
15e0: 65 63 65 6e 74 6c 79 20 73 79 6e 63 65 64 20 77 ecently synced w
15f0: 69 74 68 2e 3c 2f 70 3e 0a 0a 20 20 20 20 3c 70 ith.</p>.. <p
1600: 3e 54 68 65 20 3c 62 3e 70 75 73 68 3c 2f 62 3e >The <b>push</b>
1610: 20 63 6f 6d 6d 61 6e 64 20 6f 6e 6c 79 20 73 65 command only se
1620: 6e 64 73 20 79 6f 75 72 20 63 68 61 6e 67 65 73 nds your changes
1630: 20 74 6f 20 6f 74 68 65 72 73 2e 20 20 54 6f 0a to others. To.
1640: 20 20 20 20 52 65 63 65 69 76 65 20 63 68 61 6e Receive chan
1650: 67 65 73 20 66 72 6f 6d 20 6f 74 68 65 72 73 2c ges from others,
1660: 20 75 73 65 20 3c 62 3e 70 75 6c 6c 3c 2f 62 3e use <b>pull</b>
1670: 2e 20 20 4f 72 20 67 6f 20 62 6f 74 68 20 77 61 . Or go both wa
1680: 79 73 20 61 74 0a 20 20 20 20 6f 6e 63 65 20 75 ys at. once u
1690: 73 69 6e 67 20 3c 62 3e 73 79 6e 63 3c 2f 62 3e sing <b>sync</b>
16a0: 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 :</p>.. <bloc
16b0: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 kquote>. <b>f
16c0: 6f 73 73 69 6c 20 70 75 6c 6c 3c 2f 62 3e 20 3c ossil pull</b> <
16d0: 69 3e 55 52 4c 3c 2f 69 3e 3c 62 72 3e 0a 20 20 i>URL</i><br>.
16e0: 20 20 3c 62 3e 66 6f 73 73 69 6c 20 73 79 6e 63 <b>fossil sync
16f0: 3c 2f 62 3e 20 3c 69 3e 55 52 4c 3c 2f 69 3e 0a </b> <i>URL</i>.
1700: 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 </blockquote
1710: 3e 0a 0a 20 20 20 20 3c 70 3e 57 68 65 6e 20 79 >.. <p>When y
1720: 6f 75 20 70 75 6c 6c 20 69 6e 20 63 68 61 6e 67 ou pull in chang
1730: 65 73 20 66 72 6f 6d 20 6f 74 68 65 72 73 2c 20 es from others,
1740: 74 68 65 79 20 67 6f 20 69 6e 74 6f 20 79 6f 75 they go into you
1750: 72 20 72 65 70 6f 73 69 74 6f 72 79 2c 0a 20 20 r repository,.
1760: 20 20 6e 6f 74 20 69 6e 74 6f 20 79 6f 75 72 20 not into your
1770: 63 68 65 63 6b 65 64 2d 6f 75 74 20 6c 6f 63 61 checked-out loca
1780: 6c 20 74 72 65 65 2e 20 20 54 6f 20 67 65 74 20 l tree. To get
1790: 74 68 65 20 63 68 61 6e 67 65 73 20 69 6e 74 6f the changes into
17a0: 20 79 6f 75 72 0a 20 20 20 20 6c 6f 63 61 6c 20 your. local
17b0: 74 72 65 65 2c 20 75 73 65 20 3c 62 3e 75 70 64 tree, use <b>upd
17c0: 61 74 65 3c 2f 62 3e 3a 3c 2f 70 3e 0a 0a 20 20 ate</b>:</p>..
17d0: 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 <blockquote>.
17e0: 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 75 70 64 <b>fossil upd
17f0: 61 74 65 3c 2f 62 3e 20 3c 69 3e 41 49 44 3c 2f ate</b> <i>AID</
1800: 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 i>. </blockqu
1810: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 ote>.. <p>The
1820: 20 3c 69 3e 41 49 44 3c 2f 69 3e 20 69 73 20 73 <i>AID</i> is s
1830: 6f 6d 65 20 75 6e 69 71 75 65 20 61 62 62 72 65 ome unique abbre
1840: 76 69 61 74 69 6f 6e 20 74 6f 20 74 68 65 20 34 viation to the 4
1850: 30 2d 63 68 61 72 61 63 74 65 72 0a 20 20 20 20 0-character.
1860: 61 72 74 69 66 61 63 74 20 69 64 65 6e 74 69 66 artifact identif
1870: 69 65 72 20 28 41 49 44 29 20 66 6f 72 20 61 20 ier (AID) for a
1880: 70 61 72 74 69 63 75 6c 61 72 20 63 68 65 63 6b particular check
1890: 2d 69 6e 2e 20 20 49 66 20 79 6f 75 20 6f 6d 69 -in. If you omi
18a0: 74 0a 20 20 20 20 74 68 65 20 3c 69 3e 41 49 44 t. the <i>AID
18b0: 3c 2f 69 3e 20 66 6f 73 73 69 6c 20 6d 6f 76 65 </i> fossil move
18c0: 73 20 79 6f 75 20 74 6f 20 74 68 65 0a 20 20 20 s you to the.
18d0: 20 6c 65 61 66 20 76 65 72 73 69 6f 6e 20 6f 66 leaf version of
18e0: 20 74 68 65 20 62 72 61 6e 63 68 20 79 6f 75 72 the branch your
18f0: 20 61 72 65 20 63 75 72 72 65 6e 74 6c 79 20 6f are currently o
1900: 6e 2e 20 20 49 66 20 79 6f 75 72 20 62 72 61 6e n. If your bran
1910: 63 68 0a 20 20 20 20 68 61 73 20 6d 75 6c 74 69 ch. has multi
1920: 70 6c 65 20 6c 65 61 76 65 73 2c 20 79 6f 75 20 ple leaves, you
1930: 67 65 74 20 61 6e 20 65 72 72 6f 72 20 2d 20 79 get an error - y
1940: 6f 75 27 6c 6c 20 68 61 76 65 20 74 6f 20 73 70 ou'll have to sp
1950: 65 63 69 66 79 20 74 68 65 0a 20 20 20 20 6c 65 ecify the. le
1960: 61 66 20 79 6f 75 20 77 61 6e 74 20 75 73 69 6e af you want usin
1970: 67 20 61 20 3c 69 3e 41 49 44 3c 2f 69 3e 20 61 g a <i>AID</i> a
1980: 72 67 75 6d 65 6e 74 2e 3c 2f 70 3e 0a 0a 3c 2f rgument.</p>..</
1990: 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 42 blockquote><h2>B
19a0: 72 61 6e 63 68 69 6e 67 20 41 6e 64 20 4d 65 72 ranching And Mer
19b0: 67 69 6e 67 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 ging</h2><blockq
19c0: 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 59 6f uote>.. <p>Yo
19d0: 75 20 63 61 6e 20 63 72 65 61 74 65 20 62 72 61 u can create bra
19e0: 6e 63 68 65 73 20 62 79 20 64 6f 69 6e 67 20 6d nches by doing m
19f0: 75 6c 74 69 70 6c 65 20 63 6f 6d 6d 69 74 73 20 ultiple commits
1a00: 6f 66 66 20 6f 66 20 74 68 65 0a 20 20 20 20 73 off of the. s
1a10: 61 6d 65 20 62 61 73 65 20 76 65 72 73 69 6f 6e ame base version
1a20: 2e 20 20 54 6f 20 6d 65 72 67 65 20 74 6f 20 62 . To merge to b
1a30: 72 61 6e 63 68 65 73 20 62 61 63 6b 20 74 6f 67 ranches back tog
1a40: 65 74 68 65 72 2c 20 66 69 72 73 74 0a 20 20 20 ether, first.
1a50: 20 3c 62 3e 75 70 64 61 74 65 3c 2f 62 3e 20 74 <b>update</b> t
1a60: 6f 20 74 68 65 20 6c 65 61 66 20 6f 66 20 6f 6e o the leaf of on
1a70: 65 20 62 72 61 6e 63 68 2e 20 20 54 68 65 6e 20 e branch. Then
1a80: 64 6f 20 61 20 3c 62 3e 6d 65 72 67 65 3c 2f 62 do a <b>merge</b
1a90: 3e 0a 20 20 20 20 6f 66 20 74 68 65 20 6c 65 61 >. of the lea
1aa0: 66 20 6f 66 20 74 68 65 20 6f 74 68 65 72 20 62 f of the other b
1ab0: 72 61 6e 63 68 3a 3c 2f 70 3e 0a 0a 20 20 20 20 ranch:</p>..
1ac0: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 <blockquote>.
1ad0: 20 3c 62 3e 66 6f 73 73 69 6c 20 6d 65 72 67 65 <b>fossil merge
1ae0: 3c 2f 62 3e 20 3c 69 3e 41 49 44 3c 2f 69 3e 0a </b> <i>AID</i>.
1af0: 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 </blockquote
1b00: 3e 0a 0a 20 20 20 20 3c 70 3e 54 65 73 74 20 74 >.. <p>Test t
1b10: 6f 20 6d 61 6b 65 20 73 75 72 65 20 79 6f 75 72 o make sure your
1b20: 20 6d 65 72 67 65 20 64 69 64 6e 27 74 20 6d 65 merge didn't me
1b30: 73 73 20 75 70 20 74 68 65 20 63 6f 64 65 2c 20 ss up the code,
1b40: 74 68 65 6e 0a 20 20 20 20 3c 62 3e 63 6f 6d 6d then. <b>comm
1b50: 69 74 3c 2f 62 3e 20 61 6e 64 20 70 6f 73 73 69 it</b> and possi
1b60: 62 6c 79 20 61 6c 73 6f 20 3c 62 3e 70 75 73 68 bly also <b>push
1b70: 3c 2f 62 3e 20 79 6f 75 72 20 63 68 61 6e 67 65 </b> your change
1b80: 73 2e 20 20 20 52 65 6d 65 6d 62 65 72 0a 20 20 s. Remember.
1b90: 20 20 74 68 61 74 20 6e 6f 62 6f 64 79 20 65 6c that nobody el
1ba0: 73 65 20 63 61 6e 20 73 65 65 20 79 6f 75 72 20 se can see your
1bb0: 63 68 61 6e 67 65 73 20 75 6e 74 69 6c 20 79 6f changes until yo
1bc0: 75 20 3c 62 3e 63 6f 6d 6d 69 74 3c 2f 62 3e 20 u <b>commit</b>
1bd0: 61 6e 64 0a 20 20 20 20 69 66 20 6f 74 68 65 72 and. if other
1be0: 20 61 72 65 20 75 73 69 6e 67 20 61 20 64 69 66 are using a dif
1bf0: 66 65 72 65 6e 74 20 72 65 70 6f 73 69 74 6f 72 ferent repositor
1c00: 79 20 79 6f 75 20 77 69 6c 6c 20 61 6c 73 6f 20 y you will also
1c10: 6e 65 65 64 20 74 6f 0a 20 20 20 20 3c 62 3e 70 need to. <b>p
1c20: 75 73 68 3c 2f 62 3e 2e 3c 2f 70 3e 0a 0a 3c 61 ush</b>.</p>..<a
1c30: 20 6e 61 6d 65 3d 22 73 65 72 76 65 72 73 65 74 name="serverset
1c40: 75 70 22 3e 3c 2f 61 3e 0a 3c 2f 62 6c 6f 63 6b up"></a>.</block
1c50: 71 75 6f 74 65 3e 3c 68 32 3e 53 65 74 74 69 6e quote><h2>Settin
1c60: 67 20 55 70 20 41 20 53 65 72 76 65 72 3c 2f 68 g Up A Server</h
1c70: 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 2><blockquote>..
1c80: 20 20 20 20 3c 70 3e 54 68 65 20 65 61 73 69 65 <p>The easie
1c90: 73 74 20 77 61 79 20 74 6f 20 73 65 74 20 75 70 st way to set up
1ca0: 20 61 20 73 65 72 76 65 72 20 69 73 3a 3c 2f 70 a server is:</p
1cb0: 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f >.. <blockquo
1cc0: 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 te>. <b>fossi
1cd0: 6c 20 73 65 72 76 65 72 3c 2f 62 3e 20 3c 69 3e l server</b> <i>
1ce0: 72 65 70 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e repository-filen
1cf0: 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c ame</i>. </bl
1d00: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c ockquote>.. <
1d10: 70 3e 4f 72 3c 2f 62 3e 0a 0a 20 20 20 20 3c 62 p>Or</b>.. <b
1d20: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c lockquote>. <
1d30: 62 3e 66 6f 73 73 69 6c 20 75 69 3c 2f 62 3e 20 b>fossil ui</b>
1d40: 3c 69 3e 72 65 70 6f 73 69 74 6f 72 79 2d 66 69 <i>repository-fi
1d50: 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c lename</i>. <
1d60: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 /blockquote>..
1d70: 20 20 3c 70 3e 54 68 65 20 64 69 66 66 65 72 65 <p>The differe
1d80: 6e 63 65 20 62 65 74 77 65 65 6e 20 74 68 65 73 nce between thes
1d90: 65 20 74 77 6f 20 63 6f 6d 6d 61 6e 64 20 69 73 e two command is
1da0: 20 74 68 61 74 20 3c 62 3e 75 69 3c 2f 62 3e 0a that <b>ui</b>.
1db0: 20 20 20 20 61 74 74 65 6d 70 74 73 20 74 6f 20 attempts to
1dc0: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 73 74 automatically st
1dd0: 61 72 74 20 79 6f 75 72 20 77 65 62 20 62 72 6f art your web bro
1de0: 77 73 65 72 20 70 6f 69 6e 74 69 6e 67 20 61 74 wser pointing at
1df0: 20 74 68 65 0a 20 20 20 20 73 65 72 76 65 72 20 the. server
1e00: 77 68 65 72 65 61 73 20 3c 62 3e 73 65 72 76 65 whereas <b>serve
1e10: 72 3c 2f 62 3e 20 64 6f 65 73 20 6e 6f 74 2e 0a r</b> does not..
1e20: 20 20 20 20 59 6f 75 20 63 61 6e 20 6f 6d 69 74 You can omit
1e30: 20 74 68 65 20 3c 69 3e 72 65 70 6f 73 69 74 6f the <i>reposito
1e40: 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 20 ry-filename</i>
1e50: 69 66 20 79 6f 75 20 61 72 65 20 77 69 74 68 69 if you are withi
1e60: 6e 0a 20 20 20 20 61 20 63 68 65 63 6b 65 64 2d n. a checked-
1e70: 6f 75 74 20 6c 6f 63 61 6c 20 74 72 65 65 2e 20 out local tree.
1e80: 20 54 68 69 73 20 73 65 72 76 65 72 20 75 73 65 This server use
1e90: 73 20 70 6f 72 74 20 38 30 38 30 20 62 79 20 64 s port 8080 by d
1ea0: 65 66 61 75 6c 74 0a 20 20 20 20 62 75 74 20 79 efault. but y
1eb0: 6f 75 20 63 61 6e 20 73 70 65 63 69 66 79 20 61 ou can specify a
1ec0: 20 64 69 66 66 65 72 65 6e 74 20 70 6f 72 74 20 different port
1ed0: 75 73 69 6e 67 20 74 68 65 20 3c 62 3e 2d 70 6f using the <b>-po
1ee0: 72 74 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 2e 3c rt</b> command.<
1ef0: 2f 70 3e 0a 0a 20 20 20 20 3c 70 3e 43 6f 6d 6d /p>.. <p>Comm
1f00: 61 6e 64 2d 6c 69 6e 65 20 73 65 72 76 65 72 73 and-line servers
1f10: 20 6c 69 6b 65 20 74 68 69 73 20 61 72 65 20 75 like this are u
1f20: 73 65 66 75 6c 20 77 68 65 6e 20 74 77 6f 20 70 seful when two p
1f30: 65 6f 70 6c 65 20 77 61 6e 74 0a 20 20 20 20 74 eople want. t
1f40: 6f 20 73 68 61 72 65 20 61 20 72 65 70 6f 73 69 o share a reposi
1f50: 74 6f 72 79 20 6f 6e 20 74 65 6d 70 6f 72 61 72 tory on temporar
1f60: 79 20 6f 72 20 61 64 2d 68 6f 63 20 62 61 73 69 y or ad-hoc basi
1f70: 73 2e 20 20 46 6f 72 20 61 20 6d 6f 72 65 0a 20 s. For a more.
1f80: 20 20 20 70 65 72 6d 61 6e 65 6e 74 20 69 6e 73 permanent ins
1f90: 74 61 6c 6c 61 74 69 6f 6e 2c 20 79 6f 75 20 73 tallation, you s
1fa0: 68 6f 75 6c 64 20 75 73 65 20 65 69 74 68 65 72 hould use either
1fb0: 20 74 68 65 20 43 47 49 20 73 65 72 76 65 72 20 the CGI server
1fc0: 6f 72 20 74 68 65 0a 20 20 20 20 69 6e 65 74 64 or the. inetd
1fd0: 20 73 65 72 76 65 72 2e 0a 20 20 20 20 3c 61 20 server.. <a
1fe0: 6e 61 6d 65 3d 22 63 67 69 73 65 72 76 65 72 22 name="cgiserver"
1ff0: 3e 3c 2f 61 3e 0a 20 20 20 20 54 6f 20 75 73 65 ></a>. To use
2000: 20 74 68 65 20 43 47 49 20 73 65 72 76 65 72 2c the CGI server,
2010: 20 63 72 65 61 74 65 20 61 20 43 47 49 20 73 63 create a CGI sc
2020: 72 69 70 74 20 74 68 61 74 0a 20 20 20 20 6c 6f ript that. lo
2030: 6f 6b 73 20 73 6f 6d 65 74 68 69 6e 67 20 6c 69 oks something li
2040: 6b 65 20 74 68 69 73 3a 3c 2f 70 3e 0a 0a 20 20 ke this:</p>..
2050: 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 62 <blockquote><b
2060: 3e 0a 20 20 20 20 23 21 2f 75 73 72 2f 6c 6f 63 >. #!/usr/loc
2070: 61 6c 2f 62 69 6e 2f 66 6f 73 73 69 6c 3c 62 72 al/bin/fossil<br
2080: 3e 0a 20 20 20 20 72 65 70 6f 73 69 74 6f 72 79 >. repository
2090: 3a 20 2f 68 6f 6d 65 2f 70 72 6f 6a 31 2f 72 65 : /home/proj1/re
20a0: 70 6f 73 31 2e 66 6f 73 73 69 6c 0a 20 20 20 20 pos1.fossil.
20b0: 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 </b></blockquote
20c0: 3e 0a 0a 20 20 20 20 3c 70 3e 41 64 6a 75 73 74 >.. <p>Adjust
20d0: 20 74 68 65 20 70 61 74 68 73 20 69 6e 20 74 68 the paths in th
20e0: 69 73 20 43 47 49 20 73 63 72 69 70 74 20 74 6f is CGI script to
20f0: 20 6d 61 74 63 68 20 79 6f 75 72 20 69 6e 73 74 match your inst
2100: 61 6c 6c 61 74 69 6f 6e 0a 20 20 20 20 61 6e 64 allation. and
2110: 20 6d 61 6b 65 20 73 75 72 65 20 74 68 61 74 20 make sure that
2120: 72 65 70 6f 73 69 74 6f 72 79 20 66 69 6c 65 20 repository file
2130: 61 74 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 at the directory
2140: 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 69 that contains i
2150: 74 0a 20 20 20 20 61 72 65 20 62 6f 74 68 20 72 t. are both r
2160: 65 61 64 61 62 6c 65 20 61 6e 64 20 77 72 69 74 eadable and writ
2170: 61 62 6c 65 20 62 79 20 74 68 65 20 75 73 65 72 able by the user
2180: 20 74 68 61 74 20 43 47 49 20 73 63 72 69 70 74 that CGI script
2190: 73 20 72 75 6e 20 61 73 2e 0a 20 20 20 20 54 68 s run as.. Th
21a0: 65 6e 20 70 6f 69 6e 74 20 63 6c 69 65 6e 74 73 en point clients
21b0: 20 61 74 20 74 68 65 20 43 47 49 20 73 63 72 69 at the CGI scri
21c0: 70 74 2e 20 20 54 68 61 74 27 73 20 61 6c 6c 20 pt. That's all
21d0: 74 68 65 72 65 20 69 73 20 74 6f 20 69 74 21 3c there is to it!<
21e0: 2f 70 3e 0a 0a 20 20 20 20 3c 61 20 6e 61 6d 65 /p>.. <a name
21f0: 3d 22 69 6e 65 74 64 73 65 72 76 65 72 22 3e 3c ="inetdserver"><
2200: 2f 61 3e 0a 20 20 20 20 3c 70 3e 59 6f 75 20 63 /a>. <p>You c
2210: 61 6e 20 61 6c 73 6f 20 72 75 6e 20 66 6f 73 73 an also run foss
2220: 69 6c 20 6f 66 66 20 6f 66 20 69 6e 65 74 64 20 il off of inetd
2230: 6f 72 20 78 69 6e 65 74 64 2e 20 20 46 6f 72 20 or xinetd. For
2240: 61 6e 20 69 6e 65 74 64 0a 20 20 20 20 69 6e 73 an inetd. ins
2250: 74 61 6c 6c 61 74 69 6f 6e 2c 20 6d 61 6b 65 20 tallation, make
2260: 61 6e 20 65 6e 74 72 79 20 69 6e 20 2f 65 74 63 an entry in /etc
2270: 2f 69 6e 65 74 64 2e 63 6f 6e 66 20 74 68 61 74 /inetd.conf that
2280: 20 6c 6f 6f 6b 73 20 73 6f 6d 65 74 68 69 6e 67 looks something
2290: 0a 20 20 20 20 6c 69 6b 65 20 74 68 69 73 3a 3c . like this:<
22a0: 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 /p>.. <blockq
22b0: 75 6f 74 65 3e 3c 62 3e 0a 20 20 20 20 38 30 20 uote><b>. 80
22c0: 73 74 72 65 61 6d 20 74 63 70 20 6e 6f 77 61 69 stream tcp nowai
22d0: 74 2e 31 30 30 30 20 72 6f 6f 74 20 2f 75 73 72 t.1000 root /usr
22e0: 2f 62 69 6e 2f 66 6f 73 73 69 6c 20 5c 3c 62 72 /bin/fossil \<br
22f0: 3e 0a 20 20 20 20 20 20 20 20 2f 75 73 72 2f 62 >. /usr/b
2300: 69 6e 2f 66 6f 73 73 69 6c 20 68 74 74 70 20 2f in/fossil http /
2310: 68 6f 6d 65 2f 70 72 6f 6a 31 2f 72 65 70 6f 73 home/proj1/repos
2320: 31 2e 66 6f 73 73 69 6c 0a 20 20 20 20 3c 2f 62 1.fossil. </b
2330: 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a ></blockquote>..
2340: 20 20 20 20 3c 70 3e 41 64 6a 75 73 74 20 74 68 <p>Adjust th
2350: 65 20 70 61 74 68 73 20 74 6f 20 73 75 69 74 20 e paths to suit
2360: 79 6f 75 72 20 69 6e 73 74 61 6c 6c 61 74 69 6f your installatio
2370: 6e 2c 20 6f 66 20 63 6f 75 72 73 65 2e 20 20 4e n, of course. N
2380: 6f 74 69 63 65 20 74 68 61 74 0a 20 20 20 20 66 otice that. f
2390: 6f 73 73 69 6c 20 72 75 6e 73 20 61 73 20 72 6f ossil runs as ro
23a0: 6f 74 2e 20 20 54 68 69 73 20 69 73 20 6e 6f 74 ot. This is not
23b0: 20 72 65 71 75 69 72 65 64 20 2d 20 79 6f 75 20 required - you
23c0: 63 61 6e 20 72 75 6e 20 69 74 20 61 73 20 61 6e can run it as an
23d0: 0a 20 20 20 20 75 6e 70 72 69 76 69 6c 65 67 65 . unprivilege
23e0: 64 20 75 73 65 72 2e 20 20 42 75 74 20 69 74 20 d user. But it
23f0: 69 73 20 6d 6f 72 65 20 73 65 63 75 72 65 20 74 is more secure t
2400: 6f 20 72 75 6e 20 66 6f 73 73 69 6c 20 61 73 20 o run fossil as
2410: 72 6f 6f 74 2e 0a 20 20 20 20 57 68 65 6e 20 79 root.. When y
2420: 6f 75 20 64 6f 20 72 75 6e 20 66 6f 73 73 69 6c ou do run fossil
2430: 20 61 73 20 72 6f 6f 74 2c 20 69 74 20 61 75 74 as root, it aut
2440: 6f 6d 61 74 69 63 61 6c 6c 79 20 70 75 74 73 20 omatically puts
2450: 69 74 73 65 6c 66 20 69 6e 20 61 0a 20 20 20 20 itself in a.
2460: 63 68 72 6f 6f 74 20 6a 61 69 6c 20 69 6e 20 74 chroot jail in t
2470: 68 65 20 73 61 6d 65 20 64 69 72 65 63 74 6f 72 he same director
2480: 79 20 61 73 20 74 68 65 20 72 65 70 6f 73 69 74 y as the reposit
2490: 6f 72 79 2c 20 74 68 65 6e 20 64 72 6f 70 73 0a ory, then drops.
24a0: 20 20 20 20 72 6f 6f 74 20 70 72 69 76 69 6c 65 root privile
24b0: 67 65 73 20 70 72 69 6f 72 20 74 6f 20 72 65 61 ges prior to rea
24c0: 64 69 6e 67 20 61 6e 79 20 69 6e 66 6f 72 6d 61 ding any informa
24d0: 74 69 6f 6e 20 66 72 6f 6d 20 74 68 65 20 72 65 tion from the re
24e0: 71 75 65 73 74 2e 3c 2f 70 3e 0a 0a 3c 2f 62 6c quest.</p>..</bl
24f0: 6f 63 6b 71 75 6f 74 65 3e 3c 61 20 6e 61 6d 65 ockquote><a name
2500: 3d 22 70 72 6f 78 79 22 3e 3c 2f 61 3e 3c 68 32 ="proxy"></a><h2
2510: 3e 48 54 54 50 20 50 72 6f 78 69 65 73 3c 2f 68 >HTTP Proxies</h
2520: 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 2><blockquote>..
2530: 20 20 20 20 3c 70 3e 49 66 20 79 6f 75 20 61 72 <p>If you ar
2540: 65 20 62 65 68 69 6e 64 20 61 20 72 65 73 74 72 e behind a restr
2550: 69 63 74 69 76 65 20 66 69 72 65 77 61 6c 6c 20 ictive firewall
2560: 74 68 61 74 20 72 65 71 75 69 72 65 73 20 79 6f that requires yo
2570: 75 20 74 6f 20 75 73 65 0a 20 20 20 20 61 6e 20 u to use. an
2580: 48 54 54 50 20 70 72 6f 78 79 20 74 6f 20 72 65 HTTP proxy to re
2590: 61 63 68 20 74 68 65 20 69 6e 74 65 72 6e 65 74 ach the internet
25a0: 2c 20 74 68 65 6e 20 79 6f 75 20 63 61 6e 20 63 , then you can c
25b0: 6f 6e 66 69 67 75 72 65 20 74 68 65 20 70 72 6f onfigure the pro
25c0: 78 79 0a 20 20 20 20 69 6e 20 74 68 72 65 65 20 xy. in three
25d0: 64 69 66 66 65 72 65 6e 74 20 77 61 79 73 2e 20 different ways.
25e0: 20 59 6f 75 20 63 61 6e 20 74 65 6c 6c 20 66 6f You can tell fo
25f0: 73 73 69 6c 20 61 62 6f 75 74 20 79 6f 75 72 20 ssil about your
2600: 70 72 6f 78 79 20 75 73 69 6e 67 0a 20 20 20 20 proxy using.
2610: 61 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 6f a command-line o
2620: 70 74 69 6f 6e 20 6f 6e 20 63 6f 6d 6d 61 6e 64 ption on command
2630: 73 20 74 68 61 74 20 75 73 65 20 74 68 65 20 6e s that use the n
2640: 65 74 77 6f 72 6b 2c 0a 20 20 20 20 3c 62 3e 73 etwork,. <b>s
2650: 79 6e 63 3c 2f 62 3e 2c 20 3c 62 3e 63 6c 6f 6e ync</b>, <b>clon
2660: 65 3c 2f 62 3e 2c 20 3c 62 3e 70 75 73 68 3c 2f e</b>, <b>push</
2670: 62 3e 2c 20 61 6e 64 20 3c 62 3e 70 75 6c 6c 3c b>, and <b>pull<
2680: 2f 62 3e 2e 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 /b>.</p>.. <b
2690: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c lockquote>. <
26a0: 62 3e 66 6f 73 73 69 6c 20 63 6c 6f 6e 65 20 3c b>fossil clone <
26b0: 2f 62 3e 3c 69 3e 55 52 4c 3c 2f 69 3e 20 20 3c /b><i>URL</i> <
26c0: 62 3e 2d 2d 70 72 6f 78 79 3c 2f 62 3e 20 3c 69 b>--proxy</b> <i
26d0: 3e 50 72 6f 78 79 2d 55 52 4c 3c 2f 69 3e 0a 20 >Proxy-URL</i>.
26e0: 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e </blockquote>
26f0: 0a 0a 20 20 20 20 3c 70 3e 49 74 20 69 73 20 61 .. <p>It is a
2700: 6e 6e 6f 79 69 6e 67 20 74 6f 20 68 61 76 65 20 nnoying to have
2710: 74 6f 20 74 79 70 65 20 69 6e 20 74 68 65 20 70 to type in the p
2720: 72 6f 78 79 20 55 52 4c 20 65 76 65 72 79 20 74 roxy URL every t
2730: 69 6d 65 20 79 6f 75 0a 20 20 20 20 73 79 6e 63 ime you. sync
2740: 20 79 6f 75 72 20 70 72 6f 6a 65 63 74 2c 20 74 your project, t
2750: 68 6f 75 67 68 2c 20 73 6f 20 79 6f 75 20 63 61 hough, so you ca
2760: 6e 20 6d 61 6b 65 20 74 68 65 20 70 72 6f 78 79 n make the proxy
2770: 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 0a 20 configuration.
2780: 20 20 20 70 65 72 73 69 73 74 65 6e 74 20 75 73 persistent us
2790: 69 6e 67 20 74 68 65 20 3c 62 3e 73 65 74 74 69 ing the <b>setti
27a0: 6e 67 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 3a 3c ng</b> command:<
27b0: 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 /p>.. <blockq
27c0: 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 uote>. <b>fos
27d0: 73 69 6c 20 73 65 74 74 69 6e 67 20 70 72 6f 78 sil setting prox
27e0: 79 20 3c 2f 62 3e 3c 69 3e 50 72 6f 78 79 2d 55 y </b><i>Proxy-U
27f0: 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f RL</i>. </blo
2800: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 ckquote>.. <p
2810: 3e 4f 72 2c 20 79 6f 75 20 63 61 6e 20 73 65 74 >Or, you can set
2820: 20 74 68 65 20 22 3c 62 3e 68 74 74 70 5f 70 72 the "<b>http_pr
2830: 6f 78 79 3c 2f 62 3e 22 20 65 6e 76 69 72 6f 6e oxy</b>" environ
2840: 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 3a 3c 2f ment variable:</
2850: 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 p>.. <blockqu
2860: 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 65 78 70 6f ote>. <b>expo
2870: 72 74 20 68 74 74 70 5f 70 72 6f 78 79 3d 3c 2f rt http_proxy=</
2880: 62 3e 3c 69 3e 50 72 6f 78 79 2d 55 52 4c 3c 2f b><i>Proxy-URL</
2890: 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 i>. </blockqu
28a0: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 6f 20 ote>.. <p>To
28b0: 73 74 6f 70 20 75 73 69 6e 67 20 74 68 65 20 70 stop using the p
28c0: 72 6f 78 79 2c 20 64 6f 3a 3c 2f 70 3e 0a 0a 20 roxy, do:</p>..
28d0: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a <blockquote>.
28e0: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 73 65 <b>fossil se
28f0: 74 74 69 6e 67 20 70 72 6f 78 79 20 6f 66 66 3c tting proxy off<
2900: 2f 62 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 /b>. </blockq
2910: 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 4f 72 uote>.. <p>Or
2920: 20 75 6e 73 65 74 20 74 68 65 20 65 6e 76 69 72 unset the envir
2930: 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 2e onment variable.
2940: 20 20 54 68 65 20 66 6f 73 73 69 6c 20 73 65 74 The fossil set
2950: 74 69 6e 67 20 66 6f 72 20 74 68 65 0a 20 20 20 ting for the.
2960: 20 48 54 54 50 20 70 72 6f 78 79 20 74 61 6b 65 HTTP proxy take
2970: 73 20 70 72 65 63 65 64 65 6e 63 65 20 6f 76 65 s precedence ove
2980: 72 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e r the environmen
2990: 74 20 76 61 72 69 61 62 6c 65 20 61 6e 64 20 74 t variable and t
29a0: 68 65 0a 20 20 20 20 63 6f 6d 6d 61 6e 64 2d 6c he. command-l
29b0: 69 6e 65 20 6f 70 74 69 6f 6e 20 6f 76 65 72 72 ine option overr
29c0: 69 64 65 73 20 62 6f 74 68 2e 20 20 49 66 20 79 ides both. If y
29d0: 6f 75 20 68 61 76 65 20 61 6e 20 70 65 72 73 69 ou have an persi
29e0: 73 74 65 6e 74 0a 20 20 20 20 70 72 6f 78 79 20 stent. proxy
29f0: 73 65 74 74 69 6e 67 20 74 68 61 74 20 79 6f 75 setting that you
2a00: 20 77 61 6e 74 20 74 6f 20 6f 76 65 72 72 69 64 want to overrid
2a10: 65 20 66 6f 72 20 61 20 6f 6e 65 2d 74 69 6d 65 e for a one-time
2a20: 20 73 79 6e 63 2c 20 74 68 61 74 0a 20 20 20 20 sync, that.
2a30: 69 73 20 65 61 73 69 6c 79 20 64 6f 6e 65 20 6f is easily done o
2a40: 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2d 6c 69 n the command-li
2a50: 6e 65 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 ne. For example
2a60: 2c 20 74 6f 20 73 79 6e 63 20 77 69 74 68 0a 20 , to sync with.
2a70: 20 20 20 61 20 63 6f 2d 77 6f 72 6b 65 72 73 20 a co-workers
2a80: 72 65 70 6f 73 69 74 6f 72 79 20 6f 6e 20 79 6f repository on yo
2a90: 75 72 20 4c 41 4e 2c 20 79 6f 75 20 6d 69 67 68 ur LAN, you migh
2aa0: 74 20 74 79 70 65 3a 3c 2f 70 3e 20 20 20 0a 0a t type:</p> ..
2ab0: 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e <blockquote>
2ac0: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 73 . <b>fossil s
2ad0: 79 6e 63 20 68 74 74 70 3a 2f 2f 31 39 32 2e 31 ync http://192.1
2ae0: 36 38 2e 31 2e 33 36 3a 38 30 38 30 2f 20 2d 2d 68.1.36:8080/ --
2af0: 70 72 6f 78 79 20 6f 66 66 3c 2f 62 3e 0a 20 20 proxy off</b>.
2b00: 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a </blockquote>.
2b10: 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 .</blockquote><h
2b20: 32 3e 4d 6f 72 65 20 48 69 6e 74 73 3c 2f 68 32 2>More Hints</h2
2b30: 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 ><blockquote>..
2b40: 20 20 20 3c 70 3e 54 72 79 20 74 68 65 73 65 20 <p>Try these
2b50: 63 6f 6d 6d 61 6e 64 73 3a 3c 2f 70 3e 0a 0a 20 commands:</p>..
2b60: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c <blockquote><
2b70: 62 3e 0a 20 20 20 20 66 6f 73 73 69 6c 20 68 65 b>. fossil he
2b80: 6c 70 3c 62 72 3e 0a 20 20 20 20 66 6f 73 73 69 lp<br>. fossi
2b90: 6c 20 74 65 73 74 2d 63 6f 6d 6d 61 6e 64 73 0a l test-commands.
2ba0: 20 20 20 20 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 </b></blockq
2bb0: 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 45 78 uote>.. <p>Ex
2bc0: 70 6c 6f 72 65 20 61 6e 64 20 68 61 76 65 20 66 plore and have f
2bd0: 75 6e 21 3c 2f 70 3e 0a 0a 0a 3c 2f 62 6c 6f 63 un!</p>...</bloc
2be0: 6b 71 75 6f 74 65 3e 0a 3c 2f 6e 6f 77 69 6b 69 kquote>.</nowiki
2bf0: 3e 0a >.