Fossil

Hex Artifact Content
Login

Artifact 9974dfbc5c0ca5074910467a9b5034796470b77e:


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>&nbsp;
5f00: 3c 2f 74 64 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b  </td>.<td>&nbsp;
5f10: 3c 2f 74 64 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b  </td>.<td>&nbsp;
5f20: 3c 2f 74 64 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b  </td>.<td>&nbsp;
5f30: 3c 2f 74 64 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b  </td>.<td>&nbsp;
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>&nbsp;<
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>&nbsp;</
5fd0: 74 64 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b 3c 2f  td>.<td>&nbsp;</
5fe0: 74 64 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b 3c 2f  td>.<td>&nbsp;</
5ff0: 74 64 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b 3c 2f  td>.<td>&nbsp;</
6000: 74 64 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b 3c 2f  td>.<td>&nbsp;</
6010: 74 64 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b 3c 2f  td>.<td>&nbsp;</
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>&nbsp;</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>&nbsp;</td
60d0: 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b 3c 2f 74 64  >.<td>&nbsp;</td
60e0: 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b 3c 2f 74 64  >.<td>&nbsp;</td
60f0: 3e 0a 3c 74 64 3e 26 6e 62 73 70 3b 3c 2f 74 64  >.<td>&nbsp;</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>&nbsp;</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>&nbsp;</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>&nbsp;</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  &nbsp;</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>&nbsp;
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>&nbsp;</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>&nbsp;</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  >&nbsp;</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>&nbsp
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>&nbsp;</
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>&nbsp;</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>&nbsp;
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>&nbsp;</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>&nbsp;</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  >&nbsp;</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>&nbsp
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>&nbsp;</
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>&nbsp;</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>&nbsp;</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>&nbsp
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>&nbsp;</
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>&nbsp;</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  >&nbsp;</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>&nbsp;
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>&nbsp;</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>&nbsp;</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>&nbsp;
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>&nbsp;</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>&nbsp;</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  >&nbsp;</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>&nbsp
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>&nbsp;</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>&nbsp;</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  >&nbsp;</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>&nbsp
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>&nbsp;<
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>&nbsp;</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>&nbsp
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>&nbsp;</
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>&nbsp;</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>&nbsp;</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>&nbsp;<
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>&nbsp;</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>&nbsp;</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  &nbsp;</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>&nbsp;
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  >&nbsp;</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>&nbsp
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>&nbsp;</
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  >&nbsp;</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>&nbsp;</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>&nbsp;</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  &nbsp;</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>&nbsp;<
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..