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 0a 46 6f 73 gn="center">.Fos
0020: 73 69 6c 20 43 6f 6e 63 65 70 74 73 0a 3c 2f 68 sil Concepts.</h
0030: 31 3e 0a 0a 3c 68 32 3e 31 2e 30 20 49 6e 74 72 1>..<h2>1.0 Intr
0040: 6f 64 75 63 74 69 6f 6e 3c 2f 68 32 3e 0a 3c 70 oduction</h2>.<p
0050: 3e 0a 3c 61 20 68 72 65 66 3d 22 69 6e 64 65 78 >.<a href="index
0060: 2e 68 74 6d 6c 22 3e 46 6f 73 73 69 6c 3c 2f 61 .html">Fossil</a
0070: 3e 20 69 73 20 61 0a 3c 61 20 68 72 65 66 3d 22 > is a.<a href="
0080: 68 74 74 70 3a 2f 2f 65 6e 2e 77 69 6b 69 70 65 http://en.wikipe
0090: 64 69 61 2e 6f 72 67 2f 77 69 6b 69 2f 53 6f 66 dia.org/wiki/Sof
00a0: 74 77 61 72 65 5f 63 6f 6e 66 69 67 75 72 61 74 tware_configurat
00b0: 69 6f 6e 5f 6d 61 6e 61 67 65 6d 65 6e 74 22 3e ion_management">
00c0: 0a 73 6f 66 74 77 61 72 65 20 63 6f 6e 66 69 67 .software config
00d0: 75 72 61 74 69 6f 6e 20 6d 61 6e 61 67 65 6d 65 uration manageme
00e0: 6e 74 3c 2f 61 3e 20 73 79 73 74 65 6d 2e 0a 46 nt</a> system..F
00f0: 6f 73 73 69 6c 20 69 73 20 73 6f 66 74 77 61 72 ossil is softwar
0100: 65 20 74 68 61 74 20 69 73 20 64 65 73 69 67 6e e that is design
0110: 65 64 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 61 6e ed to control an
0120: 64 20 74 72 61 63 6b 20 74 68 65 0a 64 65 76 65 d track the.deve
0130: 6c 6f 70 6d 65 6e 74 20 6f 66 20 61 20 73 6f 66 lopment of a sof
0140: 74 77 61 72 65 20 70 72 6f 6a 65 63 74 20 61 6e tware project an
0150: 64 20 74 6f 20 72 65 63 6f 72 64 20 74 68 65 20 d to record the
0160: 68 69 73 74 6f 72 79 0a 6f 66 20 74 68 65 20 70 history.of the p
0170: 72 6f 6a 65 63 74 2e 0a 54 68 65 72 65 20 61 72 roject..There ar
0180: 65 20 6d 61 6e 79 20 73 75 63 68 20 73 79 73 74 e many such syst
0190: 65 6d 73 20 69 6e 20 75 73 65 20 74 6f 64 61 79 ems in use today
01a0: 2e 20 20 46 6f 73 73 69 6c 20 73 74 72 69 76 65 . Fossil strive
01b0: 73 20 74 6f 0a 64 69 73 74 69 6e 67 75 69 73 68 s to.distinguish
01c0: 20 69 74 73 65 6c 66 20 66 72 6f 6d 20 74 68 65 itself from the
01d0: 20 6f 74 68 65 72 73 20 62 79 20 62 65 69 6e 67 others by being
01e0: 20 65 78 74 72 65 6d 65 6c 79 20 73 69 6d 70 6c extremely simpl
01f0: 65 0a 74 6f 20 73 65 74 75 70 20 61 6e 64 20 6f e.to setup and o
0200: 70 65 72 61 74 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e perate.</p>..<p>
0210: 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 69 73 This document is
0220: 20 69 6e 74 65 6e 64 65 64 20 61 73 20 61 20 71 intended as a q
0230: 75 69 63 6b 20 69 6e 74 72 6f 64 75 63 74 69 6f uick introductio
0240: 6e 20 74 6f 20 74 68 65 20 63 6f 6e 63 65 70 74 n to the concept
0250: 73 0a 62 65 68 69 6e 64 20 66 6f 73 73 69 6c 2e s.behind fossil.
0260: 3c 2f 70 3e 0a 0a 3c 68 32 3e 32 2e 30 20 43 6f </p>..<h2>2.0 Co
0270: 6d 70 6f 73 69 74 69 6f 6e 20 4f 66 20 41 20 50 mposition Of A P
0280: 72 6f 6a 65 63 74 3c 2f 68 32 3e 0a 3c 69 6d 67 roject</h2>.<img
0290: 20 73 72 63 3d 22 63 6f 6e 63 65 70 74 31 2e 67 src="concept1.g
02a0: 69 66 22 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 if" align="right
02b0: 22 20 68 73 70 61 63 65 3d 22 31 30 22 3e 0a 0a " hspace="10">..
02c0: 3c 70 3e 41 20 73 6f 66 74 77 61 72 65 20 70 72 <p>A software pr
02d0: 6f 6a 65 63 74 20 6e 6f 72 6d 61 6c 6c 79 20 63 oject normally c
02e0: 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 22 73 6f onsists of a "so
02f0: 75 72 63 65 20 74 72 65 65 22 2e 0a 41 20 73 6f urce tree"..A so
0300: 75 72 63 65 20 74 72 65 65 20 69 73 20 61 20 68 urce tree is a h
0310: 69 65 72 61 72 63 68 79 20 6f 66 20 66 69 6c 65 ierarchy of file
0320: 73 20 74 68 61 74 20 61 72 65 20 75 73 65 64 20 s that are used
0330: 74 6f 20 67 65 6e 65 72 61 74 65 0a 74 68 65 20 to generate.the
0340: 65 6e 64 20 70 72 6f 64 75 63 74 2e 20 20 54 68 end product. Th
0350: 65 20 73 6f 75 72 63 65 20 74 72 65 65 20 63 68 e source tree ch
0360: 61 6e 67 65 73 20 6f 76 65 72 20 74 69 6d 65 20 anges over time
0370: 61 73 20 74 68 65 0a 73 6f 66 74 77 61 72 65 20 as the.software
0380: 67 72 6f 77 73 20 61 6e 64 20 65 78 70 61 6e 64 grows and expand
0390: 73 20 61 6e 64 20 61 73 20 66 65 61 74 75 72 65 s and as feature
03a0: 73 20 61 72 65 20 61 64 64 65 64 20 61 6e 64 20 s are added and
03b0: 62 75 67 73 0a 61 72 65 20 66 69 78 65 64 2e 20 bugs.are fixed.
03c0: 20 41 20 73 6e 61 70 73 68 6f 74 20 6f 66 20 74 A snapshot of t
03d0: 68 65 20 73 6f 75 72 63 65 20 74 72 65 65 20 61 he source tree a
03e0: 74 20 61 6e 79 20 70 6f 69 6e 74 20 69 6e 20 74 t any point in t
03f0: 69 6d 65 0a 69 73 20 63 61 6c 6c 65 64 20 61 20 ime.is called a
0400: 22 76 65 72 73 69 6f 6e 22 20 6f 72 20 22 72 65 "version" or "re
0410: 76 69 73 69 6f 6e 22 20 6f 72 20 61 20 22 62 61 vision" or a "ba
0420: 73 65 6c 69 6e 65 22 20 6f 66 20 74 68 65 20 70 seline" of the p
0430: 72 6f 64 75 63 74 2e 0a 49 6e 20 66 6f 73 73 69 roduct..In fossi
0440: 6c 2c 20 77 65 20 75 73 65 20 74 68 65 20 6e 61 l, we use the na
0450: 6d 65 20 22 63 68 65 63 6b 2d 69 6e 22 2e 3c 2f me "check-in".</
0460: 70 3e 0a 0a 3c 70 3e 41 20 22 72 65 70 6f 73 69 p>..<p>A "reposi
0470: 74 6f 72 79 22 20 69 73 20 61 20 64 61 74 61 62 tory" is a datab
0480: 61 73 65 20 74 68 61 74 20 63 6f 6e 74 61 69 6e ase that contain
0490: 73 20 63 6f 70 69 65 73 20 6f 66 20 61 6c 6c 20 s copies of all
04a0: 68 69 73 74 6f 72 69 63 61 6c 0a 63 68 65 63 6b historical.check
04b0: 2d 69 6e 73 20 66 6f 72 20 61 20 70 72 6f 6a 65 -ins for a proje
04c0: 63 74 2e 20 20 43 68 65 63 6b 2d 69 6e 73 20 61 ct. Check-ins a
04d0: 72 65 20 6e 6f 72 6d 61 6c 6c 79 20 73 74 6f 72 re normally stor
04e0: 65 64 20 69 6e 20 74 68 65 0a 72 65 70 6f 73 69 ed in the.reposi
04f0: 74 6f 72 79 20 69 6e 20 61 20 68 69 67 68 6c 79 tory in a highly
0500: 20 73 70 61 63 65 2d 65 66 66 69 63 69 65 6e 74 space-efficient
0510: 20 63 6f 6d 70 72 65 73 73 65 64 20 66 6f 72 6d compressed form
0520: 61 74 20 28 64 65 6c 74 61 20 65 6e 63 6f 64 69 at (delta encodi
0530: 6e 67 29 2e 0a 42 75 74 20 74 68 61 74 20 69 73 ng)..But that is
0540: 20 61 6e 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 an implementati
0550: 6f 6e 20 64 65 74 61 69 6c 20 74 68 61 74 20 79 on detail that y
0560: 6f 75 20 74 68 65 20 75 73 65 72 20 6e 65 65 64 ou the user need
0570: 20 6e 6f 74 20 77 6f 72 72 79 20 6f 76 65 72 2e not worry over.
0580: 0a 54 68 69 6e 6b 20 6f 66 20 74 68 65 20 72 65 .Think of the re
0590: 70 6f 73 69 74 6f 72 79 20 61 73 20 61 20 73 61 pository as a sa
05a0: 66 65 20 70 6c 61 63 65 20 77 68 65 72 65 20 61 fe place where a
05b0: 6c 6c 20 79 6f 75 72 20 6f 6c 64 20 63 68 65 63 ll your old chec
05c0: 6b 2d 69 6e 73 20 61 72 65 0a 73 65 63 75 72 65 k-ins are.secure
05d0: 6c 79 20 73 74 6f 72 65 64 20 61 77 61 79 20 61 ly stored away a
05e0: 6e 64 20 61 76 61 69 6c 61 62 6c 65 20 66 6f 72 nd available for
05f0: 20 72 65 74 72 69 65 76 61 6c 20 77 68 65 6e 65 retrieval whene
0600: 76 65 72 20 79 6f 75 20 6e 65 65 64 0a 74 68 65 ver you need.the
0610: 6d 2e 3c 2f 70 3e 0a 0a 3c 70 3e 41 20 72 65 70 m.</p>..<p>A rep
0620: 6f 73 69 74 6f 72 79 20 69 6e 20 66 6f 73 73 69 ository in fossi
0630: 6c 20 69 73 20 61 20 73 69 6e 67 6c 65 20 66 69 l is a single fi
0640: 6c 65 20 6f 6e 20 79 6f 75 72 20 64 69 73 6b 2e le on your disk.
0650: 20 20 54 68 69 73 20 66 69 6c 65 0a 6d 69 67 68 This file.migh
0660: 74 20 62 65 20 72 61 74 68 65 72 20 6c 61 72 67 t be rather larg
0670: 65 20 28 64 6f 7a 65 6e 73 20 6f 72 20 68 75 6e e (dozens or hun
0680: 64 72 65 64 73 20 6f 66 20 6d 65 67 61 62 79 74 dreds of megabyt
0690: 65 73 20 66 6f 72 20 61 20 6c 61 72 67 65 0a 6f es for a large.o
06a0: 72 20 6c 6f 6e 67 20 72 75 6e 6e 69 6e 67 20 70 r long running p
06b0: 72 6f 6a 65 63 74 29 20 62 75 74 20 69 74 20 69 roject) but it i
06c0: 73 20 6e 65 76 65 72 74 68 65 6c 65 73 73 20 6a s nevertheless j
06d0: 75 73 74 20 61 20 66 69 6c 65 2e 20 20 59 6f 75 ust a file. You
06e0: 0a 63 61 6e 20 6d 6f 76 65 20 69 74 20 61 72 6f .can move it aro
06f0: 75 6e 64 2c 20 72 65 6e 61 6d 65 20 69 74 2c 20 und, rename it,
0700: 77 72 69 74 65 20 69 74 20 6f 75 74 20 74 6f 20 write it out to
0710: 61 20 6d 65 6d 6f 72 79 20 73 74 69 63 6b 2c 20 a memory stick,
0720: 6f 72 0a 64 6f 20 61 6e 79 74 68 69 6e 67 20 65 or.do anything e
0730: 6c 73 65 20 79 6f 75 20 6e 6f 72 6d 61 6c 6c 79 lse you normally
0740: 20 64 6f 20 77 69 74 68 20 66 69 6c 65 73 2e 3c do with files.<
0750: 2f 70 3e 0a 0a 3c 70 3e 45 61 63 68 20 73 6f 75 /p>..<p>Each sou
0760: 72 63 65 20 74 72 65 65 20 74 68 61 74 20 69 73 rce tree that is
0770: 20 63 6f 6e 74 72 6f 6c 6c 65 64 20 62 79 20 66 controlled by f
0780: 6f 73 73 69 6c 20 69 73 20 61 73 73 6f 63 69 61 ossil is associa
0790: 74 65 64 20 77 69 74 68 0a 61 20 73 69 6e 67 6c ted with.a singl
07a0: 65 20 72 65 70 6f 73 69 74 6f 72 79 20 6f 6e 20 e repository on
07b0: 74 68 65 20 6c 6f 63 61 6c 20 64 69 73 6b 20 64 the local disk d
07c0: 72 69 76 65 2e 20 20 59 6f 75 20 63 61 6e 20 74 rive. You can t
07d0: 69 65 20 74 77 6f 20 6f 72 20 6d 6f 72 65 0a 73 ie two or more.s
07e0: 6f 75 72 63 65 20 74 72 65 65 73 20 74 6f 20 61 ource trees to a
07f0: 20 73 69 6e 67 6c 65 20 72 65 70 6f 73 69 74 6f single reposito
0800: 72 79 20 69 66 20 79 6f 75 20 77 61 6e 74 20 28 ry if you want (
0810: 74 68 6f 75 67 68 20 6f 6e 65 0a 74 72 65 65 20 though one.tree
0820: 70 65 72 20 72 65 70 6f 73 69 74 6f 72 79 20 69 per repository i
0830: 73 20 74 68 65 20 6d 6f 73 74 20 63 6f 6d 6d 6f s the most commo
0840: 6e 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e n configuration.
0850: 29 20 20 53 6f 20 61 0a 73 69 6e 67 6c 65 20 72 ) So a.single r
0860: 65 70 6f 73 69 74 6f 72 79 20 63 61 6e 20 62 65 epository can be
0870: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 associated with
0880: 20 6d 61 6e 79 20 73 6f 75 72 63 65 20 74 72 65 many source tre
0890: 65 73 2c 20 62 75 74 0a 65 61 63 68 20 73 6f 75 es, but.each sou
08a0: 72 63 65 20 74 72 65 65 20 69 73 20 61 73 73 6f rce tree is asso
08b0: 63 69 61 74 65 64 20 77 69 74 68 20 6f 6e 6c 79 ciated with only
08c0: 20 6f 6e 65 20 72 65 70 6f 73 69 74 6f 72 79 2e one repository.
08d0: 3c 2f 70 3e 0a 0a 3c 70 3e 46 6f 73 73 69 6c 20 </p>..<p>Fossil
08e0: 73 6f 75 72 63 65 20 74 72 65 65 73 20 6d 61 79 source trees may
08f0: 20 6e 6f 74 20 6f 76 65 72 6c 61 70 2e 20 20 41 not overlap. A
0900: 20 66 6f 73 73 69 6c 20 73 6f 75 72 63 65 20 74 fossil source t
0910: 72 65 65 20 69 73 20 69 64 65 6e 74 69 66 69 65 ree is identifie
0920: 64 0a 62 79 20 61 20 66 69 6c 65 20 6e 61 6d 65 d.by a file name
0930: 64 20 22 5f 46 4f 53 53 49 4c 5f 22 20 69 6e 20 d "_FOSSIL_" in
0940: 74 68 65 20 72 6f 6f 74 20 64 69 72 65 63 74 6f the root directo
0950: 72 79 20 6f 66 20 74 68 65 20 73 6f 75 72 63 65 ry of the source
0960: 20 74 72 65 65 2e 20 20 45 76 65 72 79 0a 66 69 tree. Every.fi
0970: 6c 65 20 74 68 61 74 20 69 73 20 61 20 73 69 62 le that is a sib
0980: 6c 69 6e 67 20 6f 66 20 5f 46 4f 53 53 49 4c 5f ling of _FOSSIL_
0990: 20 61 6e 64 20 65 76 65 72 79 20 66 69 6c 65 20 and every file
09a0: 69 6e 20 65 76 65 72 79 20 73 75 62 66 6f 6c 64 in every subfold
09b0: 65 72 20 69 73 0a 63 6f 6e 73 69 64 65 72 65 64 er is.considered
09c0: 20 70 6f 74 65 6e 74 69 61 6c 6c 79 20 61 20 70 potentially a p
09d0: 61 72 74 20 6f 66 20 74 68 65 20 73 6f 75 72 63 art of the sourc
09e0: 65 20 74 72 65 65 2e 20 20 54 68 65 20 5f 46 4f e tree. The _FO
09f0: 53 53 49 4c 5f 20 66 69 6c 65 0a 63 6f 6e 74 61 SSIL_ file.conta
0a00: 69 6e 73 20 28 61 6d 6f 6e 67 20 6f 74 68 65 72 ins (among other
0a10: 20 74 68 69 6e 67 73 29 20 74 68 65 20 70 61 74 things) the pat
0a20: 68 6e 61 6d 65 20 6f 66 20 74 68 65 20 72 65 70 hname of the rep
0a30: 6f 73 69 74 6f 72 79 20 77 69 74 68 20 77 68 69 ository with whi
0a40: 63 68 0a 74 68 65 20 73 6f 75 72 63 65 20 74 72 ch.the source tr
0a50: 65 65 20 69 73 20 61 73 73 6f 63 69 61 74 65 64 ee is associated
0a60: 2e 20 20 4f 6e 20 74 68 65 20 6f 74 68 65 72 20 . On the other
0a70: 68 61 6e 64 2c 20 74 68 65 20 72 65 70 6f 73 69 hand, the reposi
0a80: 74 6f 72 79 20 68 61 73 0a 6e 6f 20 72 65 63 6f tory has.no reco
0a90: 72 64 20 6f 66 20 69 74 73 20 73 6f 75 72 63 65 rd of its source
0aa0: 20 74 72 65 65 73 2e 20 20 53 6f 20 79 6f 75 20 trees. So you
0ab0: 61 72 65 20 66 72 65 65 20 74 6f 20 64 65 6c 65 are free to dele
0ac0: 74 65 20 61 20 73 6f 75 72 63 65 20 74 72 65 65 te a source tree
0ad0: 0a 6f 72 20 6d 6f 76 65 20 69 74 20 61 72 6f 75 .or move it arou
0ae0: 6e 64 20 77 69 74 68 6f 75 74 20 63 6f 6e 73 65 nd without conse
0af0: 71 75 65 6e 63 65 2e 20 20 42 75 74 20 69 66 20 quence. But if
0b00: 79 6f 75 20 6d 6f 76 65 20 6f 72 20 72 65 6e 61 you move or rena
0b10: 6d 65 20 6f 72 0a 64 65 6c 65 74 65 20 61 20 72 me or.delete a r
0b20: 65 70 6f 73 69 74 6f 72 79 2c 20 74 68 65 6e 20 epository, then
0b30: 61 6e 79 20 73 6f 75 72 63 65 20 74 72 65 65 73 any source trees
0b40: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 associated with
0b50: 20 74 68 61 74 20 72 65 70 6f 73 69 74 6f 72 79 that repository
0b60: 0a 77 69 6c 6c 20 6e 6f 20 6c 6f 6e 67 65 72 20 .will no longer
0b70: 62 65 20 61 62 6c 65 20 74 6f 20 6c 6f 63 61 74 be able to locat
0b80: 65 20 74 68 65 69 72 20 72 65 70 6f 73 69 74 6f e their reposito
0b90: 72 79 20 61 6e 64 20 77 69 6c 6c 20 73 74 6f 70 ry and will stop
0ba0: 20 77 6f 72 6b 69 6e 67 2e 3c 2f 70 3e 0a 0a 3c working.</p>..<
0bb0: 70 3e 57 68 65 6e 20 6d 75 6c 74 69 70 6c 65 20 p>When multiple
0bc0: 64 65 76 65 6c 6f 70 65 72 73 20 61 72 65 20 77 developers are w
0bd0: 6f 72 6b 69 6e 67 20 6f 6e 20 74 68 65 20 73 61 orking on the sa
0be0: 6d 65 20 70 72 6f 6a 65 63 74 2c 20 65 61 63 68 me project, each
0bf0: 0a 64 65 76 65 6c 6f 70 65 72 20 74 79 70 69 63 .developer typic
0c00: 61 6c 6c 79 20 68 61 73 20 68 69 73 20 6f 72 20 ally has his or
0c10: 68 65 72 20 6f 77 6e 20 6c 6f 63 61 6c 20 72 65 her own local re
0c20: 70 6f 73 69 74 6f 72 79 20 61 6e 64 20 61 6e 20 pository and an
0c30: 61 73 73 6f 63 69 61 74 65 64 0a 73 6f 75 72 63 associated.sourc
0c40: 65 20 74 72 65 65 20 69 6e 20 77 68 69 63 68 20 e tree in which
0c50: 74 6f 20 77 6f 72 6b 2e 20 20 44 65 76 65 6c 6f to work. Develo
0c60: 70 65 72 73 20 73 68 61 72 65 20 74 68 65 69 72 pers share their
0c70: 20 77 6f 72 6b 20 62 79 0a 22 73 79 6e 63 69 6e work by."syncin
0c80: 67 22 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f g" the content o
0c90: 66 20 74 68 65 69 72 20 6c 6f 63 61 6c 20 72 65 f their local re
0ca0: 70 6f 73 69 74 6f 72 69 65 73 20 65 69 74 68 65 positories eithe
0cb0: 72 20 64 69 72 65 63 74 6c 79 0a 6f 72 20 74 68 r directly.or th
0cc0: 72 6f 75 67 68 20 61 20 63 65 6e 74 72 61 6c 20 rough a central
0cd0: 73 65 72 76 65 72 2e 20 20 43 68 61 6e 67 65 73 server. Changes
0ce0: 20 63 61 6e 20 22 70 75 73 68 22 20 66 72 6f 6d can "push" from
0cf0: 20 74 68 65 20 6c 6f 63 61 6c 0a 72 65 70 6f 73 the local.repos
0d00: 69 74 6f 72 79 20 69 6e 74 6f 20 61 20 72 65 6d itory into a rem
0d10: 6f 74 65 20 72 65 70 6f 73 69 74 6f 72 79 2e 20 ote repository.
0d20: 20 4f 72 20 63 68 61 6e 67 65 73 20 63 61 6e 20 Or changes can
0d30: 22 70 75 6c 6c 22 20 66 72 6f 6d 20 61 0a 72 65 "pull" from a.re
0d40: 6d 6f 74 65 20 72 65 70 6f 73 69 74 6f 72 79 20 mote repository
0d50: 69 6e 74 6f 20 61 20 6c 6f 63 61 6c 20 72 65 70 into a local rep
0d60: 6f 73 69 74 6f 72 79 2e 20 20 4f 72 20 6f 6e 65 ository. Or one
0d70: 20 63 61 6e 20 64 6f 20 61 20 22 73 79 6e 63 22 can do a "sync"
0d80: 0a 77 68 69 63 68 20 69 73 20 61 20 73 68 6f 72 .which is a shor
0d90: 74 63 75 74 20 66 6f 72 20 64 6f 69 6e 67 20 62 tcut for doing b
0da0: 6f 74 68 20 61 20 70 75 73 68 20 61 6e 64 20 61 oth a push and a
0db0: 20 70 75 6c 6c 20 61 74 20 74 68 65 20 73 61 6d pull at the sam
0dc0: 65 20 74 69 6d 65 2e 0a 46 6f 73 73 69 6c 20 61 e time..Fossil a
0dd0: 6c 73 6f 20 68 61 73 20 74 68 65 20 63 6f 6e 63 lso has the conc
0de0: 65 70 74 20 6f 66 20 22 63 6c 6f 6e 69 6e 67 22 ept of "cloning"
0df0: 2e 20 20 41 20 22 63 6c 6f 6e 65 22 20 69 73 20 . A "clone" is
0e00: 6c 69 6b 65 20 61 20 22 70 75 6c 6c 22 2c 0a 65 like a "pull",.e
0e10: 78 63 65 70 74 20 74 68 61 74 20 69 6e 73 74 65 xcept that inste
0e20: 61 64 20 6f 66 20 62 65 67 69 6e 6e 69 6e 67 20 ad of beginning
0e30: 77 69 74 68 20 61 6e 20 65 78 69 73 74 69 6e 67 with an existing
0e40: 20 6c 6f 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 local repositor
0e50: 79 2c 0a 61 20 63 6c 6f 6e 65 20 62 65 67 69 6e y,.a clone begin
0e60: 73 20 77 69 74 68 20 6e 6f 74 68 69 6e 67 20 61 s with nothing a
0e70: 6e 64 20 63 72 65 61 74 65 73 20 61 20 6e 65 77 nd creates a new
0e80: 20 6c 6f 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 local repositor
0e90: 79 20 74 68 61 74 0a 69 73 20 61 20 64 75 70 6c y that.is a dupl
0ea0: 69 63 61 74 65 20 6f 66 20 61 20 72 65 6d 6f 74 icate of a remot
0eb0: 65 20 72 65 70 6f 73 69 74 6f 72 79 2e 3c 2f 70 e repository.</p
0ec0: 3e 0a 0a 3c 70 3e 43 6f 6d 6d 75 6e 69 63 61 74 >..<p>Communicat
0ed0: 69 6f 6e 20 62 65 74 77 65 65 6e 20 72 65 70 6f ion between repo
0ee0: 73 69 74 6f 72 69 65 73 20 69 73 20 76 69 61 20 sitories is via
0ef0: 48 54 54 50 2e 20 20 52 65 6d 6f 74 65 0a 72 65 HTTP. Remote.re
0f00: 70 6f 73 69 74 6f 72 69 65 73 20 61 72 65 20 69 positories are i
0f10: 64 65 6e 74 69 66 69 65 64 20 62 79 20 55 52 4c dentified by URL
0f20: 2e 20 20 59 6f 75 20 63 61 6e 20 61 6c 73 6f 20 . You can also
0f30: 70 6f 69 6e 74 20 61 20 77 65 62 20 62 72 6f 77 point a web brow
0f40: 73 65 72 0a 61 74 20 61 20 72 65 70 6f 73 69 74 ser.at a reposit
0f50: 6f 72 79 20 61 6e 64 20 67 65 74 20 68 75 6d 61 ory and get huma
0f60: 6e 2d 72 65 61 64 61 62 6c 65 20 73 74 61 74 75 n-readable statu
0f70: 73 2c 20 68 69 73 74 6f 72 79 2c 20 61 6e 64 20 s, history, and
0f80: 74 72 61 63 6b 69 6e 67 0a 69 6e 66 6f 72 6d 61 tracking.informa
0f90: 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 70 tion about the p
0fa0: 72 6f 6a 65 63 74 2e 3c 2f 70 3e 0a 0a 3c 68 33 roject.</p>..<h3
0fb0: 3e 32 2e 31 20 49 64 65 6e 74 69 66 69 63 61 74 >2.1 Identificat
0fc0: 69 6f 6e 20 4f 66 20 41 72 74 69 66 61 63 74 73 ion Of Artifacts
0fd0: 3c 2f 68 33 3e 0a 0a 3c 70 3e 41 20 70 61 72 74 </h3>..<p>A part
0fe0: 69 63 75 6c 61 72 20 76 65 72 73 69 6f 6e 20 6f icular version o
0ff0: 66 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 66 f a particular f
1000: 69 6c 65 20 69 73 20 63 61 6c 6c 65 64 20 61 6e ile is called an
1010: 20 22 61 72 74 69 66 61 63 74 22 2e 0a 45 61 63 "artifact"..Eac
1020: 68 20 61 72 74 69 66 61 63 74 20 68 61 73 20 61 h artifact has a
1030: 20 75 6e 69 76 65 72 73 61 6c 6c 79 20 75 6e 69 universally uni
1040: 71 75 65 20 6e 61 6d 65 20 77 68 69 63 68 20 69 que name which i
1050: 73 20 74 68 65 0a 3c 61 20 68 72 65 66 3d 22 68 s the.<a href="h
1060: 74 74 70 3a 2f 2f 65 6e 2e 77 69 6b 69 70 65 64 ttp://en.wikiped
1070: 69 61 2e 6f 72 67 2f 77 69 6b 69 2f 53 48 41 22 ia.org/wiki/SHA"
1080: 3e 53 48 41 31 3c 2f 61 3e 20 68 61 73 68 20 6f >SHA1</a> hash o
1090: 66 20 74 68 65 20 63 6f 6e 74 65 6e 74 0a 6f 66 f the content.of
10a0: 20 74 68 61 74 20 66 69 6c 65 20 65 78 70 72 65 that file expre
10b0: 73 73 65 64 20 61 73 20 34 30 20 63 68 61 72 61 ssed as 40 chara
10c0: 63 74 65 72 73 20 6f 66 20 6c 6f 77 65 72 2d 63 cters of lower-c
10d0: 61 73 65 20 68 65 78 61 64 65 63 69 6d 61 6c 2e ase hexadecimal.
10e0: 20 20 53 75 63 68 0a 61 20 68 61 73 68 20 69 73 Such.a hash is
10f0: 20 72 65 66 65 72 72 65 64 20 74 6f 20 61 73 20 referred to as
1100: 74 68 65 20 41 72 74 69 66 61 63 74 20 49 64 65 the Artifact Ide
1110: 6e 74 69 66 69 65 72 20 6f 72 20 41 72 74 69 66 ntifier or Artif
1120: 61 63 74 20 49 44 0a 66 6f 72 20 74 68 65 20 61 act ID.for the a
1130: 72 74 69 66 61 63 74 2e 20 20 54 68 65 20 53 48 rtifact. The SH
1140: 41 31 20 61 6c 67 6f 72 69 74 68 6d 20 69 73 20 A1 algorithm is
1150: 63 72 65 61 74 65 64 20 77 69 74 68 20 74 68 65 created with the
1160: 20 70 75 72 70 6f 73 65 20 6f 66 0a 70 72 6f 76 purpose of.prov
1170: 69 64 69 6e 67 20 61 20 68 69 67 68 6c 79 20 66 iding a highly f
1180: 6f 72 67 65 72 79 2d 72 65 73 69 73 74 61 6e 74 orgery-resistant
1190: 20 69 64 65 6e 74 69 66 69 65 72 20 66 6f 72 20 identifier for
11a0: 61 20 66 69 6c 65 2e 20 20 47 69 76 65 6e 20 61 a file. Given a
11b0: 6e 79 0a 66 69 6c 65 20 69 74 20 69 73 20 73 69 ny.file it is si
11c0: 6d 70 6c 65 20 74 6f 20 66 69 6e 64 20 74 68 65 mple to find the
11d0: 20 61 72 74 69 66 61 63 74 20 49 44 20 66 6f 72 artifact ID for
11e0: 20 74 68 61 74 20 66 69 6c 65 2e 20 20 42 75 74 that file. But
11f0: 20 67 69 76 65 6e 20 61 0a 61 72 74 69 66 61 63 given a.artifac
1200: 74 20 49 44 20 69 74 20 69 73 20 63 6f 6d 70 75 t ID it is compu
1210: 74 61 74 69 6f 6e 61 6c 6c 79 20 69 6e 74 72 61 tationally intra
1220: 63 74 61 62 6c 65 20 74 6f 20 67 65 6e 65 72 61 ctable to genera
1230: 74 65 20 61 20 66 69 6c 65 20 74 68 61 74 20 77 te a file that w
1240: 69 6c 6c 0a 68 61 76 65 20 74 68 61 74 20 41 72 ill.have that Ar
1250: 74 69 66 61 63 74 20 49 44 2e 3c 2f 70 3e 0a 0a tifact ID.</p>..
1260: 0a 3c 70 3e 41 72 74 69 66 61 63 74 20 49 44 73 .<p>Artifact IDs
1270: 20 6c 6f 6f 6b 20 73 6f 6d 65 74 68 69 6e 67 20 look something
1280: 6c 69 6b 65 20 74 68 69 73 3a 3c 2f 70 3e 0a 0a like this:</p>..
1290: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 62 3e 0a <blockquote><b>.
12a0: 36 30 38 39 66 30 62 35 36 33 61 39 64 62 30 61 6089f0b563a9db0a
12b0: 36 64 39 30 36 38 32 66 65 34 37 66 64 37 31 36 6d90682fe47fd716
12c0: 31 66 66 38 36 37 63 38 3c 62 72 3e 0a 35 39 37 1ff867c8<br>.597
12d0: 31 32 36 31 34 61 31 62 33 63 63 66 64 38 34 30 12614a1b3ccfd840
12e0: 37 38 61 33 37 66 61 35 62 36 30 36 65 32 38 34 78a37fa5b606e284
12f0: 33 34 33 32 36 3c 62 72 3e 0a 31 39 64 62 66 37 34326<br>.19dbf7
1300: 33 30 37 38 62 65 39 37 37 39 65 64 64 36 61 30 3078be9779edd6a0
1310: 31 35 36 31 39 35 65 36 31 30 66 38 31 63 39 34 156195e610f81c94
1320: 66 39 3c 62 72 3e 0a 62 34 31 30 34 39 35 39 61 f9<br>.b4104959a
1330: 36 37 31 37 35 66 30 32 64 36 62 34 31 35 34 38 67175f02d6b41548
1340: 30 62 65 32 32 61 32 33 39 66 31 66 30 37 37 3c 0be22a239f1f077<
1350: 62 72 3e 0a 39 39 37 63 39 64 36 61 65 30 33 61 br>.997c9d6ae03a
1360: 64 31 31 34 62 32 62 35 37 66 30 34 65 39 65 65 d114b2b57f04e9ee
1370: 65 66 31 37 64 63 62 38 32 37 38 38 0a 3c 2f 62 ef17dcb82788.</b
1380: 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a ></blockquote>..
1390: 3c 70 3e 57 68 65 6e 20 72 65 66 65 72 72 69 6e <p>When referrin
13a0: 67 20 74 6f 20 61 6e 20 61 72 74 69 66 61 63 74 g to an artifact
13b0: 20 75 73 69 6e 67 20 66 6f 73 73 69 6c 2c 20 79 using fossil, y
13c0: 6f 75 20 63 61 6e 20 75 73 65 20 61 20 75 6e 69 ou can use a uni
13d0: 71 75 65 0a 70 72 65 66 69 78 20 6f 66 20 74 68 que.prefix of th
13e0: 65 20 61 72 74 69 66 61 63 74 20 49 44 20 74 68 e artifact ID th
13f0: 61 74 20 69 73 20 66 6f 75 72 20 63 68 61 72 61 at is four chara
1400: 63 74 65 72 73 20 6f 72 20 6c 6f 6e 67 65 72 2e cters or longer.
1410: 20 20 54 68 69 73 20 73 61 76 65 73 0a 61 20 6c This saves.a l
1420: 6f 74 20 6f 66 20 74 79 70 69 6e 67 2e 20 20 57 ot of typing. W
1430: 68 65 6e 20 64 69 73 70 6c 61 79 69 6e 67 20 61 hen displaying a
1440: 72 74 69 66 61 63 74 20 49 44 73 2c 20 66 6f 73 rtifact IDs, fos
1450: 73 69 6c 20 77 69 6c 6c 20 75 73 75 61 6c 6c 79 sil will usually
1460: 20 6f 6e 6c 79 0a 73 68 6f 77 20 74 68 65 20 66 only.show the f
1470: 69 72 73 74 20 31 30 20 64 69 67 69 74 73 20 73 irst 10 digits s
1480: 69 6e 63 65 20 74 68 61 74 20 69 73 20 6e 6f 72 ince that is nor
1490: 6d 61 6c 6c 79 20 65 6e 6f 75 67 68 20 74 6f 20 mally enough to
14a0: 75 6e 69 71 75 65 6c 79 0a 69 64 65 6e 74 69 66 uniquely.identif
14b0: 79 20 61 20 66 69 6c 65 2e 3c 2f 70 3e 0a 0a 3c y a file.</p>..<
14c0: 70 3e 43 68 61 6e 67 69 6e 67 20 28 6f 72 20 61 p>Changing (or a
14d0: 64 64 69 6e 67 20 6f 72 20 72 65 6d 6f 76 69 6e dding or removin
14e0: 67 29 20 61 20 73 69 6e 67 6c 65 20 62 79 74 65 g) a single byte
14f0: 20 69 6e 20 61 20 66 69 6c 65 20 72 65 73 75 6c in a file resul
1500: 74 73 0a 69 6e 20 61 20 63 6f 6d 70 6c 65 74 65 ts.in a complete
1510: 6c 79 20 64 69 66 66 65 72 65 6e 74 20 61 72 74 ly different art
1520: 69 66 61 63 74 20 49 44 2e 20 20 41 6e 64 20 73 ifact ID. And s
1530: 69 6e 63 65 20 74 68 65 20 61 72 74 69 66 61 63 ince the artifac
1540: 74 20 49 44 20 69 73 20 74 68 65 20 6e 61 6d 65 t ID is the name
1550: 20 6f 66 0a 74 68 65 20 61 72 74 69 66 61 63 74 of.the artifact
1560: 2c 20 6d 61 6b 69 6e 67 20 61 6e 79 20 63 68 61 , making any cha
1570: 6e 67 65 20 74 6f 20 61 20 66 69 6c 65 20 72 65 nge to a file re
1580: 73 75 6c 74 73 20 69 6e 20 61 20 6e 65 77 20 61 sults in a new a
1590: 72 74 69 66 61 63 74 2e 0a 49 6e 20 74 68 69 73 rtifact..In this
15a0: 20 77 61 79 2c 20 61 72 74 69 66 61 63 74 73 20 way, artifacts
15b0: 61 72 65 20 69 6d 6d 75 74 61 62 6c 65 2e 3c 2f are immutable.</
15c0: 70 3e 0a 0a 3c 70 3e 41 20 72 65 70 6f 73 69 74 p>..<p>A reposit
15d0: 6f 72 79 20 69 73 20 72 65 61 6c 6c 79 20 6a 75 ory is really ju
15e0: 73 74 20 61 6e 20 75 6e 6f 72 64 65 72 65 64 20 st an unordered
15f0: 63 6f 6c 6c 65 63 74 69 6f 6e 20 6f 66 0a 61 72 collection of.ar
1600: 74 69 66 61 63 74 73 2e 20 20 4e 65 77 20 61 72 tifacts. New ar
1610: 74 69 66 61 63 74 73 20 63 61 6e 20 62 65 20 61 tifacts can be a
1620: 64 64 65 64 20 74 6f 20 74 68 65 20 72 65 70 6f dded to the repo
1630: 73 69 74 6f 72 79 2c 20 62 75 74 0a 65 78 69 73 sitory, but.exis
1640: 74 69 6e 67 20 61 72 74 69 66 61 63 74 73 20 63 ting artifacts c
1650: 61 6e 20 6e 65 76 65 72 20 62 65 20 72 65 6d 6f an never be remo
1660: 76 65 64 2e 20 20 46 6f 73 73 69 6c 20 69 73 20 ved. Fossil is
1670: 64 65 73 69 67 6e 65 64 20 69 6e 0a 73 75 63 68 designed in.such
1680: 20 61 20 77 61 79 20 74 68 61 74 20 69 74 20 63 a way that it c
1690: 61 6e 20 62 65 20 68 61 6e 64 65 64 20 61 20 73 an be handed a s
16a0: 65 74 20 6f 66 20 61 72 74 69 66 61 63 74 73 20 et of artifacts
16b0: 69 6e 20 61 6e 79 0a 6f 72 64 65 72 20 61 6e 64 in any.order and
16c0: 20 69 74 20 63 61 6e 20 66 69 67 75 72 65 20 6f it can figure o
16d0: 75 74 20 74 68 65 20 72 65 6c 61 74 69 6f 6e 73 ut the relations
16e0: 68 69 70 20 62 65 74 77 65 65 6e 20 74 68 6f 73 hip between thos
16f0: 65 0a 61 72 74 69 66 61 63 74 73 20 61 6e 64 20 e.artifacts and
1700: 72 65 63 6f 6e 73 74 72 75 63 74 20 74 68 65 20 reconstruct the
1710: 63 6f 6d 70 6c 65 74 65 20 64 65 76 65 6c 6f 70 complete develop
1720: 6d 65 6e 74 20 68 69 73 74 6f 72 79 20 6f 66 0a ment history of.
1730: 61 20 73 6f 66 74 77 61 72 65 20 70 72 6f 6a 65 a software proje
1740: 63 74 2e 3c 2f 70 3e 0a 0a 3c 68 33 3e 32 2e 32 ct.</p>..<h3>2.2
1750: 20 4d 61 6e 69 66 65 73 74 73 3c 2f 68 33 3e 0a Manifests</h3>.
1760: 0a 3c 70 3e 41 74 20 74 68 65 20 72 6f 6f 74 20 .<p>At the root
1770: 6f 66 20 61 20 73 6f 75 72 63 65 20 74 72 65 65 of a source tree
1780: 20 69 73 20 61 20 73 70 65 63 69 61 6c 20 66 69 is a special fi
1790: 6c 65 20 63 61 6c 6c 65 64 20 74 68 65 0a 22 6d le called the."m
17a0: 61 6e 69 66 65 73 74 22 2e 20 20 54 68 65 20 6d anifest". The m
17b0: 61 6e 69 66 65 73 74 20 69 73 20 61 20 6c 69 73 anifest is a lis
17c0: 74 69 6e 67 20 6f 66 20 61 6c 6c 20 6f 74 68 65 ting of all othe
17d0: 72 20 66 69 6c 65 73 20 69 6e 0a 74 68 61 74 20 r files in.that
17e0: 73 6f 75 72 63 65 20 74 72 65 65 2e 20 20 54 68 source tree. Th
17f0: 65 20 6d 61 6e 69 66 65 73 74 20 63 6f 6e 74 61 e manifest conta
1800: 69 6e 73 20 74 68 65 20 28 63 6f 6d 70 6c 65 74 ins the (complet
1810: 65 29 20 61 72 74 69 66 61 63 74 20 49 44 20 0a e) artifact ID .
1820: 6f 66 20 74 68 65 20 66 69 6c 65 20 61 6e 64 20 of the file and
1830: 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 the name of the
1840: 66 69 6c 65 20 61 73 20 69 74 20 61 70 70 65 61 file as it appea
1850: 72 73 20 6f 6e 20 64 69 73 6b 2c 0a 61 6e 64 20 rs on disk,.and
1860: 74 68 75 73 20 73 65 72 76 65 73 20 61 73 20 61 thus serves as a
1870: 20 6d 61 70 70 69 6e 67 20 66 72 6f 6d 20 61 72 mapping from ar
1880: 74 69 66 61 63 74 20 49 44 20 74 6f 20 64 69 73 tifact ID to dis
1890: 6b 20 6e 61 6d 65 2e 20 20 54 68 65 20 61 72 74 k name. The art
18a0: 69 66 61 63 74 20 49 44 0a 6f 66 20 74 68 65 20 ifact ID.of the
18b0: 6d 61 6e 69 66 65 73 74 20 69 73 20 74 68 65 20 manifest is the
18c0: 69 64 65 6e 74 69 66 69 65 72 20 66 6f 72 20 74 identifier for t
18d0: 68 65 20 65 6e 74 69 72 65 20 63 68 65 63 6b 2d he entire check-
18e0: 69 6e 2e 20 20 57 68 65 6e 0a 79 6f 75 20 6c 6f in. When.you lo
18f0: 6f 6b 20 61 74 20 61 20 22 74 69 6d 65 6c 69 6e ok at a "timelin
1900: 65 22 20 6f 66 20 63 68 61 6e 67 65 73 20 69 6e e" of changes in
1910: 20 66 6f 73 73 69 6c 2c 20 74 68 65 20 49 44 20 fossil, the ID
1920: 61 73 73 6f 63 69 61 74 65 64 0a 77 69 74 68 20 associated.with
1930: 65 61 63 68 20 63 68 65 63 6b 2d 69 6e 20 6f 72 each check-in or
1940: 20 63 6f 6d 6d 69 74 20 69 73 20 72 65 61 6c 6c commit is reall
1950: 79 20 6a 75 73 74 20 74 68 65 20 61 72 74 69 66 y just the artif
1960: 61 63 74 20 49 44 20 6f 66 20 74 68 65 0a 6d 61 act ID of the.ma
1970: 6e 69 66 65 73 74 20 66 6f 72 20 74 68 61 74 20 nifest for that
1980: 63 68 65 63 6b 2d 69 6e 2e 3c 2f 70 3e 0a 0a 3c check-in.</p>..<
1990: 70 3e 46 6f 73 73 69 6c 20 61 75 74 6f 6d 61 74 p>Fossil automat
19a0: 69 63 61 6c 6c 79 20 67 65 6e 65 72 61 74 65 73 ically generates
19b0: 20 61 20 6d 61 6e 69 66 65 73 74 20 77 68 65 6e a manifest when
19c0: 65 76 65 72 20 79 6f 75 20 22 63 6f 6d 6d 69 74 ever you "commit
19d0: 22 20 0a 61 20 6e 65 77 20 63 68 65 63 6b 2d 69 " .a new check-i
19e0: 6e 2e 20 20 53 6f 20 74 68 69 73 20 69 73 20 6e n. So this is n
19f0: 6f 74 20 73 6f 6d 65 74 68 69 6e 67 20 74 68 61 ot something tha
1a00: 74 20 79 6f 75 2c 20 74 68 65 20 64 65 76 65 6c t you, the devel
1a10: 6f 70 65 72 2c 0a 6e 65 65 64 20 74 6f 20 77 6f oper,.need to wo
1a20: 72 72 79 20 77 69 74 68 2e 20 20 54 68 65 20 66 rry with. The f
1a30: 6f 72 6d 61 74 20 6f 66 20 61 20 6d 61 6e 69 66 ormat of a manif
1a40: 65 73 74 20 69 73 20 69 6e 74 65 6e 74 69 6f 6e est is intention
1a50: 61 6c 6c 79 0a 64 65 73 69 67 6e 65 64 20 74 6f ally.designed to
1a60: 20 62 65 20 73 69 6d 70 6c 65 20 74 6f 20 70 61 be simple to pa
1a70: 72 73 65 2c 20 73 6f 20 74 68 61 74 20 69 66 0a rse, so that if.
1a80: 79 6f 75 20 77 61 6e 74 20 74 6f 20 72 65 61 64 you want to read
1a90: 20 61 6e 64 20 69 6e 74 65 72 70 72 65 74 20 61 and interpret a
1aa0: 20 6d 61 6e 69 66 65 73 74 2c 20 65 69 74 68 65 manifest, eithe
1ab0: 72 20 62 79 20 68 61 6e 64 20 6f 72 0a 77 69 74 r by hand or.wit
1ac0: 68 20 61 20 73 63 72 69 70 74 2c 20 74 68 61 74 h a script, that
1ad0: 20 69 73 20 65 61 73 79 20 74 6f 20 64 6f 2e 20 is easy to do.
1ae0: 20 42 75 74 20 79 6f 75 20 77 69 6c 6c 20 70 72 But you will pr
1af0: 6f 62 61 62 6c 79 20 6e 65 76 65 72 0a 6e 65 65 obably never.nee
1b00: 64 20 74 6f 20 64 6f 20 73 6f 2e 3c 2f 70 3e 0a d to do so.</p>.
1b10: 0a 3c 70 3e 49 6e 20 61 64 64 69 74 69 6f 6e 20 .<p>In addition
1b20: 74 6f 20 69 64 65 6e 74 69 66 79 69 6e 67 20 61 to identifying a
1b30: 6c 6c 20 66 69 6c 65 73 20 69 6e 20 74 68 65 20 ll files in the
1b40: 63 68 65 63 6b 2d 69 6e 2c 20 61 0a 6d 61 6e 69 check-in, a.mani
1b50: 66 65 73 74 20 61 6c 73 6f 20 63 6f 6e 74 61 69 fest also contai
1b60: 6e 73 20 61 20 63 68 65 63 6b 2d 69 6e 20 63 6f ns a check-in co
1b70: 6d 6d 65 6e 74 2c 20 74 68 65 20 64 61 74 65 20 mment, the date
1b80: 61 6e 64 20 74 69 6d 65 0a 77 68 65 6e 20 74 68 and time.when th
1b90: 65 20 63 68 65 63 6b 2d 69 6e 20 77 61 73 20 65 e check-in was e
1ba0: 73 74 61 62 6c 69 73 68 65 64 2c 20 77 68 6f 20 stablished, who
1bb0: 63 72 65 61 74 65 64 20 74 68 65 20 63 68 65 63 created the chec
1bc0: 6b 2d 69 6e 2c 0a 61 6e 64 20 6c 69 6e 6b 73 20 k-in,.and links
1bd0: 74 6f 20 6f 74 68 65 72 20 63 68 65 63 6b 2d 69 to other check-i
1be0: 6e 73 20 66 72 6f 6d 20 77 68 69 63 68 20 74 68 ns from which th
1bf0: 65 20 63 75 72 72 65 6e 74 20 63 68 65 63 6b 2d e current check-
1c00: 69 6e 0a 69 73 20 64 65 72 69 76 65 64 2e 20 20 in.is derived.
1c10: 54 68 65 72 65 20 69 73 20 61 6c 73 6f 20 61 20 There is also a
1c20: 63 6f 75 70 6c 65 20 6f 66 20 63 68 65 63 6b 73 couple of checks
1c30: 75 6d 73 20 75 73 65 64 20 74 6f 20 76 65 72 69 ums used to veri
1c40: 66 79 0a 74 68 65 20 69 6e 74 65 67 72 69 74 79 fy.the integrity
1c50: 20 6f 66 20 74 68 65 20 63 68 65 63 6b 2d 69 6e of the check-in
1c60: 2e 20 20 41 6e 64 20 74 68 65 20 77 68 6f 6c 65 . And the whole
1c70: 20 6d 61 6e 69 66 65 73 74 20 6d 69 67 68 74 0a manifest might.
1c80: 62 65 20 50 47 50 20 63 6c 65 61 72 73 69 67 6e be PGP clearsign
1c90: 65 64 2e 3c 2f 70 3e 0a 0a 3c 68 33 3e 32 2e 33 ed.</p>..<h3>2.3
1ca0: 20 4b 65 79 20 63 6f 6e 63 65 70 74 73 3c 2f 68 Key concepts</h
1cb0: 33 3e 0a 0a 3c 75 6c 3e 0a 3c 6c 69 3e 41 20 3c 3>..<ul>.<li>A <
1cc0: 62 3e 63 68 65 63 6b 2d 69 6e 3c 2f 62 3e 20 69 b>check-in</b> i
1cd0: 73 20 61 20 73 65 74 20 6f 66 20 66 69 6c 65 73 s a set of files
1ce0: 20 61 72 72 61 6e 67 65 64 0a 20 20 20 20 69 6e arranged. in
1cf0: 20 61 20 68 69 65 72 61 72 63 68 79 2e 3c 2f 6c a hierarchy.</l
1d00: 69 3e 0a 3c 6c 69 3e 41 20 3c 62 3e 72 65 70 6f i>.<li>A <b>repo
1d10: 73 69 74 6f 72 79 3c 2f 62 3e 20 6b 65 65 70 73 sitory</b> keeps
1d20: 20 61 20 72 65 63 6f 72 64 20 6f 66 20 68 69 73 a record of his
1d30: 74 6f 72 69 63 61 6c 20 63 68 65 63 6b 2d 69 6e torical check-in
1d40: 73 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 52 65 70 6f s.</li>.<li>Repo
1d50: 73 69 74 6f 72 69 65 73 20 73 68 61 72 65 20 74 sitories share t
1d60: 68 65 69 72 20 63 68 61 6e 67 65 73 20 75 73 69 heir changes usi
1d70: 6e 67 20 3c 62 3e 70 75 73 68 3c 2f 62 3e 2c 20 ng <b>push</b>,
1d80: 3c 62 3e 70 75 6c 6c 3c 2f 62 3e 2c 0a 20 20 20 <b>pull</b>,.
1d90: 20 3c 62 3e 73 79 6e 63 3c 2f 62 3e 2c 20 61 6e <b>sync</b>, an
1da0: 64 20 3c 62 3e 63 6c 6f 6e 65 3c 2f 62 3e 2e 3c d <b>clone</b>.<
1db0: 2f 6c 69 3e 0a 3c 6c 69 3e 41 20 70 61 72 74 69 /li>.<li>A parti
1dc0: 63 75 6c 61 72 20 76 65 72 73 69 6f 6e 20 6f 66 cular version of
1dd0: 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 66 69 a particular fi
1de0: 6c 65 20 69 73 20 61 6e 20 3c 62 3e 61 72 74 69 le is an <b>arti
1df0: 66 61 63 74 3c 2f 62 3e 0a 20 20 20 20 74 68 61 fact</b>. tha
1e00: 74 20 69 73 20 69 64 65 6e 74 69 66 69 65 64 20 t is identified
1e10: 62 79 20 61 6e 20 3c 62 3e 61 72 74 69 66 61 63 by an <b>artifac
1e20: 74 20 49 44 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0a 3c t ID</b>.</li>.<
1e30: 6c 69 3e 41 72 74 69 66 61 63 74 73 20 74 72 61 li>Artifacts tra
1e40: 63 6b 65 64 20 62 79 20 66 6f 73 73 69 6c 20 61 cked by fossil a
1e50: 72 65 20 69 6e 68 65 72 65 6e 74 6c 79 20 69 6d re inherently im
1e60: 6d 75 74 61 62 6c 65 2e 3c 2f 6c 69 3e 0a 3c 6c mutable.</li>.<l
1e70: 69 3e 46 6f 73 73 69 6c 20 61 75 74 6f 6d 61 74 i>Fossil automat
1e80: 69 63 61 6c 6c 79 20 67 65 6e 65 72 61 74 65 73 ically generates
1e90: 20 61 20 3c 62 3e 6d 61 6e 69 66 65 73 74 3c 2f a <b>manifest</
1ea0: 62 3e 20 66 69 6c 65 20 74 68 61 74 20 69 64 65 b> file that ide
1eb0: 6e 74 69 66 69 65 73 0a 20 20 20 20 65 76 65 72 ntifies. ever
1ec0: 79 20 61 72 74 69 66 61 63 74 20 69 6e 20 61 20 y artifact in a
1ed0: 63 68 65 63 6b 2d 69 6e 2e 3c 2f 6c 69 3e 0a 3c check-in.</li>.<
1ee0: 6c 69 3e 54 68 65 20 61 72 74 69 66 61 63 74 20 li>The artifact
1ef0: 49 44 20 6f 66 20 74 68 65 20 6d 61 6e 69 66 65 ID of the manife
1f00: 73 74 20 69 73 20 74 68 65 20 69 64 65 6e 74 69 st is the identi
1f10: 66 69 65 72 20 6f 66 20 74 68 65 20 63 68 65 63 fier of the chec
1f20: 6b 2d 69 6e 2e 3c 2f 6c 69 3e 0a 3c 2f 75 6c 3e k-in.</li>.</ul>
1f30: 0a 0a 3c 68 32 3e 33 2e 30 20 46 6f 73 73 69 6c ..<h2>3.0 Fossil
1f40: 20 2d 20 54 68 65 20 50 72 6f 67 72 61 6d 3c 2f - The Program</
1f50: 68 32 3e 0a 0a 3c 70 3e 46 6f 73 73 69 6c 20 69 h2>..<p>Fossil i
1f60: 73 20 73 6f 66 74 77 61 72 65 2e 20 20 54 68 65 s software. The
1f70: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 implementation
1f80: 6f 66 20 66 6f 73 73 69 6c 20 69 73 20 69 6e 20 of fossil is in
1f90: 74 68 65 20 66 6f 72 6d 0a 6f 66 20 61 20 73 69 the form.of a si
1fa0: 6e 67 6c 65 20 65 78 65 63 75 74 61 62 6c 65 20 ngle executable
1fb0: 6e 61 6d 65 64 20 22 66 6f 73 73 69 6c 22 2e 20 named "fossil".
1fc0: 20 54 6f 20 69 6e 73 74 61 6c 6c 20 66 6f 73 73 To install foss
1fd0: 69 6c 20 6f 6e 20 79 6f 75 72 20 73 79 73 74 65 il on your syste
1fe0: 6d 2c 0a 61 6c 6c 20 79 6f 75 20 68 61 76 65 20 m,.all you have
1ff0: 74 6f 20 64 6f 20 69 73 20 6f 62 74 61 69 6e 20 to do is obtain
2000: 61 20 63 6f 70 79 20 6f 66 20 74 68 69 73 20 6f a copy of this o
2010: 6e 65 20 65 78 65 63 75 74 61 62 6c 65 20 66 69 ne executable fi
2020: 6c 65 20 28 65 69 74 68 65 72 0a 62 79 20 64 6f le (either.by do
2030: 77 6e 6c 6f 61 64 69 6e 67 20 61 20 70 72 65 2d wnloading a pre-
2040: 63 6f 6d 70 69 6c 65 64 20 76 65 72 73 69 6f 6e compiled version
2050: 20 6f 72 20 63 6f 6d 70 69 6c 69 6e 67 20 69 74 or compiling it
2060: 20 79 6f 75 72 73 65 6c 66 29 20 61 6e 64 20 74 yourself) and t
2070: 68 65 6e 0a 70 75 74 74 69 6e 67 20 74 68 61 74 hen.putting that
2080: 20 66 69 6c 65 20 73 6f 6d 65 77 68 65 72 65 20 file somewhere
2090: 6f 6e 20 79 6f 75 72 20 50 41 54 48 2e 3c 2f 70 on your PATH.</p
20a0: 3e 0a 0a 3c 70 3e 46 6f 73 73 69 6c 20 69 73 20 >..<p>Fossil is
20b0: 63 6f 6d 70 6c 65 74 65 6c 79 20 73 65 6c 66 2d completely self-
20c0: 63 6f 6e 74 61 69 6e 65 64 2e 20 20 49 74 20 69 contained. It i
20d0: 73 20 6e 6f 74 20 6e 65 63 65 73 73 61 72 79 20 s not necessary
20e0: 74 6f 0a 69 6e 73 74 61 6c 6c 20 61 6e 79 20 6f to.install any o
20f0: 74 68 65 72 20 73 6f 66 74 77 61 72 65 20 69 6e ther software in
2100: 20 6f 72 64 65 72 20 74 6f 20 75 73 65 20 66 6f order to use fo
2110: 73 73 69 6c 2e 20 20 59 6f 75 20 64 6f 20 3c 75 ssil. You do <u
2120: 3e 6e 6f 74 3c 2f 75 3e 20 6e 65 65 64 0a 43 56 >not</u> need.CV
2130: 53 2c 20 67 7a 69 70 2c 20 64 69 66 66 2c 20 72 S, gzip, diff, r
2140: 73 79 6e 63 2c 20 50 79 74 68 6f 6e 2c 20 50 65 sync, Python, Pe
2150: 72 6c 2c 20 54 63 6c 2c 20 4a 61 76 61 2c 20 61 rl, Tcl, Java, a
2160: 70 61 63 68 65 2c 20 50 6f 73 74 67 72 65 53 51 pache, PostgreSQ
2170: 4c 2c 20 4d 79 53 51 4c 2c 0a 53 51 4c 69 74 65 L, MySQL,.SQLite
2180: 2c 20 70 61 74 63 68 2c 20 6f 72 20 61 6e 79 20 , patch, or any
2190: 73 69 6d 69 6c 61 72 20 73 6f 66 74 77 61 72 65 similar software
21a0: 20 6f 6e 20 79 6f 75 72 20 73 79 73 74 65 6d 20 on your system
21b0: 69 6e 20 6f 72 64 65 72 20 74 6f 20 75 73 65 0a in order to use.
21c0: 66 6f 73 73 69 6c 20 65 66 66 65 63 74 69 76 65 fossil effective
21d0: 6c 79 2e 20 20 59 6f 75 20 77 69 6c 6c 20 77 61 ly. You will wa
21e0: 6e 74 20 74 6f 20 68 61 76 65 20 73 6f 6d 65 20 nt to have some
21f0: 6b 69 6e 64 20 6f 66 20 74 65 78 74 20 65 64 69 kind of text edi
2200: 74 6f 72 0a 66 6f 72 20 65 6e 74 65 72 69 6e 67 tor.for entering
2210: 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d 6d 65 6e check-in commen
2220: 74 73 2e 20 20 46 6f 73 73 69 6c 20 77 69 6c 6c ts. Fossil will
2230: 20 75 73 65 20 77 68 61 74 65 76 65 72 20 74 65 use whatever te
2240: 78 74 20 65 64 69 74 6f 72 0a 69 73 20 69 64 65 xt editor.is ide
2250: 6e 74 69 66 69 65 64 20 62 79 20 79 6f 75 72 20 ntified by your
2260: 56 49 53 55 41 4c 20 65 6e 76 69 72 6f 6e 6d 65 VISUAL environme
2270: 6e 74 20 76 61 72 69 61 62 6c 65 2e 20 20 46 6f nt variable. Fo
2280: 73 73 69 6c 20 77 69 6c 6c 20 61 6c 73 6f 0a 75 ssil will also.u
2290: 73 65 20 47 50 47 20 74 6f 20 63 6c 65 61 72 73 se GPG to clears
22a0: 69 67 6e 20 79 6f 75 72 20 6d 61 6e 69 66 65 73 ign your manifes
22b0: 74 73 20 69 66 20 79 6f 75 20 68 61 70 70 65 6e ts if you happen
22c0: 20 74 6f 20 68 61 76 65 20 69 74 20 69 6e 73 74 to have it inst
22d0: 61 6c 6c 65 64 2c 0a 62 75 74 20 66 6f 73 73 69 alled,.but fossi
22e0: 6c 20 77 69 6c 6c 20 73 6b 69 70 20 74 68 61 74 l will skip that
22f0: 20 73 74 65 70 20 69 66 20 47 50 47 20 6d 69 73 step if GPG mis
2300: 73 69 6e 67 20 66 72 6f 6d 20 79 6f 75 72 20 73 sing from your s
2310: 79 73 74 65 6d 2e 0a 59 6f 75 20 63 61 6e 20 6f ystem..You can o
2320: 70 74 69 6f 6e 61 6c 6c 79 20 73 65 74 20 75 70 ptionally set up
2330: 20 66 6f 73 73 69 6c 20 74 6f 20 75 73 65 20 65 fossil to use e
2340: 78 74 65 72 6e 61 6c 20 22 64 69 66 66 22 20 70 xternal "diff" p
2350: 72 6f 67 72 61 6d 73 2c 20 0a 74 68 6f 75 67 68 rograms, .though
2360: 20 66 6f 73 73 69 6c 20 68 61 73 20 61 6e 20 65 fossil has an e
2370: 78 63 65 6c 6c 65 6e 74 20 62 75 69 6c 74 2d 69 xcellent built-i
2380: 6e 20 22 64 69 66 66 22 20 61 6c 67 6f 72 69 74 n "diff" algorit
2390: 68 6d 20 74 68 61 74 20 77 6f 72 6b 73 0a 66 69 hm that works.fi
23a0: 6e 65 20 66 6f 72 20 6d 6f 73 74 20 70 65 6f 70 ne for most peop
23b0: 6c 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 6f 20 75 le.</p>..<p>To u
23c0: 6e 69 6e 73 74 61 6c 6c 20 66 6f 73 73 69 6c 2c ninstall fossil,
23d0: 20 73 69 6d 70 6c 79 20 64 65 6c 65 74 65 20 74 simply delete t
23e0: 68 65 20 65 78 65 63 75 74 61 62 6c 65 2e 3c 2f he executable.</
23f0: 70 3e 0a 0a 3c 70 3e 54 6f 20 75 70 67 72 61 64 p>..<p>To upgrad
2400: 65 20 61 6e 20 6f 6c 64 65 72 20 76 65 72 73 69 e an older versi
2410: 6f 6e 20 6f 66 20 66 6f 73 73 69 6c 20 74 6f 20 on of fossil to
2420: 61 20 6e 65 77 65 72 20 76 65 72 73 69 6f 6e 2c a newer version,
2430: 20 6a 75 73 74 0a 72 65 70 6c 61 63 65 20 74 68 just.replace th
2440: 65 20 6f 6c 64 20 65 78 65 63 75 74 61 62 6c 65 e old executable
2450: 20 77 69 74 68 20 74 68 65 20 6e 65 77 20 6f 6e with the new on
2460: 65 2e 20 20 59 6f 75 20 6d 69 67 68 74 20 6e 65 e. You might ne
2470: 65 64 20 74 6f 20 0a 72 75 6e 20 61 20 6f 6e 65 ed to .run a one
2480: 2d 74 69 6d 65 20 63 6f 6d 6d 61 6e 64 20 74 6f -time command to
2490: 20 72 65 73 74 72 75 63 74 75 72 65 20 79 6f 75 restructure you
24a0: 72 20 72 65 70 6f 73 69 74 6f 72 69 65 73 20 61 r repositories a
24b0: 66 74 65 72 0a 61 6e 20 75 70 67 72 61 64 65 2e fter.an upgrade.
24c0: 20 20 43 68 65 63 6b 20 74 68 65 20 69 6e 73 74 Check the inst
24d0: 72 75 63 74 69 6f 6e 73 20 74 68 61 74 20 63 6f ructions that co
24e0: 6d 65 20 77 69 74 68 20 74 68 65 20 75 70 67 72 me with the upgr
24f0: 61 64 65 0a 66 6f 72 20 64 65 74 61 69 6c 73 2e ade.for details.
2500: 3c 2f 70 3e 0a 0a 3c 70 3e 54 6f 20 75 73 65 20 </p>..<p>To use
2510: 66 6f 73 73 69 6c 2c 20 73 69 6d 70 6c 79 20 74 fossil, simply t
2520: 79 70 65 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 ype the name of
2530: 74 68 65 20 65 78 65 63 75 74 61 62 6c 65 20 69 the executable i
2540: 6e 20 79 6f 75 72 0a 73 68 65 6c 6c 2c 20 66 6f n your.shell, fo
2550: 6c 6c 6f 77 65 64 20 62 79 20 6f 6e 65 20 6f 66 llowed by one of
2560: 20 74 68 65 20 76 61 72 69 6f 75 73 20 62 75 69 the various bui
2570: 6c 74 2d 69 6e 20 63 6f 6d 6d 61 6e 64 73 20 61 lt-in commands a
2580: 6e 64 0a 61 72 67 75 6d 65 6e 74 73 20 61 70 70 nd.arguments app
2590: 72 6f 70 72 69 61 74 65 20 66 6f 72 20 74 68 61 ropriate for tha
25a0: 74 20 63 6f 6d 6d 61 6e 64 2e 20 20 46 6f 72 20 t command. For
25b0: 65 78 61 6d 70 6c 65 3a 3c 2f 70 3e 0a 0a 3c 62 example:</p>..<b
25c0: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 62 3e 0a 66 6f lockquote><b>.fo
25d0: 73 73 69 6c 20 68 65 6c 70 0a 3c 2f 62 3e 3c 2f ssil help.</b></
25e0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e blockquote>..<p>
25f0: 49 6e 20 74 68 65 20 6e 65 78 74 20 73 65 63 74 In the next sect
2600: 69 6f 6e 2c 20 77 68 65 6e 20 77 65 20 73 61 79 ion, when we say
2610: 20 74 68 69 6e 67 73 20 6c 69 6b 65 20 22 75 73 things like "us
2620: 65 20 74 68 65 20 3c 62 3e 68 65 6c 70 3c 2f 62 e the <b>help</b
2630: 3e 0a 63 6f 6d 6d 61 6e 64 22 20 77 65 20 6d 65 >.command" we me
2640: 61 6e 20 74 6f 20 75 73 65 20 74 68 65 20 63 6f an to use the co
2650: 6d 6d 61 6e 64 20 6e 61 6d 65 20 22 68 65 6c 70 mmand name "help
2660: 22 20 61 73 20 74 68 65 20 66 69 72 73 74 0a 74 " as the first.t
2670: 6f 6b 65 6e 20 61 66 74 65 72 20 74 68 65 20 6e oken after the n
2680: 61 6d 65 20 6f 66 20 74 68 65 20 66 6f 73 73 69 ame of the fossi
2690: 6c 20 65 78 65 63 75 74 61 62 6c 65 2c 20 61 73 l executable, as
26a0: 20 73 68 6f 77 6e 20 61 62 6f 76 65 2e 3c 2f 70 shown above.</p
26b0: 3e 0a 0a 3c 68 32 3e 34 2e 30 20 57 6f 72 6b 66 >..<h2>4.0 Workf
26c0: 6c 6f 77 3c 2f 68 32 3e 0a 0a 3c 69 6d 67 20 73 low</h2>..<img s
26d0: 72 63 3d 22 63 6f 6e 63 65 70 74 32 2e 67 69 66 rc="concept2.gif
26e0: 22 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 20 " align="right"
26f0: 68 73 70 61 63 65 3d 22 31 30 22 3e 0a 0a 3c 70 hspace="10">..<p
2700: 3e 46 6f 73 73 69 6c 20 68 61 73 20 74 77 6f 20 >Fossil has two
2710: 6d 6f 64 65 73 20 6f 66 20 6f 70 65 72 61 74 69 modes of operati
2720: 6f 6e 3a 20 22 61 75 74 6f 73 79 6e 63 22 20 61 on: "autosync" a
2730: 6e 64 20 22 6e 6f 6e 2d 61 75 74 6f 73 79 6e 63 nd "non-autosync
2740: 22 2e 0a 41 75 74 6f 73 79 6e 63 20 6d 6f 64 65 "..Autosync mode
2750: 20 77 6f 72 6b 73 20 73 6f 6d 65 74 68 69 6e 67 works something
2760: 20 6c 69 6b 65 20 43 56 53 20 6f 72 20 53 56 4e like CVS or SVN
2770: 20 69 6e 20 74 68 61 74 20 69 74 20 61 75 74 6f in that it auto
2780: 6d 61 74 69 63 61 6c 6c 79 0a 6b 65 65 70 73 20 matically.keeps
2790: 79 6f 75 72 20 77 6f 72 6b 20 69 6e 20 73 79 6e your work in syn
27a0: 63 20 77 69 74 68 20 74 68 65 20 63 65 6e 74 72 c with the centr
27b0: 61 6c 20 73 65 72 76 65 72 2e 20 20 4e 6f 6e 2d al server. Non-
27c0: 61 75 74 6f 73 79 6e 63 20 69 73 0a 6d 6f 72 65 autosync is.more
27d0: 20 6c 69 6b 65 20 47 49 54 20 6f 72 20 42 69 74 like GIT or Bit
27e0: 6b 65 65 70 65 72 20 69 6e 20 74 68 61 74 20 79 keeper in that y
27f0: 6f 75 72 20 6c 6f 63 61 6c 20 72 65 70 6f 73 69 our local reposi
2800: 74 6f 72 79 20 64 65 76 65 6c 6f 70 73 0a 69 6e tory develops.in
2810: 64 65 70 65 6e 64 65 6e 74 6c 79 20 6f 66 20 79 dependently of y
2820: 6f 75 72 20 63 6f 77 6f 72 6b 65 72 73 20 61 6e our coworkers an
2830: 64 20 79 6f 75 20 73 68 61 72 65 20 79 6f 75 72 d you share your
2840: 20 63 68 61 6e 67 65 73 20 6d 61 6e 75 61 6c 6c changes manuall
2850: 79 2e 0a 41 6e 20 69 6e 74 65 72 65 73 74 69 6e y..An interestin
2860: 67 20 66 65 61 74 75 72 65 20 6f 66 20 66 6f 73 g feature of fos
2870: 73 69 6c 20 69 73 20 74 68 61 74 20 69 74 20 73 sil is that it s
2880: 75 70 70 6f 72 74 73 20 62 6f 74 68 20 61 75 74 upports both aut
2890: 6f 73 79 6e 63 0a 61 6e 64 20 6e 6f 6e 2d 61 75 osync.and non-au
28a0: 74 6f 73 79 6e 63 20 77 6f 72 6b 20 66 6c 6f 77 tosync work flow
28b0: 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 64 s.</p>..<p>The d
28c0: 65 66 61 75 6c 74 20 73 65 74 74 69 6e 67 20 66 efault setting f
28d0: 6f 72 20 66 6f 73 73 69 6c 20 69 73 20 74 6f 20 or fossil is to
28e0: 62 65 20 69 6e 20 61 75 74 6f 73 79 6e 63 20 6d be in autosync m
28f0: 6f 64 65 2e 20 20 59 6f 75 0a 63 61 6e 20 63 68 ode. You.can ch
2900: 61 6e 67 65 20 74 68 65 20 61 75 74 6f 73 79 6e ange the autosyn
2910: 63 20 73 65 74 74 69 6e 67 20 6f 72 20 63 68 65 c setting or che
2920: 63 6b 20 74 68 65 20 63 75 72 72 65 6e 74 20 61 ck the current a
2930: 75 74 6f 73 79 6e 63 0a 73 65 74 74 69 6e 67 20 utosync.setting
2940: 75 73 69 6e 67 20 63 6f 6d 6d 61 6e 64 73 20 6c using commands l
2950: 69 6b 65 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b ike:</p>..<block
2960: 71 75 6f 74 65 3e 0a 3c 62 3e 66 6f 73 73 69 6c quote>.<b>fossil
2970: 20 73 65 74 74 69 6e 67 20 61 75 74 6f 73 79 6e setting autosyn
2980: 63 20 6f 6e 3c 62 72 3e 0a 66 6f 73 73 69 6c 20 c on<br>.fossil
2990: 73 65 74 74 69 6e 67 20 61 75 74 6f 73 79 6e 63 setting autosync
29a0: 20 6f 66 66 3c 62 72 3e 0a 3c 62 3e 66 6f 73 73 off<br>.<b>foss
29b0: 69 6c 20 73 65 74 74 69 6e 67 73 3c 2f 62 3e 0a il settings</b>.
29c0: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c </blockquote>..<
29d0: 70 3e 42 79 20 64 65 66 61 75 6c 74 2c 20 66 6f p>By default, fo
29e0: 73 73 69 6c 20 72 75 6e 73 20 77 69 74 68 20 61 ssil runs with a
29f0: 75 74 6f 73 79 6e 63 20 6d 6f 64 65 20 74 75 72 utosync mode tur
2a00: 6e 65 64 20 6f 6e 2e 20 20 54 68 65 0a 61 75 74 ned on. The.aut
2a10: 68 6f 72 73 20 66 69 6e 64 20 74 68 61 74 20 70 hors find that p
2a20: 72 6f 6a 65 63 74 73 20 72 75 6e 20 6d 6f 72 65 rojects run more
2a30: 20 73 6d 6f 6f 74 68 6c 79 20 77 68 65 6e 20 61 smoothly when a
2a40: 75 74 6f 73 79 6e 63 20 69 73 20 6f 6e 6c 79 0a utosync is only.
2a50: 64 69 73 61 62 6c 65 64 20 77 68 65 6e 20 6f 66 disabled when of
2a60: 66 2d 6e 65 74 77 6f 72 6b 2e 3c 2f 70 3e 0a 0a f-network.</p>..
2a70: 3c 68 33 3e 34 2e 31 20 41 75 74 6f 73 79 6e 63 <h3>4.1 Autosync
2a80: 20 57 6f 72 6b 66 6c 6f 77 3c 2f 68 33 3e 0a 0a Workflow</h3>..
2a90: 3c 6f 6c 3e 0a 3c 6c 69 3e 3c 70 3e 0a 45 73 74 <ol>.<li><p>.Est
2aa0: 61 62 6c 69 73 68 20 61 20 6c 6f 63 61 6c 20 72 ablish a local r
2ab0: 65 70 6f 73 69 74 6f 72 79 20 75 73 69 6e 67 20 epository using
2ac0: 65 69 74 68 65 72 20 74 68 65 20 3c 62 3e 6e 65 either the <b>ne
2ad0: 77 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 0a 74 6f w</b> command.to
2ae0: 20 73 74 61 72 74 20 61 20 6e 65 77 20 70 72 6f start a new pro
2af0: 6a 65 63 74 2c 20 6f 72 20 74 68 65 20 3c 62 3e ject, or the <b>
2b00: 63 6c 6f 6e 65 3c 2f 62 3e 20 63 6f 6d 6d 61 6e clone</b> comman
2b10: 64 20 74 6f 20 6d 61 6b 65 20 61 20 63 6c 6f 6e d to make a clon
2b20: 65 0a 6f 66 20 61 20 72 65 70 6f 73 69 74 6f 72 e.of a repositor
2b30: 79 20 66 6f 72 20 61 6e 20 65 78 69 73 74 69 6e y for an existin
2b40: 67 20 70 72 6f 6a 65 63 74 2e 20 0a 3c 2f 70 3e g project. .</p>
2b50: 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 45 </li>..<li><p>.E
2b60: 73 74 61 62 6c 69 73 68 20 6f 6e 65 20 6f 72 20 stablish one or
2b70: 6d 6f 72 65 20 73 6f 75 72 63 65 20 74 72 65 65 more source tree
2b80: 73 20 62 79 20 63 68 61 6e 67 69 6e 67 20 79 6f s by changing yo
2b90: 75 72 20 77 6f 72 6b 69 6e 67 20 64 69 72 65 63 ur working direc
2ba0: 74 6f 72 79 0a 74 6f 20 77 68 65 72 65 20 79 6f tory.to where yo
2bb0: 75 20 77 61 6e 74 20 74 68 65 20 72 6f 6f 74 20 u want the root
2bc0: 6f 66 20 74 68 65 20 73 6f 75 72 63 65 20 74 72 of the source tr
2bd0: 65 65 20 74 6f 20 62 65 2c 20 74 68 65 6e 20 69 ee to be, then i
2be0: 73 73 75 69 6e 67 0a 74 68 65 20 3c 62 3e 6f 70 ssuing.the <b>op
2bf0: 65 6e 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 77 en</b> command w
2c00: 69 74 68 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 ith the name of
2c10: 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 20 66 the repository f
2c20: 69 6c 65 20 61 73 20 69 74 73 0a 61 72 67 75 6d ile as its.argum
2c30: 65 6e 74 2e 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a ent..</p></li>..
2c40: 3c 6c 69 3e 3c 70 3e 0a 54 68 65 20 3c 62 3e 6f <li><p>.The <b>o
2c50: 70 65 6e 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 pen</b> command
2c60: 69 6e 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 in the previous
2c70: 73 74 65 70 20 70 6f 70 75 6c 61 74 65 73 20 79 step populates y
2c80: 6f 75 72 20 6c 6f 63 61 6c 20 73 6f 75 72 63 65 our local source
2c90: 0a 74 72 65 65 20 77 69 74 68 20 61 20 63 6f 70 .tree with a cop
2ca0: 79 20 6f 66 20 74 68 65 20 6c 61 74 65 73 74 20 y of the latest
2cb0: 63 68 65 63 6b 2d 69 6e 2e 20 20 55 73 75 61 6c check-in. Usual
2cc0: 6c 79 20 74 68 69 73 20 69 73 20 77 68 61 74 20 ly this is what
2cd0: 79 6f 75 20 77 61 6e 74 2e 0a 49 6e 20 74 68 65 you want..In the
2ce0: 20 72 61 72 65 20 63 61 73 65 73 20 77 68 65 72 rare cases wher
2cf0: 65 20 69 74 20 69 73 20 6e 6f 74 2c 20 75 73 65 e it is not, use
2d00: 20 74 68 65 20 3c 62 3e 75 70 64 61 74 65 3c 2f the <b>update</
2d10: 62 3e 20 63 6f 6d 6d 61 6e 64 20 74 6f 0a 73 77 b> command to.sw
2d20: 69 74 63 68 20 74 6f 20 61 20 6e 65 77 20 63 68 itch to a new ch
2d30: 65 63 6b 2d 69 6e 2e 20 20 55 73 65 20 74 68 65 eck-in. Use the
2d40: 20 3c 62 3e 74 69 6d 65 6c 69 6e 65 3c 2f 62 3e <b>timeline</b>
2d50: 20 6f 72 20 3c 62 3e 6c 65 61 76 65 73 3c 2f 62 or <b>leaves</b
2d60: 3e 20 63 6f 6d 6d 61 6e 64 73 0a 74 6f 20 69 64 > commands.to id
2d70: 65 6e 74 69 66 79 20 61 6c 74 65 72 6e 61 74 69 entify alternati
2d80: 76 65 20 63 68 65 63 6b 2d 69 6e 73 20 74 6f 20 ve check-ins to
2d90: 73 77 69 74 63 68 20 74 6f 2e 0a 3c 2f 70 3e 3c switch to..</p><
2da0: 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 45 64 /li>..<li><p>.Ed
2db0: 69 74 20 74 68 65 20 63 6f 64 65 2e 20 20 41 64 it the code. Ad
2dc0: 64 20 6e 65 77 20 66 69 6c 65 73 20 74 6f 20 74 d new files to t
2dd0: 68 65 20 73 6f 75 72 63 65 20 74 72 65 65 20 75 he source tree u
2de0: 73 69 6e 67 20 74 68 65 20 3c 62 3e 61 64 64 3c sing the <b>add<
2df0: 2f 62 3e 0a 63 6f 6d 6d 61 6e 64 2e 20 20 4f 6d /b>.command. Om
2e00: 69 74 20 66 69 6c 65 73 20 66 72 6f 6d 20 66 75 it files from fu
2e10: 74 75 72 65 20 63 68 65 63 6b 2d 69 6e 73 20 75 ture check-ins u
2e20: 73 69 6e 67 20 74 68 65 20 3c 62 3e 72 6d 3c 2f sing the <b>rm</
2e30: 62 3e 20 63 6f 6d 6d 61 6e 64 2e 0a 28 45 76 65 b> command..(Eve
2e40: 6e 20 77 68 65 6e 20 79 6f 75 20 72 65 6d 6f 76 n when you remov
2e50: 65 20 66 69 6c 65 73 20 66 72 6f 6d 20 66 75 74 e files from fut
2e60: 75 72 65 20 63 68 65 63 6b 2d 69 6e 73 2c 20 74 ure check-ins, t
2e70: 68 6f 73 65 20 66 69 6c 65 73 20 63 6f 6e 74 69 hose files conti
2e80: 6e 75 65 0a 74 6f 20 65 78 69 73 74 20 69 6e 20 nue.to exist in
2e90: 68 69 73 74 6f 72 69 63 61 6c 20 63 68 65 63 6b historical check
2ea0: 2d 69 6e 73 2e 29 20 20 54 65 73 74 20 79 6f 75 -ins.) Test you
2eb0: 72 20 63 68 61 6e 67 65 73 2e 0a 3c 2f 70 3e 3c r changes..</p><
2ec0: 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 43 72 /li>..<li><p>.Cr
2ed0: 65 61 74 65 20 61 20 6e 65 77 20 63 68 65 63 6b eate a new check
2ee0: 2d 69 6e 20 75 73 69 6e 67 20 74 68 65 20 3c 62 -in using the <b
2ef0: 3e 63 6f 6d 6d 69 74 3c 2f 62 3e 20 63 6f 6d 6d >commit</b> comm
2f00: 61 6e 64 2e 20 20 59 6f 75 20 77 69 6c 6c 20 62 and. You will b
2f10: 65 20 70 72 6f 6d 70 74 65 64 0a 66 6f 72 20 61 e prompted.for a
2f20: 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d 6d 65 6e check-in commen
2f30: 74 20 61 6e 64 20 61 6c 73 6f 20 66 6f 72 20 79 t and also for y
2f40: 6f 75 72 20 47 50 47 20 6b 65 79 20 69 66 20 79 our GPG key if y
2f50: 6f 75 20 68 61 76 65 20 47 50 47 20 69 6e 73 74 ou have GPG inst
2f60: 61 6c 6c 65 64 2e 0a 54 68 65 20 63 6f 6d 6d 69 alled..The commi
2f70: 74 20 63 6f 70 69 65 73 20 74 68 65 20 65 64 69 t copies the edi
2f80: 74 73 20 79 6f 75 20 68 61 76 65 20 6d 61 64 65 ts you have made
2f90: 20 69 6e 20 79 6f 75 72 20 6c 6f 63 61 6c 20 73 in your local s
2fa0: 6f 75 72 63 65 0a 74 72 65 65 20 69 6e 74 6f 20 ource.tree into
2fb0: 79 6f 75 72 20 6c 6f 63 61 6c 20 72 65 70 6f 73 your local repos
2fc0: 69 74 6f 72 79 2e 20 20 41 66 74 65 72 20 79 6f itory. After yo
2fd0: 75 72 20 63 6f 6d 6d 69 74 20 63 6f 6d 70 6c 65 ur commit comple
2fe0: 74 65 73 2c 20 66 6f 73 73 69 6c 20 77 69 6c 6c tes, fossil will
2ff0: 0a 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 3c .automatically <
3000: 62 3e 70 75 73 68 3c 2f 62 3e 20 79 6f 75 72 20 b>push</b> your
3010: 63 68 61 6e 67 65 73 20 62 61 63 6b 20 74 6f 20 changes back to
3020: 74 68 65 20 73 65 72 76 65 72 0a 79 6f 75 20 63 the server.you c
3030: 6c 6f 6e 65 64 20 66 72 6f 6d 20 6f 72 20 77 68 loned from or wh
3040: 61 74 65 76 65 72 20 73 65 72 76 65 72 20 79 6f atever server yo
3050: 75 20 6d 6f 73 74 20 72 65 63 65 6e 74 6c 79 20 u most recently
3060: 73 79 6e 63 65 64 20 77 69 74 68 2e 0a 3c 2f 70 synced with..</p
3070: 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 0a ></li>..<li><p>.
3080: 57 68 65 6e 20 79 6f 75 72 20 63 6f 77 6f 72 6b When your cowork
3090: 65 72 73 20 6d 61 6b 65 20 74 68 65 69 72 20 6f ers make their o
30a0: 77 6e 20 63 68 61 6e 67 65 73 2c 20 79 6f 75 20 wn changes, you
30b0: 63 61 6e 20 6d 65 72 67 65 20 74 68 6f 73 65 20 can merge those
30c0: 63 68 61 6e 67 65 73 0a 69 6e 74 6f 20 79 6f 75 changes.into you
30d0: 72 20 6c 6f 63 61 6c 20 6c 6f 63 61 6c 20 73 6f r local local so
30e0: 75 72 63 65 20 74 72 65 65 20 75 73 69 6e 67 20 urce tree using
30f0: 74 68 65 20 3c 62 3e 75 70 64 61 74 65 3c 2f 62 the <b>update</b
3100: 3e 20 63 6f 6d 6d 61 6e 64 2e 20 20 0a 49 6e 20 > command. .In
3110: 61 75 74 6f 73 79 6e 63 20 6d 6f 64 65 2c 20 3c autosync mode, <
3120: 62 3e 75 70 64 61 74 65 3c 2f 62 3e 20 77 69 6c b>update</b> wil
3130: 6c 20 66 69 72 73 74 20 67 6f 20 62 61 63 6b 20 l first go back
3140: 74 6f 20 74 68 65 20 73 65 72 76 65 72 20 79 6f to the server yo
3150: 75 0a 63 6c 6f 6e 65 64 20 66 72 6f 6d 20 6f 72 u.cloned from or
3160: 20 77 69 74 68 20 77 68 69 63 68 20 79 6f 75 20 with which you
3170: 6d 6f 73 74 20 72 65 63 65 6e 74 6c 79 20 73 79 most recently sy
3180: 6e 63 65 64 2c 20 61 6e 64 20 70 75 6c 6c 20 64 nced, and pull d
3190: 6f 77 6e 20 61 6c 6c 0a 72 65 63 65 6e 74 20 63 own all.recent c
31a0: 68 61 6e 67 65 73 20 69 6e 74 6f 20 79 6f 75 72 hanges into your
31b0: 20 6c 6f 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 local repositor
31c0: 79 2e 20 20 54 68 65 6e 20 69 74 20 77 69 6c 6c y. Then it will
31d0: 20 6d 65 72 67 65 20 72 65 63 65 6e 74 0a 63 68 merge recent.ch
31e0: 61 6e 67 65 73 20 69 6e 74 6f 20 79 6f 75 72 20 anges into your
31f0: 6c 6f 63 61 6c 20 73 6f 75 72 63 65 20 74 72 65 local source tre
3200: 65 2e 20 20 49 66 20 79 6f 75 20 64 6f 20 61 6e e. If you do an
3210: 20 3c 62 3e 75 70 64 61 74 65 3c 2f 62 3e 20 61 <b>update</b> a
3220: 6e 64 0a 66 69 6e 64 20 74 68 61 74 20 69 74 20 nd.find that it
3230: 6d 65 73 73 65 73 20 73 6f 6d 65 74 68 69 6e 67 messes something
3240: 20 75 70 20 69 6e 20 79 6f 75 72 20 73 6f 75 72 up in your sour
3250: 63 65 20 74 72 65 65 20 28 70 65 72 68 61 70 73 ce tree (perhaps
3260: 20 61 20 63 6f 2d 77 6f 72 6b 65 72 0a 63 68 65 a co-worker.che
3270: 63 6b 65 64 20 69 6e 20 69 6e 63 6f 6d 70 61 74 cked in incompat
3280: 69 62 6c 65 20 63 68 61 6e 67 65 73 29 20 79 6f ible changes) yo
3290: 75 20 63 61 6e 20 75 73 65 20 74 68 65 20 3c 62 u can use the <b
32a0: 3e 75 6e 64 6f 3c 2f 62 3e 20 63 6f 6d 6d 61 6e >undo</b> comman
32b0: 64 20 0a 74 6f 20 62 61 63 6b 20 6f 75 74 20 74 d .to back out t
32c0: 68 65 20 63 68 61 6e 67 65 73 2e 0a 3c 2f 70 3e he changes..</p>
32d0: 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 52 </li>..<li><p>.R
32e0: 65 70 65 61 74 20 61 6c 6c 20 6f 66 20 74 68 65 epeat all of the
32f0: 20 61 62 6f 76 65 20 75 6e 74 69 6c 20 79 6f 75 above until you
3300: 20 68 61 76 65 20 67 65 6e 65 72 61 74 65 64 20 have generated
3310: 67 72 65 61 74 20 73 6f 66 74 77 61 72 65 2e 0a great software..
3320: 3c 2f 70 3e 3c 2f 6c 69 3e 0a 3c 2f 6f 6c 3e 0a </p></li>.</ol>.
3330: 0a 3c 68 33 3e 34 2e 32 20 4e 6f 6e 2d 41 75 74 .<h3>4.2 Non-Aut
3340: 6f 73 79 6e 63 20 57 6f 72 6b 66 6c 6f 77 3c 2f osync Workflow</
3350: 68 33 3e 0a 0a 3c 70 3e 57 68 65 6e 20 61 75 74 h3>..<p>When aut
3360: 6f 73 79 6e 63 20 69 73 20 64 69 73 61 62 6c 65 osync is disable
3370: 64 2c 20 74 68 65 20 3c 62 3e 63 6f 6d 6d 69 74 d, the <b>commit
3380: 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 69 73 20 </b> command is
3390: 64 65 63 6f 75 70 6c 65 64 20 66 72 6f 6d 0a 3c decoupled from.<
33a0: 62 3e 70 75 73 68 3c 2f 62 3e 20 61 6e 64 20 74 b>push</b> and t
33b0: 68 65 20 3c 62 3e 75 70 64 61 74 65 3c 2f 62 3e he <b>update</b>
33c0: 20 63 6f 6d 6d 61 6e 64 20 69 73 20 64 65 63 6f command is deco
33d0: 75 70 6c 65 64 20 66 72 6f 6d 20 3c 62 3e 70 75 upled from <b>pu
33e0: 6c 6c 3c 2f 62 3e 2e 0a 54 68 61 74 20 6d 65 61 ll</b>..That mea
33f0: 6e 73 20 79 6f 75 20 68 61 76 65 20 74 6f 20 64 ns you have to d
3400: 6f 20 61 20 66 65 77 20 65 78 74 72 61 20 73 74 o a few extra st
3410: 65 70 73 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 eps in order to
3420: 61 63 63 6f 6d 70 6c 69 73 68 20 74 68 65 0a 3c accomplish the.<
3430: 62 3e 70 75 73 68 3c 2f 62 3e 20 61 6e 64 20 3c b>push</b> and <
3440: 62 3e 70 75 6c 6c 3c 2f 62 3e 20 74 61 73 6b 73 b>pull</b> tasks
3450: 20 6d 61 6e 75 61 6c 6c 79 2e 3c 2f 70 3e 0a 0a manually.</p>..
3460: 3c 6f 6c 3e 0a 3c 6c 69 3e 3c 70 3e 0a 45 73 74 <ol>.<li><p>.Est
3470: 61 62 6c 69 73 68 20 61 20 6c 6f 63 61 6c 20 72 ablish a local r
3480: 65 70 6f 73 69 74 6f 72 79 20 75 73 69 6e 67 20 epository using
3490: 65 69 74 68 65 72 20 74 68 65 20 3c 62 3e 6e 65 either the <b>ne
34a0: 77 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 0a 74 6f w</b> command.to
34b0: 20 73 74 61 72 74 20 61 20 6e 65 77 20 70 72 6f start a new pro
34c0: 6a 65 63 74 2c 20 6f 72 20 74 68 65 20 3c 62 3e ject, or the <b>
34d0: 63 6c 6f 6e 65 3c 2f 62 3e 20 63 6f 6d 6d 61 6e clone</b> comman
34e0: 64 20 74 6f 20 6d 61 6b 65 20 61 20 63 6c 6f 6e d to make a clon
34f0: 65 0a 6f 66 20 61 20 72 65 70 6f 73 69 74 6f 72 e.of a repositor
3500: 79 20 66 6f 72 20 61 6e 20 65 78 69 73 74 69 6e y for an existin
3510: 67 20 70 72 6f 6a 65 63 74 2e 20 20 20 54 68 65 g project. The
3520: 20 64 65 66 61 75 6c 74 20 73 65 74 74 69 6e 67 default setting
3530: 20 66 6f 72 0a 61 20 6e 65 77 20 72 65 70 6f 73 for.a new repos
3540: 69 74 6f 72 79 20 69 73 20 77 69 74 68 20 61 75 itory is with au
3550: 74 6f 73 79 6e 63 20 6f 6e 2c 20 73 6f 20 79 6f tosync on, so yo
3560: 75 20 77 69 6c 6c 20 6e 65 65 64 20 74 6f 20 74 u will need to t
3570: 75 72 6e 20 69 74 20 6f 66 66 0a 75 73 69 6e 67 urn it off.using
3580: 20 74 68 65 20 3c 62 3e 73 65 74 74 69 6e 67 20 the <b>setting
3590: 61 75 74 6f 73 79 6e 63 20 6f 66 66 3c 2f 62 3e autosync off</b>
35a0: 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 20 61 20 command with a
35b0: 3c 62 3e 2d 52 3c 2f 62 3e 20 6f 70 74 69 6f 6e <b>-R</b> option
35c0: 0a 74 6f 20 73 70 65 63 69 66 79 20 74 68 65 20 .to specify the
35d0: 72 65 70 6f 73 69 74 6f 72 79 2e 0a 3c 2f 70 3e repository..</p>
35e0: 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 45 </li>..<li><p>.E
35f0: 73 74 61 62 6c 69 73 68 20 6f 6e 65 20 6f 72 20 stablish one or
3600: 6d 6f 72 65 20 73 6f 75 72 63 65 20 74 72 65 65 more source tree
3610: 73 20 62 79 20 63 68 61 6e 67 69 6e 67 20 79 6f s by changing yo
3620: 75 72 20 77 6f 72 6b 69 6e 67 20 64 69 72 65 63 ur working direc
3630: 74 6f 72 79 0a 74 6f 20 77 68 65 72 65 20 79 6f tory.to where yo
3640: 75 20 77 61 6e 74 20 74 68 65 20 72 6f 6f 74 20 u want the root
3650: 6f 66 20 74 68 65 20 73 6f 75 72 63 65 20 74 72 of the source tr
3660: 65 65 20 74 6f 20 62 65 2c 20 74 68 65 6e 20 69 ee to be, then i
3670: 73 73 75 69 6e 67 0a 74 68 65 20 3c 62 3e 6f 70 ssuing.the <b>op
3680: 65 6e 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 77 en</b> command w
3690: 69 74 68 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 ith the name of
36a0: 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 20 66 the repository f
36b0: 69 6c 65 20 61 73 20 69 74 73 0a 61 72 67 75 6d ile as its.argum
36c0: 65 6e 74 2e 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a ent..</p></li>..
36d0: 3c 6c 69 3e 3c 70 3e 0a 54 68 65 20 3c 62 3e 6f <li><p>.The <b>o
36e0: 70 65 6e 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 pen</b> command
36f0: 69 6e 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 in the previous
3700: 73 74 65 70 20 70 6f 70 75 6c 61 74 65 73 20 79 step populates y
3710: 6f 75 72 20 6c 6f 63 61 6c 20 73 6f 75 72 63 65 our local source
3720: 0a 74 72 65 65 20 77 69 74 68 20 61 20 63 6f 70 .tree with a cop
3730: 79 20 6f 66 20 74 68 65 20 6c 61 74 65 73 74 20 y of the latest
3740: 63 68 65 63 6b 2d 69 6e 2e 20 20 55 73 75 61 6c check-in. Usual
3750: 6c 79 20 74 68 69 73 20 69 73 20 77 68 61 74 20 ly this is what
3760: 79 6f 75 20 77 61 6e 74 2e 0a 49 6e 20 74 68 65 you want..In the
3770: 20 72 61 72 65 20 63 61 73 65 73 20 77 68 65 72 rare cases wher
3780: 65 20 69 74 20 69 73 20 6e 6f 74 2c 20 75 73 65 e it is not, use
3790: 20 74 68 65 20 3c 62 3e 75 70 64 61 74 65 3c 2f the <b>update</
37a0: 62 3e 20 63 6f 6d 6d 61 6e 64 20 74 6f 0a 73 77 b> command to.sw
37b0: 69 74 63 68 20 74 6f 20 61 20 6e 65 77 20 63 68 itch to a new ch
37c0: 65 63 6b 2d 69 6e 2e 20 20 55 73 65 20 74 68 65 eck-in. Use the
37d0: 20 3c 62 3e 74 69 6d 65 6c 69 6e 65 3c 2f 62 3e <b>timeline</b>
37e0: 20 6f 72 20 3c 62 3e 6c 65 61 76 65 73 3c 2f 62 or <b>leaves</b
37f0: 3e 20 63 6f 6d 6d 61 6e 64 73 0a 74 6f 20 69 64 > commands.to id
3800: 65 6e 74 69 66 79 20 61 6c 74 65 72 6e 61 74 69 entify alternati
3810: 76 65 20 63 68 65 63 6b 2d 69 6e 73 20 74 6f 20 ve check-ins to
3820: 73 77 69 74 63 68 20 74 6f 2e 0a 3c 2f 70 3e 3c switch to..</p><
3830: 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 45 64 /li>..<li><p>.Ed
3840: 69 74 20 74 68 65 20 63 6f 64 65 2e 20 20 41 64 it the code. Ad
3850: 64 20 6e 65 77 20 66 69 6c 65 73 20 74 6f 20 74 d new files to t
3860: 68 65 20 73 6f 75 72 63 65 20 74 72 65 65 20 75 he source tree u
3870: 73 69 6e 67 20 74 68 65 20 3c 62 3e 61 64 64 3c sing the <b>add<
3880: 2f 62 3e 0a 63 6f 6d 6d 61 6e 64 2e 20 20 4f 6d /b>.command. Om
3890: 69 74 20 66 69 6c 65 73 20 66 72 6f 6d 20 66 75 it files from fu
38a0: 74 75 72 65 20 63 68 65 63 6b 2d 69 6e 73 20 75 ture check-ins u
38b0: 73 69 6e 67 20 74 68 65 20 3c 62 3e 72 6d 3c 2f sing the <b>rm</
38c0: 62 3e 20 63 6f 6d 6d 61 6e 64 2e 0a 28 45 76 65 b> command..(Eve
38d0: 6e 20 77 68 65 6e 20 79 6f 75 20 72 65 6d 6f 76 n when you remov
38e0: 65 20 66 69 6c 65 73 20 66 72 6f 6d 20 66 75 74 e files from fut
38f0: 75 72 65 20 63 68 65 63 6b 2d 69 6e 73 2c 20 74 ure check-ins, t
3900: 68 6f 73 65 20 66 69 6c 65 73 20 63 6f 6e 74 69 hose files conti
3910: 6e 75 65 0a 74 6f 20 65 78 69 73 74 20 69 6e 20 nue.to exist in
3920: 68 69 73 74 6f 72 69 63 61 6c 20 63 68 65 63 6b historical check
3930: 2d 69 6e 73 2e 29 20 20 54 65 73 74 20 79 6f 75 -ins.) Test you
3940: 72 20 63 68 61 6e 67 65 73 2e 0a 3c 2f 70 3e 3c r changes..</p><
3950: 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 43 72 /li>..<li><p>.Cr
3960: 65 61 74 65 20 61 20 6e 65 77 20 63 68 65 63 6b eate a new check
3970: 2d 69 6e 20 75 73 69 6e 67 20 74 68 65 20 3c 62 -in using the <b
3980: 3e 63 6f 6d 6d 69 74 3c 2f 62 3e 20 63 6f 6d 6d >commit</b> comm
3990: 61 6e 64 2e 20 20 59 6f 75 20 77 69 6c 6c 20 62 and. You will b
39a0: 65 20 70 72 6f 6d 70 74 65 64 0a 66 6f 72 20 61 e prompted.for a
39b0: 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d 6d 65 6e check-in commen
39c0: 74 20 61 6e 64 20 61 6c 73 6f 20 66 6f 72 20 79 t and also for y
39d0: 6f 75 72 20 47 50 47 20 6b 65 79 20 69 66 20 79 our GPG key if y
39e0: 6f 75 20 68 61 76 65 20 47 50 47 20 69 6e 73 74 ou have GPG inst
39f0: 61 6c 6c 65 64 2e 0a 54 68 65 20 63 6f 6d 6d 69 alled..The commi
3a00: 74 20 63 6f 70 69 65 73 20 74 68 65 20 65 64 69 t copies the edi
3a10: 74 73 20 79 6f 75 20 68 61 76 65 20 6d 61 64 65 ts you have made
3a20: 20 69 6e 20 79 6f 75 72 20 6c 6f 63 61 6c 20 73 in your local s
3a30: 6f 75 72 63 65 0a 74 72 65 65 20 69 6e 74 6f 20 ource.tree into
3a40: 79 6f 75 72 20 6c 6f 63 61 6c 20 72 65 70 6f 73 your local repos
3a50: 69 74 6f 72 79 2e 0a 3c 2f 70 3e 3c 2f 6c 69 3e itory..</p></li>
3a60: 0a 0a 3c 6c 69 3e 3c 70 3e 55 73 65 20 74 68 65 ..<li><p>Use the
3a70: 20 3c 62 3e 70 75 73 68 3c 2f 62 3e 20 63 6f 6d <b>push</b> com
3a80: 6d 61 6e 64 20 74 6f 20 70 75 73 68 20 79 6f 75 mand to push you
3a90: 72 20 63 68 61 6e 67 65 73 20 6f 75 74 20 74 6f r changes out to
3aa0: 20 61 20 73 65 72 76 65 72 0a 77 68 65 72 65 20 a server.where
3ab0: 79 6f 75 72 20 63 6f 2d 77 6f 72 6b 65 72 73 20 your co-workers
3ac0: 63 61 6e 20 61 63 63 65 73 73 20 74 68 65 6d 2e can access them.
3ad0: 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e .</p></li>..<li>
3ae0: 3c 70 3e 0a 57 68 65 6e 20 63 6f 2d 77 6f 72 6b <p>.When co-work
3af0: 65 72 73 20 6d 61 6b 65 20 74 68 65 69 72 20 6f ers make their o
3b00: 77 6e 20 63 68 61 6e 67 65 73 2c 20 75 73 65 20 wn changes, use
3b10: 74 68 65 20 3c 62 3e 70 75 6c 6c 3c 2f 62 3e 20 the <b>pull</b>
3b20: 63 6f 6d 6d 61 6e 64 0a 74 6f 20 70 75 6c 6c 20 command.to pull
3b30: 74 68 6f 73 65 20 63 68 61 6e 67 65 73 20 69 6e those changes in
3b40: 74 6f 20 79 6f 75 72 20 6c 6f 63 61 6c 20 72 65 to your local re
3b50: 70 6f 73 69 74 6f 72 79 2e 20 20 4e 6f 74 65 20 pository. Note
3b60: 74 68 61 74 20 3c 62 3e 70 75 6c 6c 3c 2f 62 3e that <b>pull</b>
3b70: 0a 64 6f 65 73 20 6e 6f 74 20 6d 6f 76 65 20 74 .does not move t
3b80: 68 65 20 63 68 61 6e 67 65 73 20 69 6e 74 6f 20 he changes into
3b90: 79 6f 75 72 20 6c 6f 63 61 6c 20 73 6f 75 72 63 your local sourc
3ba0: 65 20 74 72 65 65 2c 20 6f 6e 6c 79 20 69 6e 74 e tree, only int
3bb0: 6f 20 79 6f 75 72 0a 6c 6f 63 61 6c 20 72 65 70 o your.local rep
3bc0: 6f 73 69 74 6f 72 79 2e 0a 3c 2f 70 3e 3c 2f 6c ository..</p></l
3bd0: 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 4f 6e 63 65 i>..<li><p>.Once
3be0: 20 63 68 61 6e 67 65 73 20 61 72 65 20 69 6e 20 changes are in
3bf0: 79 6f 75 72 20 6c 6f 63 61 6c 20 72 65 70 6f 73 your local repos
3c00: 69 74 6f 72 79 2c 20 75 73 65 0a 75 73 65 20 74 itory, use.use t
3c10: 68 65 20 3c 62 3e 75 70 64 61 74 65 3c 2f 62 3e he <b>update</b>
3c20: 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 6d 65 72 67 command to merg
3c30: 65 20 74 68 65 6d 20 74 6f 20 79 6f 75 72 20 6c e them to your l
3c40: 6f 63 61 6c 20 73 6f 75 72 63 65 20 74 72 65 65 ocal source tree
3c50: 2e 0a 49 66 20 79 6f 75 20 6d 65 72 67 65 20 69 ..If you merge i
3c60: 6e 20 73 6f 6d 65 20 63 68 61 6e 67 65 73 20 61 n some changes a
3c70: 6e 64 20 66 69 6e 64 20 74 68 61 74 20 74 68 65 nd find that the
3c80: 20 63 68 61 6e 67 65 73 20 64 6f 20 6e 6f 74 20 changes do not
3c90: 77 6f 72 6b 20 6f 75 74 0a 6f 72 20 61 72 65 20 work out.or are
3ca0: 6e 6f 74 20 74 6f 20 79 6f 75 72 20 6c 69 6b 69 not to your liki
3cb0: 6e 67 2c 20 79 6f 75 20 63 61 6e 20 62 61 63 6b ng, you can back
3cc0: 20 6f 75 74 20 74 68 65 20 63 68 61 6e 67 65 73 out the changes
3cd0: 20 75 73 69 6e 67 20 74 68 65 0a 3c 62 3e 75 6e using the.<b>un
3ce0: 64 6f 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 2e 0a do</b> command..
3cf0: 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c </p></li>..<li><
3d00: 70 3e 0a 52 65 70 65 61 74 20 61 6c 6c 20 6f 66 p>.Repeat all of
3d10: 20 74 68 65 20 61 62 6f 76 65 20 75 6e 74 69 6c the above until
3d20: 20 79 6f 75 20 68 61 76 65 20 67 65 6e 65 72 61 you have genera
3d30: 74 65 64 20 67 72 65 61 74 20 73 6f 66 74 77 61 ted great softwa
3d40: 72 65 2e 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 3c 2f re..</p></li>.</
3d50: 6f 6c 3e 0a 0a 3c 68 32 3e 35 2e 30 20 53 65 74 ol>..<h2>5.0 Set
3d60: 74 69 6e 67 20 55 70 20 41 20 46 6f 73 73 69 6c ting Up A Fossil
3d70: 20 53 65 72 76 65 72 3c 2f 68 32 3e 0a 0a 3c 70 Server</h2>..<p
3d80: 3e 57 69 74 68 20 6f 74 68 65 72 20 63 6f 6e 66 >With other conf
3d90: 69 67 75 72 61 74 69 6f 6e 20 6d 61 6e 61 67 65 iguration manage
3da0: 6d 65 6e 74 20 73 6f 66 74 77 61 72 65 2c 20 73 ment software, s
3db0: 65 74 74 69 6e 67 20 75 70 20 61 20 73 65 72 76 etting up a serv
3dc0: 65 72 20 69 73 0a 61 20 6c 6f 74 20 6f 66 20 77 er is.a lot of w
3dd0: 6f 72 6b 20 61 6e 64 20 6e 6f 72 6d 61 6c 6c 79 ork and normally
3de0: 20 74 61 6b 65 73 20 74 69 6d 65 2c 20 70 61 74 takes time, pat
3df0: 69 65 6e 63 65 2c 20 61 6e 64 20 61 20 6c 6f 74 ience, and a lot
3e00: 20 6f 66 20 73 79 73 74 65 6d 0a 6b 6e 6f 77 6c of system.knowl
3e10: 65 64 67 65 2e 20 20 46 6f 73 73 69 6c 20 69 73 edge. Fossil is
3e20: 20 64 65 73 69 67 6e 65 64 20 74 6f 20 61 76 6f designed to avo
3e30: 69 64 20 74 68 69 73 20 66 72 75 73 74 72 61 74 id this frustrat
3e40: 69 6f 6e 2e 20 20 53 65 74 74 69 6e 67 20 75 70 ion. Setting up
3e50: 0a 61 20 73 65 72 76 65 72 20 77 69 74 68 20 66 .a server with f
3e60: 6f 73 73 69 6c 20 69 73 20 72 69 64 69 63 75 6c ossil is ridicul
3e70: 6f 75 73 6c 79 20 65 61 73 79 2e 20 20 59 6f 75 ously easy. You
3e80: 20 68 61 76 65 20 74 68 72 65 65 20 6f 70 74 69 have three opti
3e90: 6f 6e 73 3a 3c 2f 70 3e 0a 0a 3c 6f 6c 3e 0a 3c ons:</p>..<ol>.<
3ea0: 6c 69 3e 3c 70 3e 3c 62 3e 3c 61 20 6e 61 6d 65 li><p><b><a name
3eb0: 3d 22 73 61 73 65 72 76 22 3e 53 3c 2f 61 3e 65 ="saserv">S</a>e
3ec0: 74 74 69 6e 67 20 75 70 20 61 20 73 74 61 6e 64 tting up a stand
3ed0: 2d 61 6c 6f 6e 65 20 73 65 72 76 65 72 3c 2f 62 -alone server</b
3ee0: 3e 3c 2f 70 3e 0a 0a 3c 70 3e 46 72 6f 6d 20 77 ></p>..<p>From w
3ef0: 69 74 68 69 6e 20 79 6f 75 72 20 73 6f 75 72 63 ithin your sourc
3f00: 65 20 74 72 65 65 20 6a 75 73 74 20 75 73 65 20 e tree just use
3f10: 74 68 65 20 3c 62 3e 73 65 72 76 65 72 3c 2f 62 the <b>server</b
3f20: 3e 20 63 6f 6d 6d 61 6e 64 20 61 6e 64 0a 66 6f > command and.fo
3f30: 73 73 69 6c 20 77 69 6c 6c 20 73 74 61 72 74 20 ssil will start
3f40: 6c 69 73 74 65 6e 69 6e 67 20 66 6f 72 20 69 6e listening for in
3f50: 63 6f 6d 69 6e 67 20 72 65 71 75 65 73 74 73 20 coming requests
3f60: 6f 6e 20 54 43 50 20 70 6f 72 74 20 38 30 38 30 on TCP port 8080
3f70: 2e 0a 59 6f 75 20 63 61 6e 20 70 6f 69 6e 74 20 ..You can point
3f80: 79 6f 75 72 20 77 65 62 20 62 72 6f 77 73 65 72 your web browser
3f90: 20 61 74 20 3c 61 20 68 72 65 66 3d 22 68 74 74 at <a href="htt
3fa0: 70 3a 2f 2f 6c 6f 63 61 6c 68 6f 73 74 3a 38 30 p://localhost:80
3fb0: 38 30 2f 22 3e 0a 68 74 74 70 3a 2f 2f 6c 6f 63 80/">.http://loc
3fc0: 61 6c 68 6f 73 74 3a 38 30 38 30 2f 3c 2f 61 3e alhost:8080/</a>
3fd0: 20 61 6e 64 20 62 65 67 69 6e 20 65 78 70 6c 6f and begin explo
3fe0: 72 69 6e 67 2e 20 20 4f 72 20 79 6f 75 72 20 63 ring. Or your c
3ff0: 6f 77 6f 72 6b 65 72 73 0a 63 61 6e 20 64 6f 20 oworkers.can do
4000: 70 75 73 68 65 73 20 6f 72 20 70 75 6c 6c 73 20 pushes or pulls
4010: 61 67 61 69 6e 73 74 20 79 6f 75 72 20 73 65 72 against your ser
4020: 76 65 72 2e 20 20 55 73 65 20 74 68 65 20 3c 62 ver. Use the <b
4030: 3e 2d 2d 70 6f 72 74 3c 2f 62 3e 0a 6f 70 74 69 >--port</b>.opti
4040: 6f 6e 20 74 6f 20 74 68 65 20 73 65 72 76 65 72 on to the server
4050: 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 73 70 65 63 command to spec
4060: 69 66 79 20 61 20 64 69 66 66 65 72 65 6e 74 20 ify a different
4070: 54 43 50 20 70 6f 72 74 2e 20 20 49 66 0a 79 6f TCP port. If.yo
4080: 75 20 64 6f 20 6e 6f 74 20 68 61 76 65 20 61 20 u do not have a
4090: 6c 6f 63 61 6c 20 73 6f 75 72 63 65 20 74 72 65 local source tre
40a0: 65 2c 20 75 73 65 20 74 68 65 20 3c 62 3e 2d 52 e, use the <b>-R
40b0: 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e </b> command-lin
40c0: 65 0a 6f 70 74 69 6f 6e 20 74 6f 20 73 70 65 63 e.option to spec
40d0: 69 66 79 20 74 68 65 20 72 65 70 6f 73 69 74 6f ify the reposito
40e0: 72 79 20 66 69 6c 65 2e 3c 2f 70 3e 0a 0a 3c 70 ry file.</p>..<p
40f0: 3e 41 20 73 74 61 6e 64 2d 61 6c 6f 6e 65 20 73 >A stand-alone s
4100: 65 72 76 65 72 20 69 73 20 61 20 67 72 65 61 74 erver is a great
4110: 20 77 61 79 20 74 6f 20 73 65 74 20 6f 66 20 74 way to set of t
4120: 72 61 6e 73 69 65 6e 74 20 63 6f 6e 6e 65 63 74 ransient connect
4130: 69 6f 6e 73 0a 62 65 74 77 65 65 6e 20 63 6f 77 ions.between cow
4140: 6f 72 6b 65 72 73 20 66 6f 72 20 64 6f 69 6e 67 orkers for doing
4150: 20 71 75 69 63 6b 20 70 75 73 68 65 73 20 6f 72 quick pushes or
4160: 20 70 75 6c 6c 73 2e 20 20 42 75 74 20 79 6f 75 pulls. But you
4170: 20 63 61 6e 20 61 6c 73 6f 0a 73 65 74 20 75 70 can also.set up
4180: 20 61 20 70 65 72 6d 61 6e 65 6e 74 20 73 74 61 a permanent sta
4190: 6e 64 2d 61 6c 6f 6e 65 20 73 65 72 76 65 72 20 nd-alone server
41a0: 69 66 20 79 6f 75 20 70 72 65 66 65 72 2e 20 20 if you prefer.
41b0: 4a 75 73 74 20 6d 61 6b 65 0a 61 72 72 61 6e 67 Just make.arrang
41c0: 65 6d 65 6e 74 73 20 66 6f 72 20 66 6f 73 73 69 ements for fossi
41d0: 6c 20 74 6f 20 62 65 20 6c 61 75 6e 63 68 65 64 l to be launched
41e0: 20 77 69 74 68 20 61 70 70 72 6f 70 72 69 61 74 with appropriat
41f0: 65 20 61 72 67 75 6d 65 6e 74 73 0a 61 66 74 65 e arguments.afte
4200: 72 20 65 76 65 72 79 20 72 65 62 6f 6f 74 2e 3c r every reboot.<
4210: 2f 70 3e 0a 0a 3c 70 3e 49 66 20 79 6f 75 20 6a /p>..<p>If you j
4220: 75 73 74 20 77 61 6e 74 20 61 20 73 65 72 76 65 ust want a serve
4230: 72 20 74 6f 20 62 72 6f 77 73 65 20 74 68 65 20 r to browse the
4240: 62 75 69 6c 74 2d 69 6e 20 66 6f 73 73 69 6c 20 built-in fossil
4250: 77 65 62 73 69 74 65 0a 6c 6f 63 61 6c 6c 79 2c website.locally,
4260: 20 75 73 65 20 74 68 65 20 3c 62 3e 75 69 3c 2f use the <b>ui</
4270: 62 3e 20 63 6f 6d 6d 61 6e 64 20 69 6e 20 70 6c b> command in pl
4280: 61 63 65 20 6f 66 20 3c 62 3e 73 65 72 76 65 72 ace of <b>server
4290: 3c 2f 62 3e 2e 20 20 54 68 65 0a 3c 62 3e 75 69 </b>. The.<b>ui
42a0: 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 73 74 61 </b> command sta
42b0: 72 74 73 20 75 70 20 61 20 6c 6f 63 61 6c 20 73 rts up a local s
42c0: 65 72 76 65 72 20 74 6f 6f 2c 20 62 75 74 20 69 erver too, but i
42d0: 74 20 61 6c 73 6f 20 74 61 6b 65 73 0a 74 68 65 t also takes.the
42e0: 20 61 64 64 69 74 69 6f 6e 61 6c 20 73 74 65 70 additional step
42f0: 20 6f 66 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c of automaticall
4300: 79 20 6c 61 75 6e 63 68 69 6e 67 20 79 6f 75 72 y launching your
4310: 20 77 65 62 62 72 6f 77 73 65 72 20 61 6e 64 0a webbrowser and.
4320: 70 6f 69 6e 74 69 6e 67 20 61 74 20 74 68 65 20 pointing at the
4330: 6e 65 77 20 73 65 72 76 65 72 2e 3c 2f 70 3e 0a new server.</p>.
4340: 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 </li>..<li><p><b
4350: 3e 53 65 74 74 69 6e 67 20 75 70 20 61 20 43 47 >Setting up a CG
4360: 49 20 73 65 72 76 65 72 3c 2f 62 3e 3c 2f 70 3e I server</b></p>
4370: 0a 0a 3c 70 3e 49 66 20 79 6f 75 20 68 61 76 65 ..<p>If you have
4380: 20 61 20 77 65 62 73 65 72 76 65 72 20 72 75 6e a webserver run
4390: 6e 69 6e 67 20 6f 6e 20 79 6f 75 72 20 6d 61 63 ning on your mac
43a0: 68 69 6e 65 20 61 6c 72 65 61 64 79 2c 20 79 6f hine already, yo
43b0: 75 20 63 61 6e 0a 73 65 74 20 75 70 20 66 6f 73 u can.set up fos
43c0: 73 69 6c 20 74 6f 20 62 65 20 72 75 6e 20 66 72 sil to be run fr
43d0: 6f 6d 20 43 47 49 2e 20 20 53 69 6d 70 6c 79 20 om CGI. Simply
43e0: 63 72 65 61 74 65 20 61 6e 20 65 78 65 63 75 74 create an execut
43f0: 61 62 6c 65 20 73 63 72 69 70 74 0a 74 68 61 74 able script.that
4400: 20 6c 6f 6f 6b 73 20 73 6f 6d 65 74 68 69 6e 67 looks something
4410: 20 6c 69 6b 65 20 74 68 69 73 3a 3c 2f 70 3e 0a like this:</p>.
4420: 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 .<blockquote><pr
4430: 65 3e 0a 23 21 2f 75 73 72 2f 6c 6f 63 61 6c 2f e>.#!/usr/local/
4440: 62 69 6e 2f 66 6f 73 73 69 6c 0a 72 65 70 6f 73 bin/fossil.repos
4450: 69 74 6f 72 79 3a 20 2f 68 6f 6d 65 2f 6d 65 2f itory: /home/me/
4460: 62 69 67 70 72 6f 6a 65 63 74 2e 66 6f 73 73 69 bigproject.fossi
4470: 6c 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 l.</pre></blockq
4480: 75 6f 74 65 3e 0a 0a 3c 70 3e 45 64 69 74 20 74 uote>..<p>Edit t
4490: 68 69 73 20 73 63 72 69 70 74 20 74 6f 20 75 73 his script to us
44a0: 65 20 77 68 61 74 65 76 65 72 20 70 61 74 68 6e e whatever pathn
44b0: 61 6d 65 73 20 61 72 65 20 61 70 70 72 6f 70 72 ames are appropr
44c0: 69 61 74 65 20 66 6f 72 0a 79 6f 75 72 20 70 72 iate for.your pr
44d0: 6f 6a 65 63 74 2e 20 20 54 68 65 6e 20 70 6f 69 oject. Then poi
44e0: 6e 74 20 79 6f 75 72 20 77 65 62 20 62 72 6f 77 nt your web brow
44f0: 73 65 72 20 61 74 20 74 68 65 20 73 63 72 69 70 ser at the scrip
4500: 74 20 61 6e 64 20 6f 66 66 20 79 6f 75 0a 67 6f t and off you.go
4510: 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e .</p></li>..<li>
4520: 3c 70 3e 3c 62 3e 53 65 74 74 69 6e 67 20 75 70 <p><b>Setting up
4530: 20 61 6e 20 69 6e 65 74 64 20 73 65 72 76 65 72 an inetd server
4540: 3c 2f 62 3e 3c 2f 70 3e 0a 0a 3c 70 3e 49 66 20 </b></p>..<p>If
4550: 79 6f 75 20 68 61 76 65 20 69 6e 65 74 64 20 6f you have inetd o
4560: 72 20 78 69 6e 65 74 64 20 72 75 6e 6e 69 6e 67 r xinetd running
4570: 20 6f 6e 20 79 6f 75 72 20 73 79 73 74 65 6d 2c on your system,
4580: 20 79 6f 75 20 63 61 6e 20 73 65 74 0a 74 68 6f you can set.tho
4590: 73 65 20 73 65 72 76 69 63 65 73 20 75 70 20 74 se services up t
45a0: 6f 20 6c 61 75 6e 63 68 20 66 6f 73 73 69 6c 20 o launch fossil
45b0: 74 6f 20 64 65 61 6c 20 77 69 74 68 20 69 6e 62 to deal with inb
45c0: 6f 75 6e 64 20 54 43 50 2f 49 50 20 63 6f 6e 6e ound TCP/IP conn
45d0: 65 63 74 69 6f 6e 73 0a 6f 6e 20 77 68 61 74 65 ections.on whate
45e0: 76 65 72 20 70 6f 72 74 20 79 6f 75 20 77 61 6e ver port you wan
45f0: 74 2e 20 20 53 65 74 20 75 70 20 69 6e 65 74 64 t. Set up inetd
4600: 20 6f 72 20 78 69 6e 65 74 64 20 74 6f 20 6c 61 or xinetd to la
4610: 75 6e 63 68 20 66 6f 73 73 69 6c 0a 6c 69 6b 65 unch fossil.like
4620: 20 74 68 69 73 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f this:</p>..<blo
4630: 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a 2f 75 ckquote><pre>./u
4640: 73 72 2f 6c 6f 63 61 6c 2f 62 69 6e 2f 66 6f 73 sr/local/bin/fos
4650: 73 69 6c 20 68 74 74 70 20 2f 68 6f 6d 65 2f 6d sil http /home/m
4660: 65 2f 62 69 67 70 72 6f 6a 65 63 74 2e 66 6f 73 e/bigproject.fos
4670: 73 69 6c 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63 sil.</pre></bloc
4680: 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 41 73 20 62 kquote>..<p>As b
4690: 65 66 6f 72 65 2c 20 63 68 61 6e 67 65 20 74 68 efore, change th
46a0: 65 20 66 69 6c 65 6e 61 6d 65 73 20 74 6f 20 77 e filenames to w
46b0: 68 61 74 65 76 65 72 20 69 73 20 61 70 70 72 6f hatever is appro
46c0: 70 72 69 61 74 65 20 66 6f 72 0a 79 6f 75 72 20 priate for.your
46d0: 73 79 73 74 65 6d 2e 20 20 59 6f 75 20 63 61 6e system. You can
46e0: 20 68 61 76 65 20 66 6f 73 73 69 6c 20 72 75 6e have fossil run
46f0: 20 61 73 20 61 6e 79 20 75 73 65 72 20 74 68 61 as any user tha
4700: 74 20 68 61 73 20 77 72 69 74 65 0a 70 65 72 6d t has write.perm
4710: 69 73 73 69 6f 6e 20 6f 6e 20 74 68 65 20 72 65 ission on the re
4720: 70 6f 73 69 74 6f 72 79 20 61 6e 64 20 6f 6e 20 pository and on
4730: 74 68 65 20 64 69 72 65 63 74 6f 72 79 20 74 68 the directory th
4740: 61 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 0a at contains the.
4750: 72 65 70 6f 73 69 74 6f 72 79 2e 20 20 42 75 74 repository. But
4760: 20 69 74 20 69 73 20 73 61 66 65 72 20 74 6f 20 it is safer to
4770: 72 75 6e 20 66 6f 73 73 69 6c 20 61 73 20 72 6f run fossil as ro
4780: 6f 74 2e 20 20 57 68 65 6e 20 66 6f 73 73 69 6c ot. When fossil
4790: 0a 73 65 65 73 20 74 68 61 74 20 69 74 20 69 73 .sees that it is
47a0: 20 72 75 6e 6e 69 6e 67 20 61 73 20 72 6f 6f 74 running as root
47b0: 2c 20 69 74 20 61 75 74 6f 6d 61 74 69 63 61 6c , it automatical
47c0: 6c 79 20 70 75 74 73 20 69 74 73 65 6c 66 20 69 ly puts itself i
47d0: 6e 74 6f 0a 61 20 3c 61 20 68 72 65 66 3d 22 68 nto.a <a href="h
47e0: 74 74 70 3a 2f 2f 65 6e 2e 77 69 6b 69 70 65 64 ttp://en.wikiped
47f0: 69 61 2e 6f 72 67 2f 77 69 6b 69 2f 43 68 72 6f ia.org/wiki/Chro
4800: 6f 74 22 3e 63 68 72 6f 6f 74 20 6a 61 69 6c 3c ot">chroot jail<
4810: 2f 61 3e 20 61 6e 64 0a 64 72 6f 70 73 20 61 6c /a> and.drops al
4820: 6c 20 70 72 69 76 69 6c 65 67 65 73 20 70 72 69 l privileges pri
4830: 6f 72 20 74 6f 20 72 65 61 64 69 6e 67 20 61 6e or to reading an
4840: 79 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 y information fr
4850: 6f 6d 20 74 68 65 20 63 6c 69 65 6e 74 2e 0a 53 om the client..S
4860: 69 6e 63 65 20 66 6f 73 73 69 6c 20 69 73 20 61 ince fossil is a
4870: 20 73 74 61 6e 64 2d 61 6c 6f 6e 65 20 70 72 6f stand-alone pro
4880: 67 72 61 6d 2c 20 79 6f 75 20 64 6f 20 6e 6f 74 gram, you do not
4890: 20 6e 65 65 64 20 74 6f 20 70 75 74 20 61 6e 79 need to put any
48a0: 74 68 69 6e 67 0a 69 6e 20 74 68 65 20 63 68 72 thing.in the chr
48b0: 6f 6f 74 20 6a 61 69 6c 20 77 69 74 68 20 66 6f oot jail with fo
48c0: 73 73 69 6c 20 69 6e 20 6f 72 64 65 72 20 66 6f ssil in order fo
48d0: 72 20 69 74 20 74 6f 20 64 6f 20 69 74 73 20 6a r it to do its j
48e0: 6f 62 2e 3c 2f 70 3e 0a 3c 2f 6c 69 3e 0a 3c 2f ob.</p>.</li>.</
48f0: 6f 6c 3e 0a 0a 3c 68 32 3e 36 2e 30 20 52 65 76 ol>..<h2>6.0 Rev
4900: 69 65 77 20 4f 66 20 4b 65 79 20 43 6f 6e 63 65 iew Of Key Conce
4910: 70 74 73 3c 2f 68 32 3e 0a 0a 3c 75 6c 3e 0a 3c pts</h2>..<ul>.<
4920: 6c 69 3e 54 68 65 20 3c 62 3e 66 6f 73 73 69 6c li>The <b>fossil
4930: 3c 2f 62 3e 20 70 72 6f 67 72 61 6d 20 69 73 20 </b> program is
4940: 61 20 73 65 6c 66 2d 63 6f 6e 74 61 69 6e 65 64 a self-contained
4950: 20 73 74 61 6e 64 2d 61 6c 6f 6e 65 20 65 78 65 stand-alone exe
4960: 63 75 74 61 62 6c 65 2e 0a 20 20 20 20 4a 75 73 cutable.. Jus
4970: 74 20 70 75 74 20 69 74 20 73 6f 6d 65 77 68 65 t put it somewhe
4980: 72 65 20 6f 6e 20 79 6f 75 72 20 50 41 54 48 20 re on your PATH
4990: 74 6f 20 69 6e 73 74 61 6c 6c 20 69 74 2e 3c 2f to install it.</
49a0: 6c 69 3e 0a 3c 6c 69 3e 55 73 65 20 74 68 65 20 li>.<li>Use the
49b0: 3c 62 3e 63 6c 6f 6e 65 3c 2f 62 3e 20 6f 72 20 <b>clone</b> or
49c0: 3c 62 3e 6e 65 77 3c 2f 62 3e 20 63 6f 6d 6d 61 <b>new</b> comma
49d0: 6e 64 73 20 74 6f 20 63 72 65 61 74 65 20 61 20 nds to create a
49e0: 6e 65 77 20 72 65 70 6f 73 69 74 6f 72 79 2e 3c new repository.<
49f0: 2f 6c 69 3e 0a 3c 6c 69 3e 55 73 65 20 74 68 65 /li>.<li>Use the
4a00: 20 3c 62 3e 6f 70 65 6e 3c 2f 62 3e 20 63 6f 6d <b>open</b> com
4a10: 6d 61 6e 64 20 74 6f 20 63 72 65 61 74 65 20 61 mand to create a
4a20: 20 6e 65 77 20 73 6f 75 72 63 65 20 74 72 65 65 new source tree
4a30: 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 55 73 65 20 74 .</li>.<li>Use t
4a40: 68 65 20 3c 62 3e 61 64 64 3c 2f 62 3e 20 61 6e he <b>add</b> an
4a50: 64 20 3c 62 3e 72 6d 3c 2f 62 3e 20 6f 72 20 3c d <b>rm</b> or <
4a60: 62 3e 64 65 6c 65 74 65 3c 2f 62 3e 20 63 6f 6d b>delete</b> com
4a70: 6d 61 6e 64 73 20 74 6f 20 61 64 64 20 61 6e 64 mands to add and
4a80: 0a 20 20 20 20 72 65 6d 6f 76 65 20 66 69 6c 65 . remove file
4a90: 73 20 66 72 6f 6d 20 74 68 65 20 6c 6f 63 61 6c s from the local
4aa0: 20 73 6f 75 72 63 65 20 74 72 65 65 2e 3c 2f 6c source tree.</l
4ab0: 69 3e 0a 3c 6c 69 3e 55 73 65 20 74 68 65 20 3c i>.<li>Use the <
4ac0: 62 3e 63 6f 6d 6d 69 74 3c 2f 62 3e 20 63 6f 6d b>commit</b> com
4ad0: 6d 61 6e 64 20 74 6f 20 63 72 65 61 74 65 20 61 mand to create a
4ae0: 20 6e 65 77 20 63 68 65 63 6b 2d 69 6e 2e 3c 2f new check-in.</
4af0: 6c 69 3e 0a 3c 6c 69 3e 55 73 65 20 74 68 65 20 li>.<li>Use the
4b00: 3c 62 3e 75 70 64 61 74 65 3c 2f 62 3e 20 63 6f <b>update</b> co
4b10: 6d 6d 61 6e 64 20 74 6f 20 6d 65 72 67 65 20 69 mmand to merge i
4b20: 6e 20 63 68 61 6e 67 65 73 20 66 72 6f 6d 20 6f n changes from o
4b30: 74 68 65 72 73 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e thers.</li>.<li>
4b40: 54 68 65 20 3c 62 3e 70 75 73 68 3c 2f 62 3e 20 The <b>push</b>
4b50: 61 6e 64 20 3c 62 3e 70 75 6c 6c 3c 2f 62 3e 20 and <b>pull</b>
4b60: 63 6f 6d 6d 61 6e 64 73 20 63 61 6e 20 62 65 20 commands can be
4b70: 75 73 65 64 20 74 6f 20 73 68 61 72 65 20 63 68 used to share ch
4b80: 61 6e 67 65 73 0a 20 20 20 20 6d 61 6e 75 61 6c anges. manual
4b90: 6c 79 2c 20 62 75 74 20 74 68 65 73 65 20 74 68 ly, but these th
4ba0: 69 6e 67 73 20 68 61 70 70 65 6e 20 61 75 74 6f ings happen auto
4bb0: 6d 61 74 69 63 61 6c 6c 79 20 69 6e 20 74 68 65 matically in the
4bc0: 20 64 65 66 61 75 6c 74 0a 20 20 20 20 61 75 74 default. aut
4bd0: 6f 73 79 6e 63 20 6d 6f 64 65 2e 3c 2f 6c 69 3e osync mode.</li>
4be0: 0a 3c 2f 75 6c 3e 0a .</ul>.