Hex Artifact Content
Not logged in

Artifact f589ecb4845d7647008165645cbb5c32718ecbf1:

File www/quickstart.wiki part of check-in [c8893c69ac] - Documentation updates. by drh on 2008-10-05 01:03:25.

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 55 55 49 44 3c 2f 69 3e 0a  /b> <i>UUID</i>.
17c0: 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65      </blockquote
17d0: 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 3c 69  >..    <p>The <i
17e0: 3e 55 55 49 44 3c 2f 69 3e 20 69 73 20 73 6f 6d  >UUID</i> is som
17f0: 65 20 75 6e 69 71 75 65 20 61 62 62 72 65 76 69  e unique abbrevi
1800: 61 74 69 6f 6e 20 74 6f 20 74 68 65 20 34 30 2d  ation to the 40-
1810: 63 68 61 72 61 63 74 65 72 0a 20 20 20 20 76 65  character.    ve
1820: 72 73 69 6f 6e 20 49 44 2e 20 20 49 66 20 79 6f  rsion ID.  If yo
1830: 75 20 6f 6d 69 74 20 74 68 65 20 3c 69 3e 55 55  u omit the <i>UU
1840: 49 44 3c 2f 69 3e 20 66 6f 73 73 69 6c 20 6d 6f  ID</i> fossil mo
1850: 76 65 73 20 79 6f 75 20 74 6f 20 74 68 65 0a 20  ves you to the. 
1860: 20 20 20 6c 65 61 66 20 76 65 72 73 69 6f 6e 20     leaf version 
1870: 6f 66 20 74 68 65 20 62 72 61 6e 63 68 20 79 6f  of the branch yo
1880: 75 72 20 61 72 65 20 63 75 72 72 65 6e 74 6c 79  ur are currently
1890: 20 6f 6e 2e 20 20 49 66 20 79 6f 75 72 20 62 72   on.  If your br
18a0: 61 6e 63 68 0a 20 20 20 20 68 61 73 20 6d 75 6c  anch.    has mul
18b0: 74 69 70 6c 65 20 6c 65 61 76 65 73 2c 20 79 6f  tiple leaves, yo
18c0: 75 20 67 65 74 20 61 6e 20 65 72 72 6f 72 20 2d  u get an error -
18d0: 20 79 6f 75 27 6c 6c 20 68 61 76 65 20 74 6f 20   you'll have to 
18e0: 73 70 65 63 69 66 79 20 74 68 65 0a 20 20 20 20  specify the.    
18f0: 6c 65 61 66 20 79 6f 75 20 77 61 6e 74 20 75 73  leaf you want us
1900: 69 6e 67 20 61 20 3c 69 3e 55 55 49 44 3c 2f 69  ing a <i>UUID</i
1910: 3e 20 61 72 67 75 6d 65 6e 74 2e 3c 2f 70 3e 0a  > argument.</p>.
1920: 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68  .</blockquote><h
1930: 32 3e 42 72 61 6e 63 68 69 6e 67 20 41 6e 64 20  2>Branching And 
1940: 4d 65 72 67 69 6e 67 3c 2f 68 32 3e 3c 62 6c 6f  Merging</h2><blo
1950: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70  ckquote>..    <p
1960: 3e 59 6f 75 20 63 61 6e 20 63 72 65 61 74 65 20  >You can create 
1970: 62 72 61 6e 63 68 65 73 20 62 79 20 64 6f 69 6e  branches by doin
1980: 67 20 6d 75 6c 74 69 70 6c 65 20 63 6f 6d 6d 69  g multiple commi
1990: 74 73 20 6f 66 66 20 6f 66 20 74 68 65 0a 20 20  ts off of the.  
19a0: 20 20 73 61 6d 65 20 62 61 73 65 20 76 65 72 73    same base vers
19b0: 69 6f 6e 2e 20 20 54 6f 20 6d 65 72 67 65 20 74  ion.  To merge t
19c0: 6f 20 62 72 61 6e 63 68 65 73 20 62 61 63 6b 20  o branches back 
19d0: 74 6f 67 65 74 68 65 72 2c 20 66 69 72 73 74 0a  together, first.
19e0: 20 20 20 20 3c 62 3e 75 70 64 61 74 65 3c 2f 62      <b>update</b
19f0: 3e 20 74 6f 20 74 68 65 20 6c 65 61 66 20 6f 66  > to the leaf of
1a00: 20 6f 6e 65 20 62 72 61 6e 63 68 2e 20 20 54 68   one branch.  Th
1a10: 65 6e 20 64 6f 20 61 20 3c 62 3e 6d 65 72 67 65  en do a <b>merge
1a20: 3c 2f 62 3e 0a 20 20 20 20 6f 66 20 74 68 65 20  </b>.    of the 
1a30: 6c 65 61 66 20 6f 66 20 74 68 65 20 6f 74 68 65  leaf of the othe
1a40: 72 20 62 72 61 6e 63 68 3a 3c 2f 70 3e 0a 0a 20  r branch:</p>.. 
1a50: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a     <blockquote>.
1a60: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6d 65      <b>fossil me
1a70: 72 67 65 3c 2f 62 3e 20 3c 69 3e 55 55 49 44 3c  rge</b> <i>UUID<
1a80: 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71  /i>.    </blockq
1a90: 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 65  uote>..    <p>Te
1aa0: 73 74 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20  st to make sure 
1ab0: 79 6f 75 72 20 6d 65 72 67 65 20 64 69 64 6e 27  your merge didn'
1ac0: 74 20 6d 65 73 73 20 75 70 20 74 68 65 20 63 6f  t mess up the co
1ad0: 64 65 2c 20 74 68 65 6e 0a 20 20 20 20 3c 62 3e  de, then.    <b>
1ae0: 63 6f 6d 6d 69 74 3c 2f 62 3e 20 61 6e 64 20 70  commit</b> and p
1af0: 6f 73 73 69 62 6c 79 20 61 6c 73 6f 20 3c 62 3e  ossibly also <b>
1b00: 70 75 73 68 3c 2f 62 3e 20 79 6f 75 72 20 63 68  push</b> your ch
1b10: 61 6e 67 65 73 2e 20 20 20 52 65 6d 65 6d 62 65  anges.   Remembe
1b20: 72 0a 20 20 20 20 74 68 61 74 20 6e 6f 62 6f 64  r.    that nobod
1b30: 79 20 65 6c 73 65 20 63 61 6e 20 73 65 65 20 79  y else can see y
1b40: 6f 75 72 20 63 68 61 6e 67 65 73 20 75 6e 74 69  our changes unti
1b50: 6c 20 79 6f 75 20 3c 62 3e 63 6f 6d 6d 69 74 3c  l you <b>commit<
1b60: 2f 62 3e 20 61 6e 64 0a 20 20 20 20 69 66 20 6f  /b> and.    if o
1b70: 74 68 65 72 20 61 72 65 20 75 73 69 6e 67 20 61  ther are using a
1b80: 20 64 69 66 66 65 72 65 6e 74 20 72 65 70 6f 73   different repos
1b90: 69 74 6f 72 79 20 79 6f 75 20 77 69 6c 6c 20 61  itory you will a
1ba0: 6c 73 6f 20 6e 65 65 64 20 74 6f 0a 20 20 20 20  lso need to.    
1bb0: 3c 62 3e 70 75 73 68 3c 2f 62 3e 2e 3c 2f 70 3e  <b>push</b>.</p>
1bc0: 0a 0a 3c 61 20 6e 61 6d 65 3d 22 73 65 72 76 65  ..<a name="serve
1bd0: 72 73 65 74 75 70 22 3e 3c 2f 61 3e 0a 3c 2f 62  rsetup"></a>.</b
1be0: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 53 65  lockquote><h2>Se
1bf0: 74 74 69 6e 67 20 55 70 20 41 20 53 65 72 76 65  tting Up A Serve
1c00: 72 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74  r</h2><blockquot
1c10: 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 65  e>..    <p>The e
1c20: 61 73 69 65 73 74 20 77 61 79 20 74 6f 20 73 65  asiest way to se
1c30: 74 20 75 70 20 61 20 73 65 72 76 65 72 20 69 73  t up a server is
1c40: 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63  :</p>..    <bloc
1c50: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66  kquote>.    <b>f
1c60: 6f 73 73 69 6c 20 73 65 72 76 65 72 3c 2f 62 3e  ossil server</b>
1c70: 20 3c 69 3e 72 65 70 6f 73 69 74 6f 72 79 2d 66   <i>repository-f
1c80: 69 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 20  ilename</i>.    
1c90: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20  </blockquote>.. 
1ca0: 20 20 20 3c 70 3e 4f 72 3c 2f 62 3e 0a 0a 20 20     <p>Or</b>..  
1cb0: 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20    <blockquote>. 
1cc0: 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 75 69 3c     <b>fossil ui<
1cd0: 2f 62 3e 20 3c 69 3e 72 65 70 6f 73 69 74 6f 72  /b> <i>repositor
1ce0: 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20  y-filename</i>. 
1cf0: 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e     </blockquote>
1d00: 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 64 69 66  ..    <p>The dif
1d10: 66 65 72 65 6e 63 65 20 62 65 74 77 65 65 6e 20  ference between 
1d20: 74 68 65 73 65 20 74 77 6f 20 63 6f 6d 6d 61 6e  these two comman
1d30: 64 20 69 73 20 74 68 61 74 20 3c 62 3e 75 69 3c  d is that <b>ui<
1d40: 2f 62 3e 0a 20 20 20 20 61 74 74 65 6d 70 74 73  /b>.    attempts
1d50: 20 74 6f 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c   to automaticall
1d60: 79 20 73 74 61 72 74 20 79 6f 75 72 20 77 65 62  y start your web
1d70: 20 62 72 6f 77 73 65 72 20 70 6f 69 6e 74 69 6e   browser pointin
1d80: 67 20 61 74 20 74 68 65 0a 20 20 20 20 73 65 72  g at the.    ser
1d90: 76 65 72 20 77 68 65 72 65 61 73 20 3c 62 3e 73  ver whereas <b>s
1da0: 65 72 76 65 72 3c 2f 62 3e 20 64 6f 65 73 20 6e  erver</b> does n
1db0: 6f 74 2e 0a 20 20 20 20 59 6f 75 20 63 61 6e 20  ot..    You can 
1dc0: 6f 6d 69 74 20 74 68 65 20 3c 69 3e 72 65 70 6f  omit the <i>repo
1dd0: 73 69 74 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 3c  sitory-filename<
1de0: 2f 69 3e 20 69 66 20 79 6f 75 20 61 72 65 20 77  /i> if you are w
1df0: 69 74 68 69 6e 0a 20 20 20 20 61 20 63 68 65 63  ithin.    a chec
1e00: 6b 65 64 2d 6f 75 74 20 6c 6f 63 61 6c 20 74 72  ked-out local tr
1e10: 65 65 2e 20 20 54 68 69 73 20 73 65 72 76 65 72  ee.  This server
1e20: 20 75 73 65 73 20 70 6f 72 74 20 38 30 38 30 20   uses port 8080 
1e30: 62 79 20 64 65 66 61 75 6c 74 0a 20 20 20 20 62  by default.    b
1e40: 75 74 20 79 6f 75 20 63 61 6e 20 73 70 65 63 69  ut you can speci
1e50: 66 79 20 61 20 64 69 66 66 65 72 65 6e 74 20 70  fy a different p
1e60: 6f 72 74 20 75 73 69 6e 67 20 74 68 65 20 3c 62  ort using the <b
1e70: 3e 2d 70 6f 72 74 3c 2f 62 3e 20 63 6f 6d 6d 61  >-port</b> comma
1e80: 6e 64 2e 3c 2f 70 3e 0a 0a 20 20 20 20 3c 70 3e  nd.</p>..    <p>
1e90: 43 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 73 65 72  Command-line ser
1ea0: 76 65 72 73 20 6c 69 6b 65 20 74 68 69 73 20 61  vers like this a
1eb0: 72 65 20 75 73 65 66 75 6c 20 77 68 65 6e 20 74  re useful when t
1ec0: 77 6f 20 70 65 6f 70 6c 65 20 77 61 6e 74 0a 20  wo people want. 
1ed0: 20 20 20 74 6f 20 73 68 61 72 65 20 61 20 72 65     to share a re
1ee0: 70 6f 73 69 74 6f 72 79 20 6f 6e 20 74 65 6d 70  pository on temp
1ef0: 6f 72 61 72 79 20 6f 72 20 61 64 2d 68 6f 63 20  orary or ad-hoc 
1f00: 62 61 73 69 73 2e 20 20 46 6f 72 20 61 20 6d 6f  basis.  For a mo
1f10: 72 65 0a 20 20 20 20 70 65 72 6d 61 6e 65 6e 74  re.    permanent
1f20: 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 2c 20 79   installation, y
1f30: 6f 75 20 73 68 6f 75 6c 64 20 75 73 65 20 65 69  ou should use ei
1f40: 74 68 65 72 20 74 68 65 20 43 47 49 20 73 65 72  ther the CGI ser
1f50: 76 65 72 20 6f 72 20 74 68 65 0a 20 20 20 20 69  ver or the.    i
1f60: 6e 65 74 64 20 73 65 72 76 65 72 2e 0a 20 20 20  netd server..   
1f70: 20 3c 61 20 6e 61 6d 65 3d 22 63 67 69 73 65 72   <a name="cgiser
1f80: 76 65 72 22 3e 3c 2f 61 3e 0a 20 20 20 20 54 6f  ver"></a>.    To
1f90: 20 75 73 65 20 74 68 65 20 43 47 49 20 73 65 72   use the CGI ser
1fa0: 76 65 72 2c 20 63 72 65 61 74 65 20 61 20 43 47  ver, create a CG
1fb0: 49 20 73 63 72 69 70 74 20 74 68 61 74 0a 20 20  I script that.  
1fc0: 20 20 6c 6f 6f 6b 73 20 73 6f 6d 65 74 68 69 6e    looks somethin
1fd0: 67 20 6c 69 6b 65 20 74 68 69 73 3a 3c 2f 70 3e  g like this:</p>
1fe0: 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74  ..    <blockquot
1ff0: 65 3e 3c 62 3e 0a 20 20 20 20 23 21 2f 75 73 72  e><b>.    #!/usr
2000: 2f 6c 6f 63 61 6c 2f 62 69 6e 2f 66 6f 73 73 69  /local/bin/fossi
2010: 6c 3c 62 72 3e 0a 20 20 20 20 72 65 70 6f 73 69  l<br>.    reposi
2020: 74 6f 72 79 3a 20 2f 68 6f 6d 65 2f 70 72 6f 6a  tory: /home/proj
2030: 31 2f 72 65 70 6f 73 31 2e 66 6f 73 73 69 6c 0a  1/repos1.fossil.
2040: 20 20 20 20 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71      </b></blockq
2050: 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 41 64  uote>..    <p>Ad
2060: 6a 75 73 74 20 74 68 65 20 70 61 74 68 73 20 69  just the paths i
2070: 6e 20 74 68 69 73 20 43 47 49 20 73 63 72 69 70  n this CGI scrip
2080: 74 20 74 6f 20 6d 61 74 63 68 20 79 6f 75 72 20  t to match your 
2090: 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 0a 20 20 20  installation.   
20a0: 20 61 6e 64 20 6d 61 6b 65 20 73 75 72 65 20 74   and make sure t
20b0: 68 61 74 20 72 65 70 6f 73 69 74 6f 72 79 20 66  hat repository f
20c0: 69 6c 65 20 61 74 20 74 68 65 20 64 69 72 65 63  ile at the direc
20d0: 74 6f 72 79 20 74 68 61 74 20 63 6f 6e 74 61 69  tory that contai
20e0: 6e 73 20 69 74 0a 20 20 20 20 61 72 65 20 62 6f  ns it.    are bo
20f0: 74 68 20 72 65 61 64 61 62 6c 65 20 61 6e 64 20  th readable and 
2100: 77 72 69 74 61 62 6c 65 20 62 79 20 74 68 65 20  writable by the 
2110: 75 73 65 72 20 74 68 61 74 20 43 47 49 20 73 63  user that CGI sc
2120: 72 69 70 74 73 20 72 75 6e 20 61 73 2e 0a 20 20  ripts run as..  
2130: 20 20 54 68 65 6e 20 70 6f 69 6e 74 20 63 6c 69    Then point cli
2140: 65 6e 74 73 20 61 74 20 74 68 65 20 43 47 49 20  ents at the CGI 
2150: 73 63 72 69 70 74 2e 20 20 54 68 61 74 27 73 20  script.  That's 
2160: 61 6c 6c 20 74 68 65 72 65 20 69 73 20 74 6f 20  all there is to 
2170: 69 74 21 3c 2f 70 3e 0a 0a 20 20 20 20 3c 61 20  it!</p>..    <a 
2180: 6e 61 6d 65 3d 22 69 6e 65 74 64 73 65 72 76 65  name="inetdserve
2190: 72 22 3e 3c 2f 61 3e 0a 20 20 20 20 3c 70 3e 59  r"></a>.    <p>Y
21a0: 6f 75 20 63 61 6e 20 61 6c 73 6f 20 72 75 6e 20  ou can also run 
21b0: 66 6f 73 73 69 6c 20 6f 66 66 20 6f 66 20 69 6e  fossil off of in
21c0: 65 74 64 20 6f 72 20 78 69 6e 65 74 64 2e 20 20  etd or xinetd.  
21d0: 46 6f 72 20 61 6e 20 69 6e 65 74 64 0a 20 20 20  For an inetd.   
21e0: 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 2c 20 6d   installation, m
21f0: 61 6b 65 20 61 6e 20 65 6e 74 72 79 20 69 6e 20  ake an entry in 
2200: 2f 65 74 63 2f 69 6e 65 74 64 2e 63 6f 6e 66 20  /etc/inetd.conf 
2210: 74 68 61 74 20 6c 6f 6f 6b 73 20 73 6f 6d 65 74  that looks somet
2220: 68 69 6e 67 0a 20 20 20 20 6c 69 6b 65 20 74 68  hing.    like th
2230: 69 73 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c  is:</p>..    <bl
2240: 6f 63 6b 71 75 6f 74 65 3e 3c 62 3e 0a 20 20 20  ockquote><b>.   
2250: 20 38 30 20 73 74 72 65 61 6d 20 74 63 70 20 6e   80 stream tcp n
2260: 6f 77 61 69 74 2e 31 30 30 30 20 72 6f 6f 74 20  owait.1000 root 
2270: 2f 75 73 72 2f 62 69 6e 2f 66 6f 73 73 69 6c 20  /usr/bin/fossil 
2280: 5c 3c 62 72 3e 0a 20 20 20 20 20 20 20 20 2f 75  \<br>.        /u
2290: 73 72 2f 62 69 6e 2f 66 6f 73 73 69 6c 20 68 74  sr/bin/fossil ht
22a0: 74 70 20 2f 68 6f 6d 65 2f 70 72 6f 6a 31 2f 72  tp /home/proj1/r
22b0: 65 70 6f 73 31 2e 66 6f 73 73 69 6c 0a 20 20 20  epos1.fossil.   
22c0: 20 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74   </b></blockquot
22d0: 65 3e 0a 0a 20 20 20 20 3c 70 3e 41 64 6a 75 73  e>..    <p>Adjus
22e0: 74 20 74 68 65 20 70 61 74 68 73 20 74 6f 20 73  t the paths to s
22f0: 75 69 74 20 79 6f 75 72 20 69 6e 73 74 61 6c 6c  uit your install
2300: 61 74 69 6f 6e 2c 20 6f 66 20 63 6f 75 72 73 65  ation, of course
2310: 2e 20 20 4e 6f 74 69 63 65 20 74 68 61 74 0a 20  .  Notice that. 
2320: 20 20 20 66 6f 73 73 69 6c 20 72 75 6e 73 20 61     fossil runs a
2330: 73 20 72 6f 6f 74 2e 20 20 54 68 69 73 20 69 73  s root.  This is
2340: 20 6e 6f 74 20 72 65 71 75 69 72 65 64 20 2d 20   not required - 
2350: 79 6f 75 20 63 61 6e 20 72 75 6e 20 69 74 20 61  you can run it a
2360: 73 20 61 6e 0a 20 20 20 20 75 6e 70 72 69 76 69  s an.    unprivi
2370: 6c 65 67 65 64 20 75 73 65 72 2e 20 20 42 75 74  leged user.  But
2380: 20 69 74 20 69 73 20 6d 6f 72 65 20 73 65 63 75   it is more secu
2390: 72 65 20 74 6f 20 72 75 6e 20 66 6f 73 73 69 6c  re to run fossil
23a0: 20 61 73 20 72 6f 6f 74 2e 0a 20 20 20 20 57 68   as root..    Wh
23b0: 65 6e 20 79 6f 75 20 64 6f 20 72 75 6e 20 66 6f  en you do run fo
23c0: 73 73 69 6c 20 61 73 20 72 6f 6f 74 2c 20 69 74  ssil as root, it
23d0: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 70   automatically p
23e0: 75 74 73 20 69 74 73 65 6c 66 20 69 6e 20 61 0a  uts itself in a.
23f0: 20 20 20 20 63 68 72 6f 6f 74 20 6a 61 69 6c 20      chroot jail 
2400: 69 6e 20 74 68 65 20 73 61 6d 65 20 64 69 72 65  in the same dire
2410: 63 74 6f 72 79 20 61 73 20 74 68 65 20 72 65 70  ctory as the rep
2420: 6f 73 69 74 6f 72 79 2c 20 74 68 65 6e 20 64 72  ository, then dr
2430: 6f 70 73 0a 20 20 20 20 72 6f 6f 74 20 70 72 69  ops.    root pri
2440: 76 69 6c 65 67 65 73 20 70 72 69 6f 72 20 74 6f  vileges prior to
2450: 20 72 65 61 64 69 6e 67 20 61 6e 79 20 69 6e 66   reading any inf
2460: 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 74 68  ormation from th
2470: 65 20 72 65 71 75 65 73 74 2e 3c 2f 70 3e 0a 0a  e request.</p>..
2480: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 61 20  </blockquote><a 
2490: 6e 61 6d 65 3d 22 70 72 6f 78 79 22 3e 3c 2f 61  name="proxy"></a
24a0: 3e 3c 68 32 3e 48 54 54 50 20 50 72 6f 78 69 65  ><h2>HTTP Proxie
24b0: 73 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74  s</h2><blockquot
24c0: 65 3e 0a 0a 20 20 20 20 3c 70 3e 49 66 20 79 6f  e>..    <p>If yo
24d0: 75 20 61 72 65 20 62 65 68 69 6e 64 20 61 20 72  u are behind a r
24e0: 65 73 74 72 69 63 74 69 76 65 20 66 69 72 65 77  estrictive firew
24f0: 61 6c 6c 20 74 68 61 74 20 72 65 71 75 69 72 65  all that require
2500: 73 20 79 6f 75 20 74 6f 20 75 73 65 0a 20 20 20  s you to use.   
2510: 20 61 6e 20 48 54 54 50 20 70 72 6f 78 79 20 74   an HTTP proxy t
2520: 6f 20 72 65 61 63 68 20 74 68 65 20 69 6e 74 65  o reach the inte
2530: 72 6e 65 74 2c 20 74 68 65 6e 20 79 6f 75 20 63  rnet, then you c
2540: 61 6e 20 63 6f 6e 66 69 67 75 72 65 20 74 68 65  an configure the
2550: 20 70 72 6f 78 79 0a 20 20 20 20 69 6e 20 74 68   proxy.    in th
2560: 72 65 65 20 64 69 66 66 65 72 65 6e 74 20 77 61  ree different wa
2570: 79 73 2e 20 20 59 6f 75 20 63 61 6e 20 74 65 6c  ys.  You can tel
2580: 6c 20 66 6f 73 73 69 6c 20 61 62 6f 75 74 20 79  l fossil about y
2590: 6f 75 72 20 70 72 6f 78 79 20 75 73 69 6e 67 0a  our proxy using.
25a0: 20 20 20 20 61 20 63 6f 6d 6d 61 6e 64 2d 6c 69      a command-li
25b0: 6e 65 20 6f 70 74 69 6f 6e 20 6f 6e 20 63 6f 6d  ne option on com
25c0: 6d 61 6e 64 73 20 74 68 61 74 20 75 73 65 20 74  mands that use t
25d0: 68 65 20 6e 65 74 77 6f 72 6b 2c 0a 20 20 20 20  he network,.    
25e0: 3c 62 3e 73 79 6e 63 3c 2f 62 3e 2c 20 3c 62 3e  <b>sync</b>, <b>
25f0: 63 6c 6f 6e 65 3c 2f 62 3e 2c 20 3c 62 3e 70 75  clone</b>, <b>pu
2600: 73 68 3c 2f 62 3e 2c 20 61 6e 64 20 3c 62 3e 70  sh</b>, and <b>p
2610: 75 6c 6c 3c 2f 62 3e 2e 3c 2f 70 3e 0a 0a 20 20  ull</b>.</p>..  
2620: 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20    <blockquote>. 
2630: 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 63 6c 6f     <b>fossil clo
2640: 6e 65 20 3c 2f 62 3e 3c 69 3e 55 52 4c 3c 2f 69  ne </b><i>URL</i
2650: 3e 20 20 3c 62 3e 2d 2d 70 72 6f 78 79 3c 2f 62  >  <b>--proxy</b
2660: 3e 20 3c 69 3e 50 72 6f 78 79 2d 55 52 4c 3c 2f  > <i>Proxy-URL</
2670: 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75  i>.    </blockqu
2680: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 49 74 20  ote>..    <p>It 
2690: 69 73 20 61 6e 6e 6f 79 69 6e 67 20 74 6f 20 68  is annoying to h
26a0: 61 76 65 20 74 6f 20 74 79 70 65 20 69 6e 20 74  ave to type in t
26b0: 68 65 20 70 72 6f 78 79 20 55 52 4c 20 65 76 65  he proxy URL eve
26c0: 72 79 20 74 69 6d 65 20 79 6f 75 0a 20 20 20 20  ry time you.    
26d0: 73 79 6e 63 20 79 6f 75 72 20 70 72 6f 6a 65 63  sync your projec
26e0: 74 2c 20 74 68 6f 75 67 68 2c 20 73 6f 20 79 6f  t, though, so yo
26f0: 75 20 63 61 6e 20 6d 61 6b 65 20 74 68 65 20 70  u can make the p
2700: 72 6f 78 79 20 63 6f 6e 66 69 67 75 72 61 74 69  roxy configurati
2710: 6f 6e 0a 20 20 20 20 70 65 72 73 69 73 74 65 6e  on.    persisten
2720: 74 20 75 73 69 6e 67 20 74 68 65 20 3c 62 3e 73  t using the <b>s
2730: 65 74 74 69 6e 67 3c 2f 62 3e 20 63 6f 6d 6d 61  etting</b> comma
2740: 6e 64 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c  nd:</p>..    <bl
2750: 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62  ockquote>.    <b
2760: 3e 66 6f 73 73 69 6c 20 73 65 74 74 69 6e 67 20  >fossil setting 
2770: 70 72 6f 78 79 20 3c 2f 62 3e 3c 69 3e 50 72 6f  proxy </b><i>Pro
2780: 78 79 2d 55 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c  xy-URL</i>.    <
2790: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20  /blockquote>..  
27a0: 20 20 3c 70 3e 4f 72 2c 20 79 6f 75 20 63 61 6e    <p>Or, you can
27b0: 20 73 65 74 20 74 68 65 20 22 3c 62 3e 68 74 74   set the "<b>htt
27c0: 70 5f 70 72 6f 78 79 3c 2f 62 3e 22 20 65 6e 76  p_proxy</b>" env
27d0: 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c  ironment variabl
27e0: 65 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f  e:</p>..    <blo
27f0: 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e  ckquote>.    <b>
2800: 65 78 70 6f 72 74 20 68 74 74 70 5f 70 72 6f 78  export http_prox
2810: 79 3d 3c 2f 62 3e 3c 69 3e 50 72 6f 78 79 2d 55  y=</b><i>Proxy-U
2820: 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f  RL</i>.    </blo
2830: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70  ckquote>..    <p
2840: 3e 54 6f 20 73 74 6f 70 20 75 73 69 6e 67 20 74  >To stop using t
2850: 68 65 20 70 72 6f 78 79 2c 20 64 6f 3a 3c 2f 70  he proxy, do:</p
2860: 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f  >..    <blockquo
2870: 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69  te>.    <b>fossi
2880: 6c 20 73 65 74 74 69 6e 67 20 70 72 6f 78 79 20  l setting proxy 
2890: 6f 66 66 3c 2f 62 3e 0a 20 20 20 20 3c 2f 62 6c  off</b>.    </bl
28a0: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c  ockquote>..    <
28b0: 70 3e 4f 72 20 75 6e 73 65 74 20 74 68 65 20 65  p>Or unset the e
28c0: 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61  nvironment varia
28d0: 62 6c 65 2e 20 20 54 68 65 20 66 6f 73 73 69 6c  ble.  The fossil
28e0: 20 73 65 74 74 69 6e 67 20 66 6f 72 20 74 68 65   setting for the
28f0: 0a 20 20 20 20 48 54 54 50 20 70 72 6f 78 79 20  .    HTTP proxy 
2900: 74 61 6b 65 73 20 70 72 65 63 65 64 65 6e 63 65  takes precedence
2910: 20 6f 76 65 72 20 74 68 65 20 65 6e 76 69 72 6f   over the enviro
2920: 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20 61  nment variable a
2930: 6e 64 20 74 68 65 0a 20 20 20 20 63 6f 6d 6d 61  nd the.    comma
2940: 6e 64 2d 6c 69 6e 65 20 6f 70 74 69 6f 6e 20 6f  nd-line option o
2950: 76 65 72 72 69 64 65 73 20 62 6f 74 68 2e 20 20  verrides both.  
2960: 49 66 20 79 6f 75 20 68 61 76 65 20 61 6e 20 70  If you have an p
2970: 65 72 73 69 73 74 65 6e 74 0a 20 20 20 20 70 72  ersistent.    pr
2980: 6f 78 79 20 73 65 74 74 69 6e 67 20 74 68 61 74  oxy setting that
2990: 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 6f 76 65   you want to ove
29a0: 72 72 69 64 65 20 66 6f 72 20 61 20 6f 6e 65 2d  rride for a one-
29b0: 74 69 6d 65 20 73 79 6e 63 2c 20 74 68 61 74 0a  time sync, that.
29c0: 20 20 20 20 69 73 20 65 61 73 69 6c 79 20 64 6f      is easily do
29d0: 6e 65 20 6f 6e 20 74 68 65 20 63 6f 6d 6d 61 6e  ne on the comman
29e0: 64 2d 6c 69 6e 65 2e 20 20 46 6f 72 20 65 78 61  d-line.  For exa
29f0: 6d 70 6c 65 2c 20 74 6f 20 73 79 6e 63 20 77 69  mple, to sync wi
2a00: 74 68 0a 20 20 20 20 61 20 63 6f 2d 77 6f 72 6b  th.    a co-work
2a10: 65 72 73 20 72 65 70 6f 73 69 74 6f 72 79 20 6f  ers repository o
2a20: 6e 20 79 6f 75 72 20 4c 41 4e 2c 20 79 6f 75 20  n your LAN, you 
2a30: 6d 69 67 68 74 20 74 79 70 65 3a 3c 2f 70 3e 20  might type:</p> 
2a40: 20 20 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75    ..    <blockqu
2a50: 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73  ote>.    <b>foss
2a60: 69 6c 20 73 79 6e 63 20 68 74 74 70 3a 2f 2f 31  il sync http://1
2a70: 39 32 2e 31 36 38 2e 31 2e 33 36 3a 38 30 38 30  92.168.1.36:8080
2a80: 2f 20 2d 2d 70 72 6f 78 79 20 6f 66 66 3c 2f 62  / --proxy off</b
2a90: 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f  >.    </blockquo
2aa0: 74 65 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74  te>..</blockquot
2ab0: 65 3e 3c 68 32 3e 4d 6f 72 65 20 48 69 6e 74 73  e><h2>More Hints
2ac0: 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65  </h2><blockquote
2ad0: 3e 0a 0a 20 20 20 20 3c 70 3e 54 72 79 20 74 68  >..    <p>Try th
2ae0: 65 73 65 20 63 6f 6d 6d 61 6e 64 73 3a 3c 2f 70  ese commands:</p
2af0: 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f  >..    <blockquo
2b00: 74 65 3e 3c 62 3e 0a 20 20 20 20 66 6f 73 73 69  te><b>.    fossi
2b10: 6c 20 68 65 6c 70 3c 62 72 3e 0a 20 20 20 20 66  l help<br>.    f
2b20: 6f 73 73 69 6c 20 74 65 73 74 2d 63 6f 6d 6d 61  ossil test-comma
2b30: 6e 64 73 0a 20 20 20 20 3c 2f 62 3e 3c 2f 62 6c  nds.    </b></bl
2b40: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c  ockquote>..    <
2b50: 70 3e 45 78 70 6c 6f 72 65 20 61 6e 64 20 68 61  p>Explore and ha
2b60: 76 65 20 66 75 6e 21 3c 2f 70 3e 0a 0a 0a 3c 2f  ve fun!</p>...</
2b70: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 2f 6e 6f  blockquote>.</no
2b80: 77 69 6b 69 3e                                   wiki>