0000: 3c 74 69 74 6c 65 3e 46 6f 73 73 69 6c 20 46 69 <title>Fossil Fi
0010: 6c 65 20 46 6f 72 6d 61 74 73 3c 2f 74 69 74 6c le Formats</titl
0020: 65 3e 0a 3c 68 31 20 61 6c 69 67 6e 3d 22 63 65 e>.<h1 align="ce
0030: 6e 74 65 72 22 3e 0a 46 6f 73 73 69 6c 20 46 69 nter">.Fossil Fi
0040: 6c 65 20 46 6f 72 6d 61 74 73 0a 3c 2f 68 31 3e le Formats.</h1>
0050: 0a 0a 54 68 65 20 67 6c 6f 62 61 6c 20 73 74 61 ..The global sta
0060: 74 65 20 6f 66 20 61 20 66 6f 73 73 69 6c 20 72 te of a fossil r
0070: 65 70 6f 73 69 74 6f 72 79 20 69 73 20 6b 65 70 epository is kep
0080: 74 20 73 69 6d 70 6c 65 20 73 6f 20 74 68 61 74 t simple so that
0090: 20 69 74 20 63 61 6e 0a 65 6e 64 75 72 65 20 69 it can.endure i
00a0: 6e 20 75 73 65 66 75 6c 20 66 6f 72 6d 20 66 6f n useful form fo
00b0: 72 20 64 65 63 61 64 65 73 20 6f 72 20 63 65 6e r decades or cen
00c0: 74 75 72 69 65 73 2e 20 0a 41 20 66 6f 73 73 69 turies. .A fossi
00d0: 6c 20 72 65 70 6f 73 69 74 6f 72 79 20 69 73 20 l repository is
00e0: 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 20 72 intended to be r
00f0: 65 61 64 61 62 6c 65 2c 0a 73 65 61 72 63 68 61 eadable,.searcha
0100: 62 6c 65 2c 20 61 6e 64 20 65 78 74 65 6e 73 69 ble, and extensi
0110: 62 6c 65 20 62 79 20 70 65 6f 70 6c 65 20 6e 6f ble by people no
0120: 74 20 79 65 74 20 62 6f 72 6e 2e 0a 0a 54 68 65 t yet born...The
0130: 20 67 6c 6f 62 61 6c 20 73 74 61 74 65 20 6f 66 global state of
0140: 20 61 20 66 6f 73 73 69 6c 20 72 65 70 6f 73 69 a fossil reposi
0150: 74 6f 72 79 20 69 73 20 61 6e 20 75 6e 6f 72 64 tory is an unord
0160: 65 72 65 64 0a 73 65 74 20 6f 66 20 3c 69 3e 61 ered.set of <i>a
0170: 72 74 69 66 61 63 74 73 3c 2f 69 3e 2e 0a 41 6e rtifacts</i>..An
0180: 20 61 72 74 69 66 61 63 74 20 6d 69 67 68 74 20 artifact might
0190: 62 65 20 61 20 73 6f 75 72 63 65 20 63 6f 64 65 be a source code
01a0: 20 66 69 6c 65 2c 20 74 68 65 20 74 65 78 74 20 file, the text
01b0: 6f 66 20 61 20 77 69 6b 69 20 70 61 67 65 2c 0a of a wiki page,.
01c0: 70 61 72 74 20 6f 66 20 61 20 74 72 6f 75 62 6c part of a troubl
01d0: 65 20 74 69 63 6b 65 74 2c 20 6f 72 20 6f 6e 65 e ticket, or one
01e0: 20 6f 66 20 73 65 76 65 72 61 6c 20 73 70 65 63 of several spec
01f0: 69 61 6c 20 63 6f 6e 74 72 6f 6c 20 61 72 74 69 ial control arti
0200: 66 61 63 74 73 0a 75 73 65 64 20 74 6f 20 73 68 facts.used to sh
0210: 6f 77 20 74 68 65 20 72 65 6c 61 74 69 6f 6e 73 ow the relations
0220: 68 69 70 73 20 62 65 74 77 65 65 6e 20 6f 74 68 hips between oth
0230: 65 72 20 61 72 74 69 66 61 63 74 73 20 77 69 74 er artifacts wit
0240: 68 69 6e 20 74 68 65 0a 70 72 6f 6a 65 63 74 2e hin the.project.
0250: 20 20 45 61 63 68 20 61 72 74 69 66 61 63 74 20 Each artifact
0260: 69 73 20 6e 6f 72 6d 61 6c 6c 79 20 72 65 70 72 is normally repr
0270: 65 73 65 6e 74 65 64 20 6f 6e 20 64 69 73 6b 20 esented on disk
0280: 61 73 20 61 20 73 65 70 61 72 61 74 65 0a 66 69 as a separate.fi
0290: 6c 65 2e 20 20 41 72 74 69 66 61 63 74 73 20 63 le. Artifacts c
02a0: 61 6e 20 62 65 20 74 65 78 74 20 6f 72 20 62 69 an be text or bi
02b0: 6e 61 72 79 2e 0a 0a 49 6e 20 61 64 64 69 74 69 nary...In additi
02c0: 6f 6e 20 74 6f 20 74 68 65 20 67 6c 6f 62 61 6c on to the global
02d0: 20 73 74 61 74 65 2c 20 0a 65 61 63 68 20 66 6f state, .each fo
02e0: 73 73 69 6c 20 72 65 70 6f 73 69 74 6f 72 79 20 ssil repository
02f0: 61 6c 73 6f 20 63 6f 6e 74 61 69 6e 73 20 6c 6f also contains lo
0300: 63 61 6c 20 73 74 61 74 65 2e 0a 54 68 65 20 6c cal state..The l
0310: 6f 63 61 6c 20 73 74 61 74 65 20 63 6f 6e 73 69 ocal state consi
0320: 73 74 73 20 6f 66 20 77 65 62 2d 70 61 67 65 20 sts of web-page
0330: 66 6f 72 6d 61 74 74 69 6e 67 0a 70 72 65 66 65 formatting.prefe
0340: 72 65 6e 63 65 73 2c 20 61 75 74 68 6f 72 69 7a rences, authoriz
0350: 65 64 20 75 73 65 72 73 2c 20 74 69 63 6b 65 74 ed users, ticket
0360: 20 64 69 73 70 6c 61 79 20 61 6e 64 20 72 65 70 display and rep
0370: 6f 72 74 69 6e 67 20 66 6f 72 6d 61 74 73 2c 0a orting formats,.
0380: 61 6e 64 20 73 6f 20 66 6f 72 74 68 2e 20 20 54 and so forth. T
0390: 68 65 20 67 6c 6f 62 61 6c 20 73 74 61 74 65 20 he global state
03a0: 69 73 20 73 68 61 72 65 64 20 69 6e 20 63 6f 6d is shared in com
03b0: 6d 6f 6e 20 61 6d 6f 6e 67 20 61 6c 6c 0a 72 65 mon among all.re
03c0: 70 6f 73 69 74 6f 72 69 65 73 20 66 6f 72 20 74 positories for t
03d0: 68 65 20 73 61 6d 65 20 70 72 6f 6a 65 63 74 2c he same project,
03e0: 20 77 68 65 72 65 61 73 20 74 68 65 20 6c 6f 63 whereas the loc
03f0: 61 6c 20 73 74 61 74 65 20 69 73 20 6f 66 74 65 al state is ofte
0400: 6e 0a 64 69 66 66 65 72 65 6e 74 20 69 6e 20 73 n.different in s
0410: 65 70 61 72 61 74 65 20 72 65 70 6f 73 69 74 6f eparate reposito
0420: 72 69 65 73 2e 0a 54 68 65 20 6c 6f 63 61 6c 20 ries..The local
0430: 73 74 61 74 65 20 69 73 20 6e 6f 74 20 76 65 72 state is not ver
0440: 73 69 6f 6e 65 64 20 61 6e 64 20 69 73 20 6e 6f sioned and is no
0450: 74 20 73 79 6e 63 68 72 6f 6e 69 7a 65 64 0a 77 t synchronized.w
0460: 69 74 68 20 74 68 65 20 67 6c 6f 62 61 6c 20 73 ith the global s
0470: 74 61 74 65 2e 0a 54 68 65 20 6c 6f 63 61 6c 20 tate..The local
0480: 73 74 61 74 65 20 69 73 20 6e 6f 74 20 63 6f 6d state is not com
0490: 70 6f 73 65 64 20 6f 66 20 61 72 74 69 66 61 63 posed of artifac
04a0: 74 73 20 61 6e 64 20 69 73 20 6e 6f 74 20 69 6e ts and is not in
04b0: 74 65 6e 64 65 64 20 74 6f 20 62 65 20 65 6e 64 tended to be end
04c0: 75 72 69 6e 67 2e 0a 54 68 69 73 20 64 6f 63 75 uring..This docu
04d0: 6d 65 6e 74 20 69 73 20 63 6f 6e 63 65 72 6e 65 ment is concerne
04e0: 64 20 77 69 74 68 20 67 6c 6f 62 61 6c 20 73 74 d with global st
04f0: 61 74 65 20 6f 6e 6c 79 2e 20 20 4c 6f 63 61 6c ate only. Local
0500: 20 73 74 61 74 65 20 69 73 20 6f 6e 6c 79 0a 6d state is only.m
0510: 65 6e 74 69 6f 6e 65 64 20 68 65 72 65 20 69 6e entioned here in
0520: 20 6f 72 64 65 72 20 74 6f 20 64 69 73 74 69 6e order to distin
0530: 67 75 69 73 68 20 69 74 20 66 72 6f 6d 20 67 6c guish it from gl
0540: 6f 62 61 6c 20 73 74 61 74 65 2e 0a 0a 45 61 63 obal state...Eac
0550: 68 20 61 72 74 69 66 61 63 74 20 69 6e 20 74 68 h artifact in th
0560: 65 20 72 65 70 6f 73 69 74 6f 72 79 20 69 73 20 e repository is
0570: 6e 61 6d 65 64 20 62 79 20 69 74 73 20 53 48 41 named by its SHA
0580: 31 20 68 61 73 68 2e 0a 4e 6f 20 70 72 65 66 69 1 hash..No prefi
0590: 78 65 73 20 6f 72 20 6d 65 74 61 20 69 6e 66 6f xes or meta info
05a0: 72 6d 61 74 69 6f 6e 20 69 73 20 61 64 64 65 64 rmation is added
05b0: 20 74 6f 20 61 20 61 72 74 69 66 61 63 74 20 62 to a artifact b
05c0: 65 66 6f 72 65 0a 69 74 73 20 68 61 73 68 20 69 efore.its hash i
05d0: 73 20 63 6f 6d 70 75 74 65 64 2e 20 20 54 68 65 s computed. The
05e0: 20 6e 61 6d 65 20 6f 66 20 61 20 61 72 74 69 66 name of a artif
05f0: 61 63 74 20 69 6e 20 74 68 65 20 72 65 70 6f 73 act in the repos
0600: 69 74 6f 72 79 0a 69 73 20 65 78 61 63 74 6c 79 itory.is exactly
0610: 20 74 68 65 20 73 61 6d 65 20 53 48 41 31 20 68 the same SHA1 h
0620: 61 73 68 20 74 68 61 74 20 69 73 20 63 6f 6d 70 ash that is comp
0630: 75 74 65 64 20 62 79 20 73 68 61 31 73 75 6d 20 uted by sha1sum
0640: 0a 6f 6e 20 74 68 65 20 66 69 6c 65 20 61 73 20 .on the file as
0650: 69 74 20 65 78 69 73 74 73 20 69 6e 20 79 6f 75 it exists in you
0660: 72 20 73 6f 75 72 63 65 20 74 72 65 65 2e 3c 2f r source tree.</
0670: 70 3e 0a 0a 53 6f 6d 65 20 61 72 74 69 66 61 63 p>..Some artifac
0680: 74 73 20 68 61 76 65 20 61 20 70 61 72 74 69 63 ts have a partic
0690: 75 6c 61 72 20 66 6f 72 6d 61 74 20 77 68 69 63 ular format whic
06a0: 68 20 67 69 76 65 73 20 74 68 65 6d 20 73 70 65 h gives them spe
06b0: 63 69 61 6c 0a 6d 65 61 6e 69 6e 67 20 74 6f 20 cial.meaning to
06c0: 66 6f 73 73 69 6c 2e 20 20 46 6f 73 73 69 6c 20 fossil. Fossil
06d0: 72 65 63 6f 67 6e 69 7a 65 73 3a 0a 0a 3c 75 6c recognizes:..<ul
06e0: 3e 0a 3c 6c 69 3e 20 5b 23 6d 61 6e 69 66 65 73 >.<li> [#manifes
06f0: 74 20 7c 20 4d 61 6e 69 66 65 73 74 73 5d 20 3c t | Manifests] <
0700: 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 23 63 6c 75 73 /li>.<li> [#clus
0710: 74 65 72 20 7c 20 43 6c 75 73 74 65 72 73 5d 20 ter | Clusters]
0720: 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 23 63 74 72 </li>.<li> [#ctr
0730: 6c 20 7c 20 43 6f 6e 74 72 6f 6c 20 41 72 74 69 l | Control Arti
0740: 66 61 63 74 73 5d 20 3c 2f 6c 69 3e 0a 3c 6c 69 facts] </li>.<li
0750: 3e 20 5b 23 77 69 6b 69 63 68 6e 67 20 7c 20 57 > [#wikichng | W
0760: 69 6b 69 20 50 61 67 65 73 5d 20 3c 2f 6c 69 3e iki Pages] </li>
0770: 0a 3c 6c 69 3e 20 5b 23 74 6b 74 63 68 6e 67 20 .<li> [#tktchng
0780: 7c 20 54 69 63 6b 65 74 20 43 68 61 6e 67 65 73 | Ticket Changes
0790: 5d 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 5b 23 61 ] </li>.<li> [#a
07a0: 74 74 61 63 68 6d 65 6e 74 20 7c 20 41 74 74 61 ttachment | Atta
07b0: 63 68 6d 65 6e 74 73 5d 20 3c 2f 6c 69 3e 0a 3c chments] </li>.<
07c0: 6c 69 3e 20 5b 23 65 76 65 6e 74 20 7c 20 45 76 li> [#event | Ev
07d0: 65 6e 74 73 5d 20 3c 2f 6c 69 3e 0a 3c 2f 75 6c ents] </li>.</ul
07e0: 3e 0a 0a 54 68 65 73 65 20 73 65 76 65 6e 20 61 >..These seven a
07f0: 72 74 69 66 61 63 74 20 74 79 70 65 73 20 61 72 rtifact types ar
0800: 65 20 64 65 73 63 72 69 62 65 64 20 69 6e 20 74 e described in t
0810: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 65 63 he following sec
0820: 74 69 6f 6e 73 2e 0a 0a 49 6e 20 74 68 65 20 63 tions...In the c
0830: 75 72 72 65 6e 74 20 69 6d 70 6c 65 6d 65 6e 74 urrent implement
0840: 61 74 69 6f 6e 20 28 61 73 20 6f 66 20 32 30 30 ation (as of 200
0850: 39 2d 30 31 2d 32 35 29 20 74 68 65 20 61 72 74 9-01-25) the art
0860: 69 66 61 63 74 73 20 74 68 61 74 0a 6d 61 6b 65 ifacts that.make
0870: 20 75 70 20 61 20 66 6f 73 73 69 6c 20 72 65 70 up a fossil rep
0880: 6f 73 69 74 6f 72 79 20 61 72 65 20 73 74 6f 72 ository are stor
0890: 65 64 20 69 6e 20 69 6e 20 61 73 20 64 65 6c 74 ed in in as delt
08a0: 61 2d 20 61 6e 64 20 7a 6c 69 62 2d 63 6f 6d 70 a- and zlib-comp
08b0: 72 65 73 73 65 64 0a 62 6c 6f 62 73 20 69 6e 20 ressed.blobs in
08c0: 61 6e 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 an <a href="http
08d0: 3a 2f 2f 77 77 77 2e 73 71 6c 69 74 65 2e 6f 72 ://www.sqlite.or
08e0: 67 2f 22 3e 53 51 4c 69 74 65 3c 2f 61 3e 20 64 g/">SQLite</a> d
08f0: 61 74 61 62 61 73 65 2e 20 20 54 68 69 73 0a 69 atabase. This.i
0900: 73 20 61 6e 20 69 6d 70 6c 65 6d 65 6e 74 61 74 s an implementat
0910: 69 6f 6e 20 64 65 74 61 69 6c 20 61 6e 64 20 6d ion detail and m
0920: 69 67 68 74 20 63 68 61 6e 67 65 20 69 6e 20 61 ight change in a
0930: 20 66 75 74 75 72 65 20 72 65 6c 65 61 73 65 2e future release.
0940: 20 20 46 6f 72 0a 74 68 65 20 70 75 72 70 6f 73 For.the purpos
0950: 65 20 6f 66 20 74 68 69 73 20 61 72 74 69 63 6c e of this articl
0960: 65 20 22 66 69 6c 65 20 66 6f 72 6d 61 74 22 20 e "file format"
0970: 6d 65 61 6e 73 20 74 68 65 20 66 6f 72 6d 61 74 means the format
0980: 20 6f 66 20 74 68 65 20 61 72 74 69 66 61 63 74 of the artifact
0990: 73 2c 0a 6e 6f 74 20 68 6f 77 20 74 68 65 20 61 s,.not how the a
09a0: 72 74 69 66 61 63 74 73 20 61 72 65 20 73 74 6f rtifacts are sto
09b0: 72 65 64 20 6f 6e 20 64 69 73 6b 2e 20 20 49 74 red on disk. It
09c0: 20 69 73 20 74 68 65 20 61 72 74 69 66 61 63 74 is the artifact
09d0: 20 66 6f 72 6d 61 74 20 74 68 61 74 0a 69 73 20 format that.is
09e0: 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 65 20 65 intended to be e
09f0: 6e 64 75 72 69 6e 67 2e 20 20 54 68 65 20 73 70 nduring. The sp
0a00: 65 63 69 66 69 63 73 20 6f 66 20 68 6f 77 20 61 ecifics of how a
0a10: 72 74 69 66 61 63 74 73 20 61 72 65 20 73 74 6f rtifacts are sto
0a20: 72 65 64 20 6f 6e 0a 64 69 73 6b 2c 20 74 68 6f red on.disk, tho
0a30: 75 67 68 20 73 74 61 62 6c 65 2c 20 69 73 20 6e ugh stable, is n
0a40: 6f 74 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 6c ot intended to l
0a50: 69 76 65 20 61 73 20 6c 6f 6e 67 20 61 73 20 74 ive as long as t
0a60: 68 65 0a 61 72 74 69 66 61 63 74 20 66 6f 72 6d he.artifact form
0a70: 61 74 2e 0a 0a 41 6c 6c 20 6f 66 20 74 68 65 20 at...All of the
0a80: 61 72 74 69 66 61 63 74 73 20 63 61 6e 20 62 65 artifacts can be
0a90: 20 65 78 74 72 61 63 74 65 64 20 66 72 6f 6d 20 extracted from
0aa0: 61 20 46 6f 73 73 69 6c 20 72 65 70 6f 73 69 74 a Fossil reposit
0ab0: 6f 72 79 20 75 73 69 6e 67 0a 74 68 65 20 22 66 ory using.the "f
0ac0: 6f 73 73 69 6c 20 64 65 63 6f 6e 73 74 72 75 63 ossil deconstruc
0ad0: 74 22 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 3c 61 20 t" command...<a
0ae0: 6e 61 6d 65 3d 22 6d 61 6e 69 66 65 73 74 22 3e name="manifest">
0af0: 3c 2f 61 3e 0a 3c 68 32 3e 31 2e 30 20 54 68 65 </a>.<h2>1.0 The
0b00: 20 4d 61 6e 69 66 65 73 74 3c 2f 68 32 3e 0a 0a Manifest</h2>..
0b10: 41 20 6d 61 6e 69 66 65 73 74 20 64 65 66 69 6e A manifest defin
0b20: 65 73 20 61 20 63 68 65 63 6b 2d 69 6e 20 6f 72 es a check-in or
0b30: 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 version of the
0b40: 70 72 6f 6a 65 63 74 0a 73 6f 75 72 63 65 20 74 project.source t
0b50: 72 65 65 2e 20 20 54 68 65 20 6d 61 6e 69 66 65 ree. The manife
0b60: 73 74 20 63 6f 6e 74 61 69 6e 73 20 61 20 6c 69 st contains a li
0b70: 73 74 20 6f 66 20 61 72 74 69 66 61 63 74 73 20 st of artifacts
0b80: 66 6f 72 0a 65 61 63 68 20 66 69 6c 65 20 69 6e for.each file in
0b90: 20 74 68 65 20 70 72 6f 6a 65 63 74 20 61 6e 64 the project and
0ba0: 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 the correspondi
0bb0: 6e 67 20 66 69 6c 65 6e 61 6d 65 73 2c 20 61 73 ng filenames, as
0bc0: 0a 77 65 6c 6c 20 61 73 20 69 6e 66 6f 72 6d 61 .well as informa
0bd0: 74 69 6f 6e 20 73 75 63 68 20 61 73 20 70 61 72 tion such as par
0be0: 65 6e 74 20 63 68 65 63 6b 2d 69 6e 73 2c 20 74 ent check-ins, t
0bf0: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 0a 70 he name of the.p
0c00: 72 6f 67 72 61 6d 6d 65 72 20 77 68 6f 20 63 72 rogrammer who cr
0c10: 65 61 74 65 64 20 74 68 65 20 63 68 65 63 6b 2d eated the check-
0c20: 69 6e 2c 20 74 68 65 20 64 61 74 65 20 61 6e 64 in, the date and
0c30: 20 74 69 6d 65 20 77 68 65 6e 0a 74 68 65 20 63 time when.the c
0c40: 68 65 63 6b 2d 69 6e 20 77 61 73 20 63 72 65 61 heck-in was crea
0c50: 74 65 64 2c 20 61 6e 64 20 61 6e 79 20 63 68 65 ted, and any che
0c60: 63 6b 2d 69 6e 20 63 6f 6d 6d 65 6e 74 73 20 61 ck-in comments a
0c70: 73 73 6f 63 69 61 74 65 64 0a 77 69 74 68 20 74 ssociated.with t
0c80: 68 65 20 63 68 65 63 6b 2d 69 6e 2e 0a 0a 41 6e he check-in...An
0c90: 79 20 61 72 74 69 66 61 63 74 20 69 6e 20 74 68 y artifact in th
0ca0: 65 20 72 65 70 6f 73 69 74 6f 72 79 20 74 68 61 e repository tha
0cb0: 74 20 66 6f 6c 6c 6f 77 73 20 74 68 65 20 73 79 t follows the sy
0cc0: 6e 74 61 63 74 69 63 20 72 75 6c 65 73 0a 6f 66 ntactic rules.of
0cd0: 20 61 20 6d 61 6e 69 66 65 73 74 20 69 73 20 61 a manifest is a
0ce0: 20 6d 61 6e 69 66 65 73 74 2e 20 20 4e 6f 74 65 manifest. Note
0cf0: 20 74 68 61 74 20 61 20 6d 61 6e 69 66 65 73 74 that a manifest
0d00: 20 63 61 6e 0a 62 65 20 62 6f 74 68 20 61 20 72 can.be both a r
0d10: 65 61 6c 20 6d 61 6e 69 66 65 73 74 20 61 6e 64 eal manifest and
0d20: 20 61 6c 73 6f 20 61 20 63 6f 6e 74 65 6e 74 20 also a content
0d30: 66 69 6c 65 2c 20 74 68 6f 75 67 68 20 74 68 69 file, though thi
0d40: 73 0a 69 73 20 72 61 72 65 2e 0a 0a 41 20 6d 61 s.is rare...A ma
0d50: 6e 69 66 65 73 74 20 69 73 20 61 20 74 65 78 74 nifest is a text
0d60: 20 66 69 6c 65 2e 20 20 4e 65 77 6c 69 6e 65 20 file. Newline
0d70: 63 68 61 72 61 63 74 65 72 73 0a 28 41 53 43 49 characters.(ASCI
0d80: 49 20 30 78 30 61 29 20 73 65 70 61 72 61 74 65 I 0x0a) separate
0d90: 20 74 68 65 20 66 69 6c 65 20 69 6e 74 6f 20 22 the file into "
0da0: 63 61 72 64 73 22 2e 0a 45 61 63 68 20 63 61 72 cards"..Each car
0db0: 64 20 62 65 67 69 6e 73 20 77 69 74 68 20 61 20 d begins with a
0dc0: 73 69 6e 67 6c 65 0a 63 68 61 72 61 63 74 65 72 single.character
0dd0: 20 22 63 61 72 64 20 74 79 70 65 22 2e 20 20 5a "card type". Z
0de0: 65 72 6f 20 6f 72 20 6d 6f 72 65 20 61 72 67 75 ero or more argu
0df0: 6d 65 6e 74 73 20 6d 61 79 20 66 6f 6c 6c 6f 77 ments may follow
0e00: 0a 74 68 65 20 63 61 72 64 20 74 79 70 65 2e 20 .the card type.
0e10: 20 41 6c 6c 20 61 72 67 75 6d 65 6e 74 73 20 61 All arguments a
0e20: 72 65 20 73 65 70 61 72 61 74 65 64 20 66 72 6f re separated fro
0e30: 6d 20 65 61 63 68 20 6f 74 68 65 72 0a 61 6e 64 m each other.and
0e40: 20 66 72 6f 6d 20 74 68 65 20 63 61 72 64 2d 74 from the card-t
0e50: 79 70 65 20 63 68 61 72 61 63 74 65 72 20 62 79 ype character by
0e60: 20 61 20 73 69 6e 67 6c 65 20 73 70 61 63 65 0a a single space.
0e70: 63 68 61 72 61 63 74 65 72 2e 20 20 54 68 65 72 character. Ther
0e80: 65 20 69 73 20 6e 6f 20 73 75 72 70 6c 75 73 20 e is no surplus
0e90: 77 68 69 74 65 20 73 70 61 63 65 20 62 65 74 77 white space betw
0ea0: 65 65 6e 20 61 72 67 75 6d 65 6e 74 73 0a 61 6e een arguments.an
0eb0: 64 20 6e 6f 20 6c 65 61 64 69 6e 67 20 6f 72 20 d no leading or
0ec0: 74 72 61 69 6c 69 6e 67 20 77 68 69 74 65 73 70 trailing whitesp
0ed0: 61 63 65 20 65 78 63 65 70 74 20 66 6f 72 20 74 ace except for t
0ee0: 68 65 20 6e 65 77 6c 69 6e 65 20 0a 63 68 61 72 he newline .char
0ef0: 61 63 74 65 72 20 74 68 61 74 20 61 63 74 73 20 acter that acts
0f00: 61 73 20 74 68 65 20 63 61 72 64 20 73 65 70 61 as the card sepa
0f10: 72 61 74 6f 72 2e 0a 0a 41 6c 6c 20 63 61 72 64 rator...All card
0f20: 73 20 6f 66 20 74 68 65 20 6d 61 6e 69 66 65 73 s of the manifes
0f30: 74 20 6f 63 63 75 72 20 69 6e 20 73 74 72 69 63 t occur in stric
0f40: 74 20 73 6f 72 74 65 64 20 6c 65 78 69 63 6f 67 t sorted lexicog
0f50: 72 61 70 68 69 63 61 6c 20 6f 72 64 65 72 2e 0a raphical order..
0f60: 4e 6f 20 63 61 72 64 20 6d 61 79 20 62 65 20 64 No card may be d
0f70: 75 70 6c 69 63 61 74 65 64 2e 0a 54 68 65 20 65 uplicated..The e
0f80: 6e 74 69 72 65 20 6d 61 6e 69 66 65 73 74 20 6d ntire manifest m
0f90: 61 79 20 62 65 20 50 47 50 20 63 6c 65 61 72 2d ay be PGP clear-
0fa0: 73 69 67 6e 65 64 2c 20 62 75 74 20 6f 74 68 65 signed, but othe
0fb0: 72 77 69 73 65 20 69 74 0a 6d 61 79 20 63 6f 6e rwise it.may con
0fc0: 74 61 69 6e 20 6e 6f 20 61 64 64 69 74 69 6f 6e tain no addition
0fd0: 61 6c 20 74 65 78 74 20 6f 72 20 64 61 74 61 20 al text or data
0fe0: 62 65 79 6f 6e 64 20 77 68 61 74 20 69 73 20 64 beyond what is d
0ff0: 65 73 63 72 69 62 65 64 20 68 65 72 65 2e 0a 0a escribed here...
1000: 41 6c 6c 6f 77 65 64 20 63 61 72 64 73 20 69 6e Allowed cards in
1010: 20 74 68 65 20 6d 61 6e 69 66 65 73 74 20 61 72 the manifest ar
1020: 65 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 0a 3c e as follows:..<
1030: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 62 3e 42 blockquote>.<b>B
1040: 3c 2f 62 3e 20 3c 69 3e 62 61 73 65 6c 69 6e 65 </b> <i>baseline
1050: 2d 6d 61 6e 69 66 65 73 74 3c 2f 69 3e 3c 62 72 -manifest</i><br
1060: 3e 0a 3c 62 3e 43 3c 2f 62 3e 20 3c 69 3e 63 68 >.<b>C</b> <i>ch
1070: 65 63 6b 69 6e 2d 63 6f 6d 6d 65 6e 74 3c 2f 69 eckin-comment</i
1080: 3e 3c 62 72 3e 0a 3c 62 3e 44 3c 2f 62 3e 20 3c ><br>.<b>D</b> <
1090: 69 3e 74 69 6d 65 2d 61 6e 64 2d 64 61 74 65 2d i>time-and-date-
10a0: 73 74 61 6d 70 3c 2f 69 3e 3c 62 72 3e 0a 3c 62 stamp</i><br>.<b
10b0: 3e 46 3c 2f 62 3e 20 3c 69 3e 66 69 6c 65 6e 61 >F</b> <i>filena
10c0: 6d 65 3c 2f 69 3e 20 3f 3c 69 3e 53 48 41 31 2d me</i> ?<i>SHA1-
10d0: 68 61 73 68 3c 2f 69 3e 3f 20 3f 3c 69 3e 70 65 hash</i>? ?<i>pe
10e0: 72 6d 69 73 73 69 6f 6e 73 3c 2f 69 3e 3f 20 3f rmissions</i>? ?
10f0: 3c 69 3e 6f 6c 64 2d 6e 61 6d 65 3c 2f 69 3e 3f <i>old-name</i>?
1100: 3c 62 72 3e 0a 3c 62 3e 4e 3c 2f 62 3e 20 3c 69 <br>.<b>N</b> <i
1110: 3e 6d 69 6d 65 74 79 70 65 3c 2f 69 3e 3c 62 72 >mimetype</i><br
1120: 3e 0a 3c 62 3e 50 3c 2f 62 3e 20 3c 69 3e 53 48 >.<b>P</b> <i>SH
1130: 41 31 2d 68 61 73 68 3c 2f 69 3e 2b 3c 62 72 3e A1-hash</i>+<br>
1140: 0a 3c 62 3e 51 3c 2f 62 3e 20 28 3c 62 3e 2b 3c .<b>Q</b> (<b>+<
1150: 2f 62 3e 7c 3c 62 3e 2d 3c 2f 62 3e 29 3c 69 3e /b>|<b>-</b>)<i>
1160: 53 48 41 31 2d 68 61 73 68 3c 2f 69 3e 20 3f 3c SHA1-hash</i> ?<
1170: 69 3e 53 48 41 31 2d 68 61 73 68 3c 2f 69 3e 3f i>SHA1-hash</i>?
1180: 3c 62 72 3e 0a 3c 62 3e 52 3c 2f 62 3e 20 3c 69 <br>.<b>R</b> <i
1190: 3e 72 65 70 6f 73 69 74 6f 72 79 2d 63 68 65 63 >repository-chec
11a0: 6b 73 75 6d 3c 2f 69 3e 3c 62 72 3e 0a 3c 62 3e ksum</i><br>.<b>
11b0: 54 3c 2f 62 3e 20 28 3c 62 3e 2b 3c 2f 62 3e 7c T</b> (<b>+</b>|
11c0: 3c 62 3e 2d 3c 2f 62 3e 7c 3c 62 3e 2a 3c 2f 62 <b>-</b>|<b>*</b
11d0: 3e 29 3c 69 3e 74 61 67 2d 6e 61 6d 65 3c 2f 69 >)<i>tag-name</i
11e0: 3e 20 3c 62 3e 2a 3c 2f 62 3e 20 3f 3c 69 3e 76 > <b>*</b> ?<i>v
11f0: 61 6c 75 65 3c 2f 69 3e 3f 3c 62 72 3e 0a 3c 62 alue</i>?<br>.<b
1200: 3e 55 3c 2f 62 3e 20 3c 69 3e 75 73 65 72 2d 6c >U</b> <i>user-l
1210: 6f 67 69 6e 3c 2f 69 3e 3c 62 72 3e 0a 3c 62 3e ogin</i><br>.<b>
1220: 5a 3c 2f 62 3e 20 3c 69 3e 6d 61 6e 69 66 65 73 Z</b> <i>manifes
1230: 74 2d 63 68 65 63 6b 73 75 6d 3c 2f 69 3e 0a 3c t-checksum</i>.<
1240: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 41 20 /blockquote>..A
1250: 6d 61 6e 69 66 65 73 74 20 6d 61 79 20 6f 70 74 manifest may opt
1260: 69 6f 6e 61 6c 6c 79 20 68 61 76 65 20 61 20 73 ionally have a s
1270: 69 6e 67 6c 65 20 42 2d 63 61 72 64 2e 20 20 54 ingle B-card. T
1280: 68 65 20 42 2d 63 61 72 64 20 73 70 65 63 69 66 he B-card specif
1290: 69 65 73 0a 61 6e 6f 74 68 65 72 20 6d 61 6e 69 ies.another mani
12a0: 66 65 73 74 20 74 68 61 74 20 73 65 72 76 65 73 fest that serves
12b0: 20 61 73 20 74 68 65 20 22 62 61 73 65 6c 69 6e as the "baselin
12c0: 65 22 20 66 6f 72 20 74 68 69 73 20 6d 61 6e 69 e" for this mani
12d0: 66 65 73 74 2e 20 20 41 0a 6d 61 6e 69 66 65 73 fest. A.manifes
12e0: 74 20 74 68 61 74 20 68 61 73 20 61 20 42 2d 63 t that has a B-c
12f0: 61 72 64 20 69 73 20 63 61 6c 6c 65 64 20 61 20 ard is called a
1300: 64 65 6c 74 61 2d 6d 61 6e 69 66 65 73 74 20 61 delta-manifest a
1310: 6e 64 20 61 20 6d 61 6e 69 66 65 73 74 0a 74 68 nd a manifest.th
1320: 61 74 20 6f 6d 69 74 73 20 74 68 65 20 42 2d 63 at omits the B-c
1330: 61 72 64 20 69 73 20 61 20 62 61 73 65 6c 69 6e ard is a baselin
1340: 65 2d 6d 61 6e 69 66 65 73 74 2e 20 20 54 68 65 e-manifest. The
1350: 20 6f 74 68 65 72 20 6d 61 6e 69 66 65 73 74 0a other manifest.
1360: 69 64 65 6e 74 69 66 69 65 64 20 62 79 20 74 68 identified by th
1370: 65 20 61 72 67 75 6d 65 6e 74 20 6f 66 20 74 68 e argument of th
1380: 65 20 42 2d 63 61 72 64 20 6d 75 73 74 20 62 65 e B-card must be
1390: 20 61 20 62 61 73 65 6c 69 6e 65 2d 6d 61 6e 69 a baseline-mani
13a0: 66 65 73 74 2e 0a 41 20 62 61 73 65 6c 69 6e 65 fest..A baseline
13b0: 2d 6d 61 6e 69 66 65 73 74 20 72 65 63 6f 72 64 -manifest record
13c0: 73 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 20 63 s the complete c
13d0: 6f 6e 74 65 6e 74 73 20 6f 66 20 61 20 63 68 65 ontents of a che
13e0: 63 6b 69 6e 2e 0a 41 20 64 65 6c 74 61 2d 6d 61 ckin..A delta-ma
13f0: 6e 69 66 65 73 74 20 72 65 63 6f 72 64 73 20 6f nifest records o
1400: 6e 6c 79 20 63 68 61 6e 67 65 73 20 66 72 6f 6d nly changes from
1410: 20 69 74 73 20 62 61 73 65 6c 69 6e 65 2e 20 20 its baseline.
1420: 0a 0a 41 20 6d 61 6e 69 66 65 73 74 20 6d 75 73 ..A manifest mus
1430: 74 20 68 61 76 65 20 65 78 61 63 74 6c 79 20 6f t have exactly o
1440: 6e 65 20 43 2d 63 61 72 64 2e 20 20 54 68 65 20 ne C-card. The
1450: 73 6f 6c 65 20 61 72 67 75 6d 65 6e 74 20 74 6f sole argument to
1460: 0a 74 68 65 20 43 2d 63 61 72 64 20 69 73 20 61 .the C-card is a
1470: 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d 6d 65 6e check-in commen
1480: 74 20 74 68 61 74 20 64 65 73 63 72 69 62 65 73 t that describes
1490: 20 74 68 65 20 63 68 65 63 6b 2d 69 6e 20 74 68 the check-in th
14a0: 61 74 0a 74 68 65 20 6d 61 6e 69 66 65 73 74 20 at.the manifest
14b0: 64 65 66 69 6e 65 73 2e 20 20 54 68 65 20 63 68 defines. The ch
14c0: 65 63 6b 2d 69 6e 20 63 6f 6d 6d 65 6e 74 20 69 eck-in comment i
14d0: 73 20 74 65 78 74 2e 20 20 54 68 65 20 66 6f 6c s text. The fol
14e0: 6c 6f 77 69 6e 67 0a 65 73 63 61 70 65 20 73 65 lowing.escape se
14f0: 71 75 65 6e 63 65 73 20 61 72 65 20 61 70 70 6c quences are appl
1500: 69 65 64 20 74 6f 20 74 68 65 20 74 65 78 74 3a ied to the text:
1510: 0a 41 20 73 70 61 63 65 20 28 41 53 43 49 49 20 .A space (ASCII
1520: 30 78 32 30 29 20 69 73 20 72 65 70 72 65 73 65 0x20) is represe
1530: 6e 74 65 64 20 61 73 20 22 5c 73 22 20 28 41 53 nted as "\s" (AS
1540: 43 49 49 20 30 78 35 43 2c 20 30 78 37 33 29 2e CII 0x5C, 0x73).
1550: 20 20 41 0a 6e 65 77 6c 69 6e 65 20 28 41 53 43 A.newline (ASC
1560: 49 49 20 30 78 30 61 29 20 69 73 20 22 5c 6e 22 II 0x0a) is "\n"
1570: 20 28 41 53 43 49 49 20 30 78 35 43 2c 20 78 36 (ASCII 0x5C, x6
1580: 45 29 2e 20 20 41 20 62 61 63 6b 73 6c 61 73 68 E). A backslash
1590: 20 0a 28 41 53 43 49 49 20 30 78 35 43 29 20 69 .(ASCII 0x5C) i
15a0: 73 20 72 65 70 72 65 73 65 6e 74 65 64 20 61 73 s represented as
15b0: 20 74 77 6f 20 62 61 63 6b 73 6c 61 73 68 65 73 two backslashes
15c0: 20 22 5c 5c 22 2e 20 20 41 70 61 72 74 20 66 72 "\\". Apart fr
15d0: 6f 6d 0a 73 70 61 63 65 20 61 6e 64 20 6e 65 77 om.space and new
15e0: 6c 69 6e 65 2c 20 6e 6f 20 6f 74 68 65 72 20 77 line, no other w
15f0: 68 69 74 65 73 70 61 63 65 20 63 68 61 72 61 63 hitespace charac
1600: 74 65 72 73 20 61 72 65 20 61 6c 6c 6f 77 65 64 ters are allowed
1610: 20 69 6e 0a 74 68 65 20 63 68 65 63 6b 2d 69 6e in.the check-in
1620: 20 63 6f 6d 6d 65 6e 74 2e 20 20 4e 6f 72 20 61 comment. Nor a
1630: 72 65 20 61 6e 79 20 75 6e 70 72 69 6e 74 61 62 re any unprintab
1640: 6c 65 20 63 68 61 72 61 63 74 65 72 73 20 61 6c le characters al
1650: 6c 6f 77 65 64 0a 69 6e 20 74 68 65 20 63 6f 6d lowed.in the com
1660: 6d 65 6e 74 2e 0a 0a 41 20 6d 61 6e 69 66 65 73 ment...A manifes
1670: 74 20 6d 75 73 74 20 68 61 76 65 20 65 78 61 63 t must have exac
1680: 74 6c 79 20 6f 6e 65 20 44 2d 63 61 72 64 2e 20 tly one D-card.
1690: 20 54 68 65 20 73 6f 6c 65 20 61 72 67 75 6d 65 The sole argume
16a0: 6e 74 20 74 6f 0a 74 68 65 20 44 2d 63 61 72 64 nt to.the D-card
16b0: 20 69 73 20 61 20 64 61 74 65 2d 74 69 6d 65 20 is a date-time
16c0: 73 74 61 6d 70 20 69 6e 20 74 68 65 20 49 53 4f stamp in the ISO
16d0: 38 36 30 31 20 66 6f 72 6d 61 74 2e 20 20 54 68 8601 format. Th
16e0: 65 0a 64 61 74 65 20 61 6e 64 20 74 69 6d 65 20 e.date and time
16f0: 73 68 6f 75 6c 64 20 62 65 20 69 6e 20 63 6f 6f should be in coo
1700: 72 64 69 6e 61 74 65 64 20 75 6e 69 76 65 72 73 rdinated univers
1710: 61 6c 20 74 69 6d 65 20 28 55 54 43 29 2e 0a 54 al time (UTC)..T
1720: 68 65 20 66 6f 72 6d 61 74 20 6f 6e 65 20 6f 66 he format one of
1730: 3a 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a :..<blockquote>.
1740: 3c 69 3e 59 59 59 59 3c 2f 69 3e 3c 62 3e 2d 3c <i>YYYY</i><b>-<
1750: 2f 62 3e 3c 69 3e 4d 4d 3c 2f 69 3e 3c 62 3e 2d /b><i>MM</i><b>-
1760: 3c 2f 62 3e 3c 69 3e 44 44 3c 2f 69 3e 3c 62 3e </b><i>DD</i><b>
1770: 54 3c 2f 62 3e 3c 69 3e 48 48 3c 2f 69 3e 3c 62 T</b><i>HH</i><b
1780: 3e 3a 3c 2f 62 3e 3c 69 3e 4d 4d 3c 2f 69 3e 3c >:</b><i>MM</i><
1790: 62 3e 3a 3c 2f 62 3e 3c 69 3e 53 53 3c 2f 69 3e b>:</b><i>SS</i>
17a0: 3c 62 72 3e 0a 3c 69 3e 59 59 59 59 3c 2f 69 3e <br>.<i>YYYY</i>
17b0: 3c 62 3e 2d 3c 2f 62 3e 3c 69 3e 4d 4d 3c 2f 69 <b>-</b><i>MM</i
17c0: 3e 3c 62 3e 2d 3c 2f 62 3e 3c 69 3e 44 44 3c 2f ><b>-</b><i>DD</
17d0: 69 3e 3c 62 3e 54 3c 2f 62 3e 3c 69 3e 48 48 3c i><b>T</b><i>HH<
17e0: 2f 69 3e 3c 62 3e 3a 3c 2f 62 3e 3c 69 3e 4d 4d /i><b>:</b><i>MM
17f0: 3c 2f 69 3e 3c 62 3e 3a 3c 2f 62 3e 3c 69 3e 53 </i><b>:</b><i>S
1800: 53 3c 2f 69 3e 3c 62 3e 2e 3c 2f 62 3e 3c 69 3e S</i><b>.</b><i>
1810: 53 53 53 3c 2f 69 3e 0a 3c 2f 62 6c 6f 63 6b 71 SSS</i>.</blockq
1820: 75 6f 74 65 3e 0a 0a 41 20 6d 61 6e 69 66 65 73 uote>..A manifes
1830: 74 20 68 61 73 20 7a 65 72 6f 20 6f 72 20 6d 6f t has zero or mo
1840: 72 65 20 46 2d 63 61 72 64 73 2e 20 20 45 61 63 re F-cards. Eac
1850: 68 20 46 2d 63 61 72 64 20 69 64 65 6e 74 69 66 h F-card identif
1860: 69 65 73 20 61 20 66 69 6c 65 0a 74 68 61 74 20 ies a file.that
1870: 69 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 63 is part of the c
1880: 68 65 63 6b 2d 69 6e 2e 20 20 54 68 65 72 65 20 heck-in. There
1890: 61 72 65 20 6f 6e 65 2c 20 74 77 6f 2c 20 74 68 are one, two, th
18a0: 72 65 65 2c 20 6f 72 20 66 6f 75 72 20 61 72 67 ree, or four arg
18b0: 75 6d 65 6e 74 73 2e 0a 54 68 65 20 66 69 72 73 uments..The firs
18c0: 74 20 61 72 67 75 6d 65 6e 74 0a 69 73 20 74 68 t argument.is th
18d0: 65 20 70 61 74 68 6e 61 6d 65 20 6f 66 20 74 68 e pathname of th
18e0: 65 20 66 69 6c 65 20 69 6e 20 74 68 65 20 63 68 e file in the ch
18f0: 65 63 6b 2d 69 6e 20 72 65 6c 61 74 69 76 65 20 eck-in relative
1900: 74 6f 20 74 68 65 20 72 6f 6f 74 0a 6f 66 20 74 to the root.of t
1910: 68 65 20 70 72 6f 6a 65 63 74 20 66 69 6c 65 20 he project file
1920: 68 69 65 72 61 72 63 68 79 2e 20 20 4e 6f 20 22 hierarchy. No "
1930: 2e 2e 22 20 6f 72 20 22 2e 22 20 64 69 72 65 63 .." or "." direc
1940: 74 6f 72 69 65 73 20 61 72 65 20 61 6c 6c 6f 77 tories are allow
1950: 65 64 0a 77 69 74 68 69 6e 20 74 68 65 20 66 69 ed.within the fi
1960: 6c 65 6e 61 6d 65 2e 20 20 53 70 61 63 65 20 63 lename. Space c
1970: 68 61 72 61 63 74 65 72 73 20 61 72 65 20 65 73 haracters are es
1980: 63 61 70 65 64 20 61 73 20 69 6e 20 43 2d 63 61 caped as in C-ca
1990: 72 64 0a 63 6f 6d 6d 65 6e 74 20 74 65 78 74 2e rd.comment text.
19a0: 20 20 42 61 63 6b 73 6c 61 73 68 20 63 68 61 72 Backslash char
19b0: 61 63 74 65 72 73 20 61 6e 64 20 6e 65 77 6c 69 acters and newli
19c0: 6e 65 73 20 61 72 65 20 6e 6f 74 20 61 6c 6c 6f nes are not allo
19d0: 77 65 64 0a 77 69 74 68 69 6e 20 66 69 6c 65 6e wed.within filen
19e0: 61 6d 65 73 2e 20 20 54 68 65 20 64 69 72 65 63 ames. The direc
19f0: 74 6f 72 79 20 73 65 70 61 72 61 74 6f 72 20 63 tory separator c
1a00: 68 61 72 61 63 74 65 72 20 69 73 20 61 20 66 6f haracter is a fo
1a10: 72 77 61 72 64 0a 73 6c 61 73 68 20 28 41 53 43 rward.slash (ASC
1a20: 49 49 20 30 78 32 46 29 2e 20 20 54 68 65 20 73 II 0x2F). The s
1a30: 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 74 econd argument t
1a40: 6f 20 74 68 65 20 46 2d 63 61 72 64 20 69 73 20 o the F-card is
1a50: 74 68 65 0a 66 75 6c 6c 20 34 30 2d 63 68 61 72 the.full 40-char
1a60: 61 63 74 65 72 20 6c 6f 77 65 72 2d 63 61 73 65 acter lower-case
1a70: 20 68 65 78 61 64 65 63 69 6d 61 6c 20 53 48 41 hexadecimal SHA
1a80: 31 20 68 61 73 68 20 6f 66 20 74 68 65 20 63 6f 1 hash of the co
1a90: 6e 74 65 6e 74 0a 61 72 74 69 66 61 63 74 2e 20 ntent.artifact.
1aa0: 20 54 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 The second argu
1ab0: 6d 65 6e 74 20 69 73 20 72 65 71 75 69 72 65 64 ment is required
1ac0: 20 66 6f 72 20 62 61 73 65 6c 69 6e 65 20 6d 61 for baseline ma
1ad0: 6e 69 66 65 73 74 73 0a 62 75 74 20 69 73 20 6f nifests.but is o
1ae0: 70 74 69 6f 6e 61 6c 20 66 6f 72 20 64 65 6c 74 ptional for delt
1af0: 61 20 6d 61 6e 69 66 65 73 74 73 2e 20 20 57 68 a manifests. Wh
1b00: 65 6e 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 en the second ar
1b10: 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 0a 46 2d gument to the.F-
1b20: 63 61 72 64 20 69 73 20 6f 6d 69 74 74 65 64 2c card is omitted,
1b30: 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 74 it means that t
1b40: 68 65 20 66 69 6c 65 20 68 61 73 20 62 65 65 6e he file has been
1b50: 20 64 65 6c 65 74 65 64 20 72 65 6c 61 74 69 76 deleted relativ
1b60: 65 0a 74 6f 20 74 68 65 20 62 61 73 65 6c 69 6e e.to the baselin
1b70: 65 2e 20 20 54 68 65 20 6f 70 74 69 6f 6e 61 6c e. The optional
1b80: 20 33 72 64 20 61 72 67 75 6d 65 6e 74 20 64 65 3rd argument de
1b90: 66 69 6e 65 73 20 61 6e 79 20 73 70 65 63 69 61 fines any specia
1ba0: 6c 20 61 63 63 65 73 73 20 0a 70 65 72 6d 69 73 l access .permis
1bb0: 73 69 6f 6e 73 20 61 73 73 6f 63 69 61 74 65 64 sions associated
1bc0: 20 77 69 74 68 20 74 68 65 20 66 69 6c 65 2e 20 with the file.
1bd0: 20 54 68 65 20 6f 6e 6c 79 20 73 70 65 63 69 61 The only specia
1be0: 6c 20 63 6f 64 65 20 63 75 72 72 65 6e 74 6c 79 l code currently
1bf0: 0a 64 65 66 69 6e 65 64 20 69 73 20 22 78 22 20 .defined is "x"
1c00: 77 68 69 63 68 20 6d 65 61 6e 73 20 74 68 61 74 which means that
1c10: 20 74 68 65 20 66 69 6c 65 20 69 73 20 65 78 65 the file is exe
1c20: 63 75 74 61 62 6c 65 2e 20 20 41 6c 6c 20 66 69 cutable. All fi
1c30: 6c 65 73 20 61 72 65 0a 61 6c 77 61 79 73 20 72 les are.always r
1c40: 65 61 64 61 62 6c 65 20 61 6e 64 20 77 72 69 74 eadable and writ
1c50: 61 62 6c 65 2e 20 20 54 68 69 73 20 63 61 6e 20 able. This can
1c60: 62 65 20 65 78 70 72 65 73 73 65 64 20 62 79 20 be expressed by
1c70: 22 77 22 20 70 65 72 6d 69 73 73 69 6f 6e 0a 69 "w" permission.i
1c80: 66 20 64 65 73 69 72 65 64 20 62 75 74 20 69 73 f desired but is
1c90: 20 6f 70 74 69 6f 6e 61 6c 2e 20 20 54 68 65 20 optional. The
1ca0: 66 69 6c 65 20 66 6f 72 6d 61 74 20 6d 69 67 68 file format migh
1cb0: 74 20 62 65 20 65 78 74 65 6e 64 65 64 20 77 69 t be extended wi
1cc0: 74 68 0a 6e 65 77 20 70 65 72 6d 69 73 73 69 6f th.new permissio
1cd0: 6e 20 6c 65 74 74 65 72 73 20 69 6e 20 74 68 65 n letters in the
1ce0: 20 66 75 74 75 72 65 2e 0a 54 68 65 20 6f 70 74 future..The opt
1cf0: 69 6f 6e 61 6c 20 34 74 68 20 61 72 67 75 6d 65 ional 4th argume
1d00: 6e 74 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f nt is the name o
1d10: 66 20 74 68 65 20 73 61 6d 65 20 66 69 6c 65 20 f the same file
1d20: 61 73 20 69 74 20 65 78 69 73 74 65 64 20 69 6e as it existed in
1d30: 0a 74 68 65 20 70 61 72 65 6e 74 20 63 68 65 63 .the parent chec
1d40: 6b 2d 69 6e 2e 20 20 49 66 20 74 68 65 20 6e 61 k-in. If the na
1d50: 6d 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 69 me of the file i
1d60: 73 20 75 6e 63 68 61 6e 67 65 64 20 66 72 6f 6d s unchanged from
1d70: 20 69 74 73 0a 70 61 72 65 6e 74 2c 20 74 68 65 its.parent, the
1d80: 6e 20 74 68 65 20 34 74 68 20 61 72 67 75 6d 65 n the 4th argume
1d90: 6e 74 20 69 73 20 6f 6d 69 74 74 65 64 2e 0a 0a nt is omitted...
1da0: 41 20 6d 61 6e 69 66 65 73 74 20 68 61 73 20 7a A manifest has z
1db0: 65 72 6f 20 6f 72 20 6f 6e 65 20 4e 2d 63 61 72 ero or one N-car
1dc0: 64 73 2e 20 20 54 68 65 20 4e 2d 63 61 72 64 20 ds. The N-card
1dd0: 73 70 65 63 69 66 69 65 73 20 74 68 65 20 6d 69 specifies the mi
1de0: 6d 65 74 79 70 65 20 66 6f 72 20 74 68 65 0a 74 metype for the.t
1df0: 65 78 74 20 69 6e 20 74 68 65 20 63 6f 6d 6d 65 ext in the comme
1e00: 6e 74 20 6f 66 20 74 68 65 20 43 2d 63 61 72 64 nt of the C-card
1e10: 2e 20 20 49 66 20 74 68 65 20 4e 2d 63 61 72 64 . If the N-card
1e20: 20 69 73 20 6f 6d 69 74 74 65 64 2c 20 61 20 64 is omitted, a d
1e30: 65 66 61 75 6c 74 20 6d 69 6d 65 74 79 70 65 0a efault mimetype.
1e40: 69 73 20 75 73 65 64 2e 0a 0a 41 20 6d 61 6e 69 is used...A mani
1e50: 66 65 73 74 20 68 61 73 20 7a 65 72 6f 20 6f 72 fest has zero or
1e60: 20 6f 6e 65 20 50 2d 63 61 72 64 73 2e 20 20 4d one P-cards. M
1e70: 6f 73 74 20 6d 61 6e 69 66 65 73 74 73 20 68 61 ost manifests ha
1e80: 76 65 20 6f 6e 65 20 50 2d 63 61 72 64 2e 0a 54 ve one P-card..T
1e90: 68 65 20 50 2d 63 61 72 64 20 68 61 73 20 61 20 he P-card has a
1ea0: 76 61 72 79 69 6e 67 20 6e 75 6d 62 65 72 20 6f varying number o
1eb0: 66 20 61 72 67 75 6d 65 6e 74 73 20 74 68 61 74 f arguments that
1ec0: 0a 64 65 66 69 6e 65 73 20 6f 74 68 65 72 20 6d .defines other m
1ed0: 61 6e 69 66 65 73 74 73 20 66 72 6f 6d 20 77 68 anifests from wh
1ee0: 69 63 68 20 74 68 65 20 63 75 72 72 65 6e 74 20 ich the current
1ef0: 6d 61 6e 69 66 65 73 74 0a 69 73 20 64 65 72 69 manifest.is deri
1f00: 76 65 64 2e 20 20 45 61 63 68 20 61 72 67 75 6d ved. Each argum
1f10: 65 6e 74 20 69 73 20 61 6e 20 34 30 2d 63 68 61 ent is an 40-cha
1f20: 72 61 63 74 65 72 20 6c 6f 77 65 72 63 61 73 65 racter lowercase
1f30: 20 0a 68 65 78 61 64 65 63 69 6d 61 6c 20 53 48 .hexadecimal SH
1f40: 41 31 20 6f 66 20 74 68 65 20 70 72 65 64 65 63 A1 of the predec
1f50: 65 73 73 6f 72 20 6d 61 6e 69 66 65 73 74 2e 20 essor manifest.
1f60: 20 41 6c 6c 20 61 72 67 75 6d 65 6e 74 73 0a 74 All arguments.t
1f70: 6f 20 74 68 65 20 50 2d 63 61 72 64 20 6d 75 73 o the P-card mus
1f80: 74 20 62 65 20 75 6e 69 71 75 65 20 74 6f 20 74 t be unique to t
1f90: 68 61 74 20 6c 69 6e 65 2e 0a 54 68 65 20 66 69 hat line..The fi
1fa0: 72 73 74 20 70 72 65 64 65 63 65 73 73 6f 72 20 rst predecessor
1fb0: 69 73 20 74 68 65 20 64 69 72 65 63 74 20 61 6e is the direct an
1fc0: 63 65 73 74 6f 72 20 6f 66 20 74 68 65 20 6d 61 cestor of the ma
1fd0: 6e 69 66 65 73 74 2e 0a 4f 74 68 65 72 20 61 72 nifest..Other ar
1fe0: 67 75 6d 65 6e 74 73 20 64 65 66 69 6e 65 20 6d guments define m
1ff0: 61 6e 69 66 65 73 74 73 20 77 69 74 68 20 77 68 anifests with wh
2000: 69 63 68 20 74 68 65 20 66 69 72 73 74 20 77 61 ich the first wa
2010: 73 0a 6d 65 72 67 65 64 20 74 6f 20 79 69 65 6c s.merged to yiel
2020: 64 20 74 68 65 20 63 75 72 72 65 6e 74 20 6d 61 d the current ma
2030: 6e 69 66 65 73 74 2e 20 20 4d 6f 73 74 20 6d 61 nifest. Most ma
2040: 6e 69 66 65 73 74 73 20 68 61 76 65 0a 61 20 50 nifests have.a P
2050: 2d 63 61 72 64 20 77 69 74 68 20 61 20 73 69 6e -card with a sin
2060: 67 6c 65 20 61 72 67 75 6d 65 6e 74 2e 20 20 54 gle argument. T
2070: 68 65 20 66 69 72 73 74 20 6d 61 6e 69 66 65 73 he first manifes
2080: 74 20 69 6e 20 74 68 65 0a 70 72 6f 6a 65 63 74 t in the.project
2090: 20 68 61 73 20 6e 6f 20 61 6e 63 65 73 74 6f 72 has no ancestor
20a0: 73 20 61 6e 64 20 74 68 75 73 20 68 61 73 20 6e s and thus has n
20b0: 6f 20 50 2d 63 61 72 64 2e 0a 0a 41 20 6d 61 6e o P-card...A man
20c0: 69 66 65 73 74 20 68 61 73 20 7a 65 72 6f 20 6f ifest has zero o
20d0: 72 20 6d 6f 72 65 20 51 2d 63 61 72 64 73 2e 20 r more Q-cards.
20e0: 20 41 20 51 2d 63 61 72 64 20 69 73 20 73 69 6d A Q-card is sim
20f0: 69 6c 61 72 20 74 6f 20 61 20 50 2d 63 61 72 64 ilar to a P-card
2100: 0a 69 6e 20 74 68 61 74 20 69 74 20 64 65 66 69 .in that it defi
2110: 6e 65 73 20 61 20 70 72 65 64 65 63 65 73 73 6f nes a predecesso
2120: 72 20 74 6f 20 74 68 65 20 63 75 72 72 65 6e 74 r to the current
2130: 20 63 68 65 63 6b 2d 69 6e 2e 20 20 42 75 74 0a check-in. But.
2140: 77 68 65 72 65 61 73 20 61 20 50 2d 63 61 72 64 whereas a P-card
2150: 20 64 65 66 69 6e 65 73 20 74 68 65 20 69 6d 6d defines the imm
2160: 65 64 69 61 74 65 20 61 6e 63 65 73 74 6f 72 20 ediate ancestor
2170: 6f 72 20 61 20 6d 65 72 67 65 0a 61 6e 63 65 73 or a merge.ances
2180: 74 6f 72 2c 20 74 68 65 20 51 2d 63 61 72 64 20 tor, the Q-card
2190: 69 73 20 75 73 65 64 20 74 6f 20 69 64 65 6e 74 is used to ident
21a0: 69 66 79 20 61 20 73 69 6e 67 6c 65 20 63 68 65 ify a single che
21b0: 63 6b 2d 69 6e 20 6f 72 20 61 20 73 6d 61 6c 6c ck-in or a small
21c0: 0a 72 61 6e 67 65 20 6f 66 20 63 68 65 63 6b 2d .range of check-
21d0: 69 6e 73 20 77 68 69 63 68 20 77 65 72 65 20 63 ins which were c
21e0: 68 65 72 72 79 2d 70 69 63 6b 65 64 20 66 6f 72 herry-picked for
21f0: 20 69 6e 63 6c 75 73 69 6f 6e 20 69 6e 20 6f 72 inclusion in or
2200: 0a 65 78 63 6c 75 73 69 6f 6e 20 66 72 6f 6d 20 .exclusion from
2210: 74 68 65 20 63 75 72 72 65 6e 74 20 6d 61 6e 69 the current mani
2220: 66 65 73 74 2e 20 20 54 68 65 20 66 69 72 73 74 fest. The first
2230: 20 61 72 67 75 6d 65 6e 74 20 6f 66 0a 74 68 65 argument of.the
2240: 20 51 2d 63 61 72 64 20 69 73 20 74 68 65 20 61 Q-card is the a
2250: 72 74 69 66 61 63 74 20 49 44 20 6f 66 20 61 6e rtifact ID of an
2260: 6f 74 68 65 72 20 6d 61 6e 69 66 65 73 74 20 28 other manifest (
2270: 74 68 65 20 22 74 61 72 67 65 74 22 29 0a 77 68 the "target").wh
2280: 69 63 68 20 68 61 73 20 68 61 64 20 69 74 73 20 ich has had its
2290: 63 68 61 6e 67 65 73 20 69 6e 63 6c 75 64 65 64 changes included
22a0: 20 6f 72 20 65 78 63 6c 75 64 65 64 20 69 6e 20 or excluded in
22b0: 74 68 65 20 63 75 72 72 65 6e 74 20 6d 61 6e 69 the current mani
22c0: 66 65 73 74 2e 20 20 0a 54 68 65 20 74 61 72 67 fest. .The targ
22d0: 65 74 20 69 73 20 70 72 65 63 65 65 64 65 64 20 et is preceeded
22e0: 62 79 20 22 2b 22 20 6f 72 20 22 2d 22 20 74 6f by "+" or "-" to
22f0: 20 73 68 6f 77 20 69 6e 63 6c 75 73 69 6f 6e 20 show inclusion
2300: 6f 72 0a 65 78 63 6c 75 73 69 6f 6e 2c 20 72 65 or.exclusion, re
2310: 73 70 65 63 74 69 76 65 6c 79 2e 20 20 54 68 65 spectively. The
2320: 20 6f 70 74 69 6f 6e 61 6c 20 73 65 63 6f 6e 64 optional second
2330: 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 argument to the
2340: 0a 51 2d 63 61 72 64 20 69 73 20 61 6e 6f 74 68 .Q-card is anoth
2350: 65 72 20 6d 61 6e 69 66 65 73 74 20 61 72 74 69 er manifest arti
2360: 66 61 63 74 20 49 44 20 77 68 69 63 68 20 69 73 fact ID which is
2370: 20 74 68 65 20 22 62 61 73 65 6c 69 6e 65 22 0a the "baseline".
2380: 66 6f 72 20 74 68 65 20 63 68 65 72 72 79 2d 70 for the cherry-p
2390: 69 63 6b 2e 20 20 49 66 20 6f 6d 69 74 74 65 64 ick. If omitted
23a0: 2c 20 74 68 65 20 62 61 73 65 6c 69 6e 65 20 69 , the baseline i
23b0: 73 20 74 68 65 20 70 72 69 6d 61 72 79 0a 70 61 s the primary.pa
23c0: 72 65 6e 74 20 6f 66 20 74 68 65 20 74 61 72 67 rent of the targ
23d0: 65 74 2e 20 20 54 68 65 0a 63 68 61 6e 67 65 73 et. The.changes
23e0: 20 69 6e 63 6c 75 64 65 64 20 6f 72 20 65 78 63 included or exc
23f0: 6c 75 64 65 64 20 63 6f 6e 73 69 73 74 20 6f 66 luded consist of
2400: 20 61 6c 6c 20 63 68 61 6e 67 65 73 20 6d 6f 76 all changes mov
2410: 69 6e 67 20 66 72 6f 6d 0a 74 68 65 20 62 61 73 ing from.the bas
2420: 65 6c 69 6e 65 20 74 6f 20 74 68 65 20 74 61 72 eline to the tar
2430: 67 65 74 2e 20 20 0a 0a 54 68 65 20 51 2d 63 61 get. ..The Q-ca
2440: 72 64 20 77 61 73 20 61 64 64 65 64 20 74 6f 20 rd was added to
2450: 74 68 65 20 69 6e 74 65 72 66 61 63 65 20 73 70 the interface sp
2460: 65 63 69 66 69 63 61 74 69 6f 6e 20 6f 6e 20 32 ecification on 2
2470: 30 31 31 2d 30 32 2d 32 36 2e 20 20 0a 4f 6c 64 011-02-26. .Old
2480: 65 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 46 er versions of F
2490: 6f 73 73 69 6c 20 77 69 6c 6c 20 72 65 6a 65 63 ossil will rejec
24a0: 74 20 6d 61 6e 69 66 65 73 74 73 20 74 68 61 74 t manifests that
24b0: 20 63 6f 6e 74 61 69 6e 20 51 2d 63 61 72 64 73 contain Q-cards
24c0: 2e 0a 0a 41 20 6d 61 6e 69 66 65 73 74 20 6d 61 ...A manifest ma
24d0: 79 20 6f 70 74 69 6f 6e 61 6c 6c 79 20 68 61 76 y optionally hav
24e0: 65 20 61 20 73 69 6e 67 6c 65 20 52 2d 63 61 72 e a single R-car
24f0: 64 2e 20 20 54 68 65 20 52 2d 63 61 72 64 20 68 d. The R-card h
2500: 61 73 0a 61 20 73 69 6e 67 6c 65 20 61 72 67 75 as.a single argu
2510: 6d 65 6e 74 20 77 68 69 63 68 20 69 73 20 74 68 ment which is th
2520: 65 20 4d 44 35 20 63 68 65 63 6b 73 75 6d 20 6f e MD5 checksum o
2530: 66 20 61 6c 6c 20 66 69 6c 65 73 20 69 6e 20 0a f all files in .
2540: 74 68 65 20 63 68 65 63 6b 2d 69 6e 20 65 78 63 the check-in exc
2550: 65 70 74 20 74 68 65 20 6d 61 6e 69 66 65 73 74 ept the manifest
2560: 20 69 74 73 65 6c 66 2e 20 20 54 68 65 20 63 68 itself. The ch
2570: 65 63 6b 73 75 6d 20 69 73 20 65 78 70 72 65 73 ecksum is expres
2580: 73 65 64 0a 61 73 20 33 32 2d 63 68 61 72 61 63 sed.as 32-charac
2590: 74 65 72 73 20 6f 66 20 6c 6f 77 65 72 63 61 73 ters of lowercas
25a0: 65 20 68 65 78 61 64 65 63 69 6d 61 6c 2e 20 20 e hexadecimal.
25b0: 20 54 68 65 20 63 68 65 63 6b 73 75 6d 20 69 73 The checksum is
25c0: 0a 63 6f 6d 70 75 74 65 64 20 61 73 20 66 6f 6c .computed as fol
25d0: 6c 6f 77 73 3a 20 20 46 6f 72 20 65 61 63 68 20 lows: For each
25e0: 66 69 6c 65 20 69 6e 20 74 68 65 20 63 68 65 63 file in the chec
25f0: 6b 2d 69 6e 20 28 65 78 63 65 70 74 20 66 6f 72 k-in (except for
2600: 0a 74 68 65 20 6d 61 6e 69 66 65 73 74 20 69 74 .the manifest it
2610: 73 65 6c 66 29 20 69 6e 20 73 74 72 69 63 74 20 self) in strict
2620: 73 6f 72 74 65 64 20 6c 65 78 69 63 6f 67 72 61 sorted lexicogra
2630: 70 68 69 63 61 6c 20 6f 72 64 65 72 2c 20 0a 74 phical order, .t
2640: 61 6b 65 20 74 68 65 20 70 61 74 68 6e 61 6d 65 ake the pathname
2650: 20 6f 66 20 74 68 65 20 66 69 6c 65 20 72 65 6c of the file rel
2660: 61 74 69 76 65 20 74 6f 20 74 68 65 20 72 6f 6f ative to the roo
2670: 74 20 6f 66 20 74 68 65 0a 72 65 70 6f 73 69 74 t of the.reposit
2680: 6f 72 79 2c 20 61 70 70 65 6e 64 20 61 20 73 69 ory, append a si
2690: 6e 67 6c 65 20 73 70 61 63 65 20 28 41 53 43 49 ngle space (ASCI
26a0: 49 20 30 78 32 30 29 2c 20 74 68 65 0a 73 69 7a I 0x20), the.siz
26b0: 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 69 6e e of the file in
26c0: 20 41 53 43 49 49 20 64 65 63 69 6d 61 6c 2c 20 ASCII decimal,
26d0: 61 20 73 69 6e 67 6c 65 20 6e 65 77 6c 69 6e 65 a single newline
26e0: 0a 63 68 61 72 61 63 74 65 72 20 28 41 53 43 49 .character (ASCI
26f0: 49 20 30 78 30 41 29 2c 20 61 6e 64 20 74 68 65 I 0x0A), and the
2700: 20 63 6f 6d 70 6c 65 74 65 20 74 65 78 74 20 6f complete text o
2710: 66 20 74 68 65 20 66 69 6c 65 2e 0a 43 6f 6d 70 f the file..Comp
2720: 75 74 65 20 74 68 65 20 4d 44 35 20 63 68 65 63 ute the MD5 chec
2730: 6b 73 75 6d 20 6f 66 20 74 68 65 20 72 65 73 75 ksum of the resu
2740: 6c 74 2e 0a 0a 41 20 6d 61 6e 69 66 65 73 74 20 lt...A manifest
2750: 6d 69 67 68 74 20 63 6f 6e 74 61 69 6e 20 6f 6e might contain on
2760: 65 20 6f 72 20 6d 6f 72 65 20 54 2d 63 61 72 64 e or more T-card
2770: 73 20 75 73 65 64 20 74 6f 20 73 65 74 0a 5b 2e s used to set.[.
2780: 2f 62 72 61 6e 63 68 69 6e 67 2e 77 69 6b 69 23 /branching.wiki#
2790: 74 61 67 73 20 7c 20 74 61 67 73 20 6f 72 20 70 tags | tags or p
27a0: 72 6f 70 65 72 74 69 65 73 5d 0a 6f 6e 20 74 68 roperties].on th
27b0: 65 20 63 68 65 63 6b 2d 69 6e 2e 20 20 54 68 65 e check-in. The
27c0: 20 66 6f 72 6d 61 74 20 6f 66 20 74 68 65 20 54 format of the T
27d0: 2d 63 61 72 64 20 69 73 20 74 68 65 20 73 61 6d -card is the sam
27e0: 65 20 61 73 0a 64 65 73 63 72 69 62 65 64 20 69 e as.described i
27f0: 6e 20 3c 69 3e 43 6f 6e 74 72 6f 6c 20 41 72 74 n <i>Control Art
2800: 69 66 61 63 74 73 3c 2f 69 3e 20 73 65 63 74 69 ifacts</i> secti
2810: 6f 6e 20 62 65 6c 6f 77 2c 20 65 78 63 65 70 74 on below, except
2820: 20 74 68 61 74 20 74 68 65 0a 73 65 63 6f 6e 64 that the.second
2830: 20 61 72 67 75 6d 65 6e 74 20 69 73 20 74 68 65 argument is the
2840: 20 73 69 6e 67 6c 65 20 63 68 61 72 61 63 63 74 single characct
2850: 65 72 20 22 3c 62 3e 2a 3c 2f 62 3e 22 20 69 6e er "<b>*</b>" in
2860: 73 74 65 61 64 20 6f 66 20 61 6e 0a 61 72 74 69 stead of an.arti
2870: 66 61 63 74 20 49 44 2e 20 20 54 68 65 20 3c 62 fact ID. The <b
2880: 3e 2a 3c 2f 62 3e 20 69 6e 20 70 6c 61 63 65 20 >*</b> in place
2890: 6f 66 20 74 68 65 20 61 72 74 69 66 61 63 74 20 of the artifact
28a0: 49 44 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 ID indicates tha
28b0: 74 0a 74 68 65 20 74 61 67 20 6f 72 20 70 72 6f t.the tag or pro
28c0: 70 65 72 74 79 20 61 70 70 6c 69 65 73 20 74 6f perty applies to
28d0: 20 74 68 65 20 63 75 72 72 65 6e 74 20 61 72 74 the current art
28e0: 69 66 61 63 74 2e 20 20 49 74 20 69 73 20 6e 6f ifact. It is no
28f0: 74 0a 70 6f 73 73 69 62 6c 65 20 74 6f 20 65 6e t.possible to en
2900: 63 6f 64 65 20 74 68 65 20 63 75 72 72 65 6e 74 code the current
2910: 20 61 72 74 69 66 61 63 74 20 49 44 20 61 73 20 artifact ID as
2920: 70 61 72 74 20 6f 66 20 61 6e 20 61 72 74 69 66 part of an artif
2930: 61 63 74 2c 0a 73 69 6e 63 65 20 74 68 65 20 61 act,.since the a
2940: 63 74 20 6f 66 20 69 6e 73 65 72 74 69 6e 67 20 ct of inserting
2950: 74 68 65 20 61 72 74 69 66 61 63 74 20 49 44 20 the artifact ID
2960: 77 6f 75 6c 64 20 63 68 61 6e 67 65 20 74 68 65 would change the
2970: 20 61 72 74 69 66 61 63 74 20 49 44 2c 0a 68 65 artifact ID,.he
2980: 6e 63 65 20 61 20 3c 62 3e 2a 3c 2f 62 3e 20 69 nce a <b>*</b> i
2990: 73 20 75 73 65 64 20 74 6f 20 72 65 70 72 65 73 s used to repres
29a0: 65 6e 74 20 22 73 65 6c 66 22 2e 20 20 54 2d 63 ent "self". T-c
29b0: 61 72 64 73 20 61 72 65 20 74 79 70 69 63 61 6c ards are typical
29c0: 6c 79 0a 61 64 64 65 64 20 74 6f 20 6d 61 6e 69 ly.added to mani
29d0: 66 65 73 74 73 20 69 6e 20 6f 72 64 65 72 20 74 fests in order t
29e0: 6f 20 73 65 74 20 74 68 65 20 3c 62 3e 62 72 61 o set the <b>bra
29f0: 6e 63 68 3c 2f 62 3e 20 70 72 6f 70 65 72 74 79 nch</b> property
2a00: 20 61 6e 64 20 61 0a 73 79 6d 62 6f 6c 69 63 20 and a.symbolic
2a10: 6e 61 6d 65 20 77 68 65 6e 20 74 68 65 20 63 68 name when the ch
2a20: 65 63 6b 2d 69 6e 20 69 73 20 69 6e 74 65 6e 64 eck-in is intend
2a30: 65 64 20 74 6f 20 73 74 61 72 74 20 61 20 6e 65 ed to start a ne
2a40: 77 20 62 72 61 6e 63 68 2e 0a 0a 45 61 63 68 20 w branch...Each
2a50: 6d 61 6e 69 66 65 73 74 20 68 61 73 20 61 20 73 manifest has a s
2a60: 69 6e 67 6c 65 20 55 2d 63 61 72 64 2e 20 20 54 ingle U-card. T
2a70: 68 65 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 he argument to t
2a80: 68 65 20 55 2d 63 61 72 64 20 69 73 0a 74 68 65 he U-card is.the
2a90: 20 6c 6f 67 69 6e 20 6f 66 20 74 68 65 20 75 73 login of the us
2aa0: 65 72 20 77 68 6f 20 63 72 65 61 74 65 64 20 74 er who created t
2ab0: 68 65 20 6d 61 6e 69 66 65 73 74 2e 20 20 54 68 he manifest. Th
2ac0: 65 20 6c 6f 67 69 6e 20 6e 61 6d 65 0a 69 73 20 e login name.is
2ad0: 65 6e 63 6f 64 65 64 20 75 73 69 6e 67 20 74 68 encoded using th
2ae0: 65 20 73 61 6d 65 20 63 68 61 72 61 63 74 65 72 e same character
2af0: 20 65 73 63 61 70 65 73 20 61 73 20 69 73 20 75 escapes as is u
2b00: 73 65 64 20 66 6f 72 20 74 68 65 0a 63 68 65 63 sed for the.chec
2b10: 6b 2d 69 6e 20 63 6f 6d 6d 65 6e 74 20 61 72 67 k-in comment arg
2b20: 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 43 2d 63 ument to the C-c
2b30: 61 72 64 2e 0a 0a 41 20 6d 61 6e 69 66 65 73 74 ard...A manifest
2b40: 20 6d 75 73 74 20 68 61 76 65 20 61 20 73 69 6e must have a sin
2b50: 67 6c 65 20 5a 2d 63 61 72 64 20 61 73 20 69 74 gle Z-card as it
2b60: 73 20 6c 61 73 74 20 6c 69 6e 65 2e 20 20 54 68 s last line. Th
2b70: 65 20 61 72 67 75 6d 65 6e 74 0a 74 6f 20 74 68 e argument.to th
2b80: 65 20 5a 2d 63 61 72 64 20 69 73 20 61 20 33 32 e Z-card is a 32
2b90: 2d 63 68 61 72 61 63 74 65 72 20 6c 6f 77 65 72 -character lower
2ba0: 63 61 73 65 20 68 65 78 61 64 65 63 69 6d 61 6c case hexadecimal
2bb0: 20 4d 44 35 20 68 61 73 68 0a 6f 66 20 61 6c 6c MD5 hash.of all
2bc0: 20 70 72 69 6f 72 20 6c 69 6e 65 73 20 6f 66 20 prior lines of
2bd0: 74 68 65 20 6d 61 6e 69 66 65 73 74 20 75 70 20 the manifest up
2be0: 74 6f 20 61 6e 64 20 69 6e 63 6c 75 64 69 6e 67 to and including
2bf0: 20 74 68 65 20 6e 65 77 6c 69 6e 65 20 0a 63 68 the newline .ch
2c00: 61 72 61 63 74 65 72 20 74 68 61 74 20 69 6d 6d aracter that imm
2c10: 65 64 69 61 74 65 6c 79 20 70 72 65 63 65 64 65 ediately precede
2c20: 73 20 74 68 65 20 22 5a 22 2e 20 20 54 68 65 20 s the "Z". The
2c30: 5a 2d 63 61 72 64 20 69 73 20 0a 61 20 73 61 6e Z-card is .a san
2c40: 69 74 79 20 63 68 65 63 6b 20 74 6f 20 70 72 6f ity check to pro
2c50: 76 65 20 74 68 61 74 20 74 68 65 20 6d 61 6e 69 ve that the mani
2c60: 66 65 73 74 20 69 73 20 77 65 6c 6c 2d 66 6f 72 fest is well-for
2c70: 6d 65 64 20 61 6e 64 0a 63 6f 6e 73 69 73 74 65 med and.consiste
2c80: 6e 74 2e 0a 0a 41 20 73 61 6d 70 6c 65 20 6d 61 nt...A sample ma
2c90: 6e 69 66 65 73 74 20 66 72 6f 6d 20 46 6f 73 73 nifest from Foss
2ca0: 69 6c 20 69 74 73 65 6c 66 20 63 61 6e 20 62 65 il itself can be
2cb0: 20 73 65 65 6e 0a 5b 2f 61 72 74 69 66 61 63 74 seen.[/artifact
2cc0: 2f 32 38 39 38 37 30 39 36 61 63 20 7c 20 68 65 /28987096ac | he
2cd0: 72 65 5d 2e 0a 0a 3c 61 20 6e 61 6d 65 3d 22 63 re]...<a name="c
2ce0: 6c 75 73 74 65 72 22 3e 3c 2f 61 3e 0a 3c 68 32 luster"></a>.<h2
2cf0: 3e 32 2e 30 20 43 6c 75 73 74 65 72 73 3c 2f 68 >2.0 Clusters</h
2d00: 32 3e 0a 0a 41 20 63 6c 75 73 74 65 72 20 69 73 2>..A cluster is
2d10: 20 61 20 61 72 74 69 66 61 63 74 20 74 68 61 74 a artifact that
2d20: 20 64 65 63 6c 61 72 65 73 20 74 68 65 20 65 78 declares the ex
2d30: 69 73 74 65 6e 63 65 20 6f 66 20 6f 74 68 65 72 istence of other
2d40: 20 61 72 74 69 66 61 63 74 73 2e 0a 43 6c 75 73 artifacts..Clus
2d50: 74 65 72 73 20 61 72 65 20 75 73 65 64 20 64 75 ters are used du
2d60: 72 69 6e 67 20 72 65 70 6f 73 69 74 6f 72 79 20 ring repository
2d70: 73 79 6e 63 68 72 6f 6e 69 7a 61 74 69 6f 6e 20 synchronization
2d80: 74 6f 20 68 65 6c 70 20 0a 72 65 64 75 63 65 20 to help .reduce
2d90: 6e 65 74 77 6f 72 6b 20 74 72 61 66 66 69 63 2e network traffic.
2da0: 20 20 41 73 20 73 75 63 68 2c 20 63 6c 75 73 74 As such, clust
2db0: 65 72 73 20 61 72 65 20 61 6e 20 6f 70 74 69 6d ers are an optim
2dc0: 69 7a 61 74 69 6f 6e 20 61 6e 64 0a 6d 61 79 20 ization and.may
2dd0: 62 65 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d 20 be removed from
2de0: 61 20 72 65 70 6f 73 69 74 6f 72 79 20 77 69 74 a repository wit
2df0: 68 6f 75 74 20 6c 6f 73 73 20 6f 72 20 64 61 6d hout loss or dam
2e00: 61 67 65 20 74 6f 20 74 68 65 0a 75 6e 64 65 72 age to the.under
2e10: 6c 79 69 6e 67 20 70 72 6f 6a 65 63 74 20 63 6f lying project co
2e20: 64 65 2e 0a 0a 43 6c 75 73 74 65 72 73 20 66 6f de...Clusters fo
2e30: 6c 6c 6f 77 20 61 20 73 79 6e 74 61 78 20 74 68 llow a syntax th
2e40: 61 74 20 69 73 20 76 65 72 79 20 73 69 6d 69 6c at is very simil
2e50: 61 72 20 74 6f 20 6d 61 6e 69 66 65 73 74 73 2e ar to manifests.
2e60: 0a 41 20 43 6c 75 73 74 65 72 20 69 73 20 61 20 .A Cluster is a
2e70: 6c 69 6e 65 2d 6f 72 69 65 6e 74 65 64 20 74 65 line-oriented te
2e80: 78 74 20 66 69 6c 65 2e 20 20 4e 65 77 6c 69 6e xt file. Newlin
2e90: 65 20 63 68 61 72 61 63 74 65 72 73 0a 28 41 53 e characters.(AS
2ea0: 43 49 49 20 30 78 30 61 29 20 73 65 70 61 72 61 CII 0x0a) separa
2eb0: 74 65 20 74 68 65 20 61 72 74 69 66 61 63 74 20 te the artifact
2ec0: 69 6e 74 6f 20 63 61 72 64 73 2e 20 20 45 61 63 into cards. Eac
2ed0: 68 20 63 61 72 64 20 62 65 67 69 6e 73 20 77 69 h card begins wi
2ee0: 74 68 20 61 20 73 69 6e 67 6c 65 0a 63 68 61 72 th a single.char
2ef0: 61 63 74 65 72 20 22 63 61 72 64 20 74 79 70 65 acter "card type
2f00: 22 2e 20 20 5a 65 72 6f 20 6f 72 20 6d 6f 72 65 ". Zero or more
2f10: 20 61 72 67 75 6d 65 6e 74 73 20 6d 61 79 20 66 arguments may f
2f20: 6f 6c 6c 6f 77 0a 74 68 65 20 63 61 72 64 20 74 ollow.the card t
2f30: 79 70 65 2e 20 20 41 6c 6c 20 61 72 67 75 6d 65 ype. All argume
2f40: 6e 74 73 20 61 72 65 20 73 65 70 61 72 61 74 65 nts are separate
2f50: 64 20 66 72 6f 6d 20 65 61 63 68 20 6f 74 68 65 d from each othe
2f60: 72 0a 61 6e 64 20 66 72 6f 6d 20 74 68 65 20 63 r.and from the c
2f70: 61 72 64 2d 74 79 70 65 20 63 68 61 72 61 63 74 ard-type charact
2f80: 65 72 20 62 79 20 61 20 73 69 6e 67 6c 65 20 73 er by a single s
2f90: 70 61 63 65 0a 63 68 61 72 61 63 74 65 72 2e 20 pace.character.
2fa0: 20 54 68 65 72 65 20 69 73 20 6e 6f 20 73 75 72 There is no sur
2fb0: 70 6c 75 73 20 77 68 69 74 65 20 73 70 61 63 65 plus white space
2fc0: 20 62 65 74 77 65 65 6e 20 61 72 67 75 6d 65 6e between argumen
2fd0: 74 73 0a 61 6e 64 20 6e 6f 20 6c 65 61 64 69 6e ts.and no leadin
2fe0: 67 20 6f 72 20 74 72 61 69 6c 69 6e 67 20 77 68 g or trailing wh
2ff0: 69 74 65 73 70 61 63 65 20 65 78 63 65 70 74 20 itespace except
3000: 66 6f 72 20 74 68 65 20 6e 65 77 6c 69 6e 65 20 for the newline
3010: 0a 63 68 61 72 61 63 74 65 72 20 74 68 61 74 20 .character that
3020: 61 63 74 73 20 61 73 20 74 68 65 20 63 61 72 64 acts as the card
3030: 20 73 65 70 61 72 61 74 6f 72 2e 0a 41 6c 6c 20 separator..All
3040: 63 61 72 64 73 20 6f 66 20 61 20 63 6c 75 73 74 cards of a clust
3050: 65 72 20 6f 63 63 75 72 20 69 6e 20 73 74 72 69 er occur in stri
3060: 63 74 20 73 6f 72 74 65 64 20 6c 65 78 69 63 6f ct sorted lexico
3070: 67 72 61 70 68 69 63 61 6c 20 6f 72 64 65 72 2e graphical order.
3080: 0a 4e 6f 20 63 61 72 64 20 6d 61 79 20 62 65 20 .No card may be
3090: 64 75 70 6c 69 63 61 74 65 64 2e 0a 54 68 65 20 duplicated..The
30a0: 63 6c 75 73 74 65 72 20 6d 61 79 20 6e 6f 74 20 cluster may not
30b0: 63 6f 6e 74 61 69 6e 20 61 64 64 69 74 69 6f 6e contain addition
30c0: 61 6c 20 74 65 78 74 20 6f 72 20 64 61 74 61 20 al text or data
30d0: 62 65 79 6f 6e 64 20 0a 77 68 61 74 20 69 73 20 beyond .what is
30e0: 64 65 73 63 72 69 62 65 64 20 68 65 72 65 2e 0a described here..
30f0: 55 6e 6c 69 6b 65 20 6d 61 6e 69 66 65 73 74 73 Unlike manifests
3100: 2c 20 63 6c 75 73 74 65 72 73 20 61 72 65 20 6e , clusters are n
3110: 65 76 65 72 20 50 47 50 20 73 69 67 6e 65 64 2e ever PGP signed.
3120: 0a 0a 41 6c 6c 6f 77 65 64 20 63 61 72 64 73 20 ..Allowed cards
3130: 69 6e 20 74 68 65 20 63 6c 75 73 74 65 72 20 61 in the cluster a
3140: 72 65 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 0a re as follows:..
3150: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 62 3e <blockquote>.<b>
3160: 4d 3c 2f 62 3e 20 3c 69 3e 61 72 74 69 66 61 63 M</b> <i>artifac
3170: 74 2d 69 64 3c 2f 69 3e 3c 62 72 20 2f 3e 0a 3c t-id</i><br />.<
3180: 62 3e 5a 3c 2f 62 3e 20 3c 69 3e 63 68 65 63 6b b>Z</b> <i>check
3190: 73 75 6d 3c 2f 69 3e 0a 3c 2f 62 6c 6f 63 6b 71 sum</i>.</blockq
31a0: 75 6f 74 65 3e 0a 0a 41 20 63 6c 75 73 74 65 72 uote>..A cluster
31b0: 20 63 6f 6e 74 61 69 6e 73 20 6f 6e 65 20 6f 72 contains one or
31c0: 20 6d 6f 72 65 20 22 4d 22 20 63 61 72 64 73 20 more "M" cards
31d0: 66 6f 6c 6c 6f 77 65 64 20 62 79 20 61 20 73 69 followed by a si
31e0: 6e 67 6c 65 20 22 5a 22 0a 6c 69 6e 65 2e 20 20 ngle "Z".line.
31f0: 45 61 63 68 20 4d 20 63 61 72 64 20 68 61 73 20 Each M card has
3200: 61 20 73 69 6e 67 6c 65 20 61 72 67 75 6d 65 6e a single argumen
3210: 74 20 77 68 69 63 68 20 69 73 20 74 68 65 20 61 t which is the a
3220: 72 74 69 66 61 63 74 20 49 44 20 6f 66 20 0a 61 rtifact ID of .a
3230: 6e 6f 74 68 65 72 20 61 72 74 69 66 61 63 74 20 nother artifact
3240: 69 6e 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 in the repositor
3250: 79 2e 20 20 54 68 65 20 5a 20 63 61 72 64 20 77 y. The Z card w
3260: 6f 72 6b 20 65 78 61 63 74 6c 79 20 6c 69 6b 65 ork exactly like
3270: 0a 74 68 65 20 5a 20 63 61 72 64 20 6f 66 20 61 .the Z card of a
3280: 20 6d 61 6e 69 66 65 73 74 2e 20 20 54 68 65 20 manifest. The
3290: 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 argument to the
32a0: 5a 20 63 61 72 64 20 69 73 20 74 68 65 0a 6c 6f Z card is the.lo
32b0: 77 65 72 2d 63 61 73 65 20 68 65 78 61 64 65 63 wer-case hexadec
32c0: 69 6d 61 6c 20 72 65 70 72 65 73 65 6e 74 61 74 imal representat
32d0: 69 6f 6e 20 6f 66 20 74 68 65 20 4d 44 35 20 63 ion of the MD5 c
32e0: 68 65 63 6b 73 75 6d 20 6f 66 20 61 6c 6c 0a 70 hecksum of all.p
32f0: 72 69 6f 72 20 63 61 72 64 73 20 69 6e 20 74 68 rior cards in th
3300: 65 20 63 6c 75 73 74 65 72 2e 20 20 54 68 65 20 e cluster. The
3310: 5a 2d 63 61 72 64 20 69 73 20 72 65 71 75 69 72 Z-card is requir
3320: 65 64 2e 0a 0a 41 6e 20 65 78 61 6d 70 6c 65 20 ed...An example
3330: 63 6c 75 73 74 65 72 20 66 72 6f 6d 20 46 6f 73 cluster from Fos
3340: 73 69 6c 20 63 61 6e 20 62 65 20 73 65 65 6e 0a sil can be seen.
3350: 5b 2f 61 72 74 69 66 61 63 74 2f 64 30 33 64 62 [/artifact/d03db
3360: 64 64 37 33 61 32 61 38 20 7c 20 68 65 72 65 5d dd73a2a8 | here]
3370: 2e 0a 0a 3c 61 20 6e 61 6d 65 3d 22 63 74 72 6c ...<a name="ctrl
3380: 22 3e 3c 2f 61 3e 0a 3c 68 32 3e 33 2e 30 20 43 "></a>.<h2>3.0 C
3390: 6f 6e 74 72 6f 6c 20 41 72 74 69 66 61 63 74 73 ontrol Artifacts
33a0: 3c 2f 68 32 3e 0a 0a 43 6f 6e 74 72 6f 6c 20 61 </h2>..Control a
33b0: 72 74 69 66 61 63 74 73 20 61 72 65 20 75 73 65 rtifacts are use
33c0: 64 20 74 6f 20 61 73 73 69 67 6e 20 70 72 6f 70 d to assign prop
33d0: 65 72 74 69 65 73 20 74 6f 20 6f 74 68 65 72 20 erties to other
33e0: 61 72 74 69 66 61 63 74 73 0a 77 69 74 68 69 6e artifacts.within
33f0: 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 2e the repository.
3400: 20 20 54 68 65 20 62 61 73 69 63 20 66 6f 72 6d The basic form
3410: 61 74 20 6f 66 20 61 20 63 6f 6e 74 72 6f 6c 20 at of a control
3420: 61 72 74 69 66 61 63 74 20 69 73 0a 74 68 65 20 artifact is.the
3430: 73 61 6d 65 20 61 73 20 61 20 6d 61 6e 69 66 65 same as a manife
3440: 73 74 20 6f 72 20 63 6c 75 73 74 65 72 2e 20 20 st or cluster.
3450: 41 20 63 6f 6e 74 72 6f 6c 20 61 72 74 69 66 61 A control artifa
3460: 63 74 20 69 73 20 61 20 74 65 78 74 0a 66 69 6c ct is a text.fil
3470: 65 20 64 69 76 69 64 65 64 20 69 6e 74 6f 20 63 e divided into c
3480: 61 72 64 73 20 62 79 20 6e 65 77 6c 69 6e 65 20 ards by newline
3490: 63 68 61 72 61 63 74 65 72 73 2e 20 20 45 61 63 characters. Eac
34a0: 68 20 63 61 72 64 20 68 61 73 20 61 0a 73 69 6e h card has a.sin
34b0: 67 6c 65 2d 63 68 61 72 61 63 74 65 72 20 63 61 gle-character ca
34c0: 72 64 20 74 79 70 65 20 66 6f 6c 6c 6f 77 65 64 rd type followed
34d0: 20 62 79 20 61 72 67 75 6d 65 6e 74 73 2e 20 20 by arguments.
34e0: 53 70 61 63 65 73 20 73 65 70 61 72 61 74 65 0a Spaces separate.
34f0: 74 68 65 20 63 61 72 64 20 74 79 70 65 20 61 6e the card type an
3500: 64 20 74 68 65 20 61 72 67 75 6d 65 6e 74 73 2e d the arguments.
3510: 20 20 4e 6f 20 73 75 72 70 6c 75 73 20 77 68 69 No surplus whi
3520: 74 65 73 70 61 63 65 20 69 73 20 61 6c 6c 6f 77 tespace is allow
3530: 65 64 2e 0a 41 6c 6c 20 63 61 72 64 73 20 6d 75 ed..All cards mu
3540: 73 74 20 6f 63 63 75 72 20 69 6e 20 73 74 72 69 st occur in stri
3550: 63 74 20 6c 65 78 69 63 6f 67 72 61 70 68 69 63 ct lexicographic
3560: 61 6c 20 6f 72 64 65 72 2e 0a 0a 41 6c 6c 6f 77 al order...Allow
3570: 65 64 20 63 61 72 64 73 20 69 6e 20 61 20 63 6f ed cards in a co
3580: 6e 74 72 6f 6c 20 61 72 74 69 66 61 63 74 20 61 ntrol artifact a
3590: 72 65 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 0a re as follows:..
35a0: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 62 3e <blockquote>.<b>
35b0: 44 3c 2f 62 3e 20 3c 69 3e 74 69 6d 65 2d 61 6e D</b> <i>time-an
35c0: 64 2d 64 61 74 65 2d 73 74 61 6d 70 3c 2f 69 3e d-date-stamp</i>
35d0: 3c 62 72 20 2f 3e 0a 3c 62 3e 54 3c 2f 62 3e 20 <br />.<b>T</b>
35e0: 28 3c 62 3e 2b 3c 2f 62 3e 7c 3c 62 3e 2d 3c 2f (<b>+</b>|<b>-</
35f0: 62 3e 7c 3c 62 3e 2a 3c 2f 62 3e 29 3c 69 3e 74 b>|<b>*</b>)<i>t
3600: 61 67 2d 6e 61 6d 65 3c 2f 69 3e 20 3c 69 3e 61 ag-name</i> <i>a
3610: 72 74 69 66 61 63 74 2d 69 64 3c 2f 69 3e 20 3f rtifact-id</i> ?
3620: 3c 69 3e 76 61 6c 75 65 3c 2f 69 3e 3f 3c 62 72 <i>value</i>?<br
3630: 20 2f 3e 0a 3c 62 3e 55 3c 2f 62 3e 20 3c 69 3e />.<b>U</b> <i>
3640: 75 73 65 72 2d 6e 61 6d 65 3c 2f 69 3e 3c 62 72 user-name</i><br
3650: 20 2f 3e 0a 3c 62 3e 5a 3c 2f 62 3e 20 3c 69 3e />.<b>Z</b> <i>
3660: 63 68 65 63 6b 73 75 6d 3c 2f 69 3e 3c 62 72 20 checksum</i><br
3670: 2f 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e />.</blockquote>
3680: 0a 0a 41 20 63 6f 6e 74 72 6f 6c 20 61 72 74 69 ..A control arti
3690: 66 61 63 74 20 6d 75 73 74 20 68 61 76 65 20 6f fact must have o
36a0: 6e 65 20 44 20 63 61 72 64 2c 20 6f 6e 65 20 55 ne D card, one U
36b0: 20 63 61 72 64 2c 20 6f 6e 65 20 5a 20 63 61 72 card, one Z car
36c0: 64 20 61 6e 64 0a 6f 6e 65 20 6f 72 20 6d 6f 72 d and.one or mor
36d0: 65 20 54 20 63 61 72 64 73 2e 20 20 4e 6f 20 6f e T cards. No o
36e0: 74 68 65 72 20 63 61 72 64 73 20 6f 72 20 6f 74 ther cards or ot
36f0: 68 65 72 20 74 65 78 74 20 69 73 0a 61 6c 6c 6f her text is.allo
3700: 77 65 64 20 69 6e 20 61 20 63 6f 6e 74 72 6f 6c wed in a control
3710: 20 61 72 74 69 66 61 63 74 2e 20 20 43 6f 6e 74 artifact. Cont
3720: 72 6f 6c 20 61 72 74 69 66 61 63 74 73 20 6d 69 rol artifacts mi
3730: 67 68 74 20 62 65 20 50 47 50 0a 63 6c 65 61 72 ght be PGP.clear
3740: 73 69 67 6e 65 64 2e 0a 0a 54 68 65 20 44 20 63 signed...The D c
3750: 61 72 64 20 61 6e 64 20 74 68 65 20 5a 20 63 61 ard and the Z ca
3760: 72 64 20 6f 66 20 61 20 63 6f 6e 74 72 6f 6c 20 rd of a control
3770: 61 72 74 69 66 61 63 74 20 61 72 65 20 74 68 65 artifact are the
3780: 20 73 61 6d 65 0a 61 73 20 69 6e 20 61 20 6d 61 same.as in a ma
3790: 6e 69 66 65 73 74 2e 0a 0a 54 68 65 20 54 20 63 nifest...The T c
37a0: 61 72 64 20 72 65 70 72 65 73 65 6e 74 73 20 61 ard represents a
37b0: 20 5b 2e 2f 62 72 61 6e 63 68 69 6e 67 2e 77 69 [./branching.wi
37c0: 6b 69 23 74 61 67 73 20 7c 20 74 61 67 20 6f 72 ki#tags | tag or
37d0: 20 70 72 6f 70 65 72 74 79 5d 0a 74 68 61 74 20 property].that
37e0: 69 73 20 61 70 70 6c 69 65 64 20 74 6f 0a 73 6f is applied to.so
37f0: 6d 65 20 6f 74 68 65 72 20 61 72 74 69 66 61 63 me other artifac
3800: 74 2e 20 20 54 68 65 20 54 20 63 61 72 64 20 68 t. The T card h
3810: 61 73 20 74 77 6f 20 6f 72 20 74 68 72 65 65 20 as two or three
3820: 76 61 6c 75 65 73 2e 20 20 54 68 65 0a 73 65 63 values. The.sec
3830: 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 69 73 20 ond argument is
3840: 74 68 65 20 34 30 20 63 68 61 72 61 63 74 65 72 the 40 character
3850: 20 6c 6f 77 65 72 63 61 73 65 20 61 72 74 69 66 lowercase artif
3860: 61 63 74 20 49 44 20 6f 66 20 74 68 65 20 61 72 act ID of the ar
3870: 74 69 66 61 63 74 0a 74 6f 20 77 68 69 63 68 20 tifact.to which
3880: 74 68 65 20 74 61 67 20 69 73 20 74 6f 20 62 65 the tag is to be
3890: 20 61 70 70 6c 69 65 64 2e 20 54 68 65 0a 66 69 applied. The.fi
38a0: 72 73 74 20 76 61 6c 75 65 20 69 73 20 74 68 65 rst value is the
38b0: 20 74 61 67 20 6e 61 6d 65 2e 20 20 54 68 65 20 tag name. The
38c0: 66 69 72 73 74 20 63 68 61 72 61 63 74 65 72 20 first character
38d0: 6f 66 20 74 68 65 20 74 61 67 0a 69 73 20 65 69 of the tag.is ei
38e0: 74 68 65 72 20 22 2b 22 2c 20 22 2d 22 2c 20 6f ther "+", "-", o
38f0: 72 20 22 2a 22 2e 20 20 54 68 65 20 22 2b 22 20 r "*". The "+"
3900: 6d 65 61 6e 73 20 74 68 65 20 74 61 67 20 73 68 means the tag sh
3910: 6f 75 6c 64 20 62 65 20 61 64 64 65 64 0a 74 6f ould be added.to
3920: 20 74 68 65 20 61 72 74 69 66 61 63 74 2e 20 20 the artifact.
3930: 54 68 65 20 22 2d 22 20 6d 65 61 6e 73 20 74 68 The "-" means th
3940: 65 20 74 61 67 20 73 68 6f 75 6c 64 20 62 65 20 e tag should be
3950: 72 65 6d 6f 76 65 64 2e 0a 54 68 65 20 22 2a 22 removed..The "*"
3960: 20 63 68 61 72 61 63 74 65 72 20 6d 65 61 6e 73 character means
3970: 20 74 68 65 20 74 61 67 20 73 68 6f 75 6c 64 20 the tag should
3980: 62 65 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 be added to the
3990: 61 72 74 69 66 61 63 74 0a 61 6e 64 20 61 6c 6c artifact.and all
39a0: 20 64 69 72 65 63 74 20 64 65 73 63 65 6e 64 61 direct descenda
39b0: 6e 74 73 20 28 62 75 74 20 6e 6f 74 20 64 65 73 nts (but not des
39c0: 63 65 6e 64 65 6e 74 73 20 74 68 72 6f 75 67 68 cendents through
39d0: 20 61 20 6d 65 72 67 65 29 20 64 6f 77 6e 0a 74 a merge) down.t
39e0: 6f 20 62 75 74 20 6e 6f 74 20 69 6e 63 6c 75 64 o but not includ
39f0: 69 6e 67 20 74 68 65 20 66 69 72 73 74 20 64 65 ing the first de
3a00: 73 63 65 6e 64 61 6e 74 20 74 68 61 74 20 63 6f scendant that co
3a10: 6e 74 61 69 6e 73 20 61 20 0a 6d 6f 72 65 20 72 ntains a .more r
3a20: 65 63 65 6e 74 20 22 2d 22 20 6f 72 20 22 2b 22 ecent "-" or "+"
3a30: 20 74 61 67 20 77 69 74 68 20 74 68 65 20 73 61 tag with the sa
3a40: 6d 65 20 6e 61 6d 65 2e 0a 54 68 65 20 6f 70 74 me name..The opt
3a50: 69 6f 6e 61 6c 20 74 68 69 72 64 20 61 72 67 75 ional third argu
3a60: 6d 65 6e 74 20 69 73 20 74 68 65 20 76 61 6c 75 ment is the valu
3a70: 65 20 6f 66 20 74 68 65 20 74 61 67 2e 20 20 41 e of the tag. A
3a80: 20 74 61 67 0a 77 69 74 68 6f 75 74 20 61 20 76 tag.without a v
3a90: 61 6c 75 65 20 69 73 20 61 20 62 6f 6f 6c 65 61 alue is a boolea
3aa0: 6e 2e 0a 0a 57 68 65 6e 20 74 77 6f 20 6f 72 20 n...When two or
3ab0: 6d 6f 72 65 20 74 61 67 73 20 77 69 74 68 20 74 more tags with t
3ac0: 68 65 20 73 61 6d 65 20 6e 61 6d 65 20 61 72 65 he same name are
3ad0: 20 61 70 70 6c 69 65 64 20 74 6f 20 74 68 65 0a applied to the.
3ae0: 73 61 6d 65 20 61 72 74 69 66 61 63 74 2c 20 74 same artifact, t
3af0: 68 65 20 74 61 67 20 77 69 74 68 20 74 68 65 20 he tag with the
3b00: 6c 61 74 65 73 74 20 28 6d 6f 73 74 20 72 65 63 latest (most rec
3b10: 65 6e 74 29 20 64 61 74 65 20 69 73 0a 75 73 65 ent) date is.use
3b20: 64 2e 0a 0a 53 6f 6d 65 20 74 61 67 73 20 68 61 d...Some tags ha
3b30: 76 65 20 73 70 65 63 69 61 6c 20 6d 65 61 6e 69 ve special meani
3b40: 6e 67 2e 20 20 54 68 65 20 22 63 6f 6d 6d 65 6e ng. The "commen
3b50: 74 22 20 74 61 67 20 77 68 65 6e 20 61 70 70 6c t" tag when appl
3b60: 69 65 64 0a 74 6f 20 61 20 63 68 65 63 6b 2d 69 ied.to a check-i
3b70: 6e 20 77 69 6c 6c 20 6f 76 65 72 72 69 64 65 20 n will override
3b80: 74 68 65 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d the check-in com
3b90: 6d 65 6e 74 20 6f 66 20 74 68 61 74 20 63 68 65 ment of that che
3ba0: 63 6b 2d 69 6e 0a 66 6f 72 20 64 69 73 70 6c 61 ck-in.for displa
3bb0: 79 20 70 75 72 70 6f 73 65 73 2e 20 20 54 68 65 y purposes. The
3bc0: 20 22 75 73 65 72 22 20 74 61 67 20 6f 76 65 72 "user" tag over
3bd0: 72 69 64 65 73 20 74 68 65 20 6e 61 6d 65 20 6f rides the name o
3be0: 66 20 74 68 65 0a 63 68 65 63 6b 2d 69 6e 20 75 f the.check-in u
3bf0: 73 65 72 2e 20 20 54 68 65 20 22 64 61 74 65 22 ser. The "date"
3c00: 20 74 61 67 20 6f 76 65 72 72 69 64 65 73 20 74 tag overrides t
3c10: 68 65 20 63 68 65 63 6b 2d 69 6e 20 64 61 74 65 he check-in date
3c20: 2e 0a 54 68 65 20 22 62 72 61 6e 63 68 22 20 74 ..The "branch" t
3c30: 61 67 20 73 65 74 73 20 74 68 65 20 6e 61 6d 65 ag sets the name
3c40: 20 6f 66 20 74 68 65 20 62 72 61 6e 63 68 20 74 of the branch t
3c50: 68 61 74 20 61 74 20 63 68 65 63 6b 2d 69 6e 0a hat at check-in.
3c60: 62 65 6c 6f 6e 67 73 20 74 6f 2e 20 20 53 79 6d belongs to. Sym
3c70: 62 6f 6c 69 63 20 74 61 67 73 20 62 65 67 69 6e bolic tags begin
3c80: 20 77 69 74 68 20 74 68 65 20 22 73 79 6d 2d 22 with the "sym-"
3c90: 20 70 72 65 66 69 78 2e 0a 0a 54 68 65 20 55 20 prefix...The U
3ca0: 63 61 72 64 20 69 73 20 74 68 65 20 6e 61 6d 65 card is the name
3cb0: 20 6f 66 20 74 68 65 20 75 73 65 72 20 74 68 61 of the user tha
3cc0: 74 20 63 72 65 61 74 65 64 20 74 68 65 20 63 6f t created the co
3cd0: 6e 74 72 6f 6c 20 0a 61 72 74 69 66 61 63 74 2e ntrol .artifact.
3ce0: 20 20 54 68 65 20 5a 20 63 61 72 64 20 69 73 20 The Z card is
3cf0: 74 68 65 20 75 73 75 61 6c 20 72 65 71 75 69 72 the usual requir
3d00: 65 64 20 61 72 74 69 66 61 63 74 20 63 68 65 63 ed artifact chec
3d10: 6b 73 75 6d 2e 0a 0a 41 6e 20 65 78 61 6d 70 6c ksum...An exampl
3d20: 65 20 63 6f 6e 74 72 6f 6c 20 61 72 74 69 66 61 e control artifa
3d30: 63 74 73 20 63 61 6e 20 62 65 20 73 65 65 6e 20 cts can be seen
3d40: 5b 2f 69 6e 66 6f 2f 39 64 33 30 32 63 63 64 61 [/info/9d302ccda
3d50: 38 20 7c 20 68 65 72 65 5d 2e 0a 0a 0a 3c 61 20 8 | here]....<a
3d60: 6e 61 6d 65 3d 22 77 69 6b 69 63 68 6e 67 22 3e name="wikichng">
3d70: 3c 2f 61 3e 0a 3c 68 32 3e 34 2e 30 20 57 69 6b </a>.<h2>4.0 Wik
3d80: 69 20 50 61 67 65 73 3c 2f 68 32 3e 0a 0a 41 20 i Pages</h2>..A
3d90: 77 69 6b 69 20 70 61 67 65 20 69 73 20 61 6e 20 wiki page is an
3da0: 61 72 74 69 66 61 63 74 20 77 69 74 68 20 61 20 artifact with a
3db0: 66 6f 72 6d 61 74 20 73 69 6d 69 6c 61 72 20 74 format similar t
3dc0: 6f 20 6d 61 6e 69 66 65 73 74 73 2c 0a 63 6c 75 o manifests,.clu
3dd0: 73 74 65 72 73 2c 20 61 6e 64 20 63 6f 6e 74 72 sters, and contr
3de0: 6f 6c 20 61 72 74 69 66 61 63 74 73 2e 20 20 54 ol artifacts. T
3df0: 68 65 20 61 72 74 69 66 61 63 74 20 69 73 20 64 he artifact is d
3e00: 69 76 69 64 65 64 20 69 6e 74 6f 0a 63 61 72 64 ivided into.card
3e10: 73 20 62 79 20 6e 65 77 6c 69 6e 65 20 63 68 61 s by newline cha
3e20: 72 61 63 74 65 72 73 2e 20 20 54 68 65 20 66 6f racters. The fo
3e30: 72 6d 61 74 20 6f 66 20 65 61 63 68 20 63 61 72 rmat of each car
3e40: 64 20 69 73 20 61 73 20 69 6e 0a 6d 61 6e 69 66 d is as in.manif
3e50: 65 73 74 73 2c 20 63 6c 75 73 74 65 72 73 2c 20 ests, clusters,
3e60: 61 6e 64 20 63 6f 6e 74 72 6f 6c 20 61 72 74 69 and control arti
3e70: 66 61 63 74 73 2e 20 20 57 69 6b 69 20 61 72 74 facts. Wiki art
3e80: 69 66 61 63 74 73 20 61 63 63 65 70 74 0a 74 68 ifacts accept.th
3e90: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 61 72 64 e following card
3ea0: 20 74 79 70 65 73 3a 0a 0a 3c 62 6c 6f 63 6b 71 types:..<blockq
3eb0: 75 6f 74 65 3e 0a 3c 62 3e 44 3c 2f 62 3e 20 3c uote>.<b>D</b> <
3ec0: 69 3e 74 69 6d 65 2d 61 6e 64 2d 64 61 74 65 2d i>time-and-date-
3ed0: 73 74 61 6d 70 3c 2f 69 3e 3c 62 72 20 2f 3e 0a stamp</i><br />.
3ee0: 3c 62 3e 4c 3c 2f 62 3e 20 3c 69 3e 77 69 6b 69 <b>L</b> <i>wiki
3ef0: 2d 74 69 74 6c 65 3c 2f 69 3e 3c 62 72 20 2f 3e -title</i><br />
3f00: 0a 3c 62 3e 4e 3c 2f 62 3e 20 3c 69 3e 6d 69 6d .<b>N</b> <i>mim
3f10: 65 74 79 70 65 3c 2f 69 3e 3c 62 72 20 2f 3e 0a etype</i><br />.
3f20: 3c 62 3e 50 3c 2f 62 3e 20 3c 69 3e 70 61 72 65 <b>P</b> <i>pare
3f30: 6e 74 2d 61 72 74 69 66 61 63 74 2d 69 64 3c 2f nt-artifact-id</
3f40: 69 3e 2b 3c 62 72 20 2f 3e 0a 3c 62 3e 55 3c 2f i>+<br />.<b>U</
3f50: 62 3e 20 3c 69 3e 75 73 65 72 2d 6e 61 6d 65 3c b> <i>user-name<
3f60: 2f 69 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 57 3c 2f /i><br />.<b>W</
3f70: 62 3e 20 3c 69 3e 73 69 7a 65 3c 2f 69 3e 20 3c b> <i>size</i> <
3f80: 62 3e 5c 6e 3c 2f 62 3e 20 3c 69 3e 74 65 78 74 b>\n</b> <i>text
3f90: 3c 2f 69 3e 20 3c 62 3e 5c 6e 3c 2f 62 3e 3c 62 </i> <b>\n</b><b
3fa0: 72 20 2f 3e 0a 3c 62 3e 5a 3c 2f 62 3e 20 3c 69 r />.<b>Z</b> <i
3fb0: 3e 63 68 65 63 6b 73 75 6d 3c 2f 69 3e 0a 3c 2f >checksum</i>.</
3fc0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 54 68 65 blockquote>..The
3fd0: 20 44 20 63 61 72 64 20 69 73 20 74 68 65 20 64 D card is the d
3fe0: 61 74 65 20 61 6e 64 20 74 69 6d 65 20 77 68 65 ate and time whe
3ff0: 6e 20 74 68 65 20 77 69 6b 69 20 70 61 67 65 20 n the wiki page
4000: 77 61 73 20 65 64 69 74 65 64 2e 0a 54 68 65 20 was edited..The
4010: 50 20 63 61 72 64 20 73 70 65 63 69 66 69 65 73 P card specifies
4020: 20 74 68 65 20 70 61 72 65 6e 74 20 77 69 6b 69 the parent wiki
4030: 20 70 61 67 65 73 2c 20 69 66 20 61 6e 79 2e 20 pages, if any.
4040: 20 54 68 65 20 4c 20 63 61 72 64 0a 67 69 76 65 The L card.give
4050: 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 s the name of th
4060: 65 20 77 69 6b 69 20 70 61 67 65 2e 20 20 54 68 e wiki page. Th
4070: 65 20 6f 70 74 69 6f 6e 61 6c 20 4e 20 63 61 72 e optional N car
4080: 64 20 73 70 65 63 69 66 69 65 73 0a 74 68 65 20 d specifies.the
4090: 6d 69 6d 65 74 79 70 65 20 6f 66 20 74 68 65 20 mimetype of the
40a0: 77 69 6b 69 20 74 65 78 74 2e 20 20 49 66 20 74 wiki text. If t
40b0: 68 65 20 4e 20 63 61 72 64 20 69 73 20 6f 6d 69 he N card is omi
40c0: 74 74 65 64 2c 20 74 68 65 0a 6d 69 6d 65 74 79 tted, the.mimety
40d0: 70 65 20 69 73 20 61 73 73 75 6d 65 64 20 74 6f pe is assumed to
40e0: 20 62 65 20 74 65 78 74 2f 78 2d 66 6f 73 73 69 be text/x-fossi
40f0: 6c 2e 20 20 0a 54 68 65 20 55 20 63 61 72 64 20 l. .The U card
4100: 73 70 65 63 69 66 69 65 73 20 74 68 65 20 6c 6f specifies the lo
4110: 67 69 6e 0a 6f 66 20 74 68 65 20 75 73 65 72 20 gin.of the user
4120: 77 68 6f 20 6d 61 64 65 20 74 68 69 73 20 65 64 who made this ed
4130: 69 74 20 74 6f 20 74 68 65 20 77 69 6b 69 20 70 it to the wiki p
4140: 61 67 65 2e 20 20 54 68 65 20 5a 20 63 61 72 64 age. The Z card
4150: 20 69 73 0a 74 68 65 20 75 73 75 61 6c 20 63 68 is.the usual ch
4160: 65 63 6b 73 75 6d 20 6f 76 65 72 20 74 68 65 20 ecksum over the
4170: 65 69 74 68 65 72 20 61 72 74 69 66 61 63 74 20 either artifact
4180: 61 6e 64 20 69 73 20 72 65 71 75 69 72 65 64 2e and is required.
4190: 0a 0a 54 68 65 20 57 20 63 61 72 64 20 69 73 20 ..The W card is
41a0: 75 73 65 64 20 74 6f 20 73 70 65 63 69 66 79 20 used to specify
41b0: 74 68 65 20 74 65 78 74 20 6f 66 20 74 68 65 20 the text of the
41c0: 77 69 6b 69 20 70 61 67 65 2e 20 20 54 68 65 0a wiki page. The.
41d0: 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 argument to the
41e0: 57 20 63 61 72 64 20 69 73 20 61 6e 20 69 6e 74 W card is an int
41f0: 65 67 65 72 20 77 68 69 63 68 20 69 73 20 74 68 eger which is th
4200: 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 e number of byte
4210: 73 0a 6f 66 20 74 65 78 74 20 69 6e 20 74 68 65 s.of text in the
4220: 20 77 69 6b 69 20 70 61 67 65 2e 20 20 54 68 61 wiki page. Tha
4230: 74 20 74 65 78 74 20 66 6f 6c 6c 6f 77 73 20 74 t text follows t
4240: 68 65 20 6e 65 77 6c 69 6e 65 20 63 68 61 72 61 he newline chara
4250: 63 74 65 72 0a 74 68 61 74 20 74 65 72 6d 69 6e cter.that termin
4260: 61 74 65 73 20 74 68 65 20 57 20 63 61 72 64 2e ates the W card.
4270: 20 20 54 68 65 20 77 69 6b 69 20 74 65 78 74 20 The wiki text
4280: 69 73 20 61 6c 77 61 79 73 20 66 6f 6c 6c 6f 77 is always follow
4290: 65 64 20 62 79 20 6f 6e 65 0a 65 78 74 72 61 20 ed by one.extra
42a0: 6e 65 77 6c 69 6e 65 2e 0a 0a 41 6e 20 65 78 61 newline...An exa
42b0: 6d 70 6c 65 20 77 69 6b 69 20 61 72 74 69 66 61 mple wiki artifa
42c0: 63 74 20 63 61 6e 20 62 65 20 73 65 65 6e 0a 5b ct can be seen.[
42d0: 2f 61 72 74 69 66 61 63 74 3f 6e 61 6d 65 3d 37 /artifact?name=7
42e0: 62 32 66 35 66 64 30 65 30 26 74 78 74 3d 31 20 b2f5fd0e0&txt=1
42f0: 7c 20 68 65 72 65 5d 2e 0a 0a 3c 61 20 6e 61 6d | here]...<a nam
4300: 65 3d 22 74 6b 74 63 68 6e 67 22 3e 3c 2f 61 3e e="tktchng"></a>
4310: 0a 3c 68 32 3e 35 2e 30 20 54 69 63 6b 65 74 20 .<h2>5.0 Ticket
4320: 43 68 61 6e 67 65 73 3c 2f 68 32 3e 0a 0a 41 20 Changes</h2>..A
4330: 74 69 63 6b 65 74 2d 63 68 61 6e 67 65 20 61 72 ticket-change ar
4340: 74 69 66 61 63 74 20 72 65 70 72 65 73 65 6e 74 tifact represent
4350: 73 20 61 20 63 68 61 6e 67 65 20 74 6f 20 61 20 s a change to a
4360: 74 72 6f 75 62 6c 65 20 74 69 63 6b 65 74 2e 0a trouble ticket..
4370: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 61 The following ca
4380: 72 64 73 20 61 72 65 20 61 6c 6c 6f 77 65 64 20 rds are allowed
4390: 6f 6e 20 61 20 74 69 63 6b 65 74 20 63 68 61 6e on a ticket chan
43a0: 67 65 20 61 72 74 69 66 61 63 74 3a 0a 0a 3c 62 ge artifact:..<b
43b0: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 62 3e 44 3c lockquote>.<b>D<
43c0: 2f 62 3e 20 3c 69 3e 74 69 6d 65 2d 61 6e 64 2d /b> <i>time-and-
43d0: 64 61 74 65 2d 73 74 61 6d 70 3c 2f 69 3e 3c 62 date-stamp</i><b
43e0: 72 20 2f 3e 0a 3c 62 3e 4a 3c 2f 62 3e 20 3f 3c r />.<b>J</b> ?<
43f0: 62 3e 2b 3c 2f 62 3e 3f 3c 69 3e 6e 61 6d 65 3c b>+</b>?<i>name<
4400: 2f 69 3e 20 3f 3c 69 3e 76 61 6c 75 65 3c 2f 69 /i> ?<i>value</i
4410: 3e 3f 3c 62 72 20 2f 3e 0a 3c 62 3e 4b 3c 2f 62 >?<br />.<b>K</b
4420: 3e 20 3c 69 3e 74 69 63 6b 65 74 2d 69 64 3c 2f > <i>ticket-id</
4430: 69 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 55 3c 2f 62 i><br />.<b>U</b
4440: 3e 20 3c 69 3e 75 73 65 72 2d 6e 61 6d 65 3c 2f > <i>user-name</
4450: 69 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 5a 3c 2f 62 i><br />.<b>Z</b
4460: 3e 20 3c 69 3e 63 68 65 63 6b 73 75 6d 3c 2f 69 > <i>checksum</i
4470: 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a >.</blockquote>.
4480: 0a 54 68 65 20 44 20 63 61 72 64 20 69 73 20 74 .The D card is t
4490: 68 65 20 75 73 75 61 6c 20 64 61 74 65 20 61 6e he usual date an
44a0: 64 20 74 69 6d 65 20 73 74 61 6d 70 20 61 6e 64 d time stamp and
44b0: 20 72 65 70 72 65 73 65 6e 74 73 20 74 68 65 20 represents the
44c0: 70 6f 69 6e 74 0a 69 6e 20 74 69 6d 65 20 77 68 point.in time wh
44d0: 65 6e 20 74 68 65 20 63 68 61 6e 67 65 20 77 61 en the change wa
44e0: 73 20 65 6e 74 65 72 65 64 2e 20 20 54 68 65 20 s entered. The
44f0: 55 20 63 61 72 64 20 69 73 20 74 68 65 20 6c 6f U card is the lo
4500: 67 69 6e 20 6f 66 20 74 68 65 0a 70 72 6f 67 72 gin of the.progr
4510: 61 6d 6d 65 72 20 77 68 6f 20 65 6e 74 65 72 65 ammer who entere
4520: 64 20 74 68 69 73 20 63 68 61 6e 67 65 2e 20 20 d this change.
4530: 54 68 65 20 5a 20 63 61 72 64 20 69 73 20 74 68 The Z card is th
4540: 65 20 72 65 71 75 69 72 65 64 20 63 68 65 63 6b e required check
4550: 73 75 6d 20 6f 76 65 72 0a 74 68 65 20 65 6e 74 sum over.the ent
4560: 69 72 65 20 61 72 74 69 66 61 63 74 2e 0a 0a 45 ire artifact...E
4570: 76 65 72 79 20 74 69 63 6b 65 74 20 68 61 73 20 very ticket has
4580: 61 20 64 69 73 74 69 6e 63 74 20 74 69 63 6b 65 a distinct ticke
4590: 74 2d 69 64 3a 0a 34 30 2d 63 68 61 72 61 63 74 t-id:.40-charact
45a0: 65 72 20 6c 6f 77 65 72 2d 63 61 73 65 20 68 65 er lower-case he
45b0: 78 61 64 65 63 69 6d 61 6c 20 6e 75 6d 62 65 72 xadecimal number
45c0: 2e 0a 54 68 65 20 74 69 63 6b 65 74 2d 69 64 20 ..The ticket-id
45d0: 69 73 20 67 69 76 65 6e 20 69 6e 20 74 68 65 20 is given in the
45e0: 4b 2d 63 61 72 64 2e 20 20 41 20 74 69 63 6b 65 K-card. A ticke
45f0: 74 20 65 78 69 73 74 73 20 69 66 20 69 74 20 63 t exists if it c
4600: 6f 6e 74 61 69 6e 73 20 6f 6e 65 20 6f 72 0a 6d ontains one or.m
4610: 6f 72 65 20 63 68 61 6e 67 65 73 2e 20 20 54 68 ore changes. Th
4620: 65 20 66 69 72 73 74 20 22 63 68 61 6e 67 65 22 e first "change"
4630: 20 74 6f 20 61 20 74 69 63 6b 65 74 20 69 73 20 to a ticket is
4640: 77 68 61 74 20 62 72 69 6e 67 73 20 74 68 65 0a what brings the.
4650: 74 69 63 6b 65 74 20 69 6e 74 6f 20 65 78 69 73 ticket into exis
4660: 74 65 6e 63 65 2e 0a 0a 4a 20 63 61 72 64 73 20 tence...J cards
4670: 73 70 65 63 69 66 79 20 63 68 61 6e 67 65 73 20 specify changes
4680: 74 6f 20 74 68 65 20 22 76 61 6c 75 65 22 20 6f to the "value" o
4690: 66 20 22 66 69 65 6c 64 73 22 20 69 6e 20 74 68 f "fields" in th
46a0: 65 20 74 69 63 6b 65 74 2e 0a 49 66 20 74 68 65 e ticket..If the
46b0: 20 3c 69 3e 76 61 6c 75 65 3c 2f 69 3e 20 70 61 <i>value</i> pa
46c0: 72 61 6d 65 74 65 72 20 6f 66 20 74 68 65 20 4a rameter of the J
46d0: 20 63 61 72 64 20 69 73 20 6f 6d 69 74 74 65 64 card is omitted
46e0: 2c 20 74 68 65 6e 20 74 68 65 0a 66 69 65 6c 64 , then the.field
46f0: 20 69 73 20 73 65 74 20 74 6f 20 61 6e 20 65 6d is set to an em
4700: 70 74 79 20 73 74 72 69 6e 67 2e 0a 45 61 63 68 pty string..Each
4710: 20 66 6f 73 73 69 6c 20 73 65 72 76 65 72 20 68 fossil server h
4720: 61 73 20 61 20 74 69 63 6b 65 74 20 63 6f 6e 66 as a ticket conf
4730: 69 67 75 72 61 74 69 6f 6e 20 77 68 69 63 68 20 iguration which
4740: 73 70 65 63 69 66 69 65 73 20 74 68 65 20 66 69 specifies the fi
4750: 65 6c 64 73 20 69 74 73 0a 75 6e 64 65 72 73 74 elds its.underst
4760: 61 6e 64 73 2e 20 20 54 68 65 20 74 69 63 6b 65 ands. The ticke
4770: 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 t configuration
4780: 69 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 6c is part of the l
4790: 6f 63 61 6c 20 73 74 61 74 65 20 66 6f 72 0a 74 ocal state for.t
47a0: 68 65 20 72 65 70 6f 73 69 74 6f 72 79 20 61 6e he repository an
47b0: 64 20 74 68 75 73 20 63 61 6e 20 76 61 72 79 20 d thus can vary
47c0: 66 72 6f 6d 20 6f 6e 65 20 72 65 70 6f 73 69 74 from one reposit
47d0: 6f 72 79 20 74 6f 20 61 6e 6f 74 68 65 72 2e 0a ory to another..
47e0: 48 65 6e 63 65 20 61 20 4a 20 63 61 72 64 20 6d Hence a J card m
47f0: 69 67 68 74 20 73 70 65 63 69 66 79 20 61 20 3c ight specify a <
4800: 69 3e 66 69 65 6c 64 3c 2f 69 3e 20 74 68 61 74 i>field</i> that
4810: 20 64 6f 20 6e 6f 74 20 65 78 69 73 74 20 69 6e do not exist in
4820: 20 74 68 65 20 0a 6c 6f 63 61 6c 20 74 69 63 6b the .local tick
4830: 65 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e et configuration
4840: 2e 20 20 49 66 20 61 20 4a 20 63 61 72 64 20 73 . If a J card s
4850: 70 65 63 69 66 69 65 73 20 61 20 3c 69 3e 66 69 pecifies a <i>fi
4860: 65 6c 64 3c 2f 69 3e 20 74 68 61 74 0a 69 73 20 eld</i> that.is
4870: 6e 6f 74 20 69 6e 20 74 68 65 20 6c 6f 63 61 6c not in the local
4880: 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2c 20 configuration,
4890: 74 68 65 6e 20 74 68 61 74 20 4a 20 63 61 72 64 then that J card
48a0: 0a 69 73 20 73 69 6d 70 6c 79 20 69 67 6e 6f 72 .is simply ignor
48b0: 65 64 2e 0a 0a 54 68 65 20 66 69 72 73 74 20 61 ed...The first a
48c0: 72 67 75 6d 65 6e 74 20 6f 66 20 74 68 65 20 4a rgument of the J
48d0: 20 63 61 72 64 20 69 73 20 74 68 65 20 66 69 65 card is the fie
48e0: 6c 64 20 6e 61 6d 65 2e 20 20 54 68 65 20 73 65 ld name. The se
48f0: 63 6f 6e 64 0a 76 61 6c 75 65 20 69 73 20 74 68 cond.value is th
4900: 65 20 66 69 65 6c 64 20 76 61 6c 75 65 2e 20 20 e field value.
4910: 49 66 20 74 68 65 20 66 69 65 6c 64 20 6e 61 6d If the field nam
4920: 65 20 62 65 67 69 6e 73 20 77 69 74 68 20 22 2b e begins with "+
4930: 22 20 74 68 65 6e 0a 74 68 65 20 76 61 6c 75 65 " then.the value
4940: 20 69 73 20 61 70 70 65 6e 64 65 64 20 74 6f 20 is appended to
4950: 74 68 65 20 70 72 69 6f 72 20 76 61 6c 75 65 2e the prior value.
4960: 20 20 4f 74 68 65 72 77 69 73 65 2c 20 74 68 65 Otherwise, the
4970: 20 76 61 6c 75 65 0a 6f 6e 20 74 68 65 20 4a 20 value.on the J
4980: 63 61 72 64 20 72 65 70 6c 61 63 65 73 20 61 6e card replaces an
4990: 79 20 70 72 65 76 69 6f 75 73 20 76 61 6c 75 65 y previous value
49a0: 20 6f 66 20 74 68 65 20 66 69 65 6c 64 2e 0a 54 of the field..T
49b0: 68 65 20 66 69 65 6c 64 20 6e 61 6d 65 20 61 6e he field name an
49c0: 64 20 76 61 6c 75 65 20 61 72 65 20 62 6f 74 68 d value are both
49d0: 20 65 6e 63 6f 64 65 64 20 75 73 69 6e 67 20 74 encoded using t
49e0: 68 65 20 63 68 61 72 61 63 74 65 72 0a 65 73 63 he character.esc
49f0: 61 70 65 73 20 64 65 66 69 6e 65 64 20 66 6f 72 apes defined for
4a00: 20 74 68 65 20 43 20 63 61 72 64 20 6f 66 20 61 the C card of a
4a10: 20 6d 61 6e 69 66 65 73 74 2e 0a 0a 41 6e 20 65 manifest...An e
4a20: 78 61 6d 70 6c 65 20 74 69 63 6b 65 74 2d 63 68 xample ticket-ch
4a30: 61 6e 67 65 20 61 72 74 69 66 61 63 74 20 63 61 ange artifact ca
4a40: 6e 20 62 65 20 73 65 65 6e 0a 5b 2f 61 72 74 69 n be seen.[/arti
4a50: 66 61 63 74 2f 39 31 66 31 65 63 36 61 66 30 35 fact/91f1ec6af05
4a60: 33 20 7c 20 68 65 72 65 5d 2e 0a 0a 3c 61 20 6e 3 | here]...<a n
4a70: 61 6d 65 3d 22 61 74 74 61 63 68 6d 65 6e 74 22 ame="attachment"
4a80: 3e 3c 2f 61 3e 0a 3c 68 32 3e 36 2e 30 20 41 74 ></a>.<h2>6.0 At
4a90: 74 61 63 68 6d 65 6e 74 73 3c 2f 68 32 3e 0a 0a tachments</h2>..
4aa0: 41 6e 20 61 74 74 61 63 68 6d 65 6e 74 20 61 72 An attachment ar
4ab0: 74 69 66 61 63 74 20 61 73 73 6f 63 69 61 74 65 tifact associate
4ac0: 73 20 73 6f 6d 65 20 6f 74 68 65 72 20 61 72 74 s some other art
4ad0: 69 66 61 63 74 20 74 68 61 74 20 69 73 20 74 68 ifact that is th
4ae0: 65 0a 61 74 74 61 63 68 6d 65 6e 74 20 28 74 68 e.attachment (th
4af0: 65 20 73 6f 75 72 63 65 20 61 72 74 69 66 61 63 e source artifac
4b00: 74 29 20 77 69 74 68 20 61 20 74 69 63 6b 65 74 t) with a ticket
4b10: 20 6f 72 20 77 69 6b 69 20 70 61 67 65 20 6f 72 or wiki page or
4b20: 20 65 76 65 6e 74 20 74 6f 20 77 68 69 63 68 0a event to which.
4b30: 74 68 65 20 61 74 74 61 63 68 6d 65 6e 74 20 69 the attachment i
4b40: 73 20 63 6f 6e 6e 65 63 74 65 64 20 28 74 68 65 s connected (the
4b50: 20 74 61 72 67 65 74 20 61 72 74 69 66 61 63 74 target artifact
4b60: 29 2e 0a 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 )..The following
4b70: 20 63 61 72 64 73 20 61 72 65 20 61 6c 6c 6f 77 cards are allow
4b80: 65 64 20 6f 6e 20 61 6e 20 61 74 74 61 63 68 6d ed on an attachm
4b90: 65 6e 74 20 61 72 74 69 66 61 63 74 3a 0a 0a 3c ent artifact:..<
4ba0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 62 3e 41 blockquote>.<b>A
4bb0: 3c 2f 62 3e 20 3c 69 3e 66 69 6c 65 6e 61 6d 65 </b> <i>filename
4bc0: 20 74 61 72 67 65 74 3c 2f 69 3e 20 3f 3c 69 3e target</i> ?<i>
4bd0: 73 6f 75 72 63 65 3c 2f 69 3e 3f 3c 62 72 20 2f source</i>?<br /
4be0: 3e 0a 3c 62 3e 43 3c 2f 62 3e 20 3c 69 3e 63 6f >.<b>C</b> <i>co
4bf0: 6d 6d 65 6e 74 3c 2f 69 3e 3c 62 72 20 2f 3e 0a mment</i><br />.
4c00: 3c 62 3e 44 3c 2f 62 3e 20 3c 69 3e 74 69 6d 65 <b>D</b> <i>time
4c10: 2d 61 6e 64 2d 64 61 74 65 2d 73 74 61 6d 70 3c -and-date-stamp<
4c20: 2f 69 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 4e 3c 2f /i><br />.<b>N</
4c30: 62 3e 20 3c 69 3e 6d 69 6d 65 74 79 70 65 3c 2f b> <i>mimetype</
4c40: 69 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 55 3c 2f 62 i><br />.<b>U</b
4c50: 3e 20 3c 69 3e 75 73 65 72 2d 6e 61 6d 65 3c 2f > <i>user-name</
4c60: 69 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 5a 3c 2f 62 i><br />.<b>Z</b
4c70: 3e 20 3c 69 3e 63 68 65 63 6b 73 75 6d 3c 2f 69 > <i>checksum</i
4c80: 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a >.</blockquote>.
4c90: 0a 54 68 65 20 41 20 63 61 72 64 20 73 70 65 63 .The A card spec
4ca0: 69 66 69 65 73 20 61 20 66 69 6c 65 6e 61 6d 65 ifies a filename
4cb0: 20 66 6f 72 20 74 68 65 20 61 74 74 61 63 68 6d for the attachm
4cc0: 65 6e 74 20 69 6e 20 69 74 73 20 66 69 72 73 74 ent in its first
4cd0: 20 61 72 67 75 6d 65 6e 74 2e 0a 54 68 65 20 73 argument..The s
4ce0: 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 74 econd argument t
4cf0: 6f 20 74 68 65 20 41 20 63 61 72 64 20 69 73 20 o the A card is
4d00: 74 68 65 20 6e 61 6d 65 0a 6f 66 20 74 68 65 20 the name.of the
4d10: 77 69 6b 69 20 70 61 67 65 20 6f 72 20 74 69 63 wiki page or tic
4d20: 6b 65 74 20 6f 72 20 65 76 65 6e 74 20 74 6f 20 ket or event to
4d30: 77 68 69 63 68 20 74 68 65 20 61 74 74 61 63 68 which the attach
4d40: 6d 65 6e 74 20 69 73 20 63 6f 6e 6e 65 63 74 65 ment is connecte
4d50: 64 2e 20 20 54 68 65 0a 74 68 69 72 64 20 61 72 d. The.third ar
4d60: 67 75 6d 65 6e 74 20 69 73 20 65 69 74 68 65 72 gument is either
4d70: 20 6d 69 73 73 69 6e 67 20 6f 72 20 65 6c 73 65 missing or else
4d80: 20 69 74 20 69 73 20 74 68 65 20 34 30 2d 63 68 it is the 40-ch
4d90: 61 72 61 63 74 65 72 20 61 72 74 69 66 61 63 74 aracter artifact
4da0: 20 0a 49 44 20 6f 66 20 74 68 65 20 61 74 74 61 .ID of the atta
4db0: 63 68 6d 65 6e 74 20 69 74 73 65 6c 66 2e 20 20 chment itself.
4dc0: 41 20 6d 69 73 73 69 6e 67 20 74 68 69 72 64 20 A missing third
4dd0: 61 72 67 75 6d 65 6e 74 20 6d 65 61 6e 73 20 74 argument means t
4de0: 68 61 74 20 74 68 65 0a 61 74 74 61 63 68 6d 65 hat the.attachme
4df0: 6e 74 20 73 68 6f 75 6c 64 20 62 65 20 64 65 6c nt should be del
4e00: 65 74 65 64 2e 0a 0a 54 68 65 20 43 20 63 61 72 eted...The C car
4e10: 64 20 69 73 20 61 6e 20 6f 70 74 69 6f 6e 61 6c d is an optional
4e20: 20 63 6f 6d 6d 65 6e 74 20 64 65 73 63 72 69 62 comment describ
4e30: 69 6e 67 20 77 68 61 74 20 74 68 65 20 61 74 74 ing what the att
4e40: 61 63 68 6d 65 6e 74 20 69 73 20 61 62 6f 75 74 achment is about
4e50: 2e 0a 54 68 65 20 43 20 63 61 72 64 20 69 73 20 ..The C card is
4e60: 6f 70 74 69 6f 6e 61 6c 2c 20 62 75 74 20 74 68 optional, but th
4e70: 65 72 65 20 63 61 6e 20 6f 6e 6c 79 20 62 65 20 ere can only be
4e80: 6f 6e 65 2e 0a 0a 41 20 73 69 6e 67 6c 65 20 44 one...A single D
4e90: 20 63 61 72 64 20 69 73 20 72 65 71 75 69 72 65 card is require
4ea0: 64 20 74 6f 20 67 69 76 65 20 74 68 65 20 64 61 d to give the da
4eb0: 74 65 20 61 6e 64 20 74 69 6d 65 20 77 68 65 6e te and time when
4ec0: 20 74 68 65 20 61 74 74 61 63 68 6d 65 6e 74 0a the attachment.
4ed0: 77 61 73 20 61 70 70 6c 69 65 64 2e 0a 0a 54 68 was applied...Th
4ee0: 65 72 65 20 6d 61 79 20 62 65 20 7a 65 72 6f 20 ere may be zero
4ef0: 6f 72 20 6f 6e 65 20 4e 20 63 61 72 64 73 2e 20 or one N cards.
4f00: 20 54 68 65 20 4e 20 63 61 72 64 20 73 70 65 63 The N card spec
4f10: 69 66 69 65 73 20 74 68 65 20 6d 69 6d 65 74 79 ifies the mimety
4f20: 70 65 20 6f 66 20 74 68 65 0a 63 6f 6d 6d 65 6e pe of the.commen
4f30: 74 20 74 65 78 74 20 70 72 6f 76 69 64 65 64 20 t text provided
4f40: 69 6e 20 74 68 65 20 43 20 63 61 72 64 2e 20 20 in the C card.
4f50: 49 66 20 74 68 65 20 4e 20 63 61 72 64 20 69 73 If the N card is
4f60: 20 6f 6d 69 74 74 65 64 2c 20 74 68 65 20 43 20 omitted, the C
4f70: 63 61 72 64 0a 6d 69 6d 65 74 79 70 65 20 69 73 card.mimetype is
4f80: 20 74 61 6b 65 6e 20 74 6f 20 62 65 20 74 65 78 taken to be tex
4f90: 74 2f 70 6c 61 69 6e 2e 0a 0a 41 20 73 69 6e 67 t/plain...A sing
4fa0: 6c 65 20 55 20 63 61 72 64 20 67 69 76 65 73 20 le U card gives
4fb0: 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 the name of the
4fc0: 75 73 65 72 20 74 6f 20 61 64 64 65 64 20 74 68 user to added th
4fd0: 65 20 61 74 74 61 63 68 6d 65 6e 74 2e 0a 49 66 e attachment..If
4fe0: 20 61 6e 20 61 74 74 61 63 68 6d 65 6e 74 20 69 an attachment i
4ff0: 73 20 61 64 64 65 64 20 61 6e 6f 6e 79 6d 6f 75 s added anonymou
5000: 73 6c 79 2c 20 74 68 65 6e 20 74 68 65 20 55 20 sly, then the U
5010: 63 61 72 64 20 6d 61 79 20 62 65 20 6f 6d 69 74 card may be omit
5020: 74 65 64 2e 0a 0a 54 68 65 20 5a 20 63 61 72 64 ted...The Z card
5030: 20 69 73 20 74 68 65 20 75 73 75 61 6c 20 63 68 is the usual ch
5040: 65 63 6b 73 75 6d 20 6f 76 65 72 20 74 68 65 20 ecksum over the
5050: 72 65 73 74 20 6f 66 20 74 68 65 20 61 74 74 61 rest of the atta
5060: 63 68 6d 65 6e 74 20 61 72 74 69 66 61 63 74 2e chment artifact.
5070: 0a 54 68 65 20 5a 20 63 61 72 64 20 69 73 20 72 .The Z card is r
5080: 65 71 75 69 72 65 64 2e 0a 0a 0a 3c 61 20 6e 61 equired....<a na
5090: 6d 65 3d 22 65 76 65 6e 74 22 3e 3c 2f 61 3e 0a me="event"></a>.
50a0: 3c 68 32 3e 37 2e 30 20 45 76 65 6e 74 73 3c 2f <h2>7.0 Events</
50b0: 68 32 3e 0a 0a 41 6e 20 65 76 65 6e 74 20 61 72 h2>..An event ar
50c0: 74 69 66 61 63 74 20 61 73 73 6f 63 69 61 74 65 tifact associate
50d0: 73 20 61 20 74 69 6d 65 6c 69 6e 65 20 63 6f 6d s a timeline com
50e0: 6d 65 6e 74 20 61 6e 64 20 61 20 70 61 67 65 20 ment and a page
50f0: 6f 66 20 74 65 78 74 0a 28 73 69 6d 69 6c 61 72 of text.(similar
5100: 20 74 6f 20 61 20 77 69 6b 69 20 70 61 67 65 29 to a wiki page)
5110: 20 77 69 74 68 20 61 20 70 6f 69 6e 74 20 69 6e with a point in
5120: 20 74 69 6d 65 2e 20 20 45 76 65 6e 74 73 20 63 time. Events c
5130: 61 6e 20 62 65 20 75 73 65 64 0a 74 6f 20 72 65 an be used.to re
5140: 63 6f 72 64 20 70 72 6f 6a 65 63 74 20 6d 69 6c cord project mil
5150: 65 73 74 6f 6e 65 73 2c 20 72 65 6c 65 61 73 65 estones, release
5160: 20 6e 6f 74 65 73 2c 20 62 6c 6f 67 20 65 6e 74 notes, blog ent
5170: 72 69 65 73 2c 20 70 72 6f 63 65 73 73 0a 63 68 ries, process.ch
5180: 65 63 6b 70 6f 69 6e 74 73 2c 20 6f 72 20 6e 65 eckpoints, or ne
5190: 77 73 20 61 72 74 69 63 6c 65 73 2e 0a 54 68 65 ws articles..The
51a0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 61 72 64 73 following cards
51b0: 20 61 72 65 20 61 6c 6c 6f 77 65 64 20 6f 6e 20 are allowed on
51c0: 61 6e 20 65 76 65 6e 74 20 61 72 74 69 66 61 63 an event artifac
51d0: 74 3a 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e t:..<blockquote>
51e0: 0a 3c 62 3e 43 3c 2f 62 3e 20 3c 69 3e 63 6f 6d .<b>C</b> <i>com
51f0: 6d 65 6e 74 3c 2f 69 3e 3c 62 72 3e 0a 3c 62 3e ment</i><br>.<b>
5200: 44 3c 2f 62 3e 20 3c 69 3e 74 69 6d 65 2d 61 6e D</b> <i>time-an
5210: 64 2d 64 61 74 65 2d 73 74 61 6d 70 3c 2f 69 3e d-date-stamp</i>
5220: 3c 62 72 20 2f 3e 0a 3c 62 3e 45 3c 2f 62 3e 20 <br />.<b>E</b>
5230: 3c 69 3e 65 76 65 6e 74 2d 74 69 6d 65 3c 2f 69 <i>event-time</i
5240: 3e 20 3c 69 3e 65 76 65 6e 74 2d 69 64 3c 2f 69 > <i>event-id</i
5250: 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 4e 3c 2f 62 3e ><br />.<b>N</b>
5260: 20 3c 69 3e 6d 69 6d 65 74 79 70 65 3c 2f 69 3e <i>mimetype</i>
5270: 3c 62 72 20 2f 3e 0a 3c 62 3e 50 3c 2f 62 3e 20 <br />.<b>P</b>
5280: 3c 69 3e 70 61 72 65 6e 74 2d 61 72 74 69 66 61 <i>parent-artifa
5290: 63 74 2d 69 64 3c 2f 69 3e 2b 3c 62 72 20 2f 3e ct-id</i>+<br />
52a0: 0a 3c 62 3e 54 3c 2f 62 3e 20 3c 62 3e 2b 3c 2f .<b>T</b> <b>+</
52b0: 62 3e 3c 69 3e 74 61 67 2d 6e 61 6d 65 3c 2f 69 b><i>tag-name</i
52c0: 3e 20 3c 62 3e 2a 3c 2f 62 3e 20 3f 3c 69 3e 76 > <b>*</b> ?<i>v
52d0: 61 6c 75 65 3c 2f 69 3e 3f 3c 62 72 20 2f 3e 0a alue</i>?<br />.
52e0: 3c 62 3e 55 3c 2f 62 3e 20 3c 69 3e 75 73 65 72 <b>U</b> <i>user
52f0: 2d 6e 61 6d 65 3c 2f 69 3e 3c 62 72 20 2f 3e 0a -name</i><br />.
5300: 3c 62 3e 57 3c 2f 62 3e 20 3c 69 3e 73 69 7a 65 <b>W</b> <i>size
5310: 3c 2f 69 3e 20 3c 62 3e 5c 6e 3c 2f 62 3e 20 3c </i> <b>\n</b> <
5320: 69 3e 74 65 78 74 3c 2f 69 3e 20 3c 62 3e 5c 6e i>text</i> <b>\n
5330: 3c 2f 62 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 5a 3c </b><br />.<b>Z<
5340: 2f 62 3e 20 3c 69 3e 63 68 65 63 6b 73 75 6d 3c /b> <i>checksum<
5350: 2f 69 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 /i>.</blockquote
5360: 3e 0a 0a 54 68 65 20 43 20 63 61 72 64 20 63 6f >..The C card co
5370: 6e 74 61 69 6e 73 20 74 65 78 74 20 74 68 61 74 ntains text that
5380: 20 69 73 20 64 69 73 70 6c 61 79 65 64 20 6f 6e is displayed on
5390: 20 74 68 65 20 74 69 6d 65 6c 69 6e 65 20 66 6f the timeline fo
53a0: 72 20 74 68 65 0a 65 76 65 6e 74 2e 20 20 45 78 r the.event. Ex
53b0: 61 63 74 6c 79 20 6f 6e 65 20 43 20 63 61 72 64 actly one C card
53c0: 20 69 73 20 72 65 71 75 69 72 65 64 20 6f 6e 20 is required on
53d0: 61 6e 20 65 76 65 6e 74 20 61 72 74 69 66 61 63 an event artifac
53e0: 74 2e 0a 0a 41 20 73 69 6e 67 6c 65 20 44 20 63 t...A single D c
53f0: 61 72 64 20 69 73 20 72 65 71 75 69 72 65 64 20 ard is required
5400: 74 6f 20 67 69 76 65 20 74 68 65 20 64 61 74 65 to give the date
5410: 20 61 6e 64 20 74 69 6d 65 20 77 68 65 6e 20 74 and time when t
5420: 68 65 20 0a 65 76 65 6e 74 20 61 72 74 69 66 61 he .event artifa
5430: 63 74 20 77 61 73 20 63 72 65 61 74 65 64 2e 20 ct was created.
5440: 20 54 68 69 73 20 69 73 20 64 69 66 66 65 72 65 This is differe
5450: 6e 74 20 66 72 6f 6d 20 74 68 65 20 74 69 6d 65 nt from the time
5460: 20 61 74 20 77 68 69 63 68 0a 74 68 65 20 65 76 at which.the ev
5470: 65 6e 74 20 6f 63 63 75 72 73 2e 0a 0a 41 20 73 ent occurs...A s
5480: 69 6e 67 6c 65 20 45 20 63 61 72 64 20 67 69 76 ingle E card giv
5490: 65 73 20 74 68 65 20 74 69 6d 65 20 6f 66 20 74 es the time of t
54a0: 68 65 20 65 76 65 6e 74 20 28 74 68 65 20 70 6f he event (the po
54b0: 69 6e 74 20 6f 6e 20 74 68 65 20 74 69 6d 65 6c int on the timel
54c0: 69 6e 65 0a 77 68 65 72 65 20 74 68 65 20 65 76 ine.where the ev
54d0: 65 6e 74 20 69 73 20 64 69 73 70 6c 61 79 65 64 ent is displayed
54e0: 29 20 61 6e 64 20 61 20 75 6e 69 71 75 65 20 69 ) and a unique i
54f0: 64 65 6e 74 69 66 69 65 72 20 66 6f 72 20 74 68 dentifier for th
5500: 65 20 65 76 65 6e 74 2e 0a 57 68 65 6e 20 74 68 e event..When th
5510: 65 72 65 20 61 72 65 20 6d 75 6c 74 69 70 6c 65 ere are multiple
5520: 20 61 72 74 69 66 61 63 74 73 20 77 69 74 68 20 artifacts with
5530: 74 68 65 20 73 61 6d 65 20 65 76 65 6e 74 2d 69 the same event-i
5540: 64 2c 20 74 68 65 20 6f 6e 65 20 77 69 74 68 0a d, the one with.
5550: 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 the most recent
5560: 44 20 63 61 72 64 20 69 73 20 74 68 65 20 6f 6e D card is the on
5570: 6c 79 20 6f 6e 65 20 75 73 65 64 2e 20 20 54 68 ly one used. Th
5580: 65 20 65 76 65 6e 74 2d 69 64 20 6d 75 73 74 20 e event-id must
5590: 62 65 20 61 0a 34 30 2d 63 68 61 72 61 63 74 65 be a.40-characte
55a0: 72 20 6c 6f 77 65 72 2d 63 61 73 65 20 68 65 78 r lower-case hex
55b0: 61 64 65 63 69 6d 61 6c 20 73 74 72 69 6e 67 2e adecimal string.
55c0: 0a 0a 54 68 65 20 6f 70 74 69 6f 6e 61 6c 20 4e ..The optional N
55d0: 20 63 61 72 64 20 73 70 65 63 69 66 69 65 73 20 card specifies
55e0: 74 68 65 20 6d 69 6d 65 74 79 70 65 20 6f 66 20 the mimetype of
55f0: 74 68 65 20 74 65 78 74 20 6f 66 20 74 68 65 20 the text of the
5600: 65 76 65 6e 74 0a 74 68 61 74 20 69 73 20 63 6f event.that is co
5610: 6e 74 61 69 6e 65 64 20 69 6e 20 74 68 65 20 57 ntained in the W
5620: 20 63 61 72 64 2e 20 20 49 66 20 74 68 65 20 4e card. If the N
5630: 20 63 61 72 64 20 69 73 20 6f 6d 69 74 74 65 64 card is omitted
5640: 2c 20 74 68 65 6e 20 74 68 65 0a 57 20 63 61 72 , then the.W car
5650: 64 20 74 65 78 74 20 6d 69 6d 65 74 79 70 65 20 d text mimetype
5660: 69 73 20 61 73 73 75 6d 65 64 20 74 6f 20 62 65 is assumed to be
5670: 20 74 65 78 74 2f 78 2d 66 6f 73 73 69 6c 2c 20 text/x-fossil,
5680: 77 68 69 63 68 20 69 73 20 74 68 65 0a 46 6f 73 which is the.Fos
5690: 73 69 6c 20 77 69 6b 69 20 66 6f 72 6d 61 74 2e sil wiki format.
56a0: 0a 0a 54 68 65 20 6f 70 74 69 6f 6e 61 6c 20 50 ..The optional P
56b0: 20 63 61 72 64 20 73 70 65 63 69 66 69 65 73 20 card specifies
56c0: 61 20 70 72 69 6f 72 20 65 76 65 6e 74 20 77 69 a prior event wi
56d0: 74 68 20 74 68 65 20 73 61 6d 65 20 65 76 65 6e th the same even
56e0: 74 2d 69 64 20 66 72 6f 6d 0a 77 68 69 63 68 20 t-id from.which
56f0: 74 68 65 20 63 75 72 72 65 6e 74 20 65 76 65 6e the current even
5700: 74 20 69 73 20 61 6e 20 65 64 69 74 2e 20 20 54 t is an edit. T
5710: 68 65 20 50 20 63 61 72 64 20 69 73 20 61 20 68 he P card is a h
5720: 69 6e 74 20 74 6f 20 74 68 65 20 73 79 73 74 65 int to the syste
5730: 6d 0a 74 68 61 74 20 69 74 20 6d 69 67 68 74 20 m.that it might
5740: 62 65 20 73 70 61 63 65 20 65 66 66 69 63 69 65 be space efficie
5750: 6e 74 20 74 6f 20 73 74 6f 72 65 20 6f 6e 65 20 nt to store one
5760: 65 76 65 6e 74 20 61 73 20 61 20 64 65 6c 74 61 event as a delta
5770: 20 6f 66 20 74 68 65 0a 6f 74 68 65 72 2e 0a 0a of the.other...
5780: 41 6e 20 65 76 65 6e 74 20 6d 69 67 68 74 20 63 An event might c
5790: 6f 6e 74 61 69 6e 20 6f 6e 65 20 6f 72 20 6d 6f ontain one or mo
57a0: 72 65 20 54 2d 63 61 72 64 73 20 75 73 65 64 20 re T-cards used
57b0: 74 6f 20 73 65 74 0a 5b 2e 2f 62 72 61 6e 63 68 to set.[./branch
57c0: 69 6e 67 2e 77 69 6b 69 23 74 61 67 73 20 7c 20 ing.wiki#tags |
57d0: 74 61 67 73 20 6f 72 20 70 72 6f 70 65 72 74 69 tags or properti
57e0: 65 73 5d 0a 6f 6e 20 74 68 65 20 65 76 65 6e 74 es].on the event
57f0: 2e 20 20 54 68 65 20 66 6f 72 6d 61 74 20 6f 66 . The format of
5800: 20 74 68 65 20 54 2d 63 61 72 64 20 69 73 20 74 the T-card is t
5810: 68 65 20 73 61 6d 65 20 61 73 0a 64 65 73 63 72 he same as.descr
5820: 69 62 65 64 20 69 6e 20 5b 23 63 74 72 6c 20 7c ibed in [#ctrl |
5830: 20 43 6f 6e 74 72 6f 6c 20 41 72 74 69 66 61 63 Control Artifac
5840: 74 73 5d 20 73 65 63 74 69 6f 6e 20 61 62 6f 76 ts] section abov
5850: 65 2c 20 65 78 63 65 70 74 20 74 68 61 74 20 74 e, except that t
5860: 68 65 0a 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 he.second argume
5870: 6e 74 20 69 73 20 74 68 65 20 73 69 6e 67 6c 65 nt is the single
5880: 20 63 68 61 72 61 63 63 74 65 72 20 22 3c 62 3e characcter "<b>
5890: 2a 3c 2f 62 3e 22 20 69 6e 73 74 65 61 64 20 6f *</b>" instead o
58a0: 66 20 61 6e 0a 61 72 74 69 66 61 63 74 20 49 44 f an.artifact ID
58b0: 20 61 6e 64 20 74 68 65 20 6e 61 6d 65 20 69 73 and the name is
58c0: 20 61 6c 77 61 79 73 20 70 72 65 66 61 63 65 64 always prefaced
58d0: 20 62 79 20 22 3c 62 3e 2b 3c 2f 62 3e 22 2e 0a by "<b>+</b>"..
58e0: 54 68 65 20 3c 62 3e 2a 3c 2f 62 3e 20 69 6e 20 The <b>*</b> in
58f0: 70 6c 61 63 65 20 6f 66 20 74 68 65 20 61 72 74 place of the art
5900: 69 66 61 63 74 20 49 44 20 69 6e 64 69 63 61 74 ifact ID indicat
5910: 65 73 20 74 68 61 74 0a 74 68 65 20 74 61 67 20 es that.the tag
5920: 6f 72 20 70 72 6f 70 65 72 74 79 20 61 70 70 6c or property appl
5930: 69 65 73 20 74 6f 20 74 68 65 20 63 75 72 72 65 ies to the curre
5940: 6e 74 20 61 72 74 69 66 61 63 74 2e 20 20 49 74 nt artifact. It
5950: 20 69 73 20 6e 6f 74 0a 70 6f 73 73 69 62 6c 65 is not.possible
5960: 20 74 6f 20 65 6e 63 6f 64 65 20 74 68 65 20 63 to encode the c
5970: 75 72 72 65 6e 74 20 61 72 74 69 66 61 63 74 20 urrent artifact
5980: 49 44 20 61 73 20 70 61 72 74 20 6f 66 20 61 6e ID as part of an
5990: 20 61 72 74 69 66 61 63 74 2c 0a 73 69 6e 63 65 artifact,.since
59a0: 20 74 68 65 20 61 63 74 20 6f 66 20 69 6e 73 65 the act of inse
59b0: 72 74 69 6e 67 20 74 68 65 20 61 72 74 69 66 61 rting the artifa
59c0: 63 74 20 49 44 20 77 6f 75 6c 64 20 63 68 61 6e ct ID would chan
59d0: 67 65 20 74 68 65 20 61 72 74 69 66 61 63 74 20 ge the artifact
59e0: 49 44 2c 0a 68 65 6e 63 65 20 61 20 3c 62 3e 2a ID,.hence a <b>*
59f0: 3c 2f 62 3e 20 69 73 20 75 73 65 64 20 74 6f 20 </b> is used to
5a00: 72 65 70 72 65 73 65 6e 74 20 22 73 65 6c 66 22 represent "self"
5a10: 2e 20 20 54 68 65 20 22 3c 62 3e 2b 3c 2f 62 3e . The "<b>+</b>
5a20: 22 20 6f 6e 20 74 68 65 0a 6e 61 6d 65 20 6d 65 " on the.name me
5a30: 61 6e 73 20 74 68 61 74 20 74 61 67 73 20 63 61 ans that tags ca
5a40: 6e 20 6f 6e 6c 79 20 62 65 20 61 64 64 20 61 6e n only be add an
5a50: 64 20 74 68 65 79 20 63 61 6e 20 6f 6e 6c 79 20 d they can only
5a60: 62 65 20 6e 6f 6e 2d 70 72 6f 70 61 67 61 74 69 be non-propagati
5a70: 6e 67 0a 74 61 67 73 2e 20 20 41 20 61 6e 20 65 ng.tags. A an e
5a80: 76 65 6e 74 2c 20 54 20 63 61 72 64 73 20 61 72 vent, T cards ar
5a90: 65 20 6e 6f 72 6d 61 6c 6c 79 20 75 73 65 64 20 e normally used
5aa0: 74 6f 20 73 65 74 20 74 68 65 20 62 61 63 6b 67 to set the backg
5ab0: 72 6f 75 6e 64 0a 64 69 73 70 6c 61 79 20 63 6f round.display co
5ac0: 6c 6f 72 20 66 6f 72 20 74 69 6d 65 6c 69 6e 65 lor for timeline
5ad0: 73 2e 0a 0a 54 68 65 20 6f 70 74 69 6f 6e 61 6c s...The optional
5ae0: 20 55 20 63 61 72 64 20 67 69 76 65 73 20 6e 61 U card gives na
5af0: 6d 65 20 6f 66 20 74 68 65 20 75 73 65 72 20 77 me of the user w
5b00: 68 6f 20 65 6e 74 65 72 65 64 20 74 68 65 20 65 ho entered the e
5b10: 76 65 6e 74 2e 0a 0a 41 20 73 69 6e 67 6c 65 20 vent...A single
5b20: 57 20 63 61 72 64 20 70 72 6f 76 69 64 65 73 20 W card provides
5b30: 77 69 6b 69 20 74 65 78 74 20 66 6f 72 20 74 68 wiki text for th
5b40: 65 20 64 6f 63 75 6d 65 6e 74 20 61 73 73 6f 63 e document assoc
5b50: 69 61 74 65 64 20 77 69 74 68 20 74 68 65 0a 65 iated with the.e
5b60: 76 65 6e 74 2e 20 20 54 68 65 20 66 6f 72 6d 61 vent. The forma
5b70: 74 20 6f 66 20 74 68 65 20 57 20 63 61 72 64 20 t of the W card
5b80: 69 73 20 65 78 61 63 74 6c 79 20 74 68 65 20 73 is exactly the s
5b90: 61 6d 65 20 61 73 20 66 6f 72 20 61 20 0a 5b 23 ame as for a .[#
5ba0: 77 69 6b 69 63 68 6e 67 20 7c 20 77 69 6b 69 20 wikichng | wiki
5bb0: 61 72 74 69 66 61 63 74 5d 2e 0a 0a 54 68 65 20 artifact]...The
5bc0: 5a 20 63 61 72 64 20 69 73 20 74 68 65 20 72 65 Z card is the re
5bd0: 71 75 69 72 65 64 20 63 68 65 63 6b 73 75 6d 20 quired checksum
5be0: 6f 76 65 72 20 74 68 65 20 72 65 73 74 20 6f 66 over the rest of
5bf0: 20 74 68 65 20 61 72 74 69 66 61 63 74 2e 0a 0a the artifact...
5c00: 0a 3c 61 20 6e 61 6d 65 3d 22 73 75 6d 6d 61 72 .<a name="summar
5c10: 79 22 3e 3c 2f 61 3e 0a 3c 68 32 3e 38 2e 30 20 y"></a>.<h2>8.0
5c20: 43 61 72 64 20 53 75 6d 6d 61 72 79 3c 2f 68 32 Card Summary</h2
5c30: 3e 0a 0a 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 >..The following
5c40: 20 74 61 62 6c 65 20 73 75 6d 6d 61 72 69 7a 65 table summarize
5c50: 73 20 74 68 65 20 76 61 72 69 6f 75 73 20 6b 69 s the various ki
5c60: 6e 64 73 20 6f 66 20 63 61 72 64 73 20 74 68 61 nds of cards tha
5c70: 74 20 61 70 70 65 61 72 0a 6f 6e 20 46 6f 73 73 t appear.on Foss
5c80: 69 6c 20 61 72 74 69 66 61 63 74 73 2e 20 41 20 il artifacts. A
5c90: 62 6c 61 6e 6b 20 65 6e 74 72 79 20 6d 65 61 6e blank entry mean
5ca0: 73 20 74 68 61 74 20 63 6f 6d 62 69 6e 61 74 69 s that combinati
5cb0: 6f 6e 20 6f 66 20 63 61 72 64 20 61 6e 64 0a 61 on of card and.a
5cc0: 72 74 69 66 61 63 74 20 69 73 20 6e 6f 74 20 6c rtifact is not l
5cd0: 65 67 61 6c 2e 20 41 20 6e 75 6d 62 65 72 20 6f egal. A number o
5ce0: 72 20 72 61 6e 67 65 20 6f 66 20 6e 75 6d 62 65 r range of numbe
5cf0: 72 73 20 69 6e 64 69 63 61 74 65 73 20 74 68 65 rs indicates the
5d00: 20 6e 75 6d 62 65 72 0a 6f 66 20 74 69 6d 65 73 number.of times
5d10: 20 61 20 63 61 72 64 20 6d 61 79 20 28 6f 72 20 a card may (or
5d20: 6d 75 73 74 29 20 61 70 70 65 61 72 20 69 6e 20 must) appear in
5d30: 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e the correspondin
5d40: 67 20 61 72 74 69 66 61 63 74 20 74 79 70 65 2e g artifact type.
5d50: 0a 65 2e 67 2e 20 61 20 76 61 6c 75 65 20 6f 66 .e.g. a value of
5d60: 20 31 20 69 6e 64 69 63 61 74 65 73 20 61 20 72 1 indicates a r
5d70: 65 71 75 69 72 65 64 20 75 6e 69 71 75 65 20 63 equired unique c
5d80: 61 72 64 20 61 6e 64 20 31 2b 20 69 6e 64 69 63 ard and 1+ indic
5d90: 61 74 65 73 20 74 68 61 74 20 6f 6e 65 0a 6f 72 ates that one.or
5da0: 20 6d 6f 72 65 20 73 75 63 68 20 63 61 72 64 73 more such cards
5db0: 20 61 72 65 20 72 65 71 75 69 72 65 64 2e 0a 0a are required...
5dc0: 3c 74 61 62 6c 65 20 62 6f 72 64 65 72 3d 31 20 <table border=1
5dd0: 77 69 64 74 68 3d 22 31 30 30 25 22 3e 0a 3c 74 width="100%">.<t
5de0: 72 3e 0a 3c 74 68 20 72 6f 77 73 70 61 6e 3d 32 r>.<th rowspan=2
5df0: 20 76 61 6c 69 67 6e 3d 62 6f 74 74 6f 6d 3e 43 valign=bottom>C
5e00: 61 72 64 20 46 6f 72 6d 61 74 3c 2f 74 68 3e 0a ard Format</th>.
5e10: 3c 74 68 20 63 6f 6c 73 70 61 6e 3d 37 3e 55 73 <th colspan=7>Us
5e20: 65 64 20 42 79 3c 2f 74 68 3e 0a 3c 2f 74 72 3e ed By</th>.</tr>
5e30: 0a 3c 74 72 3e 0a 3c 74 68 3e 4d 61 6e 69 66 65 .<tr>.<th>Manife
5e40: 73 74 3c 2f 74 68 3e 0a 3c 74 68 3e 43 6c 75 73 st</th>.<th>Clus
5e50: 74 65 72 3c 2f 74 68 3e 0a 3c 74 68 3e 43 6f 6e ter</th>.<th>Con
5e60: 74 72 6f 6c 3c 2f 74 68 3e 0a 3c 74 68 3e 57 69 trol</th>.<th>Wi
5e70: 6b 69 3c 2f 74 68 3e 0a 3c 74 68 3e 54 69 63 6b ki</th>.<th>Tick
5e80: 65 74 3c 2f 74 68 3e 0a 3c 74 68 3e 41 74 74 61 et</th>.<th>Atta
5e90: 63 68 6d 65 6e 74 3c 2f 74 68 3e 0a 3c 74 68 3e chment</th>.<th>
5ea0: 45 76 65 6e 74 3c 2f 74 68 3e 0a 3c 2f 74 72 3e Event</th>.</tr>
5eb0: 0a 3c 74 72 3e 0a 3c 74 64 3e 3c 62 3e 41 3c 2f .<tr>.<td><b>A</
5ec0: 62 3e 20 3c 69 3e 66 69 6c 65 6e 61 6d 65 3c 2f b> <i>filename</
5ed0: 69 3e 20 3c 69 3e 74 61 72 67 65 74 3c 2f 69 3e i> <i>target</i>
5ee0: 20 3f 3c 69 3e 73 6f 75 72 63 65 3c 2f 69 3e 3f ?<i>source</i>?
5ef0: 3c 2f 74 64 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b </td>.<td>
5f00: 3c 2f 74 64 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b </td>.<td>
5f10: 3c 2f 74 64 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b </td>.<td>
5f20: 3c 2f 74 64 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b </td>.<td>
5f30: 3c 2f 74 64 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b </td>.<td>
5f40: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
5f50: 63 65 6e 74 65 72 3e 3c 62 3e 31 3c 2f 62 3e 3c center><b>1</b><
5f60: 2f 74 64 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b 3c /td>.<td> <
5f70: 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a /td>.</tr>.<tr>.
5f80: 3c 74 64 3e 3c 62 3e 42 3c 2f 62 3e 20 3c 69 3e <td><b>B</b> <i>
5f90: 62 61 73 65 6c 69 6e 65 3c 2f 69 3e 3c 2f 74 64 baseline</i></td
5fa0: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 >.<td align=cent
5fb0: 65 72 3e 3c 62 3e 30 2d 31 2a 3c 2f 62 3e 3c 2f er><b>0-1*</b></
5fc0: 74 64 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b 3c 2f td>.<td> </
5fd0: 74 64 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b 3c 2f td>.<td> </
5fe0: 74 64 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b 3c 2f td>.<td> </
5ff0: 74 64 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b 3c 2f td>.<td> </
6000: 74 64 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b 3c 2f td>.<td> </
6010: 74 64 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b 3c 2f td>.<td> </
6020: 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 3c 74 td>.</tr>.<tr><t
6030: 64 3e 26 6e 62 73 70 3b 3c 2f 74 64 3e 3c 74 64 d> </td><td
6040: 20 63 6f 6c 73 70 61 6e 3d 27 37 27 3e 2a 20 3d colspan='7'>* =
6050: 20 52 65 71 75 69 72 65 64 20 66 6f 72 20 64 65 Required for de
6060: 6c 74 61 20 6d 61 6e 69 66 65 73 74 73 3c 2f 74 lta manifests</t
6070: 64 3e 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 d></tr>.<tr>.<td
6080: 3e 3c 62 3e 43 3c 2f 62 3e 20 3c 69 3e 63 6f 6d ><b>C</b> <i>com
6090: 6d 65 6e 74 2d 74 65 78 74 3c 2f 69 3e 3c 2f 74 ment-text</i></t
60a0: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e d>.<td align=cen
60b0: 74 65 72 3e 3c 62 3e 31 3c 2f 62 3e 3c 2f 74 64 ter><b>1</b></td
60c0: 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b 3c 2f 74 64 >.<td> </td
60d0: 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b 3c 2f 74 64 >.<td> </td
60e0: 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b 3c 2f 74 64 >.<td> </td
60f0: 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b 3c 2f 74 64 >.<td> </td
6100: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 >.<td align=cent
6110: 65 72 3e 3c 62 3e 30 2d 31 3c 2f 62 3e 3c 2f 74 er><b>0-1</b></t
6120: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e d>.<td align=cen
6130: 74 65 72 3e 3c 62 3e 31 3c 2f 62 3e 3c 2f 74 64 ter><b>1</b></td
6140: 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 >.</tr>.<tr>.<td
6150: 3e 3c 62 3e 44 3c 2f 62 3e 20 3c 69 3e 64 61 74 ><b>D</b> <i>dat
6160: 65 2d 74 69 6d 65 2d 73 74 61 6d 70 3c 2f 69 3e e-time-stamp</i>
6170: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
6180: 63 65 6e 74 65 72 3e 3c 62 3e 31 3c 2f 62 3e 3c center><b>1</b><
6190: 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 /td>.<td align=c
61a0: 65 6e 74 65 72 3e 26 6e 62 73 70 3b 3c 2f 74 64 enter> </td
61b0: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 >.<td align=cent
61c0: 65 72 3e 3c 62 3e 31 3c 2f 62 3e 3c 2f 74 64 3e er><b>1</b></td>
61d0: 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 .<td align=cente
61e0: 72 3e 3c 62 3e 31 3c 2f 62 3e 3c 2f 74 64 3e 0a r><b>1</b></td>.
61f0: 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 <td align=center
6200: 3e 3c 62 3e 31 3c 2f 62 3e 3c 2f 74 64 3e 0a 3c ><b>1</b></td>.<
6210: 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e td align=center>
6220: 3c 62 3e 31 3c 2f 62 3e 3c 2f 74 64 3e 0a 3c 74 <b>1</b></td>.<t
6230: 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 3c d align=center><
6240: 62 3e 31 3c 2f 62 3e 3c 2f 74 64 3e 0a 3c 2f 74 b>1</b></td>.</t
6250: 72 3e 0a 3c 74 72 3e 0a 3c 74 64 3e 3c 62 3e 45 r>.<tr>.<td><b>E
6260: 3c 2f 62 3e 20 3c 69 3e 65 76 65 6e 74 2d 74 69 </b> <i>event-ti
6270: 6d 65 20 65 76 65 6e 74 2d 69 64 3c 2f 69 3e 3c me event-id</i><
6280: 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 /td>.<td align=c
6290: 65 6e 74 65 72 3e 26 6e 62 73 70 3b 3c 2f 74 64 enter> </td
62a0: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 >.<td align=cent
62b0: 65 72 3e 26 6e 62 73 70 3b 3c 2f 74 64 3e 0a 3c er> </td>.<
62c0: 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e td align=center>
62d0: 26 6e 62 73 70 3b 3c 2f 74 64 3e 0a 3c 74 64 20 </td>.<td
62e0: 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 26 6e 62 align=center>&nb
62f0: 73 70 3b 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 sp;</td>.<td ali
6300: 67 6e 3d 63 65 6e 74 65 72 3e 26 6e 62 73 70 3b gn=center>
6310: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
6320: 63 65 6e 74 65 72 3e 26 6e 62 73 70 3b 3c 2f 74 center> </t
6330: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e d>.<td align=cen
6340: 74 65 72 3e 3c 62 3e 31 3c 2f 62 3e 3c 2f 74 64 ter><b>1</b></td
6350: 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 >.</tr>.<tr>.<td
6360: 3e 3c 62 3e 46 3c 2f 62 3e 20 3c 69 3e 66 69 6c ><b>F</b> <i>fil
6370: 65 6e 61 6d 65 3c 2f 69 3e 20 3f 3c 69 3e 75 75 ename</i> ?<i>uu
6380: 69 64 3c 2f 69 3e 3f 20 3f 3c 69 3e 70 65 72 6d id</i>? ?<i>perm
6390: 69 73 73 69 6f 6e 73 3c 2f 69 3e 3f 20 3f 3c 69 issions</i>? ?<i
63a0: 3e 6f 6c 64 6e 61 6d 65 3c 2f 69 3e 3f 3c 2f 74 >oldname</i>?</t
63b0: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e d>.<td align=cen
63c0: 74 65 72 3e 3c 62 3e 30 2b 3c 2f 62 3e 3c 2f 74 ter><b>0+</b></t
63d0: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e d>.<td align=cen
63e0: 74 65 72 3e 26 6e 62 73 70 3b 3c 2f 74 64 3e 0a ter> </td>.
63f0: 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 <td align=center
6400: 3e 26 6e 62 73 70 3b 3c 2f 74 64 3e 0a 3c 74 64 > </td>.<td
6410: 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 26 6e align=center>&n
6420: 62 73 70 3b 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c bsp;</td>.<td al
6430: 69 67 6e 3d 63 65 6e 74 65 72 3e 26 6e 62 73 70 ign=center> 
6440: 3b 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e ;</td>.<td align
6450: 3d 63 65 6e 74 65 72 3e 26 6e 62 73 70 3b 3c 2f =center> </
6460: 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 td>.<td align=ce
6470: 6e 74 65 72 3e 26 6e 62 73 70 3b 3c 2f 74 64 3e nter> </td>
6480: 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 3e .</tr>.<tr>.<td>
6490: 3c 62 3e 4a 3c 2f 62 3e 20 3c 69 3e 6e 61 6d 65 <b>J</b> <i>name
64a0: 3c 2f 69 3e 20 3f 3c 69 3e 76 61 6c 75 65 3c 2f </i> ?<i>value</
64b0: 69 3e 3f 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 i>?</td>.<td ali
64c0: 67 6e 3d 63 65 6e 74 65 72 3e 26 6e 62 73 70 3b gn=center>
64d0: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
64e0: 63 65 6e 74 65 72 3e 26 6e 62 73 70 3b 3c 2f 74 center> </t
64f0: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e d>.<td align=cen
6500: 74 65 72 3e 26 6e 62 73 70 3b 3c 2f 74 64 3e 0a ter> </td>.
6510: 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 <td align=center
6520: 3e 26 6e 62 73 70 3b 3c 2f 74 64 3e 0a 3c 74 64 > </td>.<td
6530: 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 3c 62 align=center><b
6540: 3e 31 2b 3c 2f 62 3e 3c 2f 74 64 3e 0a 3c 74 64 >1+</b></td>.<td
6550: 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 26 6e align=center>&n
6560: 62 73 70 3b 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c bsp;</td>.<td al
6570: 69 67 6e 3d 63 65 6e 74 65 72 3e 26 6e 62 73 70 ign=center> 
6580: 3b 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 ;</td>.</tr>.<tr
6590: 3e 0a 3c 74 64 3e 3c 62 3e 4b 3c 2f 62 3e 20 3c >.<td><b>K</b> <
65a0: 69 3e 74 69 63 6b 65 74 2d 75 75 69 64 3c 2f 69 i>ticket-uuid</i
65b0: 3e 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e ></td>.<td align
65c0: 3d 63 65 6e 74 65 72 3e 26 6e 62 73 70 3b 3c 2f =center> </
65d0: 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 td>.<td align=ce
65e0: 6e 74 65 72 3e 26 6e 62 73 70 3b 3c 2f 74 64 3e nter> </td>
65f0: 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 .<td align=cente
6600: 72 3e 26 6e 62 73 70 3b 3c 2f 74 64 3e 0a 3c 74 r> </td>.<t
6610: 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 26 d align=center>&
6620: 6e 62 73 70 3b 3c 2f 74 64 3e 0a 3c 74 64 20 61 nbsp;</td>.<td a
6630: 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 3c 62 3e 31 lign=center><b>1
6640: 3c 2f 62 3e 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c </b></td>.<td al
6650: 69 67 6e 3d 63 65 6e 74 65 72 3e 26 6e 62 73 70 ign=center> 
6660: 3b 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e ;</td>.<td align
6670: 3d 63 65 6e 74 65 72 3e 26 6e 62 73 70 3b 3c 2f =center> </
6680: 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c td>.</tr>.<tr>.<
6690: 74 64 3e 3c 62 3e 4c 3c 2f 62 3e 20 3c 69 3e 77 td><b>L</b> <i>w
66a0: 69 6b 69 2d 74 69 74 6c 65 3c 2f 69 3e 3c 2f 74 iki-title</i></t
66b0: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e d>.<td align=cen
66c0: 74 65 72 3e 26 6e 62 73 70 3b 3c 2f 74 64 3e 0a ter> </td>.
66d0: 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 <td align=center
66e0: 3e 26 6e 62 73 70 3b 3c 2f 74 64 3e 0a 3c 74 64 > </td>.<td
66f0: 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 26 6e align=center>&n
6700: 62 73 70 3b 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c bsp;</td>.<td al
6710: 69 67 6e 3d 63 65 6e 74 65 72 3e 3c 62 3e 31 3c ign=center><b>1<
6720: 2f 62 3e 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 /b></td>.<td ali
6730: 67 6e 3d 63 65 6e 74 65 72 3e 26 6e 62 73 70 3b gn=center>
6740: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
6750: 63 65 6e 74 65 72 3e 26 6e 62 73 70 3b 3c 2f 74 center> </t
6760: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e d>.<td align=cen
6770: 74 65 72 3e 26 6e 62 73 70 3b 3c 2f 74 64 3e 0a ter> </td>.
6780: 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 3e 3c </tr>.<tr>.<td><
6790: 62 3e 4d 3c 2f 62 3e 20 3c 69 3e 75 75 69 64 3c b>M</b> <i>uuid<
67a0: 2f 69 3e 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 /i></td>.<td ali
67b0: 67 6e 3d 63 65 6e 74 65 72 3e 26 6e 62 73 70 3b gn=center>
67c0: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
67d0: 63 65 6e 74 65 72 3e 3c 62 3e 31 2b 3c 2f 62 3e center><b>1+</b>
67e0: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
67f0: 63 65 6e 74 65 72 3e 26 6e 62 73 70 3b 3c 2f 74 center> </t
6800: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e d>.<td align=cen
6810: 74 65 72 3e 26 6e 62 73 70 3b 3c 2f 74 64 3e 0a ter> </td>.
6820: 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 <td align=center
6830: 3e 26 6e 62 73 70 3b 3c 2f 74 64 3e 0a 3c 74 64 > </td>.<td
6840: 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 26 6e align=center>&n
6850: 62 73 70 3b 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c bsp;</td>.<td al
6860: 69 67 6e 3d 63 65 6e 74 65 72 3e 26 6e 62 73 70 ign=center> 
6870: 3b 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 ;</td>.</tr>.<tr
6880: 3e 0a 3c 74 64 3e 3c 62 3e 4e 3c 2f 62 3e 20 3c >.<td><b>N</b> <
6890: 69 3e 6d 69 6d 65 74 79 70 65 3c 2f 69 3e 3c 2f i>mimetype</i></
68a0: 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 td>.<td align=ce
68b0: 6e 74 65 72 3e 3c 62 3e 30 2d 31 3c 2f 62 3e 3c nter><b>0-1</b><
68c0: 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 /td>.<td align=c
68d0: 65 6e 74 65 72 3e 26 6e 62 73 70 3b 3c 2f 74 64 enter> </td
68e0: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 >.<td align=cent
68f0: 65 72 3e 26 6e 62 73 70 3b 3c 2f 74 64 3e 0a 3c er> </td>.<
6900: 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e td align=center>
6910: 3c 62 3e 30 2d 31 3c 2f 62 3e 3c 2f 74 64 3e 0a <b>0-1</b></td>.
6920: 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 <td align=center
6930: 3e 26 6e 62 73 70 3b 3c 2f 74 64 3e 0a 3c 74 64 > </td>.<td
6940: 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 3c 62 align=center><b
6950: 3e 30 2d 31 3c 2f 62 3e 3c 2f 74 64 3e 0a 3c 74 >0-1</b></td>.<t
6960: 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 3c d align=center><
6970: 62 3e 30 2d 31 3c 2f 62 3e 3c 2f 74 64 3e 0a 3c b>0-1</b></td>.<
6980: 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 3e 3c 62 /tr>.<tr>.<td><b
6990: 3e 50 3c 2f 62 3e 20 3c 69 3e 75 75 69 64 20 2e >P</b> <i>uuid .
69a0: 2e 2e 3c 2f 69 3e 3c 2f 74 64 3e 0a 3c 74 64 20 ..</i></td>.<td
69b0: 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 3c 62 3e align=center><b>
69c0: 30 2d 31 3c 2f 62 3e 3c 2f 74 64 3e 0a 3c 74 64 0-1</b></td>.<td
69d0: 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 26 6e align=center>&n
69e0: 62 73 70 3b 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c bsp;</td>.<td al
69f0: 69 67 6e 3d 63 65 6e 74 65 72 3e 26 6e 62 73 70 ign=center> 
6a00: 3b 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e ;</td>.<td align
6a10: 3d 63 65 6e 74 65 72 3e 3c 62 3e 30 2d 31 3c 2f =center><b>0-1</
6a20: 62 3e 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 b></td>.<td alig
6a30: 6e 3d 63 65 6e 74 65 72 3e 26 6e 62 73 70 3b 3c n=center> <
6a40: 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 /td>.<td align=c
6a50: 65 6e 74 65 72 3e 26 6e 62 73 70 3b 3c 2f 74 64 enter> </td
6a60: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 >.<td align=cent
6a70: 65 72 3e 3c 62 3e 30 2d 31 3c 2f 62 3e 3c 2f 74 er><b>0-1</b></t
6a80: 64 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 d>.</tr>.<tr>.<t
6a90: 64 3e 3c 62 3e 51 3c 2f 62 3e 20 28 3c 62 3e 2b d><b>Q</b> (<b>+
6aa0: 3c 2f 62 3e 7c 3c 62 3e 2d 3c 2f 62 3e 29 3c 69 </b>|<b>-</b>)<i
6ab0: 3e 75 75 69 64 3c 2f 69 3e 20 3f 3c 69 3e 75 75 >uuid</i> ?<i>uu
6ac0: 69 64 3c 2f 69 3e 3f 3c 2f 74 64 3e 0a 3c 74 64 id</i>?</td>.<td
6ad0: 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 3c 62 align=center><b
6ae0: 3e 30 2b 3c 2f 62 3e 3c 2f 74 64 3e 0a 3c 74 64 >0+</b></td>.<td
6af0: 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 26 6e align=center>&n
6b00: 62 73 70 3b 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c bsp;</td>.<td al
6b10: 69 67 6e 3d 63 65 6e 74 65 72 3e 26 6e 62 73 70 ign=center> 
6b20: 3b 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e ;</td>.<td align
6b30: 3d 63 65 6e 74 65 72 3e 26 6e 62 73 70 3b 3c 2f =center> </
6b40: 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 td>.<td align=ce
6b50: 6e 74 65 72 3e 26 6e 62 73 70 3b 3c 2f 74 64 3e nter> </td>
6b60: 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 .<td align=cente
6b70: 72 3e 26 6e 62 73 70 3b 3c 2f 74 64 3e 0a 3c 74 r> </td>.<t
6b80: 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 26 d align=center>&
6b90: 6e 62 73 70 3b 3c 2f 74 64 3e 0a 3c 2f 74 72 3e nbsp;</td>.</tr>
6ba0: 0a 3c 74 72 3e 0a 3c 74 64 3e 3c 62 3e 52 3c 2f .<tr>.<td><b>R</
6bb0: 62 3e 20 3c 69 3e 6d 64 35 73 75 6d 3c 2f 69 3e b> <i>md5sum</i>
6bc0: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
6bd0: 63 65 6e 74 65 72 3e 3c 62 3e 30 2d 31 2a 3c 2f center><b>0-1*</
6be0: 62 3e 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 b></td>.<td alig
6bf0: 6e 3d 63 65 6e 74 65 72 3e 26 6e 62 73 70 3b 3c n=center> <
6c00: 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 /td>.<td align=c
6c10: 65 6e 74 65 72 3e 26 6e 62 73 70 3b 3c 2f 74 64 enter> </td
6c20: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 >.<td align=cent
6c30: 65 72 3e 26 6e 62 73 70 3b 3c 2f 74 64 3e 0a 3c er> </td>.<
6c40: 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e td align=center>
6c50: 26 6e 62 73 70 3b 3c 2f 74 64 3e 0a 3c 74 64 20 </td>.<td
6c60: 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 26 6e 62 align=center>&nb
6c70: 73 70 3b 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 sp;</td>.<td ali
6c80: 67 6e 3d 63 65 6e 74 65 72 3e 26 6e 62 73 70 3b gn=center>
6c90: 3c 2f 74 64 3e 0a 3c 74 72 3e 3c 74 64 3e 26 6e </td>.<tr><td>&n
6ca0: 62 73 70 3b 3c 2f 74 64 3e 3c 74 64 20 63 6f 6c bsp;</td><td col
6cb0: 73 70 61 6e 3d 27 37 27 3e 2a 20 3d 20 52 65 71 span='7'>* = Req
6cc0: 75 69 72 65 64 20 77 68 65 6e 20 75 73 69 6e 67 uired when using
6cd0: 20 46 20 63 61 72 64 73 3c 2f 74 64 3e 3c 2f 74 F cards</td></t
6ce0: 72 3e 0a 3c 74 72 3e 0a 3c 74 64 3e 3c 62 3e 54 r>.<tr>.<td><b>T
6cf0: 3c 2f 62 3e 20 28 3c 62 3e 2b 3c 2f 62 3e 7c 3c </b> (<b>+</b>|<
6d00: 62 3e 2a 3c 2f 62 3e 7c 3c 62 3e 2d 3c 2f 62 3e b>*</b>|<b>-</b>
6d10: 29 3c 69 3e 74 61 67 6e 61 6d 65 3c 2f 69 3e 20 )<i>tagname</i>
6d20: 3c 69 3e 75 75 69 64 3c 2f 69 3e 20 3f 3c 69 3e <i>uuid</i> ?<i>
6d30: 76 61 6c 75 65 3c 2f 69 3e 3f 3c 2f 74 64 3e 0a value</i>?</td>.
6d40: 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 <td align=center
6d50: 3e 3c 62 3e 30 2b 3c 2f 62 3e 3c 2f 74 64 3e 0a ><b>0+</b></td>.
6d60: 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 <td align=center
6d70: 3e 26 6e 62 73 70 3b 3c 2f 74 64 3e 0a 3c 74 64 > </td>.<td
6d80: 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 3c 62 align=center><b
6d90: 3e 31 2b 3c 2f 62 3e 3c 2f 74 64 3e 0a 3c 74 64 >1+</b></td>.<td
6da0: 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 26 6e align=center>&n
6db0: 62 73 70 3b 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c bsp;</td>.<td al
6dc0: 69 67 6e 3d 63 65 6e 74 65 72 3e 26 6e 62 73 70 ign=center> 
6dd0: 3b 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e ;</td>.<td align
6de0: 3d 63 65 6e 74 65 72 3e 26 6e 62 73 70 3b 3c 2f =center> </
6df0: 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 td>.<td align=ce
6e00: 6e 74 65 72 3e 3c 62 3e 30 2b 3c 2f 62 3e 3c 2f nter><b>0+</b></
6e10: 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c td>.</tr>.<tr>.<
6e20: 74 64 3e 3c 62 3e 55 3c 2f 62 3e 20 3c 69 3e 75 td><b>U</b> <i>u
6e30: 73 65 72 6e 61 6d 65 3c 2f 69 3e 3c 2f 74 64 3e sername</i></td>
6e40: 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 .<td align=cente
6e50: 72 3e 3c 62 3e 31 3c 2f 62 3e 3c 2f 74 64 3e 0a r><b>1</b></td>.
6e60: 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 <td align=center
6e70: 3e 26 6e 62 73 70 3b 3c 2f 74 64 3e 0a 3c 74 64 > </td>.<td
6e80: 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 3c 62 align=center><b
6e90: 3e 31 3c 2f 62 3e 3c 2f 74 64 3e 0a 3c 74 64 20 >1</b></td>.<td
6ea0: 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 3c 62 3e align=center><b>
6eb0: 31 3c 2f 62 3e 3c 2f 74 64 3e 0a 3c 74 64 20 61 1</b></td>.<td a
6ec0: 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 3c 62 3e 31 lign=center><b>1
6ed0: 3c 2f 62 3e 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c </b></td>.<td al
6ee0: 69 67 6e 3d 63 65 6e 74 65 72 3e 3c 62 3e 30 2d ign=center><b>0-
6ef0: 31 3c 2f 62 3e 3c 2f 74 64 3e 0a 3c 74 64 20 61 1</b></td>.<td a
6f00: 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 3c 62 3e 30 lign=center><b>0
6f10: 2d 31 3c 2f 62 3e 3c 2f 74 64 3e 0a 3c 2f 74 72 -1</b></td>.</tr
6f20: 3e 0a 3c 74 72 3e 0a 3c 74 64 3e 3c 62 3e 57 3c >.<tr>.<td><b>W<
6f30: 2f 62 3e 20 3c 69 3e 73 69 7a 65 3c 2f 69 3e 3c /b> <i>size</i><
6f40: 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 /td>.<td align=c
6f50: 65 6e 74 65 72 3e 26 6e 62 73 70 3b 3c 2f 74 64 enter> </td
6f60: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 >.<td align=cent
6f70: 65 72 3e 26 6e 62 73 70 3b 3c 2f 74 64 3e 0a 3c er> </td>.<
6f80: 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e td align=center>
6f90: 26 6e 62 73 70 3b 3c 2f 74 64 3e 0a 3c 74 64 20 </td>.<td
6fa0: 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 3c 62 3e align=center><b>
6fb0: 31 3c 2f 62 3e 3c 2f 74 64 3e 0a 3c 74 64 20 61 1</b></td>.<td a
6fc0: 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 26 6e 62 73 lign=center>&nbs
6fd0: 70 3b 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 p;</td>.<td alig
6fe0: 6e 3d 63 65 6e 74 65 72 3e 26 6e 62 73 70 3b 3c n=center> <
6ff0: 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 63 /td>.<td align=c
7000: 65 6e 74 65 72 3e 3c 62 3e 31 3c 2f 62 3e 3c 2f enter><b>1</b></
7010: 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c td>.</tr>.<tr>.<
7020: 74 64 3e 3c 62 3e 5a 3c 2f 62 3e 20 3c 69 3e 6d td><b>Z</b> <i>m
7030: 64 35 73 75 6d 3c 2f 69 3e 3c 2f 74 64 3e 0a 3c d5sum</i></td>.<
7040: 74 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e td align=center>
7050: 3c 62 3e 31 3c 2f 62 3e 3c 2f 74 64 3e 0a 3c 74 <b>1</b></td>.<t
7060: 64 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 3c d align=center><
7070: 62 3e 31 3c 2f 62 3e 3c 2f 74 64 3e 0a 3c 74 64 b>1</b></td>.<td
7080: 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 3c 62 align=center><b
7090: 3e 31 3c 2f 62 3e 3c 2f 74 64 3e 0a 3c 74 64 20 >1</b></td>.<td
70a0: 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 3c 62 3e align=center><b>
70b0: 31 3c 2f 62 3e 3c 2f 74 64 3e 0a 3c 74 64 20 61 1</b></td>.<td a
70c0: 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 3c 62 3e 31 lign=center><b>1
70d0: 3c 2f 62 3e 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c </b></td>.<td al
70e0: 69 67 6e 3d 63 65 6e 74 65 72 3e 3c 62 3e 31 3c ign=center><b>1<
70f0: 2f 62 3e 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 /b></td>.<td ali
7100: 67 6e 3d 63 65 6e 74 65 72 3e 3c 62 3e 31 3c 2f gn=center><b>1</
7110: 62 3e 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 2f b></td>.</tr>.</
7120: 74 61 62 6c 65 3e 0a 0a 0a 3c 61 20 6e 61 6d 65 table>...<a name
7130: 3d 22 61 64 64 65 6e 64 61 22 3e 3c 2f 61 3e 0a ="addenda"></a>.
7140: 3c 68 32 3e 39 2e 30 20 41 64 64 65 6e 64 61 3c <h2>9.0 Addenda<
7150: 2f 68 32 3e 0a 0a 54 68 69 73 20 73 65 63 74 69 /h2>..This secti
7160: 6f 6e 20 63 6f 6e 74 61 69 6e 73 20 61 64 64 69 on contains addi
7170: 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 tional informati
7180: 6f 6e 20 77 68 69 63 68 20 6d 61 79 20 62 65 20 on which may be
7190: 75 73 65 66 75 6c 20 77 68 65 6e 0a 69 6d 70 6c useful when.impl
71a0: 65 6d 65 6e 74 69 6e 67 20 61 6c 67 6f 72 69 74 ementing algorit
71b0: 68 6d 73 20 64 65 73 63 72 69 62 65 64 20 61 62 hms described ab
71c0: 6f 76 65 2e 0a 0a 3c 68 33 3e 52 20 43 61 72 64 ove...<h3>R Card
71d0: 20 48 61 73 68 20 43 61 6c 63 75 6c 61 74 69 6f Hash Calculatio
71e0: 6e 3c 2f 68 33 3e 0a 0a 47 69 76 65 6e 20 61 20 n</h3>..Given a
71f0: 6d 61 6e 69 66 65 73 74 20 66 69 6c 65 20 6e 61 manifest file na
7200: 6d 65 64 20 3c 74 74 3e 4d 46 3c 2f 74 74 3e 2c med <tt>MF</tt>,
7210: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 42 the following B
7220: 61 73 68 20 73 68 65 6c 6c 20 63 6f 64 65 0a 64 ash shell code.d
7230: 65 6d 6f 6e 73 74 72 61 74 65 73 20 68 6f 77 20 emonstrates how
7240: 74 6f 20 63 6f 6d 70 75 74 65 20 74 68 65 20 76 to compute the v
7250: 61 6c 75 65 20 6f 66 20 74 68 65 20 52 20 63 61 alue of the R ca
7260: 72 64 20 69 6e 20 74 68 61 74 20 6d 61 6e 69 66 rd in that manif
7270: 65 73 74 2e 0a 54 68 69 73 20 65 78 61 6d 70 6c est..This exampl
7280: 65 20 75 73 65 73 20 6d 61 6e 69 66 65 73 74 20 e uses manifest
7290: 5b 32 38 39 38 37 30 39 36 61 63 5d 2e 20 4c 69 [28987096ac]. Li
72a0: 6e 65 73 20 73 74 61 72 74 69 6e 67 20 77 69 74 nes starting wit
72b0: 68 20 3c 74 74 3e 23 3c 2f 74 74 3e 20 61 72 65 h <tt>#</tt> are
72c0: 0a 73 68 65 6c 6c 20 69 6e 70 75 74 20 61 6e 64 .shell input and
72d0: 20 6f 74 68 65 72 20 6c 69 6e 65 73 20 61 72 65 other lines are
72e0: 20 6f 75 74 70 75 74 2e 20 54 68 69 73 20 64 65 output. This de
72f0: 6d 6f 6e 73 74 72 61 74 69 6f 6e 20 61 73 73 75 monstration assu
7300: 6d 65 73 20 74 68 61 74 20 74 68 65 0a 66 69 6c mes that the.fil
7310: 65 20 76 65 72 73 69 6f 6e 73 20 72 65 70 72 65 e versions repre
7320: 73 65 6e 74 65 64 20 62 79 20 74 68 65 20 69 6e sented by the in
7330: 70 75 74 20 6d 61 6e 69 66 65 73 74 20 61 72 65 put manifest are
7340: 20 63 68 65 63 6b 65 64 20 6f 75 74 0a 75 6e 64 checked out.und
7350: 65 72 20 74 68 65 20 63 75 72 72 65 6e 74 20 64 er the current d
7360: 69 72 65 63 74 6f 72 79 2e 0a 0a 3c 6e 6f 77 69 irectory...<nowi
7370: 6b 69 3e 3c 70 72 65 3e 0a 23 20 68 65 61 64 20 ki><pre>.# head
7380: 4d 46 0a 2d 2d 2d 2d 2d 42 45 47 49 4e 20 50 47 MF.-----BEGIN PG
7390: 50 20 53 49 47 4e 45 44 20 4d 45 53 53 41 47 45 P SIGNED MESSAGE
73a0: 2d 2d 2d 2d 2d 0a 48 61 73 68 3a 20 53 48 41 31 -----.Hash: SHA1
73b0: 0a 0a 43 20 4d 61 6b 65 5c 73 74 68 65 5c 73 22 ..C Make\sthe\s"
73c0: 63 6c 65 61 72 73 69 67 6e 22 5c 73 50 47 50 5c clearsign"\sPGP\
73d0: 73 73 69 67 6e 69 6e 67 5c 73 64 65 66 61 75 6c ssigning\sdefaul
73e0: 74 5c 73 74 6f 5c 73 6f 66 66 2e 0a 44 20 32 30 t\sto\soff..D 20
73f0: 31 30 2d 30 32 2d 32 33 54 31 35 3a 33 33 3a 31 10-02-23T15:33:1
7400: 34 0a 46 20 42 55 49 4c 44 2e 74 78 74 20 34 66 4.F BUILD.txt 4f
7410: 37 39 38 38 37 36 37 65 34 65 34 38 62 32 39 66 7988767e4e48b29f
7420: 37 65 64 64 64 30 65 32 63 64 65 61 34 35 35 35 7eddd0e2cdea4555
7430: 62 39 31 36 31 63 0a 46 20 43 4f 50 59 52 49 47 b9161c.F COPYRIG
7440: 48 54 2d 47 50 4c 32 2e 74 78 74 20 30 36 38 37 HT-GPL2.txt 0687
7450: 37 36 32 34 65 61 35 63 37 37 65 66 65 33 62 37 7624ea5c77efe3b7
7460: 65 33 39 62 30 66 39 30 39 65 64 61 36 65 32 35 e39b0f909eda6e25
7470: 61 34 65 63 0a 2e 2e 2e 0a 0a 23 20 67 72 65 70 a4ec......# grep
7480: 20 27 5e 52 20 27 20 4d 46 0a 52 20 63 30 37 38 '^R ' MF.R c078
7490: 38 39 38 32 37 38 31 39 38 31 63 39 36 61 30 64 8982781981c96a0d
74a0: 38 31 34 36 35 66 65 63 37 31 39 32 0a 0a 23 20 81465fec7192..#
74b0: 66 6f 72 20 69 20 69 6e 20 24 28 61 77 6b 20 27 for i in $(awk '
74c0: 2f 5e 46 20 2f 7b 70 72 69 6e 74 20 24 32 7d 27 /^F /{print $2}'
74d0: 20 4d 46 29 3b 20 64 6f 20 5c 0a 20 20 65 63 68 MF); do \. ech
74e0: 6f 20 24 69 20 24 28 73 74 61 74 20 2d 63 20 27 o $i $(stat -c '
74f0: 25 73 27 20 24 69 29 3b 20 5c 0a 20 20 63 61 74 %s' $i); \. cat
7500: 20 24 69 3b 20 5c 0a 64 6f 6e 65 20 7c 20 6d 64 $i; \.done | md
7510: 35 73 75 6d 0a 63 30 37 38 38 39 38 32 37 38 31 5sum.c0788982781
7520: 39 38 31 63 39 36 61 30 64 38 31 34 36 35 66 65 981c96a0d81465fe
7530: 63 37 31 39 32 20 20 2d 0a 3c 2f 70 72 65 3e 3c c7192 -.</pre><
7540: 2f 6e 6f 77 69 6b 69 3e 0a 0a 4d 69 6e 6f 72 20 /nowiki>..Minor
7550: 63 61 76 65 61 74 73 3a 20 74 68 65 20 61 62 6f caveats: the abo
7560: 76 65 20 64 65 6d 6f 6e 73 74 72 61 74 69 6f 6e ve demonstration
7570: 20 77 69 6c 6c 20 77 6f 72 6b 20 6f 6e 6c 79 20 will work only
7580: 77 68 65 6e 20 6e 6f 6e 65 20 6f 66 20 74 68 65 when none of the
7590: 0a 66 69 6c 65 6e 61 6d 65 73 20 69 6e 20 74 68 .filenames in th
75a0: 65 20 6d 61 6e 69 66 65 73 74 20 61 72 65 20 22 e manifest are "
75b0: 66 6f 73 73 69 6c 69 7a 65 64 22 20 28 65 6e 63 fossilized" (enc
75c0: 6f 64 65 64 29 20 62 65 63 61 75 73 65 20 74 68 oded) because th
75d0: 65 79 20 63 6f 6e 74 61 69 6e 0a 73 70 61 63 65 ey contain.space
75e0: 73 2e 20 49 6e 20 74 68 61 74 20 63 61 73 65 20 s. In that case
75f0: 74 68 65 20 73 68 65 6c 6c 2d 67 65 6e 65 72 61 the shell-genera
7600: 74 65 64 20 68 61 73 68 20 77 6f 75 6c 64 20 64 ted hash would d
7610: 69 66 66 65 72 20 62 65 63 61 75 73 65 20 74 68 iffer because th
7620: 65 0a 3c 74 74 3e 73 74 61 74 3c 2f 74 74 3e 20 e.<tt>stat</tt>
7630: 63 61 6c 6c 73 20 77 69 6c 6c 20 66 61 69 6c 20 calls will fail
7640: 74 6f 20 66 69 6e 64 20 73 75 63 68 20 66 69 6c to find such fil
7650: 65 73 20 28 77 68 69 63 68 20 61 72 65 20 6f 75 es (which are ou
7660: 74 70 75 74 20 69 6e 20 65 6e 63 6f 64 65 64 0a tput in encoded.
7670: 66 6f 72 6d 20 68 65 72 65 29 2e 20 54 68 61 74 form here). That
7680: 20 61 70 70 72 6f 61 63 68 20 61 6c 73 6f 20 77 approach also w
7690: 6f 6e 27 74 20 77 6f 72 6b 20 66 6f 72 20 64 65 on't work for de
76a0: 6c 74 61 20 6d 61 6e 69 66 65 73 74 73 2e 20 43 lta manifests. C
76b0: 61 6c 63 75 6c 61 74 69 6e 67 0a 74 68 65 20 52 alculating.the R
76c0: 2d 63 61 72 64 20 66 6f 72 20 64 65 6c 74 61 20 -card for delta
76d0: 6d 61 6e 69 66 65 73 74 73 20 72 65 71 75 69 72 manifests requir
76e0: 65 73 20 74 72 61 76 65 72 73 69 6e 67 20 62 6f es traversing bo
76f0: 74 68 20 74 68 65 20 64 65 6c 74 61 20 61 6e 64 th the delta and
7700: 20 69 74 73 20 62 61 73 65 6c 69 6e 65 20 69 6e its baseline in
7710: 0a 6c 65 78 69 63 61 6c 20 6f 72 64 65 72 20 6f .lexical order o
7720: 66 20 74 68 65 20 66 69 6c 65 73 2c 20 70 72 65 f the files, pre
7730: 66 65 72 69 6e 67 20 74 68 65 20 64 65 6c 74 61 fering the delta
7740: 27 73 20 63 6f 70 79 20 69 66 20 62 6f 74 68 20 's copy if both
7750: 63 6f 6e 74 61 69 6e 0a 61 20 67 69 76 65 6e 20 contain.a given
7760: 66 69 6c 65 2e 0a file..