Hex Artifact Content
Not logged in

Artifact ca1d98afc167150c4f5844f6b4424450b9251a0c:

File www/quickstart.wiki part of check-in [e65e669148] - Tweaks to the embedded documentation. by drh on 2008-05-24 23:54:10.

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 66 6f 73 73 69  il-scm.org/fossi
05c0: 6c 20 6d 79 63 6c 6f 6e 65 2e 66 6f 73 73 69 6c  l myclone.fossil
05d0: 3c 2f 62 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b  </b>.    </block
05e0: 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54  quote>..    <p>T
05f0: 68 65 20 6e 65 77 20 6c 6f 63 61 6c 20 63 6f 70  he new local cop
0600: 79 20 6f 66 20 74 68 65 20 72 65 73 70 6f 73 69  y of the resposi
0610: 74 6f 72 79 20 69 73 20 73 74 6f 72 65 64 20 69  tory is stored i
0620: 6e 20 61 20 73 69 6e 67 6c 65 20 66 69 6c 65 2c  n a single file,
0630: 0a 20 20 20 20 77 68 69 63 68 20 69 6e 20 74 68  .    which in th
0640: 65 20 65 78 61 6d 70 6c 65 20 61 62 6f 76 65 20  e example above 
0650: 69 73 20 6e 61 6d 65 64 20 22 6d 79 63 6c 6f 6e  is named "myclon
0660: 65 2e 66 6f 73 73 69 6c 22 2e 0a 20 20 20 20 59  e.fossil"..    Y
0670: 6f 75 20 63 61 6e 20 6e 61 6d 65 20 79 6f 75 72  ou can name your
0680: 20 72 65 70 6f 73 69 74 6f 72 69 65 73 20 61 6e   repositories an
0690: 79 74 68 69 6e 67 20 79 6f 75 20 77 61 6e 74 2e  ything you want.
06a0: 20 20 54 68 65 20 22 2e 66 6f 73 73 69 6c 22 20    The ".fossil" 
06b0: 73 75 66 66 69 78 0a 20 20 20 20 69 73 20 6e 6f  suffix.    is no
06c0: 74 20 72 65 71 75 69 72 65 64 2e 3c 2f 70 3e 0a  t required.</p>.
06d0: 0a 20 20 20 20 3c 70 3e 4e 6f 74 65 3a 20 49 66  .    <p>Note: If
06e0: 20 79 6f 75 20 61 72 65 20 62 65 68 69 6e 64 20   you are behind 
06f0: 61 20 72 65 73 74 72 69 63 74 69 76 65 20 66 69  a restrictive fi
0700: 72 65 77 61 6c 6c 2c 20 79 6f 75 20 6d 69 67 68  rewall, you migh
0710: 74 20 6e 65 65 64 0a 20 20 20 20 74 6f 20 3c 61  t need.    to <a
0720: 20 68 72 65 66 3d 22 23 70 72 6f 78 79 22 3e 73   href="#proxy">s
0730: 70 65 63 69 66 79 20 61 6e 20 48 54 54 50 20 70  pecify an HTTP p
0740: 72 6f 78 79 3c 2f 61 3e 20 74 6f 20 75 73 65 2e  roxy</a> to use.
0750: 3c 2f 70 3e 0a 20 20 20 20 0a 3c 2f 62 6c 6f 63  </p>.    .</bloc
0760: 6b 71 75 6f 74 65 3e 3c 68 32 3e 53 74 61 72 74  kquote><h2>Start
0770: 69 6e 67 20 41 20 4e 65 77 20 50 72 6f 6a 65 63  ing A New Projec
0780: 74 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74  t</h2><blockquot
0790: 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 6f 20 73 74  e>..    <p>To st
07a0: 61 72 74 20 61 20 6e 65 77 20 70 72 6f 6a 65 63  art a new projec
07b0: 74 20 77 69 74 68 20 66 6f 73 73 69 6c 2c 20 63  t with fossil, c
07c0: 72 65 61 74 65 20 61 20 6e 65 77 20 65 6d 70 74  reate a new empt
07d0: 79 20 72 65 70 6f 73 69 74 6f 72 79 0a 20 20 20  y repository.   
07e0: 20 74 68 69 73 20 77 61 79 3a 3c 2f 70 3e 0a 20   this way:</p>. 
07f0: 20 20 20 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75     .    <blockqu
0800: 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73  ote>.    <b>foss
0810: 69 6c 20 6e 65 77 20 3c 2f 62 3e 3c 69 3e 20 72  il new </b><i> r
0820: 65 70 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e 61  epository-filena
0830: 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f  me</i>.    </blo
0840: 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 0a 3c 2f  ckquote>.    .</
0850: 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 43  blockquote><h2>C
0860: 6f 6e 66 69 67 75 72 69 6e 67 20 59 6f 75 72 20  onfiguring Your 
0870: 4c 6f 63 61 6c 20 52 65 70 6f 73 69 74 6f 72 79  Local Repository
0880: 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65  </h2><blockquote
0890: 3e 0a 20 20 20 20 0a 20 20 20 20 3c 70 3e 57 68  >.    .    <p>Wh
08a0: 65 6e 20 79 6f 75 20 63 72 65 61 74 65 20 61 20  en you create a 
08b0: 6e 65 77 20 72 65 70 6f 73 69 74 6f 72 79 2c 20  new repository, 
08c0: 65 69 74 68 65 72 20 62 79 20 63 6c 6f 6e 69 6e  either by clonin
08d0: 67 20 61 6e 20 65 78 69 73 74 69 6e 67 0a 20 20  g an existing.  
08e0: 20 20 70 72 6f 6a 65 63 74 20 6f 72 20 63 72 65    project or cre
08f0: 61 74 65 20 61 20 6e 65 77 20 70 72 6f 6a 65 63  ate a new projec
0900: 74 20 6f 66 20 79 6f 75 72 20 6f 77 6e 2c 20 79  t of your own, y
0910: 6f 75 20 75 73 75 61 6c 6c 79 20 77 61 6e 74 20  ou usually want 
0920: 74 6f 20 64 6f 20 73 6f 6d 65 0a 20 20 20 20 6c  to do some.    l
0930: 6f 63 61 6c 20 63 6f 6e 66 69 67 75 72 61 74 69  ocal configurati
0940: 6f 6e 2e 20 20 54 68 69 73 20 69 73 20 61 63 63  on.  This is acc
0950: 6f 6d 70 6c 69 73 68 65 64 20 75 73 69 6e 67 20  omplished using 
0960: 61 20 77 65 62 62 72 6f 77 73 65 72 2e 20 20 46  a webbrowser.  F
0970: 69 72 73 74 0a 20 20 20 20 73 74 61 72 74 20 61  irst.    start a
0980: 20 66 6f 73 73 69 6c 20 77 65 62 73 65 72 76 65   fossil webserve
0990: 72 20 6c 69 6b 65 20 74 68 69 73 3a 3c 2f 70 3e  r like this:</p>
09a0: 0a 20 20 20 20 0a 20 20 20 20 3c 62 6c 6f 63 6b  .    .    <block
09b0: 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f  quote>.    <b>fo
09c0: 73 73 69 6c 20 75 69 20 3c 2f 62 3e 3c 69 3e 20  ssil ui </b><i> 
09d0: 72 65 70 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e  repository-filen
09e0: 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c  ame</i>.    </bl
09f0: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c  ockquote>..    <
0a00: 70 3e 54 68 69 73 20 63 72 65 61 74 65 73 20 61  p>This creates a
0a10: 20 6d 69 6e 69 2d 77 65 62 73 65 72 76 65 72 20   mini-webserver 
0a20: 6c 69 73 74 65 6e 69 6e 67 20 6f 6e 20 70 6f 72  listening on por
0a30: 74 20 38 30 38 30 2e 20 20 59 6f 75 20 63 61 6e  t 8080.  You can
0a40: 0a 20 20 20 20 73 70 65 63 69 66 79 20 61 20 64  .    specify a d
0a50: 69 66 66 65 72 65 6e 74 20 70 6f 72 74 20 75 73  ifferent port us
0a60: 69 6e 67 20 74 68 65 20 3c 62 3e 2d 70 6f 72 74  ing the <b>-port
0a70: 3c 2f 62 3e 20 6f 70 74 69 6f 6e 20 6f 6e 20 74  </b> option on t
0a80: 68 65 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 2e  he command-line.
0a90: 0a 20 20 20 20 41 66 74 65 72 20 74 68 65 20 73  .    After the s
0aa0: 65 72 76 65 72 20 69 73 20 72 75 6e 6e 69 6e 67  erver is running
0ab0: 2c 20 66 6f 73 73 69 6c 20 77 69 6c 6c 20 74 68  , fossil will th
0ac0: 65 6e 20 61 74 74 65 6d 70 74 20 74 6f 20 6c 61  en attempt to la
0ad0: 75 6e 63 68 20 79 6f 75 72 0a 20 20 20 20 77 65  unch your.    we
0ae0: 62 20 62 72 6f 77 73 65 72 20 61 6e 64 20 6d 61  b browser and ma
0af0: 6b 65 20 69 74 20 70 6f 69 6e 74 20 74 6f 20 74  ke it point to t
0b00: 68 69 73 20 77 65 62 20 73 65 72 76 65 72 2e 20  his web server. 
0b10: 20 49 66 20 79 6f 75 72 20 73 79 73 74 65 6d 0a   If your system.
0b20: 20 20 20 20 68 61 73 20 61 6e 20 75 6e 75 73 75      has an unusu
0b30: 61 6c 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e  al configuration
0b40: 2c 20 66 6f 73 73 69 6c 20 6d 69 67 68 74 20 6e  , fossil might n
0b50: 6f 74 20 62 65 20 61 62 6c 65 20 74 6f 20 66 69  ot be able to fi
0b60: 67 75 72 65 20 6f 75 74 0a 20 20 20 20 68 6f 77  gure out.    how
0b70: 20 74 6f 20 73 74 61 72 74 20 79 6f 75 72 20 77   to start your w
0b80: 65 62 20 62 72 6f 77 73 65 72 2e 20 20 49 6e 20  eb browser.  In 
0b90: 74 68 61 74 20 63 61 73 65 2c 20 73 74 61 72 74  that case, start
0ba0: 20 74 68 65 20 77 65 62 20 62 72 6f 77 73 65 72   the web browser
0bb0: 0a 20 20 20 20 79 6f 75 72 73 65 6c 66 20 61 6e  .    yourself an
0bc0: 64 20 70 6f 69 6e 74 20 69 74 20 61 74 20 68 74  d point it at ht
0bd0: 74 70 3a 2f 2f 6c 6f 63 61 6c 68 6f 73 74 3a 38  tp://localhost:8
0be0: 30 38 30 2f 2e 20 20 43 6c 69 63 6b 20 6f 6e 20  080/.  Click on 
0bf0: 74 68 65 0a 20 20 20 20 22 53 65 74 75 70 22 20  the.    "Setup" 
0c00: 6c 69 6e 6b 20 6f 6e 20 74 68 65 20 6d 65 6e 75  link on the menu
0c10: 20 62 61 72 20 74 6f 20 73 74 61 72 74 20 63 6f   bar to start co
0c20: 6e 66 69 67 75 72 69 6e 67 20 79 6f 75 72 20 72  nfiguring your r
0c30: 65 70 6f 73 69 74 6f 72 79 2e 3c 2f 70 3e 0a 20  epository.</p>. 
0c40: 20 20 20 0a 20 20 20 20 3c 70 3e 42 79 20 64 65     .    <p>By de
0c50: 66 61 75 6c 74 2c 20 66 6f 73 73 69 6c 20 64 6f  fault, fossil do
0c60: 65 73 20 6e 6f 74 20 72 65 71 75 69 72 65 20 61  es not require a
0c70: 20 6c 6f 67 69 6e 20 66 6f 72 20 48 54 54 50 20   login for HTTP 
0c80: 63 6f 6e 6e 65 63 74 69 6f 6e 73 0a 20 20 20 20  connections.    
0c90: 63 6f 6d 69 6e 67 20 69 6e 20 66 72 6f 6d 20 74  coming in from t
0ca0: 68 65 20 49 50 20 6c 6f 6f 70 62 61 63 6b 20 61  he IP loopback a
0cb0: 64 64 72 65 73 73 20 31 32 37 2e 30 2e 30 2e 31  ddress 127.0.0.1
0cc0: 2e 20 20 59 6f 75 20 63 61 6e 2c 20 61 6e 64 20  .  You can, and 
0cd0: 70 65 72 68 61 70 73 0a 20 20 20 20 73 68 6f 75  perhaps.    shou
0ce0: 6c 64 2c 20 63 68 61 6e 67 65 20 74 68 69 73 20  ld, change this 
0cf0: 61 66 74 65 72 20 79 6f 75 20 63 72 65 61 74 65  after you create
0d00: 20 61 20 66 65 77 20 75 73 65 72 73 2e 3c 2f 70   a few users.</p
0d10: 3e 0a 20 20 20 20 0a 20 20 20 20 3c 70 3e 57 68  >.    .    <p>Wh
0d20: 65 6e 20 79 6f 75 20 61 72 65 20 66 69 6e 69 73  en you are finis
0d30: 68 65 64 20 63 6f 6e 66 69 67 75 72 69 6e 67 2c  hed configuring,
0d40: 20 6a 75 73 74 20 70 72 65 73 73 20 43 6f 6e 74   just press Cont
0d50: 72 6f 6c 2d 43 20 6f 72 20 75 73 65 0a 20 20 20  rol-C or use.   
0d60: 20 74 68 65 20 3c 62 3e 6b 69 6c 6c 3c 2f 62 3e   the <b>kill</b>
0d70: 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 73 68 75 74   command to shut
0d80: 20 64 6f 77 6e 20 74 68 65 20 6d 69 6e 69 2d 73   down the mini-s
0d90: 65 72 76 65 72 2e 3c 2f 70 3e 0a 0a 3c 2f 62 6c  erver.</p>..</bl
0da0: 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 43 68 65  ockquote><h2>Che
0db0: 63 6b 69 6e 67 20 4f 75 74 20 41 20 4c 6f 63 61  cking Out A Loca
0dc0: 6c 20 54 72 65 65 3c 2f 68 32 3e 3c 62 6c 6f 63  l Tree</h2><bloc
0dd0: 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e  kquote>..    <p>
0de0: 54 6f 20 77 6f 72 6b 20 6f 6e 20 61 20 70 72 6f  To work on a pro
0df0: 6a 65 63 74 20 69 6e 20 66 6f 73 73 69 6c 2c 20  ject in fossil, 
0e00: 79 6f 75 20 6e 65 65 64 20 74 6f 20 63 68 65 63  you need to chec
0e10: 6b 20 6f 75 74 20 61 20 6c 6f 63 61 6c 0a 20 20  k out a local.  
0e20: 20 20 63 6f 70 79 20 6f 66 20 74 68 65 20 73 6f    copy of the so
0e30: 75 72 63 65 20 74 72 65 65 2e 20 20 43 72 65 61  urce tree.  Crea
0e40: 74 65 20 74 68 65 20 64 69 72 65 63 74 6f 72 79  te the directory
0e50: 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 62 65 0a   you want to be.
0e60: 20 20 20 20 74 68 65 20 72 6f 6f 74 20 6f 66 20      the root of 
0e70: 79 6f 75 72 20 74 72 65 65 20 61 6e 64 20 63 64  your tree and cd
0e80: 20 69 6e 74 6f 20 74 68 61 74 20 64 69 72 65 63   into that direc
0e90: 74 6f 72 79 2e 20 20 54 68 65 6e 0a 20 20 20 20  tory.  Then.    
0ea0: 74 6f 20 74 68 69 73 3a 3c 2f 70 3e 0a 20 20 20  to this:</p>.   
0eb0: 20 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74   .    <blockquot
0ec0: 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c  e>.    <b>fossil
0ed0: 20 6f 70 65 6e 20 3c 2f 62 3e 3c 69 3e 20 72 65   open </b><i> re
0ee0: 70 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e 61 6d  pository-filenam
0ef0: 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63  e</i>.    </bloc
0f00: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 0a 20 20 20  kquote>.    .   
0f10: 20 3c 70 3e 54 68 69 73 20 6c 65 61 76 65 73 20   <p>This leaves 
0f20: 79 6f 75 20 77 69 74 68 20 74 68 65 20 6e 65 77  you with the new
0f30: 65 73 74 20 76 65 72 73 69 6f 6e 20 6f 66 20 74  est version of t
0f40: 68 65 20 74 72 65 65 0a 20 20 20 20 63 68 65 63  he tree.    chec
0f50: 6b 65 64 20 6f 75 74 2e 20 20 20 20 0a 20 20 20  ked out.    .   
0f60: 20 46 72 6f 6d 20 61 6e 79 77 68 65 72 65 20 75   From anywhere u
0f70: 6e 64 65 72 6e 65 61 74 68 20 74 68 65 20 72 6f  nderneath the ro
0f80: 6f 74 20 6f 66 20 79 6f 75 72 20 6c 6f 63 61 6c  ot of your local
0f90: 20 74 72 65 65 2c 20 79 6f 75 0a 20 20 20 20 63   tree, you.    c
0fa0: 61 6e 20 74 79 70 65 20 63 6f 6d 6d 61 6e 64 73  an type commands
0fb0: 20 6c 69 6b 65 20 74 68 65 20 66 6f 6c 6c 6f 77   like the follow
0fc0: 69 6e 67 20 74 6f 20 66 69 6e 64 20 6f 75 74 20  ing to find out 
0fd0: 74 68 65 20 73 74 61 74 75 73 20 6f 66 0a 20 20  the status of.  
0fe0: 20 20 79 6f 75 72 20 6c 6f 63 61 6c 20 74 72 65    your local tre
0ff0: 65 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f  e:</p>..    <blo
1000: 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e  ckquote>.    <b>
1010: 66 6f 73 73 69 6c 20 69 6e 66 6f 3c 2f 62 3e 3c  fossil info</b><
1020: 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69  br>.    <b>fossi
1030: 6c 20 73 74 61 74 75 73 3c 2f 62 3e 3c 62 72 3e  l status</b><br>
1040: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 63  .    <b>fossil c
1050: 68 61 6e 67 65 73 3c 2f 62 3e 3c 62 72 3e 0a 20  hanges</b><br>. 
1060: 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 74 69 6d     <b>fossil tim
1070: 65 6c 69 6e 65 3c 2f 62 3e 3c 62 72 3e 0a 20 20  eline</b><br>.  
1080: 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6c 65 61 76    <b>fossil leav
1090: 65 73 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 20 3c  es</b><br>.    <
10a0: 62 3e 66 6f 73 73 69 6c 20 6c 73 3c 2f 62 3e 3c  b>fossil ls</b><
10b0: 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69  br>.    <b>fossi
10c0: 6c 20 62 72 61 6e 63 68 65 73 3c 2f 62 3e 3c 62  l branches</b><b
10d0: 72 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75  r>.    </blockqu
10e0: 6f 74 65 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f  ote>..</blockquo
10f0: 74 65 3e 3c 68 32 3e 4d 61 6b 69 6e 67 20 43 68  te><h2>Making Ch
1100: 61 6e 67 65 73 3c 2f 68 32 3e 3c 62 6c 6f 63 6b  anges</h2><block
1110: 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54  quote>..    <p>T
1120: 6f 20 61 64 64 20 6e 65 77 20 66 69 6c 65 73 20  o add new files 
1130: 74 6f 20 79 6f 75 72 20 70 72 6f 6a 65 63 74 2c  to your project,
1140: 20 6f 72 20 72 65 6d 6f 76 65 20 6f 6c 64 20 66   or remove old f
1150: 69 6c 65 73 2c 20 75 73 65 20 74 68 65 73 65 0a  iles, use these.
1160: 20 20 20 20 63 6f 6d 6d 61 6e 64 73 3a 3c 2f 70      commands:</p
1170: 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f  >..    <blockquo
1180: 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69  te>.    <b>fossi
1190: 6c 20 61 64 64 3c 2f 62 3e 20 3c 69 3e 66 69 6c  l add</b> <i>fil
11a0: 65 2e 2e 2e 3c 2f 69 3e 3c 62 72 3e 0a 20 20 20  e...</i><br>.   
11b0: 20 3c 62 3e 66 6f 73 73 69 6c 20 72 6d 3c 2f 62   <b>fossil rm</b
11c0: 3e 20 3c 69 3e 66 69 6c 65 2e 2e 2e 3c 2f 69 3e  > <i>file...</i>
11d0: 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74  .    </blockquot
11e0: 65 3e 0a 0a 20 20 20 20 3c 70 3e 59 6f 75 20 63  e>..    <p>You c
11f0: 61 6e 20 61 6c 73 6f 20 65 64 69 74 20 66 69 6c  an also edit fil
1200: 65 73 20 66 72 65 65 6c 79 2e 20 20 4f 6e 63 65  es freely.  Once
1210: 20 79 6f 75 20 61 72 65 20 72 65 61 64 79 20 74   you are ready t
1220: 6f 20 63 6f 6d 6d 69 74 0a 20 20 20 20 79 6f 75  o commit.    you
1230: 72 20 63 68 61 6e 67 65 73 2c 20 74 79 70 65 3a  r changes, type:
1240: 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b  </p>..    <block
1250: 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f  quote>.    <b>fo
1260: 73 73 69 6c 20 63 6f 6d 6d 69 74 3c 2f 62 3e 0a  ssil commit</b>.
1270: 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65      </blockquote
1280: 3e 0a 0a 20 20 20 20 3c 70 3e 59 6f 75 20 77 69  >..    <p>You wi
1290: 6c 6c 20 62 65 20 70 72 6f 6d 70 74 65 64 20 66  ll be prompted f
12a0: 6f 72 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d 6d  or check-in comm
12b0: 65 6e 74 73 20 75 73 69 6e 67 20 77 68 61 74 65  ents using whate
12c0: 76 65 72 20 65 64 69 74 6f 72 0a 20 20 20 20 69  ver editor.    i
12d0: 73 20 73 70 65 63 69 66 69 65 64 20 62 79 20 79  s specified by y
12e0: 6f 75 72 20 56 49 53 55 41 4c 20 6f 72 20 45 44  our VISUAL or ED
12f0: 49 54 4f 52 20 65 6e 76 69 72 6f 6e 6d 65 6e 74  ITOR environment
1300: 20 76 61 72 69 61 62 6c 65 2e 20 20 49 66 20 79   variable.  If y
1310: 6f 75 0a 20 20 20 20 68 61 76 65 20 47 50 47 20  ou.    have GPG 
1320: 69 6e 73 74 61 6c 6c 65 64 2c 20 79 6f 75 20 6d  installed, you m
1330: 61 79 20 62 65 20 70 72 6f 6d 70 74 65 64 20 66  ay be prompted f
1340: 6f 72 20 79 6f 75 72 20 47 50 47 20 70 61 73 73  or your GPG pass
1350: 70 68 72 61 73 65 20 73 6f 0a 20 20 20 20 74 68  phrase so.    th
1360: 61 74 20 74 68 65 20 63 68 65 63 6b 2d 69 6e 20  at the check-in 
1370: 63 61 6e 20 62 65 20 73 69 67 6e 65 64 20 77 69  can be signed wi
1380: 74 68 20 79 6f 75 72 20 47 50 47 20 73 69 67 6e  th your GPG sign
1390: 61 74 75 72 65 2e 20 20 41 66 74 65 72 0a 20 20  ature.  After.  
13a0: 20 20 74 68 69 73 20 79 6f 75 72 20 63 68 61 6e    this your chan
13b0: 67 65 73 20 77 69 6c 6c 20 62 65 20 63 68 65 63  ges will be chec
13c0: 6b 65 64 20 69 6e 2e 3c 2f 70 3e 0a 0a 3c 2f 62  ked in.</p>..</b
13d0: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 53 68  lockquote><h2>Sh
13e0: 61 72 69 6e 67 20 43 68 61 6e 67 65 73 3c 2f 68  aring Changes</h
13f0: 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a  2><blockquote>..
1400: 20 20 20 20 3c 70 3e 54 68 65 20 63 68 61 6e 67      <p>The chang
1410: 65 73 20 79 6f 75 20 3c 62 3e 63 6f 6d 6d 69 74  es you <b>commit
1420: 3c 2f 62 3e 20 61 72 65 20 6f 6e 6c 79 20 6f 6e  </b> are only on
1430: 20 79 6f 75 72 20 6c 6f 63 61 6c 20 72 65 70 6f   your local repo
1440: 73 69 74 6f 72 79 2e 0a 20 20 20 20 54 6f 20 73  sitory..    To s
1450: 68 61 72 65 20 74 68 6f 73 65 20 63 68 61 6e 67  hare those chang
1460: 65 73 20 77 69 74 68 20 6f 74 68 65 72 20 72 65  es with other re
1470: 70 6f 73 69 74 6f 72 69 65 73 2c 20 64 6f 3a 3c  positories, do:<
1480: 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71  /p>..    <blockq
1490: 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73  uote>.    <b>fos
14a0: 73 69 6c 20 70 75 73 68 3c 2f 62 3e 20 3c 69 3e  sil push</b> <i>
14b0: 55 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c  URL</i>.    </bl
14c0: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c  ockquote>..    <
14d0: 70 3e 57 68 65 72 65 20 3c 69 3e 55 52 4c 3c 2f  p>Where <i>URL</
14e0: 69 3e 20 69 73 20 74 68 65 20 68 74 74 70 3a 20  i> is the http: 
14f0: 55 52 4c 20 6f 66 20 74 68 65 20 73 65 72 76 65  URL of the serve
1500: 72 20 72 65 70 6f 73 69 74 6f 72 79 20 79 6f 75  r repository you
1510: 0a 20 20 20 20 77 61 6e 74 20 74 6f 20 73 68 61  .    want to sha
1520: 72 65 20 79 6f 75 72 20 63 68 61 6e 67 65 73 20  re your changes 
1530: 77 69 74 68 2e 20 20 49 66 20 79 6f 75 20 6f 6d  with.  If you om
1540: 69 74 20 74 68 65 20 3c 69 3e 55 52 4c 3c 2f 69  it the <i>URL</i
1550: 3e 20 61 72 67 75 6d 65 6e 74 2c 0a 20 20 20 20  > argument,.    
1560: 66 6f 73 73 69 6c 20 77 69 6c 6c 20 75 73 65 20  fossil will use 
1570: 77 68 61 74 65 76 65 72 20 73 65 72 76 65 72 20  whatever server 
1580: 79 6f 75 20 6d 6f 73 74 20 72 65 63 65 6e 74 6c  you most recentl
1590: 79 20 73 79 6e 63 65 64 20 77 69 74 68 2e 3c 2f  y synced with.</
15a0: 70 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 3c  p>..    <p>The <
15b0: 62 3e 70 75 73 68 3c 2f 62 3e 20 63 6f 6d 6d 61  b>push</b> comma
15c0: 6e 64 20 6f 6e 6c 79 20 73 65 6e 64 73 20 79 6f  nd only sends yo
15d0: 75 72 20 63 68 61 6e 67 65 73 20 74 6f 20 6f 74  ur changes to ot
15e0: 68 65 72 73 2e 20 20 54 6f 0a 20 20 20 20 52 65  hers.  To.    Re
15f0: 63 65 69 76 65 20 63 68 61 6e 67 65 73 20 66 72  ceive changes fr
1600: 6f 6d 20 6f 74 68 65 72 73 2c 20 75 73 65 20 3c  om others, use <
1610: 62 3e 70 75 6c 6c 3c 2f 62 3e 2e 20 20 4f 72 20  b>pull</b>.  Or 
1620: 67 6f 20 62 6f 74 68 20 77 61 79 73 20 61 74 0a  go both ways at.
1630: 20 20 20 20 6f 6e 63 65 20 75 73 69 6e 67 20 3c      once using <
1640: 62 3e 73 79 6e 63 3c 2f 62 3e 3a 3c 2f 70 3e 0a  b>sync</b>:</p>.
1650: 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65  .    <blockquote
1660: 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20  >.    <b>fossil 
1670: 70 75 6c 6c 3c 2f 62 3e 20 3c 69 3e 55 52 4c 3c  pull</b> <i>URL<
1680: 2f 69 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66  /i><br>.    <b>f
1690: 6f 73 73 69 6c 20 73 79 6e 63 3c 2f 62 3e 20 3c  ossil sync</b> <
16a0: 69 3e 55 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c 2f  i>URL</i>.    </
16b0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20  blockquote>..   
16c0: 20 3c 70 3e 57 68 65 6e 20 79 6f 75 20 70 75 6c   <p>When you pul
16d0: 6c 20 69 6e 20 63 68 61 6e 67 65 73 20 66 72 6f  l in changes fro
16e0: 6d 20 6f 74 68 65 72 73 2c 20 74 68 65 79 20 67  m others, they g
16f0: 6f 20 69 6e 74 6f 20 79 6f 75 72 20 72 65 70 6f  o into your repo
1700: 73 69 74 6f 72 79 2c 0a 20 20 20 20 6e 6f 74 20  sitory,.    not 
1710: 69 6e 74 6f 20 79 6f 75 72 20 63 68 65 63 6b 65  into your checke
1720: 64 2d 6f 75 74 20 6c 6f 63 61 6c 20 74 72 65 65  d-out local tree
1730: 2e 20 20 54 6f 20 67 65 74 20 74 68 65 20 63 68  .  To get the ch
1740: 61 6e 67 65 73 20 69 6e 74 6f 20 79 6f 75 72 0a  anges into your.
1750: 20 20 20 20 6c 6f 63 61 6c 20 74 72 65 65 2c 20      local tree, 
1760: 75 73 65 20 3c 62 3e 75 70 64 61 74 65 3c 2f 62  use <b>update</b
1770: 3e 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f  >:</p>..    <blo
1780: 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e  ckquote>.    <b>
1790: 66 6f 73 73 69 6c 20 75 70 64 61 74 65 3c 2f 62  fossil update</b
17a0: 3e 20 3c 69 3e 55 55 49 44 3c 2f 69 3e 0a 20 20  > <i>UUID</i>.  
17b0: 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a    </blockquote>.
17c0: 0a 20 20 20 20 3c 70 3e 54 68 65 20 3c 69 3e 55  .    <p>The <i>U
17d0: 55 49 44 3c 2f 69 3e 20 69 73 20 73 6f 6d 65 20  UID</i> is some 
17e0: 75 6e 69 71 75 65 20 61 62 62 72 65 76 69 61 74  unique abbreviat
17f0: 69 6f 6e 20 74 6f 20 74 68 65 20 34 30 2d 63 68  ion to the 40-ch
1800: 61 72 61 63 74 65 72 0a 20 20 20 20 76 65 72 73  aracter.    vers
1810: 69 6f 6e 20 49 44 2e 20 20 49 66 20 79 6f 75 20  ion ID.  If you 
1820: 6f 6d 69 74 20 74 68 65 20 3c 69 3e 55 55 49 44  omit the <i>UUID
1830: 3c 2f 69 3e 20 66 6f 73 73 69 6c 20 6d 6f 76 65  </i> fossil move
1840: 73 20 79 6f 75 20 74 6f 20 74 68 65 0a 20 20 20  s you to the.   
1850: 20 6c 65 61 66 20 76 65 72 73 69 6f 6e 20 6f 66   leaf version of
1860: 20 74 68 65 20 62 72 61 6e 63 68 20 79 6f 75 72   the branch your
1870: 20 61 72 65 20 63 75 72 72 65 6e 74 6c 79 20 6f   are currently o
1880: 6e 2e 20 20 49 66 20 79 6f 75 72 20 62 72 61 6e  n.  If your bran
1890: 63 68 0a 20 20 20 20 68 61 73 20 6d 75 6c 74 69  ch.    has multi
18a0: 70 6c 65 20 6c 65 61 76 65 73 2c 20 79 6f 75 20  ple leaves, you 
18b0: 67 65 74 20 61 6e 20 65 72 72 6f 72 20 2d 20 79  get an error - y
18c0: 6f 75 27 6c 6c 20 68 61 76 65 20 74 6f 20 73 70  ou'll have to sp
18d0: 65 63 69 66 79 20 74 68 65 0a 20 20 20 20 6c 65  ecify the.    le
18e0: 61 66 20 79 6f 75 20 77 61 6e 74 20 75 73 69 6e  af you want usin
18f0: 67 20 61 20 3c 69 3e 55 55 49 44 3c 2f 69 3e 20  g a <i>UUID</i> 
1900: 61 72 67 75 6d 65 6e 74 2e 3c 2f 70 3e 0a 0a 3c  argument.</p>..<
1910: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e  /blockquote><h2>
1920: 42 72 61 6e 63 68 69 6e 67 20 41 6e 64 20 4d 65  Branching And Me
1930: 72 67 69 6e 67 3c 2f 68 32 3e 3c 62 6c 6f 63 6b  rging</h2><block
1940: 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 59  quote>..    <p>Y
1950: 6f 75 20 63 61 6e 20 63 72 65 61 74 65 20 62 72  ou can create br
1960: 61 6e 63 68 65 73 20 62 79 20 64 6f 69 6e 67 20  anches by doing 
1970: 6d 75 6c 74 69 70 6c 65 20 63 6f 6d 6d 69 74 73  multiple commits
1980: 20 6f 66 66 20 6f 66 20 74 68 65 0a 20 20 20 20   off of the.    
1990: 73 61 6d 65 20 62 61 73 65 20 76 65 72 73 69 6f  same base versio
19a0: 6e 2e 20 20 54 6f 20 6d 65 72 67 65 20 74 6f 20  n.  To merge to 
19b0: 62 72 61 6e 63 68 65 73 20 62 61 63 6b 20 74 6f  branches back to
19c0: 67 65 74 68 65 72 2c 20 66 69 72 73 74 0a 20 20  gether, first.  
19d0: 20 20 3c 62 3e 75 70 64 61 74 65 3c 2f 62 3e 20    <b>update</b> 
19e0: 74 6f 20 74 68 65 20 6c 65 61 66 20 6f 66 20 6f  to the leaf of o
19f0: 6e 65 20 62 72 61 6e 63 68 2e 20 20 54 68 65 6e  ne branch.  Then
1a00: 20 64 6f 20 61 20 3c 62 3e 6d 65 72 67 65 3c 2f   do a <b>merge</
1a10: 62 3e 0a 20 20 20 20 6f 66 20 74 68 65 20 6c 65  b>.    of the le
1a20: 61 66 20 6f 66 20 74 68 65 20 6f 74 68 65 72 20  af of the other 
1a30: 62 72 61 6e 63 68 3a 3c 2f 70 3e 0a 0a 20 20 20  branch:</p>..   
1a40: 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20   <blockquote>.  
1a50: 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6d 65 72 67    <b>fossil merg
1a60: 65 3c 2f 62 3e 20 3c 69 3e 55 55 49 44 3c 2f 69  e</b> <i>UUID</i
1a70: 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f  >.    </blockquo
1a80: 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 65 73 74  te>..    <p>Test
1a90: 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 79 6f   to make sure yo
1aa0: 75 72 20 6d 65 72 67 65 20 64 69 64 6e 27 74 20  ur merge didn't 
1ab0: 6d 65 73 73 20 75 70 20 74 68 65 20 63 6f 64 65  mess up the code
1ac0: 2c 20 74 68 65 6e 0a 20 20 20 20 3c 62 3e 63 6f  , then.    <b>co
1ad0: 6d 6d 69 74 3c 2f 62 3e 20 61 6e 64 20 70 6f 73  mmit</b> and pos
1ae0: 73 69 62 6c 79 20 61 6c 73 6f 20 3c 62 3e 70 75  sibly also <b>pu
1af0: 73 68 3c 2f 62 3e 20 79 6f 75 72 20 63 68 61 6e  sh</b> your chan
1b00: 67 65 73 2e 20 20 20 52 65 6d 65 6d 62 65 72 0a  ges.   Remember.
1b10: 20 20 20 20 74 68 61 74 20 6e 6f 62 6f 64 79 20      that nobody 
1b20: 65 6c 73 65 20 63 61 6e 20 73 65 65 20 79 6f 75  else can see you
1b30: 72 20 63 68 61 6e 67 65 73 20 75 6e 74 69 6c 20  r changes until 
1b40: 79 6f 75 20 3c 62 3e 63 6f 6d 6d 69 74 3c 2f 62  you <b>commit</b
1b50: 3e 20 61 6e 64 0a 20 20 20 20 69 66 20 6f 74 68  > and.    if oth
1b60: 65 72 20 61 72 65 20 75 73 69 6e 67 20 61 20 64  er are using a d
1b70: 69 66 66 65 72 65 6e 74 20 72 65 70 6f 73 69 74  ifferent reposit
1b80: 6f 72 79 20 79 6f 75 20 77 69 6c 6c 20 61 6c 73  ory you will als
1b90: 6f 20 6e 65 65 64 20 74 6f 0a 20 20 20 20 3c 62  o need to.    <b
1ba0: 3e 70 75 73 68 3c 2f 62 3e 2e 3c 2f 70 3e 0a 0a  >push</b>.</p>..
1bb0: 3c 61 20 6e 61 6d 65 3d 22 73 65 72 76 65 72 73  <a name="servers
1bc0: 65 74 75 70 22 3e 3c 2f 61 3e 0a 3c 2f 62 6c 6f  etup"></a>.</blo
1bd0: 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 53 65 74 74  ckquote><h2>Sett
1be0: 69 6e 67 20 55 70 20 41 20 53 65 72 76 65 72 3c  ing Up A Server<
1bf0: 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e  /h2><blockquote>
1c00: 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 65 61 73  ..    <p>The eas
1c10: 69 65 73 74 20 77 61 79 20 74 6f 20 73 65 74 20  iest way to set 
1c20: 75 70 20 61 20 73 65 72 76 65 72 20 69 73 3a 3c  up a server is:<
1c30: 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71  /p>..    <blockq
1c40: 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73  uote>.    <b>fos
1c50: 73 69 6c 20 73 65 72 76 65 72 3c 2f 62 3e 20 3c  sil server</b> <
1c60: 69 3e 72 65 70 6f 73 69 74 6f 72 79 2d 66 69 6c  i>repository-fil
1c70: 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f  ename</i>.    </
1c80: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20  blockquote>..   
1c90: 20 3c 70 3e 4f 72 3c 2f 62 3e 0a 0a 20 20 20 20   <p>Or</b>..    
1ca0: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20  <blockquote>.   
1cb0: 20 3c 62 3e 66 6f 73 73 69 6c 20 75 69 3c 2f 62   <b>fossil ui</b
1cc0: 3e 20 3c 69 3e 72 65 70 6f 73 69 74 6f 72 79 2d  > <i>repository-
1cd0: 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20  filename</i>.   
1ce0: 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a   </blockquote>..
1cf0: 20 20 20 20 3c 70 3e 54 68 65 20 64 69 66 66 65      <p>The diffe
1d00: 72 65 6e 63 65 20 62 65 74 77 65 65 6e 20 74 68  rence between th
1d10: 65 73 65 20 74 77 6f 20 63 6f 6d 6d 61 6e 64 20  ese two command 
1d20: 69 73 20 74 68 61 74 20 3c 62 3e 75 69 3c 2f 62  is that <b>ui</b
1d30: 3e 0a 20 20 20 20 61 74 74 65 6d 70 74 73 20 74  >.    attempts t
1d40: 6f 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20  o automatically 
1d50: 73 74 61 72 74 20 79 6f 75 72 20 77 65 62 20 62  start your web b
1d60: 72 6f 77 73 65 72 20 70 6f 69 6e 74 69 6e 67 20  rowser pointing 
1d70: 61 74 20 74 68 65 0a 20 20 20 20 73 65 72 76 65  at the.    serve
1d80: 72 20 77 68 65 72 65 61 73 20 3c 62 3e 73 65 72  r whereas <b>ser
1d90: 76 65 72 3c 2f 62 3e 20 64 6f 65 73 20 6e 6f 74  ver</b> does not
1da0: 2e 0a 20 20 20 20 59 6f 75 20 63 61 6e 20 6f 6d  ..    You can om
1db0: 69 74 20 74 68 65 20 3c 69 3e 72 65 70 6f 73 69  it the <i>reposi
1dc0: 74 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69  tory-filename</i
1dd0: 3e 20 69 66 20 79 6f 75 20 61 72 65 20 77 69 74  > if you are wit
1de0: 68 69 6e 0a 20 20 20 20 61 20 63 68 65 63 6b 65  hin.    a checke
1df0: 64 2d 6f 75 74 20 6c 6f 63 61 6c 20 74 72 65 65  d-out local tree
1e00: 2e 20 20 54 68 69 73 20 73 65 72 76 65 72 20 75  .  This server u
1e10: 73 65 73 20 70 6f 72 74 20 38 30 38 30 20 62 79  ses port 8080 by
1e20: 20 64 65 66 61 75 6c 74 0a 20 20 20 20 62 75 74   default.    but
1e30: 20 79 6f 75 20 63 61 6e 20 73 70 65 63 69 66 79   you can specify
1e40: 20 61 20 64 69 66 66 65 72 65 6e 74 20 70 6f 72   a different por
1e50: 74 20 75 73 69 6e 67 20 74 68 65 20 3c 62 3e 2d  t using the <b>-
1e60: 70 6f 72 74 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64  port</b> command
1e70: 2e 3c 2f 70 3e 0a 0a 20 20 20 20 3c 70 3e 43 6f  .</p>..    <p>Co
1e80: 6d 6d 61 6e 64 2d 6c 69 6e 65 20 73 65 72 76 65  mmand-line serve
1e90: 72 73 20 6c 69 6b 65 20 74 68 69 73 20 61 72 65  rs like this are
1ea0: 20 75 73 65 66 75 6c 20 77 68 65 6e 20 74 77 6f   useful when two
1eb0: 20 70 65 6f 70 6c 65 20 77 61 6e 74 0a 20 20 20   people want.   
1ec0: 20 74 6f 20 73 68 61 72 65 20 61 20 72 65 70 6f   to share a repo
1ed0: 73 69 74 6f 72 79 20 6f 6e 20 74 65 6d 70 6f 72  sitory on tempor
1ee0: 61 72 79 20 6f 72 20 61 64 2d 68 6f 63 20 62 61  ary or ad-hoc ba
1ef0: 73 69 73 2e 20 20 46 6f 72 20 61 20 6d 6f 72 65  sis.  For a more
1f00: 0a 20 20 20 20 70 65 72 6d 61 6e 65 6e 74 20 69  .    permanent i
1f10: 6e 73 74 61 6c 6c 61 74 69 6f 6e 2c 20 79 6f 75  nstallation, you
1f20: 20 73 68 6f 75 6c 64 20 75 73 65 20 65 69 74 68   should use eith
1f30: 65 72 20 74 68 65 20 43 47 49 20 73 65 72 76 65  er the CGI serve
1f40: 72 20 6f 72 20 74 68 65 0a 20 20 20 20 69 6e 65  r or the.    ine
1f50: 74 64 20 73 65 72 76 65 72 2e 20 20 54 6f 20 75  td server.  To u
1f60: 73 65 20 74 68 65 20 43 47 49 20 73 65 72 76 65  se the CGI serve
1f70: 72 2c 20 63 72 65 61 74 65 20 61 20 43 47 49 20  r, create a CGI 
1f80: 73 63 72 69 70 74 20 74 68 61 74 0a 20 20 20 20  script that.    
1f90: 6c 6f 6f 6b 73 20 73 6f 6d 65 74 68 69 6e 67 20  looks something 
1fa0: 6c 69 6b 65 20 74 68 69 73 3a 3c 2f 70 3e 0a 0a  like this:</p>..
1fb0: 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e      <blockquote>
1fc0: 3c 62 3e 0a 20 20 20 20 23 21 2f 75 73 72 2f 6c  <b>.    #!/usr/l
1fd0: 6f 63 61 6c 2f 62 69 6e 2f 66 6f 73 73 69 6c 3c  ocal/bin/fossil<
1fe0: 62 72 3e 0a 20 20 20 20 72 65 70 6f 73 69 74 6f  br>.    reposito
1ff0: 72 79 3a 20 2f 68 6f 6d 65 2f 70 72 6f 6a 31 2f  ry: /home/proj1/
2000: 72 65 70 6f 73 31 2e 66 6f 73 73 69 6c 0a 20 20  repos1.fossil.  
2010: 20 20 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 75 6f    </b></blockquo
2020: 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 41 64 6a 75  te>..    <p>Adju
2030: 73 74 20 74 68 65 20 70 61 74 68 73 20 69 6e 20  st the paths in 
2040: 74 68 69 73 20 43 47 49 20 73 63 72 69 70 74 20  this CGI script 
2050: 74 6f 20 6d 61 74 63 68 20 79 6f 75 72 20 69 6e  to match your in
2060: 73 74 61 6c 6c 61 74 69 6f 6e 0a 20 20 20 20 61  stallation.    a
2070: 6e 64 20 6d 61 6b 65 20 73 75 72 65 20 74 68 61  nd make sure tha
2080: 74 20 72 65 70 6f 73 69 74 6f 72 79 20 66 69 6c  t repository fil
2090: 65 20 61 74 20 74 68 65 20 64 69 72 65 63 74 6f  e at the directo
20a0: 72 79 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73  ry that contains
20b0: 20 69 74 0a 20 20 20 20 61 72 65 20 62 6f 74 68   it.    are both
20c0: 20 72 65 61 64 61 62 6c 65 20 61 6e 64 20 77 72   readable and wr
20d0: 69 74 61 62 6c 65 20 62 79 20 74 68 65 20 75 73  itable by the us
20e0: 65 72 20 74 68 61 74 20 43 47 49 20 73 63 72 69  er that CGI scri
20f0: 70 74 73 20 72 75 6e 20 61 73 2e 0a 20 20 20 20  pts run as..    
2100: 54 68 65 6e 20 70 6f 69 6e 74 20 63 6c 69 65 6e  Then point clien
2110: 74 73 20 61 74 20 74 68 65 20 43 47 49 20 73 63  ts at the CGI sc
2120: 72 69 70 74 2e 20 20 54 68 61 74 27 73 20 61 6c  ript.  That's al
2130: 6c 20 74 68 65 72 65 20 69 73 20 74 6f 20 69 74  l there is to it
2140: 21 3c 2f 70 3e 0a 0a 20 20 20 20 3c 70 3e 59 6f  !</p>..    <p>Yo
2150: 75 20 63 61 6e 20 61 6c 73 6f 20 72 75 6e 20 66  u can also run f
2160: 6f 73 73 69 6c 20 6f 66 66 20 6f 66 20 69 6e 65  ossil off of ine
2170: 74 64 20 6f 72 20 78 69 6e 65 74 64 2e 20 20 46  td or xinetd.  F
2180: 6f 72 20 61 6e 20 69 6e 65 74 64 0a 20 20 20 20  or an inetd.    
2190: 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 2c 20 6d 61  installation, ma
21a0: 6b 65 20 61 6e 20 65 6e 74 72 79 20 69 6e 20 2f  ke an entry in /
21b0: 65 74 63 2f 69 6e 65 74 64 2e 63 6f 6e 66 20 74  etc/inetd.conf t
21c0: 68 61 74 20 6c 6f 6f 6b 73 20 73 6f 6d 65 74 68  hat looks someth
21d0: 69 6e 67 0a 20 20 20 20 6c 69 6b 65 20 74 68 69  ing.    like thi
21e0: 73 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f  s:</p>..    <blo
21f0: 63 6b 71 75 6f 74 65 3e 3c 62 3e 0a 20 20 20 20  ckquote><b>.    
2200: 38 30 20 73 74 72 65 61 6d 20 74 63 70 20 6e 6f  80 stream tcp no
2210: 77 61 69 74 2e 31 30 30 30 20 72 6f 6f 74 20 2f  wait.1000 root /
2220: 75 73 72 2f 62 69 6e 2f 66 6f 73 73 69 6c 20 5c  usr/bin/fossil \
2230: 3c 62 72 3e 0a 20 20 20 20 20 20 20 20 2f 75 73  <br>.        /us
2240: 72 2f 62 69 6e 2f 66 6f 73 73 69 6c 20 68 74 74  r/bin/fossil htt
2250: 70 20 2f 68 6f 6d 65 2f 70 72 6f 6a 31 2f 72 65  p /home/proj1/re
2260: 70 6f 73 31 2e 66 6f 73 73 69 6c 0a 20 20 20 20  pos1.fossil.    
2270: 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65  </b></blockquote
2280: 3e 0a 0a 20 20 20 20 3c 70 3e 41 64 6a 75 73 74  >..    <p>Adjust
2290: 20 74 68 65 20 70 61 74 68 73 20 74 6f 20 73 75   the paths to su
22a0: 69 74 20 79 6f 75 72 20 69 6e 73 74 61 6c 6c 61  it your installa
22b0: 74 69 6f 6e 2c 20 6f 66 20 63 6f 75 72 73 65 2e  tion, of course.
22c0: 20 20 4e 6f 74 69 63 65 20 74 68 61 74 0a 20 20    Notice that.  
22d0: 20 20 66 6f 73 73 69 6c 20 72 75 6e 73 20 61 73    fossil runs as
22e0: 20 72 6f 6f 74 2e 20 20 54 68 69 73 20 69 73 20   root.  This is 
22f0: 6e 6f 74 20 72 65 71 75 69 72 65 64 20 2d 20 79  not required - y
2300: 6f 75 20 63 61 6e 20 72 75 6e 20 69 74 20 61 73  ou can run it as
2310: 20 61 6e 0a 20 20 20 20 75 6e 70 72 69 76 69 6c   an.    unprivil
2320: 65 67 65 64 20 75 73 65 72 2e 20 20 42 75 74 20  eged user.  But 
2330: 69 74 20 69 73 20 6d 6f 72 65 20 73 65 63 75 72  it is more secur
2340: 65 20 74 6f 20 72 75 6e 20 66 6f 73 73 69 6c 20  e to run fossil 
2350: 61 73 20 72 6f 6f 74 2e 0a 20 20 20 20 57 68 65  as root..    Whe
2360: 6e 20 79 6f 75 20 64 6f 20 72 75 6e 20 66 6f 73  n you do run fos
2370: 73 69 6c 20 61 73 20 72 6f 6f 74 2c 20 69 74 20  sil as root, it 
2380: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 70 75  automatically pu
2390: 74 73 20 69 74 73 65 6c 66 20 69 6e 20 61 0a 20  ts itself in a. 
23a0: 20 20 20 63 68 72 6f 6f 74 20 6a 61 69 6c 20 69     chroot jail i
23b0: 6e 20 74 68 65 20 73 61 6d 65 20 64 69 72 65 63  n the same direc
23c0: 74 6f 72 79 20 61 73 20 74 68 65 20 72 65 70 6f  tory as the repo
23d0: 73 69 74 6f 72 79 2c 20 74 68 65 6e 20 64 72 6f  sitory, then dro
23e0: 70 73 0a 20 20 20 20 72 6f 6f 74 20 70 72 69 76  ps.    root priv
23f0: 69 6c 65 67 65 73 20 70 72 69 6f 72 20 74 6f 20  ileges prior to 
2400: 72 65 61 64 69 6e 67 20 61 6e 79 20 69 6e 66 6f  reading any info
2410: 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 74 68 65  rmation from the
2420: 20 72 65 71 75 65 73 74 2e 3c 2f 70 3e 0a 0a 3c   request.</p>..<
2430: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 61 20 6e  /blockquote><a n
2440: 61 6d 65 3d 22 70 72 6f 78 79 22 3e 3c 2f 61 3e  ame="proxy"></a>
2450: 3c 68 32 3e 48 54 54 50 20 50 72 6f 78 69 65 73  <h2>HTTP Proxies
2460: 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65  </h2><blockquote
2470: 3e 0a 0a 20 20 20 20 3c 70 3e 49 66 20 79 6f 75  >..    <p>If you
2480: 20 61 72 65 20 62 65 68 69 6e 64 20 61 20 72 65   are behind a re
2490: 73 74 72 69 63 74 69 76 65 20 66 69 72 65 77 61  strictive firewa
24a0: 6c 6c 20 74 68 61 74 20 72 65 71 75 69 72 65 73  ll that requires
24b0: 20 79 6f 75 20 74 6f 20 75 73 65 0a 20 20 20 20   you to use.    
24c0: 61 6e 20 48 54 54 50 20 70 72 6f 78 79 20 74 6f  an HTTP proxy to
24d0: 20 72 65 61 63 68 20 74 68 65 20 69 6e 74 65 72   reach the inter
24e0: 6e 65 74 2c 20 74 68 65 6e 20 79 6f 75 20 63 61  net, then you ca
24f0: 6e 20 63 6f 6e 66 69 67 75 72 65 20 74 68 65 20  n configure the 
2500: 70 72 6f 78 79 0a 20 20 20 20 69 6e 20 74 68 72  proxy.    in thr
2510: 65 65 20 64 69 66 66 65 72 65 6e 74 20 77 61 79  ee different way
2520: 73 2e 20 20 59 6f 75 20 63 61 6e 20 74 65 6c 6c  s.  You can tell
2530: 20 66 6f 73 73 69 6c 20 61 62 6f 75 74 20 79 6f   fossil about yo
2540: 75 72 20 70 72 6f 78 79 20 75 73 69 6e 67 0a 20  ur proxy using. 
2550: 20 20 20 61 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e     a command-lin
2560: 65 20 6f 70 74 69 6f 6e 20 6f 6e 20 63 6f 6d 6d  e option on comm
2570: 61 6e 64 73 20 74 68 61 74 20 75 73 65 20 74 68  ands that use th
2580: 65 20 6e 65 74 77 6f 72 6b 2c 0a 20 20 20 20 3c  e network,.    <
2590: 62 3e 73 79 6e 63 3c 2f 62 3e 2c 20 3c 62 3e 63  b>sync</b>, <b>c
25a0: 6c 6f 6e 65 3c 2f 62 3e 2c 20 3c 62 3e 70 75 73  lone</b>, <b>pus
25b0: 68 3c 2f 62 3e 2c 20 61 6e 64 20 3c 62 3e 70 75  h</b>, and <b>pu
25c0: 6c 6c 3c 2f 62 3e 2e 3c 2f 70 3e 0a 0a 20 20 20  ll</b>.</p>..   
25d0: 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20   <blockquote>.  
25e0: 20 20 3c 62 3e 66 6f 73 73 69 6c 20 63 6c 6f 6e    <b>fossil clon
25f0: 65 20 3c 2f 62 3e 3c 69 3e 55 52 4c 3c 2f 69 3e  e </b><i>URL</i>
2600: 20 20 3c 62 3e 2d 2d 70 72 6f 78 79 3c 2f 62 3e    <b>--proxy</b>
2610: 20 3c 69 3e 50 72 6f 78 79 2d 55 52 4c 3c 2f 69   <i>Proxy-URL</i
2620: 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f  >.    </blockquo
2630: 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 49 74 20 69  te>..    <p>It i
2640: 73 20 61 6e 6e 6f 79 69 6e 67 20 74 6f 20 68 61  s annoying to ha
2650: 76 65 20 74 6f 20 74 79 70 65 20 69 6e 20 74 68  ve to type in th
2660: 65 20 70 72 6f 78 79 20 55 52 4c 20 65 76 65 72  e proxy URL ever
2670: 79 20 74 69 6d 65 20 79 6f 75 0a 20 20 20 20 73  y time you.    s
2680: 79 6e 63 20 79 6f 75 72 20 70 72 6f 6a 65 63 74  ync your project
2690: 2c 20 74 68 6f 75 67 68 2c 20 73 6f 20 79 6f 75  , though, so you
26a0: 20 63 61 6e 20 6d 61 6b 65 20 74 68 65 20 70 72   can make the pr
26b0: 6f 78 79 20 63 6f 6e 66 69 67 75 72 61 74 69 6f  oxy configuratio
26c0: 6e 0a 20 20 20 20 70 65 72 73 69 73 74 65 6e 74  n.    persistent
26d0: 20 75 73 69 6e 67 20 74 68 65 20 3c 62 3e 73 65   using the <b>se
26e0: 74 74 69 6e 67 3c 2f 62 3e 20 63 6f 6d 6d 61 6e  tting</b> comman
26f0: 64 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f  d:</p>..    <blo
2700: 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e  ckquote>.    <b>
2710: 66 6f 73 73 69 6c 20 73 65 74 74 69 6e 67 20 70  fossil setting p
2720: 72 6f 78 79 20 3c 2f 62 3e 3c 69 3e 50 72 6f 78  roxy </b><i>Prox
2730: 79 2d 55 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c 2f  y-URL</i>.    </
2740: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20  blockquote>..   
2750: 20 3c 70 3e 4f 72 2c 20 79 6f 75 20 63 61 6e 20   <p>Or, you can 
2760: 73 65 74 20 74 68 65 20 22 3c 62 3e 68 74 74 70  set the "<b>http
2770: 5f 70 72 6f 78 79 3c 2f 62 3e 22 20 65 6e 76 69  _proxy</b>" envi
2780: 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65  ronment variable
2790: 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63  :</p>..    <bloc
27a0: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 65  kquote>.    <b>e
27b0: 78 70 6f 72 74 20 68 74 74 70 5f 70 72 6f 78 79  xport http_proxy
27c0: 3d 3c 2f 62 3e 3c 69 3e 50 72 6f 78 79 2d 55 52  =</b><i>Proxy-UR
27d0: 4c 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63  L</i>.    </bloc
27e0: 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e  kquote>..    <p>
27f0: 54 6f 20 73 74 6f 70 20 75 73 69 6e 67 20 74 68  To stop using th
2800: 65 20 70 72 6f 78 79 2c 20 64 6f 3a 3c 2f 70 3e  e proxy, do:</p>
2810: 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74  ..    <blockquot
2820: 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c  e>.    <b>fossil
2830: 20 73 65 74 74 69 6e 67 20 70 72 6f 78 79 20 6f   setting proxy o
2840: 66 66 3c 2f 62 3e 0a 20 20 20 20 3c 2f 62 6c 6f  ff</b>.    </blo
2850: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70  ckquote>..    <p
2860: 3e 4f 72 20 75 6e 73 65 74 20 74 68 65 20 65 6e  >Or unset the en
2870: 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62  vironment variab
2880: 6c 65 2e 20 20 54 68 65 20 66 6f 73 73 69 6c 20  le.  The fossil 
2890: 73 65 74 74 69 6e 67 20 66 6f 72 20 74 68 65 0a  setting for the.
28a0: 20 20 20 20 48 54 54 50 20 70 72 6f 78 79 20 74      HTTP proxy t
28b0: 61 6b 65 73 20 70 72 65 63 65 64 65 6e 63 65 20  akes precedence 
28c0: 6f 76 65 72 20 74 68 65 20 65 6e 76 69 72 6f 6e  over the environ
28d0: 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20 61 6e  ment variable an
28e0: 64 20 74 68 65 0a 20 20 20 20 63 6f 6d 6d 61 6e  d the.    comman
28f0: 64 2d 6c 69 6e 65 20 6f 70 74 69 6f 6e 20 6f 76  d-line option ov
2900: 65 72 72 69 64 65 73 20 62 6f 74 68 2e 20 20 49  errides both.  I
2910: 66 20 79 6f 75 20 68 61 76 65 20 61 6e 20 70 65  f you have an pe
2920: 72 73 69 73 74 65 6e 74 0a 20 20 20 20 70 72 6f  rsistent.    pro
2930: 78 79 20 73 65 74 74 69 6e 67 20 74 68 61 74 20  xy setting that 
2940: 79 6f 75 20 77 61 6e 74 20 74 6f 20 6f 76 65 72  you want to over
2950: 72 69 64 65 20 66 6f 72 20 61 20 6f 6e 65 2d 74  ride for a one-t
2960: 69 6d 65 20 73 79 6e 63 2c 20 74 68 61 74 0a 20  ime sync, that. 
2970: 20 20 20 69 73 20 65 61 73 69 6c 79 20 64 6f 6e     is easily don
2980: 65 20 6f 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 64  e on the command
2990: 2d 6c 69 6e 65 2e 20 20 46 6f 72 20 65 78 61 6d  -line.  For exam
29a0: 70 6c 65 2c 20 74 6f 20 73 79 6e 63 20 77 69 74  ple, to sync wit
29b0: 68 0a 20 20 20 20 61 20 63 6f 2d 77 6f 72 6b 65  h.    a co-worke
29c0: 72 73 20 72 65 70 6f 73 69 74 6f 72 79 20 6f 6e  rs repository on
29d0: 20 79 6f 75 72 20 4c 41 4e 2c 20 79 6f 75 20 6d   your LAN, you m
29e0: 69 67 68 74 20 74 79 70 65 3a 3c 2f 70 3e 20 20  ight type:</p>  
29f0: 20 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f   ..    <blockquo
2a00: 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69  te>.    <b>fossi
2a10: 6c 20 73 79 6e 63 20 68 74 74 70 3a 2f 2f 31 39  l sync http://19
2a20: 32 2e 31 36 38 2e 31 2e 33 36 3a 38 30 38 30 2f  2.168.1.36:8080/
2a30: 20 2d 2d 70 72 6f 78 79 20 6f 66 66 3c 2f 62 3e   --proxy off</b>
2a40: 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74  .    </blockquot
2a50: 65 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65  e>..</blockquote
2a60: 3e 3c 68 32 3e 4d 6f 72 65 20 48 69 6e 74 73 3c  ><h2>More Hints<
2a70: 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e  /h2><blockquote>
2a80: 0a 0a 20 20 20 20 3c 70 3e 54 72 79 20 74 68 65  ..    <p>Try the
2a90: 73 65 20 63 6f 6d 6d 61 6e 64 73 3a 3c 2f 70 3e  se commands:</p>
2aa0: 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74  ..    <blockquot
2ab0: 65 3e 3c 62 3e 0a 20 20 20 20 66 6f 73 73 69 6c  e><b>.    fossil
2ac0: 20 68 65 6c 70 3c 62 72 3e 0a 20 20 20 20 66 6f   help<br>.    fo
2ad0: 73 73 69 6c 20 74 65 73 74 2d 63 6f 6d 6d 61 6e  ssil test-comman
2ae0: 64 73 0a 20 20 20 20 3c 2f 62 3e 3c 2f 62 6c 6f  ds.    </b></blo
2af0: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70  ckquote>..    <p
2b00: 3e 45 78 70 6c 6f 72 65 20 61 6e 64 20 68 61 76  >Explore and hav
2b10: 65 20 66 75 6e 21 3c 2f 70 3e 0a 0a 0a 3c 2f 62  e fun!</p>...</b
2b20: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 2f 6e 6f 77  lockquote>.</now
2b30: 69 6b 69 3e                                      iki>