Fossil

Hex Artifact Content
Login

Artifact ef6f80a6432d6b9825112fad72a7ad4301a7a9c8:

Wiki page [Tutorial] by anonymous 2010-07-25 10:49:57.
0000: 44 20 32 30 31 30 2d 30 37 2d 32 35 54 31 30 3a  D 2010-07-25T10:
0010: 34 39 3a 35 37 0a 4c 20 54 75 74 6f 72 69 61 6c  49:57.L Tutorial
0020: 0a 50 20 35 39 65 32 34 33 62 37 65 39 62 39 38  .P 59e243b7e9b98
0030: 62 64 36 37 33 34 64 62 31 32 63 38 38 36 62 65  bd6734db12c886be
0040: 36 63 33 64 31 38 33 35 39 66 35 0a 55 20 61 6e  6c3d18359f5.U an
0050: 6f 6e 79 6d 6f 75 73 0a 57 20 33 30 33 38 0a 3c  onymous.W 3038.<
0060: 68 31 3e 46 6f 73 73 69 6c 20 54 75 74 6f 72 69  h1>Fossil Tutori
0070: 61 6c 3c 2f 68 31 3e 0d 0a 0d 0a 3c 69 3e 4e 6f  al</h1>....<i>No
0080: 74 65 3a 20 41 74 20 74 68 69 73 20 70 6f 69 6e  te: At this poin
0090: 74 20 74 68 69 73 20 69 73 20 6f 6e 6c 79 20 61  t this is only a
00a0: 6e 20 6f 75 74 6c 69 6e 65 2c 20 6e 6f 74 20 74  n outline, not t
00b0: 68 65 20 72 65 61 6c 20 74 68 69 6e 67 2e 20 20  he real thing.  
00c0: 57 65 20 6e 65 65 64 20 74 6f 20 65 73 74 61 62  We need to estab
00d0: 6c 69 73 68 20 77 68 61 74 20 67 6f 65 73 20 69  lish what goes i
00e0: 6e 74 6f 20 61 20 64 65 63 65 6e 74 20 46 6f 73  nto a decent Fos
00f0: 73 69 6c 20 74 75 74 6f 72 69 61 6c 20 62 65 66  sil tutorial bef
0100: 6f 72 65 20 77 65 20 73 74 61 72 74 20 77 72 69  ore we start wri
0110: 74 69 6e 67 20 64 65 74 61 69 6c 73 2e 20 20 49  ting details.  I
0120: 6e 69 74 69 61 6c 6c 79 20 77 65 20 6d 61 79 20  nitially we may 
0130: 77 61 6e 74 20 74 6f 20 61 70 70 65 6e 64 20 74  want to append t
0140: 68 65 20 74 75 74 6f 72 69 61 6c 20 70 69 65 63  he tutorial piec
0150: 65 73 20 73 6f 20 74 68 65 79 27 72 65 20 63 6c  es so they're cl
0160: 65 61 72 6c 79 20 6c 61 62 65 6c 6c 65 64 20 61  early labelled a
0170: 6e 64 20 75 70 20 66 6f 72 20 64 69 73 63 75 73  nd up for discus
0180: 73 69 6f 6e 2e 20 20 4f 6e 63 65 20 74 68 65 20  sion.  Once the 
0190: 70 69 65 63 65 73 20 61 72 65 20 69 6e 20 73 6f  pieces are in so
01a0: 6d 65 74 68 69 6e 67 20 72 65 73 65 6d 62 6c 69  mething resembli
01b0: 6e 67 20 73 74 61 62 6c 65 20 63 6f 6e 64 69 74  ng stable condit
01c0: 69 6f 6e 2c 20 74 68 65 20 77 68 6f 6c 65 20 70  ion, the whole p
01d0: 61 67 65 20 63 61 6e 20 62 65 20 65 64 69 74 65  age can be edite
01e0: 64 20 61 6e 64 20 74 68 65 20 66 69 6e 61 6c 20  d and the final 
01f0: 66 6f 72 6d 20 6d 6f 76 65 64 20 75 70 20 69 6e  form moved up in
0200: 74 6f 20 74 68 65 20 74 75 74 6f 72 69 61 6c 20  to the tutorial 
0210: 70 72 6f 70 65 72 2e 3c 2f 69 3e 0d 0a 0d 0a 4f  proper.</i>....O
0220: 75 74 6c 69 6e 65 3a 0d 0a 20 20 2a 20 20 57 68  utline:..  *  Wh
0230: 61 74 20 69 73 20 46 6f 73 73 69 6c 3f 20 28 5b  at is Fossil? ([
0240: 68 74 74 70 3a 2f 2f 77 77 77 2e 68 77 61 63 69  http://www.hwaci
0250: 2e 63 6f 6d 2f 63 67 69 2d 62 69 6e 2f 66 6f 73  .com/cgi-bin/fos
0260: 73 69 6c 2f 64 6f 63 2f 74 69 70 2f 77 77 77 2f  sil/doc/tip/www/
0270: 69 6e 64 65 78 2e 77 69 6b 69 7c 72 65 66 5d 29  index.wiki|ref])
0280: 0d 0a 20 20 2a 20 20 57 68 61 74 20 64 69 73 74  ..  *  What dist
0290: 69 6e 67 75 69 73 68 65 73 20 69 74 20 66 72 6f  inguishes it fro
02a0: 6d 20 6f 74 68 65 72 20 53 43 4d 20 73 79 73 74  m other SCM syst
02b0: 65 6d 73 3f 0d 0a 20 20 2a 20 20 48 6f 77 20 64  ems?..  *  How d
02c0: 6f 20 49 20 67 65 74 20 69 74 3f 20 28 5b 68 74  o I get it? ([ht
02d0: 74 70 3a 2f 2f 77 77 77 2e 66 6f 73 73 69 6c 2d  tp://www.fossil-
02e0: 73 63 6d 2e 6f 72 67 2f 66 6f 73 73 69 6c 2f 74  scm.org/fossil/t
02f0: 69 6d 65 6c 69 6e 65 7c 72 65 66 5d 2c 20 5b 68  imeline|ref], [h
0300: 74 74 70 3a 2f 2f 77 77 77 2e 68 77 61 63 69 2e  ttp://www.hwaci.
0310: 63 6f 6d 2f 63 67 69 2d 62 69 6e 2f 66 6f 73 73  com/cgi-bin/foss
0320: 69 6c 2f 74 69 6d 65 6c 69 6e 65 7c 72 65 66 5d  il/timeline|ref]
0330: 2c 20 5b 68 74 74 70 3a 2f 2f 77 77 77 2e 66 6f  , [http://www.fo
0340: 73 73 69 6c 2d 73 63 6d 2e 6f 72 67 2f 64 6f 77  ssil-scm.org/dow
0350: 6e 6c 6f 61 64 2e 68 74 6d 6c 7c 72 65 66 5d 29  nload.html|ref])
0360: 0d 0a 20 20 2a 20 20 48 6f 77 20 64 6f 20 49 20  ..  *  How do I 
0370: 62 75 69 6c 64 20 69 74 20 6d 79 73 65 6c 66 3f  build it myself?
0380: 20 20 28 5b 68 74 74 70 3a 2f 2f 77 77 77 2e 68    ([http://www.h
0390: 77 61 63 69 2e 63 6f 6d 2f 63 67 69 2d 62 69 6e  waci.com/cgi-bin
03a0: 2f 66 6f 73 73 69 6c 2f 64 6f 63 2f 74 69 70 2f  /fossil/doc/tip/
03b0: 77 77 77 2f 62 75 69 6c 64 2e 77 69 6b 69 7c 72  www/build.wiki|r
03c0: 65 66 5d 29 0d 0a 20 20 2a 20 20 57 68 61 74 20  ef])..  *  What 
03d0: 61 72 65 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 75  are the common u
03e0: 73 65 20 70 61 74 74 65 72 6e 73 3f 20 28 5b 68  se patterns? ([h
03f0: 74 74 70 3a 2f 2f 77 77 77 2e 68 77 61 63 69 2e  ttp://www.hwaci.
0400: 63 6f 6d 2f 63 67 69 2d 62 69 6e 2f 66 6f 73 73  com/cgi-bin/foss
0410: 69 6c 2f 64 6f 63 2f 74 69 70 2f 77 77 77 2f 71  il/doc/tip/www/q
0420: 75 69 63 6b 73 74 61 72 74 2e 77 69 6b 69 7c 72  uickstart.wiki|r
0430: 65 66 5d 29 0d 0a 20 20 2a 20 20 43 6f 6d 69 6e  ef])..  *  Comin
0440: 67 20 74 6f 20 46 6f 73 73 69 6c 20 66 72 6f 6d  g to Fossil from
0450: 20 43 56 53 2e 0d 0a 20 20 2a 20 20 43 6f 6d 69   CVS...  *  Comi
0460: 6e 67 20 74 6f 20 46 6f 73 73 69 6c 20 66 72 6f  ng to Fossil fro
0470: 6d 20 53 75 62 76 65 72 73 69 6f 6e 2e 0d 0a 20  m Subversion... 
0480: 20 2a 20 20 43 6f 6d 69 6e 67 20 74 6f 20 46 6f   *  Coming to Fo
0490: 73 73 69 6c 20 66 72 6f 6d 20 62 7a 72 2e 0d 0a  ssil from bzr...
04a0: 20 20 2a 20 20 5b 23 66 72 6f 6d 64 61 72 63 73    *  [#fromdarcs
04b0: 7c 43 6f 6d 69 6e 67 20 74 6f 20 46 6f 73 73 69  |Coming to Fossi
04c0: 6c 20 66 72 6f 6d 20 44 61 72 63 73 2e 5d 0d 0a  l from Darcs.]..
04d0: 20 20 2a 20 20 43 6f 6d 69 6e 67 20 74 6f 20 46    *  Coming to F
04e0: 6f 73 73 69 6c 20 66 72 6f 6d 20 4d 65 72 63 75  ossil from Mercu
04f0: 72 69 61 6c 2e 0d 0a 20 20 2a 20 20 43 6f 6d 69  rial...  *  Comi
0500: 6e 67 20 74 6f 20 46 6f 73 73 69 6c 20 66 72 6f  ng to Fossil fro
0510: 6d 20 67 69 74 2e 0d 0a 20 20 2a 20 20 43 6f 6d  m git...  *  Com
0520: 69 6e 67 20 74 6f 20 46 6f 73 73 69 6c 20 66 72  ing to Fossil fr
0530: 6f 6d 20 2e 2e 2e 20 28 77 68 61 74 20 65 6c 73  om ... (what els
0540: 65 3f 29 2e 0d 0a 0d 0a 3c 68 72 3e 0d 0a 0d 0a  e?).....<hr>....
0550: 0d 0a 3c 68 72 3e 3c 69 3e 4f 6e 20 32 30 30 38  ..<hr><i>On 2008
0560: 2d 30 35 2d 32 35 20 30 36 3a 34 31 3a 35 32 20  -05-25 06:41:52 
0570: 55 54 43 20 6d 69 63 68 61 65 6c 20 61 64 64 65  UTC michael adde
0580: 64 3a 3c 2f 69 3e 3c 62 72 20 2f 3e 0d 0a 3c 68  d:</i><br />..<h
0590: 32 20 69 64 3d 22 66 72 6f 6d 64 61 72 63 73 22  2 id="fromdarcs"
05a0: 3e 43 6f 6d 69 6e 67 20 74 6f 20 3c 63 69 74 65  >Coming to <cite
05b0: 3e 46 6f 73 73 69 6c 3c 2f 63 69 74 65 3e 20 66  >Fossil</cite> f
05c0: 72 6f 6d 20 3c 63 69 74 65 3e 64 61 72 63 73 3c  rom <cite>darcs<
05d0: 2f 63 69 74 65 3e 3c 2f 68 32 3e 0d 0a 49 66 20  /cite></h2>..If 
05e0: 79 6f 75 27 72 65 20 63 6f 6d 69 6e 67 20 74 6f  you're coming to
05f0: 20 3c 63 69 74 65 3e 46 6f 73 73 69 6c 3c 2f 63   <cite>Fossil</c
0600: 69 74 65 3e 20 66 72 6f 6d 20 3c 63 69 74 65 3e  ite> from <cite>
0610: 5b 68 74 74 70 3a 2f 2f 77 77 77 2e 64 61 72 63  [http://www.darc
0620: 73 2e 6e 65 74 2f 7c 64 61 72 63 73 5d 3c 2f 63  s.net/|darcs]</c
0630: 69 74 65 3e 2c 20 6d 6f 73 74 20 6f 66 20 3c 63  ite>, most of <c
0640: 69 74 65 3e 46 6f 73 73 69 6c 3c 2f 63 69 74 65  ite>Fossil</cite
0650: 3e 27 73 20 63 6f 6e 63 65 70 74 73 20 77 69 6c  >'s concepts wil
0660: 6c 20 6e 6f 74 20 62 65 20 6e 65 77 20 74 6f 20  l not be new to 
0670: 79 6f 75 2e 20 20 41 20 62 72 69 65 66 20 63 6f  you.  A brief co
0680: 6d 70 61 72 69 73 6f 6e 20 6f 66 20 74 68 65 20  mparison of the 
0690: 74 77 6f 20 73 79 73 74 65 6d 73 20 77 69 6c 6c  two systems will
06a0: 20 68 65 6c 70 20 67 65 74 20 79 6f 75 20 6f 72   help get you or
06b0: 69 65 6e 74 65 64 2e 0d 0a 3c 6e 6f 77 69 6b 69  iented...<nowiki
06c0: 3e 0d 0a 3c 74 61 62 6c 65 20 77 69 64 74 68 3d  >..<table width=
06d0: 22 35 30 25 22 20 72 75 6c 65 73 3d 22 61 6c 6c  "50%" rules="all
06e0: 22 20 62 6f 72 64 65 72 3d 22 31 22 3e 0d 0a 20  " border="1">.. 
06f0: 3c 74 72 3e 0d 0a 20 20 3c 74 64 3e 3c 73 74 72  <tr>..  <td><str
0700: 6f 6e 67 3e 54 61 73 6b 3c 2f 73 74 72 6f 6e 67  ong>Task</strong
0710: 3e 3c 2f 74 64 3e 0d 0a 20 20 3c 74 64 3e 3c 73  ></td>..  <td><s
0720: 74 72 6f 6e 67 3e 64 61 72 63 73 3c 2f 73 74 72  trong>darcs</str
0730: 6f 6e 67 3e 3c 2f 74 64 3e 0d 0a 20 20 3c 74 64  ong></td>..  <td
0740: 3e 3c 73 74 72 6f 6e 67 3e 46 6f 73 73 69 6c 3c  ><strong>Fossil<
0750: 2f 73 74 72 6f 6e 67 3e 3c 2f 74 64 3e 0d 0a 20  /strong></td>.. 
0760: 3c 2f 74 72 3e 0d 0a 20 3c 74 72 20 76 61 6c 69  </tr>.. <tr vali
0770: 67 6e 3d 22 74 6f 70 22 3e 0d 0a 20 20 3c 74 64  gn="top">..  <td
0780: 3e 43 72 65 61 74 65 20 61 20 6e 65 77 20 72 65  >Create a new re
0790: 70 6f 73 69 74 6f 72 79 2e 3c 2f 74 64 3e 0d 0a  pository.</td>..
07a0: 20 20 3c 74 64 3e 3c 63 6f 64 65 3e 64 61 72 63    <td><code>darc
07b0: 73 20 69 6e 69 74 3c 2f 63 6f 64 65 3e 3c 2f 74  s init</code></t
07c0: 64 3e 0d 0a 20 20 3c 74 64 3e 3c 63 6f 64 65 3e  d>..  <td><code>
07d0: 66 6f 73 73 69 6c 20 6e 65 77 20 72 65 70 6f 2e  fossil new repo.
07e0: 66 73 6c 3c 2f 63 6f 64 65 3e 3c 73 75 70 3e 31  fsl</code><sup>1
07f0: 3c 2f 73 75 70 3e 3c 63 6f 64 65 3e 3c 62 72 3e  </sup><code><br>
0800: 66 6f 73 73 69 6c 20 6f 70 65 6e 20 72 65 70 6f  fossil open repo
0810: 2e 66 73 6c 3c 2f 74 64 3e 0d 0a 20 3c 74 72 20  .fsl</td>.. <tr 
0820: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0d 0a 20  valign="top">.. 
0830: 20 3c 74 64 3e 43 6c 6f 6e 65 20 61 6e 20 65 78   <td>Clone an ex
0840: 69 73 74 69 6e 67 20 72 65 70 6f 73 69 74 6f 72  isting repositor
0850: 79 2e 3c 2f 74 64 3e 0d 0a 20 20 3c 74 64 3e 3c  y.</td>..  <td><
0860: 63 6f 64 65 3e 64 61 72 63 73 20 67 65 74 20 7b  code>darcs get {
0870: 50 41 54 48 7c 55 52 4c 7d 3c 2f 63 6f 64 65 3e  PATH|URL}</code>
0880: 3c 73 75 70 3e 32 3c 2f 73 75 70 3e 3c 2f 74 64  <sup>2</sup></td
0890: 3e 0d 0a 20 20 3c 74 64 3e 3c 63 6f 64 65 3e 66  >..  <td><code>f
08a0: 6f 73 73 69 6c 20 63 6c 6f 6e 65 20 55 52 4c 20  ossil clone URL 
08b0: 63 6c 6f 6e 65 2e 66 73 6c 3c 2f 63 6f 64 65 3e  clone.fsl</code>
08c0: 3c 73 75 70 3e 31 3c 2f 73 75 70 3e 3c 63 6f 64  <sup>1</sup><cod
08d0: 65 3e 3c 62 72 3e 66 6f 73 73 69 6c 20 6f 70 65  e><br>fossil ope
08e0: 6e 20 63 6c 6f 6e 65 2e 66 73 6c 3c 2f 74 64 3e  n clone.fsl</td>
08f0: 0d 0a 20 3c 2f 74 72 3e 0d 0a 20 3c 74 72 20 76  .. </tr>.. <tr v
0900: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0d 0a 20 20  align="top">..  
0910: 3c 74 64 3e 43 6f 6c 6c 65 63 74 20 63 68 61 6e  <td>Collect chan
0920: 67 65 73 20 66 72 6f 6d 20 61 20 72 65 6d 6f 74  ges from a remot
0930: 65 20 72 65 70 6f 73 69 74 6f 72 79 2e 3c 2f 74  e repository.</t
0940: 64 3e 0d 0a 20 20 3c 74 64 3e 3c 63 6f 64 65 3e  d>..  <td><code>
0950: 64 61 72 63 73 20 70 75 6c 6c 20 5b 7b 50 41 54  darcs pull [{PAT
0960: 48 7c 55 52 4c 7d 5d 3c 2f 63 6f 64 65 3e 3c 2f  H|URL}]</code></
0970: 74 64 3e 0d 0a 20 20 3c 74 64 3e 3c 63 6f 64 65  td>..  <td><code
0980: 3e 66 6f 73 73 69 6c 20 70 75 6c 6c 20 5b 55 52  >fossil pull [UR
0990: 4c 5d 3c 2f 63 6f 64 65 3e 3c 2f 74 64 3e 0d 0a  L]</code></td>..
09a0: 20 3c 2f 74 72 3e 0d 0a 20 3c 74 72 20 76 61 6c   </tr>.. <tr val
09b0: 69 67 6e 3d 22 74 6f 70 22 3e 0d 0a 20 20 3c 74  ign="top">..  <t
09c0: 64 3e 53 65 6e 64 20 63 68 61 6e 67 65 73 20 74  d>Send changes t
09d0: 6f 20 72 65 6d 6f 74 65 20 72 65 70 6f 73 69 74  o remote reposit
09e0: 6f 72 79 2e 3c 2f 74 64 3e 0d 0a 20 20 3c 74 64  ory.</td>..  <td
09f0: 3e 3c 63 6f 64 65 3e 64 61 72 63 73 20 70 75 73  ><code>darcs pus
0a00: 68 20 5b 7b 50 41 54 48 7c 55 52 4c 7d 5d 3c 2f  h [{PATH|URL}]</
0a10: 63 6f 64 65 3e 3c 2f 74 64 3e 0d 0a 20 20 3c 74  code></td>..  <t
0a20: 64 3e 3c 63 6f 64 65 3e 66 6f 73 73 69 6c 20 70  d><code>fossil p
0a30: 75 73 68 20 5b 55 52 4c 5d 3c 2f 63 6f 64 65 3e  ush [URL]</code>
0a40: 3c 2f 74 64 3e 0d 0a 20 3c 2f 74 72 3e 0d 0a 3c  </td>.. </tr>..<
0a50: 2f 74 61 62 6c 65 3e 0d 0a 3c 2f 6e 6f 77 69 6b  /table>..</nowik
0a60: 69 3e 0d 0a 3c 73 75 70 3e 31 3c 2f 73 75 70 3e  i>..<sup>1</sup>
0a70: 20 41 20 3c 63 69 74 65 3e 64 61 72 63 73 3c 2f   A <cite>darcs</
0a80: 63 69 74 65 3e 20 72 65 70 6f 73 69 74 6f 72 79  cite> repository
0a90: 20 69 73 20 74 79 70 69 63 61 6c 6c 79 2c 20 69   is typically, i
0aa0: 6e 20 69 74 73 20 6d 6f 73 74 20 63 6f 6d 6d 6f  n its most commo
0ab0: 6e 20 75 73 65 20 63 61 73 65 2c 20 61 20 73 75  n use case, a su
0ac0: 62 64 69 72 65 63 74 6f 72 79 20 6f 66 20 74 68  bdirectory of th
0ad0: 65 20 70 72 6f 6a 65 63 74 20 64 69 72 65 63 74  e project direct
0ae0: 6f 72 79 2e 20 20 41 20 3c 63 69 74 65 3e 46 6f  ory.  A <cite>Fo
0af0: 73 73 69 6c 3c 2f 63 69 74 65 3e 20 72 65 70 6f  ssil</cite> repo
0b00: 73 69 74 6f 72 79 20 69 73 20 61 20 73 69 6e 67  sitory is a sing
0b10: 6c 65 20 66 69 6c 65 20 77 68 69 63 68 20 63 61  le file which ca
0b20: 6e 20 62 65 20 70 6c 61 63 65 64 20 61 6e 79 77  n be placed anyw
0b30: 68 65 72 65 20 6f 6e 20 79 6f 75 72 20 64 69 73  here on your dis
0b40: 6b 2e 20 20 49 74 20 64 6f 65 73 20 6e 6f 74 20  k.  It does not 
0b50: 6e 65 63 65 73 73 61 72 69 6c 79 20 28 61 6e 64  necessarily (and
0b60: 20 69 6e 64 65 65 64 20 75 73 75 61 6c 6c 79 20   indeed usually 
0b70: 73 68 6f 75 6c 64 6e 27 74 29 20 72 65 73 69 64  shouldn't) resid
0b80: 65 20 69 6e 20 74 68 65 20 73 61 6d 65 20 70 6c  e in the same pl
0b90: 61 63 65 20 79 6f 75 20 64 6f 20 79 6f 75 72 20  ace you do your 
0ba0: 77 6f 72 6b 2e 0d 0a 0d 0a 3c 73 75 70 3e 32 3c  work.....<sup>2<
0bb0: 2f 73 75 70 3e 20 41 6e 20 61 6c 74 65 72 6e 61  /sup> An alterna
0bc0: 74 69 76 65 20 74 6f 20 75 73 69 6e 67 20 3c 63  tive to using <c
0bd0: 6f 64 65 3e 64 61 72 63 73 20 67 65 74 3c 2f 63  ode>darcs get</c
0be0: 6f 64 65 3e 20 69 6e 20 74 68 65 20 64 65 73 74  ode> in the dest
0bf0: 69 6e 61 74 69 6f 6e 20 72 65 70 6f 73 69 74 6f  ination reposito
0c00: 72 79 20 69 73 20 74 6f 20 75 73 65 20 3c 63 6f  ry is to use <co
0c10: 64 65 3e 64 61 72 63 73 20 70 75 74 3c 2f 63 6f  de>darcs put</co
0c20: 64 65 3e 20 69 6e 20 74 68 65 20 73 6f 75 72 63  de> in the sourc
0c30: 65 20 72 65 70 6f 73 69 74 6f 72 79 2e 0a 5a 20  e repository..Z 
0c40: 39 66 35 63 38 36 62 31 62 30 31 36 37 64 65 66  9f5c86b1b0167def
0c50: 64 30 61 32 30 64 34 64 30 35 35 33 65 31 66 38  d0a20d4d0553e1f8
0c60: 0a                                               .