0000: 3c 6e 6f 77 69 6b 69 3e 0a 3c 68 31 20 61 6c 69 <nowiki>.<h1 ali
0010: 67 6e 3d 22 63 65 6e 74 65 72 22 3e 46 6f 73 73 gn="center">Foss
0020: 69 6c 20 51 75 69 63 6b 20 53 74 61 72 74 3c 2f il Quick Start</
0030: 68 31 3e 0a 0a 3c 70 3e 54 68 69 73 20 69 73 20 h1>..<p>This is
0040: 61 20 67 75 69 64 65 20 74 6f 20 67 65 74 20 79 a guide to get y
0050: 6f 75 20 73 74 61 72 74 65 64 20 75 73 69 6e 67 ou started using
0060: 20 66 6f 73 73 69 6c 20 71 75 69 63 6b 6c 79 0a fossil quickly.
0070: 61 6e 64 20 70 61 69 6e 6c 65 73 73 6c 79 2e 3c and painlessly.<
0080: 2f 70 3e 0a 0a 3c 68 32 3e 49 6e 73 74 61 6c 6c /p>..<h2>Install
0090: 69 6e 67 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 ing</h2><blockqu
00a0: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 46 6f 73 ote>.. <p>Fos
00b0: 73 69 6c 20 69 73 20 61 20 73 69 6e 67 6c 65 20 sil is a single
00c0: 73 65 6c 66 2d 63 6f 6e 74 61 69 6e 65 64 20 43 self-contained C
00d0: 20 70 72 6f 67 72 61 6d 2e 20 20 59 6f 75 20 6e program. You n
00e0: 65 65 64 20 74 6f 0a 20 20 20 20 65 69 74 68 65 eed to. eithe
00f0: 72 20 64 6f 77 6e 6c 6f 61 64 20 61 20 0a 20 20 r download a .
0100: 20 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 3a <a href="http:
0110: 2f 2f 77 77 77 2e 66 6f 73 73 69 6c 2d 73 63 6d //www.fossil-scm
0120: 2e 6f 72 67 2f 64 6f 77 6e 6c 6f 61 64 2e 68 74 .org/download.ht
0130: 6d 6c 22 3e 70 72 65 63 6f 6d 70 69 6c 65 64 20 ml">precompiled
0140: 62 69 6e 61 72 79 3c 2f 61 3e 0a 20 20 20 20 6f binary</a>. o
0150: 72 20 3c 61 20 68 72 65 66 3d 22 62 75 69 6c 64 r <a href="build
0160: 2e 77 69 6b 69 22 3e 62 75 69 6c 64 20 69 74 20 .wiki">build it
0170: 79 6f 75 72 73 65 6c 66 3c 2f 61 3e 20 66 72 6f yourself</a> fro
0180: 6d 20 73 6f 75 72 63 65 73 2e 0a 20 20 20 20 49 m sources.. I
0190: 6e 73 74 61 6c 6c 20 66 6f 73 73 69 6c 20 62 79 nstall fossil by
01a0: 20 70 75 74 74 69 6e 67 20 74 68 65 20 66 6f 73 putting the fos
01b0: 73 69 6c 20 62 69 6e 61 72 79 0a 20 20 20 20 73 sil binary. s
01c0: 6f 6d 65 70 6c 61 63 65 20 6f 6e 20 79 6f 75 72 omeplace on your
01d0: 20 50 41 54 48 20 65 6e 76 69 72 6f 6e 6d 65 6e PATH environmen
01e0: 74 20 76 61 72 69 61 62 6c 65 2e 3c 2f 70 3e 0a t variable.</p>.
01f0: 20 20 20 20 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b . </block
0200: 71 75 6f 74 65 3e 0a 20 20 20 20 3c 68 32 3e 43 quote>. <h2>C
0210: 6c 6f 6e 69 6e 67 20 41 20 45 78 69 73 74 69 6e loning A Existin
0220: 67 20 52 65 70 6f 73 69 74 6f 72 79 3c 2f 68 32 g Repository</h2
0230: 3e 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 >. <blockquot
0240: 65 3e 0a 0a 20 20 20 20 3c 70 3e 4d 6f 73 74 20 e>.. <p>Most
0250: 66 6f 73 73 69 6c 20 6f 70 65 72 61 74 69 6f 6e fossil operation
0260: 73 20 69 6e 74 65 72 61 63 74 20 77 69 74 68 20 s interact with
0270: 61 20 72 65 70 6f 73 69 74 6f 72 79 20 74 68 61 a repository tha
0280: 74 20 69 73 20 6f 6e 20 74 68 65 0a 20 20 20 20 t is on the.
0290: 6c 6f 63 61 6c 20 64 69 73 6b 20 64 72 69 76 65 local disk drive
02a0: 2c 20 6e 6f 74 20 6f 6e 20 61 20 72 65 6d 6f 74 , not on a remot
02b0: 65 20 73 79 73 74 65 6d 2e 20 20 48 65 6e 63 65 e system. Hence
02c0: 2c 20 62 65 66 6f 72 65 20 61 63 63 65 73 73 69 , before accessi
02d0: 6e 67 0a 20 20 20 20 61 20 72 65 6d 6f 74 65 20 ng. a remote
02e0: 72 65 70 6f 73 69 74 6f 72 79 20 69 74 20 69 73 repository it is
02f0: 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 6d 61 necessary to ma
0300: 6b 65 20 61 20 6c 6f 63 61 6c 20 63 6f 70 79 20 ke a local copy
0310: 6f 66 20 74 68 61 74 0a 20 20 20 20 72 65 70 6f of that. repo
0320: 73 69 74 6f 72 79 2e 20 20 4d 61 6b 69 6e 67 20 sitory. Making
0330: 61 20 6c 6f 63 61 6c 20 63 6f 70 79 20 6f 66 20 a local copy of
0340: 61 20 72 65 6d 6f 74 65 20 72 65 70 6f 73 69 74 a remote reposit
0350: 6f 72 79 20 69 73 20 63 61 6c 6c 65 64 0a 20 20 ory is called.
0360: 20 20 22 63 6c 6f 6e 69 6e 67 22 2e 3c 2f 70 3e "cloning".</p>
0370: 0a 20 20 20 20 0a 20 20 20 20 3c 70 3e 43 6c 6f . . <p>Clo
0380: 6e 65 20 61 20 72 65 6d 6f 74 65 20 72 65 70 6f ne a remote repo
0390: 73 69 74 6f 72 79 20 61 73 20 66 6f 6c 6c 6f 77 sitory as follow
03a0: 73 3a 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 20 20 s:</p>. .
03b0: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 <blockquote>.
03c0: 20 3c 62 3e 66 6f 73 73 69 6c 20 63 6c 6f 6e 65 <b>fossil clone
03d0: 3c 2f 62 3e 20 3c 69 3e 55 52 4c 20 20 72 65 70 </b> <i>URL rep
03e0: 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 ository-filename
03f0: 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b </i>. </block
0400: 71 75 6f 74 65 3e 0a 20 20 20 20 0a 20 20 20 20 quote>. .
0410: 3c 70 3e 54 68 65 20 3c 69 3e 55 52 4c 3c 2f 69 <p>The <i>URL</i
0420: 3e 20 61 62 6f 76 65 20 69 73 20 74 68 65 20 68 > above is the h
0430: 74 74 70 20 55 52 4c 20 66 6f 72 20 74 68 65 20 ttp URL for the
0440: 66 6f 73 73 69 6c 20 72 65 70 6f 73 69 74 6f 72 fossil repositor
0450: 79 0a 20 20 20 20 79 6f 75 20 77 61 6e 74 20 74 y. you want t
0460: 6f 20 63 6c 6f 6e 65 2c 20 61 6e 64 20 69 74 20 o clone, and it
0470: 6d 61 79 20 69 6e 63 6c 75 64 65 20 61 20 22 75 may include a "u
0480: 73 65 72 3a 70 61 73 73 77 6f 72 64 22 20 70 61 ser:password" pa
0490: 72 74 2c 20 65 2e 67 2e 0a 20 20 20 20 3c 74 74 rt, e.g.. <tt
04a0: 3e 68 74 74 70 3a 2f 2f 64 72 68 3a 73 65 63 72 >http://drh:secr
04b0: 65 74 40 77 77 77 2e 66 6f 73 73 69 6c 2d 73 63 et@www.fossil-sc
04c0: 6d 2e 6f 72 67 2f 66 6f 73 73 69 6c 3c 2f 74 74 m.org/fossil</tt
04d0: 3e 2e 20 59 6f 75 20 63 61 6e 0a 20 20 20 20 63 >. You can. c
04e0: 61 6c 6c 20 74 68 65 20 6e 65 77 20 72 65 70 6f all the new repo
04f0: 73 69 74 6f 72 79 20 61 6e 79 74 68 69 6e 67 20 sitory anything
0500: 79 6f 75 20 77 61 6e 74 20 2d 20 74 68 65 72 65 you want - there
0510: 20 61 72 65 20 6e 6f 20 6e 61 6d 69 6e 67 0a 20 are no naming.
0520: 20 20 20 72 65 73 74 72 69 63 74 69 6f 6e 73 2e restrictions.
0530: 20 20 41 73 20 61 6e 20 65 78 61 6d 70 6c 65 2c As an example,
0540: 20 79 6f 75 20 63 61 6e 20 63 6c 6f 6e 65 20 74 you can clone t
0550: 68 65 20 66 6f 73 73 69 6c 20 72 65 70 6f 73 69 he fossil reposi
0560: 74 6f 72 79 0a 20 20 20 20 74 68 69 73 20 77 61 tory. this wa
0570: 79 3a 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 20 20 y:</p>. .
0580: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 <blockquote>.
0590: 20 3c 62 3e 66 6f 73 73 69 6c 20 63 6c 6f 6e 65 <b>fossil clone
05a0: 20 68 74 74 70 3a 2f 2f 77 77 77 2e 66 6f 73 73 http://www.foss
05b0: 69 6c 2d 73 63 6d 2e 6f 72 67 2f 20 6d 79 63 6c il-scm.org/ mycl
05c0: 6f 6e 65 2e 66 6f 73 73 69 6c 3c 2f 62 3e 0a 20 one.fossil</b>.
05d0: 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e </blockquote>
05e0: 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 6e 65 77 .. <p>The new
05f0: 20 6c 6f 63 61 6c 20 63 6f 70 79 20 6f 66 20 74 local copy of t
0600: 68 65 20 72 65 73 70 6f 73 69 74 6f 72 79 20 69 he respository i
0610: 73 20 73 74 6f 72 65 64 20 69 6e 20 61 20 73 69 s stored in a si
0620: 6e 67 6c 65 20 66 69 6c 65 2c 0a 20 20 20 20 77 ngle file,. w
0630: 68 69 63 68 20 69 6e 20 74 68 65 20 65 78 61 6d hich in the exam
0640: 70 6c 65 20 61 62 6f 76 65 20 69 73 20 6e 61 6d ple above is nam
0650: 65 64 20 22 6d 79 63 6c 6f 6e 65 2e 66 6f 73 73 ed "myclone.foss
0660: 69 6c 22 2e 0a 20 20 20 20 59 6f 75 20 63 61 6e il".. You can
0670: 20 6e 61 6d 65 20 79 6f 75 72 20 72 65 70 6f 73 name your repos
0680: 69 74 6f 72 69 65 73 20 61 6e 79 74 68 69 6e 67 itories anything
0690: 20 79 6f 75 20 77 61 6e 74 2e 20 20 54 68 65 20 you want. The
06a0: 22 2e 66 6f 73 73 69 6c 22 20 73 75 66 66 69 78 ".fossil" suffix
06b0: 0a 20 20 20 20 69 73 20 6e 6f 74 20 72 65 71 75 . is not requ
06c0: 69 72 65 64 2e 3c 2f 70 3e 0a 0a 20 20 20 20 3c ired.</p>.. <
06d0: 70 3e 4e 6f 74 65 3a 20 49 66 20 79 6f 75 20 61 p>Note: If you a
06e0: 72 65 20 62 65 68 69 6e 64 20 61 20 72 65 73 74 re behind a rest
06f0: 72 69 63 74 69 76 65 20 66 69 72 65 77 61 6c 6c rictive firewall
0700: 2c 20 79 6f 75 20 6d 69 67 68 74 20 6e 65 65 64 , you might need
0710: 0a 20 20 20 20 74 6f 20 3c 61 20 68 72 65 66 3d . to <a href=
0720: 22 23 70 72 6f 78 79 22 3e 73 70 65 63 69 66 79 "#proxy">specify
0730: 20 61 6e 20 48 54 54 50 20 70 72 6f 78 79 3c 2f an HTTP proxy</
0740: 61 3e 20 74 6f 20 75 73 65 2e 3c 2f 70 3e 0a 20 a> to use.</p>.
0750: 20 20 20 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 .</blockquote
0760: 3e 3c 68 32 3e 53 74 61 72 74 69 6e 67 20 41 20 ><h2>Starting A
0770: 4e 65 77 20 50 72 6f 6a 65 63 74 3c 2f 68 32 3e New Project</h2>
0780: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 <blockquote>..
0790: 20 20 3c 70 3e 54 6f 20 73 74 61 72 74 20 61 20 <p>To start a
07a0: 6e 65 77 20 70 72 6f 6a 65 63 74 20 77 69 74 68 new project with
07b0: 20 66 6f 73 73 69 6c 2c 20 63 72 65 61 74 65 20 fossil, create
07c0: 61 20 6e 65 77 20 65 6d 70 74 79 20 72 65 70 6f a new empty repo
07d0: 73 69 74 6f 72 79 0a 20 20 20 20 74 68 69 73 20 sitory. this
07e0: 77 61 79 3a 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 way:</p>. .
07f0: 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 <blockquote>.
0800: 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6e 65 77 <b>fossil new
0810: 20 3c 2f 62 3e 3c 69 3e 20 72 65 70 6f 73 69 74 </b><i> reposit
0820: 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e ory-filename</i>
0830: 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 . </blockquot
0840: 65 3e 0a 20 20 20 20 0a 3c 2f 62 6c 6f 63 6b 71 e>. .</blockq
0850: 75 6f 74 65 3e 3c 68 32 3e 43 6f 6e 66 69 67 75 uote><h2>Configu
0860: 72 69 6e 67 20 59 6f 75 72 20 4c 6f 63 61 6c 20 ring Your Local
0870: 52 65 70 6f 73 69 74 6f 72 79 3c 2f 68 32 3e 3c Repository</h2><
0880: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 blockquote>.
0890: 0a 20 20 20 20 3c 70 3e 57 68 65 6e 20 79 6f 75 . <p>When you
08a0: 20 63 72 65 61 74 65 20 61 20 6e 65 77 20 72 65 create a new re
08b0: 70 6f 73 69 74 6f 72 79 2c 20 65 69 74 68 65 72 pository, either
08c0: 20 62 79 20 63 6c 6f 6e 69 6e 67 20 61 6e 20 65 by cloning an e
08d0: 78 69 73 74 69 6e 67 0a 20 20 20 20 70 72 6f 6a xisting. proj
08e0: 65 63 74 20 6f 72 20 63 72 65 61 74 65 20 61 20 ect or create a
08f0: 6e 65 77 20 70 72 6f 6a 65 63 74 20 6f 66 20 79 new project of y
0900: 6f 75 72 20 6f 77 6e 2c 20 79 6f 75 20 75 73 75 our own, you usu
0910: 61 6c 6c 79 20 77 61 6e 74 20 74 6f 20 64 6f 20 ally want to do
0920: 73 6f 6d 65 0a 20 20 20 20 6c 6f 63 61 6c 20 63 some. local c
0930: 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 20 20 54 onfiguration. T
0940: 68 69 73 20 69 73 20 65 61 73 69 6c 79 20 61 63 his is easily ac
0950: 63 6f 6d 70 6c 69 73 68 65 64 20 75 73 69 6e 67 complished using
0960: 20 74 68 65 20 77 65 62 73 65 72 76 65 72 0a 20 the webserver.
0970: 20 20 20 74 68 61 74 20 69 73 20 62 75 69 6c 74 that is built
0980: 20 69 6e 74 6f 20 66 6f 73 73 69 6c 2e 20 20 53 into fossil. S
0990: 74 61 72 74 20 74 68 65 20 66 6f 73 73 69 6c 20 tart the fossil
09a0: 77 65 62 73 65 72 76 65 72 20 6c 69 6b 65 20 74 webserver like t
09b0: 68 69 73 3a 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 his:</p>. .
09c0: 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 <blockquote>.
09d0: 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 75 69 20 <b>fossil ui
09e0: 3c 2f 62 3e 3c 69 3e 20 72 65 70 6f 73 69 74 6f </b><i> reposito
09f0: 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 0a ry-filename</i>.
0a00: 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 </blockquote
0a10: 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 69 73 20 73 >.. <p>This s
0a20: 74 61 72 74 73 20 61 20 77 65 62 73 65 72 76 65 tarts a webserve
0a30: 72 20 6c 69 73 74 65 6e 69 6e 67 20 6f 6e 20 70 r listening on p
0a40: 6f 72 74 20 38 30 38 30 2e 20 20 59 6f 75 20 63 ort 8080. You c
0a50: 61 6e 0a 20 20 20 20 73 70 65 63 69 66 79 20 61 an. specify a
0a60: 20 64 69 66 66 65 72 65 6e 74 20 70 6f 72 74 20 different port
0a70: 75 73 69 6e 67 20 74 68 65 20 3c 62 3e 2d 70 6f using the <b>-po
0a80: 72 74 3c 2f 62 3e 20 6f 70 74 69 6f 6e 20 6f 6e rt</b> option on
0a90: 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e the command-lin
0aa0: 65 2e 0a 20 20 20 20 41 66 74 65 72 20 74 68 65 e.. After the
0ab0: 20 73 65 72 76 65 72 20 69 73 20 72 75 6e 6e 69 server is runni
0ac0: 6e 67 2c 20 66 6f 73 73 69 6c 20 77 69 6c 6c 20 ng, fossil will
0ad0: 74 68 65 6e 20 61 74 74 65 6d 70 74 20 74 6f 20 then attempt to
0ae0: 6c 61 75 6e 63 68 20 79 6f 75 72 0a 20 20 20 20 launch your.
0af0: 77 65 62 20 62 72 6f 77 73 65 72 20 61 6e 64 20 web browser and
0b00: 6d 61 6b 65 20 69 74 20 70 6f 69 6e 74 20 74 6f make it point to
0b10: 20 74 68 69 73 20 77 65 62 20 73 65 72 76 65 72 this web server
0b20: 2e 20 20 49 66 20 79 6f 75 72 20 73 79 73 74 65 . If your syste
0b30: 6d 0a 20 20 20 20 68 61 73 20 61 6e 20 75 6e 75 m. has an unu
0b40: 73 75 61 6c 20 63 6f 6e 66 69 67 75 72 61 74 69 sual configurati
0b50: 6f 6e 2c 20 66 6f 73 73 69 6c 20 6d 69 67 68 74 on, fossil might
0b60: 20 6e 6f 74 20 62 65 20 61 62 6c 65 20 74 6f 20 not be able to
0b70: 66 69 67 75 72 65 20 6f 75 74 0a 20 20 20 20 68 figure out. h
0b80: 6f 77 20 74 6f 20 73 74 61 72 74 20 79 6f 75 72 ow to start your
0b90: 20 77 65 62 20 62 72 6f 77 73 65 72 2e 20 20 49 web browser. I
0ba0: 6e 20 74 68 61 74 20 63 61 73 65 2c 20 73 74 61 n that case, sta
0bb0: 72 74 20 74 68 65 20 77 65 62 20 62 72 6f 77 73 rt the web brows
0bc0: 65 72 0a 20 20 20 20 79 6f 75 72 73 65 6c 66 20 er. yourself
0bd0: 61 6e 64 20 70 6f 69 6e 74 20 69 74 20 61 74 20 and point it at
0be0: 68 74 74 70 3a 2f 2f 6c 6f 63 61 6c 68 6f 73 74 http://localhost
0bf0: 3a 38 30 38 30 2f 2e 20 20 43 6c 69 63 6b 20 6f :8080/. Click o
0c00: 6e 20 74 68 65 0a 20 20 20 20 22 53 65 74 75 70 n the. "Setup
0c10: 22 20 6c 69 6e 6b 20 6f 6e 20 74 68 65 20 6d 65 " link on the me
0c20: 6e 75 20 62 61 72 20 74 6f 20 73 74 61 72 74 20 nu bar to start
0c30: 63 6f 6e 66 69 67 75 72 69 6e 67 20 79 6f 75 72 configuring your
0c40: 20 72 65 70 6f 73 69 74 6f 72 79 2e 3c 2f 70 3e repository.</p>
0c50: 0a 20 20 20 20 0a 20 20 20 20 3c 70 3e 42 79 20 . . <p>By
0c60: 64 65 66 61 75 6c 74 2c 20 66 6f 73 73 69 6c 20 default, fossil
0c70: 64 6f 65 73 20 6e 6f 74 20 72 65 71 75 69 72 65 does not require
0c80: 20 61 20 6c 6f 67 69 6e 20 66 6f 72 20 48 54 54 a login for HTT
0c90: 50 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 0a 20 20 P connections.
0ca0: 20 20 63 6f 6d 69 6e 67 20 69 6e 20 66 72 6f 6d coming in from
0cb0: 20 74 68 65 20 49 50 20 6c 6f 6f 70 62 61 63 6b the IP loopback
0cc0: 20 61 64 64 72 65 73 73 20 31 32 37 2e 30 2e 30 address 127.0.0
0cd0: 2e 31 2e 20 20 59 6f 75 20 63 61 6e 2c 20 61 6e .1. You can, an
0ce0: 64 20 70 65 72 68 61 70 73 0a 20 20 20 20 73 68 d perhaps. sh
0cf0: 6f 75 6c 64 2c 20 63 68 61 6e 67 65 20 74 68 69 ould, change thi
0d00: 73 20 61 66 74 65 72 20 79 6f 75 20 63 72 65 61 s after you crea
0d10: 74 65 20 61 20 66 65 77 20 75 73 65 72 73 2e 3c te a few users.<
0d20: 2f 70 3e 0a 20 20 20 20 0a 20 20 20 20 3c 70 3e /p>. . <p>
0d30: 57 68 65 6e 20 79 6f 75 20 61 72 65 20 66 69 6e When you are fin
0d40: 69 73 68 65 64 20 63 6f 6e 66 69 67 75 72 69 6e ished configurin
0d50: 67 2c 20 6a 75 73 74 20 70 72 65 73 73 20 43 6f g, just press Co
0d60: 6e 74 72 6f 6c 2d 43 20 6f 72 20 75 73 65 0a 20 ntrol-C or use.
0d70: 20 20 20 74 68 65 20 3c 62 3e 6b 69 6c 6c 3c 2f the <b>kill</
0d80: 62 3e 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 73 68 b> command to sh
0d90: 75 74 20 64 6f 77 6e 20 74 68 65 20 6d 69 6e 69 ut down the mini
0da0: 2d 73 65 72 76 65 72 2e 3c 2f 70 3e 0a 0a 3c 2f -server.</p>..</
0db0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 43 blockquote><h2>C
0dc0: 68 65 63 6b 69 6e 67 20 4f 75 74 20 41 20 4c 6f hecking Out A Lo
0dd0: 63 61 6c 20 54 72 65 65 3c 2f 68 32 3e 3c 62 6c cal Tree</h2><bl
0de0: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c ockquote>.. <
0df0: 70 3e 54 6f 20 77 6f 72 6b 20 6f 6e 20 61 20 70 p>To work on a p
0e00: 72 6f 6a 65 63 74 20 69 6e 20 66 6f 73 73 69 6c roject in fossil
0e10: 2c 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 63 68 , you need to ch
0e20: 65 63 6b 20 6f 75 74 20 61 20 6c 6f 63 61 6c 0a eck out a local.
0e30: 20 20 20 20 63 6f 70 79 20 6f 66 20 74 68 65 20 copy of the
0e40: 73 6f 75 72 63 65 20 74 72 65 65 2e 20 20 43 72 source tree. Cr
0e50: 65 61 74 65 20 74 68 65 20 64 69 72 65 63 74 6f eate the directo
0e60: 72 79 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 62 ry you want to b
0e70: 65 0a 20 20 20 20 74 68 65 20 72 6f 6f 74 20 6f e. the root o
0e80: 66 20 79 6f 75 72 20 74 72 65 65 20 61 6e 64 20 f your tree and
0e90: 63 64 20 69 6e 74 6f 20 74 68 61 74 20 64 69 72 cd into that dir
0ea0: 65 63 74 6f 72 79 2e 20 20 54 68 65 6e 0a 20 20 ectory. Then.
0eb0: 20 20 64 6f 20 74 68 69 73 3a 3c 2f 70 3e 0a 20 do this:</p>.
0ec0: 20 20 20 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 . <blockqu
0ed0: 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 ote>. <b>foss
0ee0: 69 6c 20 6f 70 65 6e 20 3c 2f 62 3e 3c 69 3e 20 il open </b><i>
0ef0: 72 65 70 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e repository-filen
0f00: 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c ame</i>. </bl
0f10: 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 0a 20 ockquote>. .
0f20: 20 20 20 3c 70 3e 54 68 69 73 20 6c 65 61 76 65 <p>This leave
0f30: 73 20 79 6f 75 20 77 69 74 68 20 74 68 65 20 6e s you with the n
0f40: 65 77 65 73 74 20 76 65 72 73 69 6f 6e 20 6f 66 ewest version of
0f50: 20 74 68 65 20 74 72 65 65 0a 20 20 20 20 63 68 the tree. ch
0f60: 65 63 6b 65 64 20 6f 75 74 2e 20 20 20 20 0a 20 ecked out. .
0f70: 20 20 20 46 72 6f 6d 20 61 6e 79 77 68 65 72 65 From anywhere
0f80: 20 75 6e 64 65 72 6e 65 61 74 68 20 74 68 65 20 underneath the
0f90: 72 6f 6f 74 20 6f 66 20 79 6f 75 72 20 6c 6f 63 root of your loc
0fa0: 61 6c 20 74 72 65 65 2c 20 79 6f 75 0a 20 20 20 al tree, you.
0fb0: 20 63 61 6e 20 74 79 70 65 20 63 6f 6d 6d 61 6e can type comman
0fc0: 64 73 20 6c 69 6b 65 20 74 68 65 20 66 6f 6c 6c ds like the foll
0fd0: 6f 77 69 6e 67 20 74 6f 20 66 69 6e 64 20 6f 75 owing to find ou
0fe0: 74 20 74 68 65 20 73 74 61 74 75 73 20 6f 66 0a t the status of.
0ff0: 20 20 20 20 79 6f 75 72 20 6c 6f 63 61 6c 20 74 your local t
1000: 72 65 65 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 ree:</p>.. <b
1010: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c lockquote>. <
1020: 62 3e 66 6f 73 73 69 6c 20 69 6e 66 6f 3c 2f 62 b>fossil info</b
1030: 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 ><br>. <b>fos
1040: 73 69 6c 20 73 74 61 74 75 73 3c 2f 62 3e 3c 62 sil status</b><b
1050: 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c r>. <b>fossil
1060: 20 63 68 61 6e 67 65 73 3c 2f 62 3e 3c 62 72 3e changes</b><br>
1070: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 74 . <b>fossil t
1080: 69 6d 65 6c 69 6e 65 3c 2f 62 3e 3c 62 72 3e 0a imeline</b><br>.
1090: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6c 65 <b>fossil le
10a0: 61 76 65 73 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 aves</b><br>.
10b0: 20 3c 62 3e 66 6f 73 73 69 6c 20 6c 73 3c 2f 62 <b>fossil ls</b
10c0: 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 ><br>. <b>fos
10d0: 73 69 6c 20 62 72 61 6e 63 68 65 73 3c 2f 62 3e sil branches</b>
10e0: 3c 62 72 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b <br>. </block
10f0: 71 75 6f 74 65 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 quote>..</blockq
1100: 75 6f 74 65 3e 3c 68 32 3e 4d 61 6b 69 6e 67 20 uote><h2>Making
1110: 43 68 61 6e 67 65 73 3c 2f 68 32 3e 3c 62 6c 6f Changes</h2><blo
1120: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 ckquote>.. <p
1130: 3e 54 6f 20 61 64 64 20 6e 65 77 20 66 69 6c 65 >To add new file
1140: 73 20 74 6f 20 79 6f 75 72 20 70 72 6f 6a 65 63 s to your projec
1150: 74 2c 20 6f 72 20 72 65 6d 6f 76 65 20 6f 6c 64 t, or remove old
1160: 20 66 69 6c 65 73 2c 20 75 73 65 20 74 68 65 73 files, use thes
1170: 65 0a 20 20 20 20 63 6f 6d 6d 61 6e 64 73 3a 3c e. commands:<
1180: 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 /p>.. <blockq
1190: 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 uote>. <b>fos
11a0: 73 69 6c 20 61 64 64 3c 2f 62 3e 20 3c 69 3e 66 sil add</b> <i>f
11b0: 69 6c 65 2e 2e 2e 3c 2f 69 3e 3c 62 72 3e 0a 20 ile...</i><br>.
11c0: 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 72 6d 3c <b>fossil rm<
11d0: 2f 62 3e 20 3c 69 3e 66 69 6c 65 2e 2e 2e 3c 2f /b> <i>file...</
11e0: 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 i>. </blockqu
11f0: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 59 6f 75 ote>.. <p>You
1200: 20 63 61 6e 20 61 6c 73 6f 20 65 64 69 74 20 66 can also edit f
1210: 69 6c 65 73 20 66 72 65 65 6c 79 2e 20 20 4f 6e iles freely. On
1220: 63 65 20 79 6f 75 20 61 72 65 20 72 65 61 64 79 ce you are ready
1230: 20 74 6f 20 63 6f 6d 6d 69 74 0a 20 20 20 20 79 to commit. y
1240: 6f 75 72 20 63 68 61 6e 67 65 73 2c 20 74 79 70 our changes, typ
1250: 65 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f e:</p>.. <blo
1260: 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e ckquote>. <b>
1270: 66 6f 73 73 69 6c 20 63 6f 6d 6d 69 74 3c 2f 62 fossil commit</b
1280: 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f >. </blockquo
1290: 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 59 6f 75 20 te>.. <p>You
12a0: 77 69 6c 6c 20 62 65 20 70 72 6f 6d 70 74 65 64 will be prompted
12b0: 20 66 6f 72 20 63 68 65 63 6b 2d 69 6e 20 63 6f for check-in co
12c0: 6d 6d 65 6e 74 73 20 75 73 69 6e 67 20 77 68 61 mments using wha
12d0: 74 65 76 65 72 20 65 64 69 74 6f 72 0a 20 20 20 tever editor.
12e0: 20 69 73 20 73 70 65 63 69 66 69 65 64 20 62 79 is specified by
12f0: 20 79 6f 75 72 20 56 49 53 55 41 4c 20 6f 72 20 your VISUAL or
1300: 45 44 49 54 4f 52 20 65 6e 76 69 72 6f 6e 6d 65 EDITOR environme
1310: 6e 74 20 76 61 72 69 61 62 6c 65 2e 20 20 49 66 nt variable. If
1320: 20 79 6f 75 0a 20 20 20 20 68 61 76 65 20 47 50 you. have GP
1330: 47 20 69 6e 73 74 61 6c 6c 65 64 2c 20 79 6f 75 G installed, you
1340: 20 6d 61 79 20 62 65 20 70 72 6f 6d 70 74 65 64 may be prompted
1350: 20 66 6f 72 20 79 6f 75 72 20 47 50 47 20 70 61 for your GPG pa
1360: 73 73 70 68 72 61 73 65 20 73 6f 0a 20 20 20 20 ssphrase so.
1370: 74 68 61 74 20 74 68 65 20 63 68 65 63 6b 2d 69 that the check-i
1380: 6e 20 63 61 6e 20 62 65 20 73 69 67 6e 65 64 20 n can be signed
1390: 77 69 74 68 20 79 6f 75 72 20 47 50 47 20 73 69 with your GPG si
13a0: 67 6e 61 74 75 72 65 2e 20 20 41 66 74 65 72 0a gnature. After.
13b0: 20 20 20 20 74 68 69 73 20 79 6f 75 72 20 63 68 this your ch
13c0: 61 6e 67 65 73 20 77 69 6c 6c 20 62 65 20 63 68 anges will be ch
13d0: 65 63 6b 65 64 20 69 6e 2e 3c 2f 70 3e 0a 0a 3c ecked in.</p>..<
13e0: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e /blockquote><h2>
13f0: 53 68 61 72 69 6e 67 20 43 68 61 6e 67 65 73 3c Sharing Changes<
1400: 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e /h2><blockquote>
1410: 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 63 68 61 .. <p>The cha
1420: 6e 67 65 73 20 79 6f 75 20 3c 62 3e 63 6f 6d 6d nges you <b>comm
1430: 69 74 3c 2f 62 3e 20 61 72 65 20 6f 6e 6c 79 20 it</b> are only
1440: 6f 6e 20 79 6f 75 72 20 6c 6f 63 61 6c 20 72 65 on your local re
1450: 70 6f 73 69 74 6f 72 79 2e 0a 20 20 20 20 54 6f pository.. To
1460: 20 73 68 61 72 65 20 74 68 6f 73 65 20 63 68 61 share those cha
1470: 6e 67 65 73 20 77 69 74 68 20 6f 74 68 65 72 20 nges with other
1480: 72 65 70 6f 73 69 74 6f 72 69 65 73 2c 20 64 6f repositories, do
1490: 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 :</p>.. <bloc
14a0: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 kquote>. <b>f
14b0: 6f 73 73 69 6c 20 70 75 73 68 3c 2f 62 3e 20 3c ossil push</b> <
14c0: 69 3e 55 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c 2f i>URL</i>. </
14d0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 blockquote>..
14e0: 20 3c 70 3e 57 68 65 72 65 20 3c 69 3e 55 52 4c <p>Where <i>URL
14f0: 3c 2f 69 3e 20 69 73 20 74 68 65 20 68 74 74 70 </i> is the http
1500: 3a 20 55 52 4c 20 6f 66 20 74 68 65 20 73 65 72 : URL of the ser
1510: 76 65 72 20 72 65 70 6f 73 69 74 6f 72 79 20 79 ver repository y
1520: 6f 75 0a 20 20 20 20 77 61 6e 74 20 74 6f 20 73 ou. want to s
1530: 68 61 72 65 20 79 6f 75 72 20 63 68 61 6e 67 65 hare your change
1540: 73 20 77 69 74 68 2e 20 20 49 66 20 79 6f 75 20 s with. If you
1550: 6f 6d 69 74 20 74 68 65 20 3c 69 3e 55 52 4c 3c omit the <i>URL<
1560: 2f 69 3e 20 61 72 67 75 6d 65 6e 74 2c 0a 20 20 /i> argument,.
1570: 20 20 66 6f 73 73 69 6c 20 77 69 6c 6c 20 75 73 fossil will us
1580: 65 20 77 68 61 74 65 76 65 72 20 73 65 72 76 65 e whatever serve
1590: 72 20 79 6f 75 20 6d 6f 73 74 20 72 65 63 65 6e r you most recen
15a0: 74 6c 79 20 73 79 6e 63 65 64 20 77 69 74 68 2e tly synced with.
15b0: 3c 2f 70 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 </p>.. <p>The
15c0: 20 3c 62 3e 70 75 73 68 3c 2f 62 3e 20 63 6f 6d <b>push</b> com
15d0: 6d 61 6e 64 20 6f 6e 6c 79 20 73 65 6e 64 73 20 mand only sends
15e0: 79 6f 75 72 20 63 68 61 6e 67 65 73 20 74 6f 20 your changes to
15f0: 6f 74 68 65 72 73 2e 20 20 54 6f 0a 20 20 20 20 others. To.
1600: 52 65 63 65 69 76 65 20 63 68 61 6e 67 65 73 20 Receive changes
1610: 66 72 6f 6d 20 6f 74 68 65 72 73 2c 20 75 73 65 from others, use
1620: 20 3c 62 3e 70 75 6c 6c 3c 2f 62 3e 2e 20 20 4f <b>pull</b>. O
1630: 72 20 67 6f 20 62 6f 74 68 20 77 61 79 73 20 61 r go both ways a
1640: 74 0a 20 20 20 20 6f 6e 63 65 20 75 73 69 6e 67 t. once using
1650: 20 3c 62 3e 73 79 6e 63 3c 2f 62 3e 3a 3c 2f 70 <b>sync</b>:</p
1660: 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f >.. <blockquo
1670: 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 te>. <b>fossi
1680: 6c 20 70 75 6c 6c 3c 2f 62 3e 20 3c 69 3e 55 52 l pull</b> <i>UR
1690: 4c 3c 2f 69 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 L</i><br>. <b
16a0: 3e 66 6f 73 73 69 6c 20 73 79 6e 63 3c 2f 62 3e >fossil sync</b>
16b0: 20 3c 69 3e 55 52 4c 3c 2f 69 3e 0a 20 20 20 20 <i>URL</i>.
16c0: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 </blockquote>..
16d0: 20 20 20 3c 70 3e 57 68 65 6e 20 79 6f 75 20 70 <p>When you p
16e0: 75 6c 6c 20 69 6e 20 63 68 61 6e 67 65 73 20 66 ull in changes f
16f0: 72 6f 6d 20 6f 74 68 65 72 73 2c 20 74 68 65 79 rom others, they
1700: 20 67 6f 20 69 6e 74 6f 20 79 6f 75 72 20 72 65 go into your re
1710: 70 6f 73 69 74 6f 72 79 2c 0a 20 20 20 20 6e 6f pository,. no
1720: 74 20 69 6e 74 6f 20 79 6f 75 72 20 63 68 65 63 t into your chec
1730: 6b 65 64 2d 6f 75 74 20 6c 6f 63 61 6c 20 74 72 ked-out local tr
1740: 65 65 2e 20 20 54 6f 20 67 65 74 20 74 68 65 20 ee. To get the
1750: 63 68 61 6e 67 65 73 20 69 6e 74 6f 20 79 6f 75 changes into you
1760: 72 0a 20 20 20 20 6c 6f 63 61 6c 20 74 72 65 65 r. local tree
1770: 2c 20 75 73 65 20 3c 62 3e 75 70 64 61 74 65 3c , use <b>update<
1780: 2f 62 3e 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 /b>:</p>.. <b
1790: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c lockquote>. <
17a0: 62 3e 66 6f 73 73 69 6c 20 75 70 64 61 74 65 3c b>fossil update<
17b0: 2f 62 3e 20 3c 69 3e 41 49 44 3c 2f 69 3e 0a 20 /b> <i>AID</i>.
17c0: 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e </blockquote>
17d0: 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 3c 69 3e .. <p>The <i>
17e0: 41 49 44 3c 2f 69 3e 20 69 73 20 73 6f 6d 65 20 AID</i> is some
17f0: 75 6e 69 71 75 65 20 61 62 62 72 65 76 69 61 74 unique abbreviat
1800: 69 6f 6e 20 74 6f 20 74 68 65 20 34 30 2d 63 68 ion to the 40-ch
1810: 61 72 61 63 74 65 72 0a 20 20 20 20 61 72 74 69 aracter. arti
1820: 66 61 63 74 20 69 64 65 6e 74 69 66 69 65 72 20 fact identifier
1830: 28 41 49 44 29 20 66 6f 72 20 61 20 70 61 72 74 (AID) for a part
1840: 69 63 75 6c 61 72 20 63 68 65 63 6b 2d 69 6e 2e icular check-in.
1850: 20 20 49 66 20 79 6f 75 20 6f 6d 69 74 0a 20 20 If you omit.
1860: 20 20 74 68 65 20 3c 69 3e 41 49 44 3c 2f 69 3e the <i>AID</i>
1870: 20 66 6f 73 73 69 6c 20 6d 6f 76 65 73 20 79 6f fossil moves yo
1880: 75 20 74 6f 20 74 68 65 0a 20 20 20 20 6c 65 61 u to the. lea
1890: 66 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 f version of the
18a0: 20 62 72 61 6e 63 68 20 79 6f 75 72 20 61 72 65 branch your are
18b0: 20 63 75 72 72 65 6e 74 6c 79 20 6f 6e 2e 20 20 currently on.
18c0: 49 66 20 79 6f 75 72 20 62 72 61 6e 63 68 0a 20 If your branch.
18d0: 20 20 20 68 61 73 20 6d 75 6c 74 69 70 6c 65 20 has multiple
18e0: 6c 65 61 76 65 73 2c 20 79 6f 75 20 67 65 74 20 leaves, you get
18f0: 61 6e 20 65 72 72 6f 72 20 2d 20 79 6f 75 27 6c an error - you'l
1900: 6c 20 68 61 76 65 20 74 6f 20 73 70 65 63 69 66 l have to specif
1910: 79 20 74 68 65 0a 20 20 20 20 6c 65 61 66 20 79 y the. leaf y
1920: 6f 75 20 77 61 6e 74 20 75 73 69 6e 67 20 61 20 ou want using a
1930: 3c 69 3e 41 49 44 3c 2f 69 3e 20 61 72 67 75 6d <i>AID</i> argum
1940: 65 6e 74 2e 3c 2f 70 3e 0a 0a 3c 2f 62 6c 6f 63 ent.</p>..</bloc
1950: 6b 71 75 6f 74 65 3e 3c 68 32 3e 42 72 61 6e 63 kquote><h2>Branc
1960: 68 69 6e 67 20 41 6e 64 20 4d 65 72 67 69 6e 67 hing And Merging
1970: 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 </h2><blockquote
1980: 3e 0a 0a 20 20 20 20 3c 70 3e 59 6f 75 20 63 61 >.. <p>You ca
1990: 6e 20 63 72 65 61 74 65 20 62 72 61 6e 63 68 65 n create branche
19a0: 73 20 62 79 20 64 6f 69 6e 67 20 6d 75 6c 74 69 s by doing multi
19b0: 70 6c 65 20 63 6f 6d 6d 69 74 73 20 6f 66 66 20 ple commits off
19c0: 6f 66 20 74 68 65 0a 20 20 20 20 73 61 6d 65 20 of the. same
19d0: 62 61 73 65 20 76 65 72 73 69 6f 6e 2e 20 20 54 base version. T
19e0: 6f 20 6d 65 72 67 65 20 74 6f 20 62 72 61 6e 63 o merge to branc
19f0: 68 65 73 20 62 61 63 6b 20 74 6f 67 65 74 68 65 hes back togethe
1a00: 72 2c 20 66 69 72 73 74 0a 20 20 20 20 3c 62 3e r, first. <b>
1a10: 75 70 64 61 74 65 3c 2f 62 3e 20 74 6f 20 74 68 update</b> to th
1a20: 65 20 6c 65 61 66 20 6f 66 20 6f 6e 65 20 62 72 e leaf of one br
1a30: 61 6e 63 68 2e 20 20 54 68 65 6e 20 64 6f 20 61 anch. Then do a
1a40: 20 3c 62 3e 6d 65 72 67 65 3c 2f 62 3e 0a 20 20 <b>merge</b>.
1a50: 20 20 6f 66 20 74 68 65 20 6c 65 61 66 20 6f 66 of the leaf of
1a60: 20 74 68 65 20 6f 74 68 65 72 20 62 72 61 6e 63 the other branc
1a70: 68 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f h:</p>.. <blo
1a80: 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e ckquote>. <b>
1a90: 66 6f 73 73 69 6c 20 6d 65 72 67 65 3c 2f 62 3e fossil merge</b>
1aa0: 20 3c 69 3e 41 49 44 3c 2f 69 3e 0a 20 20 20 20 <i>AID</i>.
1ab0: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 </blockquote>..
1ac0: 20 20 20 3c 70 3e 54 65 73 74 20 74 6f 20 6d 61 <p>Test to ma
1ad0: 6b 65 20 73 75 72 65 20 79 6f 75 72 20 6d 65 72 ke sure your mer
1ae0: 67 65 20 64 69 64 6e 27 74 20 6d 65 73 73 20 75 ge didn't mess u
1af0: 70 20 74 68 65 20 63 6f 64 65 2c 20 74 68 65 6e p the code, then
1b00: 0a 20 20 20 20 3c 62 3e 63 6f 6d 6d 69 74 3c 2f . <b>commit</
1b10: 62 3e 20 61 6e 64 20 70 6f 73 73 69 62 6c 79 20 b> and possibly
1b20: 61 6c 73 6f 20 3c 62 3e 70 75 73 68 3c 2f 62 3e also <b>push</b>
1b30: 20 79 6f 75 72 20 63 68 61 6e 67 65 73 2e 20 20 your changes.
1b40: 20 52 65 6d 65 6d 62 65 72 0a 20 20 20 20 74 68 Remember. th
1b50: 61 74 20 6e 6f 62 6f 64 79 20 65 6c 73 65 20 63 at nobody else c
1b60: 61 6e 20 73 65 65 20 79 6f 75 72 20 63 68 61 6e an see your chan
1b70: 67 65 73 20 75 6e 74 69 6c 20 79 6f 75 20 3c 62 ges until you <b
1b80: 3e 63 6f 6d 6d 69 74 3c 2f 62 3e 20 61 6e 64 0a >commit</b> and.
1b90: 20 20 20 20 69 66 20 6f 74 68 65 72 20 61 72 65 if other are
1ba0: 20 75 73 69 6e 67 20 61 20 64 69 66 66 65 72 65 using a differe
1bb0: 6e 74 20 72 65 70 6f 73 69 74 6f 72 79 20 79 6f nt repository yo
1bc0: 75 20 77 69 6c 6c 20 61 6c 73 6f 20 6e 65 65 64 u will also need
1bd0: 20 74 6f 0a 20 20 20 20 3c 62 3e 70 75 73 68 3c to. <b>push<
1be0: 2f 62 3e 2e 3c 2f 70 3e 0a 0a 3c 61 20 6e 61 6d /b>.</p>..<a nam
1bf0: 65 3d 22 73 65 72 76 65 72 73 65 74 75 70 22 3e e="serversetup">
1c00: 3c 2f 61 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 </a>.</blockquot
1c10: 65 3e 3c 68 32 3e 53 65 74 74 69 6e 67 20 55 70 e><h2>Setting Up
1c20: 20 41 20 53 65 72 76 65 72 3c 2f 68 32 3e 3c 62 A Server</h2><b
1c30: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 lockquote>..
1c40: 3c 70 3e 54 68 65 20 65 61 73 69 65 73 74 20 77 <p>The easiest w
1c50: 61 79 20 74 6f 20 73 65 74 20 75 70 20 61 20 73 ay to set up a s
1c60: 65 72 76 65 72 20 69 73 3a 3c 2f 70 3e 0a 0a 20 erver is:</p>..
1c70: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a <blockquote>.
1c80: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 73 65 <b>fossil se
1c90: 72 76 65 72 3c 2f 62 3e 20 3c 69 3e 72 65 70 6f rver</b> <i>repo
1ca0: 73 69 74 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 3c sitory-filename<
1cb0: 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 /i>. </blockq
1cc0: 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 4f 72 uote>.. <p>Or
1cd0: 3c 2f 62 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b </b>.. <block
1ce0: 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f quote>. <b>fo
1cf0: 73 73 69 6c 20 75 69 3c 2f 62 3e 20 3c 69 3e 72 ssil ui</b> <i>r
1d00: 65 70 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e 61 epository-filena
1d10: 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f me</i>. </blo
1d20: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 ckquote>.. <p
1d30: 3e 54 68 65 20 64 69 66 66 65 72 65 6e 63 65 20 >The difference
1d40: 62 65 74 77 65 65 6e 20 74 68 65 73 65 20 74 77 between these tw
1d50: 6f 20 63 6f 6d 6d 61 6e 64 20 69 73 20 74 68 61 o command is tha
1d60: 74 20 3c 62 3e 75 69 3c 2f 62 3e 0a 20 20 20 20 t <b>ui</b>.
1d70: 61 74 74 65 6d 70 74 73 20 74 6f 20 61 75 74 6f attempts to auto
1d80: 6d 61 74 69 63 61 6c 6c 79 20 73 74 61 72 74 20 matically start
1d90: 79 6f 75 72 20 77 65 62 20 62 72 6f 77 73 65 72 your web browser
1da0: 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 74 68 65 pointing at the
1db0: 0a 20 20 20 20 73 65 72 76 65 72 20 77 68 65 72 . server wher
1dc0: 65 61 73 20 3c 62 3e 73 65 72 76 65 72 3c 2f 62 eas <b>server</b
1dd0: 3e 20 64 6f 65 73 20 6e 6f 74 2e 0a 20 20 20 20 > does not..
1de0: 59 6f 75 20 63 61 6e 20 6f 6d 69 74 20 74 68 65 You can omit the
1df0: 20 3c 69 3e 72 65 70 6f 73 69 74 6f 72 79 2d 66 <i>repository-f
1e00: 69 6c 65 6e 61 6d 65 3c 2f 69 3e 20 69 66 20 79 ilename</i> if y
1e10: 6f 75 20 61 72 65 20 77 69 74 68 69 6e 0a 20 20 ou are within.
1e20: 20 20 61 20 63 68 65 63 6b 65 64 2d 6f 75 74 20 a checked-out
1e30: 6c 6f 63 61 6c 20 74 72 65 65 2e 20 20 54 68 69 local tree. Thi
1e40: 73 20 73 65 72 76 65 72 20 75 73 65 73 20 70 6f s server uses po
1e50: 72 74 20 38 30 38 30 20 62 79 20 64 65 66 61 75 rt 8080 by defau
1e60: 6c 74 0a 20 20 20 20 62 75 74 20 79 6f 75 20 63 lt. but you c
1e70: 61 6e 20 73 70 65 63 69 66 79 20 61 20 64 69 66 an specify a dif
1e80: 66 65 72 65 6e 74 20 70 6f 72 74 20 75 73 69 6e ferent port usin
1e90: 67 20 74 68 65 20 3c 62 3e 2d 70 6f 72 74 3c 2f g the <b>-port</
1ea0: 62 3e 20 63 6f 6d 6d 61 6e 64 2e 3c 2f 70 3e 0a b> command.</p>.
1eb0: 0a 20 20 20 20 3c 70 3e 43 6f 6d 6d 61 6e 64 2d . <p>Command-
1ec0: 6c 69 6e 65 20 73 65 72 76 65 72 73 20 6c 69 6b line servers lik
1ed0: 65 20 74 68 69 73 20 61 72 65 20 75 73 65 66 75 e this are usefu
1ee0: 6c 20 77 68 65 6e 20 74 77 6f 20 70 65 6f 70 6c l when two peopl
1ef0: 65 20 77 61 6e 74 0a 20 20 20 20 74 6f 20 73 68 e want. to sh
1f00: 61 72 65 20 61 20 72 65 70 6f 73 69 74 6f 72 79 are a repository
1f10: 20 6f 6e 20 74 65 6d 70 6f 72 61 72 79 20 6f 72 on temporary or
1f20: 20 61 64 2d 68 6f 63 20 62 61 73 69 73 2e 20 20 ad-hoc basis.
1f30: 46 6f 72 20 61 20 6d 6f 72 65 0a 20 20 20 20 70 For a more. p
1f40: 65 72 6d 61 6e 65 6e 74 20 69 6e 73 74 61 6c 6c ermanent install
1f50: 61 74 69 6f 6e 2c 20 79 6f 75 20 73 68 6f 75 6c ation, you shoul
1f60: 64 20 75 73 65 20 65 69 74 68 65 72 20 74 68 65 d use either the
1f70: 20 43 47 49 20 73 65 72 76 65 72 20 6f 72 20 74 CGI server or t
1f80: 68 65 0a 20 20 20 20 69 6e 65 74 64 20 73 65 72 he. inetd ser
1f90: 76 65 72 2e 0a 20 20 20 20 3c 61 20 6e 61 6d 65 ver.. <a name
1fa0: 3d 22 63 67 69 73 65 72 76 65 72 22 3e 3c 2f 61 ="cgiserver"></a
1fb0: 3e 0a 20 20 20 20 54 6f 20 75 73 65 20 74 68 65 >. To use the
1fc0: 20 43 47 49 20 73 65 72 76 65 72 2c 20 63 72 65 CGI server, cre
1fd0: 61 74 65 20 61 20 43 47 49 20 73 63 72 69 70 74 ate a CGI script
1fe0: 20 74 68 61 74 0a 20 20 20 20 6c 6f 6f 6b 73 20 that. looks
1ff0: 73 6f 6d 65 74 68 69 6e 67 20 6c 69 6b 65 20 74 something like t
2000: 68 69 73 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 his:</p>.. <b
2010: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 62 3e 0a 20 20 lockquote><b>.
2020: 20 20 23 21 2f 75 73 72 2f 6c 6f 63 61 6c 2f 62 #!/usr/local/b
2030: 69 6e 2f 66 6f 73 73 69 6c 3c 62 72 3e 0a 20 20 in/fossil<br>.
2040: 20 20 72 65 70 6f 73 69 74 6f 72 79 3a 20 2f 68 repository: /h
2050: 6f 6d 65 2f 70 72 6f 6a 31 2f 72 65 70 6f 73 31 ome/proj1/repos1
2060: 2e 66 6f 73 73 69 6c 0a 20 20 20 20 3c 2f 62 3e .fossil. </b>
2070: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 </blockquote>..
2080: 20 20 20 3c 70 3e 41 64 6a 75 73 74 20 74 68 65 <p>Adjust the
2090: 20 70 61 74 68 73 20 69 6e 20 74 68 69 73 20 43 paths in this C
20a0: 47 49 20 73 63 72 69 70 74 20 74 6f 20 6d 61 74 GI script to mat
20b0: 63 68 20 79 6f 75 72 20 69 6e 73 74 61 6c 6c 61 ch your installa
20c0: 74 69 6f 6e 0a 20 20 20 20 61 6e 64 20 6d 61 6b tion. and mak
20d0: 65 20 73 75 72 65 20 74 68 61 74 20 72 65 70 6f e sure that repo
20e0: 73 69 74 6f 72 79 20 66 69 6c 65 20 61 74 20 74 sitory file at t
20f0: 68 65 20 64 69 72 65 63 74 6f 72 79 20 74 68 61 he directory tha
2100: 74 20 63 6f 6e 74 61 69 6e 73 20 69 74 0a 20 20 t contains it.
2110: 20 20 61 72 65 20 62 6f 74 68 20 72 65 61 64 61 are both reada
2120: 62 6c 65 20 61 6e 64 20 77 72 69 74 61 62 6c 65 ble and writable
2130: 20 62 79 20 74 68 65 20 75 73 65 72 20 74 68 61 by the user tha
2140: 74 20 43 47 49 20 73 63 72 69 70 74 73 20 72 75 t CGI scripts ru
2150: 6e 20 61 73 2e 0a 20 20 20 20 54 68 65 6e 20 70 n as.. Then p
2160: 6f 69 6e 74 20 63 6c 69 65 6e 74 73 20 61 74 20 oint clients at
2170: 74 68 65 20 43 47 49 20 73 63 72 69 70 74 2e 20 the CGI script.
2180: 20 54 68 61 74 27 73 20 61 6c 6c 20 74 68 65 72 That's all ther
2190: 65 20 69 73 20 74 6f 20 69 74 21 3c 2f 70 3e 0a e is to it!</p>.
21a0: 0a 20 20 20 20 3c 61 20 6e 61 6d 65 3d 22 69 6e . <a name="in
21b0: 65 74 64 73 65 72 76 65 72 22 3e 3c 2f 61 3e 0a etdserver"></a>.
21c0: 20 20 20 20 3c 70 3e 59 6f 75 20 63 61 6e 20 61 <p>You can a
21d0: 6c 73 6f 20 72 75 6e 20 66 6f 73 73 69 6c 20 6f lso run fossil o
21e0: 66 66 20 6f 66 20 69 6e 65 74 64 20 6f 72 20 78 ff of inetd or x
21f0: 69 6e 65 74 64 2e 20 20 46 6f 72 20 61 6e 20 69 inetd. For an i
2200: 6e 65 74 64 0a 20 20 20 20 69 6e 73 74 61 6c 6c netd. install
2210: 61 74 69 6f 6e 2c 20 6d 61 6b 65 20 61 6e 20 65 ation, make an e
2220: 6e 74 72 79 20 69 6e 20 2f 65 74 63 2f 69 6e 65 ntry in /etc/ine
2230: 74 64 2e 63 6f 6e 66 20 74 68 61 74 20 6c 6f 6f td.conf that loo
2240: 6b 73 20 73 6f 6d 65 74 68 69 6e 67 0a 20 20 20 ks something.
2250: 20 6c 69 6b 65 20 74 68 69 73 3a 3c 2f 70 3e 0a like this:</p>.
2260: 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 . <blockquote
2270: 3e 3c 62 3e 0a 20 20 20 20 38 30 20 73 74 72 65 ><b>. 80 stre
2280: 61 6d 20 74 63 70 20 6e 6f 77 61 69 74 2e 31 30 am tcp nowait.10
2290: 30 30 20 72 6f 6f 74 20 2f 75 73 72 2f 62 69 6e 00 root /usr/bin
22a0: 2f 66 6f 73 73 69 6c 20 5c 3c 62 72 3e 0a 20 20 /fossil \<br>.
22b0: 20 20 20 20 20 20 2f 75 73 72 2f 62 69 6e 2f 66 /usr/bin/f
22c0: 6f 73 73 69 6c 20 68 74 74 70 20 2f 68 6f 6d 65 ossil http /home
22d0: 2f 70 72 6f 6a 31 2f 72 65 70 6f 73 31 2e 66 6f /proj1/repos1.fo
22e0: 73 73 69 6c 0a 20 20 20 20 3c 2f 62 3e 3c 2f 62 ssil. </b></b
22f0: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 lockquote>..
2300: 3c 70 3e 41 64 6a 75 73 74 20 74 68 65 20 70 61 <p>Adjust the pa
2310: 74 68 73 20 74 6f 20 73 75 69 74 20 79 6f 75 72 ths to suit your
2320: 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 2c 20 6f installation, o
2330: 66 20 63 6f 75 72 73 65 2e 20 20 4e 6f 74 69 63 f course. Notic
2340: 65 20 74 68 61 74 0a 20 20 20 20 66 6f 73 73 69 e that. fossi
2350: 6c 20 72 75 6e 73 20 61 73 20 72 6f 6f 74 2e 20 l runs as root.
2360: 20 54 68 69 73 20 69 73 20 6e 6f 74 20 72 65 71 This is not req
2370: 75 69 72 65 64 20 2d 20 79 6f 75 20 63 61 6e 20 uired - you can
2380: 72 75 6e 20 69 74 20 61 73 20 61 6e 0a 20 20 20 run it as an.
2390: 20 75 6e 70 72 69 76 69 6c 65 67 65 64 20 75 73 unprivileged us
23a0: 65 72 2e 20 20 42 75 74 20 69 74 20 69 73 20 6d er. But it is m
23b0: 6f 72 65 20 73 65 63 75 72 65 20 74 6f 20 72 75 ore secure to ru
23c0: 6e 20 66 6f 73 73 69 6c 20 61 73 20 72 6f 6f 74 n fossil as root
23d0: 2e 0a 20 20 20 20 57 68 65 6e 20 79 6f 75 20 64 .. When you d
23e0: 6f 20 72 75 6e 20 66 6f 73 73 69 6c 20 61 73 20 o run fossil as
23f0: 72 6f 6f 74 2c 20 69 74 20 61 75 74 6f 6d 61 74 root, it automat
2400: 69 63 61 6c 6c 79 20 70 75 74 73 20 69 74 73 65 ically puts itse
2410: 6c 66 20 69 6e 20 61 0a 20 20 20 20 63 68 72 6f lf in a. chro
2420: 6f 74 20 6a 61 69 6c 20 69 6e 20 74 68 65 20 73 ot jail in the s
2430: 61 6d 65 20 64 69 72 65 63 74 6f 72 79 20 61 73 ame directory as
2440: 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 2c the repository,
2450: 20 74 68 65 6e 20 64 72 6f 70 73 0a 20 20 20 20 then drops.
2460: 72 6f 6f 74 20 70 72 69 76 69 6c 65 67 65 73 20 root privileges
2470: 70 72 69 6f 72 20 74 6f 20 72 65 61 64 69 6e 67 prior to reading
2480: 20 61 6e 79 20 69 6e 66 6f 72 6d 61 74 69 6f 6e any information
2490: 20 66 72 6f 6d 20 74 68 65 20 72 65 71 75 65 73 from the reques
24a0: 74 2e 3c 2f 70 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 t.</p>..</blockq
24b0: 75 6f 74 65 3e 3c 61 20 6e 61 6d 65 3d 22 70 72 uote><a name="pr
24c0: 6f 78 79 22 3e 3c 2f 61 3e 3c 68 32 3e 48 54 54 oxy"></a><h2>HTT
24d0: 50 20 50 72 6f 78 69 65 73 3c 2f 68 32 3e 3c 62 P Proxies</h2><b
24e0: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 lockquote>..
24f0: 3c 70 3e 49 66 20 79 6f 75 20 61 72 65 20 62 65 <p>If you are be
2500: 68 69 6e 64 20 61 20 72 65 73 74 72 69 63 74 69 hind a restricti
2510: 76 65 20 66 69 72 65 77 61 6c 6c 20 74 68 61 74 ve firewall that
2520: 20 72 65 71 75 69 72 65 73 20 79 6f 75 20 74 6f requires you to
2530: 20 75 73 65 0a 20 20 20 20 61 6e 20 48 54 54 50 use. an HTTP
2540: 20 70 72 6f 78 79 20 74 6f 20 72 65 61 63 68 20 proxy to reach
2550: 74 68 65 20 69 6e 74 65 72 6e 65 74 2c 20 74 68 the internet, th
2560: 65 6e 20 79 6f 75 20 63 61 6e 20 63 6f 6e 66 69 en you can confi
2570: 67 75 72 65 20 74 68 65 20 70 72 6f 78 79 0a 20 gure the proxy.
2580: 20 20 20 69 6e 20 74 68 72 65 65 20 64 69 66 66 in three diff
2590: 65 72 65 6e 74 20 77 61 79 73 2e 20 20 59 6f 75 erent ways. You
25a0: 20 63 61 6e 20 74 65 6c 6c 20 66 6f 73 73 69 6c can tell fossil
25b0: 20 61 62 6f 75 74 20 79 6f 75 72 20 70 72 6f 78 about your prox
25c0: 79 20 75 73 69 6e 67 0a 20 20 20 20 61 20 63 6f y using. a co
25d0: 6d 6d 61 6e 64 2d 6c 69 6e 65 20 6f 70 74 69 6f mmand-line optio
25e0: 6e 20 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 74 68 n on commands th
25f0: 61 74 20 75 73 65 20 74 68 65 20 6e 65 74 77 6f at use the netwo
2600: 72 6b 2c 0a 20 20 20 20 3c 62 3e 73 79 6e 63 3c rk,. <b>sync<
2610: 2f 62 3e 2c 20 3c 62 3e 63 6c 6f 6e 65 3c 2f 62 /b>, <b>clone</b
2620: 3e 2c 20 3c 62 3e 70 75 73 68 3c 2f 62 3e 2c 20 >, <b>push</b>,
2630: 61 6e 64 20 3c 62 3e 70 75 6c 6c 3c 2f 62 3e 2e and <b>pull</b>.
2640: 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b </p>.. <block
2650: 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f quote>. <b>fo
2660: 73 73 69 6c 20 63 6c 6f 6e 65 20 3c 2f 62 3e 3c ssil clone </b><
2670: 69 3e 55 52 4c 3c 2f 69 3e 20 20 3c 62 3e 2d 2d i>URL</i> <b>--
2680: 70 72 6f 78 79 3c 2f 62 3e 20 3c 69 3e 50 72 6f proxy</b> <i>Pro
2690: 78 79 2d 55 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c xy-URL</i>. <
26a0: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 /blockquote>..
26b0: 20 20 3c 70 3e 49 74 20 69 73 20 61 6e 6e 6f 79 <p>It is annoy
26c0: 69 6e 67 20 74 6f 20 68 61 76 65 20 74 6f 20 74 ing to have to t
26d0: 79 70 65 20 69 6e 20 74 68 65 20 70 72 6f 78 79 ype in the proxy
26e0: 20 55 52 4c 20 65 76 65 72 79 20 74 69 6d 65 20 URL every time
26f0: 79 6f 75 0a 20 20 20 20 73 79 6e 63 20 79 6f 75 you. sync you
2700: 72 20 70 72 6f 6a 65 63 74 2c 20 74 68 6f 75 67 r project, thoug
2710: 68 2c 20 73 6f 20 79 6f 75 20 63 61 6e 20 6d 61 h, so you can ma
2720: 6b 65 20 74 68 65 20 70 72 6f 78 79 20 63 6f 6e ke the proxy con
2730: 66 69 67 75 72 61 74 69 6f 6e 0a 20 20 20 20 70 figuration. p
2740: 65 72 73 69 73 74 65 6e 74 20 75 73 69 6e 67 20 ersistent using
2750: 74 68 65 20 3c 62 3e 73 65 74 74 69 6e 67 3c 2f the <b>setting</
2760: 62 3e 20 63 6f 6d 6d 61 6e 64 3a 3c 2f 70 3e 0a b> command:</p>.
2770: 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 . <blockquote
2780: 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 >. <b>fossil
2790: 73 65 74 74 69 6e 67 20 70 72 6f 78 79 20 3c 2f setting proxy </
27a0: 62 3e 3c 69 3e 50 72 6f 78 79 2d 55 52 4c 3c 2f b><i>Proxy-URL</
27b0: 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 i>. </blockqu
27c0: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 4f 72 2c ote>.. <p>Or,
27d0: 20 79 6f 75 20 63 61 6e 20 73 65 74 20 74 68 65 you can set the
27e0: 20 22 3c 62 3e 68 74 74 70 5f 70 72 6f 78 79 3c "<b>http_proxy<
27f0: 2f 62 3e 22 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 /b>" environment
2800: 20 76 61 72 69 61 62 6c 65 3a 3c 2f 70 3e 0a 0a variable:</p>..
2810: 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e <blockquote>
2820: 0a 20 20 20 20 3c 62 3e 65 78 70 6f 72 74 20 68 . <b>export h
2830: 74 74 70 5f 70 72 6f 78 79 3d 3c 2f 62 3e 3c 69 ttp_proxy=</b><i
2840: 3e 50 72 6f 78 79 2d 55 52 4c 3c 2f 69 3e 0a 20 >Proxy-URL</i>.
2850: 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e </blockquote>
2860: 0a 0a 20 20 20 20 3c 70 3e 54 6f 20 73 74 6f 70 .. <p>To stop
2870: 20 75 73 69 6e 67 20 74 68 65 20 70 72 6f 78 79 using the proxy
2880: 2c 20 64 6f 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c , do:</p>.. <
2890: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 blockquote>.
28a0: 3c 62 3e 66 6f 73 73 69 6c 20 73 65 74 74 69 6e <b>fossil settin
28b0: 67 20 70 72 6f 78 79 20 6f 66 66 3c 2f 62 3e 0a g proxy off</b>.
28c0: 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 </blockquote
28d0: 3e 0a 0a 20 20 20 20 3c 70 3e 4f 72 20 75 6e 73 >.. <p>Or uns
28e0: 65 74 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 et the environme
28f0: 6e 74 20 76 61 72 69 61 62 6c 65 2e 20 20 54 68 nt variable. Th
2900: 65 20 66 6f 73 73 69 6c 20 73 65 74 74 69 6e 67 e fossil setting
2910: 20 66 6f 72 20 74 68 65 0a 20 20 20 20 48 54 54 for the. HTT
2920: 50 20 70 72 6f 78 79 20 74 61 6b 65 73 20 70 72 P proxy takes pr
2930: 65 63 65 64 65 6e 63 65 20 6f 76 65 72 20 74 68 ecedence over th
2940: 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 e environment va
2950: 72 69 61 62 6c 65 20 61 6e 64 20 74 68 65 0a 20 riable and the.
2960: 20 20 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 command-line
2970: 6f 70 74 69 6f 6e 20 6f 76 65 72 72 69 64 65 73 option overrides
2980: 20 62 6f 74 68 2e 20 20 49 66 20 79 6f 75 20 68 both. If you h
2990: 61 76 65 20 61 6e 20 70 65 72 73 69 73 74 65 6e ave an persisten
29a0: 74 0a 20 20 20 20 70 72 6f 78 79 20 73 65 74 74 t. proxy sett
29b0: 69 6e 67 20 74 68 61 74 20 79 6f 75 20 77 61 6e ing that you wan
29c0: 74 20 74 6f 20 6f 76 65 72 72 69 64 65 20 66 6f t to override fo
29d0: 72 20 61 20 6f 6e 65 2d 74 69 6d 65 20 73 79 6e r a one-time syn
29e0: 63 2c 20 74 68 61 74 0a 20 20 20 20 69 73 20 65 c, that. is e
29f0: 61 73 69 6c 79 20 64 6f 6e 65 20 6f 6e 20 74 68 asily done on th
2a00: 65 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 2e 20 e command-line.
2a10: 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74 6f For example, to
2a20: 20 73 79 6e 63 20 77 69 74 68 0a 20 20 20 20 61 sync with. a
2a30: 20 63 6f 2d 77 6f 72 6b 65 72 73 20 72 65 70 6f co-workers repo
2a40: 73 69 74 6f 72 79 20 6f 6e 20 79 6f 75 72 20 4c sitory on your L
2a50: 41 4e 2c 20 79 6f 75 20 6d 69 67 68 74 20 74 79 AN, you might ty
2a60: 70 65 3a 3c 2f 70 3e 20 20 20 0a 0a 20 20 20 20 pe:</p> ..
2a70: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 <blockquote>.
2a80: 20 3c 62 3e 66 6f 73 73 69 6c 20 73 79 6e 63 20 <b>fossil sync
2a90: 68 74 74 70 3a 2f 2f 31 39 32 2e 31 36 38 2e 31 http://192.168.1
2aa0: 2e 33 36 3a 38 30 38 30 2f 20 2d 2d 70 72 6f 78 .36:8080/ --prox
2ab0: 79 20 6f 66 66 3c 2f 62 3e 0a 20 20 20 20 3c 2f y off</b>. </
2ac0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 2f 62 blockquote>..</b
2ad0: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 4d 6f lockquote><h2>Mo
2ae0: 72 65 20 48 69 6e 74 73 3c 2f 68 32 3e 3c 62 6c re Hints</h2><bl
2af0: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c ockquote>.. <
2b00: 70 3e 54 72 79 20 74 68 65 73 65 20 63 6f 6d 6d p>Try these comm
2b10: 61 6e 64 73 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c ands:</p>.. <
2b20: 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 62 3e 0a 20 blockquote><b>.
2b30: 20 20 20 66 6f 73 73 69 6c 20 68 65 6c 70 3c 62 fossil help<b
2b40: 72 3e 0a 20 20 20 20 66 6f 73 73 69 6c 20 74 65 r>. fossil te
2b50: 73 74 2d 63 6f 6d 6d 61 6e 64 73 0a 20 20 20 20 st-commands.
2b60: 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 </b></blockquote
2b70: 3e 0a 0a 20 20 20 20 3c 70 3e 45 78 70 6c 6f 72 >.. <p>Explor
2b80: 65 20 61 6e 64 20 68 61 76 65 20 66 75 6e 21 3c e and have fun!<
2b90: 2f 70 3e 0a 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f /p>...</blockquo
2ba0: 74 65 3e 0a 3c 2f 6e 6f 77 69 6b 69 3e 0a te>.</nowiki>.