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 62 61 73 65 6c 69 6e 65 22 2e 3c 2f me "baseline".</
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 76 65 72 73 69 historical.versi
04b0: 6f 6e 73 20 6f 72 20 62 61 73 65 6c 69 6e 65 73 ons or baselines
04c0: 20 66 6f 72 20 61 20 70 72 6f 6a 65 63 74 2e 20 for a project.
04d0: 20 42 61 73 65 6c 69 6e 65 73 20 61 72 65 20 6e Baselines are n
04e0: 6f 72 6d 61 6c 6c 79 20 73 74 6f 72 65 64 20 69 ormally stored i
04f0: 6e 20 74 68 65 0a 72 65 70 6f 73 69 74 6f 72 79 n the.repository
0500: 20 69 6e 20 61 20 68 69 67 68 6c 79 20 73 70 61 in a highly spa
0510: 63 65 2d 65 66 66 69 63 69 65 6e 74 20 63 6f 6d ce-efficient com
0520: 70 72 65 73 73 65 64 20 66 6f 72 6d 61 74 20 28 pressed format (
0530: 64 65 6c 74 61 20 65 6e 63 6f 64 69 6e 67 29 2e delta encoding).
0540: 0a 42 75 74 20 74 68 61 74 20 69 73 20 61 6e 20 .But that is an
0550: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 64 implementation d
0560: 65 74 61 69 6c 20 74 68 61 74 20 79 6f 75 20 74 etail that you t
0570: 68 65 20 75 73 65 72 20 6e 65 65 64 20 6e 6f 74 he user need not
0580: 20 77 6f 72 72 79 20 6f 76 65 72 2e 0a 54 68 69 worry over..Thi
0590: 6e 6b 20 6f 66 20 74 68 65 20 72 65 70 6f 73 69 nk of the reposi
05a0: 74 6f 72 79 20 61 73 20 61 20 73 61 66 65 20 70 tory as a safe p
05b0: 6c 61 63 65 20 77 68 65 72 65 20 61 6c 6c 20 79 lace where all y
05c0: 6f 75 72 20 6f 6c 64 20 62 61 73 65 6c 69 6e 65 our old baseline
05d0: 73 20 61 72 65 0a 73 65 63 75 72 65 6c 79 20 73 s are.securely s
05e0: 74 6f 72 65 64 20 61 77 61 79 20 61 6e 64 20 61 tored away and a
05f0: 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 72 65 74 vailable for ret
0600: 72 69 65 76 61 6c 20 77 68 65 6e 65 76 65 72 20 rieval whenever
0610: 79 6f 75 20 6e 65 65 64 0a 74 68 65 6d 2e 3c 2f you need.them.</
0620: 70 3e 0a 0a 3c 70 3e 41 20 72 65 70 6f 73 69 74 p>..<p>A reposit
0630: 6f 72 79 20 69 6e 20 66 6f 73 73 69 6c 20 69 73 ory in fossil is
0640: 20 61 20 73 69 6e 67 6c 65 20 66 69 6c 65 20 6f a single file o
0650: 6e 20 79 6f 75 72 20 64 69 73 6b 2e 20 20 54 68 n your disk. Th
0660: 69 73 20 66 69 6c 65 0a 6d 69 67 68 74 20 62 65 is file.might be
0670: 20 72 61 74 68 65 72 20 6c 61 72 67 65 20 28 64 rather large (d
0680: 6f 7a 65 6e 73 20 6f 72 20 68 75 6e 64 72 65 64 ozens or hundred
0690: 73 20 6f 66 20 6d 65 67 61 62 79 74 65 73 20 66 s of megabytes f
06a0: 6f 72 20 61 20 6c 61 72 67 65 0a 6f 72 20 6c 6f or a large.or lo
06b0: 6e 67 20 72 75 6e 6e 69 6e 67 20 70 72 6f 6a 65 ng running proje
06c0: 63 74 29 20 62 75 74 20 69 74 20 69 73 20 6e 65 ct) but it is ne
06d0: 76 65 72 74 68 65 6c 65 73 73 20 6a 75 73 74 20 vertheless just
06e0: 61 20 66 69 6c 65 2e 20 20 59 6f 75 0a 63 61 6e a file. You.can
06f0: 20 6d 6f 76 65 20 69 74 20 61 72 6f 75 6e 64 2c move it around,
0700: 20 72 65 6e 61 6d 65 20 69 74 2c 20 77 72 69 74 rename it, writ
0710: 65 20 69 74 20 6f 75 74 20 74 6f 20 61 20 6d 65 e it out to a me
0720: 6d 6f 72 79 20 73 74 69 63 6b 2c 20 6f 72 0a 64 mory stick, or.d
0730: 6f 20 61 6e 79 74 68 69 6e 67 20 65 6c 73 65 20 o anything else
0740: 79 6f 75 20 6e 6f 72 6d 61 6c 6c 79 20 64 6f 20 you normally do
0750: 77 69 74 68 20 66 69 6c 65 73 2e 3c 2f 70 3e 0a with files.</p>.
0760: 0a 3c 70 3e 45 61 63 68 20 73 6f 75 72 63 65 20 .<p>Each source
0770: 74 72 65 65 20 74 68 61 74 20 69 73 20 63 6f 6e tree that is con
0780: 74 72 6f 6c 6c 65 64 20 62 79 20 66 6f 73 73 69 trolled by fossi
0790: 6c 20 69 73 20 61 73 73 6f 63 69 61 74 65 64 20 l is associated
07a0: 77 69 74 68 0a 61 20 73 69 6e 67 6c 65 20 72 65 with.a single re
07b0: 70 6f 73 69 74 6f 72 79 20 6f 6e 20 74 68 65 20 pository on the
07c0: 6c 6f 63 61 6c 20 64 69 73 6b 20 64 72 69 76 65 local disk drive
07d0: 2e 20 20 59 6f 75 20 63 61 6e 20 74 69 65 20 74 . You can tie t
07e0: 77 6f 20 6f 72 20 6d 6f 72 65 0a 73 6f 75 72 63 wo or more.sourc
07f0: 65 20 74 72 65 65 73 20 74 6f 20 61 20 73 69 6e e trees to a sin
0800: 67 6c 65 20 72 65 70 6f 73 69 74 6f 72 79 20 69 gle repository i
0810: 66 20 79 6f 75 20 77 61 6e 74 20 28 74 68 6f 75 f you want (thou
0820: 67 68 20 6f 6e 65 0a 74 72 65 65 20 70 65 72 20 gh one.tree per
0830: 72 65 70 6f 73 69 74 6f 72 79 20 69 73 20 74 68 repository is th
0840: 65 20 6d 6f 73 74 20 63 6f 6d 6d 6f 6e 20 63 6f e most common co
0850: 6e 66 69 67 75 72 61 74 69 6f 6e 2e 29 20 20 53 nfiguration.) S
0860: 6f 20 61 0a 73 69 6e 67 6c 65 20 72 65 70 6f 73 o a.single repos
0870: 69 74 6f 72 79 20 63 61 6e 20 62 65 20 61 73 73 itory can be ass
0880: 6f 63 69 61 74 65 64 20 77 69 74 68 20 6d 61 6e ociated with man
0890: 79 20 73 6f 75 72 63 65 20 74 72 65 65 73 2c 20 y source trees,
08a0: 62 75 74 0a 65 61 63 68 20 73 6f 75 72 63 65 20 but.each source
08b0: 74 72 65 65 20 69 73 20 61 73 73 6f 63 69 61 74 tree is associat
08c0: 65 64 20 77 69 74 68 20 6f 6e 6c 79 20 6f 6e 65 ed with only one
08d0: 20 72 65 70 6f 73 69 74 6f 72 79 2e 3c 2f 70 3e repository.</p>
08e0: 0a 0a 3c 70 3e 46 6f 73 73 69 6c 20 73 6f 75 72 ..<p>Fossil sour
08f0: 63 65 20 74 72 65 65 73 20 6d 61 79 20 6e 6f 74 ce trees may not
0900: 20 6f 76 65 72 6c 61 70 2e 20 20 41 20 66 6f 73 overlap. A fos
0910: 73 69 6c 20 73 6f 75 72 63 65 20 74 72 65 65 20 sil source tree
0920: 69 73 20 69 64 65 6e 74 69 66 69 65 64 0a 62 79 is identified.by
0930: 20 61 20 66 69 6c 65 20 6e 61 6d 65 64 20 22 5f a file named "_
0940: 46 4f 53 53 49 4c 5f 22 20 69 6e 20 74 68 65 20 FOSSIL_" in the
0950: 72 6f 6f 74 20 64 69 72 65 63 74 6f 72 79 20 6f root directory o
0960: 66 20 74 68 65 20 73 6f 75 72 63 65 20 74 72 65 f the source tre
0970: 65 2e 20 20 45 76 65 72 79 0a 66 69 6c 65 20 74 e. Every.file t
0980: 68 61 74 20 69 73 20 61 20 73 69 62 6c 69 6e 67 hat is a sibling
0990: 20 6f 66 20 5f 46 4f 53 53 49 4c 5f 20 61 6e 64 of _FOSSIL_ and
09a0: 20 65 76 65 72 79 20 66 69 6c 65 20 69 6e 20 65 every file in e
09b0: 76 65 72 79 20 73 75 62 66 6f 6c 64 65 72 20 69 very subfolder i
09c0: 73 0a 63 6f 6e 73 69 64 65 72 65 64 20 70 6f 74 s.considered pot
09d0: 65 6e 74 69 61 6c 6c 79 20 61 20 70 61 72 74 20 entially a part
09e0: 6f 66 20 74 68 65 20 73 6f 75 72 63 65 20 74 72 of the source tr
09f0: 65 65 2e 20 20 54 68 65 20 5f 46 4f 53 53 49 4c ee. The _FOSSIL
0a00: 5f 20 66 69 6c 65 0a 63 6f 6e 74 61 69 6e 73 20 _ file.contains
0a10: 28 61 6d 6f 6e 67 20 6f 74 68 65 72 20 74 68 69 (among other thi
0a20: 6e 67 73 29 20 74 68 65 20 70 61 74 68 6e 61 6d ngs) the pathnam
0a30: 65 20 6f 66 20 74 68 65 20 72 65 70 6f 73 69 74 e of the reposit
0a40: 6f 72 79 20 77 69 74 68 20 77 68 69 63 68 0a 74 ory with which.t
0a50: 68 65 20 73 6f 75 72 63 65 20 74 72 65 65 20 69 he source tree i
0a60: 73 20 61 73 73 6f 63 69 61 74 65 64 2e 20 20 4f s associated. O
0a70: 6e 20 74 68 65 20 6f 74 68 65 72 20 68 61 6e 64 n the other hand
0a80: 2c 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 , the repository
0a90: 20 68 61 73 0a 6e 6f 20 72 65 63 6f 72 64 20 6f has.no record o
0aa0: 66 20 69 74 73 20 73 6f 75 72 63 65 20 74 72 65 f its source tre
0ab0: 65 73 2e 20 20 53 6f 20 79 6f 75 20 61 72 65 20 es. So you are
0ac0: 66 72 65 65 20 74 6f 20 64 65 6c 65 74 65 20 61 free to delete a
0ad0: 20 73 6f 75 72 63 65 20 74 72 65 65 0a 6f 72 20 source tree.or
0ae0: 6d 6f 76 65 20 69 74 20 61 72 6f 75 6e 64 20 77 move it around w
0af0: 69 74 68 6f 75 74 20 63 6f 6e 73 65 71 75 65 6e ithout consequen
0b00: 63 65 2e 20 20 42 75 74 20 69 66 20 79 6f 75 20 ce. But if you
0b10: 6d 6f 76 65 20 6f 72 20 72 65 6e 61 6d 65 20 6f move or rename o
0b20: 72 0a 64 65 6c 65 74 65 20 61 20 72 65 70 6f 73 r.delete a repos
0b30: 69 74 6f 72 79 2c 20 74 68 65 6e 20 61 6e 79 20 itory, then any
0b40: 73 6f 75 72 63 65 20 74 72 65 65 73 20 61 73 73 source trees ass
0b50: 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 61 ociated with tha
0b60: 74 20 72 65 70 6f 73 69 74 6f 72 79 0a 77 69 6c t repository.wil
0b70: 6c 20 6e 6f 20 6c 6f 6e 67 65 72 20 62 65 20 61 l no longer be a
0b80: 62 6c 65 20 74 6f 20 6c 6f 63 61 74 65 20 74 68 ble to locate th
0b90: 65 69 72 20 72 65 70 6f 73 69 74 6f 72 79 20 61 eir repository a
0ba0: 6e 64 20 77 69 6c 6c 20 73 74 6f 70 20 77 6f 72 nd will stop wor
0bb0: 6b 69 6e 67 2e 3c 2f 70 3e 0a 0a 3c 70 3e 57 68 king.</p>..<p>Wh
0bc0: 65 6e 20 6d 75 6c 74 69 70 6c 65 20 64 65 76 65 en multiple deve
0bd0: 6c 6f 70 65 72 73 20 61 72 65 20 77 6f 72 6b 69 lopers are worki
0be0: 6e 67 20 6f 6e 20 74 68 65 20 73 61 6d 65 20 70 ng on the same p
0bf0: 72 6f 6a 65 63 74 2c 20 65 61 63 68 0a 64 65 76 roject, each.dev
0c00: 65 6c 6f 70 65 72 20 74 79 70 69 63 61 6c 6c 79 eloper typically
0c10: 20 68 61 73 20 68 69 73 20 6f 72 20 68 65 72 20 has his or her
0c20: 6f 77 6e 20 6c 6f 63 61 6c 20 72 65 70 6f 73 69 own local reposi
0c30: 74 6f 72 79 20 61 6e 64 20 61 6e 20 61 73 73 6f tory and an asso
0c40: 63 69 61 74 65 64 0a 73 6f 75 72 63 65 20 74 72 ciated.source tr
0c50: 65 65 20 69 6e 20 77 68 69 63 68 20 74 6f 20 77 ee in which to w
0c60: 6f 72 6b 2e 20 20 44 65 76 65 6c 6f 70 65 72 73 ork. Developers
0c70: 20 73 68 61 72 65 20 74 68 65 69 72 20 77 6f 72 share their wor
0c80: 6b 20 62 79 0a 22 73 79 6e 63 69 6e 67 22 20 74 k by."syncing" t
0c90: 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 he content of th
0ca0: 65 69 72 20 6c 6f 63 61 6c 20 72 65 70 6f 73 69 eir local reposi
0cb0: 74 6f 72 69 65 73 20 65 69 74 68 65 72 20 64 69 tories either di
0cc0: 72 65 63 74 6c 79 0a 6f 72 20 74 68 72 6f 75 67 rectly.or throug
0cd0: 68 20 61 20 63 65 6e 74 72 61 6c 20 73 65 72 76 h a central serv
0ce0: 65 72 2e 20 20 43 68 61 6e 67 65 73 20 63 61 6e er. Changes can
0cf0: 20 22 70 75 73 68 22 20 66 72 6f 6d 20 74 68 65 "push" from the
0d00: 20 6c 6f 63 61 6c 0a 72 65 70 6f 73 69 74 6f 72 local.repositor
0d10: 79 20 69 6e 74 6f 20 61 20 72 65 6d 6f 74 65 20 y into a remote
0d20: 72 65 70 6f 73 69 74 6f 72 79 2e 20 20 4f 72 20 repository. Or
0d30: 63 68 61 6e 67 65 73 20 63 61 6e 20 22 70 75 6c changes can "pul
0d40: 6c 22 20 66 72 6f 6d 20 61 0a 72 65 6d 6f 74 65 l" from a.remote
0d50: 20 72 65 70 6f 73 69 74 6f 72 79 20 69 6e 74 6f repository into
0d60: 20 61 20 6c 6f 63 61 6c 20 72 65 70 6f 73 69 74 a local reposit
0d70: 6f 72 79 2e 20 20 4f 72 20 6f 6e 65 20 63 61 6e ory. Or one can
0d80: 20 64 6f 20 61 20 22 73 79 6e 63 22 0a 77 68 69 do a "sync".whi
0d90: 63 68 20 69 73 20 61 20 73 68 6f 72 74 63 75 74 ch is a shortcut
0da0: 20 66 6f 72 20 64 6f 69 6e 67 20 62 6f 74 68 20 for doing both
0db0: 61 20 70 75 73 68 20 61 6e 64 20 61 20 70 75 6c a push and a pul
0dc0: 6c 20 61 74 20 74 68 65 20 73 61 6d 65 20 74 69 l at the same ti
0dd0: 6d 65 2e 0a 46 6f 73 73 69 6c 20 61 6c 73 6f 20 me..Fossil also
0de0: 68 61 73 20 74 68 65 20 63 6f 6e 63 65 70 74 20 has the concept
0df0: 6f 66 20 22 63 6c 6f 6e 69 6e 67 22 2e 20 20 41 of "cloning". A
0e00: 20 22 63 6c 6f 6e 65 22 20 69 73 20 6c 69 6b 65 "clone" is like
0e10: 20 61 20 22 70 75 6c 6c 22 2c 0a 65 78 63 65 70 a "pull",.excep
0e20: 74 20 74 68 61 74 20 69 6e 73 74 65 61 64 20 6f t that instead o
0e30: 66 20 62 65 67 69 6e 6e 69 6e 67 20 77 69 74 68 f beginning with
0e40: 20 61 6e 20 65 78 69 73 74 69 6e 67 20 6c 6f 63 an existing loc
0e50: 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 2c 0a 61 al repository,.a
0e60: 20 63 6c 6f 6e 65 20 62 65 67 69 6e 73 20 77 69 clone begins wi
0e70: 74 68 20 6e 6f 74 68 69 6e 67 20 61 6e 64 20 63 th nothing and c
0e80: 72 65 61 74 65 73 20 61 20 6e 65 77 20 6c 6f 63 reates a new loc
0e90: 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 20 74 68 al repository th
0ea0: 61 74 0a 69 73 20 61 20 64 75 70 6c 69 63 61 74 at.is a duplicat
0eb0: 65 20 6f 66 20 61 20 72 65 6d 6f 74 65 20 72 65 e of a remote re
0ec0: 70 6f 73 69 74 6f 72 79 2e 3c 2f 70 3e 0a 0a 3c pository.</p>..<
0ed0: 70 3e 43 6f 6d 6d 75 6e 69 63 61 74 69 6f 6e 20 p>Communication
0ee0: 62 65 74 77 65 65 6e 20 72 65 70 6f 73 69 74 6f between reposito
0ef0: 72 69 65 73 20 69 73 20 76 69 61 20 48 54 54 50 ries is via HTTP
0f00: 2e 20 20 52 65 6d 6f 74 65 0a 72 65 70 6f 73 69 . Remote.reposi
0f10: 74 6f 72 69 65 73 20 61 72 65 20 69 64 65 6e 74 tories are ident
0f20: 69 66 69 65 64 20 62 79 20 55 52 4c 2e 20 20 59 ified by URL. Y
0f30: 6f 75 20 63 61 6e 20 61 6c 73 6f 20 70 6f 69 6e ou can also poin
0f40: 74 20 61 20 77 65 62 62 72 6f 77 73 65 72 0a 61 t a webbrowser.a
0f50: 74 20 61 20 72 65 70 6f 73 69 74 6f 72 79 20 61 t a repository a
0f60: 6e 64 20 67 65 74 20 68 75 6d 61 6e 2d 72 65 61 nd get human-rea
0f70: 64 61 62 6c 65 20 73 74 61 74 75 73 2c 20 68 69 dable status, hi
0f80: 73 74 6f 72 79 2c 20 61 6e 64 20 74 72 61 63 6b story, and track
0f90: 69 6e 67 0a 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 ing.information
0fa0: 61 62 6f 75 74 20 74 68 65 20 70 72 6f 6a 65 63 about the projec
0fb0: 74 2e 3c 2f 70 3e 0a 0a 3c 68 33 3e 32 2e 31 20 t.</p>..<h3>2.1
0fc0: 49 64 65 6e 74 69 66 69 63 61 74 69 6f 6e 20 4f Identification O
0fd0: 66 20 41 72 74 69 66 61 63 74 73 3c 2f 68 33 3e f Artifacts</h3>
0fe0: 0a 0a 3c 70 3e 41 20 70 61 72 74 69 63 75 6c 61 ..<p>A particula
0ff0: 72 20 76 65 72 73 69 6f 6e 20 6f 66 20 61 20 70 r version of a p
1000: 61 72 74 69 63 75 6c 61 72 20 66 69 6c 65 20 69 articular file i
1010: 73 20 63 61 6c 6c 65 64 20 61 6e 20 22 61 72 74 s called an "art
1020: 69 66 61 63 74 22 2e 0a 45 61 63 68 20 61 72 74 ifact"..Each art
1030: 69 66 61 63 74 20 68 61 73 20 61 20 75 6e 69 76 ifact has a univ
1040: 65 72 73 61 6c 6c 79 20 75 6e 69 71 75 65 20 6e ersally unique n
1050: 61 6d 65 20 77 68 69 63 68 20 69 73 20 74 68 65 ame which is the
1060: 0a 3c 61 20 68 72 65 66 3d 22 68 74 74 70 3a 2f .<a href="http:/
1070: 2f 65 6e 2e 77 69 6b 69 70 65 64 69 61 2e 6f 72 /en.wikipedia.or
1080: 67 2f 77 69 6b 69 2f 53 48 41 22 3e 53 48 41 31 g/wiki/SHA">SHA1
1090: 3c 2f 61 3e 20 68 61 73 68 20 6f 66 20 74 68 65 </a> hash of the
10a0: 20 63 6f 6e 74 65 6e 74 0a 6f 66 20 74 68 61 74 content.of that
10b0: 20 66 69 6c 65 20 65 78 70 72 65 73 73 65 64 20 file expressed
10c0: 61 73 20 34 30 20 63 68 61 72 61 63 74 65 72 73 as 40 characters
10d0: 20 6f 66 20 6c 6f 77 65 72 2d 63 61 73 65 20 68 of lower-case h
10e0: 65 78 61 64 65 63 69 6d 61 6c 2e 20 20 53 75 63 exadecimal. Suc
10f0: 68 0a 61 20 68 61 73 68 20 69 73 20 72 65 66 65 h.a hash is refe
1100: 72 72 65 64 20 74 6f 20 61 73 20 74 68 65 20 55 rred to as the U
1110: 6e 69 76 65 72 73 61 6c 6c 79 20 55 6e 69 71 75 niversally Uniqu
1120: 65 20 49 64 65 6e 74 69 66 69 65 72 20 6f 72 20 e Identifier or
1130: 55 55 49 44 0a 66 6f 72 20 74 68 65 20 61 72 74 UUID.for the art
1140: 69 66 61 63 74 2e 20 20 54 68 65 20 53 48 41 31 ifact. The SHA1
1150: 20 61 6c 67 6f 72 69 74 68 6d 20 69 73 20 63 72 algorithm is cr
1160: 65 61 74 65 64 20 77 69 74 68 20 74 68 65 20 70 eated with the p
1170: 75 72 70 6f 73 65 20 6f 66 0a 70 72 6f 76 69 64 urpose of.provid
1180: 69 6e 67 20 61 20 68 69 67 68 6c 79 20 66 6f 72 ing a highly for
1190: 67 65 72 79 2d 72 65 73 69 73 74 65 6e 74 20 69 gery-resistent i
11a0: 64 65 6e 74 69 66 69 65 72 20 66 6f 72 20 61 20 dentifier for a
11b0: 66 69 6c 65 2e 20 20 47 69 76 65 6e 20 61 6e 79 file. Given any
11c0: 0a 66 69 6c 65 20 69 74 20 69 73 20 73 69 6d 70 .file it is simp
11d0: 6c 65 20 74 6f 20 66 69 6e 64 20 74 68 65 20 55 le to find the U
11e0: 55 49 44 20 66 6f 72 20 74 68 61 74 20 66 69 6c UID for that fil
11f0: 65 2e 20 20 42 75 74 20 67 69 76 65 6e 20 61 0a e. But given a.
1200: 55 55 49 44 20 69 74 20 69 73 20 63 6f 6d 70 75 UUID 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 55 55 ill.have that UU
1250: 49 44 2e 3c 2f 70 3e 0a 0a 0a 3c 70 3e 55 55 49 ID.</p>...<p>UUI
1260: 44 73 20 6c 6f 6f 6b 20 73 6f 6d 65 74 68 69 6e Ds look somethin
1270: 67 20 6c 69 6b 65 20 74 68 69 73 3a 3c 2f 70 3e g like this:</p>
1280: 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 62 ..<blockquote><b
1290: 3e 0a 36 30 38 39 66 30 62 35 36 33 61 39 64 62 >.6089f0b563a9db
12a0: 30 61 36 64 39 30 36 38 32 66 65 34 37 66 64 37 0a6d90682fe47fd7
12b0: 31 36 31 66 66 38 36 37 63 38 3c 62 72 3e 0a 35 161ff867c8<br>.5
12c0: 39 37 31 32 36 31 34 61 31 62 33 63 63 66 64 38 9712614a1b3ccfd8
12d0: 34 30 37 38 61 33 37 66 61 35 62 36 30 36 65 32 4078a37fa5b606e2
12e0: 38 34 33 34 33 32 36 3c 62 72 3e 0a 31 39 64 62 8434326<br>.19db
12f0: 66 37 33 30 37 38 62 65 39 37 37 39 65 64 64 36 f73078be9779edd6
1300: 61 30 31 35 36 31 39 35 65 36 31 30 66 38 31 63 a0156195e610f81c
1310: 39 34 66 39 3c 62 72 3e 0a 62 34 31 30 34 39 35 94f9<br>.b410495
1320: 39 61 36 37 31 37 35 66 30 32 64 36 62 34 31 35 9a67175f02d6b415
1330: 34 38 30 62 65 32 32 61 32 33 39 66 31 66 30 37 480be22a239f1f07
1340: 37 3c 62 72 3e 0a 39 39 37 63 39 64 36 61 65 30 7<br>.997c9d6ae0
1350: 33 61 64 31 31 34 62 32 62 35 37 66 30 34 65 39 3ad114b2b57f04e9
1360: 65 65 65 66 31 37 64 63 62 38 32 37 38 38 0a 3c eeef17dcb82788.<
1370: 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e /b></blockquote>
1380: 0a 0a 3c 70 3e 57 68 65 6e 20 72 65 66 65 72 72 ..<p>When referr
1390: 69 6e 67 20 74 6f 20 61 6e 20 61 72 74 69 66 61 ing to an artifa
13a0: 63 74 20 75 73 69 6e 67 20 66 6f 73 73 69 6c 2c ct using fossil,
13b0: 20 79 6f 75 20 63 61 6e 20 75 73 65 20 61 20 75 you can use a u
13c0: 6e 69 71 75 65 0a 70 72 65 66 69 78 20 6f 66 20 nique.prefix of
13d0: 74 68 65 20 55 55 49 44 20 74 68 61 74 20 69 73 the UUID that is
13e0: 20 66 6f 75 72 20 63 68 61 72 61 63 74 65 72 73 four characters
13f0: 20 6f 72 20 6c 6f 6e 67 65 72 2e 20 20 54 68 69 or longer. Thi
1400: 73 20 73 61 76 65 73 0a 61 20 6c 6f 74 20 6f 66 s saves.a lot of
1410: 20 74 79 70 69 6e 67 2e 20 20 57 68 65 6e 20 64 typing. When d
1420: 69 73 70 6c 61 79 69 6e 67 20 55 55 49 44 73 2c isplaying UUIDs,
1430: 20 66 6f 73 73 69 6c 20 77 69 6c 6c 20 75 73 75 fossil will usu
1440: 61 6c 6c 79 20 6f 6e 6c 79 0a 73 68 6f 77 20 74 ally only.show t
1450: 68 65 20 66 69 72 73 74 20 31 30 20 64 69 67 69 he first 10 digi
1460: 74 73 20 73 69 6e 63 65 20 74 68 61 74 20 69 73 ts since that is
1470: 20 6e 6f 72 6d 61 6c 6c 79 20 65 6e 6f 75 67 68 normally enough
1480: 20 74 6f 20 75 6e 69 71 75 65 6c 79 0a 69 64 65 to uniquely.ide
1490: 6e 74 69 66 79 20 61 20 66 69 6c 65 2e 3c 2f 70 ntify a file.</p
14a0: 3e 0a 0a 3c 70 3e 43 68 61 6e 67 69 6e 67 20 28 >..<p>Changing (
14b0: 6f 72 20 61 64 64 69 6e 67 20 6f 72 20 72 65 6d or adding or rem
14c0: 6f 76 69 6e 67 29 20 61 20 73 69 6e 67 6c 65 20 oving) a single
14d0: 62 79 74 65 20 69 6e 20 61 20 66 69 6c 65 20 72 byte in a file r
14e0: 65 73 75 6c 74 73 0a 69 6e 20 61 20 63 6f 6d 70 esults.in a comp
14f0: 6c 65 74 65 6c 79 20 64 69 66 66 65 72 65 6e 74 letely different
1500: 20 55 55 49 44 2e 20 20 41 6e 64 20 73 69 6e 63 UUID. And sinc
1510: 65 20 74 68 65 20 55 55 49 44 20 69 73 20 74 68 e the UUID is th
1520: 65 20 6e 61 6d 65 20 6f 66 0a 74 68 65 20 61 72 e name of.the ar
1530: 74 69 66 61 63 74 2c 20 6d 61 6b 69 6e 67 20 61 tifact, making a
1540: 6e 79 20 63 68 61 6e 67 65 20 74 6f 20 61 20 66 ny change to a f
1550: 69 6c 65 20 72 65 73 75 6c 74 73 20 69 6e 20 61 ile results in a
1560: 20 6e 65 77 20 61 72 74 69 66 61 63 74 2e 0a 49 new artifact..I
1570: 6e 20 74 68 69 73 20 77 61 79 2c 20 61 72 74 69 n this way, arti
1580: 66 61 63 74 73 20 61 72 65 20 69 6d 6d 75 74 61 facts are immuta
1590: 62 6c 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 41 20 72 ble.</p>..<p>A r
15a0: 65 70 6f 73 69 74 6f 72 79 20 69 73 20 72 65 61 epository is rea
15b0: 6c 6c 79 20 6a 75 73 74 20 61 6e 20 75 6e 6f 72 lly just an unor
15c0: 64 65 72 65 64 20 63 6f 6c 6c 65 63 74 69 6f 6e dered collection
15d0: 20 6f 66 0a 61 72 74 69 66 61 63 74 73 2e 20 20 of.artifacts.
15e0: 4e 65 77 20 61 72 74 69 66 61 63 74 73 20 63 61 New artifacts ca
15f0: 6e 20 62 65 20 61 64 64 65 64 20 74 6f 20 74 68 n be added to th
1600: 65 20 72 65 70 6f 73 69 74 6f 72 79 2c 20 62 75 e repository, bu
1610: 74 0a 65 78 69 73 74 69 6e 67 20 61 72 74 69 66 t.existing artif
1620: 61 63 74 73 20 63 61 6e 20 6e 65 76 65 72 20 62 acts can never b
1630: 65 20 72 65 6d 6f 76 65 64 2e 20 20 46 6f 73 73 e removed. Foss
1640: 69 6c 20 69 73 20 64 65 73 69 67 6e 65 64 20 69 il is designed i
1650: 6e 0a 73 75 63 68 20 61 20 77 61 79 20 74 68 61 n.such a way tha
1660: 74 20 69 74 20 63 61 6e 20 62 65 20 68 61 6e 64 t it can be hand
1670: 65 64 20 61 20 73 65 74 20 6f 66 20 61 72 74 69 ed a set of arti
1680: 66 61 63 74 73 20 69 6e 20 61 6e 79 0a 6f 72 64 facts in any.ord
1690: 65 72 20 61 6e 64 20 69 74 20 63 61 6e 20 66 69 er and it can fi
16a0: 67 75 72 65 20 6f 75 74 20 74 68 65 20 72 65 6c gure out the rel
16b0: 61 74 69 6f 6e 73 68 69 70 20 62 65 74 77 65 65 ationship betwee
16c0: 6e 20 74 68 6f 73 65 0a 61 72 74 69 66 61 63 74 n those.artifact
16d0: 73 20 61 6e 64 20 72 65 63 6f 6e 73 74 72 75 63 s and reconstruc
16e0: 74 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 20 64 t the complete d
16f0: 65 76 65 6c 6f 70 6d 65 6e 74 20 68 69 73 74 6f evelopment histo
1700: 72 79 20 6f 66 0a 61 20 73 6f 66 74 77 61 72 65 ry of.a software
1710: 20 70 72 6f 6a 65 63 74 2e 3c 2f 70 3e 0a 0a 3c project.</p>..<
1720: 68 33 3e 32 2e 32 20 4d 61 6e 69 66 65 73 74 73 h3>2.2 Manifests
1730: 3c 2f 68 33 3e 0a 0a 3c 70 3e 41 74 20 74 68 65 </h3>..<p>At the
1740: 20 72 6f 6f 74 20 6f 66 20 61 20 73 6f 75 72 63 root of a sourc
1750: 65 20 74 72 65 65 20 69 73 20 61 20 73 70 65 63 e tree is a spec
1760: 69 61 6c 20 66 69 6c 65 20 63 61 6c 6c 65 64 20 ial file called
1770: 74 68 65 0a 22 6d 61 6e 69 66 65 73 74 22 2e 20 the."manifest".
1780: 20 54 68 65 20 6d 61 6e 69 66 65 73 74 20 69 73 The manifest is
1790: 20 61 20 6c 69 73 74 69 6e 67 20 6f 66 20 61 6c a listing of al
17a0: 6c 20 6f 74 68 65 72 20 66 69 6c 65 73 20 69 6e l other files in
17b0: 0a 74 68 61 74 20 73 6f 75 72 63 65 20 74 72 65 .that source tre
17c0: 65 2e 20 20 54 68 65 20 6d 61 6e 69 66 65 73 74 e. The manifest
17d0: 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 28 63 contains the (c
17e0: 6f 6d 70 6c 65 74 65 29 20 55 55 49 44 20 0a 6f omplete) UUID .o
17f0: 66 20 74 68 65 20 66 69 6c 65 20 61 6e 64 20 74 f the file and t
1800: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 66 he name of the f
1810: 69 6c 65 20 61 73 20 69 74 20 61 70 70 65 61 72 ile as it appear
1820: 73 20 6f 6e 20 64 69 73 6b 2c 0a 61 6e 64 20 74 s on disk,.and t
1830: 68 75 73 20 73 65 72 76 65 73 20 61 73 20 61 20 hus serves as a
1840: 6d 61 70 70 69 6e 67 20 66 72 6f 6d 20 55 55 49 mapping from UUI
1850: 44 20 74 6f 20 64 69 73 6b 20 6e 61 6d 65 2e 20 D to disk name.
1860: 20 54 68 65 20 55 55 49 44 0a 6f 66 20 74 68 65 The UUID.of the
1870: 20 6d 61 6e 69 66 65 73 74 20 69 73 20 74 68 65 manifest is the
1880: 20 55 55 49 44 20 74 68 61 74 20 69 64 65 6e 74 UUID that ident
1890: 69 66 69 65 73 20 61 20 62 61 73 65 6c 69 6e 65 ifies a baseline
18a0: 2e 20 20 57 68 65 6e 0a 79 6f 75 20 6c 6f 6f 6b . When.you look
18b0: 20 61 74 20 61 20 22 74 69 6d 65 6c 69 6e 65 22 at a "timeline"
18c0: 20 6f 66 20 63 68 61 6e 67 65 73 20 69 6e 20 66 of changes in f
18d0: 6f 73 73 69 6c 2c 20 74 68 65 20 55 55 49 44 20 ossil, the UUID
18e0: 61 73 73 6f 63 69 61 74 65 64 0a 77 69 74 68 20 associated.with
18f0: 65 61 63 68 20 63 68 65 63 6b 2d 69 6e 20 6f 72 each check-in or
1900: 20 63 6f 6d 6d 69 74 20 69 73 20 72 65 61 6c 6c commit is reall
1910: 79 20 6a 75 73 74 20 74 68 65 20 55 55 49 44 20 y just the UUID
1920: 6f 66 20 74 68 65 0a 6d 61 6e 69 66 65 73 74 20 of the.manifest
1930: 66 6f 72 20 74 68 61 74 20 62 61 73 65 6c 69 6e for that baselin
1940: 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 46 6f 73 73 69 e.</p>..<p>Fossi
1950: 6c 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 l automatically
1960: 67 65 6e 65 72 61 74 65 73 20 61 20 6d 61 6e 69 generates a mani
1970: 66 65 73 74 20 77 68 65 6e 65 76 65 72 20 79 6f fest whenever yo
1980: 75 20 22 63 6f 6d 6d 69 74 22 20 0a 61 20 6e 65 u "commit" .a ne
1990: 77 20 62 61 73 65 6c 69 6e 65 2e 20 20 53 6f 20 w baseline. So
19a0: 74 68 69 73 20 69 73 20 6e 6f 74 20 73 6f 6d 65 this is not some
19b0: 74 68 69 6e 67 20 74 68 61 74 20 79 6f 75 2c 20 thing that you,
19c0: 74 68 65 20 64 65 76 65 6c 6f 70 65 72 2c 0a 6e the developer,.n
19d0: 65 65 64 20 74 6f 20 77 6f 72 72 79 20 77 69 74 eed to worry wit
19e0: 68 2e 20 20 54 68 65 20 66 6f 72 6d 61 74 20 6f h. The format o
19f0: 66 20 61 20 6d 61 6e 69 66 65 73 74 20 69 73 20 f a manifest is
1a00: 69 6e 74 65 6e 74 69 6f 6e 61 6c 6c 79 0a 64 65 intentionally.de
1a10: 73 69 67 6e 65 64 20 74 6f 20 62 65 20 73 69 6d signed to be sim
1a20: 70 6c 65 20 74 6f 20 70 61 72 73 65 2c 20 73 6f ple to parse, so
1a30: 20 74 68 61 74 20 69 66 0a 79 6f 75 20 77 61 6e that if.you wan
1a40: 74 20 74 6f 20 72 65 61 64 20 61 6e 64 20 69 6e t to read and in
1a50: 74 65 72 70 72 65 74 20 61 20 6d 61 6e 69 66 65 terpret a manife
1a60: 73 74 2c 20 65 69 74 68 65 72 20 62 79 20 68 61 st, either by ha
1a70: 6e 64 20 6f 72 0a 77 69 74 68 20 61 20 73 63 72 nd or.with a scr
1a80: 69 70 74 2c 20 74 68 61 74 20 69 73 20 65 61 73 ipt, that is eas
1a90: 79 20 74 6f 20 64 6f 2e 20 20 42 75 74 20 79 6f y to do. But yo
1aa0: 75 20 77 69 6c 6c 20 70 72 6f 62 61 62 6c 79 20 u will probably
1ab0: 6e 65 76 65 72 0a 6e 65 65 64 20 74 6f 20 64 6f never.need to do
1ac0: 20 73 6f 2e 3c 2f 70 3e 0a 0a 3c 70 3e 49 6e 20 so.</p>..<p>In
1ad0: 61 64 64 69 74 69 6f 6e 20 74 6f 20 69 64 65 6e addition to iden
1ae0: 74 69 66 79 69 6e 67 20 61 6c 6c 20 66 69 6c 65 tifying all file
1af0: 73 20 69 6e 20 74 68 65 20 62 61 73 65 6c 69 6e s in the baselin
1b00: 65 2c 20 61 0a 6d 61 6e 69 66 65 73 74 20 61 6c e, a.manifest al
1b10: 73 6f 20 63 6f 6e 74 61 69 6e 73 20 61 20 63 68 so contains a ch
1b20: 65 63 6b 2d 69 6e 20 63 6f 6d 6d 65 6e 74 2c 20 eck-in comment,
1b30: 74 68 65 20 64 61 74 65 20 61 6e 64 20 74 69 6d the date and tim
1b40: 65 0a 77 68 65 6e 20 74 68 65 20 62 61 73 65 6c e.when the basel
1b50: 69 6e 65 20 77 61 73 20 65 73 74 61 62 6c 69 73 ine was establis
1b60: 68 65 64 2c 20 77 68 6f 20 63 72 65 61 74 65 64 hed, who created
1b70: 20 74 68 65 20 62 61 73 65 6c 69 6e 65 2c 0a 61 the baseline,.a
1b80: 6e 64 20 6c 69 6e 6b 73 20 74 6f 20 6f 74 68 65 nd links to othe
1b90: 72 20 62 61 73 65 6c 69 6e 65 73 20 66 72 6f 6d r baselines from
1ba0: 20 77 68 69 63 68 20 74 68 65 20 63 75 72 72 65 which the curre
1bb0: 6e 74 20 62 61 73 65 6c 69 6e 65 0a 69 73 20 64 nt baseline.is d
1bc0: 65 72 69 76 65 64 2e 20 20 54 68 65 72 65 20 69 erived. There i
1bd0: 73 20 61 6c 73 6f 20 61 20 63 6f 75 70 6c 65 20 s also a couple
1be0: 6f 66 20 63 68 65 63 6b 73 75 6d 73 20 75 73 65 of checksums use
1bf0: 64 20 74 6f 20 76 65 72 69 66 79 0a 74 68 65 20 d to verify.the
1c00: 69 6e 74 65 67 72 69 74 79 20 6f 66 20 74 68 65 integrity of the
1c10: 20 62 61 73 65 6c 69 6e 65 2e 20 20 41 6e 64 20 baseline. And
1c20: 74 68 65 20 77 68 6f 6c 65 20 6d 61 6e 69 66 65 the whole manife
1c30: 73 74 20 6d 69 67 68 74 0a 62 65 20 50 47 50 20 st might.be PGP
1c40: 63 6c 65 61 72 73 69 67 6e 65 64 2e 3c 2f 70 3e clearsigned.</p>
1c50: 0a 0a 3c 68 33 3e 32 2e 33 20 4b 65 79 20 63 6f ..<h3>2.3 Key co
1c60: 6e 63 65 70 74 73 3c 2f 68 33 3e 0a 0a 3c 75 6c ncepts</h3>..<ul
1c70: 3e 0a 3c 6c 69 3e 41 20 3c 62 3e 62 61 73 65 6c >.<li>A <b>basel
1c80: 69 6e 65 3c 2f 62 3e 20 69 73 20 61 20 73 65 74 ine</b> is a set
1c90: 20 6f 66 20 66 69 6c 65 73 20 61 72 72 61 6e 67 of files arrang
1ca0: 65 64 0a 20 20 20 20 69 6e 20 61 20 68 69 65 72 ed. in a hier
1cb0: 61 72 63 68 79 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e archy.</li>.<li>
1cc0: 41 20 3c 62 3e 72 65 70 6f 73 69 74 6f 72 79 3c A <b>repository<
1cd0: 2f 62 3e 20 6b 65 65 70 73 20 61 20 72 65 63 6f /b> keeps a reco
1ce0: 72 64 20 6f 66 20 68 69 73 74 6f 72 69 63 61 6c rd of historical
1cf0: 20 62 61 73 65 6c 69 6e 65 73 2e 3c 2f 6c 69 3e baselines.</li>
1d00: 0a 3c 6c 69 3e 52 65 70 6f 73 69 74 6f 72 69 65 .<li>Repositorie
1d10: 73 20 73 68 61 72 65 20 74 68 65 69 72 20 63 68 s share their ch
1d20: 61 6e 67 65 73 20 75 73 69 6e 67 20 3c 62 3e 70 anges using <b>p
1d30: 75 73 68 3c 2f 62 3e 2c 20 3c 62 3e 70 75 6c 6c ush</b>, <b>pull
1d40: 3c 2f 62 3e 2c 0a 20 20 20 20 3c 62 3e 73 79 6e </b>,. <b>syn
1d50: 63 3c 2f 62 3e 2c 20 61 6e 64 20 3c 62 3e 63 6c c</b>, and <b>cl
1d60: 6f 6e 65 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0a 3c 6c one</b>.</li>.<l
1d70: 69 3e 41 20 70 61 72 74 69 63 75 6c 61 72 20 76 i>A particular v
1d80: 65 72 73 69 6f 6e 20 6f 66 20 61 20 70 61 72 74 ersion of a part
1d90: 69 63 75 6c 61 72 20 66 69 6c 65 20 69 73 20 61 icular file is a
1da0: 6e 20 3c 62 3e 61 72 74 69 66 61 63 74 3c 2f 62 n <b>artifact</b
1db0: 3e 0a 20 20 20 20 74 68 61 74 20 69 73 20 69 64 >. that is id
1dc0: 65 6e 74 69 66 69 65 64 20 62 79 20 61 20 3c 62 entified by a <b
1dd0: 3e 55 55 49 44 3c 2f 62 3e 2e 3c 2f 6c 69 3e 0a >UUID</b>.</li>.
1de0: 3c 6c 69 3e 41 72 74 69 66 61 63 74 73 20 74 72 <li>Artifacts tr
1df0: 61 63 6b 65 64 20 62 79 20 66 6f 73 73 69 6c 20 acked by fossil
1e00: 61 72 65 20 69 6e 68 65 72 65 6e 74 6c 79 20 69 are inherently i
1e10: 6d 6d 75 74 61 62 6c 65 2e 3c 2f 6c 69 3e 0a 3c mmutable.</li>.<
1e20: 6c 69 3e 46 6f 73 73 69 6c 20 61 75 74 6f 6d 61 li>Fossil automa
1e30: 74 69 63 61 6c 6c 79 20 67 65 6e 65 72 61 74 65 tically generate
1e40: 73 20 61 20 3c 62 3e 6d 61 6e 69 66 65 73 74 3c s a <b>manifest<
1e50: 2f 62 3e 20 66 69 6c 65 20 74 68 61 74 20 69 64 /b> file that id
1e60: 65 6e 74 69 66 69 65 73 0a 20 20 20 20 65 76 65 entifies. eve
1e70: 72 79 20 61 72 74 69 66 61 63 74 20 69 6e 20 61 ry artifact in a
1e80: 20 62 61 73 65 6c 69 6e 65 2e 3c 2f 6c 69 3e 0a baseline.</li>.
1e90: 3c 6c 69 3e 54 68 65 20 55 55 49 44 20 6f 66 20 <li>The UUID of
1ea0: 74 68 65 20 6d 61 6e 69 66 65 73 74 20 69 73 20 the manifest is
1eb0: 74 68 65 20 55 55 49 44 20 6f 66 20 74 68 65 20 the UUID of the
1ec0: 62 61 73 65 6c 69 6e 65 2e 3c 2f 6c 69 3e 0a 3c baseline.</li>.<
1ed0: 2f 75 6c 3e 0a 0a 3c 68 32 3e 33 2e 30 20 46 6f /ul>..<h2>3.0 Fo
1ee0: 73 73 69 6c 20 2d 20 54 68 65 20 50 72 6f 67 72 ssil - The Progr
1ef0: 61 6d 3c 2f 68 32 3e 0a 0a 3c 70 3e 46 6f 73 73 am</h2>..<p>Foss
1f00: 69 6c 20 69 73 20 73 6f 66 74 77 61 72 65 2e 20 il is software.
1f10: 20 54 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 The implementat
1f20: 69 6f 6e 20 6f 66 20 66 6f 73 73 69 6c 20 69 73 ion of fossil is
1f30: 20 69 6e 20 74 68 65 20 66 6f 72 6d 0a 6f 66 20 in the form.of
1f40: 61 20 73 69 6e 67 6c 65 20 65 78 65 63 75 74 61 a single executa
1f50: 62 6c 65 20 6e 61 6d 65 64 20 22 66 6f 73 73 69 ble named "fossi
1f60: 6c 22 2e 20 20 54 6f 20 69 6e 73 74 61 6c 6c 20 l". To install
1f70: 66 6f 73 73 69 6c 20 6f 6e 20 79 6f 75 72 20 73 fossil on your s
1f80: 79 73 74 65 6d 2c 0a 61 6c 6c 20 79 6f 75 20 68 ystem,.all you h
1f90: 61 76 65 20 74 6f 20 64 6f 20 69 73 20 6f 62 74 ave to do is obt
1fa0: 61 69 6e 20 61 20 63 6f 70 79 20 6f 66 20 74 68 ain a copy of th
1fb0: 69 73 20 6f 6e 65 20 65 78 65 63 75 74 61 62 6c is one executabl
1fc0: 65 20 66 69 6c 65 20 28 65 69 74 68 65 72 0a 62 e file (either.b
1fd0: 79 20 64 6f 77 6e 6c 6f 61 64 69 6e 67 20 61 20 y downloading a
1fe0: 70 72 65 63 6f 6d 70 69 6c 65 64 20 76 65 72 73 precompiled vers
1ff0: 69 6f 6e 20 6f 72 20 63 6f 6d 70 69 6c 69 6e 67 ion or compiling
2000: 20 69 74 20 79 6f 75 72 73 65 6c 66 29 20 61 6e it yourself) an
2010: 64 20 74 68 65 6e 0a 70 75 74 74 69 6e 67 20 74 d then.putting t
2020: 68 61 74 20 66 69 6c 65 20 73 6f 6d 65 77 68 65 hat file somewhe
2030: 72 65 20 6f 6e 20 79 6f 75 72 20 50 41 54 48 2e re on your PATH.
2040: 3c 2f 70 3e 0a 0a 3c 70 3e 46 6f 73 73 69 6c 20 </p>..<p>Fossil
2050: 69 73 20 63 6f 6d 70 6c 65 74 65 6c 79 20 73 65 is completely se
2060: 6c 66 2d 63 6f 6e 74 61 69 6e 65 64 2e 20 20 49 lf-contained. I
2070: 74 20 69 73 20 6e 6f 74 20 6e 65 63 65 73 73 61 t is not necessa
2080: 72 79 20 74 6f 0a 69 6e 73 74 61 6c 6c 20 61 6e ry to.install an
2090: 79 20 6f 74 68 65 72 20 73 6f 66 74 77 61 72 65 y other software
20a0: 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 75 73 65 in order to use
20b0: 20 66 6f 73 73 69 6c 2e 20 20 59 6f 75 20 64 6f fossil. You do
20c0: 20 3c 75 3e 6e 6f 74 3c 2f 75 3e 20 6e 65 65 64 <u>not</u> need
20d0: 0a 43 56 53 2c 20 67 7a 69 70 2c 20 64 69 66 66 .CVS, gzip, diff
20e0: 2c 20 72 73 79 6e 63 2c 20 50 79 74 68 6f 6e 2c , rsync, Python,
20f0: 20 50 65 72 6c 2c 20 54 63 6c 2c 20 4a 61 76 61 Perl, Tcl, Java
2100: 2c 20 61 70 61 63 68 65 2c 20 50 6f 73 74 67 72 , apache, Postgr
2110: 65 53 51 4c 2c 20 4d 79 53 51 4c 2c 0a 53 51 4c eSQL, MySQL,.SQL
2120: 69 74 65 2c 20 70 61 74 63 68 2c 20 6f 72 20 61 ite, patch, or a
2130: 6e 79 20 73 69 6d 69 6c 61 72 20 73 6f 66 74 77 ny similar softw
2140: 61 72 65 20 6f 6e 20 79 6f 75 72 20 73 79 73 74 are on your syst
2150: 65 6d 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 75 em in order to u
2160: 73 65 0a 66 6f 73 73 69 6c 20 65 66 66 65 63 74 se.fossil effect
2170: 69 76 65 6c 79 2e 20 20 59 6f 75 20 77 69 6c 6c ively. You will
2180: 20 77 61 6e 74 20 74 6f 20 68 61 76 65 20 73 6f want to have so
2190: 6d 65 20 6b 69 6e 64 20 6f 66 20 74 65 78 74 20 me kind of text
21a0: 65 64 69 74 6f 72 0a 66 6f 72 20 65 6e 74 65 72 editor.for enter
21b0: 69 6e 67 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d ing check-in com
21c0: 6d 65 6e 74 73 2e 20 20 46 6f 73 73 69 6c 20 77 ments. Fossil w
21d0: 69 6c 6c 20 75 73 65 20 77 68 61 74 65 76 65 72 ill use whatever
21e0: 20 74 65 78 74 20 65 64 69 74 6f 72 0a 69 73 20 text editor.is
21f0: 69 64 65 6e 74 69 66 69 65 64 20 62 79 20 79 6f identified by yo
2200: 75 72 20 56 49 53 55 41 4c 20 65 6e 76 69 72 6f ur VISUAL enviro
2210: 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 2e 20 nment variable.
2220: 20 46 6f 73 73 69 6c 20 77 69 6c 6c 20 61 6c 73 Fossil will als
2230: 6f 0a 75 73 65 20 47 50 47 20 74 6f 20 63 6c 65 o.use GPG to cle
2240: 61 72 73 69 67 6e 20 79 6f 75 72 20 6d 61 6e 69 arsign your mani
2250: 66 65 73 74 73 20 69 66 20 79 6f 75 20 68 61 70 fests if you hap
2260: 70 65 6e 20 74 6f 20 68 61 76 65 20 69 74 20 69 pen to have it i
2270: 6e 73 74 61 6c 6c 65 64 2c 0a 62 75 74 20 66 6f nstalled,.but fo
2280: 73 73 69 6c 20 77 69 6c 6c 20 73 6b 69 70 20 74 ssil will skip t
2290: 68 61 74 20 73 74 65 70 20 69 66 20 47 50 47 20 hat step if GPG
22a0: 6d 69 73 73 69 6e 67 20 66 72 6f 6d 20 79 6f 75 missing from you
22b0: 72 20 73 79 73 74 65 6d 2e 0a 59 6f 75 20 63 61 r system..You ca
22c0: 6e 20 6f 70 74 69 6f 6e 61 6c 6c 79 20 73 65 74 n optionally set
22d0: 20 75 70 20 66 6f 73 73 69 6c 20 74 6f 20 75 73 up fossil to us
22e0: 65 20 65 78 74 65 72 6e 61 6c 20 22 64 69 66 66 e external "diff
22f0: 22 20 70 72 6f 67 72 61 6d 73 2c 20 0a 74 68 6f " programs, .tho
2300: 75 67 68 20 53 51 4c 69 74 65 20 68 61 73 20 61 ugh SQLite has a
2310: 6e 20 65 78 63 65 6c 6c 65 6e 74 20 62 75 69 6c n excellent buil
2320: 74 2d 69 6e 20 22 64 69 66 66 22 20 61 6c 67 6f t-in "diff" algo
2330: 72 69 74 68 6d 20 74 68 61 74 20 77 6f 72 6b 73 rithm that works
2340: 0a 66 69 6e 65 20 66 6f 72 20 6d 6f 73 74 20 70 .fine for most p
2350: 65 6f 70 6c 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 eople.</p>..<p>T
2360: 6f 20 75 6e 69 6e 73 74 61 6c 6c 20 66 6f 73 73 o uninstall foss
2370: 69 6c 2c 20 73 69 6d 70 6c 79 20 64 65 6c 65 74 il, simply delet
2380: 65 20 74 68 65 20 65 78 65 63 75 74 61 62 6c 65 e the executable
2390: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 6f 20 75 70 67 .</p>..<p>To upg
23a0: 72 61 64 65 20 61 6e 20 6f 6c 64 65 72 20 76 65 rade an older ve
23b0: 72 73 69 6f 6e 20 6f 66 20 66 6f 73 73 69 6c 20 rsion of fossil
23c0: 74 6f 20 61 20 6e 65 77 65 72 20 76 65 72 73 69 to a newer versi
23d0: 6f 6e 2c 20 6a 75 73 74 0a 72 65 70 6c 61 63 65 on, just.replace
23e0: 20 74 68 65 20 6f 6c 64 20 65 78 65 63 75 74 61 the old executa
23f0: 62 6c 65 20 77 69 74 68 20 74 68 65 20 6e 65 77 ble with the new
2400: 20 6f 6e 65 2e 20 20 59 6f 75 20 6d 69 67 68 74 one. You might
2410: 20 6e 65 65 64 20 74 6f 20 0a 72 75 6e 20 61 20 need to .run a
2420: 6f 6e 65 2d 74 69 6d 65 20 63 6f 6d 6d 61 6e 64 one-time command
2430: 20 74 6f 20 72 65 73 74 72 75 63 74 75 72 65 20 to restructure
2440: 79 6f 75 72 20 72 65 70 6f 73 69 74 6f 72 69 65 your repositorie
2450: 73 20 61 66 74 65 72 0a 61 6e 20 75 70 67 72 61 s after.an upgra
2460: 64 65 2e 20 20 43 68 65 63 6b 20 74 68 65 20 69 de. Check the i
2470: 6e 73 74 72 75 63 74 69 6f 6e 73 20 74 68 61 74 nstructions that
2480: 20 63 6f 6d 65 20 77 69 74 68 20 74 68 65 20 75 come with the u
2490: 70 67 72 61 64 65 0a 66 6f 72 20 64 65 74 61 69 pgrade.for detai
24a0: 6c 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 6f 20 75 ls.</p>..<p>To u
24b0: 73 65 20 66 6f 73 73 69 6c 2c 20 73 69 6d 70 6c se fossil, simpl
24c0: 79 20 74 79 70 65 20 74 68 65 20 6e 61 6d 65 20 y type the name
24d0: 6f 66 20 74 68 65 20 65 78 65 63 75 74 61 62 6c of the executabl
24e0: 65 20 69 6e 20 79 6f 75 72 0a 73 68 65 6c 6c 2c e in your.shell,
24f0: 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 6f 6e 65 followed by one
2500: 20 6f 66 20 74 68 65 20 76 61 72 69 6f 75 73 20 of the various
2510: 62 75 69 6c 74 2d 69 6e 20 63 6f 6d 6d 61 6e 64 built-in command
2520: 73 20 61 6e 64 0a 61 72 67 75 6d 65 6e 74 73 20 s and.arguments
2530: 61 70 70 72 6f 70 72 69 61 74 65 20 66 6f 72 20 appropriate for
2540: 74 68 61 74 20 63 6f 6d 6d 61 6e 64 2e 20 20 46 that command. F
2550: 6f 72 20 65 78 61 6d 70 6c 65 3a 3c 2f 70 3e 0a or example:</p>.
2560: 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 62 3e .<blockquote><b>
2570: 0a 66 6f 73 73 69 6c 20 68 65 6c 70 0a 3c 2f 62 .fossil help.</b
2580: 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a ></blockquote>..
2590: 3c 70 3e 49 6e 20 74 68 65 20 6e 65 78 74 20 73 <p>In the next s
25a0: 65 63 74 69 6f 6e 2c 20 77 68 65 6e 20 77 65 20 ection, when we
25b0: 73 61 79 20 74 68 69 6e 67 73 20 6c 69 6b 65 20 say things like
25c0: 22 75 73 65 20 74 68 65 20 3c 62 3e 68 65 6c 70 "use the <b>help
25d0: 3c 2f 62 3e 0a 63 6f 6d 6d 61 6e 64 22 20 77 65 </b>.command" we
25e0: 20 6d 65 61 6e 20 74 6f 20 75 73 65 20 74 68 65 mean to use the
25f0: 20 63 6f 6d 6d 61 6e 64 20 6e 61 6d 65 20 22 68 command name "h
2600: 65 6c 70 22 20 61 73 20 74 68 65 20 66 69 72 73 elp" as the firs
2610: 74 0a 74 6f 6b 65 6e 20 61 66 74 65 72 20 74 68 t.token after th
2620: 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 66 6f e name of the fo
2630: 73 73 69 6c 20 65 78 65 63 75 74 61 62 6c 65 2c ssil executable,
2640: 20 61 73 20 73 68 6f 77 6e 20 61 62 6f 76 65 2e as shown above.
2650: 3c 2f 70 3e 0a 0a 3c 68 32 3e 34 2e 30 20 57 6f </p>..<h2>4.0 Wo
2660: 72 6b 66 6c 6f 77 3c 2f 68 32 3e 0a 0a 3c 69 6d rkflow</h2>..<im
2670: 67 20 73 72 63 3d 22 63 6f 6e 63 65 70 74 32 2e g src="concept2.
2680: 67 69 66 22 20 61 6c 69 67 6e 3d 22 72 69 67 68 gif" align="righ
2690: 74 22 20 68 73 70 61 63 65 3d 22 31 30 22 3e 0a t" hspace="10">.
26a0: 0a 3c 70 3e 46 6f 73 73 69 6c 20 68 61 73 20 74 .<p>Fossil has t
26b0: 77 6f 20 6d 6f 64 65 73 20 6f 66 20 6f 70 65 72 wo modes of oper
26c0: 61 74 69 6f 6e 3a 20 22 61 75 74 6f 73 79 6e 63 ation: "autosync
26d0: 22 20 61 6e 64 20 22 6e 6f 6e 2d 61 75 74 6f 73 " and "non-autos
26e0: 79 6e 63 22 2e 0a 41 75 74 6f 73 79 6e 63 20 6d ync"..Autosync m
26f0: 6f 64 65 20 77 6f 72 6b 73 20 73 6f 6d 65 74 68 ode works someth
2700: 69 6e 67 20 6c 69 6b 65 20 43 56 53 20 6f 72 20 ing like CVS or
2710: 53 56 4e 20 69 6e 20 74 68 61 74 20 69 74 20 61 SVN in that it a
2720: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 0a 6b 65 65 utomatically.kee
2730: 70 73 20 79 6f 75 72 20 77 6f 72 6b 20 69 6e 20 ps your work in
2740: 73 79 6e 63 20 77 69 74 68 20 74 68 65 20 63 65 sync with the ce
2750: 6e 74 72 61 6c 20 73 65 72 76 65 72 2e 20 20 4e ntral server. N
2760: 6f 6e 2d 61 75 74 6f 73 79 6e 63 20 69 73 0a 6d on-autosync is.m
2770: 6f 72 65 20 6c 69 6b 65 20 47 49 54 2c 20 6f 72 ore like GIT, or
2780: 20 42 69 74 6b 65 65 70 65 72 20 69 6e 20 74 68 Bitkeeper in th
2790: 61 74 20 79 6f 75 72 20 6c 6f 63 61 6c 20 72 65 at your local re
27a0: 70 6f 73 69 74 6f 72 79 20 64 65 76 65 6c 6f 70 pository develop
27b0: 73 0a 69 6e 64 65 70 65 6e 64 65 6e 74 6c 79 20 s.independently
27c0: 6f 66 20 79 6f 75 72 20 63 6f 77 6f 72 6b 65 72 of your coworker
27d0: 73 20 61 6e 64 20 79 6f 75 20 73 68 61 72 65 20 s and you share
27e0: 79 6f 75 72 20 63 68 61 6e 67 65 73 20 6d 61 6e your changes man
27f0: 75 61 6c 6c 79 2e 0a 54 68 65 20 69 6e 74 65 72 ually..The inter
2800: 65 73 74 69 6e 67 20 74 68 69 6e 67 20 61 62 6f esting thing abo
2810: 75 74 20 66 6f 73 73 69 6c 20 69 73 20 74 68 61 ut fossil is tha
2820: 74 20 69 74 20 73 75 70 70 6f 72 74 73 20 62 6f t it supports bo
2830: 74 68 20 61 75 74 6f 73 79 6e 63 0a 61 6e 64 20 th autosync.and
2840: 6e 6f 6e 2d 61 75 74 6f 73 79 6e 63 20 77 6f 72 non-autosync wor
2850: 6b 20 66 6c 6f 77 73 2e 3c 2f 70 3e 0a 0a 3c 70 k flows.</p>..<p
2860: 3e 54 68 65 20 64 65 66 61 75 6c 74 20 73 65 74 >The default set
2870: 74 69 6e 67 20 66 6f 72 20 66 6f 73 73 69 6c 20 ting for fossil
2880: 69 73 20 74 6f 20 62 65 20 69 6e 20 61 75 74 6f is to be in auto
2890: 73 79 6e 63 20 6d 6f 64 65 2e 20 20 59 6f 75 0a sync mode. You.
28a0: 63 61 6e 20 63 68 61 6e 67 65 20 74 68 65 20 61 can change the a
28b0: 75 74 6f 73 79 6e 63 20 73 65 74 74 69 6e 67 20 utosync setting
28c0: 6f 72 20 63 68 65 63 6b 20 74 68 65 20 63 75 72 or check the cur
28d0: 72 65 6e 74 20 61 75 74 6f 73 79 6e 63 0a 73 65 rent autosync.se
28e0: 74 74 69 6e 67 20 75 73 69 6e 67 20 63 6f 6d 6d tting using comm
28f0: 61 6e 64 73 20 6c 69 6b 65 3a 3c 2f 70 3e 0a 0a ands like:</p>..
2900: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 62 3e <blockquote>.<b>
2910: 66 6f 73 73 69 6c 20 73 65 74 74 69 6e 67 20 61 fossil setting a
2920: 75 74 6f 73 79 6e 63 20 6f 6e 3c 62 72 3e 0a 66 utosync on<br>.f
2930: 6f 73 73 69 6c 20 73 65 74 74 69 6e 67 20 61 75 ossil setting au
2940: 74 6f 73 79 6e 63 20 6f 66 66 3c 62 72 3e 0a 3c tosync off<br>.<
2950: 62 3e 66 6f 73 73 69 6c 20 73 65 74 74 69 6e 67 b>fossil setting
2960: 73 3c 2f 62 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f s</b>.</blockquo
2970: 74 65 3e 0a 0a 3c 70 3e 42 79 20 64 65 66 61 75 te>..<p>By defau
2980: 6c 74 2c 20 66 6f 73 73 69 6c 20 72 75 6e 73 20 lt, fossil runs
2990: 77 69 74 68 20 61 75 74 6f 73 79 6e 63 20 6d 6f with autosync mo
29a0: 64 65 20 74 75 72 6e 65 64 20 6f 6e 2e 20 20 54 de turned on. T
29b0: 68 65 0a 61 75 74 68 6f 72 73 20 66 69 6e 64 20 he.authors find
29c0: 74 68 61 74 20 70 72 6f 6a 65 63 74 73 20 72 75 that projects ru
29d0: 6e 20 6d 6f 72 65 20 73 6d 6f 6f 74 68 6c 79 20 n more smoothly
29e0: 77 68 65 6e 20 61 75 74 6f 73 79 6e 63 20 69 73 when autosync is
29f0: 20 6f 6e 6c 79 0a 64 69 73 61 62 6c 65 64 20 77 only.disabled w
2a00: 68 65 6e 20 6f 66 66 2d 6e 65 74 77 6f 72 6b 2e hen off-network.
2a10: 3c 2f 70 3e 0a 0a 3c 68 33 3e 34 2e 31 20 41 75 </p>..<h3>4.1 Au
2a20: 74 6f 73 79 6e 63 20 57 6f 72 6b 66 6c 6f 77 3c tosync Workflow<
2a30: 2f 68 33 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 3e 3c /h3>..<ol>.<li><
2a40: 70 3e 0a 45 73 74 61 62 6c 69 73 68 20 61 20 6c p>.Establish a l
2a50: 6f 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 20 ocal repository
2a60: 75 73 69 6e 67 20 65 69 74 68 65 72 20 74 68 65 using either the
2a70: 20 3c 62 3e 6e 65 77 3c 2f 62 3e 20 63 6f 6d 6d <b>new</b> comm
2a80: 61 6e 64 0a 74 6f 20 73 74 61 72 74 20 61 20 6e and.to start a n
2a90: 65 77 20 70 72 6f 6a 65 63 74 2c 20 6f 72 20 74 ew project, or t
2aa0: 68 65 20 3c 62 3e 63 6c 6f 6e 65 3c 2f 62 3e 20 he <b>clone</b>
2ab0: 63 6f 6d 6d 61 6e 64 20 74 6f 20 6d 61 6b 65 20 command to make
2ac0: 61 20 63 6c 6f 6e 65 0a 6f 66 20 61 20 72 65 70 a clone.of a rep
2ad0: 6f 73 69 74 6f 72 79 20 66 6f 72 20 61 6e 20 65 ository for an e
2ae0: 78 69 73 74 69 6e 67 20 70 72 6f 6a 65 63 74 2e xisting project.
2af0: 20 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 .</p></li>..<li
2b00: 3e 3c 70 3e 0a 45 73 74 61 62 6c 69 73 68 20 6f ><p>.Establish o
2b10: 6e 65 20 6f 72 20 6d 6f 72 65 20 73 6f 75 72 63 ne or more sourc
2b20: 65 20 74 72 65 65 73 20 62 79 20 63 68 61 6e 67 e trees by chang
2b30: 69 6e 67 20 79 6f 75 72 20 77 6f 72 6b 69 6e 67 ing your working
2b40: 20 64 69 72 65 63 74 6f 72 79 0a 74 6f 20 77 68 directory.to wh
2b50: 65 72 65 20 79 6f 75 20 77 61 6e 74 20 74 68 65 ere you want the
2b60: 20 72 6f 6f 74 20 6f 66 20 74 68 65 20 73 6f 75 root of the sou
2b70: 72 63 65 20 74 72 65 65 20 74 6f 20 62 65 2c 20 rce tree to be,
2b80: 74 68 65 6e 20 69 73 73 75 69 6e 67 0a 74 68 65 then issuing.the
2b90: 20 3c 62 3e 6f 70 65 6e 3c 2f 62 3e 20 63 6f 6d <b>open</b> com
2ba0: 6d 61 6e 64 20 77 69 74 68 20 74 68 65 20 6e 61 mand with the na
2bb0: 6d 65 20 6f 66 20 74 68 65 20 72 65 70 6f 73 69 me of the reposi
2bc0: 74 6f 72 79 20 66 69 6c 65 20 61 73 20 69 74 73 tory file as its
2bd0: 0a 61 72 67 75 6d 65 6e 74 2e 0a 3c 2f 70 3e 3c .argument..</p><
2be0: 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 54 68 /li>..<li><p>.Th
2bf0: 65 20 3c 62 3e 6f 70 65 6e 3c 2f 62 3e 20 63 6f e <b>open</b> co
2c00: 6d 6d 61 6e 64 20 69 6e 20 74 68 65 20 70 72 65 mmand in the pre
2c10: 76 69 6f 75 73 20 73 74 65 70 20 70 6f 70 75 6c vious step popul
2c20: 61 74 65 73 20 79 6f 75 72 20 6c 6f 63 61 6c 20 ates your local
2c30: 73 6f 75 72 63 65 0a 74 72 65 65 20 77 69 74 68 source.tree with
2c40: 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 6c a copy of the l
2c50: 61 74 65 73 74 20 62 61 73 65 6c 69 6e 65 2e 20 atest baseline.
2c60: 20 55 73 75 61 6c 6c 79 20 74 68 69 73 20 69 73 Usually this is
2c70: 20 77 68 61 74 20 79 6f 75 20 77 61 6e 74 2e 0a what you want..
2c80: 49 6e 20 74 68 65 20 72 61 72 65 20 63 61 73 65 In the rare case
2c90: 73 20 77 68 65 72 65 20 69 74 20 69 73 20 6e 6f s where it is no
2ca0: 74 2c 20 75 73 65 20 74 68 65 20 3c 62 3e 75 70 t, use the <b>up
2cb0: 64 61 74 65 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 date</b> command
2cc0: 20 74 6f 0a 73 77 69 74 63 68 20 74 6f 20 61 20 to.switch to a
2cd0: 6e 65 77 20 62 61 73 65 6c 69 6e 65 2e 20 20 55 new baseline. U
2ce0: 73 65 20 74 68 65 20 3c 62 3e 74 69 6d 65 6c 69 se the <b>timeli
2cf0: 6e 65 3c 2f 62 3e 20 6f 72 20 3c 62 3e 6c 65 61 ne</b> or <b>lea
2d00: 76 65 73 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 73 ves</b> commands
2d10: 0a 74 6f 20 69 64 65 6e 74 69 66 79 20 61 6c 74 .to identify alt
2d20: 65 72 6e 61 74 69 76 65 20 62 61 73 65 6c 69 6e ernative baselin
2d30: 65 73 20 74 6f 20 73 77 69 74 63 68 20 74 6f 2e es to switch to.
2d40: 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e .</p></li>..<li>
2d50: 3c 70 3e 0a 45 64 69 74 20 74 68 65 20 63 6f 64 <p>.Edit the cod
2d60: 65 2e 20 20 41 64 64 20 6e 65 77 20 66 69 6c 65 e. Add new file
2d70: 73 20 74 6f 20 74 68 65 20 73 6f 75 72 63 65 20 s to the source
2d80: 74 72 65 65 20 75 73 69 6e 67 20 74 68 65 20 3c tree using the <
2d90: 62 3e 61 64 64 3c 2f 62 3e 0a 63 6f 6d 6d 61 6e b>add</b>.comman
2da0: 64 2e 20 20 4f 6d 69 74 20 66 69 6c 65 73 20 66 d. Omit files f
2db0: 72 6f 6d 20 66 75 74 75 72 65 20 62 61 73 65 6c rom future basel
2dc0: 69 6e 65 73 20 75 73 69 6e 67 20 74 68 65 20 3c ines using the <
2dd0: 62 3e 72 6d 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 b>rm</b> command
2de0: 2e 0a 28 45 76 65 6e 20 77 68 65 6e 20 79 6f 75 ..(Even when you
2df0: 20 72 65 6d 6f 76 65 20 66 69 6c 65 73 20 66 72 remove files fr
2e00: 6f 6d 20 66 75 74 75 72 65 20 62 61 73 65 6c 69 om future baseli
2e10: 6e 65 73 2c 20 74 68 6f 73 65 20 66 69 6c 65 73 nes, those files
2e20: 20 63 6f 6e 74 69 6e 75 65 0a 74 6f 20 65 78 69 continue.to exi
2e30: 73 74 20 69 6e 20 68 69 73 74 6f 72 69 63 61 6c st in historical
2e40: 20 62 61 73 65 6c 69 6e 65 73 2e 29 20 20 54 65 baselines.) Te
2e50: 73 74 20 79 6f 75 72 20 63 68 61 6e 67 65 73 2e st your changes.
2e60: 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e .</p></li>..<li>
2e70: 3c 70 3e 0a 43 72 65 61 74 65 20 61 20 6e 65 77 <p>.Create a new
2e80: 20 62 61 73 65 6c 69 6e 65 20 75 73 69 6e 67 20 baseline using
2e90: 74 68 65 20 3c 62 3e 63 6f 6d 6d 69 74 3c 2f 62 the <b>commit</b
2ea0: 3e 20 63 6f 6d 6d 61 6e 64 2e 20 20 59 6f 75 20 > command. You
2eb0: 77 69 6c 6c 20 62 65 20 70 72 6f 6d 70 74 65 64 will be prompted
2ec0: 0a 66 6f 72 20 61 20 63 68 65 63 6b 2d 69 6e 20 .for a check-in
2ed0: 63 6f 6d 6d 65 6e 74 20 61 6e 64 20 61 6c 73 6f comment and also
2ee0: 20 66 6f 72 20 79 6f 75 72 20 47 50 47 20 6b 65 for your GPG ke
2ef0: 79 20 69 66 20 79 6f 75 20 68 61 76 65 20 47 50 y if you have GP
2f00: 47 20 69 6e 73 74 61 6c 6c 65 64 2e 0a 54 68 65 G installed..The
2f10: 20 63 6f 6d 6d 69 74 20 63 6f 70 69 65 73 20 74 commit copies t
2f20: 68 65 20 65 64 69 74 73 20 79 6f 75 20 68 61 76 he edits you hav
2f30: 65 20 6d 61 64 65 20 69 6e 20 79 6f 75 72 20 6c e made in your l
2f40: 6f 63 61 6c 20 73 6f 75 72 63 65 0a 74 72 65 65 ocal source.tree
2f50: 20 69 6e 74 6f 20 79 6f 75 72 20 6c 6f 63 61 6c into your local
2f60: 20 72 65 70 6f 73 69 74 6f 72 79 2e 20 20 41 66 repository. Af
2f70: 74 65 72 20 79 6f 75 72 20 63 6f 6d 6d 69 74 20 ter your commit
2f80: 63 6f 6d 70 6c 65 74 65 73 2c 20 66 6f 73 73 69 completes, fossi
2f90: 6c 20 77 69 6c 6c 0a 61 75 74 6f 6d 61 74 69 63 l will.automatic
2fa0: 61 6c 6c 79 20 3c 62 3e 70 75 73 68 3c 2f 62 3e ally <b>push</b>
2fb0: 20 79 6f 75 72 20 63 68 61 6e 67 65 73 20 62 61 your changes ba
2fc0: 63 6b 20 74 6f 20 74 68 65 20 73 65 72 76 65 72 ck to the server
2fd0: 0a 79 6f 75 20 63 6c 6f 6e 65 64 20 66 72 6f 6d .you cloned from
2fe0: 20 6f 72 20 77 68 61 74 65 76 65 72 20 73 65 72 or whatever ser
2ff0: 76 65 72 20 79 6f 75 20 6d 6f 73 74 20 72 65 63 ver you most rec
3000: 65 6e 74 6c 79 20 73 79 6e 63 65 64 20 77 69 74 ently synced wit
3010: 68 2e 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c h..</p></li>..<l
3020: 69 3e 3c 70 3e 0a 57 68 65 6e 20 79 6f 75 72 20 i><p>.When your
3030: 63 6f 77 6f 72 6b 65 72 73 20 6d 61 6b 65 20 74 coworkers make t
3040: 68 65 69 72 20 6f 77 6e 20 63 68 61 6e 67 65 73 heir own changes
3050: 2c 20 79 6f 75 20 63 61 6e 20 6d 65 72 67 65 20 , you can merge
3060: 74 68 6f 73 65 20 63 68 61 6e 67 65 73 0a 69 6e those changes.in
3070: 74 6f 20 79 6f 75 72 20 6c 6f 63 61 6c 20 6c 6f to your local lo
3080: 63 61 6c 20 73 6f 75 72 63 65 20 74 72 65 65 20 cal source tree
3090: 75 73 69 6e 67 20 74 68 65 20 3c 62 3e 75 70 64 using the <b>upd
30a0: 61 74 65 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 2e ate</b> command.
30b0: 20 20 0a 49 6e 20 61 75 74 6f 73 79 6e 63 20 6d .In autosync m
30c0: 6f 64 65 2c 20 3c 62 3e 75 70 64 61 74 65 3c 2f ode, <b>update</
30d0: 62 3e 20 77 69 6c 6c 20 66 69 72 73 74 20 67 6f b> will first go
30e0: 20 62 61 63 6b 20 74 6f 20 74 68 65 20 73 65 72 back to the ser
30f0: 76 65 72 20 79 6f 75 0a 63 6c 6f 6e 65 64 20 66 ver you.cloned f
3100: 72 6f 6d 20 6f 72 20 77 69 74 68 20 77 68 69 63 rom or with whic
3110: 68 20 79 6f 75 20 6d 6f 73 74 20 72 65 63 65 6e h you most recen
3120: 74 6c 79 20 73 79 6e 63 65 64 2c 20 61 6e 64 20 tly synced, and
3130: 70 75 6c 6c 20 64 6f 77 6e 20 61 6c 6c 0a 72 65 pull down all.re
3140: 63 65 6e 74 20 63 68 61 6e 67 65 73 20 69 6e 74 cent changes int
3150: 6f 20 79 6f 75 72 20 6c 6f 63 61 6c 20 72 65 70 o your local rep
3160: 6f 73 69 74 6f 72 79 2e 20 20 54 68 65 6e 20 69 ository. Then i
3170: 74 20 77 69 6c 6c 20 6d 65 72 67 65 20 72 65 63 t will merge rec
3180: 65 6e 74 0a 63 68 61 6e 67 65 73 20 69 6e 74 6f ent.changes into
3190: 20 79 6f 75 72 20 6c 6f 63 61 6c 20 73 6f 75 72 your local sour
31a0: 63 65 20 74 72 65 65 2e 20 20 49 66 20 79 6f 75 ce tree. If you
31b0: 20 64 6f 20 61 6e 20 3c 62 3e 75 70 64 61 74 65 do an <b>update
31c0: 3c 2f 62 3e 20 61 6e 64 0a 66 69 6e 64 20 74 68 </b> and.find th
31d0: 61 74 20 69 74 20 6d 65 73 73 65 73 20 73 6f 6d at it messes som
31e0: 65 74 68 69 6e 67 20 75 70 20 69 6e 20 79 6f 75 ething up in you
31f0: 72 20 73 6f 75 72 63 65 20 74 72 65 65 20 28 70 r source tree (p
3200: 65 72 68 61 70 73 20 61 20 63 6f 2d 77 6f 72 6b erhaps a co-work
3210: 65 72 0a 63 68 65 63 6b 65 64 20 69 6e 20 69 6e er.checked in in
3220: 63 6f 6d 70 61 74 69 62 6c 65 20 63 68 61 6e 67 compatible chang
3230: 65 73 29 20 79 6f 75 20 63 61 6e 20 75 73 65 20 es) you can use
3240: 74 68 65 20 3c 62 3e 75 6e 64 6f 3c 2f 62 3e 20 the <b>undo</b>
3250: 63 6f 6d 6d 61 6e 64 20 0a 74 6f 20 62 61 63 6b command .to back
3260: 20 6f 75 74 20 74 68 65 20 63 68 61 6e 67 65 73 out the changes
3270: 2e 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 ..</p></li>..<li
3280: 3e 3c 70 3e 0a 52 65 70 65 61 74 20 61 6c 6c 20 ><p>.Repeat all
3290: 6f 66 20 74 68 65 20 61 62 6f 76 65 20 75 6e 74 of the above unt
32a0: 69 6c 20 79 6f 75 20 68 61 76 65 20 67 65 6e 65 il you have gene
32b0: 72 61 74 65 64 20 67 72 65 61 74 20 73 6f 66 74 rated great soft
32c0: 77 61 72 65 2e 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a ware..</p></li>.
32d0: 3c 2f 6f 6c 3e 0a 0a 3c 68 33 3e 34 2e 32 20 4e </ol>..<h3>4.2 N
32e0: 6f 6e 2d 41 75 74 6f 73 79 6e 63 20 57 6f 72 6b on-Autosync Work
32f0: 66 6c 6f 77 3c 2f 68 33 3e 0a 0a 3c 70 3e 57 68 flow</h3>..<p>Wh
3300: 65 6e 20 61 75 74 6f 73 79 6e 63 20 69 73 20 64 en autosync is d
3310: 69 73 61 62 6c 65 64 2c 20 74 68 65 20 3c 62 3e isabled, the <b>
3320: 63 6f 6d 6d 69 74 3c 2f 62 3e 20 63 6f 6d 6d 61 commit</b> comma
3330: 6e 64 20 69 73 20 64 65 63 6f 75 70 6c 65 64 20 nd is decoupled
3340: 66 72 6f 6d 0a 3c 62 3e 70 75 73 68 3c 2f 62 3e from.<b>push</b>
3350: 20 61 6e 64 20 74 68 65 20 3c 62 3e 75 70 64 61 and the <b>upda
3360: 74 65 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 69 te</b> command i
3370: 73 20 64 65 63 6f 75 70 6c 65 64 20 66 72 6f 6d s decoupled from
3380: 20 3c 62 3e 70 75 6c 6c 3c 2f 62 3e 2e 0a 54 68 <b>pull</b>..Th
3390: 61 74 20 6d 65 61 6e 73 20 79 6f 75 20 68 61 76 at means you hav
33a0: 65 20 74 6f 20 64 6f 20 61 20 66 65 77 20 65 78 e to do a few ex
33b0: 74 72 61 20 73 74 65 70 73 20 69 6e 20 6f 72 64 tra steps in ord
33c0: 65 72 20 74 6f 20 61 63 63 6f 6d 70 6c 69 73 68 er to accomplish
33d0: 20 74 68 65 0a 3c 62 3e 70 75 73 68 3c 2f 62 3e the.<b>push</b>
33e0: 20 61 6e 64 20 3c 62 3e 70 75 6c 6c 3c 2f 62 3e and <b>pull</b>
33f0: 20 74 61 73 6b 73 20 6d 61 6e 75 61 6c 6c 79 2e tasks manually.
3400: 3c 2f 70 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 3e 3c </p>..<ol>.<li><
3410: 70 3e 0a 45 73 74 61 62 6c 69 73 68 20 61 20 6c p>.Establish a l
3420: 6f 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 20 ocal repository
3430: 75 73 69 6e 67 20 65 69 74 68 65 72 20 74 68 65 using either the
3440: 20 3c 62 3e 6e 65 77 3c 2f 62 3e 20 63 6f 6d 6d <b>new</b> comm
3450: 61 6e 64 0a 74 6f 20 73 74 61 72 74 20 61 20 6e and.to start a n
3460: 65 77 20 70 72 6f 6a 65 63 74 2c 20 6f 72 20 74 ew project, or t
3470: 68 65 20 3c 62 3e 63 6c 6f 6e 65 3c 2f 62 3e 20 he <b>clone</b>
3480: 63 6f 6d 6d 61 6e 64 20 74 6f 20 6d 61 6b 65 20 command to make
3490: 61 20 63 6c 6f 6e 65 0a 6f 66 20 61 20 72 65 70 a clone.of a rep
34a0: 6f 73 69 74 6f 72 79 20 66 6f 72 20 61 6e 20 65 ository for an e
34b0: 78 69 73 74 69 6e 67 20 70 72 6f 6a 65 63 74 2e xisting project.
34c0: 20 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 73 The default s
34d0: 65 74 74 69 6e 67 20 66 6f 72 0a 61 20 6e 65 77 etting for.a new
34e0: 20 72 65 70 6f 73 69 74 6f 72 79 20 69 73 20 77 repository is w
34f0: 69 74 68 20 61 75 74 6f 73 79 6e 63 20 6f 6e 2c ith autosync on,
3500: 20 73 6f 20 79 6f 75 20 77 69 6c 6c 20 6e 65 65 so you will nee
3510: 64 20 74 6f 20 74 75 72 6e 20 69 74 20 6f 66 66 d to turn it off
3520: 0a 75 73 69 6e 67 20 74 68 65 20 3c 62 3e 73 65 .using the <b>se
3530: 74 74 69 6e 67 20 61 75 74 6f 73 79 6e 63 20 6f tting autosync o
3540: 66 66 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 77 ff</b> command w
3550: 69 74 68 20 61 20 3c 62 3e 2d 52 3c 2f 62 3e 20 ith a <b>-R</b>
3560: 6f 70 74 69 6f 6e 0a 74 6f 20 73 70 65 63 69 66 option.to specif
3570: 79 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 y the repository
3580: 2e 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 ..</p></li>..<li
3590: 3e 3c 70 3e 0a 45 73 74 61 62 6c 69 73 68 20 6f ><p>.Establish o
35a0: 6e 65 20 6f 72 20 6d 6f 72 65 20 73 6f 75 72 63 ne or more sourc
35b0: 65 20 74 72 65 65 73 20 62 79 20 63 68 61 6e 67 e trees by chang
35c0: 69 6e 67 20 79 6f 75 72 20 77 6f 72 6b 69 6e 67 ing your working
35d0: 20 64 69 72 65 63 74 6f 72 79 0a 74 6f 20 77 68 directory.to wh
35e0: 65 72 65 20 79 6f 75 20 77 61 6e 74 20 74 68 65 ere you want the
35f0: 20 72 6f 6f 74 20 6f 66 20 74 68 65 20 73 6f 75 root of the sou
3600: 72 63 65 20 74 72 65 65 20 74 6f 20 62 65 2c 20 rce tree to be,
3610: 74 68 65 6e 20 69 73 73 75 69 6e 67 0a 74 68 65 then issuing.the
3620: 20 3c 62 3e 6f 70 65 6e 3c 2f 62 3e 20 63 6f 6d <b>open</b> com
3630: 6d 61 6e 64 20 77 69 74 68 20 74 68 65 20 6e 61 mand with the na
3640: 6d 65 20 6f 66 20 74 68 65 20 72 65 70 6f 73 69 me of the reposi
3650: 74 6f 72 79 20 66 69 6c 65 20 61 73 20 69 74 73 tory file as its
3660: 0a 61 72 67 75 6d 65 6e 74 2e 0a 3c 2f 70 3e 3c .argument..</p><
3670: 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 54 68 /li>..<li><p>.Th
3680: 65 20 3c 62 3e 6f 70 65 6e 3c 2f 62 3e 20 63 6f e <b>open</b> co
3690: 6d 6d 61 6e 64 20 69 6e 20 74 68 65 20 70 72 65 mmand in the pre
36a0: 76 69 6f 75 73 20 73 74 65 70 20 70 6f 70 75 6c vious step popul
36b0: 61 74 65 73 20 79 6f 75 72 20 6c 6f 63 61 6c 20 ates your local
36c0: 73 6f 75 72 63 65 0a 74 72 65 65 20 77 69 74 68 source.tree with
36d0: 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 6c a copy of the l
36e0: 61 74 65 73 74 20 62 61 73 65 6c 69 6e 65 2e 20 atest baseline.
36f0: 20 55 73 75 61 6c 6c 79 20 74 68 69 73 20 69 73 Usually this is
3700: 20 77 68 61 74 20 79 6f 75 20 77 61 6e 74 2e 0a what you want..
3710: 49 6e 20 74 68 65 20 72 61 72 65 20 63 61 73 65 In the rare case
3720: 73 20 77 68 65 72 65 20 69 74 20 69 73 20 6e 6f s where it is no
3730: 74 2c 20 75 73 65 20 74 68 65 20 3c 62 3e 75 70 t, use the <b>up
3740: 64 61 74 65 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 date</b> command
3750: 20 74 6f 0a 73 77 69 74 63 68 20 74 6f 20 61 20 to.switch to a
3760: 6e 65 77 20 62 61 73 65 6c 69 6e 65 2e 20 20 55 new baseline. U
3770: 73 65 20 74 68 65 20 3c 62 3e 74 69 6d 65 6c 69 se the <b>timeli
3780: 6e 65 3c 2f 62 3e 20 6f 72 20 3c 62 3e 6c 65 61 ne</b> or <b>lea
3790: 76 65 73 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 73 ves</b> commands
37a0: 0a 74 6f 20 69 64 65 6e 74 69 66 79 20 61 6c 74 .to identify alt
37b0: 65 72 6e 61 74 69 76 65 20 62 61 73 65 6c 69 6e ernative baselin
37c0: 65 73 20 74 6f 20 73 77 69 74 63 68 20 74 6f 2e es to switch to.
37d0: 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e .</p></li>..<li>
37e0: 3c 70 3e 0a 45 64 69 74 20 74 68 65 20 63 6f 64 <p>.Edit the cod
37f0: 65 2e 20 20 41 64 64 20 6e 65 77 20 66 69 6c 65 e. Add new file
3800: 73 20 74 6f 20 74 68 65 20 73 6f 75 72 63 65 20 s to the source
3810: 74 72 65 65 20 75 73 69 6e 67 20 74 68 65 20 3c tree using the <
3820: 62 3e 61 64 64 3c 2f 62 3e 0a 63 6f 6d 6d 61 6e b>add</b>.comman
3830: 64 2e 20 20 4f 6d 69 74 20 66 69 6c 65 73 20 66 d. Omit files f
3840: 72 6f 6d 20 66 75 74 75 72 65 20 62 61 73 65 6c rom future basel
3850: 69 6e 65 73 20 75 73 69 6e 67 20 74 68 65 20 3c ines using the <
3860: 62 3e 72 6d 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 b>rm</b> command
3870: 2e 0a 28 45 76 65 6e 20 77 68 65 6e 20 79 6f 75 ..(Even when you
3880: 20 72 65 6d 6f 76 65 20 66 69 6c 65 73 20 66 72 remove files fr
3890: 6f 6d 20 66 75 74 75 72 65 20 62 61 73 65 6c 69 om future baseli
38a0: 6e 65 73 2c 20 74 68 6f 73 65 20 66 69 6c 65 73 nes, those files
38b0: 20 63 6f 6e 74 69 6e 75 65 0a 74 6f 20 65 78 69 continue.to exi
38c0: 73 74 20 69 6e 20 68 69 73 74 6f 72 69 63 61 6c st in historical
38d0: 20 62 61 73 65 6c 69 6e 65 73 2e 29 20 20 54 65 baselines.) Te
38e0: 73 74 20 79 6f 75 72 20 63 68 61 6e 67 65 73 2e st your changes.
38f0: 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e .</p></li>..<li>
3900: 3c 70 3e 0a 43 72 65 61 74 65 20 61 20 6e 65 77 <p>.Create a new
3910: 20 62 61 73 65 6c 69 6e 65 20 75 73 69 6e 67 20 baseline using
3920: 74 68 65 20 3c 62 3e 63 6f 6d 6d 69 74 3c 2f 62 the <b>commit</b
3930: 3e 20 63 6f 6d 6d 61 6e 64 2e 20 20 59 6f 75 20 > command. You
3940: 77 69 6c 6c 20 62 65 20 70 72 6f 6d 70 74 65 64 will be prompted
3950: 0a 66 6f 72 20 61 20 63 68 65 63 6b 2d 69 6e 20 .for a check-in
3960: 63 6f 6d 6d 65 6e 74 20 61 6e 64 20 61 6c 73 6f comment and also
3970: 20 66 6f 72 20 79 6f 75 72 20 47 50 47 20 6b 65 for your GPG ke
3980: 79 20 69 66 20 79 6f 75 20 68 61 76 65 20 47 50 y if you have GP
3990: 47 20 69 6e 73 74 61 6c 6c 65 64 2e 0a 54 68 65 G installed..The
39a0: 20 63 6f 6d 6d 69 74 20 63 6f 70 69 65 73 20 74 commit copies t
39b0: 68 65 20 65 64 69 74 73 20 79 6f 75 20 68 61 76 he edits you hav
39c0: 65 20 6d 61 64 65 20 69 6e 20 79 6f 75 72 20 6c e made in your l
39d0: 6f 63 61 6c 20 73 6f 75 72 63 65 0a 74 72 65 65 ocal source.tree
39e0: 20 69 6e 74 6f 20 79 6f 75 72 20 6c 6f 63 61 6c into your local
39f0: 20 72 65 70 6f 73 69 74 6f 72 79 2e 0a 3c 2f 70 repository..</p
3a00: 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 55 ></li>..<li><p>U
3a10: 73 65 20 74 68 65 20 3c 62 3e 70 75 73 68 3c 2f se the <b>push</
3a20: 62 3e 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 70 75 b> command to pu
3a30: 73 68 20 79 6f 75 72 20 63 68 61 6e 67 65 73 20 sh your changes
3a40: 6f 75 74 20 74 6f 20 61 20 73 65 72 76 65 72 0a out to a server.
3a50: 77 68 65 72 65 20 79 6f 75 72 20 63 6f 2d 77 6f where your co-wo
3a60: 72 6b 65 72 73 20 63 61 6e 20 61 63 63 65 73 73 rkers can access
3a70: 20 74 68 65 6d 2e 0a 3c 2f 70 3e 3c 2f 6c 69 3e them..</p></li>
3a80: 0a 0a 3c 6c 69 3e 3c 70 3e 0a 57 68 65 6e 20 63 ..<li><p>.When c
3a90: 6f 2d 77 6f 72 6b 65 72 73 20 6d 61 6b 65 20 74 o-workers make t
3aa0: 68 65 69 72 20 6f 77 6e 20 63 68 61 6e 67 65 73 heir own changes
3ab0: 2c 20 75 73 65 20 74 68 65 20 3c 62 3e 70 75 6c , use the <b>pul
3ac0: 6c 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 0a 74 6f l</b> command.to
3ad0: 20 70 75 6c 6c 20 74 68 6f 73 65 20 63 68 61 6e pull those chan
3ae0: 67 65 73 20 69 6e 74 6f 20 79 6f 75 72 20 6c 6f ges into your lo
3af0: 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 2e 20 cal repository.
3b00: 20 4e 6f 74 65 20 74 68 61 74 20 3c 62 3e 70 75 Note that <b>pu
3b10: 6c 6c 3c 2f 62 3e 0a 64 6f 65 73 20 6e 6f 74 20 ll</b>.does not
3b20: 6d 6f 76 65 20 74 68 65 20 63 68 61 6e 67 65 73 move the changes
3b30: 20 69 6e 74 6f 20 79 6f 75 72 20 6c 6f 63 61 6c into your local
3b40: 20 73 6f 75 72 63 65 20 74 72 65 65 2c 20 6f 6e source tree, on
3b50: 6c 79 20 69 6e 74 6f 20 79 6f 75 72 0a 6c 6f 63 ly into your.loc
3b60: 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 2e 0a 3c al repository..<
3b70: 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 /p></li>..<li><p
3b80: 3e 0a 4f 6e 63 65 20 63 68 61 6e 67 65 73 20 61 >.Once changes a
3b90: 72 65 20 69 6e 20 79 6f 75 72 20 6c 6f 63 61 6c re in your local
3ba0: 20 72 65 70 6f 73 69 74 6f 72 79 2c 20 75 73 65 repository, use
3bb0: 0a 75 73 65 20 74 68 65 20 3c 62 3e 75 70 64 61 .use the <b>upda
3bc0: 74 65 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 74 te</b> command t
3bd0: 6f 20 6d 65 72 67 65 20 74 68 65 6d 20 74 6f 20 o merge them to
3be0: 79 6f 75 72 20 6c 6f 63 61 6c 20 73 6f 75 72 63 your local sourc
3bf0: 65 20 74 72 65 65 2e 0a 49 66 20 79 6f 75 20 6d e tree..If you m
3c00: 65 72 67 65 20 69 6e 20 73 6f 6d 65 20 63 68 61 erge in some cha
3c10: 6e 67 65 73 20 61 6e 64 20 66 69 6e 64 20 74 68 nges and find th
3c20: 61 74 20 74 68 65 20 63 68 61 6e 67 65 73 20 64 at the changes d
3c30: 6f 20 6e 6f 74 20 77 6f 72 6b 20 6f 75 74 0a 6f o not work out.o
3c40: 72 20 61 72 65 20 6e 6f 74 20 74 6f 20 79 6f 75 r are not to you
3c50: 72 20 6c 69 6b 69 6e 67 2c 20 79 6f 75 20 63 61 r liking, you ca
3c60: 6e 20 62 61 63 6b 20 6f 75 74 20 74 68 65 20 63 n back out the c
3c70: 68 61 6e 67 65 73 20 75 73 69 6e 67 20 74 68 65 hanges using the
3c80: 0a 3c 62 3e 75 6e 64 6f 3c 2f 62 3e 20 63 6f 6d .<b>undo</b> com
3c90: 6d 61 6e 64 2e 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a mand..</p></li>.
3ca0: 0a 3c 6c 69 3e 3c 70 3e 0a 52 65 70 65 61 74 20 .<li><p>.Repeat
3cb0: 61 6c 6c 20 6f 66 20 74 68 65 20 61 62 6f 76 65 all of the above
3cc0: 20 75 6e 74 69 6c 20 79 6f 75 20 68 61 76 65 20 until you have
3cd0: 67 65 6e 65 72 61 74 65 64 20 67 72 65 61 74 20 generated great
3ce0: 73 6f 66 74 77 61 72 65 2e 0a 3c 2f 70 3e 3c 2f software..</p></
3cf0: 6c 69 3e 0a 3c 2f 6f 6c 3e 0a 0a 3c 68 32 3e 35 li>.</ol>..<h2>5
3d00: 2e 30 20 53 65 74 74 69 6e 67 20 55 70 20 41 20 .0 Setting Up A
3d10: 46 6f 73 73 69 6c 20 53 65 72 76 65 72 3c 2f 68 Fossil Server</h
3d20: 32 3e 0a 0a 3c 70 3e 57 69 74 68 20 6f 74 68 65 2>..<p>With othe
3d30: 72 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 r configuration
3d40: 6d 61 6e 61 67 65 6d 65 6e 74 20 73 6f 66 74 77 management softw
3d50: 61 72 65 2c 20 73 65 74 74 69 6e 67 20 75 70 20 are, setting up
3d60: 61 20 73 65 72 76 65 72 20 69 73 0a 61 20 6c 6f a server is.a lo
3d70: 74 20 6f 66 20 77 6f 72 6b 20 61 6e 64 20 6e 6f t of work and no
3d80: 72 6d 61 6c 6c 79 20 74 61 6b 65 73 20 74 69 6d rmally takes tim
3d90: 65 2c 20 70 61 74 69 65 6e 63 65 2c 20 61 6e 64 e, patience, and
3da0: 20 61 20 6c 6f 74 20 6f 66 20 73 79 73 74 65 6d a lot of system
3db0: 0a 6b 6e 6f 77 6c 65 64 67 65 2e 20 20 46 6f 73 .knowledge. Fos
3dc0: 73 69 6c 20 69 73 20 64 65 73 69 67 6e 65 64 20 sil is designed
3dd0: 74 6f 20 61 76 6f 69 64 20 74 68 69 73 20 66 72 to avoid this fr
3de0: 75 73 74 72 61 74 69 6f 6e 2e 20 20 53 65 74 74 ustration. Sett
3df0: 69 6e 67 20 75 70 0a 61 20 73 65 72 76 65 72 20 ing up.a server
3e00: 77 69 74 68 20 66 6f 73 73 69 6c 20 69 73 20 72 with fossil is r
3e10: 69 64 69 63 75 6c 6f 75 73 6c 79 20 65 61 73 79 idiculously easy
3e20: 2e 20 20 59 6f 75 20 68 61 76 65 20 74 68 72 65 . You have thre
3e30: 65 20 6f 70 74 69 6f 6e 73 3a 3c 2f 70 3e 0a 0a e options:</p>..
3e40: 3c 6f 6c 3e 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 53 <ol>.<li><p><b>S
3e50: 65 74 74 69 6e 67 20 75 70 20 61 20 73 74 61 6e etting up a stan
3e60: 64 2d 61 6c 6f 6e 65 20 73 65 72 76 65 72 3c 2f d-alone server</
3e70: 62 3e 3c 2f 70 3e 0a 0a 3c 70 3e 46 72 6f 6d 20 b></p>..<p>From
3e80: 77 69 74 68 69 6e 20 79 6f 75 72 20 73 6f 75 72 within your sour
3e90: 63 65 20 74 72 65 65 20 6a 75 73 74 20 75 73 65 ce tree just use
3ea0: 20 74 68 65 20 3c 62 3e 73 65 72 76 65 72 3c 2f the <b>server</
3eb0: 62 3e 20 63 6f 6d 6d 61 6e 64 20 61 6e 64 0a 66 b> command and.f
3ec0: 6f 73 73 69 6c 20 77 69 6c 6c 20 73 74 61 72 74 ossil will start
3ed0: 20 6c 69 73 74 65 6e 69 6e 67 20 66 6f 72 20 69 listening for i
3ee0: 6e 63 6f 6d 69 6e 67 20 72 65 71 75 65 73 74 73 ncoming requests
3ef0: 20 6f 6e 20 54 43 50 20 70 6f 72 74 20 38 30 38 on TCP port 808
3f00: 30 2e 0a 59 6f 75 20 63 61 6e 20 70 6f 69 6e 74 0..You can point
3f10: 20 79 6f 75 72 20 77 65 62 62 72 6f 77 73 65 72 your webbrowser
3f20: 20 61 74 20 3c 61 20 68 72 65 66 3d 22 68 74 74 at <a href="htt
3f30: 70 3a 2f 2f 6c 6f 63 61 6c 68 6f 73 74 3a 38 30 p://localhost:80
3f40: 38 30 2f 22 3e 0a 68 74 74 70 3a 2f 2f 6c 6f 63 80/">.http://loc
3f50: 61 6c 68 6f 73 74 3a 38 30 38 30 2f 3c 2f 61 3e alhost:8080/</a>
3f60: 20 61 6e 64 20 62 65 67 69 6e 20 65 78 70 6c 6f and begin explo
3f70: 72 69 6e 67 2e 20 20 4f 72 20 79 6f 75 72 20 63 ring. Or your c
3f80: 6f 77 6f 72 6b 65 72 73 0a 63 61 6e 20 64 6f 20 oworkers.can do
3f90: 70 75 73 68 65 73 20 6f 72 20 70 75 6c 6c 73 20 pushes or pulls
3fa0: 61 67 61 69 6e 73 74 20 79 6f 75 72 20 73 65 72 against your ser
3fb0: 76 65 72 2e 20 20 55 73 65 20 74 68 65 20 3c 62 ver. Use the <b
3fc0: 3e 2d 2d 70 6f 72 74 3c 2f 62 3e 0a 6f 70 74 69 >--port</b>.opti
3fd0: 6f 6e 20 74 6f 20 74 68 65 20 73 65 72 76 65 72 on to the server
3fe0: 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 73 70 65 63 command to spec
3ff0: 69 66 79 20 61 20 64 69 66 66 65 72 65 6e 74 20 ify a different
4000: 54 43 50 20 70 6f 72 74 2e 20 20 49 66 0a 79 6f TCP port. If.yo
4010: 75 20 64 6f 20 6e 6f 74 20 68 61 76 65 20 61 20 u do not have a
4020: 6c 6f 63 61 6c 20 73 6f 75 72 63 65 20 74 72 65 local source tre
4030: 65 2c 20 75 73 65 20 74 68 65 20 3c 62 3e 2d 52 e, use the <b>-R
4040: 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e </b> command-lin
4050: 65 0a 6f 70 74 69 6f 6e 20 74 6f 20 73 70 65 63 e.option to spec
4060: 69 66 79 20 74 68 65 20 72 65 70 6f 73 69 74 6f ify the reposito
4070: 72 79 20 66 69 6c 65 2e 3c 2f 70 3e 0a 0a 3c 70 ry file.</p>..<p
4080: 3e 41 20 73 74 61 6e 64 2d 61 6c 6f 6e 65 20 73 >A stand-alone s
4090: 65 72 76 65 72 20 69 73 20 61 20 67 72 65 61 74 erver is a great
40a0: 20 77 61 79 20 74 6f 20 73 65 74 20 6f 66 20 74 way to set of t
40b0: 72 61 6e 73 69 65 6e 74 20 63 6f 6e 6e 65 63 74 ransient connect
40c0: 69 6f 6e 73 0a 62 65 74 77 65 65 6e 20 63 6f 77 ions.between cow
40d0: 6f 72 6b 65 72 73 20 66 6f 72 20 64 6f 69 6e 67 orkers for doing
40e0: 20 71 75 69 63 6b 20 70 75 73 68 65 73 20 6f 72 quick pushes or
40f0: 20 70 75 6c 6c 73 2e 20 20 42 75 74 20 79 6f 75 pulls. But you
4100: 20 63 61 6e 20 61 6c 73 6f 0a 73 65 74 20 75 70 can also.set up
4110: 20 61 20 70 65 72 6d 61 6e 65 6e 74 20 73 74 61 a permanent sta
4120: 6e 64 2d 61 6c 6f 6e 65 20 73 65 72 76 65 72 20 nd-alone server
4130: 69 66 20 79 6f 75 20 70 72 65 66 65 72 2e 20 20 if you prefer.
4140: 4a 75 73 74 20 6d 61 6b 65 0a 61 72 72 61 6e 67 Just make.arrang
4150: 65 6d 65 6e 74 73 20 66 6f 72 20 66 6f 73 73 69 ements for fossi
4160: 6c 20 74 6f 20 62 65 20 6c 61 75 6e 63 68 65 64 l to be launched
4170: 20 77 69 74 68 20 61 70 70 72 6f 70 72 69 61 74 with appropriat
4180: 65 20 61 72 67 75 6d 65 6e 74 73 0a 61 66 74 65 e arguments.afte
4190: 72 20 65 76 65 72 79 20 72 65 62 6f 6f 74 2e 3c r every reboot.<
41a0: 2f 70 3e 0a 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c /p>.</li>..<li><
41b0: 70 3e 3c 62 3e 53 65 74 74 69 6e 67 20 75 70 20 p><b>Setting up
41c0: 61 20 43 47 49 20 73 65 72 76 65 72 3c 2f 62 3e a CGI server</b>
41d0: 3c 2f 70 3e 0a 0a 3c 70 3e 49 66 20 79 6f 75 20 </p>..<p>If you
41e0: 68 61 76 65 20 61 20 77 65 62 73 65 72 76 65 72 have a webserver
41f0: 20 72 75 6e 6e 69 6e 67 20 6f 6e 20 79 6f 75 72 running on your
4200: 20 6d 61 63 68 69 6e 65 20 61 6c 72 65 61 64 79 machine already
4210: 2c 20 79 6f 75 20 63 61 6e 0a 73 65 74 20 75 70 , you can.set up
4220: 20 66 6f 73 73 69 6c 20 74 6f 20 62 65 20 72 75 fossil to be ru
4230: 6e 20 66 72 6f 6d 20 43 47 49 2e 20 20 53 69 6d n from CGI. Sim
4240: 70 6c 79 20 63 72 65 61 74 65 20 61 6e 20 65 78 ply create an ex
4250: 65 63 75 74 61 62 6c 65 20 73 63 72 69 70 74 0a ecutable script.
4260: 74 68 61 74 20 6c 6f 6f 6b 73 20 73 6f 6d 65 74 that looks somet
4270: 68 69 6e 67 20 6c 69 6b 65 20 74 68 69 73 3a 3c hing like this:<
4280: 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 /p>..<blockquote
4290: 3e 3c 70 72 65 3e 0a 23 21 2f 75 73 72 2f 6c 6f ><pre>.#!/usr/lo
42a0: 63 61 6c 2f 62 69 6e 2f 66 6f 73 73 69 6c 0a 72 cal/bin/fossil.r
42b0: 65 70 6f 73 69 74 6f 72 79 3a 20 2f 68 6f 6d 65 epository: /home
42c0: 2f 6d 65 2f 62 69 67 70 72 6f 6a 65 63 74 2e 66 /me/bigproject.f
42d0: 6f 73 73 69 6c 0a 3c 2f 70 72 65 3e 3c 2f 62 6c ossil.</pre></bl
42e0: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 45 64 ockquote>..<p>Ed
42f0: 69 74 20 74 68 69 73 20 73 63 72 69 70 74 20 74 it this script t
4300: 6f 20 75 73 65 20 77 68 61 74 65 76 65 72 20 70 o use whatever p
4310: 61 74 68 6e 61 6d 65 73 20 61 72 65 20 61 70 70 athnames are app
4320: 72 6f 70 72 69 61 74 65 20 66 6f 72 0a 79 6f 75 ropriate for.you
4330: 72 20 70 72 6f 6a 65 63 74 2e 20 20 54 68 65 6e r project. Then
4340: 20 70 6f 69 6e 74 20 79 6f 75 72 20 77 65 62 62 point your webb
4350: 72 6f 77 73 65 72 20 61 74 20 74 68 65 20 73 63 rowser at the sc
4360: 72 69 70 74 20 61 6e 64 20 6f 66 66 20 79 6f 75 ript and off you
4370: 0a 67 6f 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c .go.</p></li>..<
4380: 6c 69 3e 3c 70 3e 3c 62 3e 53 65 74 74 69 6e 67 li><p><b>Setting
4390: 20 75 70 20 61 6e 20 69 6e 65 74 64 20 73 65 72 up an inetd ser
43a0: 76 65 72 3c 2f 62 3e 3c 2f 70 3e 0a 0a 3c 70 3e ver</b></p>..<p>
43b0: 49 66 20 79 6f 75 20 68 61 76 65 20 69 6e 65 74 If you have inet
43c0: 64 20 6f 72 20 78 69 6e 65 74 64 20 72 75 6e 6e d or xinetd runn
43d0: 69 6e 67 20 6f 6e 20 79 6f 75 72 20 73 79 73 74 ing on your syst
43e0: 65 6d 2c 20 79 6f 75 20 63 61 6e 20 73 65 74 0a em, you can set.
43f0: 74 68 6f 73 65 20 73 65 72 76 69 63 65 73 20 75 those services u
4400: 70 20 74 6f 20 6c 61 75 6e 63 68 20 66 6f 73 73 p to launch foss
4410: 69 6c 20 74 6f 20 64 65 61 6c 20 77 69 74 68 20 il to deal with
4420: 69 6e 62 6f 75 6e 64 20 54 43 50 2f 49 50 20 63 inbound TCP/IP c
4430: 6f 6e 6e 65 63 74 69 6f 6e 73 0a 6f 6e 20 77 68 onnections.on wh
4440: 61 74 65 76 65 72 20 70 6f 72 74 20 79 6f 75 20 atever port you
4450: 77 61 6e 74 2e 20 20 53 65 74 20 75 70 20 69 6e want. Set up in
4460: 65 74 64 20 6f 72 20 78 69 6e 65 74 64 20 74 6f etd or xinetd to
4470: 20 6c 61 75 6e 63 68 20 66 6f 73 73 69 6c 0a 6c launch fossil.l
4480: 69 6b 65 20 74 68 69 73 3a 3c 2f 70 3e 0a 0a 3c ike this:</p>..<
4490: 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e blockquote><pre>
44a0: 0a 2f 75 73 72 2f 6c 6f 63 61 6c 2f 62 69 6e 2f ./usr/local/bin/
44b0: 66 6f 73 73 69 6c 20 68 74 74 70 20 2f 68 6f 6d fossil http /hom
44c0: 65 2f 6d 65 2f 62 69 67 70 72 6f 6a 65 63 74 2e e/me/bigproject.
44d0: 66 6f 73 73 69 6c 0a 3c 2f 70 72 65 3e 3c 2f 62 fossil.</pre></b
44e0: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 41 lockquote>..<p>A
44f0: 73 20 62 65 66 6f 72 65 2c 20 63 68 61 6e 67 65 s before, change
4500: 20 74 68 65 20 66 69 6c 65 6e 61 6d 65 73 20 74 the filenames t
4510: 6f 20 77 68 61 74 65 76 65 72 20 69 73 20 61 70 o whatever is ap
4520: 70 72 6f 70 72 69 61 74 65 20 66 6f 72 0a 79 6f propriate for.yo
4530: 75 72 20 73 79 73 74 65 6d 2e 20 20 59 6f 75 20 ur system. You
4540: 63 61 6e 20 68 61 76 65 20 66 6f 73 73 69 6c 20 can have fossil
4550: 72 75 6e 20 61 73 20 61 6e 79 20 75 73 65 72 20 run as any user
4560: 74 68 61 74 20 68 61 73 20 77 72 69 74 65 0a 70 that has write.p
4570: 65 72 6d 69 73 73 69 6f 6e 20 6f 6e 20 74 68 65 ermission on the
4580: 20 72 65 70 6f 73 69 74 6f 72 79 20 61 6e 64 20 repository and
4590: 6f 6e 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 on the directory
45a0: 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 74 that contains t
45b0: 68 65 0a 72 65 70 6f 73 69 74 6f 72 79 2e 20 20 he.repository.
45c0: 42 75 74 20 69 74 20 69 73 20 73 61 66 65 72 20 But it is safer
45d0: 74 6f 20 72 75 6e 20 66 6f 73 73 69 6c 20 61 73 to run fossil as
45e0: 20 72 6f 6f 74 2e 20 20 57 68 65 6e 20 66 6f 73 root. When fos
45f0: 73 69 6c 0a 73 65 65 73 20 74 68 61 74 20 69 74 sil.sees that it
4600: 20 69 73 20 72 75 6e 6e 69 6e 67 20 61 73 20 72 is running as r
4610: 6f 6f 74 2c 20 69 74 20 61 75 74 6f 6d 61 74 69 oot, it automati
4620: 63 61 6c 6c 79 20 70 75 74 73 20 69 74 73 65 6c cally puts itsel
4630: 66 20 69 6e 74 6f 0a 61 20 3c 61 20 68 72 65 66 f into.a <a href
4640: 3d 22 68 74 74 70 3a 2f 2f 65 6e 2e 77 69 6b 69 ="http://en.wiki
4650: 70 65 64 69 61 2e 6f 72 67 2f 77 69 6b 69 2f 43 pedia.org/wiki/C
4660: 68 72 6f 6f 74 22 3e 63 68 72 6f 6f 74 20 6a 61 hroot">chroot ja
4670: 69 6c 3c 2f 61 3e 20 61 6e 64 0a 64 72 6f 70 73 il</a> and.drops
4680: 20 61 6c 6c 20 70 72 69 76 69 6c 65 67 65 73 20 all privileges
4690: 70 72 69 6f 72 20 74 6f 20 72 65 61 64 69 6e 67 prior to reading
46a0: 20 61 6e 79 20 69 6e 66 6f 72 6d 61 74 69 6f 6e any information
46b0: 20 66 72 6f 6d 20 74 68 65 20 63 6c 69 65 6e 74 from the client
46c0: 2e 0a 53 69 6e 63 65 20 66 6f 73 73 69 6c 20 69 ..Since fossil i
46d0: 73 20 61 20 73 74 61 6e 64 2d 61 6c 6f 6e 65 20 s a stand-alone
46e0: 70 72 6f 67 72 61 6d 2c 20 79 6f 75 20 64 6f 20 program, you do
46f0: 6e 6f 74 20 6e 65 65 64 20 74 6f 20 70 75 74 20 not need to put
4700: 61 6e 79 74 68 69 6e 67 0a 69 6e 20 74 68 65 20 anything.in the
4710: 63 68 72 6f 6f 74 20 6a 61 69 6c 20 77 69 74 68 chroot jail with
4720: 20 66 6f 73 73 69 6c 20 69 6e 20 6f 72 64 65 72 fossil in order
4730: 20 66 6f 72 20 69 74 20 74 6f 20 64 6f 20 69 74 for it to do it
4740: 73 20 6a 6f 62 2e 3c 2f 70 3e 0a 3c 2f 6c 69 3e s job.</p>.</li>
4750: 0a 3c 2f 6f 6c 3e 0a 0a 3c 68 32 3e 36 2e 30 20 .</ol>..<h2>6.0
4760: 52 65 76 69 65 77 20 4f 66 20 4b 65 79 20 43 6f Review Of Key Co
4770: 6e 63 65 70 74 73 3c 2f 68 32 3e 0a 0a 3c 75 6c ncepts</h2>..<ul
4780: 3e 0a 3c 6c 69 3e 54 68 65 20 3c 62 3e 66 6f 73 >.<li>The <b>fos
4790: 73 69 6c 3c 2f 62 3e 20 70 72 6f 67 72 61 6d 20 sil</b> program
47a0: 69 73 20 61 20 73 65 6c 66 2d 63 6f 6e 74 61 69 is a self-contai
47b0: 6e 65 64 20 73 74 61 6e 64 2d 61 6c 6f 6e 65 20 ned stand-alone
47c0: 65 78 65 63 75 74 61 62 6c 65 2e 0a 20 20 20 20 executable..
47d0: 4a 75 73 74 20 70 75 74 20 69 74 20 73 6f 6d 65 Just put it some
47e0: 77 68 65 72 65 20 6f 6e 20 79 6f 75 72 20 50 41 where on your PA
47f0: 54 48 20 74 6f 20 69 6e 73 74 61 6c 6c 20 69 74 TH to install it
4800: 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 55 73 65 20 74 .</li>.<li>Use t
4810: 68 65 20 3c 62 3e 63 6c 6f 6e 65 3c 2f 62 3e 20 he <b>clone</b>
4820: 6f 72 20 3c 62 3e 6e 65 77 3c 2f 62 3e 20 63 6f or <b>new</b> co
4830: 6d 6d 61 6e 64 73 20 74 6f 20 63 72 65 61 74 65 mmands to create
4840: 20 61 20 6e 65 77 20 72 65 70 6f 73 69 74 6f 72 a new repositor
4850: 79 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 55 73 65 20 y.</li>.<li>Use
4860: 74 68 65 20 3c 62 3e 6f 70 65 6e 3c 2f 62 3e 20 the <b>open</b>
4870: 63 6f 6d 6d 61 6e 64 20 74 6f 20 63 72 65 61 74 command to creat
4880: 65 20 61 20 6e 65 77 20 73 6f 75 72 63 65 20 74 e a new source t
4890: 72 65 65 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 55 73 ree.</li>.<li>Us
48a0: 65 20 74 68 65 20 3c 62 3e 61 64 64 3c 2f 62 3e e the <b>add</b>
48b0: 20 61 6e 64 20 3c 62 3e 72 6d 3c 2f 62 3e 20 6f and <b>rm</b> o
48c0: 72 20 3c 62 3e 64 65 6c 65 74 65 3c 2f 62 3e 20 r <b>delete</b>
48d0: 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 61 64 64 20 commands to add
48e0: 61 6e 64 0a 20 20 20 20 72 65 6d 6f 76 65 20 66 and. remove f
48f0: 69 6c 65 73 20 66 72 6f 6d 20 74 68 65 20 6c 6f iles from the lo
4900: 63 61 6c 20 73 6f 75 72 63 65 20 74 72 65 65 2e cal source tree.
4910: 3c 2f 6c 69 3e 0a 3c 6c 69 3e 55 73 65 20 74 68 </li>.<li>Use th
4920: 65 20 3c 62 3e 63 6f 6d 6d 69 74 3c 2f 62 3e 20 e <b>commit</b>
4930: 63 6f 6d 6d 61 6e 64 20 74 6f 20 63 72 65 61 74 command to creat
4940: 65 20 61 20 6e 65 77 20 62 61 73 65 6c 69 6e 65 e a new baseline
4950: 2e 3c 2f 6c 69 3e 0a 3c 6c 69 3e 55 73 65 20 74 .</li>.<li>Use t
4960: 68 65 20 3c 62 3e 75 70 64 61 74 65 3c 2f 62 3e he <b>update</b>
4970: 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 6d 65 72 67 command to merg
4980: 65 20 69 6e 20 63 68 61 6e 67 65 73 20 66 72 6f e in changes fro
4990: 6d 20 6f 74 68 65 72 73 2e 3c 2f 6c 69 3e 0a 3c m others.</li>.<
49a0: 6c 69 3e 54 68 65 20 3c 62 3e 70 75 73 68 3c 2f li>The <b>push</
49b0: 62 3e 20 61 6e 64 20 3c 62 3e 70 75 6c 6c 3c 2f b> and <b>pull</
49c0: 62 3e 20 63 6f 6d 6d 61 6e 64 73 20 63 61 6e 20 b> commands can
49d0: 62 65 20 75 73 65 64 20 74 6f 20 73 68 61 72 65 be used to share
49e0: 20 63 68 61 6e 67 65 73 0a 20 20 20 20 6d 61 6e changes. man
49f0: 75 61 6c 6c 79 2c 20 62 75 74 20 74 68 65 73 65 ually, but these
4a00: 20 74 68 69 6e 67 73 20 68 61 70 70 65 6e 20 61 things happen a
4a10: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 69 6e 20 utomatically in
4a20: 74 68 65 20 64 65 66 61 75 6c 74 0a 20 20 20 20 the default.
4a30: 61 75 74 6f 73 79 6e 63 20 6d 6f 64 65 2e 3c 2f autosync mode.</
4a40: 6c 69 3e 0a 3c 2f 75 6c 3e 0a li>.</ul>.