Hex Artifact Content
Not logged in

Artifact d68d09590fd77bc1687a0978cf93cd39b0b74f32:

File www/quickstart.wiki part of check-in [70dcb9fc8b] - Clarifications of the "quickstart.wiki" documentation. by drh on 2008-05-19 15:08:39.

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 2e 20 20 59 6f 75 20 63 61  o clone.  You ca
0470: 6e 20 63 61 6c 6c 20 74 68 65 20 6e 65 77 20 72  n call the new r
0480: 65 70 6f 73 69 74 6f 72 79 20 61 6e 79 74 68 69  epository anythi
0490: 6e 67 20 79 6f 75 0a 20 20 20 20 77 61 6e 74 20  ng you.    want 
04a0: 2d 20 74 68 65 72 65 20 61 72 65 20 6e 6f 20 6e  - there are no n
04b0: 61 6d 69 6e 67 20 72 65 73 74 72 69 63 74 69 6f  aming restrictio
04c0: 6e 73 2e 20 20 41 73 20 61 6e 20 65 78 61 6d 70  ns.  As an examp
04d0: 6c 65 2c 20 79 6f 75 20 63 61 6e 0a 20 20 20 20  le, you can.    
04e0: 63 6c 6f 6e 65 20 74 68 65 20 66 6f 73 73 69 6c  clone the fossil
04f0: 20 72 65 70 6f 73 69 74 6f 72 79 20 74 68 69 73   repository this
0500: 20 77 61 79 3a 3c 2f 70 3e 0a 20 20 20 20 0a 20   way:</p>.    . 
0510: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a     <blockquote>.
0520: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 63 6c      <b>fossil cl
0530: 6f 6e 65 20 68 74 74 70 3a 2f 2f 77 77 77 2e 66  one http://www.f
0540: 6f 73 73 69 6c 2d 73 63 6d 2e 6f 72 67 2f 66 6f  ossil-scm.org/fo
0550: 73 73 69 6c 20 6d 79 63 6c 6f 6e 65 2e 66 6f 73  ssil myclone.fos
0560: 73 69 6c 3c 2f 62 3e 0a 20 20 20 20 3c 2f 62 6c  sil</b>.    </bl
0570: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c  ockquote>..    <
0580: 70 3e 54 68 65 20 6e 65 77 20 6c 6f 63 61 6c 20  p>The new local 
0590: 63 6f 70 79 20 6f 66 20 74 68 65 20 72 65 73 70  copy of the resp
05a0: 6f 73 69 74 6f 72 79 20 69 73 20 73 74 6f 72 65  ository is store
05b0: 64 20 69 6e 20 61 20 73 69 6e 67 6c 65 20 66 69  d in a single fi
05c0: 6c 65 2c 0a 20 20 20 20 77 68 69 63 68 20 69 6e  le,.    which in
05d0: 20 74 68 65 20 65 78 61 6d 70 6c 65 20 61 62 6f   the example abo
05e0: 76 65 20 69 73 20 6e 61 6d 65 64 20 22 6d 79 63  ve is named "myc
05f0: 6c 6f 6e 65 2e 66 6f 73 73 69 6c 22 2e 0a 20 20  lone.fossil"..  
0600: 20 20 59 6f 75 20 63 61 6e 20 6e 61 6d 65 20 79    You can name y
0610: 6f 75 72 20 72 65 70 6f 73 69 74 6f 72 69 65 73  our repositories
0620: 20 61 6e 79 74 68 69 6e 67 20 79 6f 75 20 77 61   anything you wa
0630: 6e 74 2e 20 20 54 68 65 20 22 2e 66 6f 73 73 69  nt.  The ".fossi
0640: 6c 22 20 73 75 66 66 69 78 0a 20 20 20 20 69 73  l" suffix.    is
0650: 20 6e 6f 74 20 72 65 71 75 69 72 65 64 2e 3c 2f   not required.</
0660: 70 3e 0a 0a 20 20 20 20 3c 70 3e 4e 6f 74 65 3a  p>..    <p>Note:
0670: 20 49 66 20 79 6f 75 20 61 72 65 20 62 65 68 69   If you are behi
0680: 6e 64 20 61 20 72 65 73 74 72 69 63 74 69 76 65  nd a restrictive
0690: 20 66 69 72 65 77 61 6c 6c 2c 20 79 6f 75 20 6d   firewall, you m
06a0: 69 67 68 74 20 6e 65 65 64 0a 20 20 20 20 74 6f  ight need.    to
06b0: 20 3c 61 20 68 72 65 66 3d 22 23 70 72 6f 78 79   <a href="#proxy
06c0: 22 3e 73 70 65 63 69 66 79 20 61 6e 20 48 54 54  ">specify an HTT
06d0: 50 20 70 72 6f 78 79 3c 2f 61 3e 20 74 6f 20 75  P proxy</a> to u
06e0: 73 65 2e 3c 2f 70 3e 0a 20 20 20 20 0a 3c 2f 62  se.</p>.    .</b
06f0: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 53 74  lockquote><h2>St
0700: 61 72 74 69 6e 67 20 41 20 4e 65 77 20 50 72 6f  arting A New Pro
0710: 6a 65 63 74 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71  ject</h2><blockq
0720: 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 6f  uote>..    <p>To
0730: 20 73 74 61 72 74 20 61 20 6e 65 77 20 70 72 6f   start a new pro
0740: 6a 65 63 74 20 77 69 74 68 20 66 6f 73 73 69 6c  ject with fossil
0750: 2c 20 63 72 65 61 74 65 20 61 20 6e 65 77 20 65  , create a new e
0760: 6d 70 74 79 20 72 65 70 6f 73 69 74 6f 72 79 0a  mpty repository.
0770: 20 20 20 20 74 68 69 73 20 77 61 79 3a 3c 2f 70      this way:</p
0780: 3e 0a 20 20 20 20 0a 20 20 20 20 3c 62 6c 6f 63  >.    .    <bloc
0790: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66  kquote>.    <b>f
07a0: 6f 73 73 69 6c 20 6e 65 77 20 3c 2f 62 3e 3c 69  ossil new </b><i
07b0: 3e 20 72 65 70 6f 73 69 74 6f 72 79 2d 66 69 6c  > repository-fil
07c0: 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f  ename</i>.    </
07d0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20  blockquote>.    
07e0: 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68  .</blockquote><h
07f0: 32 3e 43 6f 6e 66 69 67 75 72 69 6e 67 20 59 6f  2>Configuring Yo
0800: 75 72 20 4c 6f 63 61 6c 20 52 65 70 6f 73 69 74  ur Local Reposit
0810: 6f 72 79 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75  ory</h2><blockqu
0820: 6f 74 65 3e 0a 20 20 20 20 0a 20 20 20 20 3c 70  ote>.    .    <p
0830: 3e 57 68 65 6e 20 79 6f 75 20 63 72 65 61 74 65  >When you create
0840: 20 61 20 6e 65 77 20 72 65 70 6f 73 69 74 6f 72   a new repositor
0850: 79 2c 20 65 69 74 68 65 72 20 62 79 20 63 6c 6f  y, either by clo
0860: 6e 69 6e 67 20 61 6e 20 65 78 69 73 74 69 6e 67  ning an existing
0870: 0a 20 20 20 20 70 72 6f 6a 65 63 74 20 6f 72 20  .    project or 
0880: 63 72 65 61 74 65 20 61 20 6e 65 77 20 70 72 6f  create a new pro
0890: 6a 65 63 74 20 6f 66 20 79 6f 75 72 20 6f 77 6e  ject of your own
08a0: 2c 20 79 6f 75 20 75 73 75 61 6c 6c 79 20 77 61  , you usually wa
08b0: 6e 74 20 74 6f 20 64 6f 20 73 6f 6d 65 0a 20 20  nt to do some.  
08c0: 20 20 6c 6f 63 61 6c 20 63 6f 6e 66 69 67 75 72    local configur
08d0: 61 74 69 6f 6e 2e 20 20 54 68 69 73 20 69 73 20  ation.  This is 
08e0: 61 63 63 6f 6d 70 6c 69 73 68 65 64 20 75 73 69  accomplished usi
08f0: 6e 67 20 61 20 77 65 62 62 72 6f 77 73 65 72 2e  ng a webbrowser.
0900: 20 20 46 69 72 73 74 0a 20 20 20 20 73 74 61 72    First.    star
0910: 74 20 61 20 66 6f 73 73 69 6c 20 77 65 62 73 65  t a fossil webse
0920: 72 76 65 72 20 6c 69 6b 65 20 74 68 69 73 3a 3c  rver like this:<
0930: 2f 70 3e 0a 20 20 20 20 0a 20 20 20 20 3c 62 6c  /p>.    .    <bl
0940: 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62  ockquote>.    <b
0950: 3e 66 6f 73 73 69 6c 20 75 69 20 3c 2f 62 3e 3c  >fossil ui </b><
0960: 69 3e 20 72 65 70 6f 73 69 74 6f 72 79 2d 66 69  i> repository-fi
0970: 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c  lename</i>.    <
0980: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20  /blockquote>..  
0990: 20 20 3c 70 3e 54 68 69 73 20 63 72 65 61 74 65    <p>This create
09a0: 73 20 61 20 6d 69 6e 69 2d 77 65 62 73 65 72 76  s a mini-webserv
09b0: 65 72 20 6c 69 73 74 65 6e 69 6e 67 20 6f 6e 20  er listening on 
09c0: 70 6f 72 74 20 38 30 38 30 2e 20 20 59 6f 75 20  port 8080.  You 
09d0: 63 61 6e 0a 20 20 20 20 73 70 65 63 69 66 79 20  can.    specify 
09e0: 61 20 64 69 66 66 65 72 65 6e 74 20 70 6f 72 74  a different port
09f0: 20 75 73 69 6e 67 20 74 68 65 20 3c 62 3e 2d 70   using the <b>-p
0a00: 6f 72 74 3c 2f 62 3e 20 6f 70 74 69 6f 6e 20 6f  ort</b> option o
0a10: 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2d 6c 69  n the command-li
0a20: 6e 65 2e 0a 20 20 20 20 41 66 74 65 72 20 74 68  ne..    After th
0a30: 65 20 73 65 72 76 65 72 20 69 73 20 72 75 6e 6e  e server is runn
0a40: 69 6e 67 2c 20 66 6f 73 73 69 6c 20 77 69 6c 6c  ing, fossil will
0a50: 20 74 68 65 6e 20 61 74 74 65 6d 70 74 20 74 6f   then attempt to
0a60: 20 6c 61 75 6e 63 68 20 79 6f 75 72 0a 20 20 20   launch your.   
0a70: 20 77 65 62 20 62 72 6f 77 73 65 72 20 61 6e 64   web browser and
0a80: 20 6d 61 6b 65 20 69 74 20 70 6f 69 6e 74 20 74   make it point t
0a90: 6f 20 74 68 69 73 20 77 65 62 20 73 65 72 76 65  o this web serve
0aa0: 72 2e 20 20 49 66 20 79 6f 75 72 20 73 79 73 74  r.  If your syst
0ab0: 65 6d 0a 20 20 20 20 68 61 73 20 61 6e 20 75 6e  em.    has an un
0ac0: 75 73 75 61 6c 20 63 6f 6e 66 69 67 75 72 61 74  usual configurat
0ad0: 69 6f 6e 2c 20 66 6f 73 73 69 6c 20 6d 69 67 68  ion, fossil migh
0ae0: 74 20 6e 6f 74 20 62 65 20 61 62 6c 65 20 74 6f  t not be able to
0af0: 20 66 69 67 75 72 65 20 6f 75 74 0a 20 20 20 20   figure out.    
0b00: 68 6f 77 20 74 6f 20 73 74 61 72 74 20 79 6f 75  how to start you
0b10: 72 20 77 65 62 20 62 72 6f 77 73 65 72 2e 20 20  r web browser.  
0b20: 49 6e 20 74 68 61 74 20 63 61 73 65 2c 20 73 74  In that case, st
0b30: 61 72 74 20 74 68 65 20 77 65 62 20 62 72 6f 77  art the web brow
0b40: 73 65 72 0a 20 20 20 20 79 6f 75 72 73 65 6c 66  ser.    yourself
0b50: 20 61 6e 64 20 70 6f 69 6e 74 20 69 74 20 61 74   and point it at
0b60: 20 68 74 74 70 3a 2f 2f 6c 6f 63 61 6c 68 6f 73   http://localhos
0b70: 74 3a 38 30 38 30 2f 2e 20 20 43 6c 69 63 6b 20  t:8080/.  Click 
0b80: 6f 6e 20 74 68 65 0a 20 20 20 20 22 53 65 74 75  on the.    "Setu
0b90: 70 22 20 6c 69 6e 6b 20 6f 6e 20 74 68 65 20 6d  p" link on the m
0ba0: 65 6e 75 20 62 61 72 20 74 6f 20 73 74 61 72 74  enu bar to start
0bb0: 20 63 6f 6e 66 69 67 75 72 69 6e 67 20 79 6f 75   configuring you
0bc0: 72 20 72 65 70 6f 73 69 74 6f 72 79 2e 3c 2f 70  r repository.</p
0bd0: 3e 0a 20 20 20 20 0a 20 20 20 20 3c 70 3e 42 79  >.    .    <p>By
0be0: 20 64 65 66 61 75 6c 74 2c 20 66 6f 73 73 69 6c   default, fossil
0bf0: 20 64 6f 65 73 20 6e 6f 74 20 72 65 71 75 69 72   does not requir
0c00: 65 20 61 20 6c 6f 67 69 6e 20 66 6f 72 20 48 54  e a login for HT
0c10: 54 50 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 0a 20  TP connections. 
0c20: 20 20 20 63 6f 6d 69 6e 67 20 69 6e 20 66 72 6f     coming in fro
0c30: 6d 20 74 68 65 20 49 50 20 6c 6f 6f 70 62 61 63  m the IP loopbac
0c40: 6b 20 61 64 64 72 65 73 73 20 31 32 37 2e 30 2e  k address 127.0.
0c50: 30 2e 31 2e 20 20 59 6f 75 20 63 61 6e 2c 20 61  0.1.  You can, a
0c60: 6e 64 20 70 65 72 68 61 70 73 0a 20 20 20 20 73  nd perhaps.    s
0c70: 68 6f 75 6c 64 2c 20 63 68 61 6e 67 65 20 74 68  hould, change th
0c80: 69 73 20 61 66 74 65 72 20 79 6f 75 20 63 72 65  is after you cre
0c90: 61 74 65 20 61 20 66 65 77 20 75 73 65 72 73 2e  ate a few users.
0ca0: 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 20 20 3c 70  </p>.    .    <p
0cb0: 3e 57 68 65 6e 20 79 6f 75 20 61 72 65 20 66 69  >When you are fi
0cc0: 6e 69 73 68 65 64 20 63 6f 6e 66 69 67 75 72 69  nished configuri
0cd0: 6e 67 2c 20 6a 75 73 74 20 70 72 65 73 73 20 43  ng, just press C
0ce0: 6f 6e 74 72 6f 6c 2d 43 20 6f 72 20 75 73 65 0a  ontrol-C or use.
0cf0: 20 20 20 20 74 68 65 20 3c 62 3e 6b 69 6c 6c 3c      the <b>kill<
0d00: 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 73  /b> command to s
0d10: 68 75 74 20 64 6f 77 6e 20 74 68 65 20 6d 69 6e  hut down the min
0d20: 69 2d 73 65 72 76 65 72 2e 3c 2f 70 3e 0a 0a 3c  i-server.</p>..<
0d30: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e  /blockquote><h2>
0d40: 43 68 65 63 6b 69 6e 67 20 4f 75 74 20 41 20 4c  Checking Out A L
0d50: 6f 63 61 6c 20 54 72 65 65 3c 2f 68 32 3e 3c 62  ocal Tree</h2><b
0d60: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20  lockquote>..    
0d70: 3c 70 3e 54 6f 20 77 6f 72 6b 20 6f 6e 20 61 20  <p>To work on a 
0d80: 70 72 6f 6a 65 63 74 20 69 6e 20 66 6f 73 73 69  project in fossi
0d90: 6c 2c 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 63  l, you need to c
0da0: 68 65 63 6b 20 6f 75 74 20 61 20 6c 6f 63 61 6c  heck out a local
0db0: 0a 20 20 20 20 63 6f 70 79 20 6f 66 20 74 68 65  .    copy of the
0dc0: 20 73 6f 75 72 63 65 20 74 72 65 65 2e 20 20 43   source tree.  C
0dd0: 72 65 61 74 65 20 74 68 65 20 64 69 72 65 63 74  reate the direct
0de0: 6f 72 79 20 79 6f 75 20 77 61 6e 74 20 74 6f 20  ory you want to 
0df0: 62 65 0a 20 20 20 20 74 68 65 20 72 6f 6f 74 20  be.    the root 
0e00: 6f 66 20 79 6f 75 72 20 74 72 65 65 20 61 6e 64  of your tree and
0e10: 20 63 64 20 69 6e 74 6f 20 74 68 61 74 20 64 69   cd into that di
0e20: 72 65 63 74 6f 72 79 2e 20 20 54 68 65 6e 0a 20  rectory.  Then. 
0e30: 20 20 20 74 6f 20 74 68 69 73 3a 3c 2f 70 3e 0a     to this:</p>.
0e40: 20 20 20 20 0a 20 20 20 20 3c 62 6c 6f 63 6b 71      .    <blockq
0e50: 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73  uote>.    <b>fos
0e60: 73 69 6c 20 6f 70 65 6e 20 3c 2f 62 3e 3c 69 3e  sil open </b><i>
0e70: 20 72 65 70 6f 73 69 74 6f 72 79 2d 66 69 6c 65   repository-file
0e80: 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62  name</i>.    </b
0e90: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 0a  lockquote>.    .
0ea0: 20 20 20 20 3c 70 3e 54 68 69 73 20 6c 65 61 76      <p>This leav
0eb0: 65 73 20 79 6f 75 20 77 69 74 68 20 74 68 65 20  es you with the 
0ec0: 6e 65 77 65 73 74 20 76 65 72 73 69 6f 6e 20 6f  newest version o
0ed0: 66 20 74 68 65 20 74 72 65 65 0a 20 20 20 20 63  f the tree.    c
0ee0: 68 65 63 6b 65 64 20 6f 75 74 2e 20 20 20 20 0a  hecked out.    .
0ef0: 20 20 20 20 46 72 6f 6d 20 61 6e 79 77 68 65 72      From anywher
0f00: 65 20 75 6e 64 65 72 6e 65 61 74 68 20 74 68 65  e underneath the
0f10: 20 72 6f 6f 74 20 6f 66 20 79 6f 75 72 20 6c 6f   root of your lo
0f20: 63 61 6c 20 74 72 65 65 2c 20 79 6f 75 0a 20 20  cal tree, you.  
0f30: 20 20 63 61 6e 20 74 79 70 65 20 63 6f 6d 6d 61    can type comma
0f40: 6e 64 73 20 6c 69 6b 65 20 74 68 65 20 66 6f 6c  nds like the fol
0f50: 6c 6f 77 69 6e 67 20 74 6f 20 66 69 6e 64 20 6f  lowing to find o
0f60: 75 74 20 74 68 65 20 73 74 61 74 75 73 20 6f 66  ut the status of
0f70: 0a 20 20 20 20 79 6f 75 72 20 6c 6f 63 61 6c 20  .    your local 
0f80: 74 72 65 65 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c  tree:</p>..    <
0f90: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20  blockquote>.    
0fa0: 3c 62 3e 66 6f 73 73 69 6c 20 69 6e 66 6f 3c 2f  <b>fossil info</
0fb0: 62 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f  b><br>.    <b>fo
0fc0: 73 73 69 6c 20 73 74 61 74 75 73 3c 2f 62 3e 3c  ssil status</b><
0fd0: 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69  br>.    <b>fossi
0fe0: 6c 20 63 68 61 6e 67 65 73 3c 2f 62 3e 3c 62 72  l changes</b><br
0ff0: 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20  >.    <b>fossil 
1000: 74 69 6d 65 6c 69 6e 65 3c 2f 62 3e 3c 62 72 3e  timeline</b><br>
1010: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6c  .    <b>fossil l
1020: 65 61 76 65 73 3c 2f 62 3e 3c 62 72 3e 0a 20 20  eaves</b><br>.  
1030: 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6c 73 3c 2f    <b>fossil ls</
1040: 62 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f  b><br>.    <b>fo
1050: 73 73 69 6c 20 62 72 61 6e 63 68 65 73 3c 2f 62  ssil branches</b
1060: 3e 3c 62 72 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63  ><br>.    </bloc
1070: 6b 71 75 6f 74 65 3e 0a 0a 3c 2f 62 6c 6f 63 6b  kquote>..</block
1080: 71 75 6f 74 65 3e 3c 68 32 3e 4d 61 6b 69 6e 67  quote><h2>Making
1090: 20 43 68 61 6e 67 65 73 3c 2f 68 32 3e 3c 62 6c   Changes</h2><bl
10a0: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c  ockquote>..    <
10b0: 70 3e 54 6f 20 61 64 64 20 6e 65 77 20 66 69 6c  p>To add new fil
10c0: 65 73 20 74 6f 20 79 6f 75 72 20 70 72 6f 6a 65  es to your proje
10d0: 63 74 2c 20 6f 72 20 72 65 6d 6f 76 65 20 6f 6c  ct, or remove ol
10e0: 64 20 66 69 6c 65 73 2c 20 75 73 65 20 74 68 65  d files, use the
10f0: 73 65 0a 20 20 20 20 63 6f 6d 6d 61 6e 64 73 3a  se.    commands:
1100: 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b  </p>..    <block
1110: 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f  quote>.    <b>fo
1120: 73 73 69 6c 20 61 64 64 3c 2f 62 3e 20 3c 69 3e  ssil add</b> <i>
1130: 66 69 6c 65 2e 2e 2e 3c 2f 69 3e 3c 62 72 3e 0a  file...</i><br>.
1140: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 72 6d      <b>fossil rm
1150: 3c 2f 62 3e 20 3c 69 3e 66 69 6c 65 2e 2e 2e 3c  </b> <i>file...<
1160: 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71  /i>.    </blockq
1170: 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 59 6f  uote>..    <p>Yo
1180: 75 20 63 61 6e 20 61 6c 73 6f 20 65 64 69 74 20  u can also edit 
1190: 66 69 6c 65 73 20 66 72 65 65 6c 79 2e 20 20 4f  files freely.  O
11a0: 6e 63 65 20 79 6f 75 20 61 72 65 20 72 65 61 64  nce you are read
11b0: 79 20 74 6f 20 63 6f 6d 6d 69 74 0a 20 20 20 20  y to commit.    
11c0: 79 6f 75 72 20 63 68 61 6e 67 65 73 2c 20 74 79  your changes, ty
11d0: 70 65 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c  pe:</p>..    <bl
11e0: 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62  ockquote>.    <b
11f0: 3e 66 6f 73 73 69 6c 20 63 6f 6d 6d 69 74 3c 2f  >fossil commit</
1200: 62 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75  b>.    </blockqu
1210: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 59 6f 75  ote>..    <p>You
1220: 20 77 69 6c 6c 20 62 65 20 70 72 6f 6d 70 74 65   will be prompte
1230: 64 20 66 6f 72 20 63 68 65 63 6b 2d 69 6e 20 63  d for check-in c
1240: 6f 6d 6d 65 6e 74 73 20 75 73 69 6e 67 20 77 68  omments using wh
1250: 61 74 65 76 65 72 20 65 64 69 74 6f 72 0a 20 20  atever editor.  
1260: 20 20 69 73 20 73 70 65 63 69 66 69 65 64 20 62    is specified b
1270: 79 20 79 6f 75 72 20 56 49 53 55 41 4c 20 6f 72  y your VISUAL or
1280: 20 45 44 49 54 4f 52 20 65 6e 76 69 72 6f 6e 6d   EDITOR environm
1290: 65 6e 74 20 76 61 72 69 61 62 6c 65 2e 20 20 49  ent variable.  I
12a0: 66 20 79 6f 75 0a 20 20 20 20 68 61 76 65 20 47  f you.    have G
12b0: 50 47 20 69 6e 73 74 61 6c 6c 65 64 2c 20 79 6f  PG installed, yo
12c0: 75 20 6d 61 79 20 62 65 20 70 72 6f 6d 70 74 65  u may be prompte
12d0: 64 20 66 6f 72 20 79 6f 75 72 20 47 50 47 20 70  d for your GPG p
12e0: 61 73 73 70 68 72 61 73 65 20 73 6f 0a 20 20 20  assphrase so.   
12f0: 20 74 68 61 74 20 74 68 65 20 63 68 65 63 6b 2d   that the check-
1300: 69 6e 20 63 61 6e 20 62 65 20 73 69 67 6e 65 64  in can be signed
1310: 20 77 69 74 68 20 79 6f 75 72 20 47 50 47 20 73   with your GPG s
1320: 69 67 6e 61 74 75 72 65 2e 20 20 41 66 74 65 72  ignature.  After
1330: 0a 20 20 20 20 74 68 69 73 20 79 6f 75 72 20 63  .    this your c
1340: 68 61 6e 67 65 73 20 77 69 6c 6c 20 62 65 20 63  hanges will be c
1350: 68 65 63 6b 65 64 20 69 6e 2e 3c 2f 70 3e 0a 0a  hecked in.</p>..
1360: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32  </blockquote><h2
1370: 3e 53 68 61 72 69 6e 67 20 43 68 61 6e 67 65 73  >Sharing Changes
1380: 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65  </h2><blockquote
1390: 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 63 68  >..    <p>The ch
13a0: 61 6e 67 65 73 20 79 6f 75 20 3c 62 3e 63 6f 6d  anges you <b>com
13b0: 6d 69 74 3c 2f 62 3e 20 61 72 65 20 6f 6e 6c 79  mit</b> are only
13c0: 20 6f 6e 20 79 6f 75 72 20 6c 6f 63 61 6c 20 72   on your local r
13d0: 65 70 6f 73 69 74 6f 72 79 2e 0a 20 20 20 20 54  epository..    T
13e0: 6f 20 73 68 61 72 65 20 74 68 6f 73 65 20 63 68  o share those ch
13f0: 61 6e 67 65 73 20 77 69 74 68 20 6f 74 68 65 72  anges with other
1400: 20 72 65 70 6f 73 69 74 6f 72 69 65 73 2c 20 64   repositories, d
1410: 6f 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f  o:</p>..    <blo
1420: 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e  ckquote>.    <b>
1430: 66 6f 73 73 69 6c 20 70 75 73 68 3c 2f 62 3e 20  fossil push</b> 
1440: 3c 69 3e 55 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c  <i>URL</i>.    <
1450: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20  /blockquote>..  
1460: 20 20 3c 70 3e 57 68 65 72 65 20 3c 69 3e 55 52    <p>Where <i>UR
1470: 4c 3c 2f 69 3e 20 69 73 20 74 68 65 20 68 74 74  L</i> is the htt
1480: 70 3a 20 55 52 4c 20 6f 66 20 74 68 65 20 73 65  p: URL of the se
1490: 72 76 65 72 20 72 65 70 6f 73 69 74 6f 72 79 20  rver repository 
14a0: 79 6f 75 0a 20 20 20 20 77 61 6e 74 20 74 6f 20  you.    want to 
14b0: 73 68 61 72 65 20 79 6f 75 72 20 63 68 61 6e 67  share your chang
14c0: 65 73 20 77 69 74 68 2e 20 20 49 66 20 79 6f 75  es with.  If you
14d0: 20 6f 6d 69 74 20 74 68 65 20 3c 69 3e 55 52 4c   omit the <i>URL
14e0: 3c 2f 69 3e 20 61 72 67 75 6d 65 6e 74 2c 0a 20  </i> argument,. 
14f0: 20 20 20 66 6f 73 73 69 6c 20 77 69 6c 6c 20 75     fossil will u
1500: 73 65 20 77 68 61 74 65 76 65 72 20 73 65 72 76  se whatever serv
1510: 65 72 20 79 6f 75 20 6d 6f 73 74 20 72 65 63 65  er you most rece
1520: 6e 74 6c 79 20 73 79 6e 63 65 64 20 77 69 74 68  ntly synced with
1530: 2e 3c 2f 70 3e 0a 0a 20 20 20 20 3c 70 3e 54 68  .</p>..    <p>Th
1540: 65 20 3c 62 3e 70 75 73 68 3c 2f 62 3e 20 63 6f  e <b>push</b> co
1550: 6d 6d 61 6e 64 20 6f 6e 6c 79 20 73 65 6e 64 73  mmand only sends
1560: 20 79 6f 75 72 20 63 68 61 6e 67 65 73 20 74 6f   your changes to
1570: 20 6f 74 68 65 72 73 2e 20 20 54 6f 0a 20 20 20   others.  To.   
1580: 20 52 65 63 65 69 76 65 20 63 68 61 6e 67 65 73   Receive changes
1590: 20 66 72 6f 6d 20 6f 74 68 65 72 73 2c 20 75 73   from others, us
15a0: 65 20 3c 62 3e 70 75 6c 6c 3c 2f 62 3e 2e 20 20  e <b>pull</b>.  
15b0: 4f 72 20 67 6f 20 62 6f 74 68 20 77 61 79 73 20  Or go both ways 
15c0: 61 74 0a 20 20 20 20 6f 6e 63 65 20 75 73 69 6e  at.    once usin
15d0: 67 20 3c 62 3e 73 79 6e 63 3c 2f 62 3e 3a 3c 2f  g <b>sync</b>:</
15e0: 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75  p>..    <blockqu
15f0: 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73  ote>.    <b>foss
1600: 69 6c 20 70 75 6c 6c 3c 2f 62 3e 20 3c 69 3e 55  il pull</b> <i>U
1610: 52 4c 3c 2f 69 3e 3c 62 72 3e 0a 20 20 20 20 3c  RL</i><br>.    <
1620: 62 3e 66 6f 73 73 69 6c 20 73 79 6e 63 3c 2f 62  b>fossil sync</b
1630: 3e 20 3c 69 3e 55 52 4c 3c 2f 69 3e 0a 20 20 20  > <i>URL</i>.   
1640: 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a   </blockquote>..
1650: 20 20 20 20 3c 70 3e 57 68 65 6e 20 79 6f 75 20      <p>When you 
1660: 70 75 6c 6c 20 69 6e 20 63 68 61 6e 67 65 73 20  pull in changes 
1670: 66 72 6f 6d 20 6f 74 68 65 72 73 2c 20 74 68 65  from others, the
1680: 79 20 67 6f 20 69 6e 74 6f 20 79 6f 75 72 20 72  y go into your r
1690: 65 70 6f 73 69 74 6f 72 79 2c 0a 20 20 20 20 6e  epository,.    n
16a0: 6f 74 20 69 6e 74 6f 20 79 6f 75 72 20 63 68 65  ot into your che
16b0: 63 6b 65 64 2d 6f 75 74 20 6c 6f 63 61 6c 20 74  cked-out local t
16c0: 72 65 65 2e 20 20 54 6f 20 67 65 74 20 74 68 65  ree.  To get the
16d0: 20 63 68 61 6e 67 65 73 20 69 6e 74 6f 20 79 6f   changes into yo
16e0: 75 72 0a 20 20 20 20 6c 6f 63 61 6c 20 74 72 65  ur.    local tre
16f0: 65 2c 20 75 73 65 20 3c 62 3e 75 70 64 61 74 65  e, use <b>update
1700: 3c 2f 62 3e 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c  </b>:</p>..    <
1710: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20  blockquote>.    
1720: 3c 62 3e 66 6f 73 73 69 6c 20 75 70 64 61 74 65  <b>fossil update
1730: 3c 2f 62 3e 20 3c 69 3e 55 55 49 44 3c 2f 69 3e  </b> <i>UUID</i>
1740: 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74  .    </blockquot
1750: 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 3c  e>..    <p>The <
1760: 69 3e 55 55 49 44 3c 2f 69 3e 20 69 73 20 73 6f  i>UUID</i> is so
1770: 6d 65 20 75 6e 69 71 75 65 20 61 62 62 72 65 76  me unique abbrev
1780: 69 61 74 69 6f 6e 20 74 6f 20 74 68 65 20 34 30  iation to the 40
1790: 2d 63 68 61 72 61 63 74 65 72 0a 20 20 20 20 76  -character.    v
17a0: 65 72 73 69 6f 6e 20 49 44 2e 20 20 49 66 20 79  ersion ID.  If y
17b0: 6f 75 20 6f 6d 69 74 20 74 68 65 20 3c 69 3e 55  ou omit the <i>U
17c0: 55 49 44 3c 2f 69 3e 20 66 6f 73 73 69 6c 20 6d  UID</i> fossil m
17d0: 6f 76 65 73 20 79 6f 75 20 74 6f 20 74 68 65 0a  oves you to the.
17e0: 20 20 20 20 6c 65 61 66 20 76 65 72 73 69 6f 6e      leaf version
17f0: 20 6f 66 20 74 68 65 20 62 72 61 6e 63 68 20 79   of the branch y
1800: 6f 75 72 20 61 72 65 20 63 75 72 72 65 6e 74 6c  our are currentl
1810: 79 20 6f 6e 2e 20 20 49 66 20 79 6f 75 72 20 62  y on.  If your b
1820: 72 61 6e 63 68 0a 20 20 20 20 68 61 73 20 6d 75  ranch.    has mu
1830: 6c 74 69 70 6c 65 20 6c 65 61 76 65 73 2c 20 79  ltiple leaves, y
1840: 6f 75 20 67 65 74 20 61 6e 20 65 72 72 6f 72 20  ou get an error 
1850: 2d 20 79 6f 75 27 6c 6c 20 68 61 76 65 20 74 6f  - you'll have to
1860: 20 73 70 65 63 69 66 79 20 74 68 65 0a 20 20 20   specify the.   
1870: 20 6c 65 61 66 20 79 6f 75 20 77 61 6e 74 20 75   leaf you want u
1880: 73 69 6e 67 20 61 20 3c 69 3e 55 55 49 44 3c 2f  sing a <i>UUID</
1890: 69 3e 20 61 72 67 75 6d 65 6e 74 2e 3c 2f 70 3e  i> argument.</p>
18a0: 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c  ..</blockquote><
18b0: 68 32 3e 42 72 61 6e 63 68 69 6e 67 20 41 6e 64  h2>Branching And
18c0: 20 4d 65 72 67 69 6e 67 3c 2f 68 32 3e 3c 62 6c   Merging</h2><bl
18d0: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c  ockquote>..    <
18e0: 70 3e 59 6f 75 20 63 61 6e 20 63 72 65 61 74 65  p>You can create
18f0: 20 62 72 61 6e 63 68 65 73 20 62 79 20 64 6f 69   branches by doi
1900: 6e 67 20 6d 75 6c 74 69 70 6c 65 20 63 6f 6d 6d  ng multiple comm
1910: 69 74 73 20 6f 66 66 20 6f 66 20 74 68 65 0a 20  its off of the. 
1920: 20 20 20 73 61 6d 65 20 62 61 73 65 20 76 65 72     same base ver
1930: 73 69 6f 6e 2e 20 20 54 6f 20 6d 65 72 67 65 20  sion.  To merge 
1940: 74 6f 20 62 72 61 6e 63 68 65 73 20 62 61 63 6b  to branches back
1950: 20 74 6f 67 65 74 68 65 72 2c 20 66 69 72 73 74   together, first
1960: 0a 20 20 20 20 3c 62 3e 75 70 64 61 74 65 3c 2f  .    <b>update</
1970: 62 3e 20 74 6f 20 74 68 65 20 6c 65 61 66 20 6f  b> to the leaf o
1980: 66 20 6f 6e 65 20 62 72 61 6e 63 68 2e 20 20 54  f one branch.  T
1990: 68 65 6e 20 64 6f 20 61 20 3c 62 3e 6d 65 72 67  hen do a <b>merg
19a0: 65 3c 2f 62 3e 0a 20 20 20 20 6f 66 20 74 68 65  e</b>.    of the
19b0: 20 6c 65 61 66 20 6f 66 20 74 68 65 20 6f 74 68   leaf of the oth
19c0: 65 72 20 62 72 61 6e 63 68 3a 3c 2f 70 3e 0a 0a  er branch:</p>..
19d0: 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e      <blockquote>
19e0: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6d  .    <b>fossil m
19f0: 65 72 67 65 3c 2f 62 3e 20 3c 69 3e 55 55 49 44  erge</b> <i>UUID
1a00: 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b  </i>.    </block
1a10: 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54  quote>..    <p>T
1a20: 65 73 74 20 74 6f 20 6d 61 6b 65 20 73 75 72 65  est to make sure
1a30: 20 79 6f 75 72 20 6d 65 72 67 65 20 64 69 64 6e   your merge didn
1a40: 27 74 20 6d 65 73 73 20 75 70 20 74 68 65 20 63  't mess up the c
1a50: 6f 64 65 2c 20 74 68 65 6e 0a 20 20 20 20 3c 62  ode, then.    <b
1a60: 3e 63 6f 6d 6d 69 74 3c 2f 62 3e 20 61 6e 64 20  >commit</b> and 
1a70: 70 6f 73 73 69 62 6c 79 20 61 6c 73 6f 20 3c 62  possibly also <b
1a80: 3e 70 75 73 68 3c 2f 62 3e 20 79 6f 75 72 20 63  >push</b> your c
1a90: 68 61 6e 67 65 73 2e 20 20 20 52 65 6d 65 6d 62  hanges.   Rememb
1aa0: 65 72 0a 20 20 20 20 74 68 61 74 20 6e 6f 62 6f  er.    that nobo
1ab0: 64 79 20 65 6c 73 65 20 63 61 6e 20 73 65 65 20  dy else can see 
1ac0: 79 6f 75 72 20 63 68 61 6e 67 65 73 20 75 6e 74  your changes unt
1ad0: 69 6c 20 79 6f 75 20 3c 62 3e 63 6f 6d 6d 69 74  il you <b>commit
1ae0: 3c 2f 62 3e 20 61 6e 64 0a 20 20 20 20 69 66 20  </b> and.    if 
1af0: 6f 74 68 65 72 20 61 72 65 20 75 73 69 6e 67 20  other are using 
1b00: 61 20 64 69 66 66 65 72 65 6e 74 20 72 65 70 6f  a different repo
1b10: 73 69 74 6f 72 79 20 79 6f 75 20 77 69 6c 6c 20  sitory you will 
1b20: 61 6c 73 6f 20 6e 65 65 64 20 74 6f 0a 20 20 20  also need to.   
1b30: 20 3c 62 3e 70 75 73 68 3c 2f 62 3e 2e 3c 2f 70   <b>push</b>.</p
1b40: 3e 0a 0a 3c 61 20 6e 61 6d 65 3d 22 73 65 72 76  >..<a name="serv
1b50: 65 72 73 65 74 75 70 22 3e 3c 2f 61 3e 0a 3c 2f  ersetup"></a>.</
1b60: 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 53  blockquote><h2>S
1b70: 65 74 74 69 6e 67 20 55 70 20 41 20 53 65 72 76  etting Up A Serv
1b80: 65 72 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f  er</h2><blockquo
1b90: 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20  te>..    <p>The 
1ba0: 65 61 73 69 65 73 74 20 77 61 79 20 74 6f 20 73  easiest way to s
1bb0: 65 74 20 75 70 20 61 20 73 65 72 76 65 72 20 69  et up a server i
1bc0: 73 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f  s:</p>..    <blo
1bd0: 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e  ckquote>.    <b>
1be0: 66 6f 73 73 69 6c 20 73 65 72 76 65 72 3c 2f 62  fossil server</b
1bf0: 3e 20 3c 69 3e 72 65 70 6f 73 69 74 6f 72 79 2d  > <i>repository-
1c00: 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20  filename</i>.   
1c10: 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a   </blockquote>..
1c20: 20 20 20 20 3c 70 3e 4f 72 3c 2f 62 3e 0a 0a 20      <p>Or</b>.. 
1c30: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a     <blockquote>.
1c40: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 75 69      <b>fossil ui
1c50: 3c 2f 62 3e 20 3c 69 3e 72 65 70 6f 73 69 74 6f  </b> <i>reposito
1c60: 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 0a  ry-filename</i>.
1c70: 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65      </blockquote
1c80: 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 64 69  >..    <p>The di
1c90: 66 66 65 72 65 6e 63 65 20 62 65 74 77 65 65 6e  fference between
1ca0: 20 74 68 65 73 65 20 74 77 6f 20 63 6f 6d 6d 61   these two comma
1cb0: 6e 64 20 69 73 20 74 68 61 74 20 3c 62 3e 75 69  nd is that <b>ui
1cc0: 3c 2f 62 3e 0a 20 20 20 20 61 74 74 65 6d 70 74  </b>.    attempt
1cd0: 73 20 74 6f 20 61 75 74 6f 6d 61 74 69 63 61 6c  s to automatical
1ce0: 6c 79 20 73 74 61 72 74 20 79 6f 75 72 20 77 65  ly start your we
1cf0: 62 20 62 72 6f 77 73 65 72 20 70 6f 69 6e 74 20  b browser point 
1d00: 61 74 20 74 68 65 0a 20 20 20 20 73 65 72 76 65  at the.    serve
1d10: 72 20 77 68 65 72 65 61 73 20 3c 62 3e 73 65 72  r whereas <b>ser
1d20: 76 65 72 3c 2f 62 3e 20 64 6f 65 73 20 6e 6f 74  ver</b> does not
1d30: 2e 0a 20 20 20 20 59 6f 75 20 63 61 6e 20 6f 6d  ..    You can om
1d40: 69 74 20 74 68 65 20 3c 69 3e 72 65 70 6f 73 69  it the <i>reposi
1d50: 74 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69  tory-filename</i
1d60: 3e 20 69 66 20 79 6f 75 20 61 72 65 20 77 69 74  > if you are wit
1d70: 68 69 6e 0a 20 20 20 20 61 20 63 68 65 63 6b 65  hin.    a checke
1d80: 64 2d 6f 75 74 20 6c 6f 63 61 6c 20 74 72 65 65  d-out local tree
1d90: 2e 20 20 54 68 69 73 20 73 65 72 76 65 72 20 75  .  This server u
1da0: 73 65 73 20 70 6f 72 74 20 38 30 38 30 20 62 79  ses port 8080 by
1db0: 20 64 65 66 61 75 6c 74 0a 20 20 20 20 62 75 74   default.    but
1dc0: 20 79 6f 75 20 63 61 6e 20 73 70 65 63 69 66 79   you can specify
1dd0: 20 61 20 64 69 66 66 65 72 65 6e 74 20 70 6f 72   a different por
1de0: 74 20 75 73 69 6e 67 20 74 68 65 20 3c 62 3e 2d  t using the <b>-
1df0: 70 6f 72 74 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64  port</b> command
1e00: 2e 3c 2f 70 3e 0a 0a 20 20 20 20 3c 70 3e 43 6f  .</p>..    <p>Co
1e10: 6d 6d 61 6e 64 2d 6c 69 6e 65 20 73 65 72 76 65  mmand-line serve
1e20: 72 73 20 6c 69 6b 65 20 74 68 69 73 20 61 72 65  rs like this are
1e30: 20 75 73 65 66 75 6c 20 77 68 65 6e 20 74 77 6f   useful when two
1e40: 20 70 65 6f 70 6c 65 20 77 61 6e 74 0a 20 20 20   people want.   
1e50: 20 74 6f 20 73 68 61 72 65 20 61 20 72 65 70 6f   to share a repo
1e60: 73 69 74 6f 72 79 20 6f 6e 20 74 65 6d 70 6f 72  sitory on tempor
1e70: 61 72 79 20 6f 72 20 61 64 2d 68 6f 63 20 62 61  ary or ad-hoc ba
1e80: 73 69 73 2e 20 20 46 6f 72 20 61 20 6d 6f 72 65  sis.  For a more
1e90: 0a 20 20 20 20 70 65 72 6d 61 6e 65 6e 74 20 69  .    permanent i
1ea0: 6e 73 74 61 6c 6c 61 74 69 6f 6e 2c 20 79 6f 75  nstallation, you
1eb0: 20 73 68 6f 75 6c 64 20 75 73 65 20 65 69 74 68   should use eith
1ec0: 65 72 20 74 68 65 20 43 47 49 20 73 65 72 76 65  er the CGI serve
1ed0: 72 20 6f 72 20 74 68 65 0a 20 20 20 20 69 6e 65  r or the.    ine
1ee0: 74 64 20 73 65 72 76 65 72 2e 20 20 54 6f 20 75  td server.  To u
1ef0: 73 65 20 74 68 65 20 43 47 49 20 73 65 72 76 65  se the CGI serve
1f00: 72 2c 20 63 72 65 61 74 65 20 61 20 43 47 49 20  r, create a CGI 
1f10: 73 63 72 69 70 74 20 74 68 61 74 0a 20 20 20 20  script that.    
1f20: 6c 6f 6f 6b 73 20 73 6f 6d 65 74 68 69 6e 67 20  looks something 
1f30: 6c 69 6b 65 20 74 68 69 73 3a 3c 2f 70 3e 0a 0a  like this:</p>..
1f40: 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e      <blockquote>
1f50: 3c 62 3e 0a 20 20 20 20 23 21 2f 75 73 72 2f 6c  <b>.    #!/usr/l
1f60: 6f 63 61 6c 2f 62 69 6e 2f 66 6f 73 73 69 6c 3c  ocal/bin/fossil<
1f70: 62 72 3e 0a 20 20 20 20 72 65 70 6f 73 69 74 6f  br>.    reposito
1f80: 72 79 3a 20 2f 68 6f 6d 65 2f 70 72 6f 6a 31 2f  ry: /home/proj1/
1f90: 72 65 70 6f 73 31 2e 66 6f 73 73 69 6c 0a 20 20  repos1.fossil.  
1fa0: 20 20 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 75 6f    </b></blockquo
1fb0: 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 41 64 6a 75  te>..    <p>Adju
1fc0: 73 74 20 74 68 65 20 70 61 74 68 73 20 69 6e 20  st the paths in 
1fd0: 74 68 69 73 20 43 47 49 20 73 63 72 69 70 74 20  this CGI script 
1fe0: 74 6f 20 6d 61 74 63 68 20 79 6f 75 72 20 69 6e  to match your in
1ff0: 73 74 61 6c 6c 61 74 69 6f 6e 2e 0a 20 20 20 20  stallation..    
2000: 4e 6f 77 20 70 6f 69 6e 74 20 63 6c 69 65 6e 74  Now point client
2010: 73 20 61 74 20 74 68 65 20 43 47 49 20 73 63 72  s at the CGI scr
2020: 69 70 74 2e 20 20 54 68 61 74 27 73 20 61 6c 6c  ipt.  That's all
2030: 20 74 68 65 72 65 20 69 73 20 74 6f 20 69 74 21   there is to it!
2040: 3c 2f 70 3e 0a 0a 20 20 20 20 3c 70 3e 59 6f 75  </p>..    <p>You
2050: 20 63 61 6e 20 61 6c 73 6f 20 72 75 6e 20 66 6f   can also run fo
2060: 73 73 69 6c 20 6f 66 66 20 6f 66 20 69 6e 65 74  ssil off of inet
2070: 64 20 6f 72 20 78 69 6e 65 74 64 2e 20 20 46 6f  d or xinetd.  Fo
2080: 72 20 61 6e 20 69 6e 65 74 64 0a 20 20 20 20 69  r an inetd.    i
2090: 6e 73 74 61 6c 6c 61 74 69 6f 6e 2c 20 6d 61 6b  nstallation, mak
20a0: 65 20 61 6e 20 65 6e 74 72 79 20 69 6e 20 2f 65  e an entry in /e
20b0: 74 63 2f 69 6e 65 74 64 2e 63 6f 6e 66 20 74 68  tc/inetd.conf th
20c0: 61 74 20 6c 6f 6f 6b 73 20 73 6f 6d 65 74 68 69  at looks somethi
20d0: 6e 67 0a 20 20 20 20 6c 69 6b 65 20 74 68 69 73  ng.    like this
20e0: 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63  :</p>..    <bloc
20f0: 6b 71 75 6f 74 65 3e 3c 62 3e 0a 20 20 20 20 38  kquote><b>.    8
2100: 30 20 73 74 72 65 61 6d 20 74 63 70 20 6e 6f 77  0 stream tcp now
2110: 61 69 74 2e 31 30 30 30 20 72 6f 6f 74 20 2f 75  ait.1000 root /u
2120: 73 72 2f 62 69 6e 2f 66 6f 73 73 69 6c 20 5c 3c  sr/bin/fossil \<
2130: 62 72 3e 0a 20 20 20 20 20 20 20 20 2f 75 73 72  br>.        /usr
2140: 2f 62 69 6e 2f 66 6f 73 73 69 6c 20 68 74 74 70  /bin/fossil http
2150: 20 2f 68 6f 6d 65 2f 70 72 6f 6a 31 2f 72 65 70   /home/proj1/rep
2160: 6f 73 31 2e 66 6f 73 73 69 6c 0a 20 20 20 20 3c  os1.fossil.    <
2170: 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e  /b></blockquote>
2180: 0a 0a 20 20 20 20 3c 70 3e 41 64 6a 75 73 74 20  ..    <p>Adjust 
2190: 74 68 65 20 70 61 74 68 73 20 74 6f 20 73 75 69  the paths to sui
21a0: 74 20 79 6f 75 72 20 69 6e 73 74 61 6c 6c 61 74  t your installat
21b0: 69 6f 6e 2c 20 6f 66 20 63 6f 75 72 73 65 2e 20  ion, of course. 
21c0: 20 4e 6f 74 69 63 65 20 74 68 61 74 0a 20 20 20   Notice that.   
21d0: 20 66 6f 73 73 69 6c 20 72 75 6e 73 20 61 73 20   fossil runs as 
21e0: 72 6f 6f 74 2e 20 20 54 68 69 73 20 69 73 20 6e  root.  This is n
21f0: 6f 74 20 72 65 71 75 69 72 65 64 20 2d 20 79 6f  ot required - yo
2200: 75 20 63 61 6e 20 72 75 6e 20 69 74 20 61 73 20  u can run it as 
2210: 61 6e 0a 20 20 20 20 75 6e 70 72 69 76 69 6c 65  an.    unprivile
2220: 67 65 64 20 75 73 65 72 2e 20 20 42 75 74 20 69  ged user.  But i
2230: 74 20 69 73 20 6d 6f 72 65 20 73 65 63 75 72 65  t is more secure
2240: 20 74 6f 20 72 75 6e 20 66 6f 73 73 69 6c 20 61   to run fossil a
2250: 73 20 72 6f 6f 74 2e 0a 20 20 20 20 57 68 65 6e  s root..    When
2260: 20 79 6f 75 20 64 6f 20 72 75 6e 20 66 6f 73 73   you do run foss
2270: 69 6c 20 61 73 20 72 6f 6f 74 2c 20 69 74 20 61  il as root, it a
2280: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 70 75 74  utomatically put
2290: 73 20 69 74 73 65 6c 66 20 69 6e 20 61 0a 20 20  s itself in a.  
22a0: 20 20 63 68 72 6f 6f 74 20 6a 61 69 6c 20 69 6e    chroot jail in
22b0: 20 74 68 65 20 73 61 6d 65 20 64 69 72 65 63 74   the same direct
22c0: 6f 72 79 20 61 73 20 74 68 65 20 72 65 70 6f 73  ory as the repos
22d0: 69 74 6f 72 79 2c 20 74 68 65 6e 20 64 72 6f 70  itory, then drop
22e0: 73 0a 20 20 20 20 72 6f 6f 74 20 70 72 69 76 69  s.    root privi
22f0: 6c 65 67 65 73 20 70 72 69 6f 72 20 74 6f 20 72  leges prior to r
2300: 65 61 64 69 6e 67 20 61 6e 79 20 69 6e 66 6f 72  eading any infor
2310: 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 74 68 65 20  mation from the 
2320: 72 65 71 75 65 73 74 2e 3c 2f 70 3e 0a 0a 3c 2f  request.</p>..</
2330: 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 61 20 6e 61  blockquote><a na
2340: 6d 65 3d 22 70 72 6f 78 79 22 3e 3c 2f 61 3e 3c  me="proxy"></a><
2350: 68 32 3e 48 54 54 50 20 50 72 6f 78 69 65 73 3c  h2>HTTP Proxies<
2360: 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e  /h2><blockquote>
2370: 0a 0a 20 20 20 20 3c 70 3e 49 66 20 79 6f 75 20  ..    <p>If you 
2380: 61 72 65 20 62 65 68 69 6e 64 20 61 20 72 65 73  are behind a res
2390: 74 72 69 63 74 69 76 65 20 66 69 72 65 77 61 6c  trictive firewal
23a0: 6c 20 74 68 61 74 20 72 65 71 75 69 72 65 73 20  l that requires 
23b0: 79 6f 75 20 74 6f 20 75 73 65 0a 20 20 20 20 61  you to use.    a
23c0: 6e 20 48 54 54 50 20 70 72 6f 78 79 20 74 6f 20  n HTTP proxy to 
23d0: 72 65 61 63 68 20 74 68 65 20 69 6e 74 65 72 6e  reach the intern
23e0: 65 74 2c 20 74 68 65 6e 20 79 6f 75 20 63 61 6e  et, then you can
23f0: 20 63 6f 6e 66 69 67 75 72 65 20 74 68 65 20 70   configure the p
2400: 72 6f 78 79 0a 20 20 20 20 69 6e 20 74 68 72 65  roxy.    in thre
2410: 65 20 64 69 66 66 65 72 65 6e 74 20 77 61 79 73  e different ways
2420: 2e 20 20 59 6f 75 20 63 61 6e 20 74 65 6c 6c 20  .  You can tell 
2430: 66 6f 73 73 69 6c 20 61 62 6f 75 74 20 79 6f 75  fossil about you
2440: 72 20 70 72 6f 78 79 20 75 73 69 6e 67 0a 20 20  r proxy using.  
2450: 20 20 61 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65    a command-line
2460: 20 6f 70 74 69 6f 6e 20 6f 6e 20 63 6f 6d 6d 61   option on comma
2470: 6e 64 73 20 74 68 61 74 20 75 73 65 20 74 68 65  nds that use the
2480: 20 6e 65 74 77 6f 72 6b 2c 0a 20 20 20 20 3c 62   network,.    <b
2490: 3e 73 79 6e 63 3c 2f 62 3e 2c 20 3c 62 3e 63 6c  >sync</b>, <b>cl
24a0: 6f 6e 65 3c 2f 62 3e 2c 20 3c 62 3e 70 75 73 68  one</b>, <b>push
24b0: 3c 2f 62 3e 2c 20 61 6e 64 20 3c 62 3e 70 75 6c  </b>, and <b>pul
24c0: 6c 3c 2f 62 3e 2e 3c 2f 70 3e 0a 0a 20 20 20 20  l</b>.</p>..    
24d0: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20  <blockquote>.   
24e0: 20 3c 62 3e 66 6f 73 73 69 6c 20 63 6c 6f 6e 65   <b>fossil clone
24f0: 20 3c 2f 62 3e 3c 69 3e 55 52 4c 3c 2f 69 3e 20   </b><i>URL</i> 
2500: 20 3c 62 3e 2d 2d 70 72 6f 78 79 3c 2f 62 3e 20   <b>--proxy</b> 
2510: 3c 69 3e 50 72 6f 78 79 2d 55 52 4c 3c 2f 69 3e  <i>Proxy-URL</i>
2520: 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74  .    </blockquot
2530: 65 3e 0a 0a 20 20 20 20 3c 70 3e 49 74 20 69 73  e>..    <p>It is
2540: 20 61 6e 6e 6f 79 69 6e 67 20 74 6f 20 68 61 76   annoying to hav
2550: 65 20 74 6f 20 74 79 70 65 20 69 6e 20 74 68 65  e to type in the
2560: 20 70 72 6f 78 79 20 55 52 4c 20 65 76 65 72 79   proxy URL every
2570: 20 74 69 6d 65 20 79 6f 75 0a 20 20 20 20 73 79   time you.    sy
2580: 6e 63 20 79 6f 75 72 20 70 72 6f 6a 65 63 74 2c  nc your project,
2590: 20 74 68 6f 75 67 68 2c 20 73 6f 20 79 6f 75 20   though, so you 
25a0: 63 61 6e 20 6d 61 6b 65 20 74 68 65 20 70 72 6f  can make the pro
25b0: 78 79 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e  xy configuration
25c0: 0a 20 20 20 20 70 65 72 73 69 73 74 65 6e 74 20  .    persistent 
25d0: 75 73 69 6e 67 20 74 68 65 20 3c 62 3e 73 65 74  using the <b>set
25e0: 74 69 6e 67 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64  ting</b> command
25f0: 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63  :</p>..    <bloc
2600: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66  kquote>.    <b>f
2610: 6f 73 73 69 6c 20 73 65 74 74 69 6e 67 20 70 72  ossil setting pr
2620: 6f 78 79 20 3c 2f 62 3e 3c 69 3e 50 72 6f 78 79  oxy </b><i>Proxy
2630: 2d 55 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62  -URL</i>.    </b
2640: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20  lockquote>..    
2650: 3c 70 3e 4f 72 2c 20 79 6f 75 20 63 61 6e 20 73  <p>Or, you can s
2660: 65 74 20 74 68 65 20 22 3c 62 3e 68 74 74 70 5f  et the "<b>http_
2670: 70 72 6f 78 79 3c 2f 62 3e 22 20 65 6e 76 69 72  proxy</b>" envir
2680: 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 3a  onment variable:
2690: 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b  </p>..    <block
26a0: 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 65 78  quote>.    <b>ex
26b0: 70 6f 72 74 20 68 74 74 70 5f 70 72 6f 78 79 3d  port http_proxy=
26c0: 3c 2f 62 3e 3c 69 3e 50 72 6f 78 79 2d 55 52 4c  </b><i>Proxy-URL
26d0: 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b  </i>.    </block
26e0: 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54  quote>..    <p>T
26f0: 6f 20 73 74 6f 70 20 75 73 69 6e 67 20 74 68 65  o stop using the
2700: 20 70 72 6f 78 79 2c 20 64 6f 3a 3c 2f 70 3e 0a   proxy, do:</p>.
2710: 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65  .    <blockquote
2720: 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20  >.    <b>fossil 
2730: 73 65 74 74 69 6e 67 20 70 72 6f 78 79 20 6f 66  setting proxy of
2740: 66 3c 2f 62 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63  f</b>.    </bloc
2750: 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e  kquote>..    <p>
2760: 4f 72 20 75 6e 73 65 74 20 74 68 65 20 65 6e 76  Or unset the env
2770: 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c  ironment variabl
2780: 65 2e 20 20 54 68 65 20 66 6f 73 73 69 6c 20 73  e.  The fossil s
2790: 65 74 74 69 6e 67 20 66 6f 72 20 74 68 65 0a 20  etting for the. 
27a0: 20 20 20 48 54 54 50 20 70 72 6f 78 79 20 74 61     HTTP proxy ta
27b0: 6b 65 73 20 70 72 65 63 65 64 65 6e 63 65 20 6f  kes precedence o
27c0: 76 65 72 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d  ver the environm
27d0: 65 6e 74 20 76 61 72 69 61 62 6c 65 20 61 6e 64  ent variable and
27e0: 20 74 68 65 0a 20 20 20 20 63 6f 6d 6d 61 6e 64   the.    command
27f0: 2d 6c 69 6e 65 20 6f 70 74 69 6f 6e 20 6f 76 65  -line option ove
2800: 72 72 69 64 65 73 20 62 6f 74 68 2e 20 20 49 66  rrides both.  If
2810: 20 79 6f 75 20 68 61 76 65 20 61 6e 20 70 65 72   you have an per
2820: 73 69 73 74 65 6e 74 0a 20 20 20 20 70 72 6f 78  sistent.    prox
2830: 79 20 73 65 74 74 69 6e 67 20 74 68 61 74 20 79  y setting that y
2840: 6f 75 20 77 61 6e 74 20 74 6f 20 6f 76 65 72 72  ou want to overr
2850: 69 64 65 20 66 6f 72 20 61 20 6f 6e 65 2d 74 69  ide for a one-ti
2860: 6d 65 20 73 79 6e 63 2c 20 74 68 61 74 0a 20 20  me sync, that.  
2870: 20 20 69 73 20 65 61 73 69 6c 79 20 64 6f 6e 65    is easily done
2880: 20 6f 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2d   on the command-
2890: 6c 69 6e 65 2e 20 20 46 6f 72 20 65 78 61 6d 70  line.  For examp
28a0: 6c 65 2c 20 74 6f 20 73 79 6e 63 20 77 69 74 68  le, to sync with
28b0: 0a 20 20 20 20 61 20 63 6f 2d 77 6f 72 6b 65 72  .    a co-worker
28c0: 73 20 72 65 70 6f 73 69 74 6f 72 79 20 6f 6e 20  s repository on 
28d0: 79 6f 75 72 20 4c 41 4e 2c 20 79 6f 75 20 6d 69  your LAN, you mi
28e0: 67 68 74 20 74 79 70 65 3a 3c 2f 70 3e 20 20 20  ght type:</p>   
28f0: 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74  ..    <blockquot
2900: 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c  e>.    <b>fossil
2910: 20 73 79 6e 63 20 68 74 74 70 3a 2f 2f 31 39 32   sync http://192
2920: 2e 31 36 38 2e 31 2e 33 36 3a 38 30 38 30 2f 20  .168.1.36:8080/ 
2930: 2d 2d 70 72 6f 78 79 20 6f 66 66 3c 2f 62 3e 0a  --proxy off</b>.
2940: 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65      </blockquote
2950: 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e  >..</blockquote>
2960: 3c 68 32 3e 4d 6f 72 65 20 48 69 6e 74 73 3c 2f  <h2>More Hints</
2970: 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a  h2><blockquote>.
2980: 0a 20 20 20 20 3c 70 3e 54 72 79 20 74 68 65 73  .    <p>Try thes
2990: 65 20 63 6f 6d 6d 61 6e 64 73 3a 3c 2f 70 3e 0a  e commands:</p>.
29a0: 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65  .    <blockquote
29b0: 3e 3c 62 3e 0a 20 20 20 20 66 6f 73 73 69 6c 20  ><b>.    fossil 
29c0: 68 65 6c 70 3c 62 72 3e 0a 20 20 20 20 66 6f 73  help<br>.    fos
29d0: 73 69 6c 20 74 65 73 74 2d 63 6f 6d 6d 61 6e 64  sil test-command
29e0: 73 0a 20 20 20 20 3c 2f 62 3e 3c 2f 62 6c 6f 63  s.    </b></bloc
29f0: 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e  kquote>..    <p>
2a00: 45 78 70 6c 6f 72 65 20 61 6e 64 20 68 61 76 65  Explore and have
2a10: 20 66 75 6e 21 3c 2f 70 3e 0a 0a 0a 3c 2f 62 6c   fun!</p>...</bl
2a20: 6f 63 6b 71 75 6f 74 65 3e 0a                    ockquote>.