Hex Artifact Content
Not logged in

Artifact 7b2cbf48080965559a1de95f29d5eff2f6ddf510:

File www/quickstart.wiki part of check-in [44a4c365a7] - explained the clone command in a bit more detail (what it does and where to go from there) by stephan on 2008-05-19 13:08:01.

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 20 09 3c 70 3e 43 6c 6f 6e 69 6e 67 20  e>. .<p>Cloning 
0250: 69 73 20 74 68 65 20 66 69 72 73 74 20 73 74 65  is the first ste
0260: 70 20 69 6e 20 63 68 65 63 6b 69 6e 67 20 6f 75  p in checking ou
0270: 74 20 61 20 72 65 70 6f 73 69 74 6f 72 79 2c 0a  t a repository,.
0280: 09 61 6e 64 20 69 73 20 66 6f 73 73 69 6c 27 73  .and is fossil's
0290: 20 65 71 75 69 76 61 6c 65 6e 74 20 74 6f 20 6d   equivalent to m
02a0: 61 6b 69 6e 67 20 61 20 6c 6f 63 61 6c 20 63 6f  aking a local co
02b0: 70 79 20 6f 66 20 61 20 72 65 6d 6f 74 65 20 72  py of a remote r
02c0: 65 70 6f 73 69 74 6f 72 79 2e 3c 2f 70 3e 0a 0a  epository.</p>..
02d0: 20 20 20 20 3c 70 3e 55 73 65 20 74 68 69 73 20      <p>Use this 
02e0: 63 6f 6d 6d 61 6e 64 3a 3c 2f 70 3e 0a 20 20 20  command:</p>.   
02f0: 20 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74   .    <blockquot
0300: 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c  e>.    <b>fossil
0310: 20 63 6c 6f 6e 65 3c 2f 62 3e 20 3c 69 3e 55 52   clone</b> <i>UR
0320: 4c 20 20 72 65 70 6f 73 69 74 6f 72 79 2d 66 69  L  repository-fi
0330: 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c  lename</i>.    <
0340: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20  /blockquote>.   
0350: 20 0a 20 20 20 20 3c 70 3e 54 68 65 20 3c 69 3e   .    <p>The <i>
0360: 55 52 4c 3c 2f 69 3e 20 61 62 6f 76 65 20 69 73  URL</i> above is
0370: 20 74 68 65 20 68 74 74 70 20 55 52 4c 20 66 6f   the http URL fo
0380: 72 20 74 68 65 20 66 6f 73 73 69 6c 20 72 65 70  r the fossil rep
0390: 6f 73 69 74 6f 72 79 0a 20 20 20 20 79 6f 75 20  ository.    you 
03a0: 77 61 6e 74 20 74 6f 20 63 6c 6f 6e 65 2e 20 20  want to clone.  
03b0: 59 6f 75 20 63 61 6e 20 63 61 6c 6c 20 74 68 65  You can call the
03c0: 20 6e 65 77 20 72 65 70 6f 73 69 74 6f 72 79 20   new repository 
03d0: 61 6e 79 74 68 69 6e 67 20 79 6f 75 0a 20 20 20  anything you.   
03e0: 20 77 61 6e 74 20 2d 20 74 68 65 72 65 20 61 72   want - there ar
03f0: 65 20 6e 6f 20 6e 61 6d 69 6e 67 20 72 65 73 74  e no naming rest
0400: 72 69 63 74 69 6f 6e 73 2e 20 20 41 73 20 61 6e  rictions.  As an
0410: 20 65 78 61 6d 70 6c 65 2c 20 79 6f 75 20 63 61   example, you ca
0420: 6e 0a 20 20 20 20 63 6c 6f 6e 65 20 74 68 65 20  n.    clone the 
0430: 66 6f 73 73 69 6c 20 72 65 70 6f 73 69 74 6f 72  fossil repositor
0440: 79 20 74 68 69 73 20 77 61 79 3a 3c 2f 70 3e 0a  y this way:</p>.
0450: 20 20 20 20 0a 20 20 20 20 3c 62 6c 6f 63 6b 71      .    <blockq
0460: 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73  uote>.    <b>fos
0470: 73 69 6c 20 63 6c 6f 6e 65 20 68 74 74 70 3a 2f  sil clone http:/
0480: 2f 77 77 77 2e 66 6f 73 73 69 6c 2d 73 63 6d 2e  /www.fossil-scm.
0490: 6f 72 67 2f 66 6f 73 73 69 6c 20 6d 79 63 6c 6f  org/fossil myclo
04a0: 6e 65 2e 66 73 6c 3c 2f 62 3e 0a 20 20 20 20 3c  ne.fsl</b>.    <
04b0: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20  /blockquote>..  
04c0: 20 20 3c 70 3e 43 6c 6f 6e 69 6e 67 20 6f 6e 6c    <p>Cloning onl
04d0: 79 20 61 20 6c 6f 63 61 6c 20 63 6f 70 79 20 6f  y a local copy o
04e0: 66 20 74 68 65 20 73 6f 75 72 63 65 20 74 72 65  f the source tre
04f0: 65 20 28 61 73 20 61 20 73 69 6e 67 6c 65 20 66  e (as a single f
0500: 69 6c 65 29 2c 20 62 75 74 0a 20 20 20 20 20 20  ile), but.      
0510: 20 20 6e 6f 74 20 73 6f 6d 65 74 68 69 6e 67 20    not something 
0520: 79 6f 75 20 63 61 6e 20 64 69 72 65 63 74 6c 79  you can directly
0530: 20 62 72 6f 77 73 65 2e 20 41 66 74 65 72 20 63   browse. After c
0540: 6c 6f 6e 69 6e 67 2c 20 79 6f 75 20 63 61 6e 20  loning, you can 
0550: 61 63 63 65 73 73 0a 20 20 20 20 20 20 20 20 74  access.        t
0560: 68 65 20 66 69 6c 65 73 20 69 6e 20 74 68 65 20  he files in the 
0570: 72 65 70 6f 73 69 74 6f 72 79 20 75 73 69 6e 67  repository using
0580: 20 74 68 65 20 3c 74 74 3e 6f 70 65 6e 3c 2f 74   the <tt>open</t
0590: 74 3e 20 63 6f 6d 6d 61 6e 64 2c 0a 20 20 20 20  t> command,.    
05a0: 20 20 20 20 64 65 73 63 72 69 62 65 64 20 62 65      described be
05b0: 6c 6f 77 3c 2f 70 3e 0a 0a 20 20 20 20 3c 70 3e  low</p>..    <p>
05c0: 4e 6f 74 65 3a 20 49 66 20 79 6f 75 20 61 72 65  Note: If you are
05d0: 20 62 65 68 69 6e 64 20 61 20 72 65 73 74 72 69   behind a restri
05e0: 63 74 69 76 65 20 66 69 72 65 77 61 6c 6c 2c 20  ctive firewall, 
05f0: 79 6f 75 20 6d 69 67 68 74 20 6e 65 65 64 0a 20  you might need. 
0600: 20 20 20 74 6f 20 3c 61 20 68 72 65 66 3d 22 23     to <a href="#
0610: 70 72 6f 78 79 22 3e 73 70 65 63 69 66 79 20 61  proxy">specify a
0620: 6e 20 48 54 54 50 20 70 72 6f 78 79 3c 2f 61 3e  n HTTP proxy</a>
0630: 20 74 6f 20 75 73 65 2e 3c 2f 70 3e 0a 20 20 20   to use.</p>.   
0640: 20 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c   .</blockquote><
0650: 68 32 3e 53 74 61 72 74 69 6e 67 20 41 20 4e 65  h2>Starting A Ne
0660: 77 20 50 72 6f 6a 65 63 74 3c 2f 68 32 3e 3c 62  w Project</h2><b
0670: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20  lockquote>..    
0680: 3c 70 3e 54 6f 20 73 74 61 72 74 20 61 20 6e 65  <p>To start a ne
0690: 77 20 70 72 6f 6a 65 63 74 20 77 69 74 68 20 66  w project with f
06a0: 6f 73 73 69 6c 2c 20 63 72 65 61 74 65 20 61 20  ossil, create a 
06b0: 6e 65 77 20 65 6d 70 74 79 20 72 65 70 6f 73 69  new empty reposi
06c0: 74 6f 72 79 0a 20 20 20 20 74 68 69 73 20 77 61  tory.    this wa
06d0: 79 3a 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 20 20  y:</p>.    .    
06e0: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20  <blockquote>.   
06f0: 20 3c 62 3e 66 6f 73 73 69 6c 20 6e 65 77 20 3c   <b>fossil new <
0700: 2f 62 3e 3c 69 3e 20 72 65 70 6f 73 69 74 6f 72  /b><i> repositor
0710: 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20  y-filename</i>. 
0720: 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e     </blockquote>
0730: 0a 20 20 20 20 0a 3c 2f 62 6c 6f 63 6b 71 75 6f  .    .</blockquo
0740: 74 65 3e 3c 68 32 3e 43 6f 6e 66 69 67 75 72 69  te><h2>Configuri
0750: 6e 67 20 59 6f 75 72 20 4c 6f 63 61 6c 20 52 65  ng Your Local Re
0760: 70 6f 73 69 74 6f 72 79 3c 2f 68 32 3e 3c 62 6c  pository</h2><bl
0770: 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 0a 20  ockquote>.    . 
0780: 20 20 20 3c 70 3e 57 68 65 6e 20 79 6f 75 20 63     <p>When you c
0790: 72 65 61 74 65 20 61 20 6e 65 77 20 72 65 70 6f  reate a new repo
07a0: 73 69 74 6f 72 79 2c 20 65 69 74 68 65 72 20 62  sitory, either b
07b0: 79 20 63 6c 6f 6e 69 6e 67 20 61 6e 20 65 78 69  y cloning an exi
07c0: 73 74 69 6e 67 0a 20 20 20 20 70 72 6f 6a 65 63  sting.    projec
07d0: 74 20 6f 72 20 63 72 65 61 74 65 20 61 20 6e 65  t or create a ne
07e0: 77 20 70 72 6f 6a 65 63 74 20 6f 66 20 79 6f 75  w project of you
07f0: 72 20 6f 77 6e 2c 20 79 6f 75 20 75 73 75 61 6c  r own, you usual
0800: 6c 79 20 77 61 6e 74 20 74 6f 20 64 6f 20 73 6f  ly want to do so
0810: 6d 65 0a 20 20 20 20 6c 6f 63 61 6c 20 63 6f 6e  me.    local con
0820: 66 69 67 75 72 61 74 69 6f 6e 2e 20 20 54 68 69  figuration.  Thi
0830: 73 20 69 73 20 61 63 63 6f 6d 70 6c 69 73 68 65  s is accomplishe
0840: 64 20 75 73 69 6e 67 20 61 20 77 65 62 62 72 6f  d using a webbro
0850: 77 73 65 72 2e 20 20 46 69 72 73 74 0a 20 20 20  wser.  First.   
0860: 20 73 74 61 72 74 20 61 20 66 6f 73 73 69 6c 20   start a fossil 
0870: 77 65 62 73 65 72 76 65 72 20 6c 69 6b 65 20 74  webserver like t
0880: 68 69 73 3a 3c 2f 70 3e 0a 20 20 20 20 0a 20 20  his:</p>.    .  
0890: 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20    <blockquote>. 
08a0: 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 75 69 20     <b>fossil ui 
08b0: 3c 2f 62 3e 3c 69 3e 20 72 65 70 6f 73 69 74 6f  </b><i> reposito
08c0: 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 0a  ry-filename</i>.
08d0: 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65      </blockquote
08e0: 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 69 73 20 63  >..    <p>This c
08f0: 72 65 61 74 65 73 20 61 20 6d 69 6e 69 2d 77 65  reates a mini-we
0900: 62 73 65 72 76 65 72 20 6c 69 73 74 65 6e 69 6e  bserver listenin
0910: 67 20 6f 6e 20 70 6f 72 74 20 38 30 38 30 2e 20  g on port 8080. 
0920: 20 59 6f 75 20 63 61 6e 0a 20 20 20 20 73 70 65   You can.    spe
0930: 63 69 66 79 20 61 20 64 69 66 66 65 72 65 6e 74  cify a different
0940: 20 70 6f 72 74 20 75 73 69 6e 67 20 74 68 65 20   port using the 
0950: 3c 62 3e 2d 70 6f 72 74 3c 2f 62 3e 20 6f 70 74  <b>-port</b> opt
0960: 69 6f 6e 20 6f 6e 20 74 68 65 20 63 6f 6d 6d 61  ion on the comma
0970: 6e 64 2d 6c 69 6e 65 2e 0a 20 20 20 20 41 66 74  nd-line..    Aft
0980: 65 72 20 74 68 65 20 73 65 72 76 65 72 20 69 73  er the server is
0990: 20 72 75 6e 6e 69 6e 67 2c 20 66 6f 73 73 69 6c   running, fossil
09a0: 20 77 69 6c 6c 20 74 68 65 6e 20 61 74 74 65 6d   will then attem
09b0: 70 74 20 74 6f 20 6c 61 75 6e 63 68 20 79 6f 75  pt to launch you
09c0: 72 0a 20 20 20 20 77 65 62 20 62 72 6f 77 73 65  r.    web browse
09d0: 72 20 61 6e 64 20 6d 61 6b 65 20 69 74 20 70 6f  r and make it po
09e0: 69 6e 74 20 74 6f 20 74 68 69 73 20 77 65 62 20  int to this web 
09f0: 73 65 72 76 65 72 2e 20 20 49 66 20 79 6f 75 72  server.  If your
0a00: 20 73 79 73 74 65 6d 0a 20 20 20 20 68 61 73 20   system.    has 
0a10: 61 6e 20 75 6e 75 73 75 61 6c 20 63 6f 6e 66 69  an unusual confi
0a20: 67 75 72 61 74 69 6f 6e 2c 20 66 6f 73 73 69 6c  guration, fossil
0a30: 20 6d 69 67 68 74 20 6e 6f 74 20 62 65 20 61 62   might not be ab
0a40: 6c 65 20 74 6f 20 66 69 67 75 72 65 20 6f 75 74  le to figure out
0a50: 0a 20 20 20 20 68 6f 77 20 74 6f 20 73 74 61 72  .    how to star
0a60: 74 20 79 6f 75 72 20 77 65 62 20 62 72 6f 77 73  t your web brows
0a70: 65 72 2e 20 20 49 6e 20 74 68 61 74 20 63 61 73  er.  In that cas
0a80: 65 2c 20 73 74 61 72 74 20 74 68 65 20 77 65 62  e, start the web
0a90: 20 62 72 6f 77 73 65 72 0a 20 20 20 20 79 6f 75   browser.    you
0aa0: 72 73 65 6c 66 20 61 6e 64 20 70 6f 69 6e 74 20  rself and point 
0ab0: 69 74 20 61 74 20 68 74 74 70 3a 2f 2f 6c 6f 63  it at http://loc
0ac0: 61 6c 68 6f 73 74 3a 38 30 38 30 2f 2e 20 20 43  alhost:8080/.  C
0ad0: 6c 69 63 6b 20 6f 6e 20 74 68 65 0a 20 20 20 20  lick on the.    
0ae0: 22 53 65 74 75 70 22 20 6c 69 6e 6b 20 6f 6e 20  "Setup" link on 
0af0: 74 68 65 20 6d 65 6e 75 20 62 61 72 20 74 6f 20  the menu bar to 
0b00: 73 74 61 72 74 20 63 6f 6e 66 69 67 75 72 69 6e  start configurin
0b10: 67 20 79 6f 75 72 20 72 65 70 6f 73 69 74 6f 72  g your repositor
0b20: 79 2e 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 20 20  y.</p>.    .    
0b30: 3c 70 3e 42 79 20 64 65 66 61 75 6c 74 2c 20 66  <p>By default, f
0b40: 6f 73 73 69 6c 20 64 6f 65 73 20 6e 6f 74 20 72  ossil does not r
0b50: 65 71 75 69 72 65 20 61 20 6c 6f 67 69 6e 20 66  equire a login f
0b60: 6f 72 20 48 54 54 50 20 63 6f 6e 6e 65 63 74 69  or HTTP connecti
0b70: 6f 6e 73 0a 20 20 20 20 63 6f 6d 69 6e 67 20 69  ons.    coming i
0b80: 6e 20 66 72 6f 6d 20 74 68 65 20 49 50 20 6c 6f  n from the IP lo
0b90: 6f 70 62 61 63 6b 20 61 64 64 72 65 73 73 20 31  opback address 1
0ba0: 32 37 2e 30 2e 30 2e 31 2e 20 20 59 6f 75 20 63  27.0.0.1.  You c
0bb0: 61 6e 2c 20 61 6e 64 20 70 65 72 68 61 70 73 0a  an, and perhaps.
0bc0: 20 20 20 20 73 68 6f 75 6c 64 2c 20 63 68 61 6e      should, chan
0bd0: 67 65 20 74 68 69 73 20 61 66 74 65 72 20 79 6f  ge this after yo
0be0: 75 20 63 72 65 61 74 65 20 61 20 66 65 77 20 75  u create a few u
0bf0: 73 65 72 73 2e 3c 2f 70 3e 0a 20 20 20 20 0a 20  sers.</p>.    . 
0c00: 20 20 20 3c 70 3e 57 68 65 6e 20 79 6f 75 20 61     <p>When you a
0c10: 72 65 20 66 69 6e 69 73 68 65 64 20 63 6f 6e 66  re finished conf
0c20: 69 67 75 72 69 6e 67 2c 20 6a 75 73 74 20 70 72  iguring, just pr
0c30: 65 73 73 20 43 6f 6e 74 72 6f 6c 2d 43 20 6f 72  ess Control-C or
0c40: 20 75 73 65 0a 20 20 20 20 74 68 65 20 3c 62 3e   use.    the <b>
0c50: 6b 69 6c 6c 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64  kill</b> command
0c60: 20 74 6f 20 73 68 75 74 20 64 6f 77 6e 20 74 68   to shut down th
0c70: 65 20 6d 69 6e 69 2d 73 65 72 76 65 72 2e 3c 2f  e mini-server.</
0c80: 70 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65  p>..</blockquote
0c90: 3e 3c 68 32 3e 43 68 65 63 6b 69 6e 67 20 4f 75  ><h2>Checking Ou
0ca0: 74 20 41 20 4c 6f 63 61 6c 20 54 72 65 65 3c 2f  t A Local Tree</
0cb0: 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a  h2><blockquote>.
0cc0: 0a 20 20 20 20 3c 70 3e 54 6f 20 77 6f 72 6b 20  .    <p>To work 
0cd0: 6f 6e 20 61 20 70 72 6f 6a 65 63 74 20 69 6e 20  on a project in 
0ce0: 66 6f 73 73 69 6c 2c 20 79 6f 75 20 6e 65 65 64  fossil, you need
0cf0: 20 74 6f 20 63 68 65 63 6b 20 6f 75 74 20 61 20   to check out a 
0d00: 6c 6f 63 61 6c 0a 20 20 20 20 63 6f 70 79 20 6f  local.    copy o
0d10: 66 20 74 68 65 20 73 6f 75 72 63 65 20 74 72 65  f the source tre
0d20: 65 2e 20 20 43 72 65 61 74 65 20 74 68 65 20 64  e.  Create the d
0d30: 69 72 65 63 74 6f 72 79 20 79 6f 75 20 77 61 6e  irectory you wan
0d40: 74 20 74 6f 20 62 65 0a 20 20 20 20 74 68 65 20  t to be.    the 
0d50: 72 6f 6f 74 20 6f 66 20 79 6f 75 72 20 74 72 65  root of your tre
0d60: 65 20 61 6e 64 20 63 64 20 69 6e 74 6f 20 74 68  e and cd into th
0d70: 61 74 20 64 69 72 65 63 74 6f 72 79 2e 20 20 54  at directory.  T
0d80: 68 65 6e 0a 20 20 20 20 74 6f 20 74 68 69 73 3a  hen.    to this:
0d90: 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 20 20 3c 62  </p>.    .    <b
0da0: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c  lockquote>.    <
0db0: 62 3e 66 6f 73 73 69 6c 20 6f 70 65 6e 20 3c 2f  b>fossil open </
0dc0: 62 3e 3c 69 3e 20 72 65 70 6f 73 69 74 6f 72 79  b><i> repository
0dd0: 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20  -filename</i>.  
0de0: 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a    </blockquote>.
0df0: 20 20 20 20 0a 20 20 20 20 3c 70 3e 54 68 69 73      .    <p>This
0e00: 20 6c 65 61 76 65 73 20 79 6f 75 20 77 69 74 68   leaves you with
0e10: 20 74 68 65 20 6e 65 77 65 73 74 20 76 65 72 73   the newest vers
0e20: 69 6f 6e 20 6f 66 20 74 68 65 20 74 72 65 65 0a  ion of the tree.
0e30: 20 20 20 20 63 68 65 63 6b 65 64 20 6f 75 74 2e      checked out.
0e40: 20 20 20 20 0a 20 20 20 20 46 72 6f 6d 20 61 6e      .    From an
0e50: 79 77 68 65 72 65 20 75 6e 64 65 72 6e 65 61 74  ywhere underneat
0e60: 68 20 74 68 65 20 72 6f 6f 74 20 6f 66 20 79 6f  h the root of yo
0e70: 75 72 20 6c 6f 63 61 6c 20 74 72 65 65 2c 20 79  ur local tree, y
0e80: 6f 75 0a 20 20 20 20 63 61 6e 20 74 79 70 65 20  ou.    can type 
0e90: 63 6f 6d 6d 61 6e 64 73 20 6c 69 6b 65 20 74 68  commands like th
0ea0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 6f 20 66  e following to f
0eb0: 69 6e 64 20 6f 75 74 20 74 68 65 20 73 74 61 74  ind out the stat
0ec0: 75 73 20 6f 66 0a 20 20 20 20 79 6f 75 72 20 6c  us of.    your l
0ed0: 6f 63 61 6c 20 74 72 65 65 3a 3c 2f 70 3e 0a 0a  ocal tree:</p>..
0ee0: 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e      <blockquote>
0ef0: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 69  .    <b>fossil i
0f00: 6e 66 6f 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 20  nfo</b><br>.    
0f10: 3c 62 3e 66 6f 73 73 69 6c 20 73 74 61 74 75 73  <b>fossil status
0f20: 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e  </b><br>.    <b>
0f30: 66 6f 73 73 69 6c 20 63 68 61 6e 67 65 73 3c 2f  fossil changes</
0f40: 62 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f  b><br>.    <b>fo
0f50: 73 73 69 6c 20 74 69 6d 65 6c 69 6e 65 3c 2f 62  ssil timeline</b
0f60: 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73  ><br>.    <b>fos
0f70: 73 69 6c 20 6c 65 61 76 65 73 3c 2f 62 3e 3c 62  sil leaves</b><b
0f80: 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c  r>.    <b>fossil
0f90: 20 6c 73 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 20   ls</b><br>.    
0fa0: 3c 62 3e 66 6f 73 73 69 6c 20 62 72 61 6e 63 68  <b>fossil branch
0fb0: 65 73 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 20 3c  es</b><br>.    <
0fc0: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 2f  /blockquote>..</
0fd0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 4d  blockquote><h2>M
0fe0: 61 6b 69 6e 67 20 43 68 61 6e 67 65 73 3c 2f 68  aking Changes</h
0ff0: 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a  2><blockquote>..
1000: 20 20 20 20 3c 70 3e 54 6f 20 61 64 64 20 6e 65      <p>To add ne
1010: 77 20 66 69 6c 65 73 20 74 6f 20 79 6f 75 72 20  w files to your 
1020: 70 72 6f 6a 65 63 74 2c 20 6f 72 20 72 65 6d 6f  project, or remo
1030: 76 65 20 6f 6c 64 20 66 69 6c 65 73 2c 20 75 73  ve old files, us
1040: 65 20 74 68 65 73 65 0a 20 20 20 20 63 6f 6d 6d  e these.    comm
1050: 61 6e 64 73 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c  ands:</p>..    <
1060: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20  blockquote>.    
1070: 3c 62 3e 66 6f 73 73 69 6c 20 61 64 64 3c 2f 62  <b>fossil add</b
1080: 3e 20 3c 69 3e 66 69 6c 65 2e 2e 2e 3c 2f 69 3e  > <i>file...</i>
1090: 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73  <br>.    <b>foss
10a0: 69 6c 20 72 6d 3c 2f 62 3e 20 3c 69 3e 66 69 6c  il rm</b> <i>fil
10b0: 65 2e 2e 2e 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62  e...</i>.    </b
10c0: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20  lockquote>..    
10d0: 3c 70 3e 59 6f 75 20 63 61 6e 20 61 6c 73 6f 20  <p>You can also 
10e0: 65 64 69 74 20 66 69 6c 65 73 20 66 72 65 65 6c  edit files freel
10f0: 79 2e 20 20 4f 6e 63 65 20 79 6f 75 20 61 72 65  y.  Once you are
1100: 20 72 65 61 64 79 20 74 6f 20 63 6f 6d 6d 69 74   ready to commit
1110: 0a 20 20 20 20 79 6f 75 72 20 63 68 61 6e 67 65  .    your change
1120: 73 2c 20 74 79 70 65 3a 3c 2f 70 3e 0a 0a 20 20  s, type:</p>..  
1130: 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20    <blockquote>. 
1140: 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 63 6f 6d     <b>fossil com
1150: 6d 69 74 3c 2f 62 3e 0a 20 20 20 20 3c 2f 62 6c  mit</b>.    </bl
1160: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c  ockquote>..    <
1170: 70 3e 59 6f 75 20 77 69 6c 6c 20 62 65 20 70 72  p>You will be pr
1180: 6f 6d 70 74 65 64 20 66 6f 72 20 63 68 65 63 6b  ompted for check
1190: 2d 69 6e 20 63 6f 6d 6d 65 6e 74 73 20 75 73 69  -in comments usi
11a0: 6e 67 20 77 68 61 74 65 76 65 72 20 65 64 69 74  ng whatever edit
11b0: 6f 72 0a 20 20 20 20 69 73 20 73 70 65 63 69 66  or.    is specif
11c0: 69 65 64 20 62 79 20 79 6f 75 72 20 56 49 53 55  ied by your VISU
11d0: 41 4c 20 6f 72 20 45 44 49 54 4f 52 20 65 6e 76  AL or EDITOR env
11e0: 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c  ironment variabl
11f0: 65 2e 20 20 49 66 20 79 6f 75 0a 20 20 20 20 68  e.  If you.    h
1200: 61 76 65 20 47 50 47 20 69 6e 73 74 61 6c 6c 65  ave GPG installe
1210: 64 2c 20 79 6f 75 20 6d 61 79 20 62 65 20 70 72  d, you may be pr
1220: 6f 6d 70 74 65 64 20 66 6f 72 20 79 6f 75 72 20  ompted for your 
1230: 47 50 47 20 70 61 73 73 70 68 72 61 73 65 20 73  GPG passphrase s
1240: 6f 0a 20 20 20 20 74 68 61 74 20 74 68 65 20 63  o.    that the c
1250: 68 65 63 6b 2d 69 6e 20 63 61 6e 20 62 65 20 73  heck-in can be s
1260: 69 67 6e 65 64 20 77 69 74 68 20 79 6f 75 72 20  igned with your 
1270: 47 50 47 20 73 69 67 6e 61 74 75 72 65 2e 20 20  GPG signature.  
1280: 41 66 74 65 72 0a 20 20 20 20 74 68 69 73 20 79  After.    this y
1290: 6f 75 72 20 63 68 61 6e 67 65 73 20 77 69 6c 6c  our changes will
12a0: 20 62 65 20 63 68 65 63 6b 65 64 20 69 6e 2e 3c   be checked in.<
12b0: 2f 70 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74  /p>..</blockquot
12c0: 65 3e 3c 68 32 3e 53 68 61 72 69 6e 67 20 43 68  e><h2>Sharing Ch
12d0: 61 6e 67 65 73 3c 2f 68 32 3e 3c 62 6c 6f 63 6b  anges</h2><block
12e0: 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54  quote>..    <p>T
12f0: 68 65 20 63 68 61 6e 67 65 73 20 79 6f 75 20 3c  he changes you <
1300: 62 3e 63 6f 6d 6d 69 74 3c 2f 62 3e 20 61 72 65  b>commit</b> are
1310: 20 6f 6e 6c 79 20 6f 6e 20 79 6f 75 72 20 6c 6f   only on your lo
1320: 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 2e 0a  cal repository..
1330: 20 20 20 20 54 6f 20 73 68 61 72 65 20 74 68 6f      To share tho
1340: 73 65 20 63 68 61 6e 67 65 73 20 77 69 74 68 20  se changes with 
1350: 6f 74 68 65 72 20 72 65 70 6f 73 69 74 6f 72 69  other repositori
1360: 65 73 2c 20 64 6f 3a 3c 2f 70 3e 0a 0a 20 20 20  es, do:</p>..   
1370: 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20   <blockquote>.  
1380: 20 20 3c 62 3e 66 6f 73 73 69 6c 20 70 75 73 68    <b>fossil push
1390: 3c 2f 62 3e 20 3c 69 3e 55 52 4c 3c 2f 69 3e 0a  </b> <i>URL</i>.
13a0: 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65      </blockquote
13b0: 3e 0a 0a 20 20 20 20 3c 70 3e 57 68 65 72 65 20  >..    <p>Where 
13c0: 3c 69 3e 55 52 4c 3c 2f 69 3e 20 69 73 20 74 68  <i>URL</i> is th
13d0: 65 20 68 74 74 70 3a 20 55 52 4c 20 6f 66 20 74  e http: URL of t
13e0: 68 65 20 73 65 72 76 65 72 20 72 65 70 6f 73 69  he server reposi
13f0: 74 6f 72 79 20 79 6f 75 0a 20 20 20 20 77 61 6e  tory you.    wan
1400: 74 20 74 6f 20 73 68 61 72 65 20 79 6f 75 72 20  t to share your 
1410: 63 68 61 6e 67 65 73 20 77 69 74 68 2e 20 20 49  changes with.  I
1420: 66 20 79 6f 75 20 6f 6d 69 74 20 74 68 65 20 3c  f you omit the <
1430: 69 3e 55 52 4c 3c 2f 69 3e 20 61 72 67 75 6d 65  i>URL</i> argume
1440: 6e 74 2c 0a 20 20 20 20 66 6f 73 73 69 6c 20 77  nt,.    fossil w
1450: 69 6c 6c 20 75 73 65 20 77 68 61 74 65 76 65 72  ill use whatever
1460: 20 73 65 72 76 65 72 20 79 6f 75 20 6d 6f 73 74   server you most
1470: 20 72 65 63 65 6e 74 6c 79 20 73 79 6e 63 65 64   recently synced
1480: 20 77 69 74 68 2e 3c 2f 70 3e 0a 0a 20 20 20 20   with.</p>..    
1490: 3c 70 3e 54 68 65 20 3c 62 3e 70 75 73 68 3c 2f  <p>The <b>push</
14a0: 62 3e 20 63 6f 6d 6d 61 6e 64 20 6f 6e 6c 79 20  b> command only 
14b0: 73 65 6e 64 73 20 79 6f 75 72 20 63 68 61 6e 67  sends your chang
14c0: 65 73 20 74 6f 20 6f 74 68 65 72 73 2e 20 20 54  es to others.  T
14d0: 6f 0a 20 20 20 20 52 65 63 65 69 76 65 20 63 68  o.    Receive ch
14e0: 61 6e 67 65 73 20 66 72 6f 6d 20 6f 74 68 65 72  anges from other
14f0: 73 2c 20 75 73 65 20 3c 62 3e 70 75 6c 6c 3c 2f  s, use <b>pull</
1500: 62 3e 2e 20 20 4f 72 20 67 6f 20 62 6f 74 68 20  b>.  Or go both 
1510: 77 61 79 73 20 61 74 0a 20 20 20 20 6f 6e 63 65  ways at.    once
1520: 20 75 73 69 6e 67 20 3c 62 3e 73 79 6e 63 3c 2f   using <b>sync</
1530: 62 3e 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c  b>:</p>..    <bl
1540: 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62  ockquote>.    <b
1550: 3e 66 6f 73 73 69 6c 20 70 75 6c 6c 3c 2f 62 3e  >fossil pull</b>
1560: 20 3c 69 3e 55 52 4c 3c 2f 69 3e 3c 62 72 3e 0a   <i>URL</i><br>.
1570: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 73 79      <b>fossil sy
1580: 6e 63 3c 2f 62 3e 20 3c 69 3e 55 52 4c 3c 2f 69  nc</b> <i>URL</i
1590: 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f  >.    </blockquo
15a0: 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 57 68 65 6e  te>..    <p>When
15b0: 20 79 6f 75 20 70 75 6c 6c 20 69 6e 20 63 68 61   you pull in cha
15c0: 6e 67 65 73 20 66 72 6f 6d 20 6f 74 68 65 72 73  nges from others
15d0: 2c 20 74 68 65 79 20 67 6f 20 69 6e 74 6f 20 79  , they go into y
15e0: 6f 75 72 20 72 65 70 6f 73 69 74 6f 72 79 2c 0a  our repository,.
15f0: 20 20 20 20 6e 6f 74 20 69 6e 74 6f 20 79 6f 75      not into you
1600: 72 20 63 68 65 63 6b 65 64 2d 6f 75 74 20 6c 6f  r checked-out lo
1610: 63 61 6c 20 74 72 65 65 2e 20 20 54 6f 20 67 65  cal tree.  To ge
1620: 74 20 74 68 65 20 63 68 61 6e 67 65 73 20 69 6e  t the changes in
1630: 74 6f 20 79 6f 75 72 0a 20 20 20 20 6c 6f 63 61  to your.    loca
1640: 6c 20 74 72 65 65 2c 20 75 73 65 20 3c 62 3e 75  l tree, use <b>u
1650: 70 64 61 74 65 3c 2f 62 3e 3a 3c 2f 70 3e 0a 0a  pdate</b>:</p>..
1660: 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e      <blockquote>
1670: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 75  .    <b>fossil u
1680: 70 64 61 74 65 3c 2f 62 3e 20 3c 69 3e 55 55 49  pdate</b> <i>UUI
1690: 44 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63  D</i>.    </bloc
16a0: 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e  kquote>..    <p>
16b0: 54 68 65 20 3c 69 3e 55 55 49 44 3c 2f 69 3e 20  The <i>UUID</i> 
16c0: 69 73 20 73 6f 6d 65 20 75 6e 69 71 75 65 20 61  is some unique a
16d0: 62 62 72 65 76 69 61 74 69 6f 6e 20 74 6f 20 74  bbreviation to t
16e0: 68 65 20 34 30 2d 63 68 61 72 61 63 74 65 72 0a  he 40-character.
16f0: 20 20 20 20 76 65 72 73 69 6f 6e 20 49 44 2e 20      version ID. 
1700: 20 49 66 20 79 6f 75 20 6f 6d 69 74 20 74 68 65   If you omit the
1710: 20 3c 69 3e 55 55 49 44 3c 2f 69 3e 20 66 6f 73   <i>UUID</i> fos
1720: 73 69 6c 20 6d 6f 76 65 73 20 79 6f 75 20 74 6f  sil moves you to
1730: 20 74 68 65 0a 20 20 20 20 6c 65 61 66 20 76 65   the.    leaf ve
1740: 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 62 72 61  rsion of the bra
1750: 6e 63 68 20 79 6f 75 72 20 61 72 65 20 63 75 72  nch your are cur
1760: 72 65 6e 74 6c 79 20 6f 6e 2e 20 20 49 66 20 79  rently on.  If y
1770: 6f 75 72 20 62 72 61 6e 63 68 0a 20 20 20 20 68  our branch.    h
1780: 61 73 20 6d 75 6c 74 69 70 6c 65 20 6c 65 61 76  as multiple leav
1790: 65 73 2c 20 79 6f 75 20 67 65 74 20 61 6e 20 65  es, you get an e
17a0: 72 72 6f 72 20 2d 20 79 6f 75 27 6c 6c 20 68 61  rror - you'll ha
17b0: 76 65 20 74 6f 20 73 70 65 63 69 66 79 20 74 68  ve to specify th
17c0: 65 0a 20 20 20 20 6c 65 61 66 20 79 6f 75 20 77  e.    leaf you w
17d0: 61 6e 74 20 75 73 69 6e 67 20 61 20 3c 69 3e 55  ant using a <i>U
17e0: 55 49 44 3c 2f 69 3e 20 61 72 67 75 6d 65 6e 74  UID</i> argument
17f0: 2e 3c 2f 70 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75  .</p>..</blockqu
1800: 6f 74 65 3e 3c 68 32 3e 42 72 61 6e 63 68 69 6e  ote><h2>Branchin
1810: 67 20 41 6e 64 20 4d 65 72 67 69 6e 67 3c 2f 68  g And Merging</h
1820: 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a  2><blockquote>..
1830: 20 20 20 20 3c 70 3e 59 6f 75 20 63 61 6e 20 63      <p>You can c
1840: 72 65 61 74 65 20 62 72 61 6e 63 68 65 73 20 62  reate branches b
1850: 79 20 64 6f 69 6e 67 20 6d 75 6c 74 69 70 6c 65  y doing multiple
1860: 20 63 6f 6d 6d 69 74 73 20 6f 66 66 20 6f 66 20   commits off of 
1870: 74 68 65 0a 20 20 20 20 73 61 6d 65 20 62 61 73  the.    same bas
1880: 65 20 76 65 72 73 69 6f 6e 2e 20 20 54 6f 20 6d  e version.  To m
1890: 65 72 67 65 20 74 6f 20 62 72 61 6e 63 68 65 73  erge to branches
18a0: 20 62 61 63 6b 20 74 6f 67 65 74 68 65 72 2c 20   back together, 
18b0: 66 69 72 73 74 0a 20 20 20 20 3c 62 3e 75 70 64  first.    <b>upd
18c0: 61 74 65 3c 2f 62 3e 20 74 6f 20 74 68 65 20 6c  ate</b> to the l
18d0: 65 61 66 20 6f 66 20 6f 6e 65 20 62 72 61 6e 63  eaf of one branc
18e0: 68 2e 20 20 54 68 65 6e 20 64 6f 20 61 20 3c 62  h.  Then do a <b
18f0: 3e 6d 65 72 67 65 3c 2f 62 3e 0a 20 20 20 20 6f  >merge</b>.    o
1900: 66 20 74 68 65 20 6c 65 61 66 20 6f 66 20 74 68  f the leaf of th
1910: 65 20 6f 74 68 65 72 20 62 72 61 6e 63 68 3a 3c  e other branch:<
1920: 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71  /p>..    <blockq
1930: 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73  uote>.    <b>fos
1940: 73 69 6c 20 6d 65 72 67 65 3c 2f 62 3e 20 3c 69  sil merge</b> <i
1950: 3e 55 55 49 44 3c 2f 69 3e 0a 20 20 20 20 3c 2f  >UUID</i>.    </
1960: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20  blockquote>..   
1970: 20 3c 70 3e 54 65 73 74 20 74 6f 20 6d 61 6b 65   <p>Test to make
1980: 20 73 75 72 65 20 79 6f 75 72 20 6d 65 72 67 65   sure your merge
1990: 20 64 69 64 6e 27 74 20 6d 65 73 73 20 75 70 20   didn't mess up 
19a0: 74 68 65 20 63 6f 64 65 2c 20 74 68 65 6e 0a 20  the code, then. 
19b0: 20 20 20 3c 62 3e 63 6f 6d 6d 69 74 3c 2f 62 3e     <b>commit</b>
19c0: 20 61 6e 64 20 70 6f 73 73 69 62 6c 79 20 61 6c   and possibly al
19d0: 73 6f 20 3c 62 3e 70 75 73 68 3c 2f 62 3e 20 79  so <b>push</b> y
19e0: 6f 75 72 20 63 68 61 6e 67 65 73 2e 20 20 20 52  our changes.   R
19f0: 65 6d 65 6d 62 65 72 0a 20 20 20 20 74 68 61 74  emember.    that
1a00: 20 6e 6f 62 6f 64 79 20 65 6c 73 65 20 63 61 6e   nobody else can
1a10: 20 73 65 65 20 79 6f 75 72 20 63 68 61 6e 67 65   see your change
1a20: 73 20 75 6e 74 69 6c 20 79 6f 75 20 3c 62 3e 63  s until you <b>c
1a30: 6f 6d 6d 69 74 3c 2f 62 3e 20 61 6e 64 0a 20 20  ommit</b> and.  
1a40: 20 20 69 66 20 6f 74 68 65 72 20 61 72 65 20 75    if other are u
1a50: 73 69 6e 67 20 61 20 64 69 66 66 65 72 65 6e 74  sing a different
1a60: 20 72 65 70 6f 73 69 74 6f 72 79 20 79 6f 75 20   repository you 
1a70: 77 69 6c 6c 20 61 6c 73 6f 20 6e 65 65 64 20 74  will also need t
1a80: 6f 0a 20 20 20 20 3c 62 3e 70 75 73 68 3c 2f 62  o.    <b>push</b
1a90: 3e 2e 3c 2f 70 3e 0a 0a 3c 61 20 6e 61 6d 65 3d  >.</p>..<a name=
1aa0: 22 73 65 72 76 65 72 73 65 74 75 70 22 3e 0a 3c  "serversetup">.<
1ab0: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e  /blockquote><h2>
1ac0: 53 65 74 74 69 6e 67 20 55 70 20 41 20 53 65 72  Setting Up A Ser
1ad0: 76 65 72 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75  ver</h2><blockqu
1ae0: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65  ote>..    <p>The
1af0: 20 65 61 73 69 65 73 74 20 77 61 79 20 74 6f 20   easiest way to 
1b00: 73 65 74 20 75 70 20 61 20 73 65 72 76 65 72 20  set up a server 
1b10: 69 73 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c  is:</p>..    <bl
1b20: 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62  ockquote>.    <b
1b30: 3e 66 6f 73 73 69 6c 20 73 65 72 76 65 72 3c 2f  >fossil server</
1b40: 62 3e 20 3c 69 3e 72 65 70 6f 73 69 74 6f 72 79  b> <i>repository
1b50: 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20  -filename</i>.  
1b60: 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a    </blockquote>.
1b70: 0a 20 20 20 20 3c 70 3e 4f 72 3c 2f 62 3e 0a 0a  .    <p>Or</b>..
1b80: 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e      <blockquote>
1b90: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 75  .    <b>fossil u
1ba0: 69 3c 2f 62 3e 20 3c 69 3e 72 65 70 6f 73 69 74  i</b> <i>reposit
1bb0: 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e  ory-filename</i>
1bc0: 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74  .    </blockquot
1bd0: 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 64  e>..    <p>The d
1be0: 69 66 66 65 72 65 6e 63 65 20 62 65 74 77 65 65  ifference betwee
1bf0: 6e 20 74 68 65 73 65 20 74 77 6f 20 63 6f 6d 6d  n these two comm
1c00: 61 6e 64 20 69 73 20 74 68 61 74 20 3c 62 3e 75  and is that <b>u
1c10: 69 3c 2f 62 3e 0a 20 20 20 20 61 74 74 65 6d 70  i</b>.    attemp
1c20: 74 73 20 74 6f 20 61 75 74 6f 6d 61 74 69 63 61  ts to automatica
1c30: 6c 6c 79 20 73 74 61 72 74 20 79 6f 75 72 20 77  lly start your w
1c40: 65 62 20 62 72 6f 77 73 65 72 20 70 6f 69 6e 74  eb browser point
1c50: 20 61 74 20 74 68 65 0a 20 20 20 20 73 65 72 76   at the.    serv
1c60: 65 72 20 77 68 65 72 65 61 73 20 3c 62 3e 73 65  er whereas <b>se
1c70: 72 76 65 72 3c 2f 62 3e 20 64 6f 65 73 20 6e 6f  rver</b> does no
1c80: 74 2e 0a 20 20 20 20 59 6f 75 20 63 61 6e 20 6f  t..    You can o
1c90: 6d 69 74 20 74 68 65 20 3c 69 3e 72 65 70 6f 73  mit the <i>repos
1ca0: 69 74 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f  itory-filename</
1cb0: 69 3e 20 69 66 20 79 6f 75 20 61 72 65 20 77 69  i> if you are wi
1cc0: 74 68 69 6e 0a 20 20 20 20 61 20 63 68 65 63 6b  thin.    a check
1cd0: 65 64 2d 6f 75 74 20 6c 6f 63 61 6c 20 74 72 65  ed-out local tre
1ce0: 65 2e 20 20 54 68 69 73 20 73 65 72 76 65 72 20  e.  This server 
1cf0: 75 73 65 73 20 70 6f 72 74 20 38 30 38 30 20 62  uses port 8080 b
1d00: 79 20 64 65 66 61 75 6c 74 0a 20 20 20 20 62 75  y default.    bu
1d10: 74 20 79 6f 75 20 63 61 6e 20 73 70 65 63 69 66  t you can specif
1d20: 79 20 61 20 64 69 66 66 65 72 65 6e 74 20 70 6f  y a different po
1d30: 72 74 20 75 73 69 6e 67 20 74 68 65 20 3c 62 3e  rt using the <b>
1d40: 2d 70 6f 72 74 3c 2f 62 3e 20 63 6f 6d 6d 61 6e  -port</b> comman
1d50: 64 2e 3c 2f 70 3e 0a 0a 20 20 20 20 3c 70 3e 43  d.</p>..    <p>C
1d60: 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 73 65 72 76  ommand-line serv
1d70: 65 72 73 20 6c 69 6b 65 20 74 68 69 73 20 61 72  ers like this ar
1d80: 65 20 75 73 65 66 75 6c 20 77 68 65 6e 20 74 77  e useful when tw
1d90: 6f 20 70 65 6f 70 6c 65 20 77 61 6e 74 0a 20 20  o people want.  
1da0: 20 20 74 6f 20 73 68 61 72 65 20 61 20 72 65 70    to share a rep
1db0: 6f 73 69 74 6f 72 79 20 6f 6e 20 74 65 6d 70 6f  ository on tempo
1dc0: 72 61 72 79 20 6f 72 20 61 64 2d 68 6f 63 20 62  rary or ad-hoc b
1dd0: 61 73 69 73 2e 20 20 46 6f 72 20 61 20 6d 6f 72  asis.  For a mor
1de0: 65 0a 20 20 20 20 70 65 72 6d 61 6e 65 6e 74 20  e.    permanent 
1df0: 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 2c 20 79 6f  installation, yo
1e00: 75 20 73 68 6f 75 6c 64 20 75 73 65 20 65 69 74  u should use eit
1e10: 68 65 72 20 74 68 65 20 43 47 49 20 73 65 72 76  her the CGI serv
1e20: 65 72 20 6f 72 20 74 68 65 0a 20 20 20 20 69 6e  er or the.    in
1e30: 65 74 64 20 73 65 72 76 65 72 2e 20 20 54 6f 20  etd server.  To 
1e40: 75 73 65 20 74 68 65 20 43 47 49 20 73 65 72 76  use the CGI serv
1e50: 65 72 2c 20 63 72 65 61 74 65 20 61 20 43 47 49  er, create a CGI
1e60: 20 73 63 72 69 70 74 20 74 68 61 74 0a 20 20 20   script that.   
1e70: 20 6c 6f 6f 6b 73 20 73 6f 6d 65 74 68 69 6e 67   looks something
1e80: 20 6c 69 6b 65 20 74 68 69 73 3a 3c 2f 70 3e 0a   like this:</p>.
1e90: 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65  .    <blockquote
1ea0: 3e 3c 62 3e 0a 20 20 20 20 23 21 2f 75 73 72 2f  ><b>.    #!/usr/
1eb0: 6c 6f 63 61 6c 2f 62 69 6e 2f 66 6f 73 73 69 6c  local/bin/fossil
1ec0: 3c 62 72 3e 0a 20 20 20 20 72 65 70 6f 73 69 74  <br>.    reposit
1ed0: 6f 72 79 3a 20 2f 68 6f 6d 65 2f 70 72 6f 6a 31  ory: /home/proj1
1ee0: 2f 72 65 70 6f 73 31 2e 66 73 6c 0a 20 20 20 20  /repos1.fsl.    
1ef0: 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65  </b></blockquote
1f00: 3e 0a 0a 20 20 20 20 3c 70 3e 41 64 6a 75 73 74  >..    <p>Adjust
1f10: 20 74 68 65 20 70 61 74 68 73 20 69 6e 20 74 68   the paths in th
1f20: 69 73 20 43 47 49 20 73 63 72 69 70 74 20 74 6f  is CGI script to
1f30: 20 6d 61 74 63 68 20 79 6f 75 72 20 69 6e 73 74   match your inst
1f40: 61 6c 6c 61 74 69 6f 6e 2e 0a 20 20 20 20 4e 6f  allation..    No
1f50: 77 20 70 6f 69 6e 74 20 63 6c 69 65 6e 74 73 20  w point clients 
1f60: 61 74 20 74 68 65 20 43 47 49 20 73 63 72 69 70  at the CGI scrip
1f70: 74 2e 20 20 54 68 61 74 27 73 20 61 6c 6c 20 74  t.  That's all t
1f80: 68 65 72 65 20 69 73 20 74 6f 20 69 74 21 3c 2f  here is to it!</
1f90: 70 3e 0a 0a 20 20 20 20 3c 70 3e 59 6f 75 20 63  p>..    <p>You c
1fa0: 61 6e 20 61 6c 73 6f 20 72 75 6e 20 66 6f 73 73  an also run foss
1fb0: 69 6c 20 6f 66 66 20 6f 66 20 69 6e 65 74 64 20  il off of inetd 
1fc0: 6f 72 20 78 69 6e 65 74 64 2e 20 20 46 6f 72 20  or xinetd.  For 
1fd0: 61 6e 20 69 6e 65 74 64 0a 20 20 20 20 69 6e 73  an inetd.    ins
1fe0: 74 61 6c 6c 61 74 69 6f 6e 2c 20 6d 61 6b 65 20  tallation, make 
1ff0: 61 6e 20 65 6e 74 72 79 20 69 6e 20 2f 65 74 63  an entry in /etc
2000: 2f 69 6e 65 74 64 2e 63 6f 6e 66 20 74 68 61 74  /inetd.conf that
2010: 20 6c 6f 6f 6b 73 20 73 6f 6d 65 74 68 69 6e 67   looks something
2020: 0a 20 20 20 20 6c 69 6b 65 20 74 68 69 73 3a 3c  .    like this:<
2030: 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71  /p>..    <blockq
2040: 75 6f 74 65 3e 3c 62 3e 0a 20 20 20 20 38 30 20  uote><b>.    80 
2050: 73 74 72 65 61 6d 20 74 63 70 20 6e 6f 77 61 69  stream tcp nowai
2060: 74 2e 31 30 30 30 20 72 6f 6f 74 20 2f 75 73 72  t.1000 root /usr
2070: 2f 62 69 6e 2f 66 6f 73 73 69 6c 20 5c 3c 62 72  /bin/fossil \<br
2080: 3e 0a 20 20 20 20 20 20 20 20 2f 75 73 72 2f 62  >.        /usr/b
2090: 69 6e 2f 66 6f 73 73 69 6c 20 68 74 74 70 20 2f  in/fossil http /
20a0: 68 6f 6d 65 2f 70 72 6f 6a 31 2f 72 65 70 6f 73  home/proj1/repos
20b0: 31 2e 66 73 6c 0a 20 20 20 20 3c 2f 62 3e 3c 2f  1.fsl.    </b></
20c0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20  blockquote>..   
20d0: 20 3c 70 3e 41 64 6a 75 73 74 20 74 68 65 20 70   <p>Adjust the p
20e0: 61 74 68 73 20 74 6f 20 73 75 69 74 20 79 6f 75  aths to suit you
20f0: 72 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 2c 20  r installation, 
2100: 6f 66 20 63 6f 75 72 73 65 2e 20 20 4e 6f 74 69  of course.  Noti
2110: 63 65 20 74 68 61 74 0a 20 20 20 20 66 6f 73 73  ce that.    foss
2120: 69 6c 20 72 75 6e 73 20 61 73 20 72 6f 6f 74 2e  il runs as root.
2130: 20 20 54 68 69 73 20 69 73 20 6e 6f 74 20 72 65    This is not re
2140: 71 75 69 72 65 64 20 2d 20 79 6f 75 20 63 61 6e  quired - you can
2150: 20 72 75 6e 20 69 74 20 61 73 20 61 6e 0a 20 20   run it as an.  
2160: 20 20 75 6e 70 72 69 76 69 6c 65 67 65 64 20 75    unprivileged u
2170: 73 65 72 2e 20 20 42 75 74 20 69 74 20 69 73 20  ser.  But it is 
2180: 6d 6f 72 65 20 73 65 63 75 72 65 20 74 6f 20 72  more secure to r
2190: 75 6e 20 66 6f 73 73 69 6c 20 61 73 20 72 6f 6f  un fossil as roo
21a0: 74 2e 0a 20 20 20 20 57 68 65 6e 20 79 6f 75 20  t..    When you 
21b0: 64 6f 20 72 75 6e 20 66 6f 73 73 69 6c 20 61 73  do run fossil as
21c0: 20 72 6f 6f 74 2c 20 69 74 20 61 75 74 6f 6d 61   root, it automa
21d0: 74 69 63 61 6c 6c 79 20 70 75 74 73 20 69 74 73  tically puts its
21e0: 65 6c 66 20 69 6e 20 61 0a 20 20 20 20 63 68 72  elf in a.    chr
21f0: 6f 6f 74 20 6a 61 69 6c 20 69 6e 20 74 68 65 20  oot jail in the 
2200: 73 61 6d 65 20 64 69 72 65 63 74 6f 72 79 20 61  same directory a
2210: 73 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79  s the repository
2220: 2c 20 74 68 65 6e 20 64 72 6f 70 73 0a 20 20 20  , then drops.   
2230: 20 72 6f 6f 74 20 70 72 69 76 69 6c 65 67 65 73   root privileges
2240: 20 70 72 69 6f 72 20 74 6f 20 72 65 61 64 69 6e   prior to readin
2250: 67 20 61 6e 79 20 69 6e 66 6f 72 6d 61 74 69 6f  g any informatio
2260: 6e 20 66 72 6f 6d 20 74 68 65 20 72 65 71 75 65  n from the reque
2270: 73 74 2e 3c 2f 70 3e 0a 0a 3c 2f 62 6c 6f 63 6b  st.</p>..</block
2280: 71 75 6f 74 65 3e 3c 61 20 6e 61 6d 65 3d 22 70  quote><a name="p
2290: 72 6f 78 79 22 3e 3c 2f 61 3e 3c 68 32 3e 48 54  roxy"></a><h2>HT
22a0: 54 50 20 50 72 6f 78 69 65 73 3c 2f 68 32 3e 3c  TP Proxies</h2><
22b0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20  blockquote>..   
22c0: 20 3c 70 3e 49 66 20 79 6f 75 20 61 72 65 20 62   <p>If you are b
22d0: 65 68 69 6e 64 20 61 20 72 65 73 74 72 69 63 74  ehind a restrict
22e0: 69 76 65 20 66 69 72 65 77 61 6c 6c 20 74 68 61  ive firewall tha
22f0: 74 20 72 65 71 75 69 72 65 73 20 79 6f 75 20 74  t requires you t
2300: 6f 20 75 73 65 0a 20 20 20 20 61 6e 20 48 54 54  o use.    an HTT
2310: 50 20 70 72 6f 78 79 20 74 6f 20 72 65 61 63 68  P proxy to reach
2320: 20 74 68 65 20 69 6e 74 65 72 6e 65 74 2c 20 74   the internet, t
2330: 68 65 6e 20 79 6f 75 20 63 61 6e 20 63 6f 6e 66  hen you can conf
2340: 69 67 75 72 65 20 74 68 65 20 70 72 6f 78 79 0a  igure the proxy.
2350: 20 20 20 20 69 6e 20 74 68 72 65 65 20 64 69 66      in three dif
2360: 66 65 72 65 6e 74 20 77 61 79 73 2e 20 20 59 6f  ferent ways.  Yo
2370: 75 20 63 61 6e 20 74 65 6c 6c 20 66 6f 73 73 69  u can tell fossi
2380: 6c 20 61 62 6f 75 74 20 79 6f 75 72 20 70 72 6f  l about your pro
2390: 78 79 20 75 73 69 6e 67 0a 20 20 20 20 61 20 63  xy using.    a c
23a0: 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 6f 70 74 69  ommand-line opti
23b0: 6f 6e 20 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 74  on on commands t
23c0: 68 61 74 20 75 73 65 20 74 68 65 20 6e 65 74 77  hat use the netw
23d0: 6f 72 6b 2c 0a 20 20 20 20 3c 62 3e 73 79 6e 63  ork,.    <b>sync
23e0: 3c 2f 62 3e 2c 20 3c 62 3e 63 6c 6f 6e 65 3c 2f  </b>, <b>clone</
23f0: 62 3e 2c 20 3c 62 3e 70 75 73 68 3c 2f 62 3e 2c  b>, <b>push</b>,
2400: 20 61 6e 64 20 3c 62 3e 70 75 6c 6c 3c 2f 62 3e   and <b>pull</b>
2410: 2e 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63  .</p>..    <bloc
2420: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66  kquote>.    <b>f
2430: 6f 73 73 69 6c 20 63 6c 6f 6e 65 20 3c 2f 62 3e  ossil clone </b>
2440: 3c 69 3e 55 52 4c 3c 2f 69 3e 20 20 3c 62 3e 2d  <i>URL</i>  <b>-
2450: 2d 70 72 6f 78 79 3c 2f 62 3e 20 3c 69 3e 50 72  -proxy</b> <i>Pr
2460: 6f 78 79 2d 55 52 4c 3c 2f 69 3e 0a 20 20 20 20  oxy-URL</i>.    
2470: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20  </blockquote>.. 
2480: 20 20 20 3c 70 3e 49 74 20 69 73 20 61 6e 6e 6f     <p>It is anno
2490: 79 69 6e 67 20 74 6f 20 68 61 76 65 20 74 6f 20  ying to have to 
24a0: 74 79 70 65 20 69 6e 20 74 68 65 20 70 72 6f 78  type in the prox
24b0: 79 20 55 52 4c 20 65 76 65 72 79 20 74 69 6d 65  y URL every time
24c0: 20 79 6f 75 0a 20 20 20 20 73 79 6e 63 20 79 6f   you.    sync yo
24d0: 75 72 20 70 72 6f 6a 65 63 74 2c 20 74 68 6f 75  ur project, thou
24e0: 67 68 2c 20 73 6f 20 79 6f 75 20 63 61 6e 20 6d  gh, so you can m
24f0: 61 6b 65 20 74 68 65 20 70 72 6f 78 79 20 63 6f  ake the proxy co
2500: 6e 66 69 67 75 72 61 74 69 6f 6e 0a 20 20 20 20  nfiguration.    
2510: 70 65 72 73 69 73 74 65 6e 74 20 75 73 69 6e 67  persistent using
2520: 20 74 68 65 20 3c 62 3e 73 65 74 74 69 6e 67 3c   the <b>setting<
2530: 2f 62 3e 20 63 6f 6d 6d 61 6e 64 3a 3c 2f 70 3e  /b> command:</p>
2540: 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74  ..    <blockquot
2550: 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c  e>.    <b>fossil
2560: 20 73 65 74 74 69 6e 67 20 70 72 6f 78 79 20 3c   setting proxy <
2570: 2f 62 3e 3c 69 3e 50 72 6f 78 79 2d 55 52 4c 3c  /b><i>Proxy-URL<
2580: 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71  /i>.    </blockq
2590: 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 4f 72  uote>..    <p>Or
25a0: 2c 20 79 6f 75 20 63 61 6e 20 73 65 74 20 74 68  , you can set th
25b0: 65 20 22 3c 62 3e 68 74 74 70 5f 70 72 6f 78 79  e "<b>http_proxy
25c0: 3c 2f 62 3e 22 20 65 6e 76 69 72 6f 6e 6d 65 6e  </b>" environmen
25d0: 74 20 76 61 72 69 61 62 6c 65 3a 3c 2f 70 3e 0a  t variable:</p>.
25e0: 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65  .    <blockquote
25f0: 3e 0a 20 20 20 20 3c 62 3e 65 78 70 6f 72 74 20  >.    <b>export 
2600: 68 74 74 70 5f 70 72 6f 78 79 3d 3c 2f 62 3e 3c  http_proxy=</b><
2610: 69 3e 50 72 6f 78 79 2d 55 52 4c 3c 2f 69 3e 0a  i>Proxy-URL</i>.
2620: 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65      </blockquote
2630: 3e 0a 0a 20 20 20 20 3c 70 3e 54 6f 20 73 74 6f  >..    <p>To sto
2640: 70 20 75 73 69 6e 67 20 74 68 65 20 70 72 6f 78  p using the prox
2650: 79 2c 20 64 6f 3a 3c 2f 70 3e 0a 0a 20 20 20 20  y, do:</p>..    
2660: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20  <blockquote>.   
2670: 20 3c 62 3e 66 6f 73 73 69 6c 20 73 65 74 74 69   <b>fossil setti
2680: 6e 67 20 70 72 6f 78 79 20 6f 66 66 3c 2f 62 3e  ng proxy off</b>
2690: 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74  .    </blockquot
26a0: 65 3e 0a 0a 20 20 20 20 3c 70 3e 4f 72 20 75 6e  e>..    <p>Or un
26b0: 73 65 74 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d  set the environm
26c0: 65 6e 74 20 76 61 72 69 61 62 6c 65 2e 20 20 54  ent variable.  T
26d0: 68 65 20 66 6f 73 73 69 6c 20 73 65 74 74 69 6e  he fossil settin
26e0: 67 20 66 6f 72 20 74 68 65 0a 20 20 20 20 48 54  g for the.    HT
26f0: 54 50 20 70 72 6f 78 79 20 74 61 6b 65 73 20 70  TP proxy takes p
2700: 72 65 63 65 64 65 6e 63 65 20 6f 76 65 72 20 74  recedence over t
2710: 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76  he environment v
2720: 61 72 69 61 62 6c 65 20 61 6e 64 20 74 68 65 0a  ariable and the.
2730: 20 20 20 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65      command-line
2740: 20 6f 70 74 69 6f 6e 20 6f 76 65 72 72 69 64 65   option override
2750: 73 20 62 6f 74 68 2e 20 20 49 66 20 79 6f 75 20  s both.  If you 
2760: 68 61 76 65 20 61 6e 20 70 65 72 73 69 73 74 65  have an persiste
2770: 6e 74 0a 20 20 20 20 70 72 6f 78 79 20 73 65 74  nt.    proxy set
2780: 74 69 6e 67 20 74 68 61 74 20 79 6f 75 20 77 61  ting that you wa
2790: 6e 74 20 74 6f 20 6f 76 65 72 72 69 64 65 20 66  nt to override f
27a0: 6f 72 20 61 20 6f 6e 65 2d 74 69 6d 65 20 73 79  or a one-time sy
27b0: 6e 63 2c 20 74 68 61 74 0a 20 20 20 20 69 73 20  nc, that.    is 
27c0: 65 61 73 69 6c 79 20 64 6f 6e 65 20 6f 6e 20 74  easily done on t
27d0: 68 65 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 2e  he command-line.
27e0: 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74    For example, t
27f0: 6f 20 73 79 6e 63 20 77 69 74 68 0a 20 20 20 20  o sync with.    
2800: 61 20 63 6f 2d 77 6f 72 6b 65 72 73 20 72 65 70  a co-workers rep
2810: 6f 73 69 74 6f 72 79 20 6f 6e 20 79 6f 75 72 20  ository on your 
2820: 4c 41 4e 2c 20 79 6f 75 20 6d 69 67 68 74 20 74  LAN, you might t
2830: 79 70 65 3a 3c 2f 70 3e 20 20 20 0a 0a 20 20 20  ype:</p>   ..   
2840: 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20   <blockquote>.  
2850: 20 20 3c 62 3e 66 6f 73 73 69 6c 20 73 79 6e 63    <b>fossil sync
2860: 20 68 74 74 70 3a 2f 2f 31 39 32 2e 31 36 38 2e   http://192.168.
2870: 31 2e 33 36 3a 38 30 38 30 2f 20 2d 2d 70 72 6f  1.36:8080/ --pro
2880: 78 79 20 6f 66 66 3c 2f 62 3e 0a 20 20 20 20 3c  xy off</b>.    <
2890: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 2f  /blockquote>..</
28a0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 4d  blockquote><h2>M
28b0: 6f 72 65 20 48 69 6e 74 73 3c 2f 68 32 3e 3c 62  ore Hints</h2><b
28c0: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20  lockquote>..    
28d0: 3c 70 3e 54 72 79 20 74 68 65 73 65 20 63 6f 6d  <p>Try these com
28e0: 6d 61 6e 64 73 3a 3c 2f 70 3e 0a 0a 20 20 20 20  mands:</p>..    
28f0: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 62 3e 0a  <blockquote><b>.
2900: 20 20 20 20 66 6f 73 73 69 6c 20 68 65 6c 70 3c      fossil help<
2910: 62 72 3e 0a 20 20 20 20 66 6f 73 73 69 6c 20 74  br>.    fossil t
2920: 65 73 74 2d 63 6f 6d 6d 61 6e 64 73 0a 20 20 20  est-commands.   
2930: 20 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74   </b></blockquot
2940: 65 3e 0a 0a 20 20 20 20 3c 70 3e 45 78 70 6c 6f  e>..    <p>Explo
2950: 72 65 20 61 6e 64 20 68 61 76 65 20 66 75 6e 21  re and have fun!
2960: 3c 2f 70 3e 0a 0a 0a 3c 2f 62 6c 6f 63 6b 71 75  </p>...</blockqu
2970: 6f 74 65 3e 0a                                   ote>.