0000: 3c 68 74 6d 6c 3e 0a 3c 68 65 61 64 3e 0a 3c 74 <html>.<head>.<t
0010: 69 74 6c 65 3e 46 6f 73 73 69 6c 20 43 6f 6e 63 itle>Fossil Conc
0020: 65 70 74 73 3c 2f 74 69 74 6c 65 3e 0a 3c 2f 68 epts</title>.</h
0030: 65 61 64 3e 0a 3c 62 6f 64 79 20 62 67 63 6f 6c ead>.<body bgcol
0040: 6f 72 3d 22 77 68 69 74 65 22 3e 0a 3c 68 31 20 or="white">.<h1
0050: 61 6c 69 67 6e 3d 22 63 65 6e 74 65 72 22 3e 0a align="center">.
0060: 46 6f 73 73 69 6c 20 43 6f 6e 63 65 70 74 73 0a Fossil Concepts.
0070: 3c 2f 68 31 3e 0a 0a 3c 68 32 3e 31 2e 30 20 49 </h1>..<h2>1.0 I
0080: 6e 74 72 6f 64 75 63 74 69 6f 6e 3c 2f 68 32 3e ntroduction</h2>
0090: 0a 3c 70 3e 0a 3c 61 20 68 72 65 66 3d 22 69 6e .<p>.<a href="in
00a0: 64 65 78 2e 68 74 6d 6c 22 3e 46 6f 73 73 69 6c dex.html">Fossil
00b0: 3c 2f 61 3e 20 69 73 20 61 0a 3c 61 20 68 72 65 </a> is a.<a hre
00c0: 66 3d 22 68 74 74 70 3a 2f 2f 65 6e 2e 77 69 6b f="http://en.wik
00d0: 69 70 65 64 69 61 2e 6f 72 67 2f 77 69 6b 69 2f ipedia.org/wiki/
00e0: 53 6f 66 74 77 61 72 65 5f 63 6f 6e 66 69 67 75 Software_configu
00f0: 72 61 74 69 6f 6e 5f 6d 61 6e 61 67 65 6d 65 6e ration_managemen
0100: 74 22 3e 0a 73 6f 66 74 77 61 72 65 20 63 6f 6e t">.software con
0110: 66 69 67 75 72 61 74 69 6f 6e 20 6d 61 6e 61 67 figuration manag
0120: 65 6d 65 6e 74 3c 2f 61 3e 20 73 79 73 74 65 6d ement</a> system
0130: 2e 0a 46 6f 73 73 69 6c 20 69 73 20 73 6f 66 74 ..Fossil is soft
0140: 77 61 72 65 20 74 68 61 74 20 69 73 20 64 65 73 ware that is des
0150: 69 67 6e 65 64 20 74 6f 20 63 6f 6e 74 72 6f 6c igned to control
0160: 20 61 6e 64 20 74 72 61 63 6b 20 74 68 65 0a 64 and track the.d
0170: 65 76 65 6c 6f 70 6d 65 6e 74 20 6f 66 20 61 20 evelopment of a
0180: 73 6f 66 74 77 61 72 65 20 70 72 6f 6a 65 63 74 software project
0190: 20 61 6e 64 20 74 6f 20 72 65 63 6f 72 64 20 74 and to record t
01a0: 68 65 20 68 69 73 74 6f 72 79 0a 6f 66 20 74 68 he history.of th
01b0: 65 20 70 72 6f 6a 65 63 74 2e 0a 54 68 65 72 65 e project..There
01c0: 20 61 72 65 20 6d 61 6e 79 20 73 75 63 68 20 73 are many such s
01d0: 79 73 74 65 6d 73 20 69 6e 20 75 73 65 20 74 6f ystems in use to
01e0: 64 61 79 2e 20 20 46 6f 73 73 69 6c 20 73 74 72 day. Fossil str
01f0: 69 76 65 73 20 74 6f 0a 64 69 73 74 69 6e 67 75 ives to.distingu
0200: 69 73 68 20 69 74 73 65 6c 66 20 66 72 6f 6d 20 ish itself from
0210: 74 68 65 20 6f 74 68 65 72 73 20 62 79 20 62 65 the others by be
0220: 69 6e 67 20 65 78 74 72 65 6d 65 6c 79 20 73 69 ing extremely si
0230: 6d 70 6c 65 0a 74 6f 20 73 65 74 75 70 20 61 6e mple.to setup an
0240: 64 20 6f 70 65 72 61 74 65 2e 3c 2f 70 3e 0a 0a d operate.</p>..
0250: 3c 70 3e 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 <p>This document
0260: 20 69 73 20 69 6e 74 65 6e 64 65 64 20 61 73 20 is intended as
0270: 61 20 71 75 69 63 6b 20 69 6e 74 72 6f 64 75 63 a quick introduc
0280: 74 69 6f 6e 20 74 6f 20 74 68 65 20 63 6f 6e 63 tion to the conc
0290: 65 70 74 73 0a 62 65 68 69 6e 64 20 66 6f 73 73 epts.behind foss
02a0: 69 6c 2e 3c 2f 70 3e 0a 0a 3c 68 32 3e 32 2e 30 il.</p>..<h2>2.0
02b0: 20 43 6f 6d 70 6f 73 69 74 69 6f 6e 20 4f 66 20 Composition Of
02c0: 41 20 50 72 6f 6a 65 63 74 3c 2f 68 32 3e 0a 3c A Project</h2>.<
02d0: 69 6d 67 20 73 72 63 3d 22 63 6f 6e 63 65 70 74 img src="concept
02e0: 31 2e 67 69 66 22 20 61 6c 69 67 6e 3d 22 72 69 1.gif" align="ri
02f0: 67 68 74 22 20 68 73 70 61 63 65 3d 22 31 30 22 ght" hspace="10"
0300: 3e 0a 0a 3c 70 3e 41 20 73 6f 66 74 77 61 72 65 >..<p>A software
0310: 20 70 72 6f 6a 65 63 74 20 6e 6f 72 6d 61 6c 6c project normall
0320: 79 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 y consists of a
0330: 22 73 6f 75 72 63 65 20 74 72 65 65 22 2e 0a 41 "source tree"..A
0340: 20 73 6f 75 72 63 65 20 74 72 65 65 20 69 73 20 source tree is
0350: 61 20 68 69 65 72 61 72 63 68 79 20 6f 66 20 66 a hierarchy of f
0360: 69 6c 65 73 20 74 68 61 74 20 61 72 65 20 75 73 iles that are us
0370: 65 64 20 74 6f 20 67 65 6e 65 72 61 74 65 0a 74 ed to generate.t
0380: 68 65 20 65 6e 64 20 70 72 6f 64 75 63 74 2e 20 he end product.
0390: 20 54 68 65 20 73 6f 75 72 63 65 20 74 72 65 65 The source tree
03a0: 20 63 68 61 6e 67 65 73 20 6f 76 65 72 20 74 69 changes over ti
03b0: 6d 65 20 61 73 20 74 68 65 0a 73 6f 66 74 77 61 me as the.softwa
03c0: 72 65 20 67 72 6f 77 73 20 61 6e 64 20 65 78 70 re grows and exp
03d0: 61 6e 64 73 20 61 6e 64 20 61 73 20 66 65 61 74 ands and as feat
03e0: 75 72 65 73 20 61 72 65 20 61 64 64 65 64 20 61 ures are added a
03f0: 6e 64 20 62 75 67 73 0a 61 72 65 20 66 69 78 65 nd bugs.are fixe
0400: 64 2e 20 20 41 20 73 6e 61 70 73 68 6f 74 20 6f d. A snapshot o
0410: 66 20 74 68 65 20 73 6f 75 72 63 65 20 74 72 65 f the source tre
0420: 65 20 61 74 20 61 6e 79 20 70 6f 69 6e 74 20 69 e at any point i
0430: 6e 20 74 69 6d 65 0a 69 73 20 63 61 6c 6c 65 64 n time.is called
0440: 20 61 20 22 76 65 72 73 69 6f 6e 22 20 6f 72 20 a "version" or
0450: 61 20 22 62 61 73 65 6c 69 6e 65 22 20 6f 66 20 a "baseline" of
0460: 74 68 65 20 70 72 6f 64 75 63 74 2e 3c 2f 70 3e the product.</p>
0470: 0a 0a 3c 70 3e 41 20 22 72 65 70 6f 73 69 74 6f ..<p>A "reposito
0480: 72 79 22 20 69 73 20 61 20 64 61 74 61 62 61 73 ry" is a databas
0490: 65 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 e that contains
04a0: 63 6f 70 69 65 73 20 6f 66 20 61 6c 6c 20 68 69 copies of all hi
04b0: 73 74 6f 72 69 63 61 6c 0a 76 65 72 73 69 6f 6e storical.version
04c0: 73 20 6f 72 20 62 61 73 65 6c 69 6e 65 73 20 66 s or baselines f
04d0: 6f 72 20 61 20 70 72 6f 6a 65 63 74 2e 20 20 42 or a project. B
04e0: 61 73 65 6c 69 6e 65 73 20 61 72 65 20 6e 6f 72 aselines are nor
04f0: 6d 61 6c 6c 79 20 73 74 6f 72 65 64 20 69 6e 20 mally stored in
0500: 74 68 65 0a 72 65 70 6f 73 69 74 6f 72 79 20 69 the.repository i
0510: 6e 20 61 20 68 69 67 68 6c 79 20 73 70 61 63 65 n a highly space
0520: 2d 65 66 66 69 63 69 65 6e 74 20 63 6f 6d 70 72 -efficient compr
0530: 65 73 73 65 64 20 66 6f 72 6d 61 74 20 28 64 65 essed format (de
0540: 6c 74 61 20 65 6e 63 6f 64 69 6e 67 29 2e 0a 42 lta encoding)..B
0550: 75 74 20 74 68 61 74 20 69 73 20 61 6e 20 69 6d ut that is an im
0560: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 64 65 74 plementation det
0570: 61 69 6c 20 74 68 61 74 20 79 6f 75 20 74 68 65 ail that you the
0580: 20 75 73 65 72 20 6e 65 65 64 20 6e 6f 74 20 77 user need not w
0590: 6f 72 72 79 20 6f 76 65 72 2e 0a 54 68 69 6e 6b orry over..Think
05a0: 20 6f 66 20 74 68 65 20 72 65 70 6f 73 69 74 6f of the reposito
05b0: 72 79 20 61 73 20 61 20 73 61 66 65 20 70 6c 61 ry as a safe pla
05c0: 63 65 20 77 68 65 72 65 20 61 6c 6c 20 79 6f 75 ce where all you
05d0: 72 20 6f 6c 64 20 62 61 73 65 6c 69 6e 65 73 20 r old baselines
05e0: 61 72 65 0a 73 65 63 75 72 65 6c 79 20 73 74 6f are.securely sto
05f0: 72 65 64 20 61 77 61 79 20 61 6e 64 20 61 76 61 red away and ava
0600: 69 6c 61 62 6c 65 20 66 6f 72 20 72 65 74 72 69 ilable for retri
0610: 65 76 61 6c 20 77 68 65 6e 65 76 65 72 20 79 6f eval whenever yo
0620: 75 20 6e 65 65 64 0a 74 68 65 6d 2e 3c 2f 70 3e u need.them.</p>
0630: 0a 0a 3c 70 3e 41 20 72 65 70 6f 73 69 74 6f 72 ..<p>A repositor
0640: 79 20 69 6e 20 66 6f 73 73 69 6c 20 69 73 20 61 y in fossil is a
0650: 20 73 69 6e 67 6c 65 20 66 69 6c 65 20 6f 6e 20 single file on
0660: 79 6f 75 72 20 64 69 73 6b 2e 20 20 54 68 69 73 your disk. This
0670: 20 66 69 6c 65 0a 6d 69 67 68 74 20 62 65 20 72 file.might be r
0680: 61 74 68 65 72 20 6c 61 72 67 65 20 28 64 6f 7a ather large (doz
0690: 65 6e 73 20 6f 72 20 68 75 6e 64 72 65 64 73 20 ens or hundreds
06a0: 6f 66 20 6d 65 67 61 62 79 74 65 73 20 66 6f 72 of megabytes for
06b0: 20 61 20 6c 61 72 67 65 0a 6f 72 20 6c 6f 6e 67 a large.or long
06c0: 20 72 75 6e 6e 69 6e 67 20 70 72 6f 6a 65 63 74 running project
06d0: 29 20 62 75 74 20 69 74 20 69 73 20 6e 65 76 65 ) but it is neve
06e0: 72 74 68 65 6c 65 73 73 20 6a 75 73 74 20 61 20 rtheless just a
06f0: 66 69 6c 65 2e 20 20 59 6f 75 0a 63 61 6e 20 6d file. You.can m
0700: 6f 76 65 20 69 74 20 61 72 6f 75 6e 64 2c 20 72 ove it around, r
0710: 65 6e 61 6d 65 20 69 74 2c 20 77 72 69 74 65 20 ename it, write
0720: 69 74 20 6f 75 74 20 74 6f 20 61 20 6d 65 6d 6f it out to a memo
0730: 72 79 20 73 74 69 63 6b 2c 20 6f 72 0a 64 6f 20 ry stick, or.do
0740: 61 6e 79 74 68 69 6e 67 20 65 6c 73 65 20 79 6f anything else yo
0750: 75 20 6e 6f 72 6d 61 6c 6c 79 20 64 6f 20 77 69 u normally do wi
0760: 74 68 20 66 69 6c 65 73 2e 3c 2f 70 3e 0a 0a 3c th files.</p>..<
0770: 70 3e 45 61 63 68 20 73 6f 75 72 63 65 20 74 72 p>Each source tr
0780: 65 65 20 74 68 61 74 20 69 73 20 63 6f 6e 74 72 ee that is contr
0790: 6f 6c 6c 65 64 20 62 79 20 66 6f 73 73 69 6c 20 olled by fossil
07a0: 69 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 is associated wi
07b0: 74 68 0a 61 20 73 69 6e 67 6c 65 20 72 65 70 6f th.a single repo
07c0: 73 69 74 6f 72 79 20 6f 6e 20 74 68 65 20 6c 6f sitory on the lo
07d0: 63 61 6c 20 64 69 73 6b 20 64 72 69 76 65 2e 20 cal disk drive.
07e0: 20 59 6f 75 20 63 61 6e 20 74 69 65 20 74 77 6f You can tie two
07f0: 20 6f 72 20 6d 6f 72 65 0a 73 6f 75 72 63 65 20 or more.source
0800: 74 72 65 65 73 20 74 6f 20 61 20 73 69 6e 67 6c trees to a singl
0810: 65 20 72 65 70 6f 73 69 74 6f 72 79 20 69 66 20 e repository if
0820: 79 6f 75 20 77 61 6e 74 20 28 74 68 6f 75 67 68 you want (though
0830: 20 6f 6e 65 0a 74 72 65 65 20 70 65 72 20 72 65 one.tree per re
0840: 70 6f 73 69 74 6f 72 79 20 69 73 20 74 68 65 20 pository is the
0850: 6d 6f 73 74 20 63 6f 6d 6d 6f 6e 20 63 6f 6e 66 most common conf
0860: 69 67 75 72 61 74 69 6f 6e 2e 29 20 20 53 6f 20 iguration.) So
0870: 61 0a 73 69 6e 67 6c 65 20 72 65 70 6f 73 69 74 a.single reposit
0880: 6f 72 79 20 63 61 6e 20 62 65 20 61 73 73 6f 63 ory can be assoc
0890: 69 61 74 65 64 20 77 69 74 68 20 6d 61 6e 79 20 iated with many
08a0: 73 6f 75 72 63 65 20 74 72 65 65 73 2c 20 62 75 source trees, bu
08b0: 74 0a 65 61 63 68 20 73 6f 75 72 63 65 20 74 72 t.each source tr
08c0: 65 65 20 69 73 20 61 73 73 6f 63 69 61 74 65 64 ee is associated
08d0: 20 77 69 74 68 20 6f 6e 6c 79 20 6f 6e 65 20 72 with only one r
08e0: 65 70 6f 73 69 74 6f 72 79 2e 3c 2f 70 3e 0a 0a epository.</p>..
08f0: 3c 70 3e 46 6f 73 73 69 6c 20 73 6f 75 72 63 65 <p>Fossil source
0900: 20 74 72 65 65 20 6d 61 79 20 6e 6f 74 20 6f 76 tree may not ov
0910: 65 72 6c 61 70 2e 20 20 41 20 66 6f 73 73 69 6c erlap. A fossil
0920: 20 73 6f 75 72 63 65 20 74 72 65 65 20 69 73 20 source tree is
0930: 69 64 65 6e 74 69 66 69 65 64 0a 62 79 20 61 20 identified.by a
0940: 66 69 6c 65 20 6e 61 6d 65 64 20 22 5f 46 4f 53 file named "_FOS
0950: 53 49 4c 5f 22 20 69 6e 20 74 68 65 20 72 6f 6f SIL_" in the roo
0960: 74 20 64 69 72 65 63 74 6f 72 79 20 6f 66 20 74 t directory of t
0970: 68 65 20 73 6f 75 72 63 65 20 74 72 65 65 2e 20 he source tree.
0980: 20 45 76 65 72 79 0a 66 69 6c 65 20 74 68 61 74 Every.file that
0990: 20 69 73 20 61 20 73 69 62 6c 69 6e 67 20 6f 66 is a sibling of
09a0: 20 5f 46 4f 53 53 49 4c 5f 20 61 6e 64 20 65 76 _FOSSIL_ and ev
09b0: 65 72 79 20 66 69 6c 65 20 69 6e 20 65 76 65 72 ery file in ever
09c0: 79 20 73 75 62 66 6f 6c 64 65 72 20 69 73 0a 63 y subfolder is.c
09d0: 6f 6e 73 69 64 65 72 65 64 20 70 6f 74 65 6e 74 onsidered potent
09e0: 69 61 6c 6c 79 20 61 20 70 61 72 74 20 6f 66 20 ially a part of
09f0: 74 68 65 20 73 6f 75 72 63 65 20 74 72 65 65 2e the source tree.
0a00: 20 20 54 68 65 20 5f 46 4f 53 53 49 4c 5f 20 66 The _FOSSIL_ f
0a10: 69 6c 65 0a 63 6f 6e 74 61 69 6e 73 20 28 61 6d ile.contains (am
0a20: 6f 6e 67 20 6f 74 68 65 72 20 74 68 69 6e 67 73 ong other things
0a30: 29 20 74 68 65 20 70 61 74 68 6e 61 6d 65 20 6f ) the pathname o
0a40: 66 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 f the repository
0a50: 20 77 69 74 68 20 77 68 69 63 68 0a 74 68 65 20 with which.the
0a60: 73 6f 75 72 63 65 20 74 72 65 65 20 69 73 20 61 source tree is a
0a70: 73 73 6f 63 69 61 74 65 64 2e 20 20 4f 6e 20 74 ssociated. On t
0a80: 68 65 20 6f 74 68 65 72 20 68 61 6e 64 2c 20 74 he other hand, t
0a90: 68 65 20 72 65 70 6f 73 69 74 6f 72 79 20 68 61 he repository ha
0aa0: 73 0a 6e 6f 20 72 65 63 6f 72 64 20 6f 66 20 69 s.no record of i
0ab0: 74 73 20 73 6f 75 72 63 65 20 74 72 65 65 73 2e ts source trees.
0ac0: 20 20 53 6f 20 79 6f 75 20 61 72 65 20 66 72 65 So you are fre
0ad0: 65 20 74 6f 20 64 65 6c 65 74 65 20 61 20 73 6f e to delete a so
0ae0: 75 72 63 65 20 74 72 65 65 0a 6f 72 20 6d 6f 76 urce tree.or mov
0af0: 65 20 69 74 20 61 72 6f 75 6e 64 20 77 69 74 68 e it around with
0b00: 6f 75 74 20 63 6f 6e 73 65 71 75 65 6e 63 65 2e out consequence.
0b10: 20 20 42 75 74 20 69 66 20 79 6f 75 20 6d 6f 76 But if you mov
0b20: 65 20 6f 72 20 72 65 6e 61 6d 65 20 6f 72 0a 64 e or rename or.d
0b30: 65 6c 65 74 65 20 61 20 72 65 70 6f 73 69 74 6f elete a reposito
0b40: 72 79 2c 20 74 68 65 6e 20 61 6e 79 20 73 6f 75 ry, then any sou
0b50: 72 63 65 20 74 72 65 65 73 20 61 73 73 6f 63 69 rce trees associ
0b60: 61 74 65 64 20 77 69 74 68 20 74 68 61 74 20 72 ated with that r
0b70: 65 70 6f 73 69 74 6f 72 79 0a 77 69 6c 6c 20 6e epository.will n
0b80: 6f 20 6c 6f 6e 67 65 72 20 62 65 20 61 62 6c 65 o longer be able
0b90: 20 74 6f 20 6c 6f 63 61 74 65 20 74 68 65 69 72 to locate their
0ba0: 20 72 65 70 6f 73 69 74 6f 72 79 20 61 6e 64 20 repository and
0bb0: 77 69 6c 6c 20 73 74 6f 70 20 77 6f 72 6b 69 6e will stop workin
0bc0: 67 2e 3c 2f 70 3e 0a 0a 3c 70 3e 57 68 65 6e 20 g.</p>..<p>When
0bd0: 6d 75 6c 74 69 70 6c 65 20 64 65 76 65 6c 6f 70 multiple develop
0be0: 65 72 73 20 61 72 65 20 77 6f 72 6b 69 6e 67 20 ers are working
0bf0: 6f 6e 20 74 68 65 20 73 61 6d 65 20 70 72 6f 6a on the same proj
0c00: 65 63 74 2c 20 65 61 63 68 0a 64 65 76 65 6c 6f ect, each.develo
0c10: 70 65 72 20 74 79 70 69 63 61 6c 6c 79 20 68 61 per typically ha
0c20: 73 20 68 69 73 20 6f 72 20 68 65 72 20 6f 77 6e s his or her own
0c30: 20 6c 6f 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 local repositor
0c40: 79 20 61 6e 64 20 61 6e 20 61 73 73 6f 63 69 61 y and an associa
0c50: 74 65 64 0a 73 6f 75 72 63 65 20 74 72 65 65 20 ted.source tree
0c60: 69 6e 20 77 68 69 63 68 20 74 6f 20 77 6f 72 6b in which to work
0c70: 2e 20 20 44 65 76 65 6c 6f 70 65 72 73 20 73 68 . Developers sh
0c80: 61 72 65 20 74 68 65 69 72 20 77 6f 72 6b 20 62 are their work b
0c90: 79 0a 22 73 79 6e 63 69 6e 67 22 20 74 68 65 20 y."syncing" the
0ca0: 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 69 72 content of their
0cb0: 20 6c 6f 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 local repositor
0cc0: 69 65 73 20 65 69 74 68 65 72 20 64 69 72 65 63 ies either direc
0cd0: 74 6c 79 0a 6f 72 20 74 68 72 6f 75 67 68 20 61 tly.or through a
0ce0: 20 63 65 6e 74 72 61 6c 20 73 65 72 76 65 72 2e central server.
0cf0: 20 20 43 68 61 6e 67 65 73 20 63 61 6e 20 22 70 Changes can "p
0d00: 75 73 68 22 20 66 72 6f 6d 20 74 68 65 20 6c 6f ush" from the lo
0d10: 63 61 6c 0a 72 65 70 6f 73 69 74 6f 72 79 20 69 cal.repository i
0d20: 6e 74 6f 20 61 20 72 65 6d 6f 74 65 20 72 65 70 nto a remote rep
0d30: 6f 73 69 74 6f 72 79 2e 20 20 4f 72 20 63 68 61 ository. Or cha
0d40: 6e 67 65 73 20 63 61 6e 20 22 70 75 6c 6c 22 20 nges can "pull"
0d50: 66 72 6f 6d 20 61 0a 72 65 6d 6f 74 65 20 72 65 from a.remote re
0d60: 70 6f 73 69 74 6f 72 79 20 69 6e 74 6f 20 61 20 pository into a
0d70: 6c 6f 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 local repository
0d80: 2e 20 20 4f 72 20 6f 6e 65 20 63 61 6e 20 64 6f . Or one can do
0d90: 20 61 20 22 73 79 6e 63 22 0a 77 68 69 63 68 20 a "sync".which
0da0: 69 73 20 61 20 73 68 6f 72 74 63 75 74 20 66 6f is a shortcut fo
0db0: 72 20 64 6f 69 6e 67 20 62 6f 74 68 20 61 20 70 r doing both a p
0dc0: 75 73 68 20 61 6e 64 20 61 20 70 75 6c 6c 20 61 ush and a pull a
0dd0: 74 20 74 68 65 20 73 61 6d 65 20 74 69 6d 65 2e t the same time.
0de0: 0a 46 6f 73 73 69 6c 20 61 6c 73 6f 20 68 61 73 .Fossil also has
0df0: 20 74 68 65 20 63 6f 6e 63 65 70 74 20 6f 66 20 the concept of
0e00: 22 63 6c 6f 6e 69 6e 67 22 2e 20 20 41 20 22 63 "cloning". A "c
0e10: 6c 6f 6e 65 22 20 69 73 20 6c 69 6b 65 20 61 20 lone" is like a
0e20: 22 70 75 6c 6c 22 2c 0a 65 78 63 65 70 74 20 74 "pull",.except t
0e30: 68 61 74 20 69 6e 73 74 65 61 64 20 6f 66 20 62 hat instead of b
0e40: 65 67 69 6e 6e 69 6e 67 20 77 69 74 68 20 61 6e eginning with an
0e50: 20 65 78 69 73 74 69 6e 67 20 6c 6f 63 61 6c 20 existing local
0e60: 72 65 70 6f 73 69 74 6f 72 79 2c 0a 61 20 63 6c repository,.a cl
0e70: 6f 6e 65 20 62 65 67 69 6e 73 20 77 69 74 68 20 one begins with
0e80: 6e 6f 74 68 69 6e 67 20 61 6e 64 20 63 72 65 61 nothing and crea
0e90: 74 65 73 20 61 20 6e 65 77 20 6c 6f 63 61 6c 20 tes a new local
0ea0: 72 65 70 6f 73 69 74 6f 72 79 20 74 68 61 74 0a repository that.
0eb0: 69 73 20 61 20 72 65 70 6c 69 63 61 74 65 20 6f is a replicate o
0ec0: 66 20 61 20 72 65 6d 6f 74 65 20 72 65 70 6f 73 f a remote repos
0ed0: 69 74 6f 72 79 2e 3c 2f 70 3e 0a 0a 3c 70 3e 43 itory.</p>..<p>C
0ee0: 6f 6d 6d 75 6e 69 63 61 74 69 6f 6e 20 62 65 74 ommunication bet
0ef0: 77 65 65 6e 20 72 65 70 6f 73 69 74 6f 72 69 65 ween repositorie
0f00: 73 20 69 73 20 76 69 61 20 48 54 54 50 2e 20 20 s is via HTTP.
0f10: 52 65 6d 6f 74 65 0a 72 65 70 6f 73 69 74 6f 72 Remote.repositor
0f20: 69 65 73 20 61 72 65 20 69 64 65 6e 74 69 66 69 ies are identifi
0f30: 65 64 20 62 79 20 55 52 4c 2e 20 20 59 6f 75 20 ed by URL. You
0f40: 63 61 6e 20 61 6c 73 6f 20 70 6f 69 6e 74 20 61 can also point a
0f50: 20 77 65 62 62 72 6f 77 73 65 72 0a 61 74 20 61 webbrowser.at a
0f60: 20 72 65 70 6f 73 69 74 6f 72 79 20 61 6e 64 20 repository and
0f70: 67 65 74 20 68 75 6d 61 6e 2d 72 65 61 64 61 62 get human-readab
0f80: 6c 65 20 73 74 61 74 75 73 2c 20 68 69 73 74 6f le status, histo
0f90: 72 79 2c 20 61 6e 64 20 74 72 61 63 6b 69 6e 67 ry, and tracking
0fa0: 0a 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f .information abo
0fb0: 75 74 20 74 68 65 20 70 72 6f 6a 65 63 74 2e 3c ut the project.<
0fc0: 2f 70 3e 0a 0a 3c 68 33 3e 32 2e 31 20 49 64 65 /p>..<h3>2.1 Ide
0fd0: 6e 74 69 66 69 63 61 74 69 6f 6e 20 4f 66 20 41 ntification Of A
0fe0: 72 74 69 66 61 63 74 73 3c 2f 68 33 3e 0a 0a 3c rtifacts</h3>..<
0ff0: 70 3e 41 20 70 61 72 74 69 63 75 6c 61 72 20 76 p>A particular v
1000: 65 72 73 69 6f 6e 20 6f 66 20 61 20 70 61 72 74 ersion of a part
1010: 69 63 75 6c 61 72 20 66 69 6c 65 20 69 73 20 63 icular file is c
1020: 61 6c 6c 65 64 20 61 6e 20 22 61 72 74 69 66 61 alled an "artifa
1030: 63 74 22 2e 0a 45 61 63 68 20 61 72 74 69 66 61 ct"..Each artifa
1040: 63 74 20 68 61 73 20 61 20 75 6e 69 76 65 72 73 ct has a univers
1050: 61 6c 6c 79 20 75 6e 69 71 75 65 20 6e 61 6d 65 ally unique name
1060: 20 77 68 69 63 68 20 69 73 20 74 68 65 0a 3c 61 which is the.<a
1070: 20 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f 65 6e href="http://en
1080: 2e 77 69 6b 69 70 65 64 69 61 2e 6f 72 67 2f 77 .wikipedia.org/w
1090: 69 6b 69 2f 53 48 41 22 3e 53 48 41 31 3c 2f 61 iki/SHA">SHA1</a
10a0: 3e 20 68 61 73 68 20 6f 66 20 74 68 65 20 63 6f > hash of the co
10b0: 6e 74 65 6e 74 0a 6f 66 20 74 68 61 74 20 66 69 ntent.of that fi
10c0: 6c 65 20 65 78 70 72 65 73 73 65 64 20 61 73 20 le expressed as
10d0: 34 30 20 63 68 61 72 61 63 74 65 72 73 20 6f 66 40 characters of
10e0: 20 6c 6f 77 65 72 2d 63 61 73 65 20 68 65 78 61 lower-case hexa
10f0: 64 65 63 69 6d 61 6c 2e 20 20 53 75 63 68 0a 61 decimal. Such.a
1100: 20 68 61 73 68 20 69 73 20 72 65 66 65 72 72 65 hash is referre
1110: 64 20 74 6f 20 61 73 20 74 68 65 20 55 6e 69 76 d to as the Univ
1120: 65 72 73 61 6c 6c 79 20 55 6e 69 71 75 65 20 49 ersally Unique I
1130: 64 65 6e 74 69 66 69 65 72 20 6f 72 20 55 55 49 dentifier or UUI
1140: 44 0a 66 6f 72 20 74 68 65 20 61 72 74 69 66 61 D.for the artifa
1150: 63 74 2e 20 20 54 68 65 20 53 48 41 31 20 61 6c ct. The SHA1 al
1160: 67 6f 72 69 74 68 6d 20 69 73 20 63 72 65 61 74 gorithm is creat
1170: 65 64 20 77 69 74 68 20 74 68 65 20 70 75 72 70 ed with the purp
1180: 6f 73 65 20 6f 66 0a 70 72 6f 76 69 64 69 6e 67 ose of.providing
1190: 20 61 20 68 69 67 68 6c 79 20 66 6f 72 67 65 72 a highly forger
11a0: 79 2d 72 65 73 69 73 74 65 6e 74 20 69 64 65 6e y-resistent iden
11b0: 74 69 66 69 65 72 20 66 6f 72 20 61 20 66 69 6c tifier for a fil
11c0: 65 2e 20 20 47 69 76 65 6e 20 61 6e 79 0a 66 69 e. Given any.fi
11d0: 6c 65 20 69 74 20 69 73 20 73 69 6d 70 6c 65 20 le it is simple
11e0: 74 6f 20 66 69 6e 64 20 74 68 65 20 55 55 49 44 to find the UUID
11f0: 20 66 6f 72 20 74 68 61 74 20 66 69 6c 65 2e 20 for that file.
1200: 20 42 75 74 20 67 69 76 65 6e 20 61 0a 55 55 49 But given a.UUI
1210: 44 20 69 74 20 69 73 20 63 6f 6d 70 75 74 61 74 D it is computat
1220: 69 6f 6e 61 6c 6c 79 20 69 6e 74 72 61 63 74 61 ionally intracta
1230: 62 6c 65 20 74 6f 20 67 65 6e 65 72 61 74 65 20 ble to generate
1240: 61 20 66 69 6c 65 20 74 68 61 74 20 77 69 6c 6c a file that will
1250: 0a 67 65 6e 65 72 61 74 65 20 74 68 61 74 20 55 .generate that U
1260: 55 49 44 2e 3c 2f 70 3e 0a 0a 0a 3c 70 3e 55 55 UID.</p>...<p>UU
1270: 49 44 73 20 6c 6f 6f 6b 20 73 6f 6d 65 74 68 69 IDs look somethi
1280: 6e 67 20 6c 69 6b 65 20 74 68 69 73 3a 3c 2f 70 ng like this:</p
1290: 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c >..<blockquote><
12a0: 62 3e 0a 36 30 38 39 66 30 62 35 36 33 61 39 64 b>.6089f0b563a9d
12b0: 62 30 61 36 64 39 30 36 38 32 66 65 34 37 66 64 b0a6d90682fe47fd
12c0: 37 31 36 31 66 66 38 36 37 63 38 3c 62 72 3e 0a 7161ff867c8<br>.
12d0: 35 39 37 31 32 36 31 34 61 31 62 33 63 63 66 64 59712614a1b3ccfd
12e0: 38 34 30 37 38 61 33 37 66 61 35 62 36 30 36 65 84078a37fa5b606e
12f0: 32 38 34 33 34 33 32 36 3c 62 72 3e 0a 31 39 64 28434326<br>.19d
1300: 62 66 37 33 30 37 38 62 65 39 37 37 39 65 64 64 bf73078be9779edd
1310: 36 61 30 31 35 36 31 39 35 65 36 31 30 66 38 31 6a0156195e610f81
1320: 63 39 34 66 39 3c 62 72 3e 0a 62 34 31 30 34 39 c94f9<br>.b41049
1330: 35 39 61 36 37 31 37 35 66 30 32 64 36 62 34 31 59a67175f02d6b41
1340: 35 34 38 30 62 65 32 32 61 32 33 39 66 31 66 30 5480be22a239f1f0
1350: 37 37 3c 62 72 3e 0a 39 39 37 63 39 64 36 61 65 77<br>.997c9d6ae
1360: 30 33 61 64 31 31 34 62 32 62 35 37 66 30 34 65 03ad114b2b57f04e
1370: 39 65 65 65 66 31 37 64 63 62 38 32 37 38 38 0a 9eeef17dcb82788.
1380: 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 </b></blockquote
1390: 3e 0a 0a 3c 70 3e 57 68 65 6e 20 72 65 66 65 72 >..<p>When refer
13a0: 72 69 6e 67 20 74 6f 20 61 6e 20 61 72 74 69 66 ring to an artif
13b0: 61 63 74 20 75 73 69 6e 67 20 66 6f 73 73 69 6c act using fossil
13c0: 2c 20 79 6f 75 20 63 61 6e 20 75 73 65 20 61 20 , you can use a
13d0: 75 6e 69 71 75 65 0a 70 72 65 66 69 78 20 6f 66 unique.prefix of
13e0: 20 74 68 65 20 55 55 49 44 20 74 68 61 74 20 69 the UUID that i
13f0: 73 20 66 6f 75 72 20 63 68 61 72 61 63 74 65 72 s four character
1400: 73 20 6f 72 20 6c 6f 6e 67 65 72 2e 20 20 54 68 s or longer. Th
1410: 69 73 20 73 61 76 65 73 0a 61 20 6c 6f 74 20 6f is saves.a lot o
1420: 66 20 74 79 70 69 6e 67 2e 20 20 57 68 65 6e 20 f typing. When
1430: 64 69 73 70 6c 61 79 69 6e 67 20 55 55 49 44 73 displaying UUIDs
1440: 2c 20 66 6f 73 73 69 6c 20 77 69 6c 6c 20 75 73 , fossil will us
1450: 75 61 6c 6c 79 20 6f 6e 6c 79 0a 73 68 6f 77 20 ually only.show
1460: 74 68 65 20 66 69 72 73 74 20 31 30 20 64 69 67 the first 10 dig
1470: 69 74 73 20 73 69 6e 63 65 20 74 68 61 74 20 69 its since that i
1480: 73 20 6e 6f 72 6d 61 6c 6c 79 20 65 6e 6f 75 67 s normally enoug
1490: 68 20 74 6f 20 75 6e 69 71 75 65 6c 79 0a 69 64 h to uniquely.id
14a0: 65 6e 74 69 66 79 20 61 20 66 69 6c 65 2e 3c 2f entify a file.</
14b0: 70 3e 0a 0a 3c 70 3e 43 68 61 6e 67 69 6e 67 20 p>..<p>Changing
14c0: 28 6f 72 20 61 64 64 69 6e 67 20 6f 72 20 72 65 (or adding or re
14d0: 6d 6f 76 69 6e 67 29 20 61 20 73 69 6e 67 6c 65 moving) a single
14e0: 20 62 79 74 65 20 69 6e 20 61 20 66 69 6c 65 20 byte in a file
14f0: 72 65 73 75 6c 74 73 0a 69 6e 20 61 20 63 6f 6d results.in a com
1500: 70 6c 65 74 65 6c 79 20 64 69 66 66 65 72 65 6e pletely differen
1510: 74 20 55 55 49 44 2e 20 20 41 6e 64 20 73 69 6e t UUID. And sin
1520: 63 65 20 74 68 65 20 55 55 49 44 20 69 73 20 74 ce the UUID is t
1530: 68 65 20 6e 61 6d 65 20 6f 66 0a 74 68 65 20 61 he name of.the a
1540: 72 74 69 66 61 63 74 2c 20 6d 61 6b 69 6e 67 20 rtifact, making
1550: 61 6e 79 20 63 68 61 6e 67 65 20 74 6f 20 61 20 any change to a
1560: 66 69 6c 65 20 72 65 73 75 6c 74 73 20 69 6e 20 file results in
1570: 61 20 6e 65 77 20 61 72 74 69 66 61 63 74 2e 0a a new artifact..
1580: 49 6e 20 74 68 69 73 20 77 61 79 2c 20 61 72 74 In this way, art
1590: 69 66 61 63 74 73 20 61 72 65 20 69 6d 6d 75 74 ifacts are immut
15a0: 61 62 6c 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 41 20 able.</p>..<p>A
15b0: 72 65 70 6f 73 69 74 6f 72 79 20 69 73 20 72 65 repository is re
15c0: 61 6c 6c 79 20 6a 75 73 74 20 61 6e 20 75 6e 6f ally just an uno
15d0: 72 64 65 72 65 64 20 63 6f 6c 6c 65 63 74 69 6f rdered collectio
15e0: 6e 20 6f 66 0a 61 72 74 69 66 61 63 74 73 2e 20 n of.artifacts.
15f0: 20 4e 65 77 20 61 72 74 69 66 61 63 74 73 20 63 New artifacts c
1600: 61 6e 20 62 65 20 61 64 64 65 64 20 74 6f 20 74 an be added to t
1610: 68 65 20 72 65 70 6f 73 69 74 6f 72 79 2c 20 62 he repository, b
1620: 75 74 0a 65 78 69 73 74 69 6e 67 20 61 72 74 69 ut.existing arti
1630: 66 61 63 74 73 20 63 61 6e 20 6e 65 76 65 72 20 facts can never
1640: 62 65 20 72 65 6d 6f 76 65 64 2e 20 20 46 6f 73 be removed. Fos
1650: 73 69 6c 20 69 73 20 64 65 73 69 67 6e 65 64 20 sil is designed
1660: 69 6e 0a 73 75 63 68 20 61 20 77 61 79 20 74 68 in.such a way th
1670: 61 74 20 69 74 20 63 61 6e 20 62 65 20 68 61 6e at it can be han
1680: 64 65 64 20 61 20 73 65 74 20 6f 66 20 61 72 74 ded a set of art
1690: 69 66 61 63 74 73 20 69 6e 20 61 6e 79 0a 6f 72 ifacts in any.or
16a0: 64 65 72 20 61 6e 64 20 69 74 20 63 61 6e 20 66 der and it can f
16b0: 69 67 75 72 65 20 6f 75 74 20 74 68 65 20 72 65 igure out the re
16c0: 6c 61 74 69 6f 6e 73 68 69 70 20 62 65 74 77 65 lationship betwe
16d0: 65 6e 20 74 68 6f 73 65 0a 61 72 74 69 66 61 63 en those.artifac
16e0: 74 73 20 61 6e 64 20 72 65 63 6f 6e 73 74 72 75 ts and reconstru
16f0: 63 74 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 20 ct the complete
1700: 64 65 76 65 6c 6f 70 6d 65 6e 74 20 68 69 73 74 development hist
1710: 6f 72 79 20 6f 66 0a 61 20 73 6f 66 74 77 61 72 ory of.a softwar
1720: 65 20 70 72 6f 6a 65 63 74 2e 3c 2f 70 3e 0a 0a e project.</p>..
1730: 3c 68 33 3e 32 2e 32 20 4d 61 6e 69 66 65 73 74 <h3>2.2 Manifest
1740: 73 3c 2f 68 33 3e 0a 0a 3c 70 3e 41 74 20 74 68 s</h3>..<p>At th
1750: 65 20 72 6f 6f 74 20 6f 66 20 61 20 73 6f 75 72 e root of a sour
1760: 63 65 20 74 72 65 65 20 69 73 20 61 20 73 70 65 ce tree is a spe
1770: 63 69 61 6c 20 66 69 6c 65 20 63 61 6c 6c 65 64 cial file called
1780: 20 74 68 65 0a 22 6d 61 6e 69 66 65 73 74 22 2e the."manifest".
1790: 20 20 54 68 65 20 6d 61 6e 69 66 65 73 74 20 69 The manifest i
17a0: 73 20 61 20 6c 69 73 74 69 6e 67 20 6f 66 20 61 s a listing of a
17b0: 6c 6c 20 6f 74 68 65 72 20 66 69 6c 65 73 20 69 ll other files i
17c0: 6e 0a 74 68 61 74 20 73 6f 75 72 63 65 20 74 72 n.that source tr
17d0: 65 65 2e 20 20 54 68 65 20 6d 61 6e 69 66 65 73 ee. The manifes
17e0: 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 28 t contains the (
17f0: 63 6f 6d 70 6c 65 74 65 29 20 55 55 49 44 20 0a complete) UUID .
1800: 6f 66 20 74 68 65 20 66 69 6c 65 20 61 6e 64 20 of the file and
1810: 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 the name of the
1820: 66 69 6c 65 20 61 73 20 69 74 20 61 70 70 65 61 file as it appea
1830: 72 73 20 6f 6e 20 64 69 73 6b 2c 0a 61 6e 64 20 rs on disk,.and
1840: 74 68 75 73 20 73 65 72 76 65 73 20 61 73 20 61 thus serves as a
1850: 20 6d 61 70 70 69 6e 67 20 66 72 6f 6d 20 55 55 mapping from UU
1860: 49 44 20 74 6f 20 64 69 73 6b 20 6e 61 6d 65 2e ID to disk name.
1870: 20 20 54 68 65 20 55 55 49 44 0a 6f 66 20 74 68 The UUID.of th
1880: 65 20 6d 61 6e 69 66 65 73 74 20 69 73 20 74 68 e manifest is th
1890: 65 20 55 55 49 44 20 74 68 61 74 20 69 64 65 6e e UUID that iden
18a0: 74 69 66 69 65 73 20 61 20 62 61 73 65 6c 69 6e tifies a baselin
18b0: 65 2e 20 20 57 68 65 6e 0a 79 6f 75 20 6c 6f 6f e. When.you loo
18c0: 6b 20 61 74 20 61 20 22 74 69 6d 65 6c 69 6e 65 k at a "timeline
18d0: 22 20 6f 66 20 63 68 61 6e 67 65 73 20 69 6e 20 " of changes in
18e0: 66 6f 73 73 69 6c 2c 20 74 68 65 20 55 55 49 44 fossil, the UUID
18f0: 20 61 73 73 6f 63 69 61 74 65 64 0a 77 69 74 68 associated.with
1900: 20 65 61 63 68 20 63 68 65 63 6b 2d 69 6e 20 6f each check-in o
1910: 72 20 63 6f 6d 6d 69 74 20 69 73 20 72 65 61 6c r commit is real
1920: 6c 79 20 6a 75 73 74 20 74 68 65 20 55 55 49 44 ly just the UUID
1930: 20 6f 66 20 74 68 65 0a 6d 61 6e 69 66 65 73 74 of the.manifest
1940: 20 66 6f 72 20 74 68 61 74 20 62 61 73 65 6c 69 for that baseli
1950: 6e 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 46 6f 73 73 ne.</p>..<p>Foss
1960: 69 6c 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 il automatically
1970: 20 67 65 6e 65 72 61 74 65 73 20 61 20 6d 61 6e generates a man
1980: 69 66 65 73 74 20 77 68 65 6e 65 76 65 72 20 79 ifest whenever y
1990: 6f 75 20 22 63 6f 6d 6d 69 74 22 20 0a 61 20 6e ou "commit" .a n
19a0: 65 77 20 62 61 73 65 6c 69 6e 65 2e 20 20 53 6f ew baseline. So
19b0: 20 74 68 69 73 20 69 73 20 6e 6f 74 20 73 6f 6d this is not som
19c0: 65 74 68 69 6e 67 20 74 68 61 74 20 79 6f 75 2c ething that you,
19d0: 20 74 68 65 20 64 65 76 65 6c 6f 70 65 72 2c 0a the developer,.
19e0: 6e 65 65 64 20 74 6f 20 77 6f 72 72 79 20 77 69 need to worry wi
19f0: 74 68 2e 20 20 54 68 65 20 66 6f 72 6d 61 74 20 th. The format
1a00: 6f 66 20 61 20 6d 61 6e 69 66 65 73 74 20 69 73 of a manifest is
1a10: 20 69 6e 74 65 6e 74 69 6f 6e 61 6c 6c 79 0a 64 intentionally.d
1a20: 65 73 69 67 6e 65 64 20 74 6f 20 62 65 20 73 69 esigned to be si
1a30: 6d 70 6c 65 20 74 6f 20 70 61 72 73 65 2c 20 68 mple to parse, h
1a40: 6f 77 65 76 65 72 2c 20 73 6f 20 74 68 61 74 20 owever, so that
1a50: 69 66 0a 79 6f 75 20 77 61 6e 74 20 74 6f 20 72 if.you want to r
1a60: 65 61 64 20 61 6e 64 20 69 6e 74 65 72 70 72 65 ead and interpre
1a70: 74 20 61 20 6d 61 6e 69 66 65 73 74 2c 20 65 69 t a manifest, ei
1a80: 74 68 65 72 20 62 79 20 68 61 6e 64 20 6f 72 0a ther by hand or.
1a90: 77 69 74 68 20 61 20 73 63 72 69 70 74 2c 20 74 with a script, t
1aa0: 68 61 74 20 69 73 20 65 61 73 79 20 74 6f 20 64 hat is easy to d
1ab0: 6f 2e 3c 2f 70 3e 0a 0a 3c 70 3e 49 6e 20 61 64 o.</p>..<p>In ad
1ac0: 64 69 74 69 6f 6e 20 74 6f 20 69 64 65 6e 74 69 dition to identi
1ad0: 66 79 69 6e 67 20 61 6c 6c 20 66 69 6c 65 73 20 fying all files
1ae0: 69 6e 20 74 68 65 20 62 61 73 65 6c 69 6e 65 2c in the baseline,
1af0: 20 61 0a 6d 61 6e 69 66 65 73 74 20 61 6c 73 6f a.manifest also
1b00: 20 63 6f 6e 74 61 69 6e 73 20 61 20 63 68 65 63 contains a chec
1b10: 6b 2d 69 6e 20 63 6f 6d 6d 65 6e 74 2c 20 74 68 k-in comment, th
1b20: 65 20 64 61 74 65 20 61 6e 64 20 74 69 6d 65 0a e date and time.
1b30: 77 68 65 6e 20 74 68 65 20 62 61 73 65 6c 69 6e when the baselin
1b40: 65 20 77 61 73 20 65 73 74 61 62 6c 69 73 68 65 e was establishe
1b50: 64 2c 20 77 68 6f 20 63 72 65 61 74 65 64 20 74 d, who created t
1b60: 68 65 20 62 61 73 65 6c 69 6e 65 2c 0a 61 6e 64 he baseline,.and
1b70: 20 6c 69 6e 6b 73 20 74 6f 20 6f 74 68 65 72 20 links to other
1b80: 62 61 73 65 6c 69 6e 65 73 20 66 72 6f 6d 20 77 baselines from w
1b90: 68 69 63 68 20 74 68 65 20 63 75 72 72 65 6e 74 hich the current
1ba0: 20 62 61 73 65 6c 69 6e 65 0a 69 73 20 64 65 72 baseline.is der
1bb0: 69 76 65 64 2e 20 20 54 68 65 72 65 20 69 73 20 ived. There is
1bc0: 61 6c 73 6f 20 61 20 63 6f 75 70 6c 65 20 6f 66 also a couple of
1bd0: 20 63 68 65 63 6b 73 75 6d 73 20 75 73 65 64 20 checksums used
1be0: 74 6f 20 76 65 72 69 66 79 0a 74 68 65 20 69 6e to verify.the in
1bf0: 74 65 67 72 69 74 79 20 6f 66 20 74 68 65 20 62 tegrity of the b
1c00: 61 73 65 6c 69 6e 65 2e 20 20 41 6e 64 20 74 68 aseline. And th
1c10: 65 20 77 68 6f 6c 65 20 6d 61 6e 69 66 65 73 74 e whole manifest
1c20: 20 6d 69 67 68 74 0a 62 65 20 50 47 50 20 63 6c might.be PGP cl
1c30: 65 61 72 73 69 67 6e 65 64 2e 3c 2f 70 3e 0a 0a earsigned.</p>..
1c40: 3c 68 33 3e 32 2e 33 20 4b 65 79 20 63 6f 6e 63 <h3>2.3 Key conc
1c50: 65 70 74 73 3c 2f 68 33 3e 0a 0a 3c 75 6c 3e 0a epts</h3>..<ul>.
1c60: 3c 6c 69 3e 41 20 3c 62 3e 62 61 73 65 6c 69 6e <li>A <b>baselin
1c70: 65 3c 2f 62 3e 20 6f 72 20 3c 62 3e 76 65 72 73 e</b> or <b>vers
1c80: 69 6f 6e 3c 2f 62 3e 20 69 73 20 61 20 73 65 74 ion</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 79 6f 75 20 hat step if you
22a0: 64 6f 20 6e 6f 74 20 68 61 76 65 20 47 50 47 20 do not have GPG
22b0: 73 6f 20 69 74 20 69 73 20 6e 6f 74 0a 65 73 73 so it is not.ess
22c0: 65 6e 74 69 61 6c 2e 3c 2f 70 3e 0a 0a 3c 70 3e ential.</p>..<p>
22d0: 54 6f 20 75 6e 69 6e 73 74 61 6c 6c 20 66 6f 73 To uninstall fos
22e0: 73 69 6c 2c 20 73 69 6d 70 6c 79 20 64 65 6c 65 sil, simply dele
22f0: 74 65 20 74 68 65 20 65 78 65 63 75 74 61 62 6c te the executabl
2300: 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 6f 20 75 70 e.</p>..<p>To up
2310: 67 72 61 64 65 20 61 6e 20 6f 6c 64 65 72 20 76 grade an older v
2320: 65 72 73 69 6f 6e 20 6f 66 20 66 6f 73 73 69 6c ersion of fossil
2330: 20 74 6f 20 61 20 6e 65 77 65 72 20 76 65 72 73 to a newer vers
2340: 69 6f 6e 2c 20 6a 75 73 74 0a 72 65 70 6c 61 63 ion, just.replac
2350: 65 20 74 68 65 20 6f 6c 64 20 65 78 65 63 75 74 e the old execut
2360: 61 62 6c 65 20 77 69 74 68 20 74 68 65 20 6e 65 able with the ne
2370: 77 20 6f 6e 65 2e 20 20 59 6f 75 20 6d 69 67 68 w one. You migh
2380: 74 20 6e 65 65 64 20 74 6f 20 0a 72 75 6e 20 61 t need to .run a
2390: 20 6f 6e 65 2d 74 69 6d 65 20 63 6f 6d 6d 61 6e one-time comman
23a0: 64 20 74 6f 20 72 65 73 74 72 75 63 74 75 72 65 d to restructure
23b0: 20 79 6f 75 72 20 72 65 70 6f 73 69 74 6f 72 69 your repositori
23c0: 65 73 20 61 66 74 65 72 0a 61 6e 20 75 70 67 72 es after.an upgr
23d0: 61 64 65 2e 20 20 43 68 65 63 6b 20 74 68 65 20 ade. Check the
23e0: 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 74 68 61 instructions tha
23f0: 74 20 63 6f 6d 65 20 77 69 74 68 20 74 68 65 20 t come with the
2400: 75 70 67 72 61 64 65 0a 66 6f 72 20 64 65 74 61 upgrade.for deta
2410: 69 6c 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 6f 20 ils.</p>..<p>To
2420: 75 73 65 20 66 6f 73 73 69 6c 2c 20 73 69 6d 70 use fossil, simp
2430: 6c 79 20 74 79 70 65 20 74 68 65 20 6e 61 6d 65 ly type the name
2440: 20 6f 66 20 65 78 65 63 75 74 61 62 6c 65 20 69 of executable i
2450: 6e 20 79 6f 75 72 0a 73 68 65 6c 6c 2c 20 66 6f n your.shell, fo
2460: 6c 6c 6f 77 65 64 20 62 79 20 6f 6e 65 20 6f 66 llowed by one of
2470: 20 74 68 65 20 76 61 72 69 6f 75 73 20 62 75 69 the various bui
2480: 6c 74 2d 69 6e 20 63 6f 6d 6d 61 6e 64 73 20 61 lt-in commands a
2490: 6e 64 0a 61 72 67 75 6d 65 6e 74 73 20 61 70 70 nd.arguments app
24a0: 72 6f 70 72 69 61 74 65 20 66 6f 72 20 74 68 61 ropriate for tha
24b0: 74 20 63 6f 6d 6d 61 6e 64 2e 20 20 46 6f 72 20 t command. For
24c0: 65 78 61 6d 70 6c 65 3a 3c 2f 70 3e 0a 0a 3c 62 example:</p>..<b
24d0: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 62 3e 0a 66 6f lockquote><b>.fo
24e0: 73 73 69 6c 20 68 65 6c 70 0a 3c 2f 62 3e 3c 2f ssil help.</b></
24f0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e blockquote>..<p>
2500: 49 6e 20 74 68 65 20 6e 65 78 74 20 73 65 63 74 In the next sect
2510: 69 6f 6e 2c 20 77 68 65 6e 20 77 65 20 73 61 79 ion, when we say
2520: 20 74 68 69 6e 67 73 20 6c 69 6b 65 20 22 75 73 things like "us
2530: 65 20 74 68 65 20 3c 62 3e 68 65 6c 70 3c 2f 62 e the <b>help</b
2540: 3e 0a 63 6f 6d 6d 61 6e 64 22 20 77 65 20 6d 65 >.command" we me
2550: 61 6e 20 74 6f 20 75 73 65 20 74 68 65 20 63 6f an to use the co
2560: 6d 6d 61 6e 64 20 6e 61 6d 65 20 22 68 65 6c 70 mmand name "help
2570: 22 20 61 73 20 74 68 65 20 66 69 72 73 74 0a 74 " as the first.t
2580: 6f 6b 65 6e 20 61 66 74 65 72 20 74 68 65 20 6e oken after the n
2590: 61 6d 65 20 6f 66 20 74 68 65 20 66 6f 73 73 69 ame of the fossi
25a0: 6c 20 65 78 65 63 75 74 61 62 6c 65 2c 20 61 73 l executable, as
25b0: 20 73 68 6f 77 6e 20 61 62 6f 76 65 2e 3c 2f 70 shown above.</p
25c0: 3e 0a 0a 3c 68 32 3e 34 2e 30 20 57 6f 72 6b 66 >..<h2>4.0 Workf
25d0: 6c 6f 77 3c 2f 68 32 3e 0a 0a 3c 69 6d 67 20 73 low</h2>..<img s
25e0: 72 63 3d 22 63 6f 6e 63 65 70 74 32 2e 67 69 66 rc="concept2.gif
25f0: 22 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 20 " align="right"
2600: 68 73 70 61 63 65 3d 22 31 30 22 3e 0a 3c 6f 6c hspace="10">.<ol
2610: 3e 0a 3c 6c 69 3e 3c 70 3e 0a 45 73 74 61 62 6c >.<li><p>.Establ
2620: 69 73 68 20 61 20 6c 6f 63 61 6c 20 72 65 70 6f ish a local repo
2630: 73 69 74 6f 72 79 20 75 73 69 6e 67 20 65 69 74 sitory using eit
2640: 68 65 72 20 74 68 65 20 3c 62 3e 6e 65 77 3c 2f her the <b>new</
2650: 62 3e 20 63 6f 6d 6d 61 6e 64 0a 74 6f 20 73 74 b> command.to st
2660: 61 72 74 20 61 20 6e 65 77 20 70 72 6f 6a 65 63 art a new projec
2670: 74 2c 20 6f 72 20 74 68 65 20 3c 62 3e 63 6c 6f t, or the <b>clo
2680: 6e 65 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 74 ne</b> command t
2690: 6f 20 6d 61 6b 65 20 61 20 63 6c 6f 6e 65 0a 6f o make a clone.o
26a0: 66 20 61 20 72 65 70 6f 73 69 74 6f 72 79 20 66 f a repository f
26b0: 6f 72 20 61 6e 20 65 78 69 73 74 69 6e 67 20 70 or an existing p
26c0: 72 6f 6a 65 63 74 2e 20 0a 3c 2f 70 3e 3c 2f 6c roject. .</p></l
26d0: 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 45 73 74 61 i>..<li><p>.Esta
26e0: 62 6c 69 73 68 20 6f 6e 65 20 6f 72 20 6d 6f 72 blish one or mor
26f0: 65 20 73 6f 75 72 63 65 20 74 72 65 65 73 20 62 e source trees b
2700: 79 20 63 68 61 6e 67 69 6e 67 20 79 6f 75 72 20 y changing your
2710: 77 6f 72 6b 69 6e 67 20 64 69 72 65 63 74 6f 72 working director
2720: 79 0a 74 6f 20 77 68 65 72 65 20 79 6f 75 20 77 y.to where you w
2730: 61 6e 74 20 74 68 65 20 72 6f 6f 74 20 6f 66 20 ant the root of
2740: 74 68 65 20 73 6f 75 72 63 65 20 74 72 65 65 20 the source tree
2750: 74 6f 20 62 65 2c 20 74 68 65 6e 20 69 73 73 75 to be, then issu
2760: 69 6e 67 0a 74 68 65 20 3c 62 3e 6f 70 65 6e 3c ing.the <b>open<
2770: 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 /b> command with
2780: 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 the name of the
2790: 20 72 65 70 6f 73 69 74 6f 72 79 20 66 69 6c 65 repository file
27a0: 20 61 73 20 69 74 73 0a 61 72 67 75 6d 65 6e 74 as its.argument
27b0: 2e 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 ..</p></li>..<li
27c0: 3e 3c 70 3e 0a 55 73 65 20 74 68 65 20 3c 62 3e ><p>.Use the <b>
27d0: 75 70 64 61 74 65 3c 2f 62 3e 20 63 6f 6d 6d 61 update</b> comma
27e0: 6e 64 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 61 nd followed by a
27f0: 20 55 55 49 44 20 74 6f 20 63 61 75 73 65 20 79 UUID to cause y
2800: 6f 75 72 0a 73 6f 75 72 63 65 20 74 72 65 65 20 our.source tree
2810: 74 6f 20 63 68 61 6e 67 65 20 74 6f 20 74 68 65 to change to the
2820: 20 62 61 73 65 6c 69 6e 65 20 69 64 65 6e 74 69 baseline identi
2830: 66 69 65 64 20 62 79 20 74 68 61 74 20 55 55 49 fied by that UUI
2840: 44 2e 0a 54 68 65 20 3c 62 3e 74 69 6d 65 6c 69 D..The <b>timeli
2850: 6e 65 3c 2f 62 3e 20 6f 72 20 3c 62 3e 6c 65 61 ne</b> or <b>lea
2860: 76 65 73 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 73 ves</b> commands
2870: 20 6d 69 67 68 74 20 68 65 6c 70 20 79 6f 75 20 might help you
2880: 74 6f 0a 69 64 65 6e 74 69 66 79 20 61 6e 20 61 to.identify an a
2890: 70 70 72 6f 70 72 69 61 74 65 20 62 61 73 65 6c ppropriate basel
28a0: 69 6e 65 2e 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a ine..</p></li>..
28b0: 3c 6c 69 3e 3c 70 3e 0a 45 64 69 74 20 74 68 65 <li><p>.Edit the
28c0: 20 63 6f 64 65 2e 20 20 41 64 64 20 6e 65 77 20 code. Add new
28d0: 66 69 6c 65 73 20 74 6f 20 74 68 65 20 73 6f 75 files to the sou
28e0: 72 63 65 20 74 72 65 65 20 75 73 69 6e 67 20 74 rce tree using t
28f0: 68 65 20 3c 62 3e 61 64 64 3c 2f 62 3e 0a 63 6f he <b>add</b>.co
2900: 6d 6d 61 6e 64 2e 20 20 4f 6d 69 74 20 66 69 6c mmand. Omit fil
2910: 65 73 20 66 72 6f 6d 20 66 75 74 75 72 65 20 62 es from future b
2920: 61 73 65 6c 69 6e 65 73 20 75 73 69 6e 67 20 74 aselines using t
2930: 68 65 20 3c 62 3e 72 6d 3c 2f 62 3e 20 63 6f 6d he <b>rm</b> com
2940: 6d 61 6e 64 2e 0a 28 45 76 65 6e 20 77 68 65 6e mand..(Even when
2950: 20 79 6f 75 20 72 65 6d 6f 76 65 20 66 69 6c 65 you remove file
2960: 73 20 66 72 6f 6d 20 66 75 74 75 72 65 20 62 61 s from future ba
2970: 73 65 6c 69 6e 65 73 2c 20 74 68 6f 73 65 20 66 selines, those f
2980: 69 6c 65 73 20 63 6f 6e 74 69 6e 75 65 0a 74 6f iles continue.to
2990: 20 65 78 69 73 74 20 69 6e 20 68 69 73 74 6f 72 exist in histor
29a0: 69 63 61 6c 20 62 61 73 65 6c 69 6e 65 73 2e 29 ical baselines.)
29b0: 20 20 54 65 73 74 20 79 6f 75 72 20 63 68 61 6e Test your chan
29c0: 67 65 73 2e 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a ges..</p></li>..
29d0: 3c 6c 69 3e 3c 70 3e 0a 43 72 65 61 74 65 20 61 <li><p>.Create a
29e0: 20 6e 65 77 20 62 61 73 65 6c 69 6e 65 20 75 73 new baseline us
29f0: 69 6e 67 20 74 68 65 20 3c 62 3e 63 6f 6d 6d 69 ing the <b>commi
2a00: 74 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 2e 20 20 t</b> command.
2a10: 59 6f 75 20 77 69 6c 6c 20 62 65 20 70 72 6f 6d You will be prom
2a20: 70 74 65 64 0a 66 6f 72 20 61 20 63 68 65 63 6b pted.for a check
2a30: 2d 69 6e 20 63 6f 6d 6d 65 6e 74 20 61 6e 64 20 -in comment and
2a40: 61 6c 73 6f 20 66 6f 72 20 79 6f 75 72 20 47 50 also for your GP
2a50: 47 20 6b 65 79 20 69 66 20 79 6f 75 20 68 61 76 G key if you hav
2a60: 65 20 47 50 47 20 69 6e 73 74 61 6c 6c 65 64 2e e GPG installed.
2a70: 0a 54 68 65 20 63 6f 6d 6d 69 74 20 63 6f 70 69 .The commit copi
2a80: 65 73 20 74 68 65 20 65 64 69 74 73 20 79 6f 75 es the edits you
2a90: 20 68 61 76 65 20 6d 61 64 65 20 69 6e 20 79 6f have made in yo
2aa0: 75 72 20 6c 6f 63 61 6c 20 73 6f 75 72 63 65 0a ur local source.
2ab0: 74 72 65 65 20 69 6e 74 6f 20 79 6f 75 72 20 6c tree into your l
2ac0: 6f 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 2e ocal repository.
2ad0: 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e .</p></li>..<li>
2ae0: 3c 70 3e 0a 53 68 61 72 65 20 79 6f 75 72 20 63 <p>.Share your c
2af0: 68 61 6e 67 65 73 20 77 69 74 68 20 6f 74 68 65 hanges with othe
2b00: 72 73 20 75 73 69 6e 67 20 74 68 65 20 3c 62 3e rs using the <b>
2b10: 70 75 73 68 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 push</b> command
2b20: 2e 20 0a 50 75 73 68 20 63 61 75 73 65 73 20 74 . .Push causes t
2b30: 68 65 20 65 64 69 74 73 20 79 6f 75 20 63 6f 6d he edits you com
2b40: 6d 69 74 74 65 64 20 69 6e 74 6f 20 79 6f 75 72 mitted into your
2b50: 20 6c 6f 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 local repositor
2b60: 79 20 74 6f 20 62 65 0a 70 75 73 68 65 64 20 6f y to be.pushed o
2b70: 75 74 20 69 6e 74 6f 20 6f 74 68 65 72 20 72 65 ut into other re
2b80: 70 6f 73 69 74 6f 72 69 65 73 2e 0a 3c 2f 70 3e positories..</p>
2b90: 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 57 </li>..<li><p>.W
2ba0: 68 65 6e 20 79 6f 75 72 20 63 6f 77 6f 72 6b 65 hen your coworke
2bb0: 72 73 20 6d 61 6b 65 20 74 68 65 69 72 20 6f 77 rs make their ow
2bc0: 6e 20 63 68 61 6e 67 65 73 2c 20 79 6f 75 20 63 n changes, you c
2bd0: 61 6e 20 70 75 6c 6c 20 74 68 6f 73 65 20 63 68 an pull those ch
2be0: 61 6e 67 65 73 0a 69 6e 74 6f 20 79 6f 75 72 20 anges.into your
2bf0: 6c 6f 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 local repository
2c00: 20 75 73 69 6e 67 20 74 68 65 20 3c 62 3e 70 75 using the <b>pu
2c10: 6c 6c 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 2e 20 ll</b> command.
2c20: 20 20 4e 6f 74 65 20 74 68 61 74 0a 74 68 65 20 Note that.the
2c30: 70 75 6c 6c 20 63 6f 6d 6d 61 6e 64 20 6f 6e 6c pull command onl
2c40: 79 20 70 75 6c 6c 73 20 74 68 65 20 63 68 61 6e y pulls the chan
2c50: 67 65 73 20 69 6e 74 6f 20 79 6f 75 72 20 6c 6f ges into your lo
2c60: 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 2c 0a cal repository,.
2c70: 6e 6f 74 20 69 6e 74 6f 20 79 6f 75 72 20 6c 6f not into your lo
2c80: 63 61 6c 20 73 6f 75 72 63 65 20 74 72 65 65 2e cal source tree.
2c90: 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e .</p></li>..<li>
2ca0: 3c 70 3e 0a 41 66 74 65 72 20 74 68 65 20 63 68 <p>.After the ch
2cb0: 61 6e 67 65 73 20 6f 66 20 6f 74 68 65 72 73 20 anges of others
2cc0: 61 72 65 20 69 6e 20 79 6f 75 72 20 6c 6f 63 61 are in your loca
2cd0: 6c 20 72 65 70 6f 73 69 74 6f 72 79 2c 20 79 6f l repository, yo
2ce0: 75 20 0a 63 61 6e 20 6d 6f 76 65 20 74 68 65 6d u .can move them
2cf0: 20 69 6e 74 6f 20 79 6f 75 72 20 6c 6f 63 61 6c into your local
2d00: 20 73 6f 75 72 63 65 20 74 72 65 65 20 75 73 69 source tree usi
2d10: 6e 67 20 3c 62 3e 75 70 64 61 74 65 3c 2f 62 3e ng <b>update</b>
2d20: 2e 20 20 49 66 20 0a 79 6f 75 20 68 61 76 65 20 . If .you have
2d30: 6d 61 64 65 20 70 61 72 61 6c 6c 65 6c 0a 63 68 made parallel.ch
2d40: 61 6e 67 65 73 2c 20 79 6f 75 20 63 61 6e 20 6d anges, you can m
2d50: 65 72 67 65 20 79 6f 75 72 20 63 68 61 6e 67 65 erge your change
2d60: 73 20 74 6f 67 65 74 68 65 72 20 77 69 74 68 20 s together with
2d70: 79 6f 75 72 20 63 6f 77 6f 72 6b 65 72 73 20 63 your coworkers c
2d80: 68 61 6e 67 65 73 0a 62 79 20 64 6f 20 61 6e 20 hanges.by do an
2d90: 3c 62 3e 75 70 64 61 74 65 3c 2f 62 3e 20 74 6f <b>update</b> to
2da0: 20 79 6f 75 72 20 6c 61 74 65 73 74 20 62 61 73 your latest bas
2db0: 65 6c 69 6e 65 2c 20 74 68 65 6e 20 64 6f 69 6e eline, then doin
2dc0: 67 20 61 0a 3c 62 3e 6d 65 72 67 65 3c 2f 62 3e g a.<b>merge</b>
2dd0: 20 77 69 74 68 20 79 6f 75 72 20 63 6f 77 6f 72 with your cowor
2de0: 6b 65 72 73 20 6c 61 74 65 73 74 20 62 61 73 65 kers latest base
2df0: 6c 69 6e 65 2e 20 20 41 66 74 65 72 20 79 6f 75 line. After you
2e00: 72 0a 76 65 72 69 66 79 20 74 68 61 74 20 74 68 r.verify that th
2e10: 65 20 6d 65 72 67 65 64 20 63 6f 64 65 20 69 73 e merged code is
2e20: 20 73 74 69 6c 6c 20 66 75 6e 63 74 69 6f 6e 61 still functiona
2e30: 6c 2c 20 79 6f 75 20 63 61 6e 20 3c 62 3e 63 6f l, you can <b>co
2e40: 6d 6d 69 74 3c 2f 62 3e 0a 61 20 6e 65 77 20 62 mmit</b>.a new b
2e50: 61 73 65 6c 69 6e 65 20 74 68 61 74 20 63 6f 6e aseline that con
2e60: 74 61 69 6e 73 20 62 6f 74 68 20 79 6f 75 72 73 tains both yours
2e70: 20 61 6e 64 20 79 6f 75 72 20 63 6f 77 6f 72 6b and your cowork
2e80: 65 72 73 20 63 68 61 6e 67 65 73 0a 61 6e 64 20 ers changes.and
2e90: 74 68 65 6e 20 70 75 73 68 20 74 68 65 20 6e 65 then push the ne
2ea0: 77 20 62 61 73 65 6c 69 6e 65 20 62 61 63 6b 20 w baseline back
2eb0: 74 6f 20 79 6f 75 72 20 63 6f 77 6f 72 6b 65 72 to your coworker
2ec0: 2e 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 ..</p></li>..<li
2ed0: 3e 3c 70 3e 0a 52 65 70 65 61 74 20 61 6c 6c 20 ><p>.Repeat all
2ee0: 6f 66 20 74 68 65 20 61 62 6f 76 65 20 75 6e 74 of the above unt
2ef0: 69 6c 20 79 6f 75 20 68 61 76 65 20 67 65 6e 65 il you have gene
2f00: 72 61 74 65 64 20 67 72 65 61 74 20 73 6f 66 74 rated great soft
2f10: 77 61 72 65 2e 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a ware..</p></li>.
2f20: 3c 2f 6f 6c 3e 0a 0a 3c 68 32 3e 35 2e 30 20 53 </ol>..<h2>5.0 S
2f30: 65 74 74 69 6e 67 20 55 70 20 41 20 46 6f 73 73 etting Up A Foss
2f40: 69 6c 20 53 65 72 76 65 72 3c 2f 68 32 3e 0a 0a il Server</h2>..
2f50: 3c 70 3e 57 69 74 68 20 6f 74 68 65 72 20 63 6f <p>With other co
2f60: 6e 66 69 67 75 72 61 74 69 6f 6e 20 6d 61 6e 61 nfiguration mana
2f70: 67 65 6d 65 6e 74 20 73 6f 66 74 77 61 72 65 2c gement software,
2f80: 20 73 65 74 74 69 6e 67 20 75 70 20 61 20 73 65 setting up a se
2f90: 72 76 65 72 20 69 73 0a 61 20 6c 6f 74 20 6f 66 rver is.a lot of
2fa0: 20 77 6f 72 6b 20 61 6e 64 20 6e 6f 72 6d 61 6c work and normal
2fb0: 6c 79 20 74 61 6b 65 73 20 74 69 6d 65 2c 20 70 ly takes time, p
2fc0: 61 74 69 65 6e 63 65 2c 20 61 6e 64 20 61 20 6c atience, and a l
2fd0: 6f 74 20 6f 66 20 73 79 73 74 65 6d 0a 6b 6e 6f ot of system.kno
2fe0: 77 6c 65 64 67 65 2e 20 20 46 6f 73 73 69 6c 20 wledge. Fossil
2ff0: 69 73 20 64 65 73 69 67 6e 65 64 20 74 6f 20 61 is designed to a
3000: 76 6f 69 64 20 74 68 69 73 20 66 72 75 73 74 72 void this frustr
3010: 61 74 69 6f 6e 2e 20 20 53 65 74 74 69 6e 67 20 ation. Setting
3020: 75 70 0a 61 20 73 65 72 76 65 72 20 77 69 74 68 up.a server with
3030: 20 66 6f 73 73 69 6c 20 69 73 20 72 69 64 69 63 fossil is ridic
3040: 75 6c 6f 75 73 6c 79 20 65 61 73 79 2e 20 20 59 ulously easy. Y
3050: 6f 75 20 68 61 76 65 20 74 68 72 65 65 20 6f 70 ou have three op
3060: 74 69 6f 6e 73 3a 3c 2f 70 3e 0a 0a 3c 6f 6c 3e tions:</p>..<ol>
3070: 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 53 65 74 74 69 .<li><p><b>Setti
3080: 6e 67 20 75 70 20 61 20 73 74 61 6e 64 2d 61 6c ng up a stand-al
3090: 6f 6e 65 20 73 65 72 76 65 72 3c 2f 62 3e 3c 2f one server</b></
30a0: 70 3e 0a 0a 3c 70 3e 46 72 6f 6d 20 77 69 74 68 p>..<p>From with
30b0: 69 6e 20 79 6f 75 72 20 73 6f 75 72 63 65 20 74 in your source t
30c0: 72 65 65 20 6a 75 73 74 20 75 73 65 20 74 68 65 ree just use the
30d0: 20 3c 62 3e 73 65 72 76 65 72 3c 2f 62 3e 20 63 <b>server</b> c
30e0: 6f 6d 6d 61 6e 64 20 61 6e 64 0a 66 6f 73 73 69 ommand and.fossi
30f0: 6c 20 77 69 6c 6c 20 73 74 61 72 74 20 6c 69 73 l will start lis
3100: 74 65 6e 69 6e 67 20 66 6f 72 20 69 6e 63 6f 6d tening for incom
3110: 69 6e 67 20 72 65 71 75 65 73 74 73 20 6f 6e 20 ing requests on
3120: 54 43 50 20 70 6f 72 74 20 38 30 38 30 2e 0a 59 TCP port 8080..Y
3130: 6f 75 20 63 61 6e 20 70 6f 69 6e 74 20 79 6f 75 ou can point you
3140: 72 20 77 65 62 62 72 6f 77 73 65 72 20 61 74 20 r webbrowser at
3150: 3c 61 20 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f <a href="http://
3160: 6c 6f 63 61 6c 68 6f 73 74 3a 38 30 38 30 2f 22 localhost:8080/"
3170: 3e 0a 68 74 74 70 3a 2f 2f 6c 6f 63 61 6c 68 6f >.http://localho
3180: 73 74 3a 38 30 38 30 2f 3c 2f 61 3e 20 61 6e 64 st:8080/</a> and
3190: 20 62 65 67 69 6e 20 65 78 70 6c 6f 72 69 6e 67 begin exploring
31a0: 2e 20 20 4f 72 20 79 6f 75 72 20 63 6f 77 6f 72 . Or your cowor
31b0: 6b 65 72 73 0a 63 61 6e 20 64 6f 20 70 75 73 68 kers.can do push
31c0: 65 73 20 6f 72 20 70 75 6c 6c 73 20 61 67 61 69 es or pulls agai
31d0: 6e 73 74 20 79 6f 75 72 20 73 65 72 76 65 72 2e nst your server.
31e0: 20 20 55 73 65 20 74 68 65 20 3c 62 3e 2d 2d 70 Use the <b>--p
31f0: 6f 72 74 3c 2f 62 3e 0a 6f 70 74 69 6f 6e 20 74 ort</b>.option t
3200: 6f 20 74 68 65 20 73 65 72 76 65 72 20 63 6f 6d o the server com
3210: 6d 61 6e 64 20 74 6f 20 73 70 65 63 69 66 79 20 mand to specify
3220: 61 20 64 69 66 66 65 72 65 6e 74 20 54 43 50 20 a different TCP
3230: 70 6f 72 74 2e 20 20 49 66 0a 79 6f 75 20 64 6f port. If.you do
3240: 20 6e 6f 74 20 68 61 76 65 20 61 20 6c 6f 63 61 not have a loca
3250: 6c 20 73 6f 75 72 63 65 20 74 72 65 65 2c 20 75 l source tree, u
3260: 73 65 20 74 68 65 20 3c 62 3e 2d 52 3c 2f 62 3e se the <b>-R</b>
3270: 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 0a 6f 70 command-line.op
3280: 74 69 6f 6e 20 74 6f 20 73 70 65 63 69 66 79 20 tion to specify
3290: 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 20 66 the repository f
32a0: 69 6c 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 41 20 73 ile.</p>..<p>A s
32b0: 74 61 6e 64 2d 61 6c 6f 6e 65 20 73 65 72 76 65 tand-alone serve
32c0: 72 20 69 73 20 61 20 67 72 65 61 74 20 77 61 79 r is a great way
32d0: 20 74 6f 20 73 65 74 20 6f 66 20 74 72 61 6e 73 to set of trans
32e0: 69 65 6e 74 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 ient connections
32f0: 0a 62 65 74 77 65 65 6e 20 63 6f 77 6f 72 6b 65 .between coworke
3300: 72 73 20 66 6f 72 20 64 6f 69 6e 67 20 71 75 69 rs for doing qui
3310: 63 6b 20 70 75 73 68 65 73 20 6f 72 20 70 75 6c ck pushes or pul
3320: 6c 73 2e 20 20 42 75 74 20 79 6f 75 20 63 61 6e ls. But you can
3330: 20 61 6c 73 6f 0a 73 65 74 20 75 70 20 61 20 70 also.set up a p
3340: 65 72 6d 61 6e 65 6e 74 20 73 74 61 6e 64 2d 61 ermanent stand-a
3350: 6c 6f 6e 65 20 73 65 72 76 65 72 20 69 66 20 79 lone server if y
3360: 6f 75 20 70 72 65 66 65 72 2e 20 20 4a 75 73 74 ou prefer. Just
3370: 20 6d 61 6b 65 0a 61 72 72 61 6e 67 65 6d 65 6e make.arrangemen
3380: 74 73 20 66 6f 72 20 66 6f 73 73 69 6c 20 74 6f ts for fossil to
3390: 20 62 65 20 6c 61 75 6e 63 68 65 64 20 77 69 74 be launched wit
33a0: 68 20 61 70 70 72 6f 70 72 69 61 74 65 20 61 72 h appropriate ar
33b0: 67 75 6d 65 6e 74 73 0a 61 66 74 65 72 20 65 76 guments.after ev
33c0: 65 72 79 20 72 65 62 6f 6f 74 2e 3c 2f 70 3e 0a ery reboot.</p>.
33d0: 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 </li>..<li><p><b
33e0: 3e 53 65 74 74 69 6e 67 20 75 70 20 61 20 43 47 >Setting up a CG
33f0: 49 20 73 65 72 76 65 72 3c 2f 62 3e 3c 2f 70 3e I server</b></p>
3400: 0a 0a 3c 70 3e 49 66 20 79 6f 75 20 68 61 76 65 ..<p>If you have
3410: 20 61 20 77 65 62 73 65 72 76 65 72 20 72 75 6e a webserver run
3420: 6e 69 6e 67 20 6f 6e 20 79 6f 75 72 20 6d 61 63 ning on your mac
3430: 68 69 6e 65 20 61 6c 72 65 61 64 79 2c 20 79 6f hine already, yo
3440: 75 20 63 61 6e 0a 73 65 74 20 75 70 20 66 6f 73 u can.set up fos
3450: 73 69 6c 20 74 6f 20 62 65 20 72 75 6e 20 66 72 sil to be run fr
3460: 6f 6d 20 43 47 49 2e 20 20 53 69 6d 70 6c 79 20 om CGI. Simply
3470: 63 72 65 61 74 65 20 61 6e 20 65 78 65 63 75 74 create an execut
3480: 61 62 6c 65 20 73 63 72 69 70 74 0a 74 68 61 74 able script.that
3490: 20 6c 6f 6f 6b 73 20 73 6f 6d 65 74 68 69 6e 67 looks something
34a0: 20 6c 69 6b 65 20 74 68 69 73 3a 3c 2f 70 3e 0a like this:</p>.
34b0: 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 .<blockquote><pr
34c0: 65 3e 0a 23 21 2f 75 73 72 2f 6c 6f 63 61 6c 2f e>.#!/usr/local/
34d0: 62 69 6e 2f 66 6f 73 73 69 6c 0a 72 65 70 6f 73 bin/fossil.repos
34e0: 69 74 6f 72 79 3a 20 2f 68 6f 6d 65 2f 6d 65 2f itory: /home/me/
34f0: 62 69 67 70 72 6f 6a 65 63 74 2e 66 6f 73 73 69 bigproject.fossi
3500: 6c 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 l.</pre></blockq
3510: 75 6f 74 65 3e 0a 0a 3c 70 3e 45 64 69 74 20 74 uote>..<p>Edit t
3520: 68 69 73 20 73 63 72 69 70 74 20 74 6f 20 75 73 his script to us
3530: 65 20 77 68 61 74 65 76 65 72 20 70 61 74 68 6e e whatever pathn
3540: 61 6d 65 73 20 61 72 65 20 61 70 70 72 6f 70 72 ames are appropr
3550: 69 61 74 65 20 66 6f 72 0a 79 6f 75 72 20 70 72 iate for.your pr
3560: 6f 6a 65 63 74 2e 20 20 54 68 65 6e 20 70 6f 69 oject. Then poi
3570: 6e 74 20 79 6f 75 72 20 77 65 62 62 72 6f 77 73 nt your webbrows
3580: 65 72 20 61 74 20 74 68 65 20 73 63 72 69 70 74 er at the script
3590: 20 61 6e 64 20 6f 66 66 20 79 6f 75 0a 67 6f 2e and off you.go.
35a0: 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c </p></li>..<li><
35b0: 70 3e 3c 62 3e 53 65 74 74 69 6e 67 20 75 70 20 p><b>Setting up
35c0: 61 6e 20 69 6e 65 74 64 20 73 65 72 76 65 72 3c an inetd server<
35d0: 2f 62 3e 3c 2f 70 3e 0a 0a 3c 70 3e 49 66 20 79 /b></p>..<p>If y
35e0: 6f 75 20 68 61 76 65 20 69 6e 65 74 64 20 6f 72 ou have inetd or
35f0: 20 78 69 6e 65 74 64 20 72 75 6e 6e 69 6e 67 20 xinetd running
3600: 6f 6e 20 79 6f 75 72 20 73 79 73 74 65 6d 2c 20 on your system,
3610: 79 6f 75 20 63 61 6e 20 73 65 74 0a 74 68 6f 73 you can set.thos
3620: 65 20 73 65 72 76 69 63 65 73 20 75 70 20 74 6f e services up to
3630: 20 6c 61 75 6e 63 68 20 66 6f 73 73 69 6c 20 74 launch fossil t
3640: 6f 20 64 65 61 6c 20 77 69 74 68 20 69 6e 62 6f o deal with inbo
3650: 75 6e 64 20 54 43 50 2f 49 50 20 63 6f 6e 6e 65 und TCP/IP conne
3660: 63 74 69 6f 6e 73 0a 6f 6e 20 77 68 61 74 65 76 ctions.on whatev
3670: 65 72 20 70 6f 72 74 20 79 6f 75 20 77 61 6e 74 er port you want
3680: 2e 20 20 53 65 74 20 75 70 20 69 6e 65 74 64 20 . Set up inetd
3690: 6f 72 20 78 69 6e 65 74 64 20 74 6f 20 6c 61 75 or xinetd to lau
36a0: 6e 63 68 20 66 6f 73 73 69 6c 0a 6c 69 6b 65 20 nch fossil.like
36b0: 74 68 69 73 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 this:</p>..<bloc
36c0: 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a 2f 75 73 kquote><pre>./us
36d0: 72 2f 6c 6f 63 61 6c 2f 62 69 6e 2f 66 6f 73 73 r/local/bin/foss
36e0: 69 6c 20 68 74 74 70 20 2f 68 6f 6d 65 2f 6d 65 il http /home/me
36f0: 2f 62 69 67 70 72 6f 6a 65 63 74 2e 66 6f 73 73 /bigproject.foss
3700: 69 6c 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b il.</pre></block
3710: 71 75 6f 74 65 3e 0a 0a 3c 70 3e 41 73 20 62 65 quote>..<p>As be
3720: 66 6f 72 65 2c 20 63 68 61 6e 67 65 20 74 68 65 fore, change the
3730: 20 66 69 6c 65 6e 61 6d 65 73 20 74 6f 20 77 68 filenames to wh
3740: 61 74 65 76 65 72 20 69 73 20 61 70 70 72 6f 70 atever is approp
3750: 72 69 61 74 65 20 66 6f 72 0a 79 6f 75 72 20 73 riate for.your s
3760: 79 73 74 65 6d 2e 20 20 59 6f 75 20 63 61 6e 20 ystem. You can
3770: 68 61 76 65 20 66 6f 73 73 69 6c 20 72 75 6e 20 have fossil run
3780: 61 73 20 61 6e 79 20 75 73 65 72 20 74 68 61 74 as any user that
3790: 20 68 61 73 20 77 72 69 74 65 0a 70 65 72 6d 69 has write.permi
37a0: 73 73 69 6f 6e 20 6f 6e 20 74 68 65 20 72 65 70 ssion on the rep
37b0: 6f 73 69 74 6f 72 79 20 61 6e 64 20 6f 6e 20 74 ository and on t
37c0: 68 65 20 64 69 72 65 63 74 6f 72 79 20 74 68 61 he directory tha
37d0: 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 0a 72 t contains the.r
37e0: 65 70 6f 73 69 74 6f 72 79 2e 20 20 42 75 74 20 epository. But
37f0: 69 74 20 69 73 20 73 61 66 65 72 20 74 6f 20 72 it is safer to r
3800: 75 6e 20 66 6f 73 73 69 6c 20 61 73 20 72 6f 6f un fossil as roo
3810: 74 2e 20 20 57 68 65 6e 20 66 6f 73 73 69 6c 0a t. When fossil.
3820: 73 65 65 73 20 74 68 61 74 20 69 74 20 69 73 20 sees that it is
3830: 72 75 6e 6e 69 6e 67 20 61 73 20 72 6f 6f 74 2c running as root,
3840: 20 69 74 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c it automaticall
3850: 79 20 70 75 74 73 20 69 74 73 65 6c 66 20 69 6e y puts itself in
3860: 74 6f 0a 61 20 3c 61 20 68 72 65 66 3d 22 68 74 to.a <a href="ht
3870: 74 70 3a 2f 2f 65 6e 2e 77 69 6b 69 70 65 64 69 tp://en.wikipedi
3880: 61 2e 6f 72 67 2f 77 69 6b 69 2f 43 68 72 6f 6f a.org/wiki/Chroo
3890: 74 22 3e 63 68 72 6f 6f 74 20 6a 61 69 6c 3c 2f t">chroot jail</
38a0: 61 3e 20 61 6e 64 0a 64 72 6f 70 73 20 61 6c 6c a> and.drops all
38b0: 20 70 72 69 76 69 6c 65 67 65 73 20 70 72 69 6f privileges prio
38c0: 72 20 74 6f 20 72 65 61 64 69 6e 67 20 61 6e 79 r to reading any
38d0: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f information fro
38e0: 6d 20 74 68 65 20 63 6c 69 65 6e 74 2e 0a 53 69 m the client..Si
38f0: 6e 63 65 20 66 6f 73 73 69 6c 20 69 73 20 61 20 nce fossil is a
3900: 73 74 61 6e 64 2d 61 6c 6f 6e 65 20 70 72 6f 67 stand-alone prog
3910: 72 61 6d 2c 20 79 6f 75 20 64 6f 20 6e 6f 74 20 ram, you do not
3920: 6e 65 65 64 20 74 6f 20 70 75 74 20 61 6e 79 74 need to put anyt
3930: 68 69 6e 67 0a 69 6e 20 74 68 65 20 63 68 72 6f hing.in the chro
3940: 6f 74 20 6a 61 69 6c 20 77 69 74 68 20 66 6f 73 ot jail with fos
3950: 73 69 6c 20 69 6e 20 6f 72 64 65 72 20 66 6f 72 sil in order for
3960: 20 69 74 20 74 6f 20 64 6f 20 69 74 73 20 6a 6f it to do its jo
3970: 62 2e 3c 2f 70 3e 0a 3c 2f 6c 69 3e 0a 3c 2f 6f b.</p>.</li>.</o
3980: 6c 3e 0a l>.