0000: 3c 68 31 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65 <h1 align="cente
0010: 72 22 3e 0a 46 6f 73 73 69 6c 20 43 6f 6e 63 65 r">.Fossil Conce
0020: 70 74 73 0a 3c 2f 68 31 3e 0a 0a 3c 68 32 3e 31 pts.</h1>..<h2>1
0030: 2e 30 20 49 6e 74 72 6f 64 75 63 74 69 6f 6e 3c .0 Introduction<
0040: 2f 68 32 3e 0a 3c 70 3e 0a 3c 61 20 68 72 65 66 /h2>.<p>.<a href
0050: 3d 22 69 6e 64 65 78 2e 68 74 6d 6c 22 3e 46 6f ="index.html">Fo
0060: 73 73 69 6c 3c 2f 61 3e 20 69 73 20 61 0a 3c 61 ssil</a> is a.<a
0070: 20 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f 65 6e href="http://en
0080: 2e 77 69 6b 69 70 65 64 69 61 2e 6f 72 67 2f 77 .wikipedia.org/w
0090: 69 6b 69 2f 53 6f 66 74 77 61 72 65 5f 63 6f 6e iki/Software_con
00a0: 66 69 67 75 72 61 74 69 6f 6e 5f 6d 61 6e 61 67 figuration_manag
00b0: 65 6d 65 6e 74 22 3e 0a 73 6f 66 74 77 61 72 65 ement">.software
00c0: 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6d configuration m
00d0: 61 6e 61 67 65 6d 65 6e 74 3c 2f 61 3e 20 73 79 anagement</a> sy
00e0: 73 74 65 6d 2e 0a 46 6f 73 73 69 6c 20 69 73 20 stem..Fossil is
00f0: 73 6f 66 74 77 61 72 65 20 74 68 61 74 20 69 73 software that is
0100: 20 64 65 73 69 67 6e 65 64 20 74 6f 20 63 6f 6e designed to con
0110: 74 72 6f 6c 20 61 6e 64 20 74 72 61 63 6b 20 74 trol and track t
0120: 68 65 0a 64 65 76 65 6c 6f 70 6d 65 6e 74 20 6f he.development o
0130: 66 20 61 20 73 6f 66 74 77 61 72 65 20 70 72 6f f a software pro
0140: 6a 65 63 74 20 61 6e 64 20 74 6f 20 72 65 63 6f ject and to reco
0150: 72 64 20 74 68 65 20 68 69 73 74 6f 72 79 0a 6f rd the history.o
0160: 66 20 74 68 65 20 70 72 6f 6a 65 63 74 2e 0a 54 f the project..T
0170: 68 65 72 65 20 61 72 65 20 6d 61 6e 79 20 73 75 here are many su
0180: 63 68 20 73 79 73 74 65 6d 73 20 69 6e 20 75 73 ch systems in us
0190: 65 20 74 6f 64 61 79 2e 20 20 46 6f 73 73 69 6c e today. Fossil
01a0: 20 73 74 72 69 76 65 73 20 74 6f 0a 64 69 73 74 strives to.dist
01b0: 69 6e 67 75 69 73 68 20 69 74 73 65 6c 66 20 66 inguish itself f
01c0: 72 6f 6d 20 74 68 65 20 6f 74 68 65 72 73 20 62 rom the others b
01d0: 79 20 62 65 69 6e 67 20 65 78 74 72 65 6d 65 6c y being extremel
01e0: 79 20 73 69 6d 70 6c 65 0a 74 6f 20 73 65 74 75 y simple.to setu
01f0: 70 20 61 6e 64 20 6f 70 65 72 61 74 65 2e 3c 2f p and operate.</
0200: 70 3e 0a 0a 3c 70 3e 54 68 69 73 20 64 6f 63 75 p>..<p>This docu
0210: 6d 65 6e 74 20 69 73 20 69 6e 74 65 6e 64 65 64 ment is intended
0220: 20 61 73 20 61 20 71 75 69 63 6b 20 69 6e 74 72 as a quick intr
0230: 6f 64 75 63 74 69 6f 6e 20 74 6f 20 74 68 65 20 oduction to the
0240: 63 6f 6e 63 65 70 74 73 0a 62 65 68 69 6e 64 20 concepts.behind
0250: 66 6f 73 73 69 6c 2e 3c 2f 70 3e 0a 0a 3c 68 32 fossil.</p>..<h2
0260: 3e 32 2e 30 20 43 6f 6d 70 6f 73 69 74 69 6f 6e >2.0 Composition
0270: 20 4f 66 20 41 20 50 72 6f 6a 65 63 74 3c 2f 68 Of A Project</h
0280: 32 3e 0a 3c 69 6d 67 20 73 72 63 3d 22 63 6f 6e 2>.<img src="con
0290: 63 65 70 74 31 2e 67 69 66 22 20 61 6c 69 67 6e cept1.gif" align
02a0: 3d 22 72 69 67 68 74 22 20 68 73 70 61 63 65 3d ="right" hspace=
02b0: 22 31 30 22 3e 0a 0a 3c 70 3e 41 20 73 6f 66 74 "10">..<p>A soft
02c0: 77 61 72 65 20 70 72 6f 6a 65 63 74 20 6e 6f 72 ware project nor
02d0: 6d 61 6c 6c 79 20 63 6f 6e 73 69 73 74 73 20 6f mally consists o
02e0: 66 20 61 20 22 73 6f 75 72 63 65 20 74 72 65 65 f a "source tree
02f0: 22 2e 0a 41 20 73 6f 75 72 63 65 20 74 72 65 65 "..A source tree
0300: 20 69 73 20 61 20 68 69 65 72 61 72 63 68 79 20 is a hierarchy
0310: 6f 66 20 66 69 6c 65 73 20 74 68 61 74 20 61 72 of files that ar
0320: 65 20 75 73 65 64 20 74 6f 20 67 65 6e 65 72 61 e used to genera
0330: 74 65 0a 74 68 65 20 65 6e 64 20 70 72 6f 64 75 te.the end produ
0340: 63 74 2e 20 20 54 68 65 20 73 6f 75 72 63 65 20 ct. The source
0350: 74 72 65 65 20 63 68 61 6e 67 65 73 20 6f 76 65 tree changes ove
0360: 72 20 74 69 6d 65 20 61 73 20 74 68 65 0a 73 6f r time as the.so
0370: 66 74 77 61 72 65 20 67 72 6f 77 73 20 61 6e 64 ftware grows and
0380: 20 65 78 70 61 6e 64 73 20 61 6e 64 20 61 73 20 expands and as
0390: 66 65 61 74 75 72 65 73 20 61 72 65 20 61 64 64 features are add
03a0: 65 64 20 61 6e 64 20 62 75 67 73 0a 61 72 65 20 ed and bugs.are
03b0: 66 69 78 65 64 2e 20 20 41 20 73 6e 61 70 73 68 fixed. A snapsh
03c0: 6f 74 20 6f 66 20 74 68 65 20 73 6f 75 72 63 65 ot of the source
03d0: 20 74 72 65 65 20 61 74 20 61 6e 79 20 70 6f 69 tree at any poi
03e0: 6e 74 20 69 6e 20 74 69 6d 65 0a 69 73 20 63 61 nt in time.is ca
03f0: 6c 6c 65 64 20 61 20 22 76 65 72 73 69 6f 6e 22 lled a "version"
0400: 20 6f 72 20 22 72 65 76 69 73 69 6f 6e 22 20 6f or "revision" o
0410: 72 20 61 20 22 62 61 73 65 6c 69 6e 65 22 20 6f r a "baseline" o
0420: 66 20 74 68 65 20 70 72 6f 64 75 63 74 2e 0a 49 f the product..I
0430: 6e 20 66 6f 73 73 69 6c 2c 20 77 65 20 75 73 65 n fossil, we use
0440: 20 74 68 65 20 6e 61 6d 65 20 22 62 61 73 65 6c the name "basel
0450: 69 6e 65 22 2e 3c 2f 70 3e 0a 0a 3c 70 3e 41 20 ine".</p>..<p>A
0460: 22 72 65 70 6f 73 69 74 6f 72 79 22 20 69 73 20 "repository" is
0470: 61 20 64 61 74 61 62 61 73 65 20 74 68 61 74 20 a database that
0480: 63 6f 6e 74 61 69 6e 73 20 63 6f 70 69 65 73 20 contains copies
0490: 6f 66 20 61 6c 6c 20 68 69 73 74 6f 72 69 63 61 of all historica
04a0: 6c 0a 76 65 72 73 69 6f 6e 73 20 6f 72 20 62 61 l.versions or ba
04b0: 73 65 6c 69 6e 65 73 20 66 6f 72 20 61 20 70 72 selines for a pr
04c0: 6f 6a 65 63 74 2e 20 20 42 61 73 65 6c 69 6e 65 oject. Baseline
04d0: 73 20 61 72 65 20 6e 6f 72 6d 61 6c 6c 79 20 73 s are normally s
04e0: 74 6f 72 65 64 20 69 6e 20 74 68 65 0a 72 65 70 tored in the.rep
04f0: 6f 73 69 74 6f 72 79 20 69 6e 20 61 20 68 69 67 ository in a hig
0500: 68 6c 79 20 73 70 61 63 65 2d 65 66 66 69 63 69 hly space-effici
0510: 65 6e 74 20 63 6f 6d 70 72 65 73 73 65 64 20 66 ent compressed f
0520: 6f 72 6d 61 74 20 28 64 65 6c 74 61 20 65 6e 63 ormat (delta enc
0530: 6f 64 69 6e 67 29 2e 0a 42 75 74 20 74 68 61 74 oding)..But that
0540: 20 69 73 20 61 6e 20 69 6d 70 6c 65 6d 65 6e 74 is an implement
0550: 61 74 69 6f 6e 20 64 65 74 61 69 6c 20 74 68 61 ation detail tha
0560: 74 20 79 6f 75 20 74 68 65 20 75 73 65 72 20 6e t you the user n
0570: 65 65 64 20 6e 6f 74 20 77 6f 72 72 79 20 6f 76 eed not worry ov
0580: 65 72 2e 0a 54 68 69 6e 6b 20 6f 66 20 74 68 65 er..Think of the
0590: 20 72 65 70 6f 73 69 74 6f 72 79 20 61 73 20 61 repository as a
05a0: 20 73 61 66 65 20 70 6c 61 63 65 20 77 68 65 72 safe place wher
05b0: 65 20 61 6c 6c 20 79 6f 75 72 20 6f 6c 64 20 62 e all your old b
05c0: 61 73 65 6c 69 6e 65 73 20 61 72 65 0a 73 65 63 aselines are.sec
05d0: 75 72 65 6c 79 20 73 74 6f 72 65 64 20 61 77 61 urely stored awa
05e0: 79 20 61 6e 64 20 61 76 61 69 6c 61 62 6c 65 20 y and available
05f0: 66 6f 72 20 72 65 74 72 69 65 76 61 6c 20 77 68 for retrieval wh
0600: 65 6e 65 76 65 72 20 79 6f 75 20 6e 65 65 64 0a enever you need.
0610: 74 68 65 6d 2e 3c 2f 70 3e 0a 0a 3c 70 3e 41 20 them.</p>..<p>A
0620: 72 65 70 6f 73 69 74 6f 72 79 20 69 6e 20 66 6f repository in fo
0630: 73 73 69 6c 20 69 73 20 61 20 73 69 6e 67 6c 65 ssil is a single
0640: 20 66 69 6c 65 20 6f 6e 20 79 6f 75 72 20 64 69 file on your di
0650: 73 6b 2e 20 20 54 68 69 73 20 66 69 6c 65 0a 6d sk. This file.m
0660: 69 67 68 74 20 62 65 20 72 61 74 68 65 72 20 6c ight be rather l
0670: 61 72 67 65 20 28 64 6f 7a 65 6e 73 20 6f 72 20 arge (dozens or
0680: 68 75 6e 64 72 65 64 73 20 6f 66 20 6d 65 67 61 hundreds of mega
0690: 62 79 74 65 73 20 66 6f 72 20 61 20 6c 61 72 67 bytes for a larg
06a0: 65 0a 6f 72 20 6c 6f 6e 67 20 72 75 6e 6e 69 6e e.or long runnin
06b0: 67 20 70 72 6f 6a 65 63 74 29 20 62 75 74 20 69 g project) but i
06c0: 74 20 69 73 20 6e 65 76 65 72 74 68 65 6c 65 73 t is nevertheles
06d0: 73 20 6a 75 73 74 20 61 20 66 69 6c 65 2e 20 20 s just a file.
06e0: 59 6f 75 0a 63 61 6e 20 6d 6f 76 65 20 69 74 20 You.can move it
06f0: 61 72 6f 75 6e 64 2c 20 72 65 6e 61 6d 65 20 69 around, rename i
0700: 74 2c 20 77 72 69 74 65 20 69 74 20 6f 75 74 20 t, write it out
0710: 74 6f 20 61 20 6d 65 6d 6f 72 79 20 73 74 69 63 to a memory stic
0720: 6b 2c 20 6f 72 0a 64 6f 20 61 6e 79 74 68 69 6e k, or.do anythin
0730: 67 20 65 6c 73 65 20 79 6f 75 20 6e 6f 72 6d 61 g else you norma
0740: 6c 6c 79 20 64 6f 20 77 69 74 68 20 66 69 6c 65 lly do with file
0750: 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e 45 61 63 68 20 s.</p>..<p>Each
0760: 73 6f 75 72 63 65 20 74 72 65 65 20 74 68 61 74 source tree that
0770: 20 69 73 20 63 6f 6e 74 72 6f 6c 6c 65 64 20 62 is controlled b
0780: 79 20 66 6f 73 73 69 6c 20 69 73 20 61 73 73 6f y fossil is asso
0790: 63 69 61 74 65 64 20 77 69 74 68 0a 61 20 73 69 ciated with.a si
07a0: 6e 67 6c 65 20 72 65 70 6f 73 69 74 6f 72 79 20 ngle repository
07b0: 6f 6e 20 74 68 65 20 6c 6f 63 61 6c 20 64 69 73 on the local dis
07c0: 6b 20 64 72 69 76 65 2e 20 20 59 6f 75 20 63 61 k drive. You ca
07d0: 6e 20 74 69 65 20 74 77 6f 20 6f 72 20 6d 6f 72 n tie two or mor
07e0: 65 0a 73 6f 75 72 63 65 20 74 72 65 65 73 20 74 e.source trees t
07f0: 6f 20 61 20 73 69 6e 67 6c 65 20 72 65 70 6f 73 o a single repos
0800: 69 74 6f 72 79 20 69 66 20 79 6f 75 20 77 61 6e itory if you wan
0810: 74 20 28 74 68 6f 75 67 68 20 6f 6e 65 0a 74 72 t (though one.tr
0820: 65 65 20 70 65 72 20 72 65 70 6f 73 69 74 6f 72 ee per repositor
0830: 79 20 69 73 20 74 68 65 20 6d 6f 73 74 20 63 6f y is the most co
0840: 6d 6d 6f 6e 20 63 6f 6e 66 69 67 75 72 61 74 69 mmon configurati
0850: 6f 6e 2e 29 20 20 53 6f 20 61 0a 73 69 6e 67 6c on.) So a.singl
0860: 65 20 72 65 70 6f 73 69 74 6f 72 79 20 63 61 6e e repository can
0870: 20 62 65 20 61 73 73 6f 63 69 61 74 65 64 20 77 be associated w
0880: 69 74 68 20 6d 61 6e 79 20 73 6f 75 72 63 65 20 ith many source
0890: 74 72 65 65 73 2c 20 62 75 74 0a 65 61 63 68 20 trees, but.each
08a0: 73 6f 75 72 63 65 20 74 72 65 65 20 69 73 20 61 source tree is a
08b0: 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 6f ssociated with o
08c0: 6e 6c 79 20 6f 6e 65 20 72 65 70 6f 73 69 74 6f nly one reposito
08d0: 72 79 2e 3c 2f 70 3e 0a 0a 3c 70 3e 46 6f 73 73 ry.</p>..<p>Foss
08e0: 69 6c 20 73 6f 75 72 63 65 20 74 72 65 65 73 20 il source trees
08f0: 6d 61 79 20 6e 6f 74 20 6f 76 65 72 6c 61 70 2e may not overlap.
0900: 20 20 41 20 66 6f 73 73 69 6c 20 73 6f 75 72 63 A fossil sourc
0910: 65 20 74 72 65 65 20 69 73 20 69 64 65 6e 74 69 e tree is identi
0920: 66 69 65 64 0a 62 79 20 61 20 66 69 6c 65 20 6e fied.by a file n
0930: 61 6d 65 64 20 22 5f 46 4f 53 53 49 4c 5f 22 20 amed "_FOSSIL_"
0940: 69 6e 20 74 68 65 20 72 6f 6f 74 20 64 69 72 65 in the root dire
0950: 63 74 6f 72 79 20 6f 66 20 74 68 65 20 73 6f 75 ctory of the sou
0960: 72 63 65 20 74 72 65 65 2e 20 20 45 76 65 72 79 rce tree. Every
0970: 0a 66 69 6c 65 20 74 68 61 74 20 69 73 20 61 20 .file that is a
0980: 73 69 62 6c 69 6e 67 20 6f 66 20 5f 46 4f 53 53 sibling of _FOSS
0990: 49 4c 5f 20 61 6e 64 20 65 76 65 72 79 20 66 69 IL_ and every fi
09a0: 6c 65 20 69 6e 20 65 76 65 72 79 20 73 75 62 66 le in every subf
09b0: 6f 6c 64 65 72 20 69 73 0a 63 6f 6e 73 69 64 65 older is.conside
09c0: 72 65 64 20 70 6f 74 65 6e 74 69 61 6c 6c 79 20 red potentially
09d0: 61 20 70 61 72 74 20 6f 66 20 74 68 65 20 73 6f a part of the so
09e0: 75 72 63 65 20 74 72 65 65 2e 20 20 54 68 65 20 urce tree. The
09f0: 5f 46 4f 53 53 49 4c 5f 20 66 69 6c 65 0a 63 6f _FOSSIL_ file.co
0a00: 6e 74 61 69 6e 73 20 28 61 6d 6f 6e 67 20 6f 74 ntains (among ot
0a10: 68 65 72 20 74 68 69 6e 67 73 29 20 74 68 65 20 her things) the
0a20: 70 61 74 68 6e 61 6d 65 20 6f 66 20 74 68 65 20 pathname of the
0a30: 72 65 70 6f 73 69 74 6f 72 79 20 77 69 74 68 20 repository with
0a40: 77 68 69 63 68 0a 74 68 65 20 73 6f 75 72 63 65 which.the source
0a50: 20 74 72 65 65 20 69 73 20 61 73 73 6f 63 69 61 tree is associa
0a60: 74 65 64 2e 20 20 4f 6e 20 74 68 65 20 6f 74 68 ted. On the oth
0a70: 65 72 20 68 61 6e 64 2c 20 74 68 65 20 72 65 70 er hand, the rep
0a80: 6f 73 69 74 6f 72 79 20 68 61 73 0a 6e 6f 20 72 ository has.no r
0a90: 65 63 6f 72 64 20 6f 66 20 69 74 73 20 73 6f 75 ecord of its sou
0aa0: 72 63 65 20 74 72 65 65 73 2e 20 20 53 6f 20 79 rce trees. So y
0ab0: 6f 75 20 61 72 65 20 66 72 65 65 20 74 6f 20 64 ou are free to d
0ac0: 65 6c 65 74 65 20 61 20 73 6f 75 72 63 65 20 74 elete a source t
0ad0: 72 65 65 0a 6f 72 20 6d 6f 76 65 20 69 74 20 61 ree.or move it a
0ae0: 72 6f 75 6e 64 20 77 69 74 68 6f 75 74 20 63 6f round without co
0af0: 6e 73 65 71 75 65 6e 63 65 2e 20 20 42 75 74 20 nsequence. But
0b00: 69 66 20 79 6f 75 20 6d 6f 76 65 20 6f 72 20 72 if you move or r
0b10: 65 6e 61 6d 65 20 6f 72 0a 64 65 6c 65 74 65 20 ename or.delete
0b20: 61 20 72 65 70 6f 73 69 74 6f 72 79 2c 20 74 68 a repository, th
0b30: 65 6e 20 61 6e 79 20 73 6f 75 72 63 65 20 74 72 en any source tr
0b40: 65 65 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 ees associated w
0b50: 69 74 68 20 74 68 61 74 20 72 65 70 6f 73 69 74 ith that reposit
0b60: 6f 72 79 0a 77 69 6c 6c 20 6e 6f 20 6c 6f 6e 67 ory.will no long
0b70: 65 72 20 62 65 20 61 62 6c 65 20 74 6f 20 6c 6f er be able to lo
0b80: 63 61 74 65 20 74 68 65 69 72 20 72 65 70 6f 73 cate their repos
0b90: 69 74 6f 72 79 20 61 6e 64 20 77 69 6c 6c 20 73 itory and will s
0ba0: 74 6f 70 20 77 6f 72 6b 69 6e 67 2e 3c 2f 70 3e top working.</p>
0bb0: 0a 0a 3c 70 3e 57 68 65 6e 20 6d 75 6c 74 69 70 ..<p>When multip
0bc0: 6c 65 20 64 65 76 65 6c 6f 70 65 72 73 20 61 72 le developers ar
0bd0: 65 20 77 6f 72 6b 69 6e 67 20 6f 6e 20 74 68 65 e working on the
0be0: 20 73 61 6d 65 20 70 72 6f 6a 65 63 74 2c 20 65 same project, e
0bf0: 61 63 68 0a 64 65 76 65 6c 6f 70 65 72 20 74 79 ach.developer ty
0c00: 70 69 63 61 6c 6c 79 20 68 61 73 20 68 69 73 20 pically has his
0c10: 6f 72 20 68 65 72 20 6f 77 6e 20 6c 6f 63 61 6c or her own local
0c20: 20 72 65 70 6f 73 69 74 6f 72 79 20 61 6e 64 20 repository and
0c30: 61 6e 20 61 73 73 6f 63 69 61 74 65 64 0a 73 6f an associated.so
0c40: 75 72 63 65 20 74 72 65 65 20 69 6e 20 77 68 69 urce tree in whi
0c50: 63 68 20 74 6f 20 77 6f 72 6b 2e 20 20 44 65 76 ch to work. Dev
0c60: 65 6c 6f 70 65 72 73 20 73 68 61 72 65 20 74 68 elopers share th
0c70: 65 69 72 20 77 6f 72 6b 20 62 79 0a 22 73 79 6e eir work by."syn
0c80: 63 69 6e 67 22 20 74 68 65 20 63 6f 6e 74 65 6e cing" the conten
0c90: 74 20 6f 66 20 74 68 65 69 72 20 6c 6f 63 61 6c t of their local
0ca0: 20 72 65 70 6f 73 69 74 6f 72 69 65 73 20 65 69 repositories ei
0cb0: 74 68 65 72 20 64 69 72 65 63 74 6c 79 0a 6f 72 ther directly.or
0cc0: 20 74 68 72 6f 75 67 68 20 61 20 63 65 6e 74 72 through a centr
0cd0: 61 6c 20 73 65 72 76 65 72 2e 20 20 43 68 61 6e al server. Chan
0ce0: 67 65 73 20 63 61 6e 20 22 70 75 73 68 22 20 66 ges can "push" f
0cf0: 72 6f 6d 20 74 68 65 20 6c 6f 63 61 6c 0a 72 65 rom the local.re
0d00: 70 6f 73 69 74 6f 72 79 20 69 6e 74 6f 20 61 20 pository into a
0d10: 72 65 6d 6f 74 65 20 72 65 70 6f 73 69 74 6f 72 remote repositor
0d20: 79 2e 20 20 4f 72 20 63 68 61 6e 67 65 73 20 63 y. Or changes c
0d30: 61 6e 20 22 70 75 6c 6c 22 20 66 72 6f 6d 20 61 an "pull" from a
0d40: 0a 72 65 6d 6f 74 65 20 72 65 70 6f 73 69 74 6f .remote reposito
0d50: 72 79 20 69 6e 74 6f 20 61 20 6c 6f 63 61 6c 20 ry into a local
0d60: 72 65 70 6f 73 69 74 6f 72 79 2e 20 20 4f 72 20 repository. Or
0d70: 6f 6e 65 20 63 61 6e 20 64 6f 20 61 20 22 73 79 one can do a "sy
0d80: 6e 63 22 0a 77 68 69 63 68 20 69 73 20 61 20 73 nc".which is a s
0d90: 68 6f 72 74 63 75 74 20 66 6f 72 20 64 6f 69 6e hortcut for doin
0da0: 67 20 62 6f 74 68 20 61 20 70 75 73 68 20 61 6e g both a push an
0db0: 64 20 61 20 70 75 6c 6c 20 61 74 20 74 68 65 20 d a pull at the
0dc0: 73 61 6d 65 20 74 69 6d 65 2e 0a 46 6f 73 73 69 same time..Fossi
0dd0: 6c 20 61 6c 73 6f 20 68 61 73 20 74 68 65 20 63 l also has the c
0de0: 6f 6e 63 65 70 74 20 6f 66 20 22 63 6c 6f 6e 69 oncept of "cloni
0df0: 6e 67 22 2e 20 20 41 20 22 63 6c 6f 6e 65 22 20 ng". A "clone"
0e00: 69 73 20 6c 69 6b 65 20 61 20 22 70 75 6c 6c 22 is like a "pull"
0e10: 2c 0a 65 78 63 65 70 74 20 74 68 61 74 20 69 6e ,.except that in
0e20: 73 74 65 61 64 20 6f 66 20 62 65 67 69 6e 6e 69 stead of beginni
0e30: 6e 67 20 77 69 74 68 20 61 6e 20 65 78 69 73 74 ng with an exist
0e40: 69 6e 67 20 6c 6f 63 61 6c 20 72 65 70 6f 73 69 ing local reposi
0e50: 74 6f 72 79 2c 0a 61 20 63 6c 6f 6e 65 20 62 65 tory,.a clone be
0e60: 67 69 6e 73 20 77 69 74 68 20 6e 6f 74 68 69 6e gins with nothin
0e70: 67 20 61 6e 64 20 63 72 65 61 74 65 73 20 61 20 g and creates a
0e80: 6e 65 77 20 6c 6f 63 61 6c 20 72 65 70 6f 73 69 new local reposi
0e90: 74 6f 72 79 20 74 68 61 74 0a 69 73 20 61 20 64 tory that.is a d
0ea0: 75 70 6c 69 63 61 74 65 20 6f 66 20 61 20 72 65 uplicate of a re
0eb0: 6d 6f 74 65 20 72 65 70 6f 73 69 74 6f 72 79 2e mote repository.
0ec0: 3c 2f 70 3e 0a 0a 3c 70 3e 43 6f 6d 6d 75 6e 69 </p>..<p>Communi
0ed0: 63 61 74 69 6f 6e 20 62 65 74 77 65 65 6e 20 72 cation between r
0ee0: 65 70 6f 73 69 74 6f 72 69 65 73 20 69 73 20 76 epositories is v
0ef0: 69 61 20 48 54 54 50 2e 20 20 52 65 6d 6f 74 65 ia HTTP. Remote
0f00: 0a 72 65 70 6f 73 69 74 6f 72 69 65 73 20 61 72 .repositories ar
0f10: 65 20 69 64 65 6e 74 69 66 69 65 64 20 62 79 20 e identified by
0f20: 55 52 4c 2e 20 20 59 6f 75 20 63 61 6e 20 61 6c URL. You can al
0f30: 73 6f 20 70 6f 69 6e 74 20 61 20 77 65 62 62 72 so point a webbr
0f40: 6f 77 73 65 72 0a 61 74 20 61 20 72 65 70 6f 73 owser.at a repos
0f50: 69 74 6f 72 79 20 61 6e 64 20 67 65 74 20 68 75 itory and get hu
0f60: 6d 61 6e 2d 72 65 61 64 61 62 6c 65 20 73 74 61 man-readable sta
0f70: 74 75 73 2c 20 68 69 73 74 6f 72 79 2c 20 61 6e tus, history, an
0f80: 64 20 74 72 61 63 6b 69 6e 67 0a 69 6e 66 6f 72 d tracking.infor
0f90: 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 mation about the
0fa0: 20 70 72 6f 6a 65 63 74 2e 3c 2f 70 3e 0a 0a 3c project.</p>..<
0fb0: 68 33 3e 32 2e 31 20 49 64 65 6e 74 69 66 69 63 h3>2.1 Identific
0fc0: 61 74 69 6f 6e 20 4f 66 20 41 72 74 69 66 61 63 ation Of Artifac
0fd0: 74 73 3c 2f 68 33 3e 0a 0a 3c 70 3e 41 20 70 61 ts</h3>..<p>A pa
0fe0: 72 74 69 63 75 6c 61 72 20 76 65 72 73 69 6f 6e rticular version
0ff0: 20 6f 66 20 61 20 70 61 72 74 69 63 75 6c 61 72 of a particular
1000: 20 66 69 6c 65 20 69 73 20 63 61 6c 6c 65 64 20 file is called
1010: 61 6e 20 22 61 72 74 69 66 61 63 74 22 2e 0a 45 an "artifact"..E
1020: 61 63 68 20 61 72 74 69 66 61 63 74 20 68 61 73 ach artifact has
1030: 20 61 20 75 6e 69 76 65 72 73 61 6c 6c 79 20 75 a universally u
1040: 6e 69 71 75 65 20 6e 61 6d 65 20 77 68 69 63 68 nique name which
1050: 20 69 73 20 74 68 65 0a 3c 61 20 68 72 65 66 3d is the.<a href=
1060: 22 68 74 74 70 3a 2f 2f 65 6e 2e 77 69 6b 69 70 "http://en.wikip
1070: 65 64 69 61 2e 6f 72 67 2f 77 69 6b 69 2f 53 48 edia.org/wiki/SH
1080: 41 22 3e 53 48 41 31 3c 2f 61 3e 20 68 61 73 68 A">SHA1</a> hash
1090: 20 6f 66 20 74 68 65 20 63 6f 6e 74 65 6e 74 0a of the content.
10a0: 6f 66 20 74 68 61 74 20 66 69 6c 65 20 65 78 70 of that file exp
10b0: 72 65 73 73 65 64 20 61 73 20 34 30 20 63 68 61 ressed as 40 cha
10c0: 72 61 63 74 65 72 73 20 6f 66 20 6c 6f 77 65 72 racters of lower
10d0: 2d 63 61 73 65 20 68 65 78 61 64 65 63 69 6d 61 -case hexadecima
10e0: 6c 2e 20 20 53 75 63 68 0a 61 20 68 61 73 68 20 l. Such.a hash
10f0: 69 73 20 72 65 66 65 72 72 65 64 20 74 6f 20 61 is referred to a
1100: 73 20 74 68 65 20 55 6e 69 76 65 72 73 61 6c 6c s the Universall
1110: 79 20 55 6e 69 71 75 65 20 49 64 65 6e 74 69 66 y Unique Identif
1120: 69 65 72 20 6f 72 20 55 55 49 44 0a 66 6f 72 20 ier or UUID.for
1130: 74 68 65 20 61 72 74 69 66 61 63 74 2e 20 20 54 the artifact. T
1140: 68 65 20 53 48 41 31 20 61 6c 67 6f 72 69 74 68 he SHA1 algorith
1150: 6d 20 69 73 20 63 72 65 61 74 65 64 20 77 69 74 m is created wit
1160: 68 20 74 68 65 20 70 75 72 70 6f 73 65 20 6f 66 h the purpose of
1170: 0a 70 72 6f 76 69 64 69 6e 67 20 61 20 68 69 67 .providing a hig
1180: 68 6c 79 20 66 6f 72 67 65 72 79 2d 72 65 73 69 hly forgery-resi
1190: 73 74 65 6e 74 20 69 64 65 6e 74 69 66 69 65 72 stent identifier
11a0: 20 66 6f 72 20 61 20 66 69 6c 65 2e 20 20 47 69 for a file. Gi
11b0: 76 65 6e 20 61 6e 79 0a 66 69 6c 65 20 69 74 20 ven any.file it
11c0: 69 73 20 73 69 6d 70 6c 65 20 74 6f 20 66 69 6e is simple to fin
11d0: 64 20 74 68 65 20 55 55 49 44 20 66 6f 72 20 74 d the UUID for t
11e0: 68 61 74 20 66 69 6c 65 2e 20 20 42 75 74 20 67 hat file. But g
11f0: 69 76 65 6e 20 61 0a 55 55 49 44 20 69 74 20 69 iven a.UUID it i
1200: 73 20 63 6f 6d 70 75 74 61 74 69 6f 6e 61 6c 6c s computationall
1210: 79 20 69 6e 74 72 61 63 74 61 62 6c 65 20 74 6f y intractable to
1220: 20 67 65 6e 65 72 61 74 65 20 61 20 66 69 6c 65 generate a file
1230: 20 74 68 61 74 20 77 69 6c 6c 0a 68 61 76 65 20 that will.have
1240: 74 68 61 74 20 55 55 49 44 2e 3c 2f 70 3e 0a 0a that UUID.</p>..
1250: 0a 3c 70 3e 55 55 49 44 73 20 6c 6f 6f 6b 20 73 .<p>UUIDs look s
1260: 6f 6d 65 74 68 69 6e 67 20 6c 69 6b 65 20 74 68 omething like th
1270: 69 73 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 is:</p>..<blockq
1280: 75 6f 74 65 3e 3c 62 3e 0a 36 30 38 39 66 30 62 uote><b>.6089f0b
1290: 35 36 33 61 39 64 62 30 61 36 64 39 30 36 38 32 563a9db0a6d90682
12a0: 66 65 34 37 66 64 37 31 36 31 66 66 38 36 37 63 fe47fd7161ff867c
12b0: 38 3c 62 72 3e 0a 35 39 37 31 32 36 31 34 61 31 8<br>.59712614a1
12c0: 62 33 63 63 66 64 38 34 30 37 38 61 33 37 66 61 b3ccfd84078a37fa
12d0: 35 62 36 30 36 65 32 38 34 33 34 33 32 36 3c 62 5b606e28434326<b
12e0: 72 3e 0a 31 39 64 62 66 37 33 30 37 38 62 65 39 r>.19dbf73078be9
12f0: 37 37 39 65 64 64 36 61 30 31 35 36 31 39 35 65 779edd6a0156195e
1300: 36 31 30 66 38 31 63 39 34 66 39 3c 62 72 3e 0a 610f81c94f9<br>.
1310: 62 34 31 30 34 39 35 39 61 36 37 31 37 35 66 30 b4104959a67175f0
1320: 32 64 36 62 34 31 35 34 38 30 62 65 32 32 61 32 2d6b415480be22a2
1330: 33 39 66 31 66 30 37 37 3c 62 72 3e 0a 39 39 37 39f1f077<br>.997
1340: 63 39 64 36 61 65 30 33 61 64 31 31 34 62 32 62 c9d6ae03ad114b2b
1350: 35 37 66 30 34 65 39 65 65 65 66 31 37 64 63 62 57f04e9eeef17dcb
1360: 38 32 37 38 38 0a 3c 2f 62 3e 3c 2f 62 6c 6f 63 82788.</b></bloc
1370: 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 57 68 65 6e kquote>..<p>When
1380: 20 72 65 66 65 72 72 69 6e 67 20 74 6f 20 61 6e referring to an
1390: 20 61 72 74 69 66 61 63 74 20 75 73 69 6e 67 20 artifact using
13a0: 66 6f 73 73 69 6c 2c 20 79 6f 75 20 63 61 6e 20 fossil, you can
13b0: 75 73 65 20 61 20 75 6e 69 71 75 65 0a 70 72 65 use a unique.pre
13c0: 66 69 78 20 6f 66 20 74 68 65 20 55 55 49 44 20 fix of the UUID
13d0: 74 68 61 74 20 69 73 20 66 6f 75 72 20 63 68 61 that is four cha
13e0: 72 61 63 74 65 72 73 20 6f 72 20 6c 6f 6e 67 65 racters or longe
13f0: 72 2e 20 20 54 68 69 73 20 73 61 76 65 73 0a 61 r. This saves.a
1400: 20 6c 6f 74 20 6f 66 20 74 79 70 69 6e 67 2e 20 lot of typing.
1410: 20 57 68 65 6e 20 64 69 73 70 6c 61 79 69 6e 67 When displaying
1420: 20 55 55 49 44 73 2c 20 66 6f 73 73 69 6c 20 77 UUIDs, fossil w
1430: 69 6c 6c 20 75 73 75 61 6c 6c 79 20 6f 6e 6c 79 ill usually only
1440: 0a 73 68 6f 77 20 74 68 65 20 66 69 72 73 74 20 .show the first
1450: 31 30 20 64 69 67 69 74 73 20 73 69 6e 63 65 20 10 digits since
1460: 74 68 61 74 20 69 73 20 6e 6f 72 6d 61 6c 6c 79 that is normally
1470: 20 65 6e 6f 75 67 68 20 74 6f 20 75 6e 69 71 75 enough to uniqu
1480: 65 6c 79 0a 69 64 65 6e 74 69 66 79 20 61 20 66 ely.identify a f
1490: 69 6c 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 43 68 61 ile.</p>..<p>Cha
14a0: 6e 67 69 6e 67 20 28 6f 72 20 61 64 64 69 6e 67 nging (or adding
14b0: 20 6f 72 20 72 65 6d 6f 76 69 6e 67 29 20 61 20 or removing) a
14c0: 73 69 6e 67 6c 65 20 62 79 74 65 20 69 6e 20 61 single byte in a
14d0: 20 66 69 6c 65 20 72 65 73 75 6c 74 73 0a 69 6e file results.in
14e0: 20 61 20 63 6f 6d 70 6c 65 74 65 6c 79 20 64 69 a completely di
14f0: 66 66 65 72 65 6e 74 20 55 55 49 44 2e 20 20 41 fferent UUID. A
1500: 6e 64 20 73 69 6e 63 65 20 74 68 65 20 55 55 49 nd since the UUI
1510: 44 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 D is the name of
1520: 0a 74 68 65 20 61 72 74 69 66 61 63 74 2c 20 6d .the artifact, m
1530: 61 6b 69 6e 67 20 61 6e 79 20 63 68 61 6e 67 65 aking any change
1540: 20 74 6f 20 61 20 66 69 6c 65 20 72 65 73 75 6c to a file resul
1550: 74 73 20 69 6e 20 61 20 6e 65 77 20 61 72 74 69 ts in a new arti
1560: 66 61 63 74 2e 0a 49 6e 20 74 68 69 73 20 77 61 fact..In this wa
1570: 79 2c 20 61 72 74 69 66 61 63 74 73 20 61 72 65 y, artifacts are
1580: 20 69 6d 6d 75 74 61 62 6c 65 2e 3c 2f 70 3e 0a immutable.</p>.
1590: 0a 3c 70 3e 41 20 72 65 70 6f 73 69 74 6f 72 79 .<p>A repository
15a0: 20 69 73 20 72 65 61 6c 6c 79 20 6a 75 73 74 20 is really just
15b0: 61 6e 20 75 6e 6f 72 64 65 72 65 64 20 63 6f 6c an unordered col
15c0: 6c 65 63 74 69 6f 6e 20 6f 66 0a 61 72 74 69 66 lection of.artif
15d0: 61 63 74 73 2e 20 20 4e 65 77 20 61 72 74 69 66 acts. New artif
15e0: 61 63 74 73 20 63 61 6e 20 62 65 20 61 64 64 65 acts can be adde
15f0: 64 20 74 6f 20 74 68 65 20 72 65 70 6f 73 69 74 d to the reposit
1600: 6f 72 79 2c 20 62 75 74 0a 65 78 69 73 74 69 6e ory, but.existin
1610: 67 20 61 72 74 69 66 61 63 74 73 20 63 61 6e 20 g artifacts can
1620: 6e 65 76 65 72 20 62 65 20 72 65 6d 6f 76 65 64 never be removed
1630: 2e 20 20 46 6f 73 73 69 6c 20 69 73 20 64 65 73 . Fossil is des
1640: 69 67 6e 65 64 20 69 6e 0a 73 75 63 68 20 61 20 igned in.such a
1650: 77 61 79 20 74 68 61 74 20 69 74 20 63 61 6e 20 way that it can
1660: 62 65 20 68 61 6e 64 65 64 20 61 20 73 65 74 20 be handed a set
1670: 6f 66 20 61 72 74 69 66 61 63 74 73 20 69 6e 20 of artifacts in
1680: 61 6e 79 0a 6f 72 64 65 72 20 61 6e 64 20 69 74 any.order and it
1690: 20 63 61 6e 20 66 69 67 75 72 65 20 6f 75 74 20 can figure out
16a0: 74 68 65 20 72 65 6c 61 74 69 6f 6e 73 68 69 70 the relationship
16b0: 20 62 65 74 77 65 65 6e 20 74 68 6f 73 65 0a 61 between those.a
16c0: 72 74 69 66 61 63 74 73 20 61 6e 64 20 72 65 63 rtifacts and rec
16d0: 6f 6e 73 74 72 75 63 74 20 74 68 65 20 63 6f 6d onstruct the com
16e0: 70 6c 65 74 65 20 64 65 76 65 6c 6f 70 6d 65 6e plete developmen
16f0: 74 20 68 69 73 74 6f 72 79 20 6f 66 0a 61 20 73 t history of.a s
1700: 6f 66 74 77 61 72 65 20 70 72 6f 6a 65 63 74 2e oftware project.
1710: 3c 2f 70 3e 0a 0a 3c 68 33 3e 32 2e 32 20 4d 61 </p>..<h3>2.2 Ma
1720: 6e 69 66 65 73 74 73 3c 2f 68 33 3e 0a 0a 3c 70 nifests</h3>..<p
1730: 3e 41 74 20 74 68 65 20 72 6f 6f 74 20 6f 66 20 >At the root of
1740: 61 20 73 6f 75 72 63 65 20 74 72 65 65 20 69 73 a source tree is
1750: 20 61 20 73 70 65 63 69 61 6c 20 66 69 6c 65 20 a special file
1760: 63 61 6c 6c 65 64 20 74 68 65 0a 22 6d 61 6e 69 called the."mani
1770: 66 65 73 74 22 2e 20 20 54 68 65 20 6d 61 6e 69 fest". The mani
1780: 66 65 73 74 20 69 73 20 61 20 6c 69 73 74 69 6e fest is a listin
1790: 67 20 6f 66 20 61 6c 6c 20 6f 74 68 65 72 20 66 g of all other f
17a0: 69 6c 65 73 20 69 6e 0a 74 68 61 74 20 73 6f 75 iles in.that sou
17b0: 72 63 65 20 74 72 65 65 2e 20 20 54 68 65 20 6d rce tree. The m
17c0: 61 6e 69 66 65 73 74 20 63 6f 6e 74 61 69 6e 73 anifest contains
17d0: 20 74 68 65 20 28 63 6f 6d 70 6c 65 74 65 29 20 the (complete)
17e0: 55 55 49 44 20 0a 6f 66 20 74 68 65 20 66 69 6c UUID .of the fil
17f0: 65 20 61 6e 64 20 74 68 65 20 6e 61 6d 65 20 6f e and the name o
1800: 66 20 74 68 65 20 66 69 6c 65 20 61 73 20 69 74 f the file as it
1810: 20 61 70 70 65 61 72 73 20 6f 6e 20 64 69 73 6b appears on disk
1820: 2c 0a 61 6e 64 20 74 68 75 73 20 73 65 72 76 65 ,.and thus serve
1830: 73 20 61 73 20 61 20 6d 61 70 70 69 6e 67 20 66 s as a mapping f
1840: 72 6f 6d 20 55 55 49 44 20 74 6f 20 64 69 73 6b rom UUID to disk
1850: 20 6e 61 6d 65 2e 20 20 54 68 65 20 55 55 49 44 name. The UUID
1860: 0a 6f 66 20 74 68 65 20 6d 61 6e 69 66 65 73 74 .of the manifest
1870: 20 69 73 20 74 68 65 20 55 55 49 44 20 74 68 61 is the UUID tha
1880: 74 20 69 64 65 6e 74 69 66 69 65 73 20 61 20 62 t identifies a b
1890: 61 73 65 6c 69 6e 65 2e 20 20 57 68 65 6e 0a 79 aseline. When.y
18a0: 6f 75 20 6c 6f 6f 6b 20 61 74 20 61 20 22 74 69 ou look at a "ti
18b0: 6d 65 6c 69 6e 65 22 20 6f 66 20 63 68 61 6e 67 meline" of chang
18c0: 65 73 20 69 6e 20 66 6f 73 73 69 6c 2c 20 74 68 es in fossil, th
18d0: 65 20 55 55 49 44 20 61 73 73 6f 63 69 61 74 65 e UUID associate
18e0: 64 0a 77 69 74 68 20 65 61 63 68 20 63 68 65 63 d.with each chec
18f0: 6b 2d 69 6e 20 6f 72 20 63 6f 6d 6d 69 74 20 69 k-in or commit i
1900: 73 20 72 65 61 6c 6c 79 20 6a 75 73 74 20 74 68 s really just th
1910: 65 20 55 55 49 44 20 6f 66 20 74 68 65 0a 6d 61 e UUID of the.ma
1920: 6e 69 66 65 73 74 20 66 6f 72 20 74 68 61 74 20 nifest for that
1930: 62 61 73 65 6c 69 6e 65 2e 3c 2f 70 3e 0a 0a 3c baseline.</p>..<
1940: 70 3e 46 6f 73 73 69 6c 20 61 75 74 6f 6d 61 74 p>Fossil automat
1950: 69 63 61 6c 6c 79 20 67 65 6e 65 72 61 74 65 73 ically generates
1960: 20 61 20 6d 61 6e 69 66 65 73 74 20 77 68 65 6e a manifest when
1970: 65 76 65 72 20 79 6f 75 20 22 63 6f 6d 6d 69 74 ever you "commit
1980: 22 20 0a 61 20 6e 65 77 20 62 61 73 65 6c 69 6e " .a new baselin
1990: 65 2e 20 20 53 6f 20 74 68 69 73 20 69 73 20 6e e. So this is n
19a0: 6f 74 20 73 6f 6d 65 74 68 69 6e 67 20 74 68 61 ot something tha
19b0: 74 20 79 6f 75 2c 20 74 68 65 20 64 65 76 65 6c t you, the devel
19c0: 6f 70 65 72 2c 0a 6e 65 65 64 20 74 6f 20 77 6f oper,.need to wo
19d0: 72 72 79 20 77 69 74 68 2e 20 20 54 68 65 20 66 rry with. The f
19e0: 6f 72 6d 61 74 20 6f 66 20 61 20 6d 61 6e 69 66 ormat of a manif
19f0: 65 73 74 20 69 73 20 69 6e 74 65 6e 74 69 6f 6e est is intention
1a00: 61 6c 6c 79 0a 64 65 73 69 67 6e 65 64 20 74 6f ally.designed to
1a10: 20 62 65 20 73 69 6d 70 6c 65 20 74 6f 20 70 61 be simple to pa
1a20: 72 73 65 2c 20 73 6f 20 74 68 61 74 20 69 66 0a rse, so that if.
1a30: 79 6f 75 20 77 61 6e 74 20 74 6f 20 72 65 61 64 you want to read
1a40: 20 61 6e 64 20 69 6e 74 65 72 70 72 65 74 20 61 and interpret a
1a50: 20 6d 61 6e 69 66 65 73 74 2c 20 65 69 74 68 65 manifest, eithe
1a60: 72 20 62 79 20 68 61 6e 64 20 6f 72 0a 77 69 74 r by hand or.wit
1a70: 68 20 61 20 73 63 72 69 70 74 2c 20 74 68 61 74 h a script, that
1a80: 20 69 73 20 65 61 73 79 20 74 6f 20 64 6f 2e 20 is easy to do.
1a90: 20 42 75 74 20 79 6f 75 20 77 69 6c 6c 20 70 72 But you will pr
1aa0: 6f 62 61 62 6c 79 20 6e 65 76 65 72 0a 6e 65 65 obably never.nee
1ab0: 64 20 74 6f 20 64 6f 20 73 6f 2e 3c 2f 70 3e 0a d to do so.</p>.
1ac0: 0a 3c 70 3e 49 6e 20 61 64 64 69 74 69 6f 6e 20 .<p>In addition
1ad0: 74 6f 20 69 64 65 6e 74 69 66 79 69 6e 67 20 61 to identifying a
1ae0: 6c 6c 20 66 69 6c 65 73 20 69 6e 20 74 68 65 20 ll files in the
1af0: 62 61 73 65 6c 69 6e 65 2c 20 61 0a 6d 61 6e 69 baseline, a.mani
1b00: 66 65 73 74 20 61 6c 73 6f 20 63 6f 6e 74 61 69 fest also contai
1b10: 6e 73 20 61 20 63 68 65 63 6b 2d 69 6e 20 63 6f ns a check-in co
1b20: 6d 6d 65 6e 74 2c 20 74 68 65 20 64 61 74 65 20 mment, the date
1b30: 61 6e 64 20 74 69 6d 65 0a 77 68 65 6e 20 74 68 and time.when th
1b40: 65 20 62 61 73 65 6c 69 6e 65 20 77 61 73 20 65 e baseline was e
1b50: 73 74 61 62 6c 69 73 68 65 64 2c 20 77 68 6f 20 stablished, who
1b60: 63 72 65 61 74 65 64 20 74 68 65 20 62 61 73 65 created the base
1b70: 6c 69 6e 65 2c 0a 61 6e 64 20 6c 69 6e 6b 73 20 line,.and links
1b80: 74 6f 20 6f 74 68 65 72 20 62 61 73 65 6c 69 6e to other baselin
1b90: 65 73 20 66 72 6f 6d 20 77 68 69 63 68 20 74 68 es from which th
1ba0: 65 20 63 75 72 72 65 6e 74 20 62 61 73 65 6c 69 e current baseli
1bb0: 6e 65 0a 69 73 20 64 65 72 69 76 65 64 2e 20 20 ne.is derived.
1bc0: 54 68 65 72 65 20 69 73 20 61 6c 73 6f 20 61 20 There is also a
1bd0: 63 6f 75 70 6c 65 20 6f 66 20 63 68 65 63 6b 73 couple of checks
1be0: 75 6d 73 20 75 73 65 64 20 74 6f 20 76 65 72 69 ums used to veri
1bf0: 66 79 0a 74 68 65 20 69 6e 74 65 67 72 69 74 79 fy.the integrity
1c00: 20 6f 66 20 74 68 65 20 62 61 73 65 6c 69 6e 65 of the baseline
1c10: 2e 20 20 41 6e 64 20 74 68 65 20 77 68 6f 6c 65 . And the whole
1c20: 20 6d 61 6e 69 66 65 73 74 20 6d 69 67 68 74 0a manifest might.
1c30: 62 65 20 50 47 50 20 63 6c 65 61 72 73 69 67 6e be PGP clearsign
1c40: 65 64 2e 3c 2f 70 3e 0a 0a 3c 68 33 3e 32 2e 33 ed.</p>..<h3>2.3
1c50: 20 4b 65 79 20 63 6f 6e 63 65 70 74 73 3c 2f 68 Key concepts</h
1c60: 33 3e 0a 0a 3c 75 6c 3e 0a 3c 6c 69 3e 41 20 3c 3>..<ul>.<li>A <
1c70: 62 3e 62 61 73 65 6c 69 6e 65 3c 2f 62 3e 20 69 b>baseline</b> i
1c80: 73 20 61 20 73 65 74 20 6f 66 20 66 69 6c 65 73 s a set of files
1c90: 20 61 72 72 61 6e 67 65 64 0a 20 20 20 20 69 6e arranged. in
1ca0: 20 61 20 68 69 65 72 61 72 63 68 79 2e 3c 2f 6c a hierarchy.</l
1cb0: 69 3e 0a 3c 6c 69 3e 41 20 3c 62 3e 72 65 70 6f i>.<li>A <b>repo
1cc0: 73 69 74 6f 72 79 3c 2f 62 3e 20 6b 65 65 70 73 sitory</b> keeps
1cd0: 20 61 20 72 65 63 6f 72 64 20 6f 66 20 68 69 73 a record of his
1ce0: 74 6f 72 69 63 61 6c 20 62 61 73 65 6c 69 6e 65 torical baseline
1cf0: 73 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 52 65 70 6f s.</li>.<li>Repo
1d00: 73 69 74 6f 72 69 65 73 20 73 68 61 72 65 20 74 sitories share t
1d10: 68 65 69 72 20 63 68 61 6e 67 65 73 20 75 73 69 heir changes usi
1d20: 6e 67 20 3c 62 3e 70 75 73 68 3c 2f 62 3e 2c 20 ng <b>push</b>,
1d30: 3c 62 3e 70 75 6c 6c 3c 2f 62 3e 2c 0a 20 20 20 <b>pull</b>,.
1d40: 20 3c 62 3e 73 79 6e 63 3c 2f 62 3e 2c 20 61 6e <b>sync</b>, an
1d50: 64 20 3c 62 3e 63 6c 6f 6e 65 3c 2f 62 3e 2e 3c d <b>clone</b>.<
1d60: 2f 6c 69 3e 0a 3c 6c 69 3e 41 20 70 61 72 74 69 /li>.<li>A parti
1d70: 63 75 6c 61 72 20 76 65 72 73 69 6f 6e 20 6f 66 cular version of
1d80: 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 66 69 a particular fi
1d90: 6c 65 20 69 73 20 61 6e 20 3c 62 3e 61 72 74 69 le is an <b>arti
1da0: 66 61 63 74 3c 2f 62 3e 0a 20 20 20 20 74 68 61 fact</b>. tha
1db0: 74 20 69 73 20 69 64 65 6e 74 69 66 69 65 64 20 t is identified
1dc0: 62 79 20 61 20 3c 62 3e 55 55 49 44 3c 2f 62 3e by a <b>UUID</b>
1dd0: 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 41 72 74 69 66 .</li>.<li>Artif
1de0: 61 63 74 73 20 74 72 61 63 6b 65 64 20 62 79 20 acts tracked by
1df0: 66 6f 73 73 69 6c 20 61 72 65 20 69 6e 68 65 72 fossil are inher
1e00: 65 6e 74 6c 79 20 69 6d 6d 75 74 61 62 6c 65 2e ently immutable.
1e10: 3c 2f 6c 69 3e 0a 3c 6c 69 3e 46 6f 73 73 69 6c </li>.<li>Fossil
1e20: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 67 automatically g
1e30: 65 6e 65 72 61 74 65 73 20 61 20 3c 62 3e 6d 61 enerates a <b>ma
1e40: 6e 69 66 65 73 74 3c 2f 62 3e 20 66 69 6c 65 20 nifest</b> file
1e50: 74 68 61 74 20 69 64 65 6e 74 69 66 69 65 73 0a that identifies.
1e60: 20 20 20 20 65 76 65 72 79 20 61 72 74 69 66 61 every artifa
1e70: 63 74 20 69 6e 20 61 20 62 61 73 65 6c 69 6e 65 ct in a baseline
1e80: 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 54 68 65 20 55 .</li>.<li>The U
1e90: 55 49 44 20 6f 66 20 74 68 65 20 6d 61 6e 69 66 UID of the manif
1ea0: 65 73 74 20 69 73 20 74 68 65 20 55 55 49 44 20 est is the UUID
1eb0: 6f 66 20 74 68 65 20 62 61 73 65 6c 69 6e 65 2e of the baseline.
1ec0: 3c 2f 6c 69 3e 0a 3c 2f 75 6c 3e 0a 0a 3c 68 32 </li>.</ul>..<h2
1ed0: 3e 33 2e 30 20 46 6f 73 73 69 6c 20 2d 20 54 68 >3.0 Fossil - Th
1ee0: 65 20 50 72 6f 67 72 61 6d 3c 2f 68 32 3e 0a 0a e Program</h2>..
1ef0: 3c 70 3e 46 6f 73 73 69 6c 20 69 73 20 73 6f 66 <p>Fossil is sof
1f00: 74 77 61 72 65 2e 20 20 54 68 65 20 69 6d 70 6c tware. The impl
1f10: 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 66 6f ementation of fo
1f20: 73 73 69 6c 20 69 73 20 69 6e 20 74 68 65 20 66 ssil is in the f
1f30: 6f 72 6d 0a 6f 66 20 61 20 73 69 6e 67 6c 65 20 orm.of a single
1f40: 65 78 65 63 75 74 61 62 6c 65 20 6e 61 6d 65 64 executable named
1f50: 20 22 66 6f 73 73 69 6c 22 2e 20 20 54 6f 20 69 "fossil". To i
1f60: 6e 73 74 61 6c 6c 20 66 6f 73 73 69 6c 20 6f 6e nstall fossil on
1f70: 20 79 6f 75 72 20 73 79 73 74 65 6d 2c 0a 61 6c your system,.al
1f80: 6c 20 79 6f 75 20 68 61 76 65 20 74 6f 20 64 6f l you have to do
1f90: 20 69 73 20 6f 62 74 61 69 6e 20 61 20 63 6f 70 is obtain a cop
1fa0: 79 20 6f 66 20 74 68 69 73 20 6f 6e 65 20 65 78 y of this one ex
1fb0: 65 63 75 74 61 62 6c 65 20 66 69 6c 65 20 28 65 ecutable file (e
1fc0: 69 74 68 65 72 0a 62 79 20 64 6f 77 6e 6c 6f 61 ither.by downloa
1fd0: 64 69 6e 67 20 61 20 70 72 65 63 6f 6d 70 69 6c ding a precompil
1fe0: 65 64 20 76 65 72 73 69 6f 6e 20 6f 72 20 63 6f ed version or co
1ff0: 6d 70 69 6c 69 6e 67 20 69 74 20 79 6f 75 72 73 mpiling it yours
2000: 65 6c 66 29 20 61 6e 64 20 74 68 65 6e 0a 70 75 elf) and then.pu
2010: 74 74 69 6e 67 20 74 68 61 74 20 66 69 6c 65 20 tting that file
2020: 73 6f 6d 65 77 68 65 72 65 20 6f 6e 20 79 6f 75 somewhere on you
2030: 72 20 50 41 54 48 2e 3c 2f 70 3e 0a 0a 3c 70 3e r PATH.</p>..<p>
2040: 46 6f 73 73 69 6c 20 69 73 20 63 6f 6d 70 6c 65 Fossil is comple
2050: 74 65 6c 79 20 73 65 6c 66 2d 63 6f 6e 74 61 69 tely self-contai
2060: 6e 65 64 2e 20 20 49 74 20 69 73 20 6e 6f 74 20 ned. It is not
2070: 6e 65 63 65 73 73 61 72 79 20 74 6f 0a 69 6e 73 necessary to.ins
2080: 74 61 6c 6c 20 61 6e 79 20 6f 74 68 65 72 20 73 tall any other s
2090: 6f 66 74 77 61 72 65 20 69 6e 20 6f 72 64 65 72 oftware in order
20a0: 20 74 6f 20 75 73 65 20 66 6f 73 73 69 6c 2e 20 to use fossil.
20b0: 20 59 6f 75 20 64 6f 20 3c 75 3e 6e 6f 74 3c 2f You do <u>not</
20c0: 75 3e 20 6e 65 65 64 0a 43 56 53 2c 20 67 7a 69 u> need.CVS, gzi
20d0: 70 2c 20 64 69 66 66 2c 20 72 73 79 6e 63 2c 20 p, diff, rsync,
20e0: 50 79 74 68 6f 6e 2c 20 50 65 72 6c 2c 20 54 63 Python, Perl, Tc
20f0: 6c 2c 20 4a 61 76 61 2c 20 61 70 61 63 68 65 2c l, Java, apache,
2100: 20 50 6f 73 74 67 72 65 53 51 4c 2c 20 4d 79 53 PostgreSQL, MyS
2110: 51 4c 2c 0a 53 51 4c 69 74 65 2c 20 70 61 74 63 QL,.SQLite, patc
2120: 68 2c 20 6f 72 20 61 6e 79 20 73 69 6d 69 6c 61 h, or any simila
2130: 72 20 73 6f 66 74 77 61 72 65 20 6f 6e 20 79 6f r software on yo
2140: 75 72 20 73 79 73 74 65 6d 20 69 6e 20 6f 72 64 ur system in ord
2150: 65 72 20 74 6f 20 75 73 65 0a 66 6f 73 73 69 6c er to use.fossil
2160: 20 65 66 66 65 63 74 69 76 65 6c 79 2e 20 20 59 effectively. Y
2170: 6f 75 20 77 69 6c 6c 20 77 61 6e 74 20 74 6f 20 ou will want to
2180: 68 61 76 65 20 73 6f 6d 65 20 6b 69 6e 64 20 6f have some kind o
2190: 66 20 74 65 78 74 20 65 64 69 74 6f 72 0a 66 6f f text editor.fo
21a0: 72 20 65 6e 74 65 72 69 6e 67 20 63 68 65 63 6b r entering check
21b0: 2d 69 6e 20 63 6f 6d 6d 65 6e 74 73 2e 20 20 46 -in comments. F
21c0: 6f 73 73 69 6c 20 77 69 6c 6c 20 75 73 65 20 77 ossil will use w
21d0: 68 61 74 65 76 65 72 20 74 65 78 74 20 65 64 69 hatever text edi
21e0: 74 6f 72 0a 69 73 20 69 64 65 6e 74 69 66 69 65 tor.is identifie
21f0: 64 20 62 79 20 79 6f 75 72 20 56 49 53 55 41 4c d by your VISUAL
2200: 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 environment var
2210: 69 61 62 6c 65 2e 20 20 46 6f 73 73 69 6c 20 77 iable. Fossil w
2220: 69 6c 6c 20 61 6c 73 6f 0a 75 73 65 20 47 50 47 ill also.use GPG
2230: 20 74 6f 20 63 6c 65 61 72 73 69 67 6e 20 79 6f to clearsign yo
2240: 75 72 20 6d 61 6e 69 66 65 73 74 73 20 69 66 20 ur manifests if
2250: 79 6f 75 20 68 61 70 70 65 6e 20 74 6f 20 68 61 you happen to ha
2260: 76 65 20 69 74 20 69 6e 73 74 61 6c 6c 65 64 2c ve it installed,
2270: 0a 62 75 74 20 66 6f 73 73 69 6c 20 77 69 6c 6c .but fossil will
2280: 20 73 6b 69 70 20 74 68 61 74 20 73 74 65 70 20 skip that step
2290: 69 66 20 47 50 47 20 6d 69 73 73 69 6e 67 20 66 if GPG missing f
22a0: 72 6f 6d 20 79 6f 75 72 20 73 79 73 74 65 6d 2e rom your system.
22b0: 0a 59 6f 75 20 63 61 6e 20 6f 70 74 69 6f 6e 61 .You can optiona
22c0: 6c 6c 79 20 73 65 74 20 75 70 20 66 6f 73 73 69 lly set up fossi
22d0: 6c 20 74 6f 20 75 73 65 20 65 78 74 65 72 6e 61 l to use externa
22e0: 6c 20 22 64 69 66 66 22 20 70 72 6f 67 72 61 6d l "diff" program
22f0: 73 2c 20 0a 74 68 6f 75 67 68 20 61 20 70 65 72 s, .though a per
2300: 66 65 63 74 6c 79 20 66 75 6e 63 74 69 6f 6e 61 fectly functiona
2310: 6c 20 22 64 69 66 66 22 20 61 6c 67 6f 72 69 74 l "diff" algorit
2320: 68 6d 20 69 73 20 62 75 69 6c 74 20 69 74 20 61 hm is built it a
2330: 6e 64 20 77 6f 72 6b 73 0a 66 69 6e 64 20 66 6f nd works.find fo
2340: 72 20 6d 6f 73 74 20 70 65 6f 70 6c 65 2e 3c 2f r most people.</
2350: 70 3e 0a 0a 3c 70 3e 54 6f 20 75 6e 69 6e 73 74 p>..<p>To uninst
2360: 61 6c 6c 20 66 6f 73 73 69 6c 2c 20 73 69 6d 70 all fossil, simp
2370: 6c 79 20 64 65 6c 65 74 65 20 74 68 65 20 65 78 ly delete the ex
2380: 65 63 75 74 61 62 6c 65 2e 3c 2f 70 3e 0a 0a 3c ecutable.</p>..<
2390: 70 3e 54 6f 20 75 70 67 72 61 64 65 20 61 6e 20 p>To upgrade an
23a0: 6f 6c 64 65 72 20 76 65 72 73 69 6f 6e 20 6f 66 older version of
23b0: 20 66 6f 73 73 69 6c 20 74 6f 20 61 20 6e 65 77 fossil to a new
23c0: 65 72 20 76 65 72 73 69 6f 6e 2c 20 6a 75 73 74 er version, just
23d0: 0a 72 65 70 6c 61 63 65 20 74 68 65 20 6f 6c 64 .replace the old
23e0: 20 65 78 65 63 75 74 61 62 6c 65 20 77 69 74 68 executable with
23f0: 20 74 68 65 20 6e 65 77 20 6f 6e 65 2e 20 20 59 the new one. Y
2400: 6f 75 20 6d 69 67 68 74 20 6e 65 65 64 20 74 6f ou might need to
2410: 20 0a 72 75 6e 20 61 20 6f 6e 65 2d 74 69 6d 65 .run a one-time
2420: 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 72 65 73 74 command to rest
2430: 72 75 63 74 75 72 65 20 79 6f 75 72 20 72 65 70 ructure your rep
2440: 6f 73 69 74 6f 72 69 65 73 20 61 66 74 65 72 0a ositories after.
2450: 61 6e 20 75 70 67 72 61 64 65 2e 20 20 43 68 65 an upgrade. Che
2460: 63 6b 20 74 68 65 20 69 6e 73 74 72 75 63 74 69 ck the instructi
2470: 6f 6e 73 20 74 68 61 74 20 63 6f 6d 65 20 77 69 ons that come wi
2480: 74 68 20 74 68 65 20 75 70 67 72 61 64 65 0a 66 th the upgrade.f
2490: 6f 72 20 64 65 74 61 69 6c 73 2e 3c 2f 70 3e 0a or details.</p>.
24a0: 0a 3c 70 3e 54 6f 20 75 73 65 20 66 6f 73 73 69 .<p>To use fossi
24b0: 6c 2c 20 73 69 6d 70 6c 79 20 74 79 70 65 20 74 l, simply type t
24c0: 68 65 20 6e 61 6d 65 20 6f 66 20 65 78 65 63 75 he name of execu
24d0: 74 61 62 6c 65 20 69 6e 20 79 6f 75 72 0a 73 68 table in your.sh
24e0: 65 6c 6c 2c 20 66 6f 6c 6c 6f 77 65 64 20 62 79 ell, followed by
24f0: 20 6f 6e 65 20 6f 66 20 74 68 65 20 76 61 72 69 one of the vari
2500: 6f 75 73 20 62 75 69 6c 74 2d 69 6e 20 63 6f 6d ous built-in com
2510: 6d 61 6e 64 73 20 61 6e 64 0a 61 72 67 75 6d 65 mands and.argume
2520: 6e 74 73 20 61 70 70 72 6f 70 72 69 61 74 65 20 nts appropriate
2530: 66 6f 72 20 74 68 61 74 20 63 6f 6d 6d 61 6e 64 for that command
2540: 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 3a 3c . For example:<
2550: 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 /p>..<blockquote
2560: 3e 3c 62 3e 0a 66 6f 73 73 69 6c 20 68 65 6c 70 ><b>.fossil help
2570: 0a 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 .</b></blockquot
2580: 65 3e 0a 0a 3c 70 3e 49 6e 20 74 68 65 20 6e 65 e>..<p>In the ne
2590: 78 74 20 73 65 63 74 69 6f 6e 2c 20 77 68 65 6e xt section, when
25a0: 20 77 65 20 73 61 79 20 74 68 69 6e 67 73 20 6c we say things l
25b0: 69 6b 65 20 22 75 73 65 20 74 68 65 20 3c 62 3e ike "use the <b>
25c0: 68 65 6c 70 3c 2f 62 3e 0a 63 6f 6d 6d 61 6e 64 help</b>.command
25d0: 22 20 77 65 20 6d 65 61 6e 20 74 6f 20 75 73 65 " we mean to use
25e0: 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 6e 61 6d the command nam
25f0: 65 20 22 68 65 6c 70 22 20 61 73 20 74 68 65 20 e "help" as the
2600: 66 69 72 73 74 0a 74 6f 6b 65 6e 20 61 66 74 65 first.token afte
2610: 72 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 r the name of th
2620: 65 20 66 6f 73 73 69 6c 20 65 78 65 63 75 74 61 e fossil executa
2630: 62 6c 65 2c 20 61 73 20 73 68 6f 77 6e 20 61 62 ble, as shown ab
2640: 6f 76 65 2e 3c 2f 70 3e 0a 0a 3c 68 32 3e 34 2e ove.</p>..<h2>4.
2650: 30 20 57 6f 72 6b 66 6c 6f 77 3c 2f 68 32 3e 0a 0 Workflow</h2>.
2660: 0a 3c 69 6d 67 20 73 72 63 3d 22 63 6f 6e 63 65 .<img src="conce
2670: 70 74 32 2e 67 69 66 22 20 61 6c 69 67 6e 3d 22 pt2.gif" align="
2680: 72 69 67 68 74 22 20 68 73 70 61 63 65 3d 22 31 right" hspace="1
2690: 30 22 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 3e 3c 70 0">..<ol>.<li><p
26a0: 3e 0a 45 73 74 61 62 6c 69 73 68 20 61 20 6c 6f >.Establish a lo
26b0: 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 20 75 cal repository u
26c0: 73 69 6e 67 20 65 69 74 68 65 72 20 74 68 65 20 sing either the
26d0: 3c 62 3e 6e 65 77 3c 2f 62 3e 20 63 6f 6d 6d 61 <b>new</b> comma
26e0: 6e 64 0a 74 6f 20 73 74 61 72 74 20 61 20 6e 65 nd.to start a ne
26f0: 77 20 70 72 6f 6a 65 63 74 2c 20 6f 72 20 74 68 w project, or th
2700: 65 20 3c 62 3e 63 6c 6f 6e 65 3c 2f 62 3e 20 63 e <b>clone</b> c
2710: 6f 6d 6d 61 6e 64 20 74 6f 20 6d 61 6b 65 20 61 ommand to make a
2720: 20 63 6c 6f 6e 65 0a 6f 66 20 61 20 72 65 70 6f clone.of a repo
2730: 73 69 74 6f 72 79 20 66 6f 72 20 61 6e 20 65 78 sitory for an ex
2740: 69 73 74 69 6e 67 20 70 72 6f 6a 65 63 74 2e 20 isting project.
2750: 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e .</p></li>..<li>
2760: 3c 70 3e 0a 45 73 74 61 62 6c 69 73 68 20 6f 6e <p>.Establish on
2770: 65 20 6f 72 20 6d 6f 72 65 20 73 6f 75 72 63 65 e or more source
2780: 20 74 72 65 65 73 20 62 79 20 63 68 61 6e 67 69 trees by changi
2790: 6e 67 20 79 6f 75 72 20 77 6f 72 6b 69 6e 67 20 ng your working
27a0: 64 69 72 65 63 74 6f 72 79 0a 74 6f 20 77 68 65 directory.to whe
27b0: 72 65 20 79 6f 75 20 77 61 6e 74 20 74 68 65 20 re you want the
27c0: 72 6f 6f 74 20 6f 66 20 74 68 65 20 73 6f 75 72 root of the sour
27d0: 63 65 20 74 72 65 65 20 74 6f 20 62 65 2c 20 74 ce tree to be, t
27e0: 68 65 6e 20 69 73 73 75 69 6e 67 0a 74 68 65 20 hen issuing.the
27f0: 3c 62 3e 6f 70 65 6e 3c 2f 62 3e 20 63 6f 6d 6d <b>open</b> comm
2800: 61 6e 64 20 77 69 74 68 20 74 68 65 20 6e 61 6d and with the nam
2810: 65 20 6f 66 20 74 68 65 20 72 65 70 6f 73 69 74 e of the reposit
2820: 6f 72 79 20 66 69 6c 65 20 61 73 20 69 74 73 0a ory file as its.
2830: 61 72 67 75 6d 65 6e 74 2e 0a 3c 2f 70 3e 3c 2f argument..</p></
2840: 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 55 73 65 li>..<li><p>.Use
2850: 20 74 68 65 20 3c 62 3e 75 70 64 61 74 65 3c 2f the <b>update</
2860: 62 3e 20 63 6f 6d 6d 61 6e 64 20 66 6f 6c 6c 6f b> command follo
2870: 77 65 64 20 62 79 20 61 20 55 55 49 44 20 74 6f wed by a UUID to
2880: 20 63 61 75 73 65 20 79 6f 75 72 0a 73 6f 75 72 cause your.sour
2890: 63 65 20 74 72 65 65 20 74 6f 20 63 68 61 6e 67 ce tree to chang
28a0: 65 20 74 6f 20 74 68 65 20 62 61 73 65 6c 69 6e e to the baselin
28b0: 65 20 69 64 65 6e 74 69 66 69 65 64 20 62 79 20 e identified by
28c0: 74 68 61 74 20 55 55 49 44 2e 0a 54 68 65 20 3c that UUID..The <
28d0: 62 3e 74 69 6d 65 6c 69 6e 65 3c 2f 62 3e 20 6f b>timeline</b> o
28e0: 72 20 3c 62 3e 6c 65 61 76 65 73 3c 2f 62 3e 20 r <b>leaves</b>
28f0: 63 6f 6d 6d 61 6e 64 73 20 6d 69 67 68 74 20 68 commands might h
2900: 65 6c 70 20 79 6f 75 20 74 6f 0a 69 64 65 6e 74 elp you to.ident
2910: 69 66 79 20 61 6e 20 61 70 70 72 6f 70 72 69 61 ify an appropria
2920: 74 65 20 62 61 73 65 6c 69 6e 65 2e 0a 3c 2f 70 te baseline..</p
2930: 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 0a ></li>..<li><p>.
2940: 45 64 69 74 20 74 68 65 20 63 6f 64 65 2e 20 20 Edit the code.
2950: 41 64 64 20 6e 65 77 20 66 69 6c 65 73 20 74 6f Add new files to
2960: 20 74 68 65 20 73 6f 75 72 63 65 20 74 72 65 65 the source tree
2970: 20 75 73 69 6e 67 20 74 68 65 20 3c 62 3e 61 64 using the <b>ad
2980: 64 3c 2f 62 3e 0a 63 6f 6d 6d 61 6e 64 2e 20 20 d</b>.command.
2990: 4f 6d 69 74 20 66 69 6c 65 73 20 66 72 6f 6d 20 Omit files from
29a0: 66 75 74 75 72 65 20 62 61 73 65 6c 69 6e 65 73 future baselines
29b0: 20 75 73 69 6e 67 20 74 68 65 20 3c 62 3e 72 6d using the <b>rm
29c0: 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 2e 0a 28 45 </b> command..(E
29d0: 76 65 6e 20 77 68 65 6e 20 79 6f 75 20 72 65 6d ven when you rem
29e0: 6f 76 65 20 66 69 6c 65 73 20 66 72 6f 6d 20 66 ove files from f
29f0: 75 74 75 72 65 20 62 61 73 65 6c 69 6e 65 73 2c uture baselines,
2a00: 20 74 68 6f 73 65 20 66 69 6c 65 73 20 63 6f 6e those files con
2a10: 74 69 6e 75 65 0a 74 6f 20 65 78 69 73 74 20 69 tinue.to exist i
2a20: 6e 20 68 69 73 74 6f 72 69 63 61 6c 20 62 61 73 n historical bas
2a30: 65 6c 69 6e 65 73 2e 29 20 20 54 65 73 74 20 79 elines.) Test y
2a40: 6f 75 72 20 63 68 61 6e 67 65 73 2e 0a 3c 2f 70 our changes..</p
2a50: 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 0a ></li>..<li><p>.
2a60: 43 72 65 61 74 65 20 61 20 6e 65 77 20 62 61 73 Create a new bas
2a70: 65 6c 69 6e 65 20 75 73 69 6e 67 20 74 68 65 20 eline using the
2a80: 3c 62 3e 63 6f 6d 6d 69 74 3c 2f 62 3e 20 63 6f <b>commit</b> co
2a90: 6d 6d 61 6e 64 2e 20 20 59 6f 75 20 77 69 6c 6c mmand. You will
2aa0: 20 62 65 20 70 72 6f 6d 70 74 65 64 0a 66 6f 72 be prompted.for
2ab0: 20 61 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d 6d a check-in comm
2ac0: 65 6e 74 20 61 6e 64 20 61 6c 73 6f 20 66 6f 72 ent and also for
2ad0: 20 79 6f 75 72 20 47 50 47 20 6b 65 79 20 69 66 your GPG key if
2ae0: 20 79 6f 75 20 68 61 76 65 20 47 50 47 20 69 6e you have GPG in
2af0: 73 74 61 6c 6c 65 64 2e 0a 54 68 65 20 63 6f 6d stalled..The com
2b00: 6d 69 74 20 63 6f 70 69 65 73 20 74 68 65 20 65 mit copies the e
2b10: 64 69 74 73 20 79 6f 75 20 68 61 76 65 20 6d 61 dits you have ma
2b20: 64 65 20 69 6e 20 79 6f 75 72 20 6c 6f 63 61 6c de in your local
2b30: 20 73 6f 75 72 63 65 0a 74 72 65 65 20 69 6e 74 source.tree int
2b40: 6f 20 79 6f 75 72 20 6c 6f 63 61 6c 20 72 65 70 o your local rep
2b50: 6f 73 69 74 6f 72 79 2e 0a 3c 2f 70 3e 3c 2f 6c ository..</p></l
2b60: 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 53 68 61 72 i>..<li><p>.Shar
2b70: 65 20 79 6f 75 72 20 63 68 61 6e 67 65 73 20 77 e your changes w
2b80: 69 74 68 20 6f 74 68 65 72 73 20 75 73 69 6e 67 ith others using
2b90: 20 74 68 65 20 3c 62 3e 70 75 73 68 3c 2f 62 3e the <b>push</b>
2ba0: 20 63 6f 6d 6d 61 6e 64 2e 20 0a 50 75 73 68 20 command. .Push
2bb0: 63 61 75 73 65 73 20 74 68 65 20 65 64 69 74 73 causes the edits
2bc0: 20 79 6f 75 20 63 6f 6d 6d 69 74 74 65 64 20 69 you committed i
2bd0: 6e 74 6f 20 79 6f 75 72 20 6c 6f 63 61 6c 20 72 nto your local r
2be0: 65 70 6f 73 69 74 6f 72 79 20 74 6f 20 62 65 0a epository to be.
2bf0: 70 75 73 68 65 64 20 6f 75 74 20 69 6e 74 6f 20 pushed out into
2c00: 6f 74 68 65 72 20 72 65 70 6f 73 69 74 6f 72 69 other repositori
2c10: 65 73 2e 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c es..</p></li>..<
2c20: 6c 69 3e 3c 70 3e 0a 57 68 65 6e 20 79 6f 75 72 li><p>.When your
2c30: 20 63 6f 77 6f 72 6b 65 72 73 20 6d 61 6b 65 20 coworkers make
2c40: 74 68 65 69 72 20 6f 77 6e 20 63 68 61 6e 67 65 their own change
2c50: 73 2c 20 79 6f 75 20 63 61 6e 20 70 75 6c 6c 20 s, you can pull
2c60: 74 68 6f 73 65 20 63 68 61 6e 67 65 73 0a 69 6e those changes.in
2c70: 74 6f 20 79 6f 75 72 20 6c 6f 63 61 6c 20 72 65 to your local re
2c80: 70 6f 73 69 74 6f 72 79 20 75 73 69 6e 67 20 74 pository using t
2c90: 68 65 20 3c 62 3e 70 75 6c 6c 3c 2f 62 3e 20 63 he <b>pull</b> c
2ca0: 6f 6d 6d 61 6e 64 2e 20 20 20 4e 6f 74 65 20 74 ommand. Note t
2cb0: 68 61 74 0a 74 68 65 20 70 75 6c 6c 20 63 6f 6d hat.the pull com
2cc0: 6d 61 6e 64 20 6f 6e 6c 79 20 70 75 6c 6c 73 20 mand only pulls
2cd0: 74 68 65 20 63 68 61 6e 67 65 73 20 69 6e 74 6f the changes into
2ce0: 20 79 6f 75 72 20 6c 6f 63 61 6c 20 72 65 70 6f your local repo
2cf0: 73 69 74 6f 72 79 2c 0a 6e 6f 74 20 69 6e 74 6f sitory,.not into
2d00: 20 79 6f 75 72 20 6c 6f 63 61 6c 20 73 6f 75 72 your local sour
2d10: 63 65 20 74 72 65 65 2e 0a 3c 2f 70 3e 3c 2f 6c ce tree..</p></l
2d20: 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 41 66 74 65 i>..<li><p>.Afte
2d30: 72 20 74 68 65 20 63 68 61 6e 67 65 73 20 6f 66 r the changes of
2d40: 20 6f 74 68 65 72 73 20 61 72 65 20 69 6e 20 79 others are in y
2d50: 6f 75 72 20 6c 6f 63 61 6c 20 72 65 70 6f 73 69 our local reposi
2d60: 74 6f 72 79 2c 20 79 6f 75 20 0a 63 61 6e 20 6d tory, you .can m
2d70: 6f 76 65 20 74 68 65 6d 20 69 6e 74 6f 20 79 6f ove them into yo
2d80: 75 72 20 6c 6f 63 61 6c 20 73 6f 75 72 63 65 20 ur local source
2d90: 74 72 65 65 20 75 73 69 6e 67 20 3c 62 3e 75 70 tree using <b>up
2da0: 64 61 74 65 3c 2f 62 3e 2e 20 20 49 66 20 0a 79 date</b>. If .y
2db0: 6f 75 20 68 61 76 65 20 6d 61 64 65 20 70 61 72 ou have made par
2dc0: 61 6c 6c 65 6c 0a 63 68 61 6e 67 65 73 2c 20 79 allel.changes, y
2dd0: 6f 75 20 63 61 6e 20 6d 65 72 67 65 20 79 6f 75 ou can merge you
2de0: 72 20 63 68 61 6e 67 65 73 20 74 6f 67 65 74 68 r changes togeth
2df0: 65 72 20 77 69 74 68 20 79 6f 75 72 20 63 6f 77 er with your cow
2e00: 6f 72 6b 65 72 73 20 63 68 61 6e 67 65 73 0a 62 orkers changes.b
2e10: 79 20 64 6f 20 61 6e 20 3c 62 3e 75 70 64 61 74 y do an <b>updat
2e20: 65 3c 2f 62 3e 20 74 6f 20 79 6f 75 72 20 6c 61 e</b> to your la
2e30: 74 65 73 74 20 62 61 73 65 6c 69 6e 65 2c 20 74 test baseline, t
2e40: 68 65 6e 20 64 6f 69 6e 67 20 61 0a 3c 62 3e 6d hen doing a.<b>m
2e50: 65 72 67 65 3c 2f 62 3e 20 77 69 74 68 20 79 6f erge</b> with yo
2e60: 75 72 20 63 6f 77 6f 72 6b 65 72 73 20 6c 61 74 ur coworkers lat
2e70: 65 73 74 20 62 61 73 65 6c 69 6e 65 2e 20 20 41 est baseline. A
2e80: 66 74 65 72 20 79 6f 75 72 0a 76 65 72 69 66 79 fter your.verify
2e90: 20 74 68 61 74 20 74 68 65 20 6d 65 72 67 65 64 that the merged
2ea0: 20 63 6f 64 65 20 69 73 20 73 74 69 6c 6c 20 66 code is still f
2eb0: 75 6e 63 74 69 6f 6e 61 6c 2c 20 79 6f 75 20 63 unctional, you c
2ec0: 61 6e 20 3c 62 3e 63 6f 6d 6d 69 74 3c 2f 62 3e an <b>commit</b>
2ed0: 0a 61 20 6e 65 77 20 62 61 73 65 6c 69 6e 65 20 .a new baseline
2ee0: 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 62 6f that contains bo
2ef0: 74 68 20 79 6f 75 72 73 20 61 6e 64 20 79 6f 75 th yours and you
2f00: 72 20 63 6f 77 6f 72 6b 65 72 73 20 63 68 61 6e r coworkers chan
2f10: 67 65 73 0a 61 6e 64 20 74 68 65 6e 20 70 75 73 ges.and then pus
2f20: 68 20 74 68 65 20 6e 65 77 20 62 61 73 65 6c 69 h the new baseli
2f30: 6e 65 20 62 61 63 6b 20 74 6f 20 79 6f 75 72 20 ne back to your
2f40: 63 6f 77 6f 72 6b 65 72 2e 0a 3c 2f 70 3e 3c 2f coworker..</p></
2f50: 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 52 65 70 li>..<li><p>.Rep
2f60: 65 61 74 20 61 6c 6c 20 6f 66 20 74 68 65 20 61 eat all of the a
2f70: 62 6f 76 65 20 75 6e 74 69 6c 20 79 6f 75 20 68 bove until you h
2f80: 61 76 65 20 67 65 6e 65 72 61 74 65 64 20 67 72 ave generated gr
2f90: 65 61 74 20 73 6f 66 74 77 61 72 65 2e 0a 3c 2f eat software..</
2fa0: 70 3e 3c 2f 6c 69 3e 0a 3c 2f 6f 6c 3e 0a 0a 3c p></li>.</ol>..<
2fb0: 68 33 3e 34 2e 31 20 56 61 72 69 61 74 69 6f 6e h3>4.1 Variation
2fc0: 73 3c 2f 68 33 3e 0a 0a 3c 70 3e 54 68 65 20 3c s</h3>..<p>The <
2fd0: 62 3e 73 65 74 74 69 6e 67 73 3c 2f 62 3e 20 6c b>settings</b> l
2fe0: 65 74 73 20 79 6f 75 20 76 69 65 77 20 61 6e 64 ets you view and
2ff0: 20 6d 6f 64 69 66 79 20 76 61 72 69 6f 75 73 20 modify various
3000: 6f 70 65 72 61 74 69 6e 67 0a 70 72 6f 70 65 72 operating.proper
3010: 74 69 65 73 20 6f 66 20 66 6f 73 73 69 6c 2e 20 ties of fossil.
3020: 20 41 6d 6f 6e 67 20 74 68 65 20 61 76 61 69 6c Among the avail
3030: 61 62 6c 65 20 73 65 74 74 69 6e 67 73 20 69 73 able settings is
3040: 20 22 61 75 74 6f 73 79 6e 63 22 0a 6d 6f 64 65 "autosync".mode
3050: 2e 20 20 57 68 65 6e 20 61 75 74 6f 73 79 6e 63 . When autosync
3060: 20 69 73 20 65 6e 61 62 6c 65 64 2c 20 74 68 65 is enabled, the
3070: 20 70 75 73 68 20 61 6e 64 20 70 75 6c 6c 20 6f push and pull o
3080: 66 20 63 6f 6e 74 65 6e 74 20 66 72 6f 6d 0a 79 f content from.y
3090: 6f 75 72 20 6c 6f 63 61 6c 20 73 65 72 76 65 72 our local server
30a0: 20 69 73 20 6c 61 72 67 65 6c 79 20 61 75 74 6f is largely auto
30b0: 6d 61 74 65 64 2e 20 20 57 68 65 6e 65 76 65 72 mated. Whenever
30c0: 20 79 6f 75 20 75 73 65 20 74 68 65 20 3c 62 3e you use the <b>
30d0: 75 70 64 61 74 65 3c 2f 62 3e 0a 63 6f 6d 6d 61 update</b>.comma
30e0: 6e 64 2c 20 66 6f 73 73 69 6c 20 66 69 72 73 74 nd, fossil first
30f0: 20 64 6f 65 73 20 61 20 3c 62 3e 70 75 6c 6c 3c does a <b>pull<
3100: 2f 62 3e 20 74 6f 20 73 65 65 20 69 66 20 6f 74 /b> to see if ot
3110: 68 65 72 20 75 73 65 72 73 20 68 61 76 65 0a 70 her users have.p
3120: 65 72 68 61 70 73 20 61 64 64 65 64 20 6e 65 77 erhaps added new
3130: 20 62 61 73 65 6c 69 6e 65 73 20 74 6f 20 74 68 baselines to th
3140: 65 20 63 65 6e 74 72 61 6c 20 72 65 70 6f 73 69 e central reposi
3150: 74 6f 72 79 2e 20 20 57 68 65 6e 20 79 6f 75 0a tory. When you.
3160: 3c 62 3e 63 6f 6d 6d 69 74 3c 2f 62 3e 2c 20 66 <b>commit</b>, f
3170: 6f 73 73 69 6c 20 61 6c 73 6f 20 64 6f 65 73 20 ossil also does
3180: 61 20 3c 62 3e 70 75 6c 6c 3c 2f 62 3e 20 61 6e a <b>pull</b> an
3190: 64 20 69 73 73 75 65 73 20 61 20 77 61 72 6e 69 d issues a warni
31a0: 6e 67 0a 69 66 20 79 6f 75 72 20 63 68 65 63 6b ng.if your check
31b0: 2d 69 6e 20 77 6f 75 6c 64 20 63 61 75 73 65 20 -in would cause
31c0: 61 20 66 6f 72 6b 2e 20 20 41 66 74 65 72 20 61 a fork. After a
31d0: 20 3c 62 3e 63 6f 6d 6d 69 74 3c 2f 62 3e 2c 20 <b>commit</b>,
31e0: 66 6f 73 73 69 6c 0a 61 75 74 6f 6d 61 74 69 63 fossil.automatic
31f0: 61 6c 6c 79 20 64 6f 65 73 20 61 20 3c 62 3e 70 ally does a <b>p
3200: 75 73 68 3c 2f 62 3e 20 74 6f 20 73 65 6e 64 20 ush</b> to send
3210: 79 6f 75 72 20 63 68 61 6e 67 65 73 20 75 70 20 your changes up
3220: 74 6f 20 74 68 65 0a 63 65 6e 74 72 61 6c 20 73 to the.central s
3230: 65 72 76 65 72 2e 3c 2f 70 3e 0a 0a 3c 70 3e 57 erver.</p>..<p>W
3240: 69 74 68 20 61 75 74 6f 73 79 6e 63 20 65 6e 61 ith autosync ena
3250: 62 6c 65 64 2c 20 66 6f 73 73 69 6c 20 77 6f 72 bled, fossil wor
3260: 6b 73 20 6c 69 6b 65 0a 3c 61 20 68 72 65 66 3d ks like.<a href=
3270: 22 68 74 74 70 3a 2f 2f 77 77 77 2e 6e 6f 6e 67 "http://www.nong
3280: 6e 75 2e 6f 72 67 2f 63 76 73 2f 22 3e 43 56 53 nu.org/cvs/">CVS
3290: 3c 2f 61 3e 20 6f 72 20 0a 3c 61 20 68 72 65 66 </a> or .<a href
32a0: 3d 22 68 74 74 70 3a 2f 2f 73 75 62 76 65 72 73 ="http://subvers
32b0: 69 6f 6e 2e 74 69 67 72 69 73 2e 6f 72 67 2f 22 ion.tigris.org/"
32c0: 3e 53 75 62 76 65 72 73 69 6f 6e 3c 2f 61 3e 2e >Subversion</a>.
32d0: 0a 57 68 65 6e 20 61 75 74 6f 73 79 6e 63 20 64 .When autosync d
32e0: 69 73 61 62 6c 65 64 2c 20 66 6f 73 73 69 6c 20 isabled, fossil
32f0: 77 6f 72 6b 73 20 6d 6f 72 65 20 6c 69 6b 65 0a works more like.
3300: 3c 61 20 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f <a href="http://
3310: 6d 6f 6e 6f 74 6f 6e 65 2e 63 61 2f 22 3e 4d 6f monotone.ca/">Mo
3320: 6e 6f 74 6f 6e 65 3c 2f 61 3e 2c 20 0a 3c 61 20 notone</a>, .<a
3330: 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f 67 69 74 href="http://git
3340: 2e 6f 72 2e 63 7a 22 3e 47 49 54 3c 2f 61 3e 2c .or.cz">GIT</a>,
3350: 20 6f 72 0a 3c 61 20 68 72 65 66 3d 22 68 74 74 or.<a href="htt
3360: 70 3a 2f 2f 77 77 77 2e 73 65 6c 65 6e 69 63 2e p://www.selenic.
3370: 63 6f 6d 2f 6d 65 72 63 75 72 69 61 6c 2f 77 69 com/mercurial/wi
3380: 6b 69 2f 22 3e 4d 65 72 63 75 72 69 61 6c 3c 2f ki/">Mercurial</
3390: 61 3e 2e 0a 54 68 65 20 66 75 6e 20 74 68 69 6e a>..The fun thin
33a0: 67 20 61 62 6f 75 74 20 66 6f 73 73 69 6c 20 69 g about fossil i
33b0: 73 20 74 68 61 74 20 69 74 20 77 69 6c 6c 20 77 s that it will w
33c0: 6f 72 6b 20 65 69 74 68 65 72 0a 77 61 79 2c 20 ork either.way,
33d0: 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 79 6f 75 depending on you
33e0: 72 20 6e 65 65 64 73 20 6f 66 20 74 68 65 20 6d r needs of the m
33f0: 6f 6d 65 6e 74 2e 20 20 59 6f 75 20 63 61 6e 20 oment. You can
3400: 66 72 65 65 6c 79 20 73 77 69 74 63 68 0a 62 65 freely switch.be
3410: 74 77 65 65 6e 20 74 68 65 73 65 20 6f 70 65 72 tween these oper
3420: 61 74 69 6e 67 20 6d 6f 64 65 73 20 75 73 69 6e ating modes usin
3430: 67 20 63 6f 6d 6d 61 6e 64 73 20 6c 69 6b 65 3a g commands like:
3440: 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 </p>..<blockquot
3450: 65 3e 0a 3c 62 3e 66 6f 73 73 69 6c 20 73 65 74 e>.<b>fossil set
3460: 74 69 6e 67 20 61 75 74 6f 73 79 6e 63 20 6f 66 ting autosync of
3470: 66 3c 62 72 20 2f 3e 0a 66 6f 73 73 69 6c 20 73 f<br />.fossil s
3480: 65 74 74 69 6e 67 20 61 75 74 6f 73 79 6e 63 20 etting autosync
3490: 6f 6e 3c 2f 62 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 on</b>.</blockqu
34a0: 6f 74 65 3e 0a 0a 3c 70 3e 46 6f 72 20 61 64 64 ote>..<p>For add
34b0: 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 itional informat
34c0: 69 6f 6e 20 61 62 6f 75 74 20 61 75 74 6f 73 79 ion about autosy
34d0: 6e 63 20 61 6e 64 20 6f 74 68 65 72 20 73 65 74 nc and other set
34e0: 74 69 6e 67 73 0a 75 73 69 6e 67 20 74 68 65 20 tings.using the
34f0: 3c 62 3e 68 65 6c 70 3c 2f 62 3e 20 63 6f 6d 6d <b>help</b> comm
3500: 61 6e 64 2e 3c 2f 70 3e 0a 0a 3c 68 32 3e 35 2e and.</p>..<h2>5.
3510: 30 20 53 65 74 74 69 6e 67 20 55 70 20 41 20 46 0 Setting Up A F
3520: 6f 73 73 69 6c 20 53 65 72 76 65 72 3c 2f 68 32 ossil Server</h2
3530: 3e 0a 0a 3c 70 3e 57 69 74 68 20 6f 74 68 65 72 >..<p>With other
3540: 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6d configuration m
3550: 61 6e 61 67 65 6d 65 6e 74 20 73 6f 66 74 77 61 anagement softwa
3560: 72 65 2c 20 73 65 74 74 69 6e 67 20 75 70 20 61 re, setting up a
3570: 20 73 65 72 76 65 72 20 69 73 0a 61 20 6c 6f 74 server is.a lot
3580: 20 6f 66 20 77 6f 72 6b 20 61 6e 64 20 6e 6f 72 of work and nor
3590: 6d 61 6c 6c 79 20 74 61 6b 65 73 20 74 69 6d 65 mally takes time
35a0: 2c 20 70 61 74 69 65 6e 63 65 2c 20 61 6e 64 20 , patience, and
35b0: 61 20 6c 6f 74 20 6f 66 20 73 79 73 74 65 6d 0a a lot of system.
35c0: 6b 6e 6f 77 6c 65 64 67 65 2e 20 20 46 6f 73 73 knowledge. Foss
35d0: 69 6c 20 69 73 20 64 65 73 69 67 6e 65 64 20 74 il is designed t
35e0: 6f 20 61 76 6f 69 64 20 74 68 69 73 20 66 72 75 o avoid this fru
35f0: 73 74 72 61 74 69 6f 6e 2e 20 20 53 65 74 74 69 stration. Setti
3600: 6e 67 20 75 70 0a 61 20 73 65 72 76 65 72 20 77 ng up.a server w
3610: 69 74 68 20 66 6f 73 73 69 6c 20 69 73 20 72 69 ith fossil is ri
3620: 64 69 63 75 6c 6f 75 73 6c 79 20 65 61 73 79 2e diculously easy.
3630: 20 20 59 6f 75 20 68 61 76 65 20 74 68 72 65 65 You have three
3640: 20 6f 70 74 69 6f 6e 73 3a 3c 2f 70 3e 0a 0a 3c options:</p>..<
3650: 6f 6c 3e 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 53 65 ol>.<li><p><b>Se
3660: 74 74 69 6e 67 20 75 70 20 61 20 73 74 61 6e 64 tting up a stand
3670: 2d 61 6c 6f 6e 65 20 73 65 72 76 65 72 3c 2f 62 -alone server</b
3680: 3e 3c 2f 70 3e 0a 0a 3c 70 3e 46 72 6f 6d 20 77 ></p>..<p>From w
3690: 69 74 68 69 6e 20 79 6f 75 72 20 73 6f 75 72 63 ithin your sourc
36a0: 65 20 74 72 65 65 20 6a 75 73 74 20 75 73 65 20 e tree just use
36b0: 74 68 65 20 3c 62 3e 73 65 72 76 65 72 3c 2f 62 the <b>server</b
36c0: 3e 20 63 6f 6d 6d 61 6e 64 20 61 6e 64 0a 66 6f > command and.fo
36d0: 73 73 69 6c 20 77 69 6c 6c 20 73 74 61 72 74 20 ssil will start
36e0: 6c 69 73 74 65 6e 69 6e 67 20 66 6f 72 20 69 6e listening for in
36f0: 63 6f 6d 69 6e 67 20 72 65 71 75 65 73 74 73 20 coming requests
3700: 6f 6e 20 54 43 50 20 70 6f 72 74 20 38 30 38 30 on TCP port 8080
3710: 2e 0a 59 6f 75 20 63 61 6e 20 70 6f 69 6e 74 20 ..You can point
3720: 79 6f 75 72 20 77 65 62 62 72 6f 77 73 65 72 20 your webbrowser
3730: 61 74 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 at <a href="http
3740: 3a 2f 2f 6c 6f 63 61 6c 68 6f 73 74 3a 38 30 38 ://localhost:808
3750: 30 2f 22 3e 0a 68 74 74 70 3a 2f 2f 6c 6f 63 61 0/">.http://loca
3760: 6c 68 6f 73 74 3a 38 30 38 30 2f 3c 2f 61 3e 20 lhost:8080/</a>
3770: 61 6e 64 20 62 65 67 69 6e 20 65 78 70 6c 6f 72 and begin explor
3780: 69 6e 67 2e 20 20 4f 72 20 79 6f 75 72 20 63 6f ing. Or your co
3790: 77 6f 72 6b 65 72 73 0a 63 61 6e 20 64 6f 20 70 workers.can do p
37a0: 75 73 68 65 73 20 6f 72 20 70 75 6c 6c 73 20 61 ushes or pulls a
37b0: 67 61 69 6e 73 74 20 79 6f 75 72 20 73 65 72 76 gainst your serv
37c0: 65 72 2e 20 20 55 73 65 20 74 68 65 20 3c 62 3e er. Use the <b>
37d0: 2d 2d 70 6f 72 74 3c 2f 62 3e 0a 6f 70 74 69 6f --port</b>.optio
37e0: 6e 20 74 6f 20 74 68 65 20 73 65 72 76 65 72 20 n to the server
37f0: 63 6f 6d 6d 61 6e 64 20 74 6f 20 73 70 65 63 69 command to speci
3800: 66 79 20 61 20 64 69 66 66 65 72 65 6e 74 20 54 fy a different T
3810: 43 50 20 70 6f 72 74 2e 20 20 49 66 0a 79 6f 75 CP port. If.you
3820: 20 64 6f 20 6e 6f 74 20 68 61 76 65 20 61 20 6c do not have a l
3830: 6f 63 61 6c 20 73 6f 75 72 63 65 20 74 72 65 65 ocal source tree
3840: 2c 20 75 73 65 20 74 68 65 20 3c 62 3e 2d 52 3c , use the <b>-R<
3850: 2f 62 3e 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 /b> command-line
3860: 0a 6f 70 74 69 6f 6e 20 74 6f 20 73 70 65 63 69 .option to speci
3870: 66 79 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 fy the repositor
3880: 79 20 66 69 6c 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e y file.</p>..<p>
3890: 41 20 73 74 61 6e 64 2d 61 6c 6f 6e 65 20 73 65 A stand-alone se
38a0: 72 76 65 72 20 69 73 20 61 20 67 72 65 61 74 20 rver is a great
38b0: 77 61 79 20 74 6f 20 73 65 74 20 6f 66 20 74 72 way to set of tr
38c0: 61 6e 73 69 65 6e 74 20 63 6f 6e 6e 65 63 74 69 ansient connecti
38d0: 6f 6e 73 0a 62 65 74 77 65 65 6e 20 63 6f 77 6f ons.between cowo
38e0: 72 6b 65 72 73 20 66 6f 72 20 64 6f 69 6e 67 20 rkers for doing
38f0: 71 75 69 63 6b 20 70 75 73 68 65 73 20 6f 72 20 quick pushes or
3900: 70 75 6c 6c 73 2e 20 20 42 75 74 20 79 6f 75 20 pulls. But you
3910: 63 61 6e 20 61 6c 73 6f 0a 73 65 74 20 75 70 20 can also.set up
3920: 61 20 70 65 72 6d 61 6e 65 6e 74 20 73 74 61 6e a permanent stan
3930: 64 2d 61 6c 6f 6e 65 20 73 65 72 76 65 72 20 69 d-alone server i
3940: 66 20 79 6f 75 20 70 72 65 66 65 72 2e 20 20 4a f you prefer. J
3950: 75 73 74 20 6d 61 6b 65 0a 61 72 72 61 6e 67 65 ust make.arrange
3960: 6d 65 6e 74 73 20 66 6f 72 20 66 6f 73 73 69 6c ments for fossil
3970: 20 74 6f 20 62 65 20 6c 61 75 6e 63 68 65 64 20 to be launched
3980: 77 69 74 68 20 61 70 70 72 6f 70 72 69 61 74 65 with appropriate
3990: 20 61 72 67 75 6d 65 6e 74 73 0a 61 66 74 65 72 arguments.after
39a0: 20 65 76 65 72 79 20 72 65 62 6f 6f 74 2e 3c 2f every reboot.</
39b0: 70 3e 0a 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 p>.</li>..<li><p
39c0: 3e 3c 62 3e 53 65 74 74 69 6e 67 20 75 70 20 61 ><b>Setting up a
39d0: 20 43 47 49 20 73 65 72 76 65 72 3c 2f 62 3e 3c CGI server</b><
39e0: 2f 70 3e 0a 0a 3c 70 3e 49 66 20 79 6f 75 20 68 /p>..<p>If you h
39f0: 61 76 65 20 61 20 77 65 62 73 65 72 76 65 72 20 ave a webserver
3a00: 72 75 6e 6e 69 6e 67 20 6f 6e 20 79 6f 75 72 20 running on your
3a10: 6d 61 63 68 69 6e 65 20 61 6c 72 65 61 64 79 2c machine already,
3a20: 20 79 6f 75 20 63 61 6e 0a 73 65 74 20 75 70 20 you can.set up
3a30: 66 6f 73 73 69 6c 20 74 6f 20 62 65 20 72 75 6e fossil to be run
3a40: 20 66 72 6f 6d 20 43 47 49 2e 20 20 53 69 6d 70 from CGI. Simp
3a50: 6c 79 20 63 72 65 61 74 65 20 61 6e 20 65 78 65 ly create an exe
3a60: 63 75 74 61 62 6c 65 20 73 63 72 69 70 74 0a 74 cutable script.t
3a70: 68 61 74 20 6c 6f 6f 6b 73 20 73 6f 6d 65 74 68 hat looks someth
3a80: 69 6e 67 20 6c 69 6b 65 20 74 68 69 73 3a 3c 2f ing like this:</
3a90: 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e p>..<blockquote>
3aa0: 3c 70 72 65 3e 0a 23 21 2f 75 73 72 2f 6c 6f 63 <pre>.#!/usr/loc
3ab0: 61 6c 2f 62 69 6e 2f 66 6f 73 73 69 6c 0a 72 65 al/bin/fossil.re
3ac0: 70 6f 73 69 74 6f 72 79 3a 20 2f 68 6f 6d 65 2f pository: /home/
3ad0: 6d 65 2f 62 69 67 70 72 6f 6a 65 63 74 2e 66 6f me/bigproject.fo
3ae0: 73 73 69 6c 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f ssil.</pre></blo
3af0: 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 45 64 69 ckquote>..<p>Edi
3b00: 74 20 74 68 69 73 20 73 63 72 69 70 74 20 74 6f t this script to
3b10: 20 75 73 65 20 77 68 61 74 65 76 65 72 20 70 61 use whatever pa
3b20: 74 68 6e 61 6d 65 73 20 61 72 65 20 61 70 70 72 thnames are appr
3b30: 6f 70 72 69 61 74 65 20 66 6f 72 0a 79 6f 75 72 opriate for.your
3b40: 20 70 72 6f 6a 65 63 74 2e 20 20 54 68 65 6e 20 project. Then
3b50: 70 6f 69 6e 74 20 79 6f 75 72 20 77 65 62 62 72 point your webbr
3b60: 6f 77 73 65 72 20 61 74 20 74 68 65 20 73 63 72 owser at the scr
3b70: 69 70 74 20 61 6e 64 20 6f 66 66 20 79 6f 75 0a ipt and off you.
3b80: 67 6f 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c go.</p></li>..<l
3b90: 69 3e 3c 70 3e 3c 62 3e 53 65 74 74 69 6e 67 20 i><p><b>Setting
3ba0: 75 70 20 61 6e 20 69 6e 65 74 64 20 73 65 72 76 up an inetd serv
3bb0: 65 72 3c 2f 62 3e 3c 2f 70 3e 0a 0a 3c 70 3e 49 er</b></p>..<p>I
3bc0: 66 20 79 6f 75 20 68 61 76 65 20 69 6e 65 74 64 f you have inetd
3bd0: 20 6f 72 20 78 69 6e 65 74 64 20 72 75 6e 6e 69 or xinetd runni
3be0: 6e 67 20 6f 6e 20 79 6f 75 72 20 73 79 73 74 65 ng on your syste
3bf0: 6d 2c 20 79 6f 75 20 63 61 6e 20 73 65 74 0a 74 m, you can set.t
3c00: 68 6f 73 65 20 73 65 72 76 69 63 65 73 20 75 70 hose services up
3c10: 20 74 6f 20 6c 61 75 6e 63 68 20 66 6f 73 73 69 to launch fossi
3c20: 6c 20 74 6f 20 64 65 61 6c 20 77 69 74 68 20 69 l to deal with i
3c30: 6e 62 6f 75 6e 64 20 54 43 50 2f 49 50 20 63 6f nbound TCP/IP co
3c40: 6e 6e 65 63 74 69 6f 6e 73 0a 6f 6e 20 77 68 61 nnections.on wha
3c50: 74 65 76 65 72 20 70 6f 72 74 20 79 6f 75 20 77 tever port you w
3c60: 61 6e 74 2e 20 20 53 65 74 20 75 70 20 69 6e 65 ant. Set up ine
3c70: 74 64 20 6f 72 20 78 69 6e 65 74 64 20 74 6f 20 td or xinetd to
3c80: 6c 61 75 6e 63 68 20 66 6f 73 73 69 6c 0a 6c 69 launch fossil.li
3c90: 6b 65 20 74 68 69 73 3a 3c 2f 70 3e 0a 0a 3c 62 ke this:</p>..<b
3ca0: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a lockquote><pre>.
3cb0: 2f 75 73 72 2f 6c 6f 63 61 6c 2f 62 69 6e 2f 66 /usr/local/bin/f
3cc0: 6f 73 73 69 6c 20 68 74 74 70 20 2f 68 6f 6d 65 ossil http /home
3cd0: 2f 6d 65 2f 62 69 67 70 72 6f 6a 65 63 74 2e 66 /me/bigproject.f
3ce0: 6f 73 73 69 6c 0a 3c 2f 70 72 65 3e 3c 2f 62 6c ossil.</pre></bl
3cf0: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 41 73 ockquote>..<p>As
3d00: 20 62 65 66 6f 72 65 2c 20 63 68 61 6e 67 65 20 before, change
3d10: 74 68 65 20 66 69 6c 65 6e 61 6d 65 73 20 74 6f the filenames to
3d20: 20 77 68 61 74 65 76 65 72 20 69 73 20 61 70 70 whatever is app
3d30: 72 6f 70 72 69 61 74 65 20 66 6f 72 0a 79 6f 75 ropriate for.you
3d40: 72 20 73 79 73 74 65 6d 2e 20 20 59 6f 75 20 63 r system. You c
3d50: 61 6e 20 68 61 76 65 20 66 6f 73 73 69 6c 20 72 an have fossil r
3d60: 75 6e 20 61 73 20 61 6e 79 20 75 73 65 72 20 74 un as any user t
3d70: 68 61 74 20 68 61 73 20 77 72 69 74 65 0a 70 65 hat has write.pe
3d80: 72 6d 69 73 73 69 6f 6e 20 6f 6e 20 74 68 65 20 rmission on the
3d90: 72 65 70 6f 73 69 74 6f 72 79 20 61 6e 64 20 6f repository and o
3da0: 6e 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 20 n the directory
3db0: 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 that contains th
3dc0: 65 0a 72 65 70 6f 73 69 74 6f 72 79 2e 20 20 42 e.repository. B
3dd0: 75 74 20 69 74 20 69 73 20 73 61 66 65 72 20 74 ut it is safer t
3de0: 6f 20 72 75 6e 20 66 6f 73 73 69 6c 20 61 73 20 o run fossil as
3df0: 72 6f 6f 74 2e 20 20 57 68 65 6e 20 66 6f 73 73 root. When foss
3e00: 69 6c 0a 73 65 65 73 20 74 68 61 74 20 69 74 20 il.sees that it
3e10: 69 73 20 72 75 6e 6e 69 6e 67 20 61 73 20 72 6f is running as ro
3e20: 6f 74 2c 20 69 74 20 61 75 74 6f 6d 61 74 69 63 ot, it automatic
3e30: 61 6c 6c 79 20 70 75 74 73 20 69 74 73 65 6c 66 ally puts itself
3e40: 20 69 6e 74 6f 0a 61 20 3c 61 20 68 72 65 66 3d into.a <a href=
3e50: 22 68 74 74 70 3a 2f 2f 65 6e 2e 77 69 6b 69 70 "http://en.wikip
3e60: 65 64 69 61 2e 6f 72 67 2f 77 69 6b 69 2f 43 68 edia.org/wiki/Ch
3e70: 72 6f 6f 74 22 3e 63 68 72 6f 6f 74 20 6a 61 69 root">chroot jai
3e80: 6c 3c 2f 61 3e 20 61 6e 64 0a 64 72 6f 70 73 20 l</a> and.drops
3e90: 61 6c 6c 20 70 72 69 76 69 6c 65 67 65 73 20 70 all privileges p
3ea0: 72 69 6f 72 20 74 6f 20 72 65 61 64 69 6e 67 20 rior to reading
3eb0: 61 6e 79 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 any information
3ec0: 66 72 6f 6d 20 74 68 65 20 63 6c 69 65 6e 74 2e from the client.
3ed0: 0a 53 69 6e 63 65 20 66 6f 73 73 69 6c 20 69 73 .Since fossil is
3ee0: 20 61 20 73 74 61 6e 64 2d 61 6c 6f 6e 65 20 70 a stand-alone p
3ef0: 72 6f 67 72 61 6d 2c 20 79 6f 75 20 64 6f 20 6e rogram, you do n
3f00: 6f 74 20 6e 65 65 64 20 74 6f 20 70 75 74 20 61 ot need to put a
3f10: 6e 79 74 68 69 6e 67 0a 69 6e 20 74 68 65 20 63 nything.in the c
3f20: 68 72 6f 6f 74 20 6a 61 69 6c 20 77 69 74 68 20 hroot jail with
3f30: 66 6f 73 73 69 6c 20 69 6e 20 6f 72 64 65 72 20 fossil in order
3f40: 66 6f 72 20 69 74 20 74 6f 20 64 6f 20 69 74 73 for it to do its
3f50: 20 6a 6f 62 2e 3c 2f 70 3e 0a 3c 2f 6c 69 3e 0a job.</p>.</li>.
3f60: 3c 2f 6f 6c 3e 0a </ol>.