0000: 3c 74 69 74 6c 65 3e 46 6f 73 73 69 6c 20 43 6f <title>Fossil Co
0010: 6e 63 65 70 74 73 3c 2f 74 69 74 6c 65 3e 0a 3c ncepts</title>.<
0020: 68 31 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65 72 h1 align="center
0030: 22 3e 46 6f 73 73 69 6c 20 43 6f 6e 63 65 70 74 ">Fossil Concept
0040: 73 3c 2f 68 31 3e 0a 0a 3c 68 32 3e 31 2e 30 20 s</h1>..<h2>1.0
0050: 49 6e 74 72 6f 64 75 63 74 69 6f 6e 3c 2f 68 32 Introduction</h2
0060: 3e 0a 0a 5b 2e 2f 69 6e 64 65 78 2e 77 69 6b 69 >..[./index.wiki
0070: 20 7c 20 46 6f 73 73 69 6c 5d 20 69 73 20 61 0a | Fossil] is a.
0080: 5b 68 74 74 70 3a 2f 2f 65 6e 2e 77 69 6b 69 70 [http://en.wikip
0090: 65 64 69 61 2e 6f 72 67 2f 77 69 6b 69 2f 53 6f edia.org/wiki/So
00a0: 66 74 77 61 72 65 5f 63 6f 6e 66 69 67 75 72 61 ftware_configura
00b0: 74 69 6f 6e 5f 6d 61 6e 61 67 65 6d 65 6e 74 20 tion_management
00c0: 7c 20 73 6f 66 74 77 61 72 65 20 63 6f 6e 66 69 | software confi
00d0: 67 75 72 61 74 69 6f 6e 20 6d 61 6e 61 67 65 6d guration managem
00e0: 65 6e 74 5d 20 73 79 73 74 65 6d 2e 0a 46 6f 73 ent] system..Fos
00f0: 73 69 6c 20 69 73 20 73 6f 66 74 77 61 72 65 20 sil is software
0100: 74 68 61 74 20 69 73 20 64 65 73 69 67 6e 65 64 that is designed
0110: 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 61 6e 64 20 to control and
0120: 74 72 61 63 6b 20 74 68 65 0a 64 65 76 65 6c 6f track the.develo
0130: 70 6d 65 6e 74 20 6f 66 20 61 20 73 6f 66 74 77 pment of a softw
0140: 61 72 65 20 70 72 6f 6a 65 63 74 20 61 6e 64 20 are project and
0150: 74 6f 20 72 65 63 6f 72 64 20 74 68 65 20 68 69 to record the hi
0160: 73 74 6f 72 79 0a 6f 66 20 74 68 65 20 70 72 6f story.of the pro
0170: 6a 65 63 74 2e 0a 54 68 65 72 65 20 61 72 65 20 ject..There are
0180: 6d 61 6e 79 20 73 75 63 68 20 73 79 73 74 65 6d many such system
0190: 73 20 69 6e 20 75 73 65 20 74 6f 64 61 79 2e 20 s in use today.
01a0: 20 46 6f 73 73 69 6c 20 73 74 72 69 76 65 73 20 Fossil strives
01b0: 74 6f 0a 64 69 73 74 69 6e 67 75 69 73 68 20 69 to.distinguish i
01c0: 74 73 65 6c 66 20 66 72 6f 6d 20 74 68 65 20 6f tself from the o
01d0: 74 68 65 72 73 20 62 79 20 62 65 69 6e 67 20 65 thers by being e
01e0: 78 74 72 65 6d 65 6c 79 20 73 69 6d 70 6c 65 0a xtremely simple.
01f0: 74 6f 20 73 65 74 75 70 20 61 6e 64 20 6f 70 65 to setup and ope
0200: 72 61 74 65 2e 0a 0a 54 68 69 73 20 64 6f 63 75 rate...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 0a 0a 3c 68 32 3e 32 2e 30 fossil...<h2>2.0
0260: 20 43 6f 6d 70 6f 73 69 74 69 6f 6e 20 4f 66 20 Composition Of
0270: 41 20 50 72 6f 6a 65 63 74 3c 2f 68 32 3e 0a 3c A Project</h2>.<
0280: 69 6d 67 20 73 72 63 3d 22 63 6f 6e 63 65 70 74 img src="concept
0290: 31 2e 67 69 66 22 20 61 6c 69 67 6e 3d 22 72 69 1.gif" align="ri
02a0: 67 68 74 22 20 68 73 70 61 63 65 3d 22 31 30 22 ght" hspace="10"
02b0: 3e 0a 0a 41 20 73 6f 66 74 77 61 72 65 20 70 72 >..A software pr
02c0: 6f 6a 65 63 74 20 6e 6f 72 6d 61 6c 6c 79 20 63 oject normally c
02d0: 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 22 73 6f onsists of a "so
02e0: 75 72 63 65 20 74 72 65 65 22 2e 0a 41 20 73 6f urce tree"..A so
02f0: 75 72 63 65 20 74 72 65 65 20 69 73 20 61 20 68 urce tree is a h
0300: 69 65 72 61 72 63 68 79 20 6f 66 20 66 69 6c 65 ierarchy of file
0310: 73 20 74 68 61 74 20 61 72 65 20 75 73 65 64 20 s that are used
0320: 74 6f 20 67 65 6e 65 72 61 74 65 0a 74 68 65 20 to generate.the
0330: 65 6e 64 20 70 72 6f 64 75 63 74 2e 20 20 54 68 end product. Th
0340: 65 20 73 6f 75 72 63 65 20 74 72 65 65 20 63 68 e source tree ch
0350: 61 6e 67 65 73 20 6f 76 65 72 20 74 69 6d 65 20 anges over time
0360: 61 73 20 74 68 65 0a 73 6f 66 74 77 61 72 65 20 as the.software
0370: 67 72 6f 77 73 20 61 6e 64 20 65 78 70 61 6e 64 grows and expand
0380: 73 20 61 6e 64 20 61 73 20 66 65 61 74 75 72 65 s and as feature
0390: 73 20 61 72 65 20 61 64 64 65 64 20 61 6e 64 20 s are added and
03a0: 62 75 67 73 0a 61 72 65 20 66 69 78 65 64 2e 20 bugs.are fixed.
03b0: 20 41 20 73 6e 61 70 73 68 6f 74 20 6f 66 20 74 A snapshot of t
03c0: 68 65 20 73 6f 75 72 63 65 20 74 72 65 65 20 61 he source tree a
03d0: 74 20 61 6e 79 20 70 6f 69 6e 74 20 69 6e 20 74 t any point in t
03e0: 69 6d 65 0a 69 73 20 63 61 6c 6c 65 64 20 61 20 ime.is called a
03f0: 22 76 65 72 73 69 6f 6e 22 20 6f 72 20 22 72 65 "version" or "re
0400: 76 69 73 69 6f 6e 22 20 6f 72 20 61 20 22 62 61 vision" or a "ba
0410: 73 65 6c 69 6e 65 22 20 6f 66 20 74 68 65 20 70 seline" of the p
0420: 72 6f 64 75 63 74 2e 0a 49 6e 20 66 6f 73 73 69 roduct..In fossi
0430: 6c 2c 20 77 65 20 75 73 65 20 74 68 65 20 6e 61 l, we use the na
0440: 6d 65 20 22 63 68 65 63 6b 2d 69 6e 22 2e 0a 0a me "check-in"...
0450: 41 20 22 72 65 70 6f 73 69 74 6f 72 79 22 20 69 A "repository" i
0460: 73 20 61 20 64 61 74 61 62 61 73 65 20 74 68 61 s a database tha
0470: 74 20 63 6f 6e 74 61 69 6e 73 20 63 6f 70 69 65 t contains copie
0480: 73 20 6f 66 20 61 6c 6c 20 68 69 73 74 6f 72 69 s of all histori
0490: 63 61 6c 0a 63 68 65 63 6b 2d 69 6e 73 20 66 6f cal.check-ins fo
04a0: 72 20 61 20 70 72 6f 6a 65 63 74 2e 20 20 43 68 r a project. Ch
04b0: 65 63 6b 2d 69 6e 73 20 61 72 65 20 6e 6f 72 6d eck-ins are norm
04c0: 61 6c 6c 79 20 73 74 6f 72 65 64 20 69 6e 20 74 ally stored in t
04d0: 68 65 0a 72 65 70 6f 73 69 74 6f 72 79 20 69 6e he.repository in
04e0: 20 61 20 68 69 67 68 6c 79 20 73 70 61 63 65 2d a highly space-
04f0: 65 66 66 69 63 69 65 6e 74 20 63 6f 6d 70 72 65 efficient compre
0500: 73 73 65 64 20 66 6f 72 6d 61 74 20 28 64 65 6c ssed format (del
0510: 74 61 20 65 6e 63 6f 64 69 6e 67 29 2e 0a 42 75 ta encoding)..Bu
0520: 74 20 74 68 61 74 20 69 73 20 61 6e 20 69 6d 70 t that is an imp
0530: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 64 65 74 61 lementation deta
0540: 69 6c 20 74 68 61 74 20 79 6f 75 20 74 68 65 20 il that you the
0550: 75 73 65 72 20 6e 65 65 64 20 6e 6f 74 20 77 6f user need not wo
0560: 72 72 79 20 6f 76 65 72 2e 0a 54 68 69 6e 6b 20 rry over..Think
0570: 6f 66 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 of the repositor
0580: 79 20 61 73 20 61 20 73 61 66 65 20 70 6c 61 63 y as a safe plac
0590: 65 20 77 68 65 72 65 20 61 6c 6c 20 79 6f 75 72 e where all your
05a0: 20 6f 6c 64 20 63 68 65 63 6b 2d 69 6e 73 20 61 old check-ins a
05b0: 72 65 0a 73 65 63 75 72 65 6c 79 20 73 74 6f 72 re.securely stor
05c0: 65 64 20 61 77 61 79 20 61 6e 64 20 61 76 61 69 ed away and avai
05d0: 6c 61 62 6c 65 20 66 6f 72 20 72 65 74 72 69 65 lable for retrie
05e0: 76 61 6c 20 77 68 65 6e 65 76 65 72 20 79 6f 75 val whenever you
05f0: 20 6e 65 65 64 0a 74 68 65 6d 2e 0a 0a 41 20 72 need.them...A r
0600: 65 70 6f 73 69 74 6f 72 79 20 69 6e 20 66 6f 73 epository in fos
0610: 73 69 6c 20 69 73 20 61 20 73 69 6e 67 6c 65 20 sil is a single
0620: 66 69 6c 65 20 6f 6e 20 79 6f 75 72 20 64 69 73 file on your dis
0630: 6b 2e 20 20 54 68 69 73 20 66 69 6c 65 0a 6d 69 k. This file.mi
0640: 67 68 74 20 62 65 20 72 61 74 68 65 72 20 6c 61 ght be rather la
0650: 72 67 65 20 28 64 6f 7a 65 6e 73 20 6f 72 20 68 rge (dozens or h
0660: 75 6e 64 72 65 64 73 20 6f 66 20 6d 65 67 61 62 undreds of megab
0670: 79 74 65 73 20 66 6f 72 20 61 20 6c 61 72 67 65 ytes for a large
0680: 0a 6f 72 20 6c 6f 6e 67 20 72 75 6e 6e 69 6e 67 .or long running
0690: 20 70 72 6f 6a 65 63 74 29 20 62 75 74 20 69 74 project) but it
06a0: 20 69 73 20 6e 65 76 65 72 74 68 65 6c 65 73 73 is nevertheless
06b0: 20 6a 75 73 74 20 61 20 66 69 6c 65 2e 20 20 59 just a file. Y
06c0: 6f 75 0a 63 61 6e 20 6d 6f 76 65 20 69 74 20 61 ou.can move it a
06d0: 72 6f 75 6e 64 2c 20 72 65 6e 61 6d 65 20 69 74 round, rename it
06e0: 2c 20 77 72 69 74 65 20 69 74 20 6f 75 74 20 74 , write it out t
06f0: 6f 20 61 20 6d 65 6d 6f 72 79 20 73 74 69 63 6b o a memory stick
0700: 2c 20 6f 72 0a 64 6f 20 61 6e 79 74 68 69 6e 67 , or.do anything
0710: 20 65 6c 73 65 20 79 6f 75 20 6e 6f 72 6d 61 6c else you normal
0720: 6c 79 20 64 6f 20 77 69 74 68 20 66 69 6c 65 73 ly do with files
0730: 2e 0a 0a 45 61 63 68 20 73 6f 75 72 63 65 20 74 ...Each source t
0740: 72 65 65 20 74 68 61 74 20 69 73 20 63 6f 6e 74 ree that is cont
0750: 72 6f 6c 6c 65 64 20 62 79 20 66 6f 73 73 69 6c rolled by fossil
0760: 20 69 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 is associated w
0770: 69 74 68 0a 61 20 73 69 6e 67 6c 65 20 72 65 70 ith.a single rep
0780: 6f 73 69 74 6f 72 79 20 6f 6e 20 74 68 65 20 6c ository on the l
0790: 6f 63 61 6c 20 64 69 73 6b 20 64 72 69 76 65 2e ocal disk drive.
07a0: 20 20 59 6f 75 20 63 61 6e 20 74 69 65 20 74 77 You can tie tw
07b0: 6f 20 6f 72 20 6d 6f 72 65 0a 73 6f 75 72 63 65 o or more.source
07c0: 20 74 72 65 65 73 20 74 6f 20 61 20 73 69 6e 67 trees to a sing
07d0: 6c 65 20 72 65 70 6f 73 69 74 6f 72 79 20 69 66 le repository if
07e0: 20 79 6f 75 20 77 61 6e 74 20 28 74 68 6f 75 67 you want (thoug
07f0: 68 20 6f 6e 65 0a 74 72 65 65 20 70 65 72 20 72 h one.tree per r
0800: 65 70 6f 73 69 74 6f 72 79 20 69 73 20 74 68 65 epository is the
0810: 20 6d 6f 73 74 20 63 6f 6d 6d 6f 6e 20 63 6f 6e most common con
0820: 66 69 67 75 72 61 74 69 6f 6e 2e 29 20 20 53 6f figuration.) So
0830: 20 61 0a 73 69 6e 67 6c 65 20 72 65 70 6f 73 69 a.single reposi
0840: 74 6f 72 79 20 63 61 6e 20 62 65 20 61 73 73 6f tory can be asso
0850: 63 69 61 74 65 64 20 77 69 74 68 20 6d 61 6e 79 ciated with many
0860: 20 73 6f 75 72 63 65 20 74 72 65 65 73 2c 20 62 source trees, b
0870: 75 74 0a 65 61 63 68 20 73 6f 75 72 63 65 20 74 ut.each source t
0880: 72 65 65 20 69 73 20 61 73 73 6f 63 69 61 74 65 ree is associate
0890: 64 20 77 69 74 68 20 6f 6e 6c 79 20 6f 6e 65 20 d with only one
08a0: 72 65 70 6f 73 69 74 6f 72 79 2e 0a 0a 46 6f 73 repository...Fos
08b0: 73 69 6c 20 73 6f 75 72 63 65 20 74 72 65 65 73 sil source trees
08c0: 20 6d 61 79 20 6e 6f 74 20 6f 76 65 72 6c 61 70 may not overlap
08d0: 2e 20 20 41 20 66 6f 73 73 69 6c 20 73 6f 75 72 . A fossil sour
08e0: 63 65 20 74 72 65 65 20 69 73 20 69 64 65 6e 74 ce tree is ident
08f0: 69 66 69 65 64 0a 62 79 20 61 20 66 69 6c 65 20 ified.by a file
0900: 6e 61 6d 65 64 20 22 5f 46 4f 53 53 49 4c 5f 22 named "_FOSSIL_"
0910: 20 69 6e 20 74 68 65 20 72 6f 6f 74 20 64 69 72 in the root dir
0920: 65 63 74 6f 72 79 20 6f 66 20 74 68 65 20 73 6f ectory of the so
0930: 75 72 63 65 20 74 72 65 65 2e 20 20 45 76 65 72 urce tree. Ever
0940: 79 0a 66 69 6c 65 20 74 68 61 74 20 69 73 20 61 y.file that is a
0950: 20 73 69 62 6c 69 6e 67 20 6f 66 20 5f 46 4f 53 sibling of _FOS
0960: 53 49 4c 5f 20 61 6e 64 20 65 76 65 72 79 20 66 SIL_ and every f
0970: 69 6c 65 20 69 6e 20 65 76 65 72 79 20 73 75 62 ile in every sub
0980: 66 6f 6c 64 65 72 20 69 73 0a 63 6f 6e 73 69 64 folder is.consid
0990: 65 72 65 64 20 70 6f 74 65 6e 74 69 61 6c 6c 79 ered potentially
09a0: 20 61 20 70 61 72 74 20 6f 66 20 74 68 65 20 73 a part of the s
09b0: 6f 75 72 63 65 20 74 72 65 65 2e 20 20 54 68 65 ource tree. The
09c0: 20 5f 46 4f 53 53 49 4c 5f 20 66 69 6c 65 0a 63 _FOSSIL_ file.c
09d0: 6f 6e 74 61 69 6e 73 20 28 61 6d 6f 6e 67 20 6f ontains (among o
09e0: 74 68 65 72 20 74 68 69 6e 67 73 29 20 74 68 65 ther things) the
09f0: 20 70 61 74 68 6e 61 6d 65 20 6f 66 20 74 68 65 pathname of the
0a00: 20 72 65 70 6f 73 69 74 6f 72 79 20 77 69 74 68 repository with
0a10: 20 77 68 69 63 68 0a 74 68 65 20 73 6f 75 72 63 which.the sourc
0a20: 65 20 74 72 65 65 20 69 73 20 61 73 73 6f 63 69 e tree is associ
0a30: 61 74 65 64 2e 20 20 4f 6e 20 74 68 65 20 6f 74 ated. On the ot
0a40: 68 65 72 20 68 61 6e 64 2c 20 74 68 65 20 72 65 her hand, the re
0a50: 70 6f 73 69 74 6f 72 79 20 68 61 73 0a 6e 6f 20 pository has.no
0a60: 72 65 63 6f 72 64 20 6f 66 20 69 74 73 20 73 6f record of its so
0a70: 75 72 63 65 20 74 72 65 65 73 2e 20 20 53 6f 20 urce trees. So
0a80: 79 6f 75 20 61 72 65 20 66 72 65 65 20 74 6f 20 you are free to
0a90: 64 65 6c 65 74 65 20 61 20 73 6f 75 72 63 65 20 delete a source
0aa0: 74 72 65 65 0a 6f 72 20 6d 6f 76 65 20 69 74 20 tree.or move it
0ab0: 61 72 6f 75 6e 64 20 77 69 74 68 6f 75 74 20 63 around without c
0ac0: 6f 6e 73 65 71 75 65 6e 63 65 2e 20 20 42 75 74 onsequence. But
0ad0: 20 69 66 20 79 6f 75 20 6d 6f 76 65 20 6f 72 20 if you move or
0ae0: 72 65 6e 61 6d 65 20 6f 72 0a 64 65 6c 65 74 65 rename or.delete
0af0: 20 61 20 72 65 70 6f 73 69 74 6f 72 79 2c 20 74 a repository, t
0b00: 68 65 6e 20 61 6e 79 20 73 6f 75 72 63 65 20 74 hen any source t
0b10: 72 65 65 73 20 61 73 73 6f 63 69 61 74 65 64 20 rees associated
0b20: 77 69 74 68 20 74 68 61 74 20 72 65 70 6f 73 69 with that reposi
0b30: 74 6f 72 79 0a 77 69 6c 6c 20 6e 6f 20 6c 6f 6e tory.will no lon
0b40: 67 65 72 20 62 65 20 61 62 6c 65 20 74 6f 20 6c ger be able to l
0b50: 6f 63 61 74 65 20 74 68 65 69 72 20 72 65 70 6f ocate their repo
0b60: 73 69 74 6f 72 79 20 61 6e 64 20 77 69 6c 6c 20 sitory and will
0b70: 73 74 6f 70 20 77 6f 72 6b 69 6e 67 2e 0a 0a 57 stop working...W
0b80: 68 65 6e 20 6d 75 6c 74 69 70 6c 65 20 64 65 76 hen multiple dev
0b90: 65 6c 6f 70 65 72 73 20 61 72 65 20 77 6f 72 6b elopers are work
0ba0: 69 6e 67 20 6f 6e 20 74 68 65 20 73 61 6d 65 20 ing on the same
0bb0: 70 72 6f 6a 65 63 74 2c 20 65 61 63 68 0a 64 65 project, each.de
0bc0: 76 65 6c 6f 70 65 72 20 74 79 70 69 63 61 6c 6c veloper typicall
0bd0: 79 20 68 61 73 20 68 69 73 20 6f 72 20 68 65 72 y has his or her
0be0: 20 6f 77 6e 20 6c 6f 63 61 6c 20 72 65 70 6f 73 own local repos
0bf0: 69 74 6f 72 79 20 61 6e 64 20 61 6e 20 61 73 73 itory and an ass
0c00: 6f 63 69 61 74 65 64 0a 73 6f 75 72 63 65 20 74 ociated.source t
0c10: 72 65 65 20 69 6e 20 77 68 69 63 68 20 74 6f 20 ree in which to
0c20: 77 6f 72 6b 2e 20 20 44 65 76 65 6c 6f 70 65 72 work. Developer
0c30: 73 20 73 68 61 72 65 20 74 68 65 69 72 20 77 6f s share their wo
0c40: 72 6b 20 62 79 0a 22 73 79 6e 63 69 6e 67 22 20 rk by."syncing"
0c50: 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74 the content of t
0c60: 68 65 69 72 20 6c 6f 63 61 6c 20 72 65 70 6f 73 heir local repos
0c70: 69 74 6f 72 69 65 73 20 65 69 74 68 65 72 20 64 itories either d
0c80: 69 72 65 63 74 6c 79 0a 6f 72 20 74 68 72 6f 75 irectly.or throu
0c90: 67 68 20 61 20 63 65 6e 74 72 61 6c 20 73 65 72 gh a central ser
0ca0: 76 65 72 2e 20 20 43 68 61 6e 67 65 73 20 63 61 ver. Changes ca
0cb0: 6e 20 22 70 75 73 68 22 20 66 72 6f 6d 20 74 68 n "push" from th
0cc0: 65 20 6c 6f 63 61 6c 0a 72 65 70 6f 73 69 74 6f e local.reposito
0cd0: 72 79 20 69 6e 74 6f 20 61 20 72 65 6d 6f 74 65 ry into a remote
0ce0: 20 72 65 70 6f 73 69 74 6f 72 79 2e 20 20 4f 72 repository. Or
0cf0: 20 63 68 61 6e 67 65 73 20 63 61 6e 20 22 70 75 changes can "pu
0d00: 6c 6c 22 20 66 72 6f 6d 20 61 0a 72 65 6d 6f 74 ll" from a.remot
0d10: 65 20 72 65 70 6f 73 69 74 6f 72 79 20 69 6e 74 e repository int
0d20: 6f 20 61 20 6c 6f 63 61 6c 20 72 65 70 6f 73 69 o a local reposi
0d30: 74 6f 72 79 2e 20 20 4f 72 20 6f 6e 65 20 63 61 tory. Or one ca
0d40: 6e 20 64 6f 20 61 20 22 73 79 6e 63 22 0a 77 68 n do a "sync".wh
0d50: 69 63 68 20 69 73 20 61 20 73 68 6f 72 74 63 75 ich is a shortcu
0d60: 74 20 66 6f 72 20 64 6f 69 6e 67 20 62 6f 74 68 t for doing both
0d70: 20 61 20 70 75 73 68 20 61 6e 64 20 61 20 70 75 a push and a pu
0d80: 6c 6c 20 61 74 20 74 68 65 20 73 61 6d 65 20 74 ll at the same t
0d90: 69 6d 65 2e 0a 46 6f 73 73 69 6c 20 61 6c 73 6f ime..Fossil also
0da0: 20 68 61 73 20 74 68 65 20 63 6f 6e 63 65 70 74 has the concept
0db0: 20 6f 66 20 22 63 6c 6f 6e 69 6e 67 22 2e 20 20 of "cloning".
0dc0: 41 20 22 63 6c 6f 6e 65 22 20 69 73 20 6c 69 6b A "clone" is lik
0dd0: 65 20 61 20 22 70 75 6c 6c 22 2c 0a 65 78 63 65 e a "pull",.exce
0de0: 70 74 20 74 68 61 74 20 69 6e 73 74 65 61 64 20 pt that instead
0df0: 6f 66 20 62 65 67 69 6e 6e 69 6e 67 20 77 69 74 of beginning wit
0e00: 68 20 61 6e 20 65 78 69 73 74 69 6e 67 20 6c 6f h an existing lo
0e10: 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 2c 0a cal repository,.
0e20: 61 20 63 6c 6f 6e 65 20 62 65 67 69 6e 73 20 77 a clone begins w
0e30: 69 74 68 20 6e 6f 74 68 69 6e 67 20 61 6e 64 20 ith nothing and
0e40: 63 72 65 61 74 65 73 20 61 20 6e 65 77 20 6c 6f creates a new lo
0e50: 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 20 74 cal repository t
0e60: 68 61 74 0a 69 73 20 61 20 64 75 70 6c 69 63 61 hat.is a duplica
0e70: 74 65 20 6f 66 20 61 20 72 65 6d 6f 74 65 20 72 te of a remote r
0e80: 65 70 6f 73 69 74 6f 72 79 2e 0a 0a 43 6f 6d 6d epository...Comm
0e90: 75 6e 69 63 61 74 69 6f 6e 20 62 65 74 77 65 65 unication betwee
0ea0: 6e 20 72 65 70 6f 73 69 74 6f 72 69 65 73 20 69 n repositories i
0eb0: 73 20 76 69 61 20 48 54 54 50 2e 20 20 52 65 6d s via HTTP. Rem
0ec0: 6f 74 65 0a 72 65 70 6f 73 69 74 6f 72 69 65 73 ote.repositories
0ed0: 20 61 72 65 20 69 64 65 6e 74 69 66 69 65 64 20 are identified
0ee0: 62 79 20 55 52 4c 2e 20 20 59 6f 75 20 63 61 6e by URL. You can
0ef0: 20 61 6c 73 6f 20 70 6f 69 6e 74 20 61 20 77 65 also point a we
0f00: 62 20 62 72 6f 77 73 65 72 0a 61 74 20 61 20 72 b browser.at a r
0f10: 65 70 6f 73 69 74 6f 72 79 20 61 6e 64 20 67 65 epository and ge
0f20: 74 20 68 75 6d 61 6e 2d 72 65 61 64 61 62 6c 65 t human-readable
0f30: 20 73 74 61 74 75 73 2c 20 68 69 73 74 6f 72 79 status, history
0f40: 2c 20 61 6e 64 20 74 72 61 63 6b 69 6e 67 0a 69 , and tracking.i
0f50: 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 nformation about
0f60: 20 74 68 65 20 70 72 6f 6a 65 63 74 2e 0a 0a 3c the project...<
0f70: 68 33 3e 32 2e 31 20 49 64 65 6e 74 69 66 69 63 h3>2.1 Identific
0f80: 61 74 69 6f 6e 20 4f 66 20 41 72 74 69 66 61 63 ation Of Artifac
0f90: 74 73 3c 2f 68 33 3e 0a 0a 41 20 70 61 72 74 69 ts</h3>..A parti
0fa0: 63 75 6c 61 72 20 76 65 72 73 69 6f 6e 20 6f 66 cular version of
0fb0: 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 66 69 a particular fi
0fc0: 6c 65 20 69 73 20 63 61 6c 6c 65 64 20 61 6e 20 le is called an
0fd0: 22 61 72 74 69 66 61 63 74 22 2e 0a 45 61 63 68 "artifact"..Each
0fe0: 20 61 72 74 69 66 61 63 74 20 68 61 73 20 61 20 artifact has a
0ff0: 75 6e 69 76 65 72 73 61 6c 6c 79 20 75 6e 69 71 universally uniq
1000: 75 65 20 6e 61 6d 65 20 77 68 69 63 68 20 69 73 ue name which is
1010: 20 74 68 65 0a 3c 61 20 68 72 65 66 3d 22 68 74 the.<a href="ht
1020: 74 70 3a 2f 2f 65 6e 2e 77 69 6b 69 70 65 64 69 tp://en.wikipedi
1030: 61 2e 6f 72 67 2f 77 69 6b 69 2f 53 48 41 22 3e a.org/wiki/SHA">
1040: 53 48 41 31 3c 2f 61 3e 20 68 61 73 68 20 6f 66 SHA1</a> hash of
1050: 20 74 68 65 20 63 6f 6e 74 65 6e 74 0a 6f 66 20 the content.of
1060: 74 68 61 74 20 66 69 6c 65 20 65 78 70 72 65 73 that file expres
1070: 73 65 64 20 61 73 20 34 30 20 63 68 61 72 61 63 sed as 40 charac
1080: 74 65 72 73 20 6f 66 20 6c 6f 77 65 72 2d 63 61 ters of lower-ca
1090: 73 65 20 68 65 78 61 64 65 63 69 6d 61 6c 2e 20 se hexadecimal.
10a0: 20 53 75 63 68 0a 61 20 68 61 73 68 20 69 73 20 Such.a hash is
10b0: 72 65 66 65 72 72 65 64 20 74 6f 20 61 73 20 74 referred to as t
10c0: 68 65 20 41 72 74 69 66 61 63 74 20 49 64 65 6e he Artifact Iden
10d0: 74 69 66 69 65 72 20 6f 72 20 41 72 74 69 66 61 tifier or Artifa
10e0: 63 74 20 49 44 0a 66 6f 72 20 74 68 65 20 61 72 ct ID.for the ar
10f0: 74 69 66 61 63 74 2e 20 20 54 68 65 20 53 48 41 tifact. The SHA
1100: 31 20 61 6c 67 6f 72 69 74 68 6d 20 69 73 20 63 1 algorithm is c
1110: 72 65 61 74 65 64 20 77 69 74 68 20 74 68 65 20 reated with the
1120: 70 75 72 70 6f 73 65 20 6f 66 0a 70 72 6f 76 69 purpose of.provi
1130: 64 69 6e 67 20 61 20 68 69 67 68 6c 79 20 66 6f ding a highly fo
1140: 72 67 65 72 79 2d 72 65 73 69 73 74 61 6e 74 20 rgery-resistant
1150: 69 64 65 6e 74 69 66 69 65 72 20 66 6f 72 20 61 identifier for a
1160: 20 66 69 6c 65 2e 20 20 47 69 76 65 6e 20 61 6e file. Given an
1170: 79 0a 66 69 6c 65 20 69 74 20 69 73 20 73 69 6d y.file it is sim
1180: 70 6c 65 20 74 6f 20 66 69 6e 64 20 74 68 65 20 ple to find the
1190: 61 72 74 69 66 61 63 74 20 49 44 20 66 6f 72 20 artifact ID for
11a0: 74 68 61 74 20 66 69 6c 65 2e 20 20 42 75 74 20 that file. But
11b0: 67 69 76 65 6e 20 61 0a 61 72 74 69 66 61 63 74 given a.artifact
11c0: 20 49 44 20 69 74 20 69 73 20 63 6f 6d 70 75 74 ID it is comput
11d0: 61 74 69 6f 6e 61 6c 6c 79 20 69 6e 74 72 61 63 ationally intrac
11e0: 74 61 62 6c 65 20 74 6f 20 67 65 6e 65 72 61 74 table to generat
11f0: 65 20 61 20 66 69 6c 65 20 74 68 61 74 20 77 69 e a file that wi
1200: 6c 6c 0a 68 61 76 65 20 74 68 61 74 20 41 72 74 ll.have that Art
1210: 69 66 61 63 74 20 49 44 2e 0a 0a 41 72 74 69 66 ifact ID...Artif
1220: 61 63 74 20 49 44 73 20 6c 6f 6f 6b 20 73 6f 6d act IDs look som
1230: 65 74 68 69 6e 67 20 6c 69 6b 65 20 74 68 69 73 ething like this
1240: 3a 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c :..<blockquote><
1250: 62 3e 0a 36 30 38 39 66 30 62 35 36 33 61 39 64 b>.6089f0b563a9d
1260: 62 30 61 36 64 39 30 36 38 32 66 65 34 37 66 64 b0a6d90682fe47fd
1270: 37 31 36 31 66 66 38 36 37 63 38 3c 62 72 3e 0a 7161ff867c8<br>.
1280: 35 39 37 31 32 36 31 34 61 31 62 33 63 63 66 64 59712614a1b3ccfd
1290: 38 34 30 37 38 61 33 37 66 61 35 62 36 30 36 65 84078a37fa5b606e
12a0: 32 38 34 33 34 33 32 36 3c 62 72 3e 0a 31 39 64 28434326<br>.19d
12b0: 62 66 37 33 30 37 38 62 65 39 37 37 39 65 64 64 bf73078be9779edd
12c0: 36 61 30 31 35 36 31 39 35 65 36 31 30 66 38 31 6a0156195e610f81
12d0: 63 39 34 66 39 3c 62 72 3e 0a 62 34 31 30 34 39 c94f9<br>.b41049
12e0: 35 39 61 36 37 31 37 35 66 30 32 64 36 62 34 31 59a67175f02d6b41
12f0: 35 34 38 30 62 65 32 32 61 32 33 39 66 31 66 30 5480be22a239f1f0
1300: 37 37 3c 62 72 3e 0a 39 39 37 63 39 64 36 61 65 77<br>.997c9d6ae
1310: 30 33 61 64 31 31 34 62 32 62 35 37 66 30 34 65 03ad114b2b57f04e
1320: 39 65 65 65 66 31 37 64 63 62 38 32 37 38 38 0a 9eeef17dcb82788.
1330: 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 </b></blockquote
1340: 3e 0a 0a 57 68 65 6e 20 72 65 66 65 72 72 69 6e >..When referrin
1350: 67 20 74 6f 20 61 6e 20 61 72 74 69 66 61 63 74 g to an artifact
1360: 20 75 73 69 6e 67 20 66 6f 73 73 69 6c 2c 20 79 using fossil, y
1370: 6f 75 20 63 61 6e 20 75 73 65 20 61 20 75 6e 69 ou can use a uni
1380: 71 75 65 0a 70 72 65 66 69 78 20 6f 66 20 74 68 que.prefix of th
1390: 65 20 61 72 74 69 66 61 63 74 20 49 44 20 74 68 e artifact ID th
13a0: 61 74 20 69 73 20 66 6f 75 72 20 63 68 61 72 61 at is four chara
13b0: 63 74 65 72 73 20 6f 72 20 6c 6f 6e 67 65 72 2e cters or longer.
13c0: 20 20 54 68 69 73 20 73 61 76 65 73 0a 61 20 6c This saves.a l
13d0: 6f 74 20 6f 66 20 74 79 70 69 6e 67 2e 20 20 57 ot of typing. W
13e0: 68 65 6e 20 64 69 73 70 6c 61 79 69 6e 67 20 61 hen displaying a
13f0: 72 74 69 66 61 63 74 20 49 44 73 2c 20 66 6f 73 rtifact IDs, fos
1400: 73 69 6c 20 77 69 6c 6c 20 75 73 75 61 6c 6c 79 sil will usually
1410: 20 6f 6e 6c 79 0a 73 68 6f 77 20 74 68 65 20 66 only.show the f
1420: 69 72 73 74 20 31 30 20 64 69 67 69 74 73 20 73 irst 10 digits s
1430: 69 6e 63 65 20 74 68 61 74 20 69 73 20 6e 6f 72 ince that is nor
1440: 6d 61 6c 6c 79 20 65 6e 6f 75 67 68 20 74 6f 20 mally enough to
1450: 75 6e 69 71 75 65 6c 79 0a 69 64 65 6e 74 69 66 uniquely.identif
1460: 79 20 61 20 66 69 6c 65 2e 0a 0a 43 68 61 6e 67 y a file...Chang
1470: 69 6e 67 20 28 6f 72 20 61 64 64 69 6e 67 20 6f ing (or adding o
1480: 72 20 72 65 6d 6f 76 69 6e 67 29 20 61 20 73 69 r removing) a si
1490: 6e 67 6c 65 20 62 79 74 65 20 69 6e 20 61 20 66 ngle byte in a f
14a0: 69 6c 65 20 72 65 73 75 6c 74 73 0a 69 6e 20 61 ile results.in a
14b0: 20 63 6f 6d 70 6c 65 74 65 6c 79 20 64 69 66 66 completely diff
14c0: 65 72 65 6e 74 20 61 72 74 69 66 61 63 74 20 49 erent artifact I
14d0: 44 2e 20 20 41 6e 64 20 73 69 6e 63 65 20 74 68 D. And since th
14e0: 65 20 61 72 74 69 66 61 63 74 20 49 44 20 69 73 e artifact ID is
14f0: 20 74 68 65 20 6e 61 6d 65 20 6f 66 0a 74 68 65 the name of.the
1500: 20 61 72 74 69 66 61 63 74 2c 20 6d 61 6b 69 6e artifact, makin
1510: 67 20 61 6e 79 20 63 68 61 6e 67 65 20 74 6f 20 g any change to
1520: 61 20 66 69 6c 65 20 72 65 73 75 6c 74 73 20 69 a file results i
1530: 6e 20 61 20 6e 65 77 20 61 72 74 69 66 61 63 74 n a new artifact
1540: 2e 0a 49 6e 20 74 68 69 73 20 77 61 79 2c 20 61 ..In this way, a
1550: 72 74 69 66 61 63 74 73 20 61 72 65 20 69 6d 6d rtifacts are imm
1560: 75 74 61 62 6c 65 2e 0a 0a 41 20 72 65 70 6f 73 utable...A repos
1570: 69 74 6f 72 79 20 69 73 20 72 65 61 6c 6c 79 20 itory is really
1580: 6a 75 73 74 20 61 6e 20 75 6e 6f 72 64 65 72 65 just an unordere
1590: 64 20 63 6f 6c 6c 65 63 74 69 6f 6e 20 6f 66 0a d collection of.
15a0: 61 72 74 69 66 61 63 74 73 2e 20 20 4e 65 77 20 artifacts. New
15b0: 61 72 74 69 66 61 63 74 73 20 63 61 6e 20 62 65 artifacts can be
15c0: 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 72 65 added to the re
15d0: 70 6f 73 69 74 6f 72 79 2c 20 62 75 74 0a 65 78 pository, but.ex
15e0: 69 73 74 69 6e 67 20 61 72 74 69 66 61 63 74 73 isting artifacts
15f0: 20 63 61 6e 20 6e 65 76 65 72 20 62 65 20 72 65 can never be re
1600: 6d 6f 76 65 64 2e 20 20 28 57 65 6c 6c 2c 20 61 moved. (Well, a
1610: 6c 6d 6f 73 74 20 6e 65 76 65 72 2e 20 54 68 65 lmost never. The
1620: 72 65 0a 69 73 20 61 20 5b 2e 2f 73 68 75 6e 6e re.is a [./shunn
1630: 69 6e 67 2e 77 69 6b 69 20 7c 20 22 73 68 75 6e ing.wiki | "shun
1640: 6e 69 6e 67 22 5d 20 6d 65 63 68 61 6e 69 73 6d ning"] mechanism
1650: 20 74 68 61 74 20 61 6c 6c 6f 77 73 20 73 70 61 that allows spa
1660: 6d 20 6f 72 20 6f 74 68 65 72 0a 69 6e 61 70 70 m or other.inapp
1670: 72 6f 70 72 69 61 74 65 20 63 6f 6e 74 65 6e 74 ropriate content
1680: 20 74 6f 20 62 65 20 72 65 6d 6f 76 65 64 20 69 to be removed i
1690: 66 20 61 62 73 6f 6c 75 74 65 6c 79 20 6e 65 63 f absolutely nec
16a0: 65 73 73 61 72 79 2c 20 62 75 74 20 73 75 63 68 essary, but such
16b0: 0a 72 65 6d 6f 76 61 6c 20 69 73 20 64 69 73 63 .removal is disc
16c0: 6f 75 72 61 67 65 64 2e 29 0a 46 6f 73 73 69 6c ouraged.).Fossil
16d0: 20 69 73 20 64 65 73 69 67 6e 65 64 20 69 6e 0a is designed in.
16e0: 73 75 63 68 20 61 20 77 61 79 20 74 68 61 74 20 such a way that
16f0: 69 74 20 63 61 6e 20 62 65 20 68 61 6e 64 65 64 it can be handed
1700: 20 61 20 73 65 74 20 6f 66 20 61 72 74 69 66 61 a set of artifa
1710: 63 74 73 20 69 6e 20 61 6e 79 0a 6f 72 64 65 72 cts in any.order
1720: 20 61 6e 64 20 69 74 20 63 61 6e 20 66 69 67 75 and it can figu
1730: 72 65 20 6f 75 74 20 74 68 65 20 72 65 6c 61 74 re out the relat
1740: 69 6f 6e 73 68 69 70 20 62 65 74 77 65 65 6e 20 ionship between
1750: 74 68 6f 73 65 0a 61 72 74 69 66 61 63 74 73 20 those.artifacts
1760: 61 6e 64 20 72 65 63 6f 6e 73 74 72 75 63 74 20 and reconstruct
1770: 74 68 65 20 63 6f 6d 70 6c 65 74 65 20 64 65 76 the complete dev
1780: 65 6c 6f 70 6d 65 6e 74 20 68 69 73 74 6f 72 79 elopment history
1790: 20 6f 66 0a 61 20 73 6f 66 74 77 61 72 65 20 70 of.a software p
17a0: 72 6f 6a 65 63 74 2e 0a 0a 3c 68 33 3e 32 2e 32 roject...<h3>2.2
17b0: 20 4d 61 6e 69 66 65 73 74 73 3c 2f 68 33 3e 0a Manifests</h3>.
17c0: 0a 41 74 20 74 68 65 20 72 6f 6f 74 20 6f 66 20 .At the root of
17d0: 61 20 73 6f 75 72 63 65 20 74 72 65 65 20 69 73 a source tree is
17e0: 20 61 20 73 70 65 63 69 61 6c 20 66 69 6c 65 20 a special file
17f0: 63 61 6c 6c 65 64 20 74 68 65 0a 22 6d 61 6e 69 called the."mani
1800: 66 65 73 74 22 2e 20 20 54 68 65 20 6d 61 6e 69 fest". The mani
1810: 66 65 73 74 20 69 73 20 61 20 6c 69 73 74 69 6e fest is a listin
1820: 67 20 6f 66 20 61 6c 6c 20 6f 74 68 65 72 20 66 g of all other f
1830: 69 6c 65 73 20 69 6e 0a 74 68 61 74 20 73 6f 75 iles in.that sou
1840: 72 63 65 20 74 72 65 65 2e 20 20 54 68 65 20 6d rce tree. The m
1850: 61 6e 69 66 65 73 74 20 63 6f 6e 74 61 69 6e 73 anifest contains
1860: 20 74 68 65 20 28 63 6f 6d 70 6c 65 74 65 29 20 the (complete)
1870: 61 72 74 69 66 61 63 74 20 49 44 20 0a 6f 66 20 artifact ID .of
1880: 74 68 65 20 66 69 6c 65 20 61 6e 64 20 74 68 65 the file and the
1890: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 66 69 6c name of the fil
18a0: 65 20 61 73 20 69 74 20 61 70 70 65 61 72 73 20 e as it appears
18b0: 6f 6e 20 64 69 73 6b 2c 0a 61 6e 64 20 74 68 75 on disk,.and thu
18c0: 73 20 73 65 72 76 65 73 20 61 73 20 61 20 6d 61 s serves as a ma
18d0: 70 70 69 6e 67 20 66 72 6f 6d 20 61 72 74 69 66 pping from artif
18e0: 61 63 74 20 49 44 20 74 6f 20 64 69 73 6b 20 6e act ID to disk n
18f0: 61 6d 65 2e 20 20 54 68 65 20 61 72 74 69 66 61 ame. The artifa
1900: 63 74 20 49 44 0a 6f 66 20 74 68 65 20 6d 61 6e ct ID.of the man
1910: 69 66 65 73 74 20 69 73 20 74 68 65 20 69 64 65 ifest is the ide
1920: 6e 74 69 66 69 65 72 20 66 6f 72 20 74 68 65 20 ntifier for the
1930: 65 6e 74 69 72 65 20 63 68 65 63 6b 2d 69 6e 2e entire check-in.
1940: 20 20 57 68 65 6e 0a 79 6f 75 20 6c 6f 6f 6b 20 When.you look
1950: 61 74 20 61 20 22 74 69 6d 65 6c 69 6e 65 22 20 at a "timeline"
1960: 6f 66 20 63 68 61 6e 67 65 73 20 69 6e 20 66 6f of changes in fo
1970: 73 73 69 6c 2c 20 74 68 65 20 49 44 20 61 73 73 ssil, the ID ass
1980: 6f 63 69 61 74 65 64 0a 77 69 74 68 20 65 61 63 ociated.with eac
1990: 68 20 63 68 65 63 6b 2d 69 6e 20 6f 72 20 63 6f h check-in or co
19a0: 6d 6d 69 74 20 69 73 20 72 65 61 6c 6c 79 20 6a mmit is really j
19b0: 75 73 74 20 74 68 65 20 61 72 74 69 66 61 63 74 ust the artifact
19c0: 20 49 44 20 6f 66 20 74 68 65 0a 6d 61 6e 69 66 ID of the.manif
19d0: 65 73 74 20 66 6f 72 20 74 68 61 74 20 63 68 65 est for that che
19e0: 63 6b 2d 69 6e 2e 0a 0a 3c 70 3e 46 6f 73 73 69 ck-in...<p>Fossi
19f0: 6c 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 l automatically
1a00: 67 65 6e 65 72 61 74 65 73 20 61 20 6d 61 6e 69 generates a mani
1a10: 66 65 73 74 20 77 68 65 6e 65 76 65 72 20 79 6f fest whenever yo
1a20: 75 20 22 63 6f 6d 6d 69 74 22 20 0a 61 20 6e 65 u "commit" .a ne
1a30: 77 20 63 68 65 63 6b 2d 69 6e 2e 20 20 53 6f 20 w check-in. So
1a40: 74 68 69 73 20 69 73 20 6e 6f 74 20 73 6f 6d 65 this is not some
1a50: 74 68 69 6e 67 20 74 68 61 74 20 79 6f 75 2c 20 thing that you,
1a60: 74 68 65 20 64 65 76 65 6c 6f 70 65 72 2c 0a 6e the developer,.n
1a70: 65 65 64 20 74 6f 20 77 6f 72 72 79 20 77 69 74 eed to worry wit
1a80: 68 2e 20 20 54 68 65 20 66 6f 72 6d 61 74 20 6f h. The format o
1a90: 66 20 61 20 6d 61 6e 69 66 65 73 74 20 69 73 20 f a manifest is
1aa0: 69 6e 74 65 6e 74 69 6f 6e 61 6c 6c 79 0a 64 65 intentionally.de
1ab0: 73 69 67 6e 65 64 20 74 6f 20 62 65 20 73 69 6d signed to be sim
1ac0: 70 6c 65 20 74 6f 20 70 61 72 73 65 2c 20 73 6f ple to parse, so
1ad0: 20 74 68 61 74 20 69 66 0a 79 6f 75 20 77 61 6e that if.you wan
1ae0: 74 20 74 6f 20 72 65 61 64 20 61 6e 64 20 69 6e t to read and in
1af0: 74 65 72 70 72 65 74 20 61 20 6d 61 6e 69 66 65 terpret a manife
1b00: 73 74 2c 20 65 69 74 68 65 72 20 62 79 20 68 61 st, either by ha
1b10: 6e 64 20 6f 72 0a 77 69 74 68 20 61 20 73 63 72 nd or.with a scr
1b20: 69 70 74 2c 20 74 68 61 74 20 69 73 20 65 61 73 ipt, that is eas
1b30: 79 20 74 6f 20 64 6f 2e 20 20 42 75 74 20 79 6f y to do. But yo
1b40: 75 20 77 69 6c 6c 20 70 72 6f 62 61 62 6c 79 20 u will probably
1b50: 6e 65 76 65 72 0a 6e 65 65 64 20 74 6f 20 64 6f never.need to do
1b60: 20 73 6f 2e 3c 2f 70 3e 0a 0a 3c 70 3e 49 6e 20 so.</p>..<p>In
1b70: 61 64 64 69 74 69 6f 6e 20 74 6f 20 69 64 65 6e addition to iden
1b80: 74 69 66 79 69 6e 67 20 61 6c 6c 20 66 69 6c 65 tifying all file
1b90: 73 20 69 6e 20 74 68 65 20 63 68 65 63 6b 2d 69 s in the check-i
1ba0: 6e 2c 20 61 0a 6d 61 6e 69 66 65 73 74 20 61 6c n, a.manifest al
1bb0: 73 6f 20 63 6f 6e 74 61 69 6e 73 20 61 20 63 68 so contains a ch
1bc0: 65 63 6b 2d 69 6e 20 63 6f 6d 6d 65 6e 74 2c 20 eck-in comment,
1bd0: 74 68 65 20 64 61 74 65 20 61 6e 64 20 74 69 6d the date and tim
1be0: 65 0a 77 68 65 6e 20 74 68 65 20 63 68 65 63 6b e.when the check
1bf0: 2d 69 6e 20 77 61 73 20 65 73 74 61 62 6c 69 73 -in was establis
1c00: 68 65 64 2c 20 77 68 6f 20 63 72 65 61 74 65 64 hed, who created
1c10: 20 74 68 65 20 63 68 65 63 6b 2d 69 6e 2c 0a 61 the check-in,.a
1c20: 6e 64 20 6c 69 6e 6b 73 20 74 6f 20 6f 74 68 65 nd links to othe
1c30: 72 20 63 68 65 63 6b 2d 69 6e 73 20 66 72 6f 6d r check-ins from
1c40: 20 77 68 69 63 68 20 74 68 65 20 63 75 72 72 65 which the curre
1c50: 6e 74 20 63 68 65 63 6b 2d 69 6e 0a 69 73 20 64 nt check-in.is d
1c60: 65 72 69 76 65 64 2e 20 20 54 68 65 72 65 20 69 erived. There i
1c70: 73 20 61 6c 73 6f 20 61 20 63 6f 75 70 6c 65 20 s also a couple
1c80: 6f 66 20 63 68 65 63 6b 73 75 6d 73 20 75 73 65 of checksums use
1c90: 64 20 74 6f 20 76 65 72 69 66 79 0a 74 68 65 20 d to verify.the
1ca0: 69 6e 74 65 67 72 69 74 79 20 6f 66 20 74 68 65 integrity of the
1cb0: 20 63 68 65 63 6b 2d 69 6e 2e 20 20 41 6e 64 20 check-in. And
1cc0: 74 68 65 20 77 68 6f 6c 65 20 6d 61 6e 69 66 65 the whole manife
1cd0: 73 74 20 6d 69 67 68 74 0a 62 65 20 50 47 50 20 st might.be PGP
1ce0: 63 6c 65 61 72 73 69 67 6e 65 64 2e 3c 2f 70 3e clearsigned.</p>
1cf0: 0a 0a 3c 61 20 6e 61 6d 65 3d 22 6b 65 79 63 6f ..<a name="keyco
1d00: 6e 63 22 3e 3c 2f 61 3e 0a 3c 68 33 3e 32 2e 33 nc"></a>.<h3>2.3
1d10: 20 4b 65 79 20 63 6f 6e 63 65 70 74 73 3c 2f 68 Key concepts</h
1d20: 33 3e 0a 0a 3c 75 6c 3e 0a 3c 6c 69 3e 41 20 3c 3>..<ul>.<li>A <
1d30: 62 3e 63 68 65 63 6b 2d 69 6e 3c 2f 62 3e 20 69 b>check-in</b> i
1d40: 73 20 61 20 73 65 74 20 6f 66 20 66 69 6c 65 73 s a set of files
1d50: 20 61 72 72 61 6e 67 65 64 0a 20 20 20 20 69 6e arranged. in
1d60: 20 61 20 68 69 65 72 61 72 63 68 79 2e 3c 2f 6c a hierarchy.</l
1d70: 69 3e 0a 3c 6c 69 3e 41 20 3c 62 3e 72 65 70 6f i>.<li>A <b>repo
1d80: 73 69 74 6f 72 79 3c 2f 62 3e 20 6b 65 65 70 73 sitory</b> keeps
1d90: 20 61 20 72 65 63 6f 72 64 20 6f 66 20 68 69 73 a record of his
1da0: 74 6f 72 69 63 61 6c 20 63 68 65 63 6b 2d 69 6e torical check-in
1db0: 73 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 52 65 70 6f s.</li>.<li>Repo
1dc0: 73 69 74 6f 72 69 65 73 20 73 68 61 72 65 20 74 sitories share t
1dd0: 68 65 69 72 20 63 68 61 6e 67 65 73 20 75 73 69 heir changes usi
1de0: 6e 67 20 3c 62 3e 70 75 73 68 3c 2f 62 3e 2c 20 ng <b>push</b>,
1df0: 3c 62 3e 70 75 6c 6c 3c 2f 62 3e 2c 0a 20 20 20 <b>pull</b>,.
1e00: 20 3c 62 3e 73 79 6e 63 3c 2f 62 3e 2c 20 61 6e <b>sync</b>, an
1e10: 64 20 3c 62 3e 63 6c 6f 6e 65 3c 2f 62 3e 2e 3c d <b>clone</b>.<
1e20: 2f 6c 69 3e 0a 3c 6c 69 3e 41 20 70 61 72 74 69 /li>.<li>A parti
1e30: 63 75 6c 61 72 20 3c 75 3e 76 65 72 73 69 6f 6e cular <u>version
1e40: 3c 2f 75 3e 20 6f 66 20 61 20 70 61 72 74 69 63 </u> of a partic
1e50: 75 6c 61 72 20 66 69 6c 65 20 69 73 20 61 6e 20 ular file is an
1e60: 3c 62 3e 61 72 74 69 66 61 63 74 3c 2f 62 3e 0a <b>artifact</b>.
1e70: 20 20 20 20 74 68 61 74 20 69 73 20 69 64 65 6e that is iden
1e80: 74 69 66 69 65 64 20 62 79 20 61 6e 20 3c 62 3e tified by an <b>
1e90: 61 72 74 69 66 61 63 74 20 49 44 3c 2f 62 3e 2e artifact ID</b>.
1ea0: 3c 2f 6c 69 3e 0a 3c 6c 69 3e 41 72 74 69 66 61 </li>.<li>Artifa
1eb0: 63 74 73 20 74 72 61 63 6b 65 64 20 62 79 20 66 cts tracked by f
1ec0: 6f 73 73 69 6c 20 61 72 65 20 69 6e 68 65 72 65 ossil are inhere
1ed0: 6e 74 6c 79 20 69 6d 6d 75 74 61 62 6c 65 2e 3c ntly immutable.<
1ee0: 2f 6c 69 3e 0a 3c 6c 69 3e 46 6f 73 73 69 6c 20 /li>.<li>Fossil
1ef0: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 67 65 automatically ge
1f00: 6e 65 72 61 74 65 73 20 61 20 3c 62 3e 6d 61 6e nerates a <b>man
1f10: 69 66 65 73 74 3c 2f 62 3e 20 66 69 6c 65 20 74 ifest</b> file t
1f20: 68 61 74 20 69 64 65 6e 74 69 66 69 65 73 0a 20 hat identifies.
1f30: 20 20 20 65 76 65 72 79 20 61 72 74 69 66 61 63 every artifac
1f40: 74 20 69 6e 20 61 20 63 68 65 63 6b 2d 69 6e 2e t in a check-in.
1f50: 3c 2f 6c 69 3e 0a 3c 6c 69 3e 54 68 65 20 61 72 </li>.<li>The ar
1f60: 74 69 66 61 63 74 20 49 44 20 6f 66 20 74 68 65 tifact ID of the
1f70: 20 6d 61 6e 69 66 65 73 74 20 69 73 20 74 68 65 manifest is the
1f80: 20 69 64 65 6e 74 69 66 69 65 72 20 6f 66 20 74 identifier of t
1f90: 68 65 20 63 68 65 63 6b 2d 69 6e 2e 3c 2f 6c 69 he check-in.</li
1fa0: 3e 0a 3c 2f 75 6c 3e 0a 0a 3c 68 32 3e 33 2e 30 >.</ul>..<h2>3.0
1fb0: 20 46 6f 73 73 69 6c 20 2d 20 54 68 65 20 50 72 Fossil - The Pr
1fc0: 6f 67 72 61 6d 3c 2f 68 32 3e 0a 0a 46 6f 73 73 ogram</h2>..Foss
1fd0: 69 6c 20 69 73 20 73 6f 66 74 77 61 72 65 2e 20 il is software.
1fe0: 20 54 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 The implementat
1ff0: 69 6f 6e 20 6f 66 20 66 6f 73 73 69 6c 20 69 73 ion of fossil is
2000: 20 69 6e 20 74 68 65 20 66 6f 72 6d 0a 6f 66 20 in the form.of
2010: 61 20 73 69 6e 67 6c 65 20 65 78 65 63 75 74 61 a single executa
2020: 62 6c 65 20 6e 61 6d 65 64 20 22 66 6f 73 73 69 ble named "fossi
2030: 6c 22 20 28 6f 72 20 22 66 6f 73 73 69 6c 2e 65 l" (or "fossil.e
2040: 78 65 22 20 6f 6e 20 77 69 6e 64 6f 77 73 29 2e xe" on windows).
2050: 0a 54 6f 20 69 6e 73 74 61 6c 6c 20 66 6f 73 73 .To install foss
2060: 69 6c 20 6f 6e 20 79 6f 75 72 20 73 79 73 74 65 il on your syste
2070: 6d 2c 0a 61 6c 6c 20 79 6f 75 20 68 61 76 65 20 m,.all you have
2080: 74 6f 20 64 6f 20 69 73 20 6f 62 74 61 69 6e 20 to do is obtain
2090: 61 20 63 6f 70 79 20 6f 66 20 74 68 69 73 20 6f a copy of this o
20a0: 6e 65 20 65 78 65 63 75 74 61 62 6c 65 20 66 69 ne executable fi
20b0: 6c 65 20 28 65 69 74 68 65 72 0a 62 79 20 64 6f le (either.by do
20c0: 77 6e 6c 6f 61 64 69 6e 67 20 61 0a 3c 61 20 68 wnloading a.<a h
20d0: 72 65 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e ref="http://www.
20e0: 66 6f 73 73 69 6c 2d 73 63 6d 2e 6f 72 67 2f 64 fossil-scm.org/d
20f0: 6f 77 6e 6c 6f 61 64 2e 68 74 6d 6c 22 3e 70 72 ownload.html">pr
2100: 65 2d 63 6f 6d 70 69 6c 65 64 20 76 65 72 73 69 e-compiled versi
2110: 6f 6e 3c 2f 61 3e 0a 6f 72 20 5b 2e 2f 62 75 69 on</a>.or [./bui
2120: 6c 64 2e 77 69 6b 69 20 7c 20 63 6f 6d 70 69 6c ld.wiki | compil
2130: 69 6e 67 20 69 74 20 79 6f 75 72 73 65 6c 66 5d ing it yourself]
2140: 29 20 61 6e 64 20 74 68 65 6e 0a 70 75 74 74 69 ) and then.putti
2150: 6e 67 20 74 68 61 74 20 66 69 6c 65 20 73 6f 6d ng that file som
2160: 65 77 68 65 72 65 20 6f 6e 20 79 6f 75 72 20 50 ewhere on your P
2170: 41 54 48 2e 0a 0a 46 6f 73 73 69 6c 20 69 73 20 ATH...Fossil is
2180: 63 6f 6d 70 6c 65 74 65 6c 79 20 73 65 6c 66 2d completely self-
2190: 63 6f 6e 74 61 69 6e 65 64 2e 20 20 49 74 20 69 contained. It i
21a0: 73 20 6e 6f 74 20 6e 65 63 65 73 73 61 72 79 20 s not necessary
21b0: 74 6f 0a 69 6e 73 74 61 6c 6c 20 61 6e 79 20 6f to.install any o
21c0: 74 68 65 72 20 73 6f 66 74 77 61 72 65 20 69 6e ther software in
21d0: 20 6f 72 64 65 72 20 74 6f 20 75 73 65 20 66 6f order to use fo
21e0: 73 73 69 6c 2e 20 20 59 6f 75 20 64 6f 20 3c 75 ssil. You do <u
21f0: 3e 6e 6f 74 3c 2f 75 3e 20 6e 65 65 64 0a 43 56 >not</u> need.CV
2200: 53 2c 20 67 7a 69 70 2c 20 64 69 66 66 2c 20 72 S, gzip, diff, r
2210: 73 79 6e 63 2c 20 50 79 74 68 6f 6e 2c 20 50 65 sync, Python, Pe
2220: 72 6c 2c 20 54 63 6c 2c 20 4a 61 76 61 2c 20 61 rl, Tcl, Java, a
2230: 70 61 63 68 65 2c 20 50 6f 73 74 67 72 65 53 51 pache, PostgreSQ
2240: 4c 2c 20 4d 79 53 51 4c 2c 0a 53 51 4c 69 74 65 L, MySQL,.SQLite
2250: 2c 20 70 61 74 63 68 2c 20 6f 72 20 61 6e 79 20 , patch, or any
2260: 73 69 6d 69 6c 61 72 20 73 6f 66 74 77 61 72 65 similar software
2270: 20 6f 6e 20 79 6f 75 72 20 73 79 73 74 65 6d 20 on your system
2280: 69 6e 20 6f 72 64 65 72 20 74 6f 20 75 73 65 0a in order to use.
2290: 66 6f 73 73 69 6c 20 65 66 66 65 63 74 69 76 65 fossil effective
22a0: 6c 79 2e 20 20 59 6f 75 20 77 69 6c 6c 20 77 61 ly. You will wa
22b0: 6e 74 20 74 6f 20 68 61 76 65 20 73 6f 6d 65 20 nt to have some
22c0: 6b 69 6e 64 20 6f 66 20 74 65 78 74 20 65 64 69 kind of text edi
22d0: 74 6f 72 0a 66 6f 72 20 65 6e 74 65 72 69 6e 67 tor.for entering
22e0: 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d 6d 65 6e check-in commen
22f0: 74 73 2e 20 20 46 6f 73 73 69 6c 20 77 69 6c 6c ts. Fossil will
2300: 20 75 73 65 20 77 68 61 74 65 76 65 72 20 74 65 use whatever te
2310: 78 74 20 65 64 69 74 6f 72 0a 69 73 20 69 64 65 xt editor.is ide
2320: 6e 74 69 66 69 65 64 20 62 79 20 79 6f 75 72 20 ntified by your
2330: 56 49 53 55 41 4c 20 65 6e 76 69 72 6f 6e 6d 65 VISUAL environme
2340: 6e 74 20 76 61 72 69 61 62 6c 65 2e 20 20 46 6f nt variable. Fo
2350: 73 73 69 6c 20 77 69 6c 6c 20 61 6c 73 6f 0a 75 ssil will also.u
2360: 73 65 20 47 50 47 20 74 6f 20 63 6c 65 61 72 73 se GPG to clears
2370: 69 67 6e 20 79 6f 75 72 20 6d 61 6e 69 66 65 73 ign your manifes
2380: 74 73 20 69 66 20 79 6f 75 20 68 61 70 70 65 6e ts if you happen
2390: 20 74 6f 20 68 61 76 65 20 69 74 20 69 6e 73 74 to have it inst
23a0: 61 6c 6c 65 64 2c 0a 62 75 74 20 66 6f 73 73 69 alled,.but fossi
23b0: 6c 20 77 69 6c 6c 20 73 6b 69 70 20 74 68 61 74 l will skip that
23c0: 20 73 74 65 70 20 69 66 20 47 50 47 20 6d 69 73 step if GPG mis
23d0: 73 69 6e 67 20 66 72 6f 6d 20 79 6f 75 72 20 73 sing from your s
23e0: 79 73 74 65 6d 2e 0a 59 6f 75 20 63 61 6e 20 6f ystem..You can o
23f0: 70 74 69 6f 6e 61 6c 6c 79 20 73 65 74 20 75 70 ptionally set up
2400: 20 66 6f 73 73 69 6c 20 74 6f 20 75 73 65 20 65 fossil to use e
2410: 78 74 65 72 6e 61 6c 20 22 64 69 66 66 22 20 70 xternal "diff" p
2420: 72 6f 67 72 61 6d 73 2c 20 0a 74 68 6f 75 67 68 rograms, .though
2430: 20 66 6f 73 73 69 6c 20 68 61 73 20 61 6e 20 65 fossil has an e
2440: 78 63 65 6c 6c 65 6e 74 20 62 75 69 6c 74 2d 69 xcellent built-i
2450: 6e 20 22 64 69 66 66 22 20 61 6c 67 6f 72 69 74 n "diff" algorit
2460: 68 6d 20 74 68 61 74 20 77 6f 72 6b 73 0a 66 69 hm that works.fi
2470: 6e 65 20 66 6f 72 20 6d 6f 73 74 20 70 65 6f 70 ne for most peop
2480: 6c 65 2e 0a 0a 54 6f 20 75 6e 69 6e 73 74 61 6c le...To uninstal
2490: 6c 20 66 6f 73 73 69 6c 2c 20 73 69 6d 70 6c 79 l fossil, simply
24a0: 20 64 65 6c 65 74 65 20 74 68 65 20 65 78 65 63 delete the exec
24b0: 75 74 61 62 6c 65 2e 0a 0a 54 6f 20 75 70 67 72 utable...To upgr
24c0: 61 64 65 20 61 6e 20 6f 6c 64 65 72 20 76 65 72 ade an older ver
24d0: 73 69 6f 6e 20 6f 66 20 66 6f 73 73 69 6c 20 74 sion of fossil t
24e0: 6f 20 61 20 6e 65 77 65 72 20 76 65 72 73 69 6f o a newer versio
24f0: 6e 2c 20 6a 75 73 74 0a 72 65 70 6c 61 63 65 20 n, just.replace
2500: 74 68 65 20 6f 6c 64 20 65 78 65 63 75 74 61 62 the old executab
2510: 6c 65 20 77 69 74 68 20 74 68 65 20 6e 65 77 20 le with the new
2520: 6f 6e 65 2e 20 20 59 6f 75 20 6d 69 67 68 74 20 one. You might
2530: 6e 65 65 64 20 74 6f 20 0a 72 75 6e 20 22 3c 62 need to .run "<b
2540: 3e 66 6f 73 73 69 6c 20 61 6c 6c 20 72 65 62 75 >fossil all rebu
2550: 69 6c 64 3c 2f 62 3e 22 20 74 6f 20 72 65 73 74 ild</b>" to rest
2560: 72 75 63 74 75 72 65 20 79 6f 75 72 20 72 65 70 ructure your rep
2570: 6f 73 69 74 6f 72 69 65 73 20 61 66 74 65 72 0a ositories after.
2580: 61 6e 20 75 70 67 72 61 64 65 2e 20 20 52 75 6e an upgrade. Run
2590: 6e 69 6e 67 20 22 61 6c 6c 20 72 65 62 75 69 6c ning "all rebuil
25a0: 64 22 20 6e 65 76 65 72 20 68 75 72 74 73 2c 20 d" never hurts,
25b0: 73 6f 20 77 68 65 6e 20 75 70 67 72 61 64 69 6e so when upgradin
25c0: 67 20 69 74 0a 69 73 20 61 20 67 6f 6f 64 20 70 g it.is a good p
25d0: 6f 6c 69 63 79 20 74 6f 20 72 75 6e 20 69 74 20 olicy to run it
25e0: 65 76 65 6e 20 69 66 20 69 74 20 69 73 20 6e 6f even if it is no
25f0: 74 20 73 74 72 69 63 74 6c 79 20 6e 65 63 65 73 t strictly neces
2600: 73 61 72 79 2e 0a 0a 54 6f 20 75 73 65 20 66 6f sary...To use fo
2610: 73 73 69 6c 2c 20 73 69 6d 70 6c 79 20 74 79 70 ssil, simply typ
2620: 65 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 e the name of th
2630: 65 20 65 78 65 63 75 74 61 62 6c 65 20 69 6e 20 e executable in
2640: 79 6f 75 72 0a 73 68 65 6c 6c 2c 20 66 6f 6c 6c your.shell, foll
2650: 6f 77 65 64 20 62 79 20 6f 6e 65 20 6f 66 20 74 owed by one of t
2660: 68 65 20 76 61 72 69 6f 75 73 20 62 75 69 6c 74 he various built
2670: 2d 69 6e 20 63 6f 6d 6d 61 6e 64 73 20 61 6e 64 -in commands and
2680: 0a 61 72 67 75 6d 65 6e 74 73 20 61 70 70 72 6f .arguments appro
2690: 70 72 69 61 74 65 20 66 6f 72 20 74 68 61 74 20 priate for that
26a0: 63 6f 6d 6d 61 6e 64 2e 20 20 46 6f 72 20 65 78 command. For ex
26b0: 61 6d 70 6c 65 3a 0a 0a 3c 62 6c 6f 63 6b 71 75 ample:..<blockqu
26c0: 6f 74 65 3e 3c 62 3e 0a 66 6f 73 73 69 6c 20 68 ote><b>.fossil h
26d0: 65 6c 70 0a 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 elp.</b></blockq
26e0: 75 6f 74 65 3e 0a 0a 49 6e 20 74 68 65 20 6e 65 uote>..In the ne
26f0: 78 74 20 73 65 63 74 69 6f 6e 2c 20 77 68 65 6e xt section, when
2700: 20 77 65 20 73 61 79 20 74 68 69 6e 67 73 20 6c we say things l
2710: 69 6b 65 20 22 75 73 65 20 74 68 65 20 3c 62 3e ike "use the <b>
2720: 68 65 6c 70 3c 2f 62 3e 0a 63 6f 6d 6d 61 6e 64 help</b>.command
2730: 22 20 77 65 20 6d 65 61 6e 20 74 6f 20 75 73 65 " we mean to use
2740: 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 6e 61 6d the command nam
2750: 65 20 22 68 65 6c 70 22 20 61 73 20 74 68 65 20 e "help" as the
2760: 66 69 72 73 74 0a 74 6f 6b 65 6e 20 61 66 74 65 first.token afte
2770: 72 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 r the name of th
2780: 65 20 66 6f 73 73 69 6c 20 65 78 65 63 75 74 61 e fossil executa
2790: 62 6c 65 2c 20 61 73 20 73 68 6f 77 6e 20 61 62 ble, as shown ab
27a0: 6f 76 65 2e 0a 0a 3c 61 20 6e 61 6d 65 3d 22 77 ove...<a name="w
27b0: 6f 72 6b 66 6c 6f 77 22 3e 3c 2f 61 3e 0a 3c 68 orkflow"></a>.<h
27c0: 32 3e 34 2e 30 20 57 6f 72 6b 66 6c 6f 77 3c 2f 2>4.0 Workflow</
27d0: 68 32 3e 0a 0a 3c 69 6d 67 20 73 72 63 3d 22 63 h2>..<img src="c
27e0: 6f 6e 63 65 70 74 32 2e 67 69 66 22 20 61 6c 69 oncept2.gif" ali
27f0: 67 6e 3d 22 72 69 67 68 74 22 20 68 73 70 61 63 gn="right" hspac
2800: 65 3d 22 31 30 22 3e 0a 0a 46 6f 73 73 69 6c 20 e="10">..Fossil
2810: 68 61 73 20 74 77 6f 20 6d 6f 64 65 73 20 6f 66 has two modes of
2820: 20 6f 70 65 72 61 74 69 6f 6e 3a 20 3c 69 3e 22 operation: <i>"
2830: 61 75 74 6f 73 79 6e 63 22 3c 2f 69 3e 20 61 6e autosync"</i> an
2840: 64 0a 3c 69 3e 22 6d 61 6e 75 61 6c 2d 6d 65 72 d.<i>"manual-mer
2850: 67 65 22 3c 2f 69 3e 0a 41 75 74 6f 73 79 6e 63 ge"</i>.Autosync
2860: 20 6d 6f 64 65 20 69 73 20 72 65 6d 69 6e 69 73 mode is reminis
2870: 63 65 6e 74 20 6f 66 20 43 56 53 20 6f 72 20 53 cent of CVS or S
2880: 56 4e 20 69 6e 20 74 68 61 74 20 69 74 20 61 75 VN in that it au
2890: 74 6f 6d 61 74 69 63 61 6c 6c 79 0a 6b 65 65 70 tomatically.keep
28a0: 73 20 79 6f 75 72 20 63 68 61 6e 67 65 73 20 69 s your changes i
28b0: 6e 20 73 79 6e 63 68 72 6f 6e 69 7a 61 74 69 6f n synchronizatio
28c0: 6e 20 77 69 74 68 20 79 6f 75 72 20 63 6f 2d 77 n with your co-w
28d0: 6f 72 6b 65 72 73 20 74 68 72 6f 75 67 68 0a 74 orkers through.t
28e0: 68 65 20 75 73 65 20 6f 66 20 61 20 63 65 6e 74 he use of a cent
28f0: 72 61 6c 20 73 65 72 76 65 72 2e 20 20 54 68 65 ral server. The
2900: 20 6d 61 6e 75 61 6c 2d 6d 65 72 67 65 20 6d 6f manual-merge mo
2910: 64 65 20 69 73 20 74 68 65 20 73 74 61 6e 64 61 de is the standa
2920: 72 64 20 77 6f 72 6b 66 6c 6f 77 0a 66 6f 72 20 rd workflow.for
2930: 47 49 54 20 6f 72 20 4d 65 72 63 75 72 69 61 6c GIT or Mercurial
2940: 20 69 6e 20 74 68 61 74 20 79 6f 75 72 20 6c 6f in that your lo
2950: 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 20 64 cal repository d
2960: 65 76 65 6c 6f 70 73 0a 69 6e 64 65 70 65 6e 64 evelops.independ
2970: 65 6e 74 6c 79 20 6f 66 20 79 6f 75 72 20 63 6f ently of your co
2980: 77 6f 72 6b 65 72 73 20 61 6e 64 20 79 6f 75 20 workers and you
2990: 73 68 61 72 65 20 61 6e 64 20 6d 65 72 67 65 20 share and merge
29a0: 79 6f 75 72 20 63 68 61 6e 67 65 73 20 6d 61 6e your changes man
29b0: 75 61 6c 6c 79 2e 0a 41 6e 20 69 6e 74 65 72 65 ually..An intere
29c0: 73 74 69 6e 67 20 66 65 61 74 75 72 65 20 6f 66 sting feature of
29d0: 20 66 6f 73 73 69 6c 20 69 73 20 74 68 61 74 20 fossil is that
29e0: 69 74 20 73 75 70 70 6f 72 74 73 20 62 6f 74 68 it supports both
29f0: 20 61 75 74 6f 73 79 6e 63 0a 61 6e 64 20 6d 61 autosync.and ma
2a00: 6e 75 61 6c 2d 6d 65 72 67 65 20 77 6f 72 6b 20 nual-merge work
2a10: 66 6c 6f 77 73 2e 0a 0a 54 68 65 20 64 65 66 61 flows...The defa
2a20: 75 6c 74 20 73 65 74 74 69 6e 67 20 66 6f 72 20 ult setting for
2a30: 66 6f 73 73 69 6c 20 69 73 20 74 6f 20 62 65 20 fossil is to be
2a40: 69 6e 20 61 75 74 6f 73 79 6e 63 20 6d 6f 64 65 in autosync mode
2a50: 2e 20 20 59 6f 75 0a 63 61 6e 20 63 68 61 6e 67 . You.can chang
2a60: 65 20 74 68 65 20 61 75 74 6f 73 79 6e 63 20 73 e the autosync s
2a70: 65 74 74 69 6e 67 20 6f 72 20 63 68 65 63 6b 20 etting or check
2a80: 74 68 65 20 63 75 72 72 65 6e 74 20 61 75 74 6f the current auto
2a90: 73 79 6e 63 0a 73 65 74 74 69 6e 67 20 75 73 69 sync.setting usi
2aa0: 6e 67 20 63 6f 6d 6d 61 6e 64 73 20 6c 69 6b 65 ng commands like
2ab0: 3a 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a :..<blockquote>.
2ac0: 3c 62 3e 66 6f 73 73 69 6c 20 73 65 74 74 69 6e <b>fossil settin
2ad0: 67 20 61 75 74 6f 73 79 6e 63 20 6f 6e 3c 62 72 g autosync on<br
2ae0: 3e 0a 66 6f 73 73 69 6c 20 73 65 74 74 69 6e 67 >.fossil setting
2af0: 20 61 75 74 6f 73 79 6e 63 20 6f 66 66 3c 62 72 autosync off<br
2b00: 3e 0a 3c 62 3e 66 6f 73 73 69 6c 20 73 65 74 74 >.<b>fossil sett
2b10: 69 6e 67 73 3c 2f 62 3e 0a 3c 2f 62 6c 6f 63 6b ings</b>.</block
2b20: 71 75 6f 74 65 3e 0a 0a 42 79 20 64 65 66 61 75 quote>..By defau
2b30: 6c 74 2c 20 66 6f 73 73 69 6c 20 72 75 6e 73 20 lt, fossil runs
2b40: 77 69 74 68 20 61 75 74 6f 73 79 6e 63 20 6d 6f with autosync mo
2b50: 64 65 20 74 75 72 6e 65 64 20 6f 6e 2e 20 20 54 de turned on. T
2b60: 68 65 0a 61 75 74 68 6f 72 73 20 66 69 6e 64 73 he.authors finds
2b70: 20 74 68 61 74 20 70 72 6f 6a 65 63 74 73 20 72 that projects r
2b80: 75 6e 20 6d 6f 72 65 20 73 6d 6f 6f 74 68 6c 79 un more smoothly
2b90: 20 69 6e 20 61 75 74 6f 73 79 6e 63 20 6d 6f 64 in autosync mod
2ba0: 65 20 73 69 6e 63 65 0a 61 75 74 6f 73 79 6e 63 e since.autosync
2bb0: 20 68 65 6c 70 73 20 74 6f 20 70 72 65 76 65 6e helps to preven
2bc0: 74 20 70 6f 69 6e 74 6c 65 73 73 20 66 6f 72 6b t pointless fork
2bd0: 69 6e 67 20 61 6e 64 20 6d 65 72 67 65 20 61 6e ing and merge an
2be0: 64 20 68 65 6c 70 73 20 6b 65 65 70 73 0a 61 6c d helps keeps.al
2bf0: 6c 20 63 6f 6c 6c 61 62 6f 72 61 74 6f 72 73 20 l collaborators
2c00: 77 6f 72 6b 69 6e 67 20 6f 6e 20 65 78 61 63 74 working on exact
2c10: 6c 79 20 74 68 65 20 73 61 6d 65 20 63 6f 64 65 ly the same code
2c20: 20 72 61 74 68 65 72 20 74 68 61 6e 20 6f 6e 20 rather than on
2c30: 74 68 65 69 72 0a 6f 77 6e 20 70 65 72 73 6f 6e their.own person
2c40: 61 6c 20 66 6f 72 6b 73 20 6f 66 20 74 68 65 20 al forks of the
2c50: 63 6f 64 65 2e 20 20 49 6e 20 74 68 65 20 61 75 code. In the au
2c60: 74 68 6f 72 27 73 20 76 69 65 77 2c 20 6d 61 6e thor's view, man
2c70: 75 61 6c 2d 6d 65 72 67 65 20 6d 6f 64 65 0a 73 ual-merge mode.s
2c80: 68 6f 75 6c 64 20 62 65 20 72 65 73 65 72 76 65 hould be reserve
2c90: 64 20 66 6f 72 20 64 69 73 63 6f 6e 6e 65 63 74 d for disconnect
2ca0: 65 64 20 6f 70 65 72 61 74 69 6f 6e 2e 0a 0a 3c ed operation...<
2cb0: 68 33 3e 34 2e 31 20 41 75 74 6f 73 79 6e 63 20 h3>4.1 Autosync
2cc0: 57 6f 72 6b 66 6c 6f 77 3c 2f 68 33 3e 0a 0a 3c Workflow</h3>..<
2cd0: 6f 6c 3e 0a 3c 6c 69 3e 0a 45 73 74 61 62 6c 69 ol>.<li>.Establi
2ce0: 73 68 20 61 20 6c 6f 63 61 6c 20 72 65 70 6f 73 sh a local repos
2cf0: 69 74 6f 72 79 20 75 73 69 6e 67 20 65 69 74 68 itory using eith
2d00: 65 72 20 74 68 65 20 3c 62 3e 6e 65 77 3c 2f 62 er the <b>new</b
2d10: 3e 20 63 6f 6d 6d 61 6e 64 0a 74 6f 20 73 74 61 > command.to sta
2d20: 72 74 20 61 20 6e 65 77 20 70 72 6f 6a 65 63 74 rt a new project
2d30: 2c 20 6f 72 20 74 68 65 20 3c 62 3e 63 6c 6f 6e , or the <b>clon
2d40: 65 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 74 6f e</b> command to
2d50: 20 6d 61 6b 65 20 61 20 63 6c 6f 6e 65 0a 6f 66 make a clone.of
2d60: 20 61 20 72 65 70 6f 73 69 74 6f 72 79 20 66 6f a repository fo
2d70: 72 20 61 6e 20 65 78 69 73 74 69 6e 67 20 70 72 r an existing pr
2d80: 6f 6a 65 63 74 2e 20 0a 3c 2f 6c 69 3e 0a 0a 3c oject. .</li>..<
2d90: 6c 69 3e 0a 45 73 74 61 62 6c 69 73 68 20 6f 6e li>.Establish on
2da0: 65 20 6f 72 20 6d 6f 72 65 20 73 6f 75 72 63 65 e or more source
2db0: 20 74 72 65 65 73 20 62 79 20 63 68 61 6e 67 69 trees by changi
2dc0: 6e 67 20 79 6f 75 72 20 77 6f 72 6b 69 6e 67 20 ng your working
2dd0: 64 69 72 65 63 74 6f 72 79 0a 74 6f 20 77 68 65 directory.to whe
2de0: 72 65 20 79 6f 75 20 77 61 6e 74 20 74 68 65 20 re you want the
2df0: 72 6f 6f 74 20 6f 66 20 74 68 65 20 73 6f 75 72 root of the sour
2e00: 63 65 20 74 72 65 65 20 74 6f 20 62 65 2c 20 74 ce tree to be, t
2e10: 68 65 6e 20 69 73 73 75 69 6e 67 0a 74 68 65 20 hen issuing.the
2e20: 3c 62 3e 6f 70 65 6e 3c 2f 62 3e 20 63 6f 6d 6d <b>open</b> comm
2e30: 61 6e 64 20 77 69 74 68 20 74 68 65 20 6e 61 6d and with the nam
2e40: 65 20 6f 66 20 74 68 65 20 72 65 70 6f 73 69 74 e of the reposit
2e50: 6f 72 79 20 66 69 6c 65 20 61 73 20 69 74 73 0a ory file as its.
2e60: 61 72 67 75 6d 65 6e 74 2e 0a 3c 2f 6c 69 3e 0a argument..</li>.
2e70: 0a 3c 6c 69 3e 0a 54 68 65 20 3c 62 3e 6f 70 65 .<li>.The <b>ope
2e80: 6e 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 69 6e n</b> command in
2e90: 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 73 74 the previous st
2ea0: 65 70 20 70 6f 70 75 6c 61 74 65 73 20 79 6f 75 ep populates you
2eb0: 72 20 6c 6f 63 61 6c 20 73 6f 75 72 63 65 0a 74 r local source.t
2ec0: 72 65 65 20 77 69 74 68 20 61 20 63 6f 70 79 20 ree with a copy
2ed0: 6f 66 20 74 68 65 20 6c 61 74 65 73 74 20 63 68 of the latest ch
2ee0: 65 63 6b 2d 69 6e 2e 20 20 55 73 75 61 6c 6c 79 eck-in. Usually
2ef0: 20 74 68 69 73 20 69 73 20 77 68 61 74 20 79 6f this is what yo
2f00: 75 20 77 61 6e 74 2e 0a 49 6e 20 74 68 65 20 72 u want..In the r
2f10: 61 72 65 20 63 61 73 65 73 20 77 68 65 72 65 20 are cases where
2f20: 69 74 20 69 73 20 6e 6f 74 2c 20 75 73 65 20 74 it is not, use t
2f30: 68 65 20 3c 62 3e 75 70 64 61 74 65 3c 2f 62 3e he <b>update</b>
2f40: 20 63 6f 6d 6d 61 6e 64 20 74 6f 0a 73 77 69 74 command to.swit
2f50: 63 68 20 74 6f 20 61 20 6e 65 77 20 63 68 65 63 ch to a new chec
2f60: 6b 2d 69 6e 2e 20 20 55 73 65 20 74 68 65 20 3c k-in. Use the <
2f70: 62 3e 74 69 6d 65 6c 69 6e 65 3c 2f 62 3e 20 6f b>timeline</b> o
2f80: 72 20 3c 62 3e 6c 65 61 76 65 73 3c 2f 62 3e 20 r <b>leaves</b>
2f90: 63 6f 6d 6d 61 6e 64 73 0a 74 6f 20 69 64 65 6e commands.to iden
2fa0: 74 69 66 79 20 61 6c 74 65 72 6e 61 74 69 76 65 tify alternative
2fb0: 20 63 68 65 63 6b 2d 69 6e 73 20 74 6f 20 73 77 check-ins to sw
2fc0: 69 74 63 68 20 74 6f 2e 0a 3c 2f 6c 69 3e 0a 0a itch to..</li>..
2fd0: 3c 6c 69 3e 0a 45 64 69 74 20 74 68 65 20 63 6f <li>.Edit the co
2fe0: 64 65 2e 20 20 41 64 64 20 6e 65 77 20 66 69 6c de. Add new fil
2ff0: 65 73 20 74 6f 20 74 68 65 20 73 6f 75 72 63 65 es to the source
3000: 20 74 72 65 65 20 75 73 69 6e 67 20 74 68 65 20 tree using the
3010: 3c 62 3e 61 64 64 3c 2f 62 3e 0a 63 6f 6d 6d 61 <b>add</b>.comma
3020: 6e 64 2e 20 20 4f 6d 69 74 20 66 69 6c 65 73 20 nd. Omit files
3030: 66 72 6f 6d 20 66 75 74 75 72 65 20 63 68 65 63 from future chec
3040: 6b 2d 69 6e 73 20 75 73 69 6e 67 20 74 68 65 20 k-ins using the
3050: 3c 62 3e 72 6d 3c 2f 62 3e 20 63 6f 6d 6d 61 6e <b>rm</b> comman
3060: 64 2e 0a 28 45 76 65 6e 20 77 68 65 6e 20 79 6f d..(Even when yo
3070: 75 20 72 65 6d 6f 76 65 20 66 69 6c 65 73 20 66 u remove files f
3080: 72 6f 6d 20 66 75 74 75 72 65 20 63 68 65 63 6b rom future check
3090: 2d 69 6e 73 2c 20 74 68 6f 73 65 20 66 69 6c 65 -ins, those file
30a0: 73 20 63 6f 6e 74 69 6e 75 65 0a 74 6f 20 65 78 s continue.to ex
30b0: 69 73 74 20 69 6e 20 68 69 73 74 6f 72 69 63 61 ist in historica
30c0: 6c 20 63 68 65 63 6b 2d 69 6e 73 2e 29 20 20 54 l check-ins.) T
30d0: 65 73 74 20 79 6f 75 72 20 63 68 61 6e 67 65 73 est your changes
30e0: 2e 0a 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 0a 43 72 ..</li>..<li>.Cr
30f0: 65 61 74 65 20 61 20 6e 65 77 20 63 68 65 63 6b eate a new check
3100: 2d 69 6e 20 75 73 69 6e 67 20 74 68 65 20 3c 62 -in using the <b
3110: 3e 63 6f 6d 6d 69 74 3c 2f 62 3e 20 63 6f 6d 6d >commit</b> comm
3120: 61 6e 64 2e 20 20 59 6f 75 20 77 69 6c 6c 20 62 and. You will b
3130: 65 20 70 72 6f 6d 70 74 65 64 0a 66 6f 72 20 61 e prompted.for a
3140: 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d 6d 65 6e check-in commen
3150: 74 20 61 6e 64 20 61 6c 73 6f 20 66 6f 72 20 79 t and also for y
3160: 6f 75 72 20 47 50 47 20 6b 65 79 20 69 66 20 79 our GPG key if y
3170: 6f 75 20 68 61 76 65 20 47 50 47 20 69 6e 73 74 ou have GPG inst
3180: 61 6c 6c 65 64 2e 0a 54 68 65 20 63 6f 6d 6d 69 alled..The commi
3190: 74 20 63 6f 70 69 65 73 20 74 68 65 20 65 64 69 t copies the edi
31a0: 74 73 20 79 6f 75 20 68 61 76 65 20 6d 61 64 65 ts you have made
31b0: 20 69 6e 20 79 6f 75 72 20 6c 6f 63 61 6c 20 73 in your local s
31c0: 6f 75 72 63 65 0a 74 72 65 65 20 69 6e 74 6f 20 ource.tree into
31d0: 79 6f 75 72 20 6c 6f 63 61 6c 20 72 65 70 6f 73 your local repos
31e0: 69 74 6f 72 79 2e 20 20 41 66 74 65 72 20 79 6f itory. After yo
31f0: 75 72 20 63 6f 6d 6d 69 74 20 63 6f 6d 70 6c 65 ur commit comple
3200: 74 65 73 2c 20 66 6f 73 73 69 6c 20 77 69 6c 6c tes, fossil will
3210: 0a 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 3c .automatically <
3220: 62 3e 70 75 73 68 3c 2f 62 3e 20 79 6f 75 72 20 b>push</b> your
3230: 63 68 61 6e 67 65 73 20 62 61 63 6b 20 74 6f 20 changes back to
3240: 74 68 65 20 73 65 72 76 65 72 0a 79 6f 75 20 63 the server.you c
3250: 6c 6f 6e 65 64 20 66 72 6f 6d 20 6f 72 20 77 68 loned from or wh
3260: 61 74 65 76 65 72 20 73 65 72 76 65 72 20 79 6f atever server yo
3270: 75 20 6d 6f 73 74 20 72 65 63 65 6e 74 6c 79 20 u most recently
3280: 73 79 6e 63 65 64 20 77 69 74 68 2e 0a 3c 2f 6c synced with..</l
3290: 69 3e 0a 0a 3c 6c 69 3e 0a 57 68 65 6e 20 79 6f i>..<li>.When yo
32a0: 75 72 20 63 6f 77 6f 72 6b 65 72 73 20 6d 61 6b ur coworkers mak
32b0: 65 20 74 68 65 69 72 20 6f 77 6e 20 63 68 61 6e e their own chan
32c0: 67 65 73 2c 20 79 6f 75 20 63 61 6e 20 6d 65 72 ges, you can mer
32d0: 67 65 20 74 68 6f 73 65 20 63 68 61 6e 67 65 73 ge those changes
32e0: 0a 69 6e 74 6f 20 79 6f 75 72 20 6c 6f 63 61 6c .into your local
32f0: 20 6c 6f 63 61 6c 20 73 6f 75 72 63 65 20 74 72 local source tr
3300: 65 65 20 75 73 69 6e 67 20 74 68 65 20 3c 62 3e ee using the <b>
3310: 75 70 64 61 74 65 3c 2f 62 3e 20 63 6f 6d 6d 61 update</b> comma
3320: 6e 64 2e 20 20 0a 49 6e 20 61 75 74 6f 73 79 6e nd. .In autosyn
3330: 63 20 6d 6f 64 65 2c 20 3c 62 3e 75 70 64 61 74 c mode, <b>updat
3340: 65 3c 2f 62 3e 20 77 69 6c 6c 20 66 69 72 73 74 e</b> will first
3350: 20 67 6f 20 62 61 63 6b 20 74 6f 20 74 68 65 20 go back to the
3360: 73 65 72 76 65 72 20 79 6f 75 0a 63 6c 6f 6e 65 server you.clone
3370: 64 20 66 72 6f 6d 20 6f 72 20 77 69 74 68 20 77 d from or with w
3380: 68 69 63 68 20 79 6f 75 20 6d 6f 73 74 20 72 65 hich you most re
3390: 63 65 6e 74 6c 79 20 73 79 6e 63 65 64 2c 20 61 cently synced, a
33a0: 6e 64 20 70 75 6c 6c 20 64 6f 77 6e 20 61 6c 6c nd pull down all
33b0: 0a 72 65 63 65 6e 74 20 63 68 61 6e 67 65 73 20 .recent changes
33c0: 69 6e 74 6f 20 79 6f 75 72 20 6c 6f 63 61 6c 20 into your local
33d0: 72 65 70 6f 73 69 74 6f 72 79 2e 20 20 54 68 65 repository. The
33e0: 6e 20 69 74 20 77 69 6c 6c 20 6d 65 72 67 65 20 n it will merge
33f0: 72 65 63 65 6e 74 0a 63 68 61 6e 67 65 73 20 69 recent.changes i
3400: 6e 74 6f 20 79 6f 75 72 20 6c 6f 63 61 6c 20 73 nto your local s
3410: 6f 75 72 63 65 20 74 72 65 65 2e 20 20 49 66 20 ource tree. If
3420: 79 6f 75 20 64 6f 20 61 6e 20 3c 62 3e 75 70 64 you do an <b>upd
3430: 61 74 65 3c 2f 62 3e 20 61 6e 64 0a 66 69 6e 64 ate</b> and.find
3440: 20 74 68 61 74 20 69 74 20 6d 65 73 73 65 73 20 that it messes
3450: 73 6f 6d 65 74 68 69 6e 67 20 75 70 20 69 6e 20 something up in
3460: 79 6f 75 72 20 73 6f 75 72 63 65 20 74 72 65 65 your source tree
3470: 20 28 70 65 72 68 61 70 73 20 61 20 63 6f 2d 77 (perhaps a co-w
3480: 6f 72 6b 65 72 0a 63 68 65 63 6b 65 64 20 69 6e orker.checked in
3490: 20 69 6e 63 6f 6d 70 61 74 69 62 6c 65 20 63 68 incompatible ch
34a0: 61 6e 67 65 73 29 20 79 6f 75 20 63 61 6e 20 75 anges) you can u
34b0: 73 65 20 74 68 65 20 3c 62 3e 75 6e 64 6f 3c 2f se the <b>undo</
34c0: 62 3e 20 63 6f 6d 6d 61 6e 64 20 0a 74 6f 20 62 b> command .to b
34d0: 61 63 6b 20 6f 75 74 20 74 68 65 20 63 68 61 6e ack out the chan
34e0: 67 65 73 2e 0a 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e ges..</li>..<li>
34f0: 0a 52 65 70 65 61 74 20 61 6c 6c 20 6f 66 20 74 .Repeat all of t
3500: 68 65 20 61 62 6f 76 65 20 75 6e 74 69 6c 20 79 he above until y
3510: 6f 75 20 68 61 76 65 20 67 65 6e 65 72 61 74 65 ou have generate
3520: 64 20 67 72 65 61 74 20 73 6f 66 74 77 61 72 65 d great software
3530: 2e 0a 3c 2f 6c 69 3e 0a 3c 2f 6f 6c 3e 0a 0a 3c ..</li>.</ol>..<
3540: 68 33 3e 34 2e 32 20 4d 61 6e 75 61 6c 2d 4d 65 h3>4.2 Manual-Me
3550: 72 67 65 20 57 6f 72 6b 66 6c 6f 77 3c 2f 68 33 rge Workflow</h3
3560: 3e 0a 0a 57 68 65 6e 20 61 75 74 6f 73 79 6e 63 >..When autosync
3570: 20 69 73 20 64 69 73 61 62 6c 65 64 2c 20 74 68 is disabled, th
3580: 65 20 3c 62 3e 63 6f 6d 6d 69 74 3c 2f 62 3e 20 e <b>commit</b>
3590: 63 6f 6d 6d 61 6e 64 20 69 73 20 64 65 63 6f 75 command is decou
35a0: 70 6c 65 64 20 66 72 6f 6d 0a 3c 62 3e 70 75 73 pled from.<b>pus
35b0: 68 3c 2f 62 3e 20 61 6e 64 20 74 68 65 20 3c 62 h</b> and the <b
35c0: 3e 75 70 64 61 74 65 3c 2f 62 3e 20 63 6f 6d 6d >update</b> comm
35d0: 61 6e 64 20 69 73 20 64 65 63 6f 75 70 6c 65 64 and is decoupled
35e0: 20 66 72 6f 6d 20 3c 62 3e 70 75 6c 6c 3c 2f 62 from <b>pull</b
35f0: 3e 2e 0a 54 68 61 74 20 6d 65 61 6e 73 20 79 6f >..That means yo
3600: 75 20 68 61 76 65 20 74 6f 20 64 6f 20 61 20 66 u have to do a f
3610: 65 77 20 65 78 74 72 61 20 73 74 65 70 73 20 69 ew extra steps i
3620: 6e 20 6f 72 64 65 72 20 74 6f 20 61 63 63 6f 6d n order to accom
3630: 70 6c 69 73 68 20 74 68 65 0a 3c 62 3e 70 75 73 plish the.<b>pus
3640: 68 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 70 75 6c h</b> and <b>pul
3650: 6c 3c 2f 62 3e 20 74 61 73 6b 73 20 6d 61 6e 75 l</b> tasks manu
3660: 61 6c 6c 79 2e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 3e ally...<ol>.<li>
3670: 0a 45 73 74 61 62 6c 69 73 68 20 61 20 6c 6f 63 .Establish a loc
3680: 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 20 75 73 al repository us
3690: 69 6e 67 20 65 69 74 68 65 72 20 74 68 65 20 3c ing either the <
36a0: 62 3e 6e 65 77 3c 2f 62 3e 20 63 6f 6d 6d 61 6e b>new</b> comman
36b0: 64 0a 74 6f 20 73 74 61 72 74 20 61 20 6e 65 77 d.to start a new
36c0: 20 70 72 6f 6a 65 63 74 2c 20 6f 72 20 74 68 65 project, or the
36d0: 20 3c 62 3e 63 6c 6f 6e 65 3c 2f 62 3e 20 63 6f <b>clone</b> co
36e0: 6d 6d 61 6e 64 20 74 6f 20 6d 61 6b 65 20 61 20 mmand to make a
36f0: 63 6c 6f 6e 65 0a 6f 66 20 61 20 72 65 70 6f 73 clone.of a repos
3700: 69 74 6f 72 79 20 66 6f 72 20 61 6e 20 65 78 69 itory for an exi
3710: 73 74 69 6e 67 20 70 72 6f 6a 65 63 74 2e 20 20 sting project.
3720: 20 54 68 65 20 64 65 66 61 75 6c 74 20 73 65 74 The default set
3730: 74 69 6e 67 20 66 6f 72 0a 61 20 6e 65 77 20 72 ting for.a new r
3740: 65 70 6f 73 69 74 6f 72 79 20 69 73 20 77 69 74 epository is wit
3750: 68 20 61 75 74 6f 73 79 6e 63 20 6f 6e 2c 20 73 h autosync on, s
3760: 6f 20 79 6f 75 20 77 69 6c 6c 20 6e 65 65 64 20 o you will need
3770: 74 6f 20 74 75 72 6e 20 69 74 20 6f 66 66 0a 75 to turn it off.u
3780: 73 69 6e 67 20 74 68 65 20 3c 62 3e 73 65 74 74 sing the <b>sett
3790: 69 6e 67 20 61 75 74 6f 73 79 6e 63 20 6f 66 66 ing autosync off
37a0: 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 77 69 74 </b> command wit
37b0: 68 20 61 20 3c 62 3e 2d 52 3c 2f 62 3e 20 6f 70 h a <b>-R</b> op
37c0: 74 69 6f 6e 0a 74 6f 20 73 70 65 63 69 66 79 20 tion.to specify
37d0: 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 2e 0a the repository..
37e0: 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 0a 45 73 74 61 </li>..<li>.Esta
37f0: 62 6c 69 73 68 20 6f 6e 65 20 6f 72 20 6d 6f 72 blish one or mor
3800: 65 20 73 6f 75 72 63 65 20 74 72 65 65 73 20 62 e source trees b
3810: 79 20 63 68 61 6e 67 69 6e 67 20 79 6f 75 72 20 y changing your
3820: 77 6f 72 6b 69 6e 67 20 64 69 72 65 63 74 6f 72 working director
3830: 79 0a 74 6f 20 77 68 65 72 65 20 79 6f 75 20 77 y.to where you w
3840: 61 6e 74 20 74 68 65 20 72 6f 6f 74 20 6f 66 20 ant the root of
3850: 74 68 65 20 73 6f 75 72 63 65 20 74 72 65 65 20 the source tree
3860: 74 6f 20 62 65 2c 20 74 68 65 6e 20 69 73 73 75 to be, then issu
3870: 69 6e 67 0a 74 68 65 20 3c 62 3e 6f 70 65 6e 3c ing.the <b>open<
3880: 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 /b> command with
3890: 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 the name of the
38a0: 20 72 65 70 6f 73 69 74 6f 72 79 20 66 69 6c 65 repository file
38b0: 20 61 73 20 69 74 73 0a 61 72 67 75 6d 65 6e 74 as its.argument
38c0: 2e 0a 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 0a 54 68 ..</li>..<li>.Th
38d0: 65 20 3c 62 3e 6f 70 65 6e 3c 2f 62 3e 20 63 6f e <b>open</b> co
38e0: 6d 6d 61 6e 64 20 69 6e 20 74 68 65 20 70 72 65 mmand in the pre
38f0: 76 69 6f 75 73 20 73 74 65 70 20 70 6f 70 75 6c vious step popul
3900: 61 74 65 73 20 79 6f 75 72 20 6c 6f 63 61 6c 20 ates your local
3910: 73 6f 75 72 63 65 0a 74 72 65 65 20 77 69 74 68 source.tree with
3920: 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 6c a copy of the l
3930: 61 74 65 73 74 20 63 68 65 63 6b 2d 69 6e 2e 20 atest check-in.
3940: 20 55 73 75 61 6c 6c 79 20 74 68 69 73 20 69 73 Usually this is
3950: 20 77 68 61 74 20 79 6f 75 20 77 61 6e 74 2e 0a what you want..
3960: 49 6e 20 74 68 65 20 72 61 72 65 20 63 61 73 65 In the rare case
3970: 73 20 77 68 65 72 65 20 69 74 20 69 73 20 6e 6f s where it is no
3980: 74 2c 20 75 73 65 20 74 68 65 20 3c 62 3e 75 70 t, use the <b>up
3990: 64 61 74 65 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 date</b> command
39a0: 20 74 6f 0a 73 77 69 74 63 68 20 74 6f 20 61 20 to.switch to a
39b0: 6e 65 77 20 63 68 65 63 6b 2d 69 6e 2e 20 20 55 new check-in. U
39c0: 73 65 20 74 68 65 20 3c 62 3e 74 69 6d 65 6c 69 se the <b>timeli
39d0: 6e 65 3c 2f 62 3e 20 6f 72 20 3c 62 3e 6c 65 61 ne</b> or <b>lea
39e0: 76 65 73 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 73 ves</b> commands
39f0: 0a 74 6f 20 69 64 65 6e 74 69 66 79 20 61 6c 74 .to identify alt
3a00: 65 72 6e 61 74 69 76 65 20 63 68 65 63 6b 2d 69 ernative check-i
3a10: 6e 73 20 74 6f 20 73 77 69 74 63 68 20 74 6f 2e ns to switch to.
3a20: 0a 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 0a 45 64 69 .</li>..<li>.Edi
3a30: 74 20 74 68 65 20 63 6f 64 65 2e 20 20 41 64 64 t the code. Add
3a40: 20 6e 65 77 20 66 69 6c 65 73 20 74 6f 20 74 68 new files to th
3a50: 65 20 73 6f 75 72 63 65 20 74 72 65 65 20 75 73 e source tree us
3a60: 69 6e 67 20 74 68 65 20 3c 62 3e 61 64 64 3c 2f ing the <b>add</
3a70: 62 3e 0a 63 6f 6d 6d 61 6e 64 2e 20 20 4f 6d 69 b>.command. Omi
3a80: 74 20 66 69 6c 65 73 20 66 72 6f 6d 20 66 75 74 t files from fut
3a90: 75 72 65 20 63 68 65 63 6b 2d 69 6e 73 20 75 73 ure check-ins us
3aa0: 69 6e 67 20 74 68 65 20 3c 62 3e 72 6d 3c 2f 62 ing the <b>rm</b
3ab0: 3e 20 63 6f 6d 6d 61 6e 64 2e 0a 28 45 76 65 6e > command..(Even
3ac0: 20 77 68 65 6e 20 79 6f 75 20 72 65 6d 6f 76 65 when you remove
3ad0: 20 66 69 6c 65 73 20 66 72 6f 6d 20 66 75 74 75 files from futu
3ae0: 72 65 20 63 68 65 63 6b 2d 69 6e 73 2c 20 74 68 re check-ins, th
3af0: 6f 73 65 20 66 69 6c 65 73 20 63 6f 6e 74 69 6e ose files contin
3b00: 75 65 0a 74 6f 20 65 78 69 73 74 20 69 6e 20 68 ue.to exist in h
3b10: 69 73 74 6f 72 69 63 61 6c 20 63 68 65 63 6b 2d istorical check-
3b20: 69 6e 73 2e 29 20 20 54 65 73 74 20 79 6f 75 72 ins.) Test your
3b30: 20 63 68 61 6e 67 65 73 2e 0a 3c 2f 6c 69 3e 0a changes..</li>.
3b40: 0a 3c 6c 69 3e 0a 43 72 65 61 74 65 20 61 20 6e .<li>.Create a n
3b50: 65 77 20 63 68 65 63 6b 2d 69 6e 20 75 73 69 6e ew check-in usin
3b60: 67 20 74 68 65 20 3c 62 3e 63 6f 6d 6d 69 74 3c g the <b>commit<
3b70: 2f 62 3e 20 63 6f 6d 6d 61 6e 64 2e 20 20 59 6f /b> command. Yo
3b80: 75 20 77 69 6c 6c 20 62 65 20 70 72 6f 6d 70 74 u will be prompt
3b90: 65 64 0a 66 6f 72 20 61 20 63 68 65 63 6b 2d 69 ed.for a check-i
3ba0: 6e 20 63 6f 6d 6d 65 6e 74 20 61 6e 64 20 61 6c n comment and al
3bb0: 73 6f 20 66 6f 72 20 79 6f 75 72 20 47 50 47 20 so for your GPG
3bc0: 6b 65 79 20 69 66 20 79 6f 75 20 68 61 76 65 20 key if you have
3bd0: 47 50 47 20 69 6e 73 74 61 6c 6c 65 64 2e 0a 54 GPG installed..T
3be0: 68 65 20 63 6f 6d 6d 69 74 20 63 6f 70 69 65 73 he commit copies
3bf0: 20 74 68 65 20 65 64 69 74 73 20 79 6f 75 20 68 the edits you h
3c00: 61 76 65 20 6d 61 64 65 20 69 6e 20 79 6f 75 72 ave made in your
3c10: 20 6c 6f 63 61 6c 20 73 6f 75 72 63 65 0a 74 72 local source.tr
3c20: 65 65 20 69 6e 74 6f 20 79 6f 75 72 20 6c 6f 63 ee into your loc
3c30: 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 2e 0a 3c al repository..<
3c40: 2f 6c 69 3e 0a 0a 3c 6c 69 3e 0a 55 73 65 20 74 /li>..<li>.Use t
3c50: 68 65 20 3c 62 3e 70 75 73 68 3c 2f 62 3e 20 63 he <b>push</b> c
3c60: 6f 6d 6d 61 6e 64 20 74 6f 20 70 75 73 68 20 79 ommand to push y
3c70: 6f 75 72 20 63 68 61 6e 67 65 73 20 6f 75 74 20 our changes out
3c80: 74 6f 20 61 20 73 65 72 76 65 72 0a 77 68 65 72 to a server.wher
3c90: 65 20 79 6f 75 72 20 63 6f 2d 77 6f 72 6b 65 72 e your co-worker
3ca0: 73 20 63 61 6e 20 61 63 63 65 73 73 20 74 68 65 s can access the
3cb0: 6d 2e 0a 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 0a 57 m..</li>..<li>.W
3cc0: 68 65 6e 20 63 6f 2d 77 6f 72 6b 65 72 73 20 6d hen co-workers m
3cd0: 61 6b 65 20 74 68 65 69 72 20 6f 77 6e 20 63 68 ake their own ch
3ce0: 61 6e 67 65 73 2c 20 75 73 65 20 74 68 65 20 3c anges, use the <
3cf0: 62 3e 70 75 6c 6c 3c 2f 62 3e 20 63 6f 6d 6d 61 b>pull</b> comma
3d00: 6e 64 0a 74 6f 20 70 75 6c 6c 20 74 68 6f 73 65 nd.to pull those
3d10: 20 63 68 61 6e 67 65 73 20 69 6e 74 6f 20 79 6f changes into yo
3d20: 75 72 20 6c 6f 63 61 6c 20 72 65 70 6f 73 69 74 ur local reposit
3d30: 6f 72 79 2e 20 20 4e 6f 74 65 20 74 68 61 74 20 ory. Note that
3d40: 3c 62 3e 70 75 6c 6c 3c 2f 62 3e 0a 64 6f 65 73 <b>pull</b>.does
3d50: 20 6e 6f 74 20 6d 6f 76 65 20 74 68 65 20 63 68 not move the ch
3d60: 61 6e 67 65 73 20 69 6e 74 6f 20 79 6f 75 72 20 anges into your
3d70: 6c 6f 63 61 6c 20 73 6f 75 72 63 65 20 74 72 65 local source tre
3d80: 65 2c 20 6f 6e 6c 79 20 69 6e 74 6f 20 79 6f 75 e, only into you
3d90: 72 0a 6c 6f 63 61 6c 20 72 65 70 6f 73 69 74 6f r.local reposito
3da0: 72 79 2e 0a 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 0a ry..</li>..<li>.
3db0: 4f 6e 63 65 20 63 68 61 6e 67 65 73 20 61 72 65 Once changes are
3dc0: 20 69 6e 20 79 6f 75 72 20 6c 6f 63 61 6c 20 72 in your local r
3dd0: 65 70 6f 73 69 74 6f 72 79 2c 20 75 73 65 0a 75 epository, use.u
3de0: 73 65 20 74 68 65 20 3c 62 3e 75 70 64 61 74 65 se the <b>update
3df0: 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 </b> command to
3e00: 6d 65 72 67 65 20 74 68 65 6d 20 74 6f 20 79 6f merge them to yo
3e10: 75 72 20 6c 6f 63 61 6c 20 73 6f 75 72 63 65 20 ur local source
3e20: 74 72 65 65 2e 0a 49 66 20 79 6f 75 20 6d 65 72 tree..If you mer
3e30: 67 65 20 69 6e 20 73 6f 6d 65 20 63 68 61 6e 67 ge in some chang
3e40: 65 73 20 61 6e 64 20 66 69 6e 64 20 74 68 61 74 es and find that
3e50: 20 74 68 65 20 63 68 61 6e 67 65 73 20 64 6f 20 the changes do
3e60: 6e 6f 74 20 77 6f 72 6b 20 6f 75 74 0a 6f 72 20 not work out.or
3e70: 61 72 65 20 6e 6f 74 20 74 6f 20 79 6f 75 72 20 are not to your
3e80: 6c 69 6b 69 6e 67 2c 20 79 6f 75 20 63 61 6e 20 liking, you can
3e90: 62 61 63 6b 20 6f 75 74 20 74 68 65 20 63 68 61 back out the cha
3ea0: 6e 67 65 73 20 75 73 69 6e 67 20 74 68 65 0a 3c nges using the.<
3eb0: 62 3e 75 6e 64 6f 3c 2f 62 3e 20 63 6f 6d 6d 61 b>undo</b> comma
3ec0: 6e 64 2e 0a 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 0a nd..</li>..<li>.
3ed0: 49 66 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 70 If two or more p
3ee0: 65 6f 70 6c 65 20 72 61 6e 20 22 63 6f 6d 6d 69 eople ran "commi
3ef0: 74 22 20 61 67 61 69 6e 73 74 20 74 68 65 20 73 t" against the s
3f00: 61 6d 65 20 62 61 73 65 6c 69 6e 65 2c 20 74 68 ame baseline, th
3f10: 69 73 20 77 69 6c 6c 0a 72 65 73 75 6c 74 20 69 is will.result i
3f20: 6e 20 61 20 5b 2e 2f 62 72 61 6e 63 68 69 6e 67 n a [./branching
3f30: 2e 77 69 6b 69 20 7c 20 66 6f 72 6b 5d 20 77 68 .wiki | fork] wh
3f40: 69 63 68 20 79 6f 75 20 6d 61 79 20 77 61 6e 74 ich you may want
3f50: 20 74 6f 20 72 65 73 6f 6c 76 65 20 62 79 0a 72 to resolve by.r
3f60: 75 6e 6e 69 6e 67 20 3c 62 3e 6d 65 72 67 65 3c unning <b>merge<
3f70: 2f 62 3e 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 /b> followed by
3f80: 61 6e 6f 74 68 65 72 20 3c 62 3e 63 6f 6d 6d 69 another <b>commi
3f90: 74 3c 2f 62 3e 2e 0a 3c 2f 6c 69 3e 0a 0a 3c 6c t</b>..</li>..<l
3fa0: 69 3e 0a 52 65 70 65 61 74 20 61 6c 6c 20 6f 66 i>.Repeat all of
3fb0: 20 74 68 65 20 61 62 6f 76 65 20 75 6e 74 69 6c the above until
3fc0: 20 79 6f 75 20 68 61 76 65 20 67 65 6e 65 72 61 you have genera
3fd0: 74 65 64 20 67 72 65 61 74 20 73 6f 66 74 77 61 ted great softwa
3fe0: 72 65 2e 0a 3c 2f 6c 69 3e 0a 3c 2f 6f 6c 3e 0a re..</li>.</ol>.
3ff0: 0a 3c 68 32 3e 35 2e 30 20 53 65 74 74 69 6e 67 .<h2>5.0 Setting
4000: 20 55 70 20 41 20 46 6f 73 73 69 6c 20 53 65 72 Up A Fossil Ser
4010: 76 65 72 3c 2f 68 32 3e 0a 0a 57 69 74 68 20 6f ver</h2>..With o
4020: 74 68 65 72 20 63 6f 6e 66 69 67 75 72 61 74 69 ther configurati
4030: 6f 6e 20 6d 61 6e 61 67 65 6d 65 6e 74 20 73 6f on management so
4040: 66 74 77 61 72 65 2c 20 73 65 74 74 69 6e 67 20 ftware, setting
4050: 75 70 20 61 20 73 65 72 76 65 72 20 69 73 0a 61 up a server is.a
4060: 20 6c 6f 74 20 6f 66 20 77 6f 72 6b 20 61 6e 64 lot of work and
4070: 20 6e 6f 72 6d 61 6c 6c 79 20 74 61 6b 65 73 20 normally takes
4080: 74 69 6d 65 2c 20 70 61 74 69 65 6e 63 65 2c 20 time, patience,
4090: 61 6e 64 20 61 20 6c 6f 74 20 6f 66 20 73 79 73 and a lot of sys
40a0: 74 65 6d 0a 6b 6e 6f 77 6c 65 64 67 65 2e 20 20 tem.knowledge.
40b0: 46 6f 73 73 69 6c 20 69 73 20 64 65 73 69 67 6e Fossil is design
40c0: 65 64 20 74 6f 20 61 76 6f 69 64 20 74 68 69 73 ed to avoid this
40d0: 20 66 72 75 73 74 72 61 74 69 6f 6e 2e 20 20 53 frustration. S
40e0: 65 74 74 69 6e 67 20 75 70 0a 61 20 73 65 72 76 etting up.a serv
40f0: 65 72 20 77 69 74 68 20 66 6f 73 73 69 6c 20 69 er with fossil i
4100: 73 20 72 69 64 69 63 75 6c 6f 75 73 6c 79 20 65 s ridiculously e
4110: 61 73 79 2e 20 20 59 6f 75 20 68 61 76 65 20 74 asy. You have t
4120: 68 72 65 65 20 6f 70 74 69 6f 6e 73 3a 3c 2f 70 hree options:</p
4130: 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 3e 3c 62 3e 3c >..<ol>.<li><b><
4140: 61 20 6e 61 6d 65 3d 22 73 61 73 65 72 76 22 3e a name="saserv">
4150: 3c 2f 61 3e 53 65 74 74 69 6e 67 20 75 70 20 61 </a>Setting up a
4160: 20 73 74 61 6e 64 2d 61 6c 6f 6e 65 20 73 65 72 stand-alone ser
4170: 76 65 72 3c 2f 62 3e 0a 0a 46 72 6f 6d 20 77 69 ver</b>..From wi
4180: 74 68 69 6e 20 79 6f 75 72 20 73 6f 75 72 63 65 thin your source
4190: 20 74 72 65 65 20 6a 75 73 74 20 75 73 65 20 74 tree just use t
41a0: 68 65 20 3c 62 3e 73 65 72 76 65 72 3c 2f 62 3e he <b>server</b>
41b0: 20 63 6f 6d 6d 61 6e 64 20 61 6e 64 0a 66 6f 73 command and.fos
41c0: 73 69 6c 20 77 69 6c 6c 20 73 74 61 72 74 20 6c sil will start l
41d0: 69 73 74 65 6e 69 6e 67 20 66 6f 72 20 69 6e 63 istening for inc
41e0: 6f 6d 69 6e 67 20 72 65 71 75 65 73 74 73 20 6f oming requests o
41f0: 6e 20 54 43 50 20 70 6f 72 74 20 38 30 38 30 2e n TCP port 8080.
4200: 0a 59 6f 75 20 63 61 6e 20 70 6f 69 6e 74 20 79 .You can point y
4210: 6f 75 72 20 77 65 62 20 62 72 6f 77 73 65 72 20 our web browser
4220: 61 74 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 at <a href="http
4230: 3a 2f 2f 6c 6f 63 61 6c 68 6f 73 74 3a 38 30 38 ://localhost:808
4240: 30 2f 22 3e 0a 68 74 74 70 3a 2f 2f 6c 6f 63 61 0/">.http://loca
4250: 6c 68 6f 73 74 3a 38 30 38 30 2f 3c 2f 61 3e 20 lhost:8080/</a>
4260: 61 6e 64 20 62 65 67 69 6e 20 65 78 70 6c 6f 72 and begin explor
4270: 69 6e 67 2e 20 20 4f 72 20 79 6f 75 72 20 63 6f ing. Or your co
4280: 77 6f 72 6b 65 72 73 0a 63 61 6e 20 64 6f 20 70 workers.can do p
4290: 75 73 68 65 73 20 6f 72 20 70 75 6c 6c 73 20 61 ushes or pulls a
42a0: 67 61 69 6e 73 74 20 79 6f 75 72 20 73 65 72 76 gainst your serv
42b0: 65 72 2e 20 20 55 73 65 20 74 68 65 20 3c 62 3e er. Use the <b>
42c0: 2d 2d 70 6f 72 74 3c 2f 62 3e 0a 6f 70 74 69 6f --port</b>.optio
42d0: 6e 20 74 6f 20 74 68 65 20 73 65 72 76 65 72 20 n to the server
42e0: 63 6f 6d 6d 61 6e 64 20 74 6f 20 73 70 65 63 69 command to speci
42f0: 66 79 20 61 20 64 69 66 66 65 72 65 6e 74 20 54 fy a different T
4300: 43 50 20 70 6f 72 74 2e 20 20 49 66 0a 79 6f 75 CP port. If.you
4310: 20 64 6f 20 6e 6f 74 20 68 61 76 65 20 61 20 6c do not have a l
4320: 6f 63 61 6c 20 73 6f 75 72 63 65 20 74 72 65 65 ocal source tree
4330: 2c 20 75 73 65 20 74 68 65 20 3c 62 3e 2d 52 3c , use the <b>-R<
4340: 2f 62 3e 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 /b> command-line
4350: 0a 6f 70 74 69 6f 6e 20 74 6f 20 73 70 65 63 69 .option to speci
4360: 66 79 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 fy the repositor
4370: 79 20 66 69 6c 65 2e 0a 0a 41 20 73 74 61 6e 64 y file...A stand
4380: 2d 61 6c 6f 6e 65 20 73 65 72 76 65 72 20 69 73 -alone server is
4390: 20 61 20 67 72 65 61 74 20 77 61 79 20 74 6f 20 a great way to
43a0: 73 65 74 20 6f 66 20 74 72 61 6e 73 69 65 6e 74 set of transient
43b0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 0a 62 65 74 connections.bet
43c0: 77 65 65 6e 20 63 6f 77 6f 72 6b 65 72 73 20 66 ween coworkers f
43d0: 6f 72 20 64 6f 69 6e 67 20 71 75 69 63 6b 20 70 or doing quick p
43e0: 75 73 68 65 73 20 6f 72 20 70 75 6c 6c 73 2e 20 ushes or pulls.
43f0: 20 42 75 74 20 79 6f 75 20 63 61 6e 20 61 6c 73 But you can als
4400: 6f 0a 73 65 74 20 75 70 20 61 20 70 65 72 6d 61 o.set up a perma
4410: 6e 65 6e 74 20 73 74 61 6e 64 2d 61 6c 6f 6e 65 nent stand-alone
4420: 20 73 65 72 76 65 72 20 69 66 20 79 6f 75 20 70 server if you p
4430: 72 65 66 65 72 2e 20 20 4a 75 73 74 20 6d 61 6b refer. Just mak
4440: 65 0a 61 72 72 61 6e 67 65 6d 65 6e 74 73 20 66 e.arrangements f
4450: 6f 72 20 66 6f 73 73 69 6c 20 74 6f 20 62 65 20 or fossil to be
4460: 6c 61 75 6e 63 68 65 64 20 77 69 74 68 20 61 70 launched with ap
4470: 70 72 6f 70 72 69 61 74 65 20 61 72 67 75 6d 65 propriate argume
4480: 6e 74 73 0a 61 66 74 65 72 20 65 76 65 72 79 20 nts.after every
4490: 72 65 62 6f 6f 74 2e 0a 0a 49 66 20 79 6f 75 20 reboot...If you
44a0: 6a 75 73 74 20 77 61 6e 74 20 61 20 73 65 72 76 just want a serv
44b0: 65 72 20 74 6f 20 62 72 6f 77 73 65 20 74 68 65 er to browse the
44c0: 20 62 75 69 6c 74 2d 69 6e 20 66 6f 73 73 69 6c built-in fossil
44d0: 20 77 65 62 73 69 74 65 0a 6c 6f 63 61 6c 6c 79 website.locally
44e0: 2c 20 75 73 65 20 74 68 65 20 3c 62 3e 75 69 3c , use the <b>ui<
44f0: 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 69 6e 20 70 /b> command in p
4500: 6c 61 63 65 20 6f 66 20 3c 62 3e 73 65 72 76 65 lace of <b>serve
4510: 72 3c 2f 62 3e 2e 20 20 54 68 65 0a 3c 62 3e 75 r</b>. The.<b>u
4520: 69 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 73 74 i</b> command st
4530: 61 72 74 73 20 75 70 20 61 20 6c 6f 63 61 6c 20 arts up a local
4540: 73 65 72 76 65 72 20 74 6f 6f 2c 20 62 75 74 20 server too, but
4550: 69 74 20 61 6c 73 6f 20 74 61 6b 65 73 0a 74 68 it also takes.th
4560: 65 20 61 64 64 69 74 69 6f 6e 61 6c 20 73 74 65 e additional ste
4570: 70 20 6f 66 20 61 75 74 6f 6d 61 74 69 63 61 6c p of automatical
4580: 6c 79 20 6c 61 75 6e 63 68 69 6e 67 20 79 6f 75 ly launching you
4590: 72 20 77 65 62 62 72 6f 77 73 65 72 20 61 6e 64 r webbrowser and
45a0: 0a 70 6f 69 6e 74 69 6e 67 20 61 74 20 74 68 65 .pointing at the
45b0: 20 6e 65 77 20 73 65 72 76 65 72 2e 0a 3c 2f 6c new server..</l
45c0: 69 3e 0a 0a 3c 6c 69 3e 3c 62 3e 53 65 74 74 69 i>..<li><b>Setti
45d0: 6e 67 20 75 70 20 61 20 43 47 49 20 73 65 72 76 ng up a CGI serv
45e0: 65 72 3c 2f 62 3e 0a 0a 49 66 20 79 6f 75 20 68 er</b>..If you h
45f0: 61 76 65 20 61 20 77 65 62 2d 73 65 72 76 65 72 ave a web-server
4600: 20 72 75 6e 6e 69 6e 67 20 6f 6e 20 79 6f 75 72 running on your
4610: 20 6d 61 63 68 69 6e 65 20 61 6c 72 65 61 64 79 machine already
4620: 2c 20 79 6f 75 20 63 61 6e 0a 73 65 74 20 75 70 , you can.set up
4630: 20 66 6f 73 73 69 6c 20 74 6f 20 62 65 20 72 75 fossil to be ru
4640: 6e 20 66 72 6f 6d 20 43 47 49 2e 20 20 53 69 6d n from CGI. Sim
4650: 70 6c 79 20 63 72 65 61 74 65 20 61 6e 20 65 78 ply create an ex
4660: 65 63 75 74 61 62 6c 65 20 73 63 72 69 70 74 0a ecutable script.
4670: 74 68 61 74 20 6c 6f 6f 6b 73 20 73 6f 6d 65 74 that looks somet
4680: 68 69 6e 67 20 6c 69 6b 65 20 74 68 69 73 3a 0a hing like this:.
4690: 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 .<blockquote><pr
46a0: 65 3e 0a 23 21 2f 75 73 72 2f 6c 6f 63 61 6c 2f e>.#!/usr/local/
46b0: 62 69 6e 2f 66 6f 73 73 69 6c 0a 72 65 70 6f 73 bin/fossil.repos
46c0: 69 74 6f 72 79 3a 20 2f 68 6f 6d 65 2f 6d 65 2f itory: /home/me/
46d0: 62 69 67 70 72 6f 6a 65 63 74 2e 66 6f 73 73 69 bigproject.fossi
46e0: 6c 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 l.</pre></blockq
46f0: 75 6f 74 65 3e 0a 0a 45 64 69 74 20 74 68 69 73 uote>..Edit this
4700: 20 73 63 72 69 70 74 20 74 6f 20 75 73 65 20 77 script to use w
4710: 68 61 74 65 76 65 72 20 70 61 74 68 6e 61 6d 65 hatever pathname
4720: 73 20 61 72 65 20 61 70 70 72 6f 70 72 69 61 74 s are appropriat
4730: 65 20 66 6f 72 0a 79 6f 75 72 20 70 72 6f 6a 65 e for.your proje
4740: 63 74 2e 20 20 54 68 65 6e 20 70 6f 69 6e 74 20 ct. Then point
4750: 79 6f 75 72 20 77 65 62 20 62 72 6f 77 73 65 72 your web browser
4760: 20 61 74 20 74 68 65 20 73 63 72 69 70 74 20 61 at the script a
4770: 6e 64 20 6f 66 66 20 79 6f 75 0a 67 6f 2e 20 20 nd off you.go.
4780: 54 68 65 20 5b 2e 2f 73 65 6c 66 68 6f 73 74 2e The [./selfhost.
4790: 77 69 6b 69 20 7c 20 73 65 6c 66 2d 68 6f 73 74 wiki | self-host
47a0: 69 6e 67 20 66 6f 73 73 69 6c 20 72 65 70 6f 73 ing fossil repos
47b0: 69 74 6f 72 69 65 73 5d 20 61 72 65 0a 61 6c 6c itories] are.all
47c0: 20 73 65 74 20 75 70 20 74 68 69 73 20 77 61 79 set up this way
47d0: 2e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 62 3e 53 .</li>..<li><b>S
47e0: 65 74 74 69 6e 67 20 75 70 20 61 6e 20 69 6e 65 etting up an ine
47f0: 74 64 20 73 65 72 76 65 72 3c 2f 62 3e 0a 0a 49 td server</b>..I
4800: 66 20 79 6f 75 20 68 61 76 65 20 69 6e 65 74 64 f you have inetd
4810: 20 6f 72 20 78 69 6e 65 74 64 20 72 75 6e 6e 69 or xinetd runni
4820: 6e 67 20 6f 6e 20 79 6f 75 72 20 73 79 73 74 65 ng on your syste
4830: 6d 2c 20 79 6f 75 20 63 61 6e 20 73 65 74 0a 74 m, you can set.t
4840: 68 6f 73 65 20 73 65 72 76 69 63 65 73 20 75 70 hose services up
4850: 20 74 6f 20 6c 61 75 6e 63 68 20 66 6f 73 73 69 to launch fossi
4860: 6c 20 74 6f 20 64 65 61 6c 20 77 69 74 68 20 69 l to deal with i
4870: 6e 62 6f 75 6e 64 20 54 43 50 2f 49 50 20 63 6f nbound TCP/IP co
4880: 6e 6e 65 63 74 69 6f 6e 73 0a 6f 6e 20 77 68 61 nnections.on wha
4890: 74 65 76 65 72 20 70 6f 72 74 20 79 6f 75 20 77 tever port you w
48a0: 61 6e 74 2e 20 20 53 65 74 20 75 70 20 69 6e 65 ant. Set up ine
48b0: 74 64 20 6f 72 20 78 69 6e 65 74 64 20 74 6f 20 td or xinetd to
48c0: 6c 61 75 6e 63 68 20 66 6f 73 73 69 6c 0a 6c 69 launch fossil.li
48d0: 6b 65 20 74 68 69 73 3a 0a 0a 3c 62 6c 6f 63 6b ke this:..<block
48e0: 71 75 6f 74 65 3e 3c 70 72 65 3e 0a 2f 75 73 72 quote><pre>./usr
48f0: 2f 6c 6f 63 61 6c 2f 62 69 6e 2f 66 6f 73 73 69 /local/bin/fossi
4900: 6c 20 68 74 74 70 20 2f 68 6f 6d 65 2f 6d 65 2f l http /home/me/
4910: 62 69 67 70 72 6f 6a 65 63 74 2e 66 6f 73 73 69 bigproject.fossi
4920: 6c 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 l.</pre></blockq
4930: 75 6f 74 65 3e 0a 0a 41 73 20 62 65 66 6f 72 65 uote>..As before
4940: 2c 20 63 68 61 6e 67 65 20 74 68 65 20 66 69 6c , change the fil
4950: 65 6e 61 6d 65 73 20 74 6f 20 77 68 61 74 65 76 enames to whatev
4960: 65 72 20 69 73 20 61 70 70 72 6f 70 72 69 61 74 er is appropriat
4970: 65 20 66 6f 72 0a 79 6f 75 72 20 73 79 73 74 65 e for.your syste
4980: 6d 2e 20 20 59 6f 75 20 63 61 6e 20 68 61 76 65 m. You can have
4990: 20 66 6f 73 73 69 6c 20 72 75 6e 20 61 73 20 61 fossil run as a
49a0: 6e 79 20 75 73 65 72 20 74 68 61 74 20 68 61 73 ny user that has
49b0: 20 77 72 69 74 65 0a 70 65 72 6d 69 73 73 69 6f write.permissio
49c0: 6e 20 6f 6e 20 74 68 65 20 72 65 70 6f 73 69 74 n on the reposit
49d0: 6f 72 79 20 61 6e 64 20 6f 6e 20 74 68 65 20 64 ory and on the d
49e0: 69 72 65 63 74 6f 72 79 20 74 68 61 74 20 63 6f irectory that co
49f0: 6e 74 61 69 6e 73 20 74 68 65 0a 72 65 70 6f 73 ntains the.repos
4a00: 69 74 6f 72 79 2e 20 20 42 75 74 20 69 74 20 69 itory. But it i
4a10: 73 20 73 61 66 65 72 20 74 6f 20 72 75 6e 20 66 s safer to run f
4a20: 6f 73 73 69 6c 20 61 73 20 72 6f 6f 74 2e 20 20 ossil as root.
4a30: 57 68 65 6e 20 66 6f 73 73 69 6c 0a 73 65 65 73 When fossil.sees
4a40: 20 74 68 61 74 20 69 74 20 69 73 20 72 75 6e 6e that it is runn
4a50: 69 6e 67 20 61 73 20 72 6f 6f 74 2c 20 69 74 20 ing as root, it
4a60: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 70 75 automatically pu
4a70: 74 73 20 69 74 73 65 6c 66 20 69 6e 74 6f 0a 61 ts itself into.a
4a80: 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 3a 2f <a href="http:/
4a90: 2f 65 6e 2e 77 69 6b 69 70 65 64 69 61 2e 6f 72 /en.wikipedia.or
4aa0: 67 2f 77 69 6b 69 2f 43 68 72 6f 6f 74 22 3e 63 g/wiki/Chroot">c
4ab0: 68 72 6f 6f 74 20 6a 61 69 6c 3c 2f 61 3e 20 61 hroot jail</a> a
4ac0: 6e 64 0a 64 72 6f 70 73 20 61 6c 6c 20 70 72 69 nd.drops all pri
4ad0: 76 69 6c 65 67 65 73 20 70 72 69 6f 72 20 74 6f vileges prior to
4ae0: 20 72 65 61 64 69 6e 67 20 61 6e 79 20 69 6e 66 reading any inf
4af0: 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 74 68 ormation from th
4b00: 65 20 63 6c 69 65 6e 74 2e 0a 53 69 6e 63 65 20 e client..Since
4b10: 66 6f 73 73 69 6c 20 69 73 20 61 20 73 74 61 6e fossil is a stan
4b20: 64 2d 61 6c 6f 6e 65 20 70 72 6f 67 72 61 6d 2c d-alone program,
4b30: 20 79 6f 75 20 64 6f 20 6e 6f 74 20 6e 65 65 64 you do not need
4b40: 20 74 6f 20 70 75 74 20 61 6e 79 74 68 69 6e 67 to put anything
4b50: 0a 69 6e 20 74 68 65 20 63 68 72 6f 6f 74 20 6a .in the chroot j
4b60: 61 69 6c 20 77 69 74 68 20 66 6f 73 73 69 6c 20 ail with fossil
4b70: 69 6e 20 6f 72 64 65 72 20 66 6f 72 20 69 74 20 in order for it
4b80: 74 6f 20 64 6f 20 69 74 73 20 6a 6f 62 2e 0a 3c to do its job..<
4b90: 2f 6c 69 3e 0a 3c 2f 6f 6c 3e 0a 0a 3c 68 32 3e /li>.</ol>..<h2>
4ba0: 36 2e 30 20 52 65 76 69 65 77 20 4f 66 20 4b 65 6.0 Review Of Ke
4bb0: 79 20 43 6f 6e 63 65 70 74 73 3c 2f 68 32 3e 0a y Concepts</h2>.
4bc0: 0a 3c 75 6c 3e 0a 3c 6c 69 3e 54 68 65 20 3c 62 .<ul>.<li>The <b
4bd0: 3e 66 6f 73 73 69 6c 3c 2f 62 3e 20 70 72 6f 67 >fossil</b> prog
4be0: 72 61 6d 20 69 73 20 61 20 73 65 6c 66 2d 63 6f ram is a self-co
4bf0: 6e 74 61 69 6e 65 64 20 73 74 61 6e 64 2d 61 6c ntained stand-al
4c00: 6f 6e 65 20 65 78 65 63 75 74 61 62 6c 65 2e 0a one executable..
4c10: 20 20 20 20 4a 75 73 74 20 70 75 74 20 69 74 20 Just put it
4c20: 73 6f 6d 65 77 68 65 72 65 20 6f 6e 20 79 6f 75 somewhere on you
4c30: 72 20 50 41 54 48 20 74 6f 20 69 6e 73 74 61 6c r PATH to instal
4c40: 6c 20 69 74 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 55 l it.</li>.<li>U
4c50: 73 65 20 74 68 65 20 3c 62 3e 63 6c 6f 6e 65 3c se the <b>clone<
4c60: 2f 62 3e 20 6f 72 20 3c 62 3e 6e 65 77 3c 2f 62 /b> or <b>new</b
4c70: 3e 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 63 72 > commands to cr
4c80: 65 61 74 65 20 61 20 6e 65 77 20 72 65 70 6f 73 eate a new repos
4c90: 69 74 6f 72 79 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e itory.</li>.<li>
4ca0: 55 73 65 20 74 68 65 20 3c 62 3e 6f 70 65 6e 3c Use the <b>open<
4cb0: 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 63 /b> command to c
4cc0: 72 65 61 74 65 20 61 20 6e 65 77 20 73 6f 75 72 reate a new sour
4cd0: 63 65 20 74 72 65 65 2e 3c 2f 6c 69 3e 0a 3c 6c ce tree.</li>.<l
4ce0: 69 3e 55 73 65 20 74 68 65 20 3c 62 3e 61 64 64 i>Use the <b>add
4cf0: 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 72 6d 3c 2f </b> and <b>rm</
4d00: 62 3e 20 6f 72 20 3c 62 3e 64 65 6c 65 74 65 3c b> or <b>delete<
4d10: 2f 62 3e 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 /b> commands to
4d20: 61 64 64 20 61 6e 64 0a 20 20 20 20 72 65 6d 6f add and. remo
4d30: 76 65 20 66 69 6c 65 73 20 66 72 6f 6d 20 74 68 ve files from th
4d40: 65 20 6c 6f 63 61 6c 20 73 6f 75 72 63 65 20 74 e local source t
4d50: 72 65 65 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 55 73 ree.</li>.<li>Us
4d60: 65 20 74 68 65 20 3c 62 3e 63 6f 6d 6d 69 74 3c e the <b>commit<
4d70: 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 63 /b> command to c
4d80: 72 65 61 74 65 20 61 20 6e 65 77 20 63 68 65 63 reate a new chec
4d90: 6b 2d 69 6e 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 55 k-in.</li>.<li>U
4da0: 73 65 20 74 68 65 20 3c 62 3e 75 70 64 61 74 65 se the <b>update
4db0: 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 </b> command to
4dc0: 6d 65 72 67 65 20 69 6e 20 63 68 61 6e 67 65 73 merge in changes
4dd0: 20 66 72 6f 6d 20 6f 74 68 65 72 73 2e 3c 2f 6c from others.</l
4de0: 69 3e 0a 3c 6c 69 3e 54 68 65 20 3c 62 3e 70 75 i>.<li>The <b>pu
4df0: 73 68 3c 2f 62 3e 20 61 6e 64 20 3c 62 3e 70 75 sh</b> and <b>pu
4e00: 6c 6c 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 73 20 ll</b> commands
4e10: 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 73 can be used to s
4e20: 68 61 72 65 20 63 68 61 6e 67 65 73 0a 20 20 20 hare changes.
4e30: 20 6d 61 6e 75 61 6c 6c 79 2c 20 62 75 74 20 74 manually, but t
4e40: 68 65 73 65 20 74 68 69 6e 67 73 20 68 61 70 70 hese things happ
4e50: 65 6e 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 en automatically
4e60: 20 69 6e 20 74 68 65 20 64 65 66 61 75 6c 74 0a in the default.
4e70: 20 20 20 20 61 75 74 6f 73 79 6e 63 20 6d 6f 64 autosync mod
4e80: 65 2e 3c 2f 6c 69 3e 0a 3c 2f 75 6c 3e 0a e.</li>.</ul>.