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