Artifact fff56efd8bb12d07e65153ad30ed820dbce8b1bd:
File www/fileformat.wiki part of check-in [c8893c69ac] - Documentation updates. by drh on 2008-10-05 01:03:25.
0000: 3c 68 31 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65 <h1 align="cente 0010: 72 22 3e 0a 46 6f 73 73 69 6c 20 46 69 6c 65 20 r">.Fossil File 0020: 46 6f 72 6d 61 74 73 0a 3c 2f 68 31 3e 0a 0a 3c Formats.</h1>..< 0030: 70 3e 54 68 65 20 73 74 61 74 65 20 6f 66 20 61 p>The state of a 0040: 20 66 6f 73 73 69 6c 20 72 65 70 6f 73 69 74 6f fossil reposito 0050: 72 79 20 69 73 20 6b 65 70 74 20 73 69 6d 70 6c ry is kept simpl 0060: 65 20 73 6f 20 74 68 61 74 20 69 74 20 63 61 6e e so that it can 0070: 0a 65 6e 64 75 72 65 20 69 6e 20 75 73 65 66 75 .endure in usefu 0080: 6c 20 66 6f 72 6d 20 66 6f 72 20 64 65 63 61 64 l form for decad 0090: 65 73 20 6f 72 20 63 65 6e 74 75 72 69 65 73 2e es or centuries. 00a0: 20 0a 41 20 66 6f 73 73 69 6c 20 72 65 70 6f 73 .A fossil repos 00b0: 69 74 6f 72 79 20 69 73 20 69 6e 74 65 6e 64 65 itory is intende 00c0: 64 20 74 6f 20 62 65 20 72 65 61 64 61 62 6c 65 d to be readable 00d0: 2c 0a 73 65 61 72 63 68 61 62 6c 65 2c 20 61 6e ,.searchable, an 00e0: 64 20 65 78 74 65 6e 73 69 62 6c 65 20 62 79 20 d extensible by 00f0: 70 65 6f 70 6c 65 20 6e 6f 74 20 79 65 74 20 62 people not yet b 0100: 6f 72 6e 2e 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54 68 orn.</p>..<p>.Th 0110: 65 20 67 6c 6f 62 61 6c 20 73 74 61 74 65 20 6f e global state o 0120: 66 20 61 20 66 6f 73 73 69 6c 20 72 65 70 6f 73 f a fossil repos 0130: 69 74 6f 72 79 20 69 73 20 64 65 74 65 72 6d 69 itory is determi 0140: 6e 65 64 20 62 79 20 61 6e 20 75 6e 6f 72 64 65 ned by an unorde 0150: 72 65 64 0a 73 65 74 20 6f 66 20 3c 69 3e 61 72 red.set of <i>ar 0160: 74 69 66 61 63 74 73 3c 2f 69 3e 2e 0a 41 6e 20 tifacts</i>..An 0170: 61 72 74 69 66 61 63 74 20 6d 69 67 68 74 20 62 artifact might b 0180: 65 20 61 20 73 6f 75 72 63 65 20 63 6f 64 65 20 e a source code 0190: 66 69 6c 65 2c 20 74 68 65 20 74 65 78 74 20 6f file, the text o 01a0: 66 20 61 20 77 69 6b 69 20 70 61 67 65 2c 0a 70 f a wiki page,.p 01b0: 61 72 74 20 6f 66 20 61 20 74 72 6f 75 62 6c 65 art of a trouble 01c0: 20 74 69 63 6b 65 74 2c 20 6f 72 20 6f 6e 65 20 ticket, or one 01d0: 6f 66 20 73 65 76 65 72 61 6c 20 73 70 65 63 69 of several speci 01e0: 61 6c 20 63 6f 6e 74 72 6f 6c 20 61 72 74 69 66 al control artif 01f0: 61 63 74 73 0a 75 73 65 64 20 74 6f 20 73 68 6f acts.used to sho 0200: 77 20 74 68 65 20 72 65 6c 61 74 69 6f 6e 73 68 w the relationsh 0210: 69 70 73 20 62 65 74 77 65 65 6e 20 6f 74 68 65 ips between othe 0220: 72 20 61 72 74 69 66 61 63 74 73 20 77 69 74 68 r artifacts with 0230: 69 6e 20 74 68 65 0a 70 72 6f 6a 65 63 74 2e 20 in the.project. 0240: 20 45 61 63 68 20 61 72 74 69 66 61 63 74 20 69 Each artifact i 0250: 73 20 6e 6f 72 6d 61 6c 6c 79 20 72 65 70 72 65 s normally repre 0260: 73 65 6e 74 65 64 20 6f 6e 20 64 69 73 6b 20 61 sented on disk a 0270: 73 20 61 20 73 65 70 61 72 61 74 65 0a 66 69 6c s a separate.fil 0280: 65 2e 20 20 41 72 74 69 66 61 63 74 73 20 63 61 e. Artifacts ca 0290: 6e 20 62 65 20 74 65 78 74 20 6f 72 20 62 69 6e n be text or bin 02a0: 61 72 79 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 45 ary..</p>..<p>.E 02b0: 61 63 68 20 61 72 74 69 66 61 63 74 20 69 6e 20 ach artifact in 02c0: 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 20 69 the repository i 02d0: 73 20 6e 61 6d 65 64 20 62 79 20 69 74 73 20 53 s named by its S 02e0: 48 41 31 20 68 61 73 68 2e 0a 4e 6f 20 70 72 65 HA1 hash..No pre 02f0: 66 69 78 65 73 20 6f 72 20 6d 65 74 61 20 69 6e fixes or meta in 0300: 66 6f 72 6d 61 74 69 6f 6e 20 69 73 20 61 64 64 formation is add 0310: 65 64 20 74 6f 20 61 20 61 72 74 69 66 61 63 74 ed to a artifact 0320: 20 62 65 66 6f 72 65 0a 69 74 73 20 68 61 73 68 before.its hash 0330: 20 69 73 20 63 6f 6d 70 75 74 65 64 2e 20 20 54 is computed. T 0340: 68 65 20 6e 61 6d 65 20 6f 66 20 61 20 61 72 74 he name of a art 0350: 69 66 61 63 74 20 69 6e 20 74 68 65 20 72 65 70 ifact in the rep 0360: 6f 73 69 74 6f 72 79 0a 69 73 20 65 78 61 63 74 ository.is exact 0370: 6c 79 20 74 68 65 20 73 61 6d 65 20 53 48 41 31 ly the same SHA1 0380: 20 68 61 73 68 20 74 68 61 74 20 69 73 20 63 6f hash that is co 0390: 6d 70 75 74 65 64 20 62 79 20 73 68 61 31 73 75 mputed by sha1su 03a0: 6d 20 0a 6f 6e 20 74 68 65 20 66 69 6c 65 20 61 m .on the file a 03b0: 73 20 69 74 20 65 78 69 73 74 73 20 69 6e 20 79 s it exists in y 03c0: 6f 75 72 20 73 6f 75 72 63 65 20 74 72 65 65 2e our source tree. 03d0: 3c 2f 70 3e 0a 0a 3c 70 3e 0a 53 6f 6d 65 20 61 </p>..<p>.Some a 03e0: 72 74 69 66 61 63 74 73 20 68 61 76 65 20 61 20 rtifacts have a 03f0: 70 61 72 74 69 63 75 6c 61 72 20 66 6f 72 6d 61 particular forma 0400: 74 20 77 68 69 63 68 20 67 69 76 65 73 20 74 68 t which gives th 0410: 65 6d 20 73 70 65 63 69 61 6c 0a 6d 65 61 6e 69 em special.meani 0420: 6e 67 20 74 6f 20 66 6f 73 73 69 6c 2e 20 20 46 ng to fossil. F 0430: 6f 73 73 69 6c 20 72 65 63 6f 67 6e 69 7a 65 73 ossil recognizes 0440: 3a 3c 2f 70 3e 0a 0a 3c 75 6c 3e 0a 3c 6c 69 3e :</p>..<ul>.<li> 0450: 20 4d 61 6e 69 66 65 73 74 73 20 3c 2f 6c 69 3e Manifests </li> 0460: 0a 3c 6c 69 3e 20 43 6c 75 73 74 65 72 73 20 3c .<li> Clusters < 0470: 2f 6c 69 3e 0a 3c 6c 69 3e 20 43 6f 6e 74 72 6f /li>.<li> Contro 0480: 6c 20 41 72 74 69 66 61 63 74 73 20 3c 2f 6c 69 l Artifacts </li 0490: 3e 0a 3c 6c 69 3e 20 57 69 6b 69 20 50 61 67 65 >.<li> Wiki Page 04a0: 73 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 54 69 63 s </li>.<li> Tic 04b0: 6b 65 74 20 43 68 61 6e 67 65 73 20 3c 2f 6c 69 ket Changes </li 04c0: 3e 0a 3c 2f 75 6c 3e 0a 0a 3c 70 3e 54 68 65 73 >.</ul>..<p>Thes 04d0: 65 20 66 69 76 65 20 61 72 74 69 66 61 63 74 20 e five artifact 04e0: 74 79 70 65 73 20 61 72 65 20 64 65 73 63 72 69 types are descri 04f0: 62 65 64 20 69 6e 20 74 68 65 20 73 65 71 75 65 bed in the seque 0500: 6c 2e 3c 2f 70 3e 0a 0a 3c 70 3e 49 6e 20 74 68 l.</p>..<p>In th 0510: 65 20 63 75 72 72 65 6e 74 20 69 6d 70 6c 65 6d e current implem 0520: 65 6e 74 61 74 69 6f 6e 20 28 61 73 20 6f 66 20 entation (as of 0530: 32 30 30 38 2d 31 30 2d 30 34 29 20 74 68 65 20 2008-10-04) the 0540: 61 72 74 69 66 61 63 74 73 20 74 68 61 74 0a 6d artifacts that.m 0550: 61 6b 65 20 75 70 20 61 20 66 6f 73 73 69 6c 20 ake up a fossil 0560: 72 65 70 6f 73 69 74 6f 72 79 20 61 72 65 20 73 repository are s 0570: 74 6f 72 65 64 20 69 6e 20 69 6e 20 61 73 20 64 tored in in as d 0580: 65 6c 74 61 2d 20 61 6e 64 20 7a 6c 69 62 2d 63 elta- and zlib-c 0590: 6f 6d 70 72 65 73 73 65 64 0a 62 6c 6f 62 73 20 ompressed.blobs 05a0: 69 6e 20 61 6e 20 3c 61 20 68 72 65 66 3d 22 68 in an <a href="h 05b0: 74 74 70 3a 2f 2f 77 77 77 2e 73 71 6c 69 74 65 ttp://www.sqlite 05c0: 2e 6f 72 67 2f 22 3e 53 51 4c 69 74 65 3c 2f 61 .org/">SQLite</a 05d0: 3e 20 64 61 74 61 62 61 73 65 2e 20 20 54 68 69 > database. Thi 05e0: 73 0a 69 73 20 61 6e 20 69 6d 70 6c 65 6d 65 6e s.is an implemen 05f0: 74 61 74 69 6f 6e 20 64 65 74 61 69 6c 20 61 6e tation detail an 0600: 64 20 6d 69 67 68 74 20 63 68 61 6e 67 65 20 69 d might change i 0610: 6e 20 61 20 66 75 74 75 72 65 20 72 65 6c 65 61 n a future relea 0620: 73 65 2e 20 20 46 6f 72 0a 74 68 65 20 70 75 72 se. For.the pur 0630: 70 6f 73 65 20 6f 66 20 74 68 69 73 20 61 72 74 pose of this art 0640: 69 63 6c 65 20 22 66 69 6c 65 20 66 6f 72 6d 61 icle "file forma 0650: 74 22 20 6d 65 61 6e 73 20 74 68 65 20 66 6f 72 t" means the for 0660: 6d 61 74 20 6f 66 20 74 68 65 20 61 72 74 69 66 mat of the artif 0670: 61 63 74 73 2c 0a 6e 6f 74 20 68 6f 77 20 74 68 acts,.not how th 0680: 65 20 61 72 74 69 66 61 63 74 73 20 61 72 65 20 e artifacts are 0690: 73 74 6f 72 65 64 20 6f 6e 20 64 69 73 6b 2e 20 stored on disk. 06a0: 20 49 74 20 69 73 20 74 68 65 20 61 72 74 69 66 It is the artif 06b0: 61 63 74 20 66 6f 72 6d 61 74 20 74 68 61 74 0a act format that. 06c0: 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 is intended to b 06d0: 65 20 65 6e 64 75 72 69 6e 67 2e 20 20 54 68 65 e enduring. The 06e0: 20 73 70 65 63 69 66 69 63 73 20 6f 66 20 68 6f specifics of ho 06f0: 77 20 61 72 74 69 66 61 63 74 73 20 61 72 65 20 w artifacts are 0700: 73 74 6f 72 65 64 20 6f 6e 0a 64 69 73 6b 2c 20 stored on.disk, 0710: 74 68 6f 75 67 68 20 73 74 61 62 6c 65 2c 20 69 though stable, i 0720: 73 20 6e 6f 74 20 69 6e 74 65 6e 64 65 64 20 74 s not intended t 0730: 6f 20 68 61 76 65 20 61 73 20 6c 6f 6e 67 20 61 o have as long a 0740: 20 6c 69 66 65 73 70 61 6e 20 61 73 20 74 68 65 lifespan as the 0750: 0a 61 72 74 69 66 61 63 74 20 66 6f 72 6d 61 74 .artifact format 0760: 2e 3c 2f 70 3e 0a 0a 3c 68 32 3e 31 2e 30 20 54 .</p>..<h2>1.0 T 0770: 68 65 20 4d 61 6e 69 66 65 73 74 3c 2f 68 32 3e he Manifest</h2> 0780: 0a 0a 3c 70 3e 41 20 6d 61 6e 69 66 65 73 74 20 ..<p>A manifest 0790: 64 65 66 69 6e 65 73 20 61 20 62 61 73 65 6c 69 defines a baseli 07a0: 6e 65 20 6f 72 20 76 65 72 73 69 6f 6e 20 6f 66 ne or version of 07b0: 20 74 68 65 20 70 72 6f 6a 65 63 74 0a 73 6f 75 the project.sou 07c0: 72 63 65 20 74 72 65 65 2e 20 20 54 68 65 20 6d rce tree. The m 07d0: 61 6e 69 66 65 73 74 20 63 6f 6e 74 61 69 6e 73 anifest contains 07e0: 20 61 20 6c 69 73 74 20 6f 66 20 61 72 74 69 66 a list of artif 07f0: 61 63 74 73 20 66 6f 72 0a 65 61 63 68 20 66 69 acts for.each fi 0800: 6c 65 20 69 6e 20 74 68 65 20 70 72 6f 6a 65 63 le in the projec 0810: 74 20 61 6e 64 20 74 68 65 20 63 6f 72 72 65 73 t and the corres 0820: 70 6f 6e 64 69 6e 67 20 66 69 6c 65 6e 61 6d 65 ponding filename 0830: 73 2c 20 61 73 0a 77 65 6c 6c 20 61 73 20 69 6e s, as.well as in 0840: 66 6f 72 6d 61 74 69 6f 6e 20 73 75 63 68 20 61 formation such a 0850: 73 20 70 61 72 65 6e 74 20 62 61 73 65 6c 69 6e s parent baselin 0860: 65 73 2c 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 es, the name of 0870: 74 68 65 0a 70 72 6f 67 72 61 6d 6d 65 72 20 77 the.programmer w 0880: 68 6f 20 63 72 65 61 74 65 64 20 74 68 65 20 62 ho created the b 0890: 61 73 65 6c 69 6e 65 2c 20 74 68 65 20 64 61 74 aseline, the dat 08a0: 65 20 61 6e 64 20 74 69 6d 65 20 77 68 65 6e 0a e and time when. 08b0: 74 68 65 20 62 61 73 65 6c 69 6e 65 20 77 61 73 the baseline was 08c0: 20 63 72 65 61 74 65 64 2c 20 61 6e 64 20 61 6e created, and an 08d0: 79 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d 6d 65 y check-in comme 08e0: 6e 74 73 20 61 73 73 6f 63 69 61 74 65 64 0a 77 nts associated.w 08f0: 69 74 68 20 74 68 65 20 62 61 73 65 6c 69 6e 65 ith the baseline 0900: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 0a 41 6e 79 20 61 .</p>..<p>.Any a 0910: 72 74 69 66 61 63 74 20 69 6e 20 74 68 65 20 72 rtifact in the r 0920: 65 70 6f 73 69 74 6f 72 79 20 74 68 61 74 20 66 epository that f 0930: 6f 6c 6c 6f 77 73 20 74 68 65 20 73 79 6e 74 61 ollows the synta 0940: 63 74 69 63 20 72 75 6c 65 73 0a 6f 66 20 61 20 ctic rules.of a 0950: 6d 61 6e 69 66 65 73 74 20 69 73 20 61 20 6d 61 manifest is a ma 0960: 6e 69 66 65 73 74 2e 20 20 4e 6f 74 65 20 74 68 nifest. Note th 0970: 61 74 20 61 20 6d 61 6e 69 66 65 73 74 20 63 61 at a manifest ca 0980: 6e 0a 62 65 20 62 6f 74 68 20 61 20 72 65 61 6c n.be both a real 0990: 20 6d 61 6e 69 66 65 73 74 20 61 6e 64 20 61 6c manifest and al 09a0: 73 6f 20 61 20 63 6f 6e 74 65 6e 74 20 66 69 6c so a content fil 09b0: 65 2c 20 74 68 6f 75 67 68 20 74 68 69 73 0a 69 e, though this.i 09c0: 73 20 72 61 72 65 2e 0a 3c 2f 70 3e 0a 0a 3c 70 s rare..</p>..<p 09d0: 3e 0a 41 20 6d 61 6e 69 66 65 73 74 20 69 73 20 >.A manifest is 09e0: 61 20 74 65 78 74 20 66 69 6c 65 2e 20 20 4e 65 a text file. Ne 09f0: 77 6c 69 6e 65 20 63 68 61 72 61 63 74 65 72 73 wline characters 0a00: 0a 28 41 53 43 49 49 20 30 78 30 61 29 20 73 65 .(ASCII 0x0a) se 0a10: 70 61 72 61 74 65 20 74 68 65 20 66 69 6c 65 20 parate the file 0a20: 69 6e 74 6f 20 22 63 61 72 64 73 22 2e 0a 45 61 into "cards"..Ea 0a30: 63 68 20 63 61 72 64 20 62 65 67 69 6e 73 20 77 ch card begins w 0a40: 69 74 68 20 61 20 73 69 6e 67 6c 65 0a 63 68 61 ith a single.cha 0a50: 72 61 63 74 65 72 20 22 63 61 72 64 20 74 79 70 racter "card typ 0a60: 65 22 2e 20 20 5a 65 72 6f 20 6f 72 20 6d 6f 72 e". Zero or mor 0a70: 65 20 61 72 67 75 6d 65 6e 74 73 20 6d 61 79 20 e arguments may 0a80: 66 6f 6c 6c 6f 77 0a 74 68 65 20 63 61 72 64 20 follow.the card 0a90: 74 79 70 65 2e 20 20 41 6c 6c 20 61 72 67 75 6d type. All argum 0aa0: 65 6e 74 73 20 61 72 65 20 73 65 70 61 72 61 74 ents are separat 0ab0: 65 64 20 66 72 6f 6d 20 65 61 63 68 20 6f 74 68 ed from each oth 0ac0: 65 72 0a 61 6e 64 20 66 72 6f 6d 20 74 68 65 20 er.and from the 0ad0: 63 61 72 64 2d 74 79 70 65 20 63 68 61 72 61 63 card-type charac 0ae0: 74 65 72 20 62 79 20 61 20 73 69 6e 67 6c 65 20 ter by a single 0af0: 73 70 61 63 65 0a 63 68 61 72 61 63 74 65 72 2e space.character. 0b00: 20 20 54 68 65 72 65 20 69 73 20 6e 6f 20 73 75 There is no su 0b10: 72 70 6c 75 73 20 77 68 69 74 65 20 73 70 61 63 rplus white spac 0b20: 65 20 62 65 74 77 65 65 6e 20 61 72 67 75 6d 65 e between argume 0b30: 6e 74 73 0a 61 6e 64 20 6e 6f 20 6c 65 61 64 69 nts.and no leadi 0b40: 6e 67 20 6f 72 20 74 72 61 69 6c 69 6e 67 20 77 ng or trailing w 0b50: 68 69 74 65 73 70 61 63 65 20 65 78 63 65 70 74 hitespace except 0b60: 20 66 6f 72 20 74 68 65 20 6e 65 77 6c 69 6e 65 for the newline 0b70: 20 0a 63 68 61 72 61 63 74 65 72 20 74 68 61 74 .character that 0b80: 20 61 63 74 73 20 61 73 20 74 68 65 20 63 61 72 acts as the car 0b90: 64 20 73 65 70 61 72 61 74 6f 72 2e 0a 3c 2f 70 d separator..</p 0ba0: 3e 0a 0a 3c 70 3e 0a 41 6c 6c 20 63 61 72 64 73 >..<p>.All cards 0bb0: 20 6f 66 20 74 68 65 20 6d 61 6e 69 66 65 73 74 of the manifest 0bc0: 20 6f 63 63 75 72 20 69 6e 20 73 74 72 69 63 74 occur in strict 0bd0: 20 73 6f 72 74 65 64 20 6c 65 78 69 63 6f 67 72 sorted lexicogr 0be0: 61 70 68 69 63 61 6c 20 6f 72 64 65 72 2e 0a 4e aphical order..N 0bf0: 6f 20 63 61 72 64 20 6d 61 79 20 62 65 20 64 75 o card may be du 0c00: 70 6c 69 63 61 74 65 64 2e 0a 54 68 65 20 65 6e plicated..The en 0c10: 74 69 72 65 20 6d 61 6e 69 66 65 73 74 20 6d 61 tire manifest ma 0c20: 79 20 62 65 20 50 47 50 20 63 6c 65 61 72 2d 73 y be PGP clear-s 0c30: 69 67 6e 65 64 2c 20 62 75 74 20 6f 74 68 65 72 igned, but other 0c40: 77 69 73 65 20 69 74 0a 6d 61 79 20 63 6f 6e 74 wise it.may cont 0c50: 61 69 6e 20 6e 6f 20 61 64 64 69 74 69 6f 6e 61 ain no additiona 0c60: 6c 20 74 65 78 74 20 6f 72 20 64 61 74 61 20 62 l text or data b 0c70: 65 79 6f 6e 64 20 77 68 61 74 20 69 73 20 64 65 eyond what is de 0c80: 73 63 72 69 62 65 64 20 68 65 72 65 2e 0a 3c 2f scribed here..</ 0c90: 70 3e 0a 0a 3c 70 3e 0a 41 6c 6c 6f 77 65 64 20 p>..<p>.Allowed 0ca0: 63 61 72 64 73 20 69 6e 20 74 68 65 20 6d 61 6e cards in the man 0cb0: 69 66 65 73 74 20 61 72 65 20 61 73 20 66 6f 6c ifest are as fol 0cc0: 6c 6f 77 73 3a 0a 3c 2f 70 3e 0a 0a 3c 62 6c 6f lows:.</p>..<blo 0cd0: 63 6b 71 75 6f 74 65 3e 0a 3c 62 3e 43 3c 2f 62 ckquote>.<b>C</b 0ce0: 3e 20 3c 69 3e 63 68 65 63 6b 69 6e 2d 63 6f 6d > <i>checkin-com 0cf0: 6d 65 6e 74 3c 2f 69 3e 3c 62 72 3e 0a 3c 62 3e ment</i><br>.<b> 0d00: 44 3c 2f 62 3e 20 3c 69 3e 74 69 6d 65 2d 61 6e D</b> <i>time-an 0d10: 64 2d 64 61 74 65 2d 73 74 61 6d 70 3c 2f 69 3e d-date-stamp</i> 0d20: 3c 62 72 3e 0a 3c 62 3e 46 3c 2f 62 3e 20 3c 69 <br>.<b>F</b> <i 0d30: 3e 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 20 3c 69 >filename</i> <i 0d40: 3e 53 48 41 31 2d 68 61 73 68 3c 2f 69 3e 3c 62 >SHA1-hash</i><b 0d50: 72 3e 0a 3c 62 3e 50 3c 2f 62 3e 20 3c 69 3e 53 r>.<b>P</b> <i>S 0d60: 48 41 31 2d 68 61 73 68 3c 2f 69 3e 2b 3c 62 72 HA1-hash</i>+<br 0d70: 3e 0a 3c 62 3e 52 3c 2f 62 3e 20 3c 69 3e 72 65 >.<b>R</b> <i>re 0d80: 70 6f 73 69 74 6f 72 79 2d 63 68 65 63 6b 73 75 pository-checksu 0d90: 6d 3c 2f 69 3e 3c 62 72 3e 0a 3c 62 3e 55 3c 2f m</i><br>.<b>U</ 0da0: 62 3e 20 3c 69 3e 75 73 65 72 2d 6c 6f 67 69 6e b> <i>user-login 0db0: 3c 2f 69 3e 3c 62 72 3e 0a 3c 62 3e 5a 3c 2f 62 </i><br>.<b>Z</b 0dc0: 3e 20 3c 69 3e 6d 61 6e 69 66 65 73 74 2d 63 68 > <i>manifest-ch 0dd0: 65 63 6b 73 75 6d 3c 2f 69 3e 0a 3c 2f 62 6c 6f ecksum</i>.</blo 0de0: 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 0a 41 20 ckquote>..<p>.A 0df0: 6d 61 6e 69 66 65 73 74 20 6d 75 73 74 20 68 61 manifest must ha 0e00: 76 65 20 65 78 61 63 74 6c 79 20 6f 6e 65 20 43 ve exactly one C 0e10: 2d 63 61 72 64 2e 20 20 54 68 65 20 73 6f 6c 65 -card. The sole 0e20: 20 61 72 67 75 6d 65 6e 74 20 74 6f 0a 74 68 65 argument to.the 0e30: 20 43 2d 63 61 72 64 20 69 73 20 61 20 63 68 65 C-card is a che 0e40: 63 6b 2d 69 6e 20 63 6f 6d 6d 65 6e 74 20 74 68 ck-in comment th 0e50: 61 74 20 64 65 73 63 72 69 62 65 73 20 74 68 65 at describes the 0e60: 20 63 68 65 63 6b 2d 69 6e 20 74 68 61 74 0a 74 check-in that.t 0e70: 68 65 20 6d 61 6e 69 66 65 73 74 20 64 65 66 69 he manifest defi 0e80: 6e 65 73 2e 20 20 54 68 65 20 63 68 65 63 6b 2d nes. The check- 0e90: 69 6e 20 63 6f 6d 6d 65 6e 74 20 69 73 20 74 65 in comment is te 0ea0: 78 74 2e 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 xt. The followi 0eb0: 6e 67 0a 65 73 63 61 70 65 20 73 65 71 75 65 6e ng.escape sequen 0ec0: 63 65 73 20 61 72 65 20 61 70 70 6c 69 65 64 20 ces are applied 0ed0: 74 6f 20 74 68 65 20 74 65 78 74 3a 0a 41 20 73 to the text:.A s 0ee0: 70 61 63 65 20 28 41 53 43 49 49 20 30 78 32 30 pace (ASCII 0x20 0ef0: 29 20 69 73 20 72 65 70 72 65 73 65 6e 74 65 64 ) is represented 0f00: 20 61 73 20 22 5c 73 22 20 28 41 53 43 49 49 20 as "\s" (ASCII 0f10: 30 78 35 43 2c 20 30 78 37 33 29 2e 20 20 41 0a 0x5C, 0x73). A. 0f20: 6e 65 77 6c 69 6e 65 20 28 41 53 43 49 49 20 30 newline (ASCII 0 0f30: 78 30 61 29 20 69 73 20 22 5c 6e 22 20 28 41 53 x0a) is "\n" (AS 0f40: 43 49 49 20 30 78 36 43 2c 20 78 36 45 29 2e 20 CII 0x6C, x6E). 0f50: 20 41 20 62 61 63 6b 73 6c 61 73 68 20 0a 28 41 A backslash .(A 0f60: 53 43 49 49 20 30 78 35 43 29 20 69 73 20 72 65 SCII 0x5C) is re 0f70: 70 72 65 73 65 6e 74 65 64 20 61 73 20 74 77 6f presented as two 0f80: 20 62 61 63 6b 73 6c 61 73 68 65 73 20 22 5c 5c backslashes "\\ 0f90: 22 2e 20 20 41 70 61 72 74 20 66 72 6f 6d 0a 73 ". Apart from.s 0fa0: 70 61 63 65 20 61 6e 64 20 6e 65 77 6c 69 6e 65 pace and newline 0fb0: 2c 20 6e 6f 20 6f 74 68 65 72 20 77 68 69 74 65 , no other white 0fc0: 73 70 61 63 65 20 63 68 61 72 61 63 74 65 72 73 space characters 0fd0: 20 61 72 65 20 61 6c 6c 6f 77 65 64 20 69 6e 0a are allowed in. 0fe0: 74 68 65 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d the check-in com 0ff0: 6d 65 6e 74 2e 20 20 4e 6f 72 20 61 72 65 20 61 ment. Nor are a 1000: 6e 79 20 75 6e 70 72 69 6e 74 61 62 6c 65 20 63 ny unprintable c 1010: 68 61 72 61 63 74 65 72 73 20 61 6c 6c 6f 77 65 haracters allowe 1020: 64 0a 69 6e 20 74 68 65 20 63 6f 6d 6d 65 6e 74 d.in the comment 1030: 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 41 20 6d 61 ..</p>..<p>.A ma 1040: 6e 69 66 65 73 74 20 6d 75 73 74 20 68 61 76 65 nifest must have 1050: 20 65 78 61 63 74 6c 79 20 6f 6e 65 20 44 2d 63 exactly one D-c 1060: 61 72 64 2e 20 20 54 68 65 20 73 6f 6c 65 20 61 ard. The sole a 1070: 72 67 75 6d 65 6e 74 20 74 6f 0a 74 68 65 20 44 rgument to.the D 1080: 2d 63 61 72 64 20 69 73 20 61 20 64 61 74 65 2d -card is a date- 1090: 74 69 6d 65 20 73 74 61 6d 70 20 69 6e 20 74 68 time stamp in th 10a0: 65 20 49 53 4f 38 36 30 31 20 66 6f 72 6d 61 74 e ISO8601 format 10b0: 2e 20 20 54 68 65 0a 64 61 74 65 20 61 6e 64 20 . The.date and 10c0: 74 69 6d 65 20 73 68 6f 75 6c 64 20 62 65 20 69 time should be i 10d0: 6e 20 63 6f 6f 72 64 69 6e 61 74 65 64 20 75 6e n coordinated un 10e0: 69 76 65 72 73 61 6c 20 74 69 6d 65 20 28 55 54 iversal time (UT 10f0: 43 29 2e 0a 54 68 65 20 66 6f 72 6d 61 74 20 69 C)..The format i 1100: 73 3a 0a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 s:.</p>..<blockq 1110: 75 6f 74 65 3e 0a 3c 69 3e 59 59 59 59 3c 2f 69 uote>.<i>YYYY</i 1120: 3e 3c 62 3e 2d 3c 2f 62 3e 3c 69 3e 4d 4d 3c 2f ><b>-</b><i>MM</ 1130: 69 3e 3c 62 3e 2d 3c 2f 62 3e 3c 69 3e 44 44 3c i><b>-</b><i>DD< 1140: 2f 69 3e 3c 62 3e 54 3c 2f 62 3e 3c 69 3e 48 48 /i><b>T</b><i>HH 1150: 3c 2f 69 3e 3c 62 3e 3a 3c 2f 62 3e 3c 69 3e 4d </i><b>:</b><i>M 1160: 4d 3c 2f 69 3e 3c 62 3e 3a 3c 2f 62 3e 3c 69 3e M</i><b>:</b><i> 1170: 53 53 3c 2f 69 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 SS</i>.</blockqu 1180: 6f 74 65 3e 0a 0a 3c 70 3e 0a 41 20 6d 61 6e 69 ote>..<p>.A mani 1190: 66 65 73 74 20 68 61 73 20 7a 65 72 6f 20 6f 72 fest has zero or 11a0: 20 6d 6f 72 65 20 46 2d 63 61 72 64 73 2e 20 20 more F-cards. 11b0: 45 61 63 68 20 46 2d 63 61 72 64 20 64 65 66 69 Each F-card defi 11c0: 6e 65 73 20 61 20 66 69 6c 65 0a 28 6f 74 68 65 nes a file.(othe 11d0: 72 20 74 68 61 6e 20 74 68 65 20 6d 61 6e 69 66 r than the manif 11e0: 65 73 74 20 69 74 73 65 6c 66 29 20 77 68 69 63 est itself) whic 11f0: 68 20 69 73 20 70 61 72 74 20 6f 66 20 74 68 65 h is part of the 1200: 20 62 61 73 65 6c 69 6e 65 20 74 68 61 74 0a 74 baseline that.t 1210: 68 65 20 6d 61 6e 69 66 65 73 74 20 64 65 66 69 he manifest defi 1220: 6e 65 73 2e 20 20 54 68 65 72 65 20 61 72 65 20 nes. There are 1230: 74 77 6f 20 61 72 67 75 6d 65 6e 74 73 2e 20 20 two arguments. 1240: 54 68 65 20 66 69 72 73 74 20 61 72 67 6d 65 6e The first argmen 1250: 74 0a 69 73 20 74 68 65 20 70 61 74 68 6e 61 6d t.is the pathnam 1260: 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 69 6e e of the file in 1270: 20 74 68 65 20 62 61 73 65 6c 69 6e 65 20 72 65 the baseline re 1280: 6c 61 74 69 76 65 20 74 6f 20 74 68 65 20 72 6f lative to the ro 1290: 6f 74 0a 6f 66 20 74 68 65 20 70 72 6f 6a 65 63 ot.of the projec 12a0: 74 20 66 69 6c 65 20 68 69 65 72 61 72 63 68 79 t file hierarchy 12b0: 2e 20 20 4e 6f 20 22 2e 2e 22 20 6f 72 20 22 2e . No ".." or ". 12c0: 22 20 64 69 72 65 63 74 6f 72 69 65 73 20 61 72 " directories ar 12d0: 65 20 61 6c 6c 6f 77 65 64 0a 77 69 74 68 69 6e e allowed.within 12e0: 20 74 68 65 20 66 69 6c 65 6e 61 6d 65 2e 20 20 the filename. 12f0: 53 70 61 63 65 20 63 68 61 72 61 63 74 65 72 73 Space characters 1300: 20 61 72 65 20 65 73 63 61 70 65 64 20 61 73 20 are escaped as 1310: 69 6e 20 43 2d 63 61 72 64 0a 63 6f 6d 6d 65 6e in C-card.commen 1320: 74 20 74 65 78 74 2e 20 20 42 61 63 6b 73 6c 61 t text. Backsla 1330: 73 68 20 63 68 61 72 61 63 74 65 72 73 20 61 6e sh characters an 1340: 64 20 6e 65 77 6c 69 6e 65 73 20 61 72 65 20 6e d newlines are n 1350: 6f 74 20 61 6c 6c 6f 77 65 64 0a 77 69 74 68 69 ot allowed.withi 1360: 6e 20 66 69 6c 65 6e 61 6d 65 73 2e 20 20 54 68 n filenames. Th 1370: 65 20 64 69 72 65 63 74 6f 72 79 20 73 65 70 61 e directory sepa 1380: 72 61 74 6f 72 20 63 68 61 72 61 63 74 65 72 20 rator character 1390: 69 73 20 61 20 66 6f 72 77 61 72 64 0a 73 6c 61 is a forward.sla 13a0: 73 68 20 28 41 53 43 49 49 20 30 78 32 46 29 2e sh (ASCII 0x2F). 13b0: 20 20 54 68 65 20 73 65 63 6f 6e 64 20 61 72 67 The second arg 13c0: 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 46 2d 63 ument to the F-c 13d0: 61 72 64 20 69 73 20 74 68 65 0a 66 75 6c 6c 20 ard is the.full 13e0: 34 30 2d 63 68 61 72 61 63 74 65 72 20 6c 6f 77 40-character low 13f0: 65 72 2d 63 61 73 65 20 68 65 78 61 64 65 63 69 er-case hexadeci 1400: 6d 61 6c 20 53 48 41 31 20 68 61 73 68 20 6f 66 mal SHA1 hash of 1410: 20 74 68 65 20 63 6f 6e 74 65 6e 74 0a 61 72 74 the content.art 1420: 69 66 61 63 74 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e ifact..</p>..<p> 1430: 0a 41 20 6d 61 6e 69 66 65 73 74 20 68 61 73 20 .A manifest has 1440: 7a 65 72 6f 20 6f 72 20 6f 6e 65 20 50 2d 63 61 zero or one P-ca 1450: 72 64 73 2e 20 20 4d 6f 73 74 20 6d 61 6e 69 66 rds. Most manif 1460: 65 73 74 73 20 68 61 76 65 20 6f 6e 65 20 50 2d ests have one P- 1470: 63 61 72 64 2e 0a 54 68 65 20 50 2d 63 61 72 64 card..The P-card 1480: 20 68 61 73 20 61 20 76 61 72 79 69 6e 67 20 6e has a varying n 1490: 75 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e umber of argumen 14a0: 74 73 20 74 68 61 74 0a 64 65 66 69 6e 65 73 20 ts that.defines 14b0: 6f 74 68 65 72 20 6d 61 6e 69 66 65 73 74 73 20 other manifests 14c0: 66 72 6f 6d 20 77 68 69 63 68 20 74 68 65 20 63 from which the c 14d0: 75 72 72 65 6e 74 20 6d 61 6e 69 66 65 73 74 0a urrent manifest. 14e0: 69 73 20 64 65 72 69 76 65 64 2e 20 20 45 61 63 is derived. Eac 14f0: 68 20 61 72 67 75 6d 65 6e 74 20 69 73 20 61 6e h argument is an 1500: 20 34 30 2d 63 68 61 72 61 63 74 65 72 20 6c 6f 40-character lo 1510: 77 65 72 63 61 73 65 20 0a 68 65 78 61 64 65 63 wercase .hexadec 1520: 69 6d 61 6c 20 53 48 41 31 20 6f 66 20 74 68 65 imal SHA1 of the 1530: 20 70 72 65 64 65 63 65 73 73 6f 72 20 6d 61 6e predecessor man 1540: 69 66 65 73 74 2e 20 20 41 6c 6c 20 61 72 67 75 ifest. All argu 1550: 6d 65 6e 74 73 0a 74 6f 20 74 68 65 20 50 2d 63 ments.to the P-c 1560: 61 72 64 20 6d 75 73 74 20 62 65 20 75 6e 69 71 ard must be uniq 1570: 75 65 20 74 6f 20 74 68 61 74 20 6c 69 6e 65 2e ue to that line. 1580: 0a 54 68 65 20 66 69 72 73 74 20 70 72 65 64 65 .The first prede 1590: 63 65 73 73 6f 72 20 69 73 20 74 68 65 20 64 69 cessor is the di 15a0: 72 65 63 74 20 61 6e 63 65 73 74 6f 72 20 6f 66 rect ancestor of 15b0: 20 74 68 65 20 6d 61 6e 69 66 65 73 74 2e 0a 4f the manifest..O 15c0: 74 68 65 72 20 61 72 67 75 6d 65 6e 74 73 20 64 ther arguments d 15d0: 65 66 69 6e 65 20 6d 61 6e 69 66 65 73 74 73 20 efine manifests 15e0: 77 69 74 68 20 77 68 69 63 68 20 74 68 65 20 66 with which the f 15f0: 69 72 73 74 20 77 61 73 0a 6d 65 72 67 65 64 20 irst was.merged 1600: 74 6f 20 79 69 65 6c 64 20 74 68 65 20 63 75 72 to yield the cur 1610: 72 65 6e 74 20 6d 61 6e 69 66 65 73 74 2e 20 20 rent manifest. 1620: 4d 6f 73 74 20 6d 61 6e 69 66 65 73 74 73 20 68 Most manifests h 1630: 61 76 65 0a 61 20 50 2d 63 61 72 64 20 77 69 74 ave.a P-card wit 1640: 68 20 61 20 73 69 6e 67 6c 65 20 61 72 67 75 6d h a single argum 1650: 65 6e 74 2e 20 20 54 68 65 20 66 69 72 73 74 20 ent. The first 1660: 6d 61 6e 69 66 65 73 74 20 69 6e 20 74 68 65 0a manifest in the. 1670: 70 72 6f 6a 65 63 74 20 68 61 73 20 6e 6f 20 61 project has no a 1680: 6e 63 65 73 74 6f 72 73 20 61 6e 64 20 74 68 75 ncestors and thu 1690: 73 20 68 61 73 20 6e 6f 20 50 2d 63 61 72 64 2e s has no P-card. 16a0: 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 41 20 6d 61 6e .</p>..<p>.A man 16b0: 69 66 65 73 74 20 6d 61 79 20 6f 70 74 69 6f 6e ifest may option 16c0: 61 6c 6c 79 20 68 61 76 65 20 61 20 73 69 6e 67 ally have a sing 16d0: 6c 65 20 52 2d 63 61 72 64 2e 20 20 54 68 65 20 le R-card. The 16e0: 52 2d 63 61 72 64 20 68 61 73 0a 61 20 73 69 6e R-card has.a sin 16f0: 67 6c 65 20 61 72 67 75 6d 65 6e 74 20 77 68 69 gle argument whi 1700: 63 68 20 69 73 20 74 68 65 20 4d 44 35 20 63 68 ch is the MD5 ch 1710: 65 63 6b 73 75 6d 20 6f 66 20 61 6c 6c 20 66 69 ecksum of all fi 1720: 6c 65 73 20 69 6e 20 0a 74 68 65 20 62 61 73 65 les in .the base 1730: 6c 69 6e 65 20 65 78 63 65 70 74 20 74 68 65 20 line except the 1740: 6d 61 6e 69 66 65 73 74 20 69 74 73 65 6c 66 2e manifest itself. 1750: 20 20 54 68 65 20 63 68 65 63 6b 73 75 6d 20 69 The checksum i 1760: 73 20 65 78 70 72 65 73 73 65 64 0a 61 73 20 33 s expressed.as 3 1770: 32 2d 63 68 61 72 61 63 74 65 72 73 20 6f 66 20 2-characters of 1780: 6c 6f 77 65 72 63 61 73 65 20 68 65 78 61 64 65 lowercase hexade 1790: 63 69 6d 61 6c 2e 20 20 20 54 68 65 20 63 68 65 cimal. The che 17a0: 63 6b 73 75 6d 20 69 73 0a 63 6f 6d 70 75 74 65 cksum is.compute 17b0: 64 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 20 20 46 d as follows: F 17c0: 6f 72 20 65 61 63 68 20 66 69 6c 65 20 69 6e 20 or each file in 17d0: 74 68 65 20 62 61 73 65 6c 69 6e 65 20 28 65 78 the baseline (ex 17e0: 63 65 70 74 20 66 6f 72 0a 74 68 65 20 6d 61 6e cept for.the man 17f0: 69 66 65 73 74 20 69 74 73 65 6c 66 29 20 69 6e ifest itself) in 1800: 20 73 74 72 69 63 74 20 73 6f 72 74 65 64 20 6c strict sorted l 1810: 65 78 69 63 6f 67 72 61 70 68 69 63 61 6c 20 6f exicographical o 1820: 72 64 65 72 2c 20 0a 74 61 6b 65 20 74 68 65 20 rder, .take the 1830: 70 61 74 68 6e 61 6d 65 20 6f 66 20 74 68 65 20 pathname of the 1840: 66 69 6c 65 20 72 65 6c 61 74 69 76 65 20 74 6f file relative to 1850: 20 74 68 65 20 72 6f 6f 74 20 6f 66 20 74 68 65 the root of the 1860: 0a 72 65 70 6f 73 69 74 6f 72 79 2c 20 61 70 70 .repository, app 1870: 65 6e 64 20 61 20 73 69 6e 67 6c 65 20 73 70 61 end a single spa 1880: 63 65 20 28 41 53 43 49 49 20 30 78 32 30 29 2c ce (ASCII 0x20), 1890: 20 74 68 65 0a 73 69 7a 65 20 6f 66 20 74 68 65 the.size of the 18a0: 20 66 69 6c 65 20 69 6e 20 41 53 43 49 49 20 64 file in ASCII d 18b0: 65 63 69 6d 61 6c 2c 20 61 20 73 69 6e 67 6c 65 ecimal, a single 18c0: 20 6e 65 77 6c 69 6e 65 0a 63 68 61 72 61 63 74 newline.charact 18d0: 65 72 20 28 41 53 43 49 49 20 30 78 30 41 29 2c er (ASCII 0x0A), 18e0: 20 61 6e 64 20 74 68 65 20 63 6f 6d 70 6c 65 74 and the complet 18f0: 65 20 74 65 78 74 20 6f 66 20 74 68 65 20 66 69 e text of the fi 1900: 6c 65 2e 0a 43 6f 6d 70 75 74 65 20 74 68 65 20 le..Compute the 1910: 4d 44 35 20 63 68 65 63 6b 73 75 6d 20 6f 66 20 MD5 checksum of 1920: 74 68 65 20 74 68 65 20 72 65 73 75 6c 74 2e 0a the the result.. 1930: 3c 2f 70 3e 0a 0a 3c 70 3e 0a 45 61 63 68 20 6d </p>..<p>.Each m 1940: 61 6e 69 66 65 73 74 20 68 61 73 20 61 20 73 69 anifest has a si 1950: 6e 67 6c 65 20 55 2d 63 61 72 64 2e 20 20 54 68 ngle U-card. Th 1960: 65 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 e argument to th 1970: 65 20 55 2d 63 61 72 64 20 69 73 0a 74 68 65 20 e U-card is.the 1980: 6c 6f 67 69 6e 20 6f 66 20 74 68 65 20 75 73 65 login of the use 1990: 72 20 77 68 6f 20 63 72 65 61 74 65 64 20 74 68 r who created th 19a0: 65 20 6d 61 6e 69 66 65 73 74 2e 20 20 54 68 65 e manifest. The 19b0: 20 6c 6f 67 69 6e 20 6e 61 6d 65 0a 69 73 20 65 login name.is e 19c0: 6e 63 6f 64 65 64 20 75 73 69 6e 67 20 74 68 65 ncoded using the 19d0: 20 73 61 6d 65 20 63 68 61 72 61 63 74 65 72 20 same character 19e0: 65 73 63 61 70 65 73 20 61 73 20 69 73 20 75 73 escapes as is us 19f0: 65 64 20 66 6f 72 20 74 68 65 0a 63 68 65 63 6b ed for the.check 1a00: 2d 69 6e 20 63 6f 6d 6d 65 6e 74 20 61 72 67 75 -in comment argu 1a10: 6d 65 6e 74 20 74 6f 20 74 68 65 20 43 2d 63 61 ment to the C-ca 1a20: 72 64 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 41 20 rd..</p>..<p>.A 1a30: 6d 61 6e 69 66 65 73 74 20 68 61 73 20 61 6e 20 manifest has an 1a40: 6f 70 74 69 6f 6e 20 5a 2d 63 61 72 64 20 61 73 option Z-card as 1a50: 20 69 74 73 20 6c 61 73 74 20 6c 69 6e 65 2e 20 its last line. 1a60: 20 54 68 65 20 61 72 67 75 6d 65 6e 74 0a 74 6f The argument.to 1a70: 20 74 68 65 20 5a 2d 63 61 72 64 20 69 73 20 61 the Z-card is a 1a80: 20 33 32 2d 63 68 61 72 61 63 74 65 72 20 6c 6f 32-character lo 1a90: 77 65 72 63 61 73 65 20 68 65 78 61 64 65 63 69 wercase hexadeci 1aa0: 6d 61 6c 20 4d 44 35 20 68 61 73 68 0a 6f 66 20 mal MD5 hash.of 1ab0: 61 6c 6c 20 70 72 69 6f 72 20 6c 69 6e 65 73 20 all prior lines 1ac0: 6f 66 20 74 68 65 20 6d 61 6e 69 66 65 73 74 20 of the manifest 1ad0: 75 70 20 74 6f 20 61 6e 64 20 69 6e 63 6c 75 64 up to and includ 1ae0: 69 6e 67 20 74 68 65 20 6e 65 77 6c 69 6e 65 20 ing the newline 1af0: 0a 63 68 61 72 61 63 74 65 72 20 74 68 61 74 20 .character that 1b00: 69 6d 6d 65 64 69 61 74 65 6c 79 20 70 72 65 63 immediately prec 1b10: 65 65 64 73 20 74 68 65 20 22 5a 22 2e 20 20 54 eeds the "Z". T 1b20: 68 65 20 5a 2d 63 61 72 64 20 69 73 20 6a 75 73 he Z-card is jus 1b30: 74 0a 61 20 73 61 6e 69 74 79 20 63 68 65 63 6b t.a sanity check 1b40: 20 74 6f 20 70 72 6f 76 65 20 74 68 61 74 20 74 to prove that t 1b50: 68 65 20 6d 61 6e 69 66 65 73 74 20 69 73 20 77 he manifest is w 1b60: 65 6c 6c 2d 66 6f 72 6d 65 64 20 61 6e 64 0a 63 ell-formed and.c 1b70: 6f 6e 73 69 73 74 65 6e 74 2e 0a 3c 2f 70 3e 0a onsistent..</p>. 1b80: 0a 3c 68 32 3e 32 2e 30 20 43 6c 75 73 74 65 72 .<h2>2.0 Cluster 1b90: 73 3c 2f 68 32 3e 0a 0a 3c 70 3e 0a 41 20 63 6c s</h2>..<p>.A cl 1ba0: 75 73 74 65 72 20 69 73 20 61 20 61 72 74 69 66 uster is a artif 1bb0: 61 63 74 20 74 68 61 74 20 64 65 63 6c 61 72 65 act that declare 1bc0: 73 20 74 68 65 20 65 78 69 73 74 61 6e 63 65 20 s the existance 1bd0: 6f 66 20 6f 74 68 65 72 20 61 72 74 69 66 61 63 of other artifac 1be0: 74 73 2e 0a 43 6c 75 73 74 65 72 73 20 61 72 65 ts..Clusters are 1bf0: 20 75 73 65 64 20 64 75 72 69 6e 67 20 72 65 70 used during rep 1c00: 6f 73 69 74 6f 72 79 20 73 79 6e 63 68 72 6f 6e ository synchron 1c10: 69 7a 61 74 69 6f 6e 20 74 6f 20 68 65 6c 70 20 ization to help 1c20: 0a 72 65 64 75 63 65 20 6e 65 74 77 6f 72 6b 20 .reduce network 1c30: 74 72 61 66 66 69 63 2e 20 20 41 73 20 73 75 63 traffic. As suc 1c40: 68 2c 20 63 6c 75 73 74 65 72 73 20 61 72 65 20 h, clusters are 1c50: 61 6e 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 an optimization 1c60: 61 6e 64 0a 6d 61 79 20 62 65 20 72 65 6d 6f 76 and.may be remov 1c70: 65 64 20 66 72 6f 6d 20 61 20 72 65 70 6f 73 69 ed from a reposi 1c80: 74 6f 72 79 20 77 69 74 68 6f 75 74 20 6c 6f 73 tory without los 1c90: 73 20 6f 72 20 64 61 6d 61 67 65 20 74 6f 20 74 s or damage to t 1ca0: 68 65 0a 75 6e 64 65 72 6c 79 69 6e 67 20 70 72 he.underlying pr 1cb0: 6f 6a 65 63 74 20 63 6f 64 65 2e 0a 3c 2f 70 3e oject code..</p> 1cc0: 0a 0a 3c 70 3e 0a 43 6c 75 73 74 65 72 73 20 66 ..<p>.Clusters f 1cd0: 6f 6c 6c 6f 77 20 61 20 73 79 6e 74 61 78 20 74 ollow a syntax t 1ce0: 68 61 74 20 69 73 20 76 65 72 79 20 73 69 6d 69 hat is very simi 1cf0: 6c 61 72 20 74 6f 20 6d 61 6e 69 66 65 73 74 73 lar to manifests 1d00: 2e 0a 41 20 43 6c 75 73 74 65 72 20 69 73 20 61 ..A Cluster is a 1d10: 20 6c 69 6e 65 2d 6f 72 69 65 6e 74 65 64 20 74 line-oriented t 1d20: 65 78 74 20 66 69 6c 65 2e 20 20 4e 65 77 6c 69 ext file. Newli 1d30: 6e 65 20 63 68 61 72 61 63 74 65 72 73 0a 28 41 ne characters.(A 1d40: 53 43 49 49 20 30 78 30 61 29 20 73 65 70 61 72 SCII 0x0a) separ 1d50: 61 74 65 20 74 68 65 20 61 72 74 69 66 61 63 74 ate the artifact 1d60: 20 69 6e 74 6f 20 63 61 72 64 73 2e 20 20 45 61 into cards. Ea 1d70: 63 68 20 63 61 72 64 20 62 65 67 69 6e 73 20 77 ch card begins w 1d80: 69 74 68 20 61 20 73 69 6e 67 6c 65 0a 63 68 61 ith a single.cha 1d90: 72 61 63 74 65 72 20 22 63 61 72 64 20 74 79 70 racter "card typ 1da0: 65 22 2e 20 20 5a 65 72 6f 20 6f 72 20 6d 6f 72 e". Zero or mor 1db0: 65 20 61 72 67 75 6d 65 6e 74 73 20 6d 61 79 20 e arguments may 1dc0: 66 6f 6c 6c 6f 77 0a 74 68 65 20 63 61 72 64 20 follow.the card 1dd0: 74 79 70 65 2e 20 20 41 6c 6c 20 61 72 67 75 6d type. All argum 1de0: 65 6e 74 73 20 61 72 65 20 73 65 70 61 72 61 74 ents are separat 1df0: 65 64 20 66 72 6f 6d 20 65 61 63 68 20 6f 74 68 ed from each oth 1e00: 65 72 0a 61 6e 64 20 66 72 6f 6d 20 74 68 65 20 er.and from the 1e10: 63 61 72 64 2d 74 79 70 65 20 63 68 61 72 61 63 card-type charac 1e20: 74 65 72 20 62 79 20 61 20 73 69 6e 67 6c 65 20 ter by a single 1e30: 73 70 61 63 65 0a 63 68 61 72 61 63 74 65 72 2e space.character. 1e40: 20 20 54 68 65 72 65 20 69 73 20 6e 6f 20 73 75 There is no su 1e50: 72 70 6c 75 73 20 77 68 69 74 65 20 73 70 61 63 rplus white spac 1e60: 65 20 62 65 74 77 65 65 6e 20 61 72 67 75 6d 65 e between argume 1e70: 6e 74 73 0a 61 6e 64 20 6e 6f 20 6c 65 61 64 69 nts.and no leadi 1e80: 6e 67 20 6f 72 20 74 72 61 69 6c 69 6e 67 20 77 ng or trailing w 1e90: 68 69 74 65 73 70 61 63 65 20 65 78 63 65 70 74 hitespace except 1ea0: 20 66 6f 72 20 74 68 65 20 6e 65 77 6c 69 6e 65 for the newline 1eb0: 20 0a 63 68 61 72 61 63 74 65 72 20 74 68 61 74 .character that 1ec0: 20 61 63 74 73 20 61 73 20 74 68 65 20 63 61 72 acts as the car 1ed0: 64 20 73 65 70 61 72 61 74 6f 72 2e 0a 41 6c 6c d separator..All 1ee0: 20 63 61 72 64 73 20 6f 66 20 61 20 63 6c 75 74 cards of a clut 1ef0: 65 72 20 6f 63 63 75 72 20 69 6e 20 73 74 72 69 er occur in stri 1f00: 63 74 20 73 6f 72 74 65 64 20 6c 65 78 69 63 6f ct sorted lexico 1f10: 67 72 61 70 68 69 63 61 6c 20 6f 72 64 65 72 2e graphical order. 1f20: 0a 4e 6f 20 63 61 72 64 20 6d 61 79 20 62 65 20 .No card may be 1f30: 64 75 70 6c 69 63 61 74 65 64 2e 0a 54 68 65 20 duplicated..The 1f40: 63 6c 75 73 74 65 72 20 6d 61 79 20 6e 6f 74 20 cluster may not 1f50: 63 6f 6e 74 61 69 6e 20 61 64 64 69 74 69 6f 6e contain addition 1f60: 61 6c 20 74 65 78 74 20 6f 72 20 64 61 74 61 20 al text or data 1f70: 62 65 79 6f 6e 64 20 0a 77 68 61 74 20 69 73 20 beyond .what is 1f80: 64 65 73 63 72 69 62 65 64 20 68 65 72 65 2e 0a described here.. 1f90: 55 6e 6c 69 6b 65 20 6d 61 6e 69 66 65 73 74 73 Unlike manifests 1fa0: 2c 20 63 6c 75 73 74 65 72 73 20 61 72 65 20 6e , clusters are n 1fb0: 65 76 65 72 20 50 47 50 20 73 69 67 6e 65 64 2e ever PGP signed. 1fc0: 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 41 6c 6c 6f 77 .</p>..<p>.Allow 1fd0: 65 64 20 63 61 72 64 73 20 69 6e 20 74 68 65 20 ed cards in the 1fe0: 63 6c 75 73 74 65 72 20 61 72 65 20 61 73 20 66 cluster are as f 1ff0: 6f 6c 6c 6f 77 73 3a 0a 3c 2f 70 3e 0a 0a 3c 62 ollows:.</p>..<b 2000: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 62 3e 4d 3c lockquote>.<b>M< 2010: 2f 62 3e 20 3c 69 3e 75 75 69 64 3c 2f 69 3e 3c /b> <i>uuid</i>< 2020: 62 72 20 2f 3e 0a 3c 62 3e 5a 3c 2f 62 3e 20 3c br />.<b>Z</b> < 2030: 69 3e 63 68 65 63 6b 73 75 6d 3c 2f 69 3e 0a 3c i>checksum</i>.< 2040: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 /blockquote>..<p 2050: 3e 0a 41 20 63 6c 75 73 74 65 72 20 63 6f 6e 74 >.A cluster cont 2060: 61 69 6e 73 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 ains one or more 2070: 20 22 4d 22 20 63 61 72 64 73 20 66 6f 6c 6c 6f "M" cards follo 2080: 77 65 64 20 62 79 20 61 20 73 69 6e 67 6c 65 20 wed by a single 2090: 22 5a 22 0a 6c 69 6e 65 2e 20 20 45 61 63 68 20 "Z".line. Each 20a0: 4d 20 63 61 72 64 20 68 61 73 20 61 20 73 69 6e M card has a sin 20b0: 67 6c 65 20 61 72 67 75 6d 65 6e 74 20 77 68 69 gle argument whi 20c0: 63 68 20 69 73 20 74 68 65 20 55 55 49 44 20 6f ch is the UUID o 20d0: 66 20 0a 61 6e 6f 74 68 65 72 20 61 72 74 69 66 f .another artif 20e0: 61 63 74 20 69 6e 20 74 68 65 20 72 65 70 6f 73 act in the repos 20f0: 69 74 6f 72 79 2e 20 20 54 68 65 20 5a 20 63 61 itory. The Z ca 2100: 72 64 20 77 6f 72 6b 20 65 78 61 63 74 6c 79 20 rd work exactly 2110: 6c 69 6b 65 0a 74 68 65 20 5a 20 63 61 72 64 20 like.the Z card 2120: 6f 66 20 61 20 6d 61 6e 69 66 65 73 74 2e 20 20 of a manifest. 2130: 54 68 65 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 The argument to 2140: 74 68 65 20 5a 20 63 61 72 64 20 69 73 20 74 68 the Z card is th 2150: 65 0a 6c 6f 77 65 72 2d 63 61 73 65 20 68 65 78 e.lower-case hex 2160: 61 64 65 63 69 6d 61 6c 20 72 65 70 72 65 73 65 adecimal represe 2170: 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 4d ntation of the M 2180: 44 35 20 63 68 65 63 6b 73 75 6d 20 6f 66 20 61 D5 checksum of a 2190: 6c 6c 0a 70 72 69 6f 72 20 63 61 72 64 73 20 69 ll.prior cards i 21a0: 6e 20 74 68 65 20 63 6c 75 73 74 65 72 2e 20 20 n the cluster. 21b0: 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 5a 20 Note that the Z 21c0: 63 61 72 64 20 69 73 20 72 65 71 75 69 72 65 64 card is required 21d0: 0a 6f 6e 20 61 20 63 6c 75 73 74 65 72 2e 0a 3c .on a cluster..< 21e0: 2f 70 3e 0a 0a 0a 3c 68 32 3e 33 2e 30 20 43 6f /p>...<h2>3.0 Co 21f0: 6e 74 72 6f 6c 20 41 72 74 69 66 61 63 74 73 3c ntrol Artifacts< 2200: 2f 68 32 3e 0a 0a 3c 70 3e 0a 43 6f 6e 74 72 6f /h2>..<p>.Contro 2210: 6c 20 61 72 74 69 66 61 63 74 73 20 61 72 65 20 l artifacts are 2220: 75 73 65 64 20 74 6f 20 61 73 73 69 67 6e 20 70 used to assign p 2230: 72 6f 70 65 72 74 69 65 73 20 74 6f 20 6f 74 68 roperties to oth 2240: 65 72 20 61 72 74 69 66 61 63 74 73 0a 77 69 74 er artifacts.wit 2250: 68 69 6e 20 74 68 65 20 72 65 70 6f 73 69 74 6f hin the reposito 2260: 72 79 2e 20 20 54 68 65 20 62 61 73 69 63 20 66 ry. The basic f 2270: 6f 72 6d 61 74 20 6f 66 20 61 20 63 6f 6e 74 72 ormat of a contr 2280: 6f 6c 20 61 72 74 69 66 61 63 74 20 69 73 0a 74 ol artifact is.t 2290: 68 65 20 73 61 6d 65 20 61 73 20 61 20 6d 61 6e he same as a man 22a0: 69 66 65 73 74 20 6f 72 20 63 6c 75 73 74 65 72 ifest or cluster 22b0: 2e 20 20 41 20 63 6f 6e 74 72 6f 6c 20 61 72 74 . A control art 22c0: 69 66 61 63 74 20 69 73 20 61 20 74 65 78 74 0a ifact is a text. 22d0: 66 69 6c 65 73 20 64 69 76 69 64 65 64 20 69 6e files divided in 22e0: 74 6f 20 63 61 72 64 73 20 62 79 20 6e 65 77 6c to cards by newl 22f0: 69 6e 65 20 63 68 61 72 61 63 74 65 72 73 2e 20 ine characters. 2300: 20 45 61 63 68 20 63 61 72 64 20 68 61 73 20 61 Each card has a 2310: 0a 73 69 6e 67 6c 65 2d 63 68 61 72 61 63 74 65 .single-characte 2320: 72 20 63 61 72 64 20 74 79 70 65 20 66 6f 6c 6c r card type foll 2330: 6f 77 65 64 20 62 79 20 61 72 67 75 6d 65 6e 74 owed by argument 2340: 73 2e 20 20 53 70 61 63 65 73 20 73 65 70 61 72 s. Spaces separ 2350: 61 74 65 0a 74 68 65 20 63 61 72 64 20 74 79 70 ate.the card typ 2360: 65 20 61 6e 64 20 74 68 65 20 61 72 67 75 6d 65 e and the argume 2370: 6e 74 73 2e 20 20 4e 6f 20 73 75 72 70 6c 75 73 nts. No surplus 2380: 20 77 68 69 74 65 73 70 61 63 65 20 69 73 20 61 whitespace is a 2390: 6c 6c 6f 77 65 64 2e 0a 41 6c 6c 20 63 61 72 64 llowed..All card 23a0: 73 20 6d 75 73 74 20 6f 63 63 75 72 20 69 6e 20 s must occur in 23b0: 73 74 72 69 63 74 20 6c 65 78 69 67 72 61 70 68 strict lexigraph 23c0: 69 63 61 6c 20 6f 72 64 65 72 2e 0a 3c 2f 70 3e ical order..</p> 23d0: 0a 0a 3c 70 3e 0a 41 6c 6c 6f 77 65 64 20 63 61 ..<p>.Allowed ca 23e0: 72 64 73 20 69 6e 20 61 20 63 6f 6e 74 72 6f 6c rds in a control 23f0: 20 61 72 74 69 66 61 63 74 20 61 72 65 20 61 73 artifact are as 2400: 20 66 6f 6c 6c 6f 77 73 3a 0a 3c 2f 70 3e 0a 0a follows:.</p>.. 2410: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 62 3e <blockquote>.<b> 2420: 44 3c 2f 62 3e 20 3c 69 3e 74 69 6d 65 2d 61 6e D</b> <i>time-an 2430: 64 2d 64 61 74 65 2d 73 74 61 6d 70 3c 2f 69 3e d-date-stamp</i> 2440: 3c 62 72 20 2f 3e 0a 3c 62 3e 54 3c 2f 62 3e 20 <br />.<b>T</b> 2450: 28 3c 62 3e 2b 3c 2f 62 3e 7c 3c 62 3e 2d 3c 2f (<b>+</b>|<b>-</ 2460: 62 3e 7c 3c 62 3e 2a 3c 2f 62 3e 29 3c 69 3e 74 b>|<b>*</b>)<i>t 2470: 61 67 2d 6e 61 6d 65 20 20 75 75 69 64 20 20 3f ag-name uuid ? 2480: 76 61 6c 75 65 3f 3c 2f 69 3e 3c 62 72 20 2f 3e value?</i><br /> 2490: 0a 3c 62 3e 5a 3c 2f 62 3e 20 3c 69 3e 63 68 65 .<b>Z</b> <i>che 24a0: 63 6b 73 75 6d 3c 2f 69 3e 3c 62 72 20 2f 3e 0a cksum</i><br />. 24b0: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c </blockquote>..< 24c0: 70 3e 0a 41 20 63 6f 6e 74 72 6f 6c 20 61 72 74 p>.A control art 24d0: 69 66 61 63 74 20 6d 75 73 74 20 68 61 76 65 20 ifact must have 24e0: 6f 6e 65 20 44 20 63 61 72 64 20 61 6e 64 20 6f one D card and o 24f0: 6e 65 20 5a 20 63 61 72 64 20 61 6e 64 0a 6f 6e ne Z card and.on 2500: 65 20 6f 72 20 6d 6f 72 65 20 6f 72 20 6d 6f 72 e or more or mor 2510: 65 20 54 20 63 61 72 64 73 2e 20 20 4e 6f 20 6f e T cards. No o 2520: 74 68 65 72 20 63 61 72 64 73 20 6f 72 20 6f 74 ther cards or ot 2530: 68 65 72 20 74 65 78 74 20 69 73 0a 61 6c 6c 6f her text is.allo 2540: 77 65 64 20 69 6e 20 61 20 63 6f 6e 74 72 6f 6c wed in a control 2550: 20 61 72 74 69 66 61 63 74 2e 20 20 43 6f 6e 74 artifact. Cont 2560: 72 6f 6c 20 61 72 74 69 66 61 63 74 73 20 6d 69 rol artifacts mi 2570: 67 68 74 20 62 65 20 50 47 50 0a 63 6c 65 61 72 ght be PGP.clear 2580: 73 69 67 6e 65 64 2e 3c 2f 70 3e 0a 0a 3c 70 3e signed.</p>..<p> 2590: 54 68 65 20 44 20 63 61 72 64 20 61 6e 64 20 74 The D card and t 25a0: 68 65 20 5a 20 63 61 72 64 20 6f 66 20 61 20 63 he Z card of a c 25b0: 6f 6e 74 72 6f 6c 20 61 72 74 69 66 61 63 74 20 ontrol artifact 25c0: 61 72 65 20 74 68 65 20 73 61 6d 65 0a 61 73 20 are the same.as 25d0: 69 6e 20 61 20 6d 61 6e 69 66 65 73 74 2e 3c 2f in a manifest.</ 25e0: 70 3e 0a 0a 3c 70 3e 54 68 65 20 54 20 63 61 72 p>..<p>The T car 25f0: 64 20 72 65 70 72 65 73 65 6e 74 73 20 61 20 22 d represents a " 2600: 74 61 67 22 20 6f 72 20 70 72 6f 70 65 72 74 79 tag" or property 2610: 20 74 68 61 74 20 69 73 20 61 70 70 6c 69 65 64 that is applied 2620: 20 74 6f 0a 73 6f 6d 65 20 6f 74 68 65 72 20 61 to.some other a 2630: 72 74 69 66 61 63 74 2e 20 20 54 68 65 20 54 20 rtifact. The T 2640: 63 61 72 64 20 68 61 73 20 74 77 6f 20 6f 72 20 card has two or 2650: 74 68 72 65 65 20 76 61 6c 75 65 73 2e 20 20 54 three values. T 2660: 68 65 0a 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 he.second argume 2670: 6e 74 20 69 73 20 74 68 65 20 34 30 20 63 68 61 nt is the 40 cha 2680: 72 61 63 74 65 72 20 6c 6f 77 65 72 63 61 73 65 racter lowercase 2690: 20 55 55 49 44 20 6f 66 20 74 68 65 20 61 72 74 UUID of the art 26a0: 69 66 61 63 74 0a 74 6f 20 77 68 69 63 68 20 74 ifact.to which t 26b0: 68 65 20 74 61 67 20 69 73 20 74 6f 20 62 65 20 he tag is to be 26c0: 61 70 70 6c 69 65 64 2e 20 54 68 65 0a 66 69 72 applied. The.fir 26d0: 73 74 20 76 61 6c 75 65 20 69 73 20 74 68 65 20 st value is the 26e0: 74 61 67 20 6e 61 6d 65 2e 20 20 54 68 65 20 66 tag name. The f 26f0: 69 72 73 74 20 63 68 61 72 61 63 74 65 72 20 6f irst character o 2700: 66 20 74 68 65 20 74 61 67 0a 69 73 20 65 69 74 f the tag.is eit 2710: 68 65 72 20 22 2b 22 2c 20 22 2d 22 2c 20 6f 72 her "+", "-", or 2720: 20 22 2a 22 2e 20 20 41 20 22 2b 22 20 6d 65 61 "*". A "+" mea 2730: 6e 73 20 74 68 65 20 74 61 67 20 73 68 6f 75 6c ns the tag shoul 2740: 64 20 62 65 20 61 64 64 65 64 0a 74 6f 20 74 68 d be added.to th 2750: 65 20 61 72 74 69 66 61 63 74 2e 20 20 54 68 65 e artifact. The 2760: 20 22 2d 22 20 6d 65 61 6e 73 20 74 68 65 20 74 "-" means the t 2770: 61 67 20 73 68 6f 75 6c 64 20 62 65 20 72 65 6d ag should be rem 2780: 6f 76 65 64 2e 0a 54 68 65 20 22 2a 22 20 63 68 oved..The "*" ch 2790: 61 72 61 63 74 65 72 20 6d 65 61 6e 73 20 74 68 aracter means th 27a0: 65 20 74 61 67 20 73 68 6f 75 6c 64 20 62 65 20 e tag should be 27b0: 61 64 64 65 64 20 74 6f 20 74 68 65 20 61 72 74 added to the art 27c0: 69 66 61 63 74 0a 61 6e 64 20 61 6c 6c 20 64 69 ifact.and all di 27d0: 72 65 63 74 20 64 65 63 65 6e 64 61 6e 74 73 20 rect decendants 27e0: 28 62 75 74 20 6e 6f 74 20 62 72 61 6e 63 68 65 (but not branche 27f0: 73 29 20 6f 66 20 74 68 65 20 61 72 74 69 66 61 s) of the artifa 2800: 63 74 20 64 6f 77 6e 0a 74 6f 20 62 75 74 20 6e ct down.to but n 2810: 6f 74 20 69 6e 63 6c 75 64 69 6e 67 20 74 68 65 ot including the 2820: 20 66 69 72 73 74 20 64 65 63 65 6e 64 61 6e 74 first decendant 2830: 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 61 that contains a 2840: 20 0a 6d 6f 72 65 20 72 65 63 65 6e 74 20 22 2d .more recent "- 2850: 22 20 74 61 67 20 77 69 74 68 20 74 68 65 20 73 " tag with the s 2860: 61 6d 65 20 6e 61 6d 65 2e 0a 54 68 65 20 6f 70 ame name..The op 2870: 74 69 6f 6e 61 6c 20 74 68 69 72 64 20 61 72 67 tional third arg 2880: 75 6d 65 6e 74 20 69 73 20 74 68 65 20 76 61 6c ument is the val 2890: 75 65 20 6f 66 20 74 68 65 20 74 61 67 2e 20 20 ue of the tag. 28a0: 41 20 74 61 67 0a 77 69 74 68 6f 75 74 20 61 20 A tag.without a 28b0: 76 61 6c 75 65 20 69 73 20 61 20 62 6f 6f 6c 65 value is a boole 28c0: 61 6e 2e 3c 2f 70 3e 0a 0a 3c 70 3e 57 68 65 6e an.</p>..<p>When 28d0: 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 74 61 67 two or more tag 28e0: 73 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 20 s with the same 28f0: 6e 61 6d 65 20 61 72 65 20 61 70 70 6c 69 65 64 name are applied 2900: 20 74 6f 20 74 68 65 0a 73 61 6d 65 20 61 72 74 to the.same art 2910: 69 66 61 63 74 2c 20 74 68 65 20 74 61 67 20 77 ifact, the tag w 2920: 69 74 68 20 74 68 65 20 6c 61 74 65 73 74 20 28 ith the latest ( 2930: 6d 6f 73 74 20 72 65 63 65 6e 74 29 20 64 61 74 most recent) dat 2940: 65 20 69 73 0a 75 73 65 64 2e 3c 2f 70 3e 0a 0a e is.used.</p>.. 2950: 3c 70 3e 53 6f 6d 65 20 74 61 67 73 20 68 61 76 <p>Some tags hav 2960: 65 20 73 70 65 63 69 61 6c 20 6d 65 61 6e 69 6e e special meanin 2970: 67 2e 20 20 54 68 65 20 22 63 6f 6d 6d 65 6e 74 g. The "comment 2980: 22 20 74 61 67 20 77 68 65 6e 20 61 70 70 6c 69 " tag when appli 2990: 65 64 0a 74 6f 20 61 20 62 61 73 65 6c 69 6e 65 ed.to a baseline 29a0: 20 77 69 6c 6c 20 6f 76 65 72 72 69 64 65 20 74 will override t 29b0: 68 65 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d 6d he check-in comm 29c0: 65 6e 74 20 6f 66 20 74 68 61 74 20 62 61 73 65 ent of that base 29d0: 6c 69 6e 65 0a 66 6f 72 20 64 69 73 70 6c 61 79 line.for display 29e0: 20 70 75 72 70 6f 73 65 73 2e 3c 2f 70 3e 0a 0a purposes.</p>.. 29f0: 3c 61 20 6e 61 6d 65 3d 22 77 69 6b 69 63 68 6e <a name="wikichn 2a00: 67 22 3e 3c 2f 61 3e 0a 3c 68 32 3e 34 2e 30 20 g"></a>.<h2>4.0 2a10: 57 69 6b 69 20 50 61 67 65 73 3c 2f 68 32 3e 0a Wiki Pages</h2>. 2a20: 0a 3c 70 3e 41 20 77 69 6b 69 20 70 61 67 65 20 .<p>A wiki page 2a30: 69 73 20 61 6e 20 61 72 74 69 66 61 63 74 20 77 is an artifact w 2a40: 69 74 68 20 61 20 66 6f 72 6d 61 74 20 73 69 6d ith a format sim 2a50: 69 6c 61 72 20 74 6f 20 6d 61 6e 69 66 65 73 74 ilar to manifest 2a60: 73 2c 0a 63 6c 75 73 74 65 72 73 2c 20 61 6e 64 s,.clusters, and 2a70: 20 63 6f 6e 74 72 6f 6c 20 61 72 74 69 66 61 63 control artifac 2a80: 74 73 2e 20 20 54 68 65 20 61 72 74 69 66 61 63 ts. The artifac 2a90: 74 20 69 73 20 64 69 76 69 64 65 64 20 69 6e 74 t is divided int 2aa0: 6f 0a 63 61 72 64 73 20 62 79 20 6e 65 77 6c 69 o.cards by newli 2ab0: 6e 65 20 63 68 61 72 61 63 74 65 72 73 2e 20 20 ne characters. 2ac0: 54 68 65 20 66 6f 72 6d 61 74 20 6f 66 20 65 61 The format of ea 2ad0: 63 68 20 63 61 72 64 20 69 73 20 61 73 20 69 6e ch card is as in 2ae0: 0a 6d 61 6e 69 66 65 73 74 73 2c 20 63 6c 75 73 .manifests, clus 2af0: 74 65 72 73 2c 20 61 6e 64 20 63 6f 6e 74 72 6f ters, and contro 2b00: 6c 20 61 72 74 69 66 61 63 74 73 2e 20 20 57 69 l artifacts. Wi 2b10: 6b 69 20 61 72 74 69 66 61 63 74 73 20 61 63 63 ki artifacts acc 2b20: 65 70 74 0a 74 68 65 20 66 6f 6c 6c 6f 77 69 6e ept.the followin 2b30: 67 20 63 61 72 64 20 74 79 70 65 73 3a 3c 2f 70 g card types:</p 2b40: 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a >..<blockquote>. 2b50: 3c 62 3e 44 3c 2f 62 3e 20 3c 69 3e 74 69 6d 65 <b>D</b> <i>time 2b60: 2d 61 6e 64 2d 64 61 74 65 2d 73 74 61 6d 70 3c -and-date-stamp< 2b70: 2f 69 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 4c 3c 2f /i><br />.<b>L</ 2b80: 62 3e 20 3c 69 3e 77 69 6b 69 2d 74 69 74 6c 65 b> <i>wiki-title 2b90: 3c 2f 69 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 50 3c </i><br />.<b>P< 2ba0: 2f 62 3e 20 3c 69 3e 70 61 72 65 6e 74 2d 75 75 /b> <i>parent-uu 2bb0: 69 64 3c 2f 69 3e 2b 3c 62 72 20 2f 3e 0a 3c 62 id</i>+<br />.<b 2bc0: 3e 55 3c 2f 62 3e 20 3c 69 3e 75 73 65 72 2d 6e >U</b> <i>user-n 2bd0: 61 6d 65 3c 2f 69 3e 3c 62 72 20 2f 3e 0a 3c 62 ame</i><br />.<b 2be0: 3e 57 3c 2f 62 3e 20 3c 69 3e 73 69 7a 65 3c 2f >W</b> <i>size</ 2bf0: 69 3e 20 3c 62 3e 5c 6e 3c 2f 62 3e 20 3c 69 3e i> <b>\n</b> <i> 2c00: 74 65 78 74 3c 2f 69 3e 20 3c 62 3e 5c 6e 3c 2f text</i> <b>\n</ 2c10: 62 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 5a 3c 2f 62 b><br />.<b>Z</b 2c20: 3e 20 3c 69 3e 63 68 65 63 6b 73 75 6d 3c 2f 69 > <i>checksum</i 2c30: 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a >.</blockquote>. 2c40: 0a 3c 70 3e 54 68 65 20 44 20 63 61 72 64 20 69 .<p>The D card i 2c50: 73 20 74 68 65 20 64 61 74 65 20 61 6e 64 20 74 s the date and t 2c60: 69 6d 65 20 77 68 65 6e 20 74 68 65 20 77 69 6b ime when the wik 2c70: 69 20 70 61 67 65 20 77 61 73 20 65 64 69 74 65 i page was edite 2c80: 64 2e 0a 54 68 65 20 50 20 63 61 72 64 20 73 70 d..The P card sp 2c90: 65 63 69 66 69 65 73 20 74 68 65 20 70 61 72 65 ecifies the pare 2ca0: 6e 74 20 77 69 6b 69 20 70 61 67 65 73 2c 20 69 nt wiki pages, i 2cb0: 66 20 61 6e 79 2e 20 20 54 68 65 20 4c 20 63 61 f any. The L ca 2cc0: 72 64 0a 67 69 76 65 73 20 74 68 65 20 6e 61 6d rd.gives the nam 2cd0: 65 20 6f 66 20 74 68 65 20 77 69 6b 69 20 70 61 e of the wiki pa 2ce0: 67 65 2e 20 20 54 68 65 20 55 20 63 61 72 64 20 ge. The U card 2cf0: 73 70 65 63 69 66 69 65 73 20 74 68 65 20 6c 6f specifies the lo 2d00: 67 69 6e 0a 6f 66 20 74 68 65 20 75 73 65 72 20 gin.of the user 2d10: 77 68 6f 20 6d 61 64 65 20 74 68 69 73 20 65 64 who made this ed 2d20: 69 74 20 74 6f 20 74 68 65 20 77 69 6b 69 20 70 it to the wiki p 2d30: 61 67 65 2e 20 20 54 68 65 20 5a 20 63 61 72 64 age. The Z card 2d40: 20 69 73 0a 74 68 65 20 75 73 75 61 6c 20 63 68 is.the usual ch 2d50: 65 63 6b 73 75 6d 20 6f 76 65 72 20 74 68 65 20 ecksum over the 2d60: 65 69 74 68 65 72 20 61 72 74 69 66 61 63 74 2e either artifact. 2d70: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 57 20 63 </p>..<p>The W c 2d80: 61 72 64 20 69 73 20 75 73 65 64 20 74 6f 20 73 ard is used to s 2d90: 70 65 63 69 66 79 20 74 68 65 20 74 65 78 74 20 pecify the text 2da0: 6f 66 20 74 68 65 20 77 69 6b 69 20 70 61 67 65 of the wiki page 2db0: 2e 20 20 54 68 65 0a 61 72 67 75 6d 65 6e 74 20 . The.argument 2dc0: 74 6f 20 74 68 65 20 57 20 63 61 72 64 20 69 73 to the W card is 2dd0: 20 61 6e 20 69 6e 74 65 67 65 72 20 77 68 69 63 an integer whic 2de0: 68 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 h is the number 2df0: 6f 66 20 62 79 74 65 73 0a 6f 66 20 74 65 78 74 of bytes.of text 2e00: 20 69 6e 20 74 68 65 20 77 69 6b 69 20 70 61 67 in the wiki pag 2e10: 65 2e 20 20 54 68 61 74 20 74 65 78 74 20 66 6f e. That text fo 2e20: 6c 6c 6f 77 73 20 74 68 65 20 6e 65 77 6c 69 6e llows the newlin 2e30: 65 20 63 68 61 72 61 63 74 65 72 0a 74 68 61 74 e character.that 2e40: 20 74 65 72 6d 69 6e 61 74 65 73 20 74 68 65 20 terminates the 2e50: 57 20 63 61 72 64 2e 20 20 54 68 65 20 77 69 6b W card. The wik 2e60: 69 20 74 65 78 74 20 69 73 20 61 6c 77 61 79 73 i text is always 2e70: 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 6f 6e 65 followed by one 2e80: 0a 65 78 74 72 61 20 6e 65 77 6c 69 6e 65 2e 3c .extra newline.< 2e90: 2f 70 3e 0a 0a 3c 61 20 6e 61 6d 65 3d 22 74 6b /p>..<a name="tk 2ea0: 74 63 68 6e 67 22 3e 3c 2f 61 3e 0a 3c 68 32 3e tchng"></a>.<h2> 2eb0: 35 2e 30 20 54 69 63 6b 65 74 20 43 68 61 6e 67 5.0 Ticket Chang 2ec0: 65 73 3c 2f 68 32 3e 0a 0a 3c 70 3e 41 20 74 69 es</h2>..<p>A ti 2ed0: 63 6b 65 74 2d 63 68 61 6e 67 65 20 61 72 74 69 cket-change arti 2ee0: 66 61 63 74 20 72 65 70 72 65 73 65 6e 74 73 20 fact represents 2ef0: 61 20 63 68 61 6e 67 65 20 74 6f 20 61 20 74 72 a change to a tr 2f00: 6f 75 62 6c 65 20 74 69 63 6b 65 74 2e 0a 54 68 ouble ticket..Th 2f10: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 61 72 64 e following card 2f20: 73 20 61 72 65 20 61 6c 6c 6f 77 65 64 20 6f 6e s are allowed on 2f30: 20 61 20 74 69 63 6b 65 74 20 63 68 61 6e 67 65 a ticket change 2f40: 20 61 72 74 69 66 61 63 74 3a 3c 2f 70 3e 0a 0a artifact:</p>.. 2f50: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 62 3e <blockquote>.<b> 2f60: 44 3c 2f 62 3e 20 3c 69 3e 74 69 6d 65 2d 61 6e D</b> <i>time-an 2f70: 64 2d 64 61 74 65 2d 73 74 61 6d 70 3c 2f 69 3e d-date-stamp</i> 2f80: 3c 62 72 20 2f 3e 0a 3c 62 3e 4a 3c 2f 62 3e 20 <br />.<b>J</b> 2f90: 3f 3c 62 3e 2b 3c 2f 62 3e 3f 3c 69 3e 6e 61 6d ?<b>+</b>?<i>nam 2fa0: 65 20 76 61 6c 75 65 3c 2f 69 3e 3c 62 72 20 2f e value</i><br / 2fb0: 3e 0a 3c 62 3e 4b 3c 2f 62 3e 20 3c 69 3e 74 69 >.<b>K</b> <i>ti 2fc0: 63 6b 65 74 2d 75 75 69 64 3c 2f 69 3e 3c 62 72 cket-uuid</i><br 2fd0: 20 2f 3e 0a 3c 62 3e 55 3c 2f 62 3e 20 3c 69 3e />.<b>U</b> <i> 2fe0: 75 73 65 72 2d 6e 61 6d 65 3c 2f 69 3e 3c 62 72 user-name</i><br 2ff0: 20 2f 3e 0a 3c 62 3e 5a 3c 2f 62 3e 20 3c 69 3e />.<b>Z</b> <i> 3000: 63 68 65 63 6b 73 75 6d 3c 2f 69 3e 0a 3c 2f 62 checksum</i>.</b 3010: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 0a lockquote>..<p>. 3020: 54 68 65 20 44 20 63 61 72 64 20 69 73 20 74 68 The D card is th 3030: 65 20 75 73 75 61 6c 20 64 61 74 65 20 61 6e 64 e usual date and 3040: 20 74 69 6d 65 20 73 74 61 6d 70 20 61 6e 64 20 time stamp and 3050: 72 65 70 72 65 73 65 6e 74 73 20 74 68 65 20 70 represents the p 3060: 6f 69 6e 74 0a 69 6e 20 74 69 6d 65 20 77 68 65 oint.in time whe 3070: 6e 20 74 68 65 20 63 68 61 6e 67 65 20 77 61 73 n the change was 3080: 20 65 6e 74 65 72 65 64 2e 20 20 54 68 65 20 55 entered. The U 3090: 20 63 61 72 64 20 69 73 20 74 68 65 20 6c 6f 67 card is the log 30a0: 69 6e 20 6f 66 20 74 68 65 0a 70 72 6f 67 72 61 in of the.progra 30b0: 6d 6d 65 72 20 77 68 6f 20 65 6e 74 65 72 65 64 mmer who entered 30c0: 20 74 68 69 73 20 63 68 61 6e 67 65 2e 20 20 54 this change. T 30d0: 68 65 20 5a 20 63 61 72 64 20 69 73 20 74 68 65 he Z card is the 30e0: 20 63 68 65 63 6b 73 75 6d 20 6f 76 65 72 0a 74 checksum over.t 30f0: 68 65 20 65 6e 74 69 72 65 20 61 72 74 69 66 61 he entire artifa 3100: 63 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e 0a 45 76 65 ct.</p>..<p>.Eve 3110: 72 79 20 74 69 63 6b 65 74 20 68 61 73 20 61 20 ry ticket has a 3120: 55 55 49 44 2e 20 20 54 68 65 20 74 69 63 6b 65 UUID. The ticke 3130: 74 20 74 6f 20 77 68 69 63 68 20 74 68 69 73 20 t to which this 3140: 63 68 61 6e 67 65 20 69 73 20 61 70 70 6c 69 65 change is applie 3150: 64 0a 69 73 20 73 70 65 63 69 66 69 65 64 20 62 d.is specified b 3160: 79 20 74 68 65 20 4b 20 63 61 72 64 2e 20 20 41 y the K card. A 3170: 20 74 69 63 6b 65 74 20 65 78 69 73 74 73 20 69 ticket exists i 3180: 66 20 69 74 20 63 6f 6e 74 61 69 6e 73 20 6f 6e f it contains on 3190: 65 20 6f 72 0a 6d 6f 72 65 20 63 68 61 6e 67 65 e or.more change 31a0: 73 2e 20 20 54 68 65 20 66 69 72 73 74 20 22 63 s. The first "c 31b0: 68 61 6e 67 65 22 20 74 6f 20 61 20 74 69 63 6b hange" to a tick 31c0: 65 74 20 69 73 20 77 68 61 74 20 62 72 69 6e 67 et is what bring 31d0: 73 20 74 68 65 0a 74 69 63 6b 65 74 20 69 6e 74 s the.ticket int 31e0: 6f 20 65 78 69 73 74 61 6e 63 65 2e 3c 2f 70 3e o existance.</p> 31f0: 0a 0a 3c 70 3e 0a 4a 20 63 61 72 64 73 20 73 70 ..<p>.J cards sp 3200: 65 63 69 66 79 20 63 68 61 6e 67 65 73 20 74 6f ecify changes to 3210: 20 22 66 69 65 6c 64 73 22 20 6f 66 20 74 68 65 "fields" of the 3220: 20 74 69 63 6b 65 74 2e 20 20 45 61 63 68 20 66 ticket. Each f 3230: 6f 73 73 69 6c 0a 73 65 72 76 65 72 20 68 61 73 ossil.server has 3240: 20 61 20 74 69 63 6b 65 74 20 63 6f 6e 66 69 67 a ticket config 3250: 75 72 61 74 69 6f 6e 20 77 68 69 63 68 20 73 70 uration which sp 3260: 65 63 69 66 69 65 73 20 74 68 65 20 66 69 65 6c ecifies the fiel 3270: 64 73 20 69 74 73 0a 75 6e 64 65 72 73 74 61 6e ds its.understan 3280: 64 73 2e 20 20 54 68 69 73 20 69 73 20 6e 6f 74 ds. This is not 3290: 20 61 20 6c 69 6d 69 74 20 6f 6e 20 74 68 65 20 a limit on the 32a0: 66 69 65 6c 64 73 20 74 68 61 74 20 63 61 6e 20 fields that can 32b0: 61 70 70 65 61 72 0a 6f 6e 20 74 68 65 20 4a 20 appear.on the J 32c0: 63 61 72 64 73 2c 20 68 6f 77 65 76 65 72 2e 20 cards, however. 32d0: 20 49 66 20 61 20 4a 20 63 61 72 64 20 73 70 65 If a J card spe 32e0: 63 69 66 69 65 73 20 61 20 66 69 65 6c 64 20 74 cifies a field t 32f0: 68 61 74 20 61 0a 70 61 72 74 69 63 75 6c 61 72 hat a.particular 3300: 20 66 6f 73 73 69 6c 20 73 65 72 76 65 72 20 64 fossil server d 3310: 6f 65 73 20 6e 6f 74 20 72 65 63 6f 67 6e 69 7a oes not recogniz 3320: 65 2c 20 74 68 65 6e 20 74 68 61 74 20 4a 20 63 e, then that J c 3330: 61 72 64 0a 69 73 20 73 69 6d 70 6c 79 20 69 67 ard.is simply ig 3340: 6e 6f 72 65 64 2e 3c 2f 70 3e 0a 0a 3c 70 3e 0a nored.</p>..<p>. 3350: 54 68 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 The first argume 3360: 6e 74 20 6f 66 20 74 68 65 20 4a 20 63 61 72 64 nt of the J card 3370: 20 69 73 20 74 68 65 20 66 69 65 6c 64 20 6e 61 is the field na 3380: 6d 65 2e 20 20 54 68 65 20 73 65 63 6f 6e 64 0a me. The second. 3390: 76 61 6c 75 65 20 69 73 20 74 68 65 20 66 69 65 value is the fie 33a0: 6c 64 20 76 61 6c 75 65 2e 20 20 49 66 20 74 68 ld value. If th 33b0: 65 20 66 69 65 6c 64 20 6e 61 6d 65 20 62 65 67 e field name beg 33c0: 69 6e 73 20 77 69 74 68 20 22 2b 22 20 74 68 65 ins with "+" the 33d0: 6e 0a 74 68 65 20 76 61 6c 75 65 20 69 73 20 61 n.the value is a 33e0: 70 70 65 6e 64 65 64 20 74 6f 20 74 68 65 20 70 ppended to the p 33f0: 72 69 6f 72 20 76 61 6c 75 65 2e 20 20 4f 74 68 rior value. Oth 3400: 65 72 77 69 73 65 2c 20 74 68 65 20 76 61 6c 75 erwise, the valu 3410: 65 0a 6f 6e 20 74 68 65 20 4a 20 63 61 72 64 20 e.on the J card 3420: 72 65 70 6c 61 63 65 73 20 61 6e 79 20 70 72 65 replaces any pre 3430: 76 69 6f 75 73 20 76 61 6c 75 65 20 6f 66 20 74 vious value of t 3440: 68 65 20 66 69 65 6c 64 2e 0a 54 68 65 20 66 69 he field..The fi 3450: 65 6c 64 20 6e 61 6d 65 20 61 6e 64 20 76 61 6c eld name and val 3460: 75 65 20 61 72 65 20 62 6f 74 68 20 65 6e 63 6f ue are both enco 3470: 64 65 64 20 75 73 69 6e 67 20 74 68 65 20 63 68 ded using the ch 3480: 61 72 61 63 74 65 72 0a 65 73 63 61 70 65 73 20 aracter.escapes 3490: 64 65 66 69 6e 65 64 20 66 6f 72 20 74 68 65 20 defined for the 34a0: 43 20 63 61 72 64 20 6f 66 20 61 20 6d 61 6e 69 C card of a mani 34b0: 66 65 73 74 2e 0a 3c 2f 70 3e 0a fest..</p>.