Artifact 3dee4db54116dbd050542b2a07254c39c211bc69:
File www/fileformat.wiki part of check-in [6ecc392f1c] - Updated documentation to indicate that bug-tracking is now available. Preliminary documentation on bug-tracking. (Much more documentation is needed - also need documentation on how the wiki works.) by drh on 2008-07-20 17:37:10.
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 68 32 3e 31 2e 30 20 l.</p>..<h2>1.0 0510: 54 68 65 20 4d 61 6e 69 66 65 73 74 3c 2f 68 32 The Manifest</h2 0520: 3e 0a 0a 3c 70 3e 41 20 6d 61 6e 69 66 65 73 74 >..<p>A manifest 0530: 20 64 65 66 69 6e 65 73 20 61 20 62 61 73 65 6c defines a basel 0540: 69 6e 65 20 6f 72 20 76 65 72 73 69 6f 6e 20 6f ine or version o 0550: 66 20 74 68 65 20 70 72 6f 6a 65 63 74 0a 73 6f f the project.so 0560: 75 72 63 65 20 74 72 65 65 2e 20 20 54 68 65 20 urce tree. The 0570: 6d 61 6e 69 66 65 73 74 20 63 6f 6e 74 61 69 6e manifest contain 0580: 73 20 61 20 6c 69 73 74 20 6f 66 20 61 72 74 69 s a list of arti 0590: 66 61 63 74 73 20 66 6f 72 0a 65 61 63 68 20 66 facts for.each f 05a0: 69 6c 65 20 69 6e 20 74 68 65 20 70 72 6f 6a 65 ile in the proje 05b0: 63 74 20 61 6e 64 20 74 68 65 20 63 6f 72 72 65 ct and the corre 05c0: 73 70 6f 6e 64 69 6e 67 20 66 69 6c 65 6e 61 6d sponding filenam 05d0: 65 73 2c 20 61 73 0a 77 65 6c 6c 20 61 73 20 69 es, as.well as i 05e0: 6e 66 6f 72 6d 61 74 69 6f 6e 20 73 75 63 68 20 nformation such 05f0: 61 73 20 70 61 72 65 6e 74 20 62 61 73 65 6c 69 as parent baseli 0600: 6e 65 73 2c 20 74 68 65 20 6e 61 6d 65 20 6f 66 nes, the name of 0610: 20 74 68 65 0a 70 72 6f 67 72 61 6d 6d 65 72 20 the.programmer 0620: 77 68 6f 20 63 72 65 61 74 65 64 20 74 68 65 20 who created the 0630: 62 61 73 65 6c 69 6e 65 2c 20 74 68 65 20 64 61 baseline, the da 0640: 74 65 20 61 6e 64 20 74 69 6d 65 20 77 68 65 6e te and time when 0650: 0a 74 68 65 20 62 61 73 65 6c 69 6e 65 20 77 61 .the baseline wa 0660: 73 20 63 72 65 61 74 65 64 2c 20 61 6e 64 20 61 s created, and a 0670: 6e 79 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d 6d ny check-in comm 0680: 65 6e 74 73 20 61 73 73 6f 63 69 61 74 65 64 0a ents associated. 0690: 77 69 74 68 20 74 68 65 20 62 61 73 65 6c 69 6e with the baselin 06a0: 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 0a 41 6e 79 20 e.</p>..<p>.Any 06b0: 61 72 74 69 66 61 63 74 20 69 6e 20 74 68 65 20 artifact in the 06c0: 72 65 70 6f 73 69 74 6f 72 79 20 74 68 61 74 20 repository that 06d0: 66 6f 6c 6c 6f 77 73 20 74 68 65 20 73 79 6e 74 follows the synt 06e0: 61 63 74 69 63 20 72 75 6c 65 73 0a 6f 66 20 61 actic rules.of a 06f0: 20 6d 61 6e 69 66 65 73 74 20 69 73 20 61 20 6d manifest is a m 0700: 61 6e 69 66 65 73 74 2e 20 20 4e 6f 74 65 20 74 anifest. Note t 0710: 68 61 74 20 61 20 6d 61 6e 69 66 65 73 74 20 63 hat a manifest c 0720: 61 6e 0a 62 65 20 62 6f 74 68 20 61 20 72 65 61 an.be both a rea 0730: 6c 20 6d 61 6e 69 66 65 73 74 20 61 6e 64 20 61 l manifest and a 0740: 6c 73 6f 20 61 20 63 6f 6e 74 65 6e 74 20 66 69 lso a content fi 0750: 6c 65 2c 20 74 68 6f 75 67 68 20 74 68 69 73 0a le, though this. 0760: 69 73 20 72 61 72 65 2e 0a 3c 2f 70 3e 0a 0a 3c is rare..</p>..< 0770: 70 3e 0a 41 20 6d 61 6e 69 66 65 73 74 20 69 73 p>.A manifest is 0780: 20 61 20 74 65 78 74 20 66 69 6c 65 2e 20 20 4e a text file. N 0790: 65 77 6c 69 6e 65 20 63 68 61 72 61 63 74 65 72 ewline character 07a0: 73 0a 28 41 53 43 49 49 20 30 78 30 61 29 20 73 s.(ASCII 0x0a) s 07b0: 65 70 61 72 61 74 65 20 74 68 65 20 66 69 6c 65 eparate the file 07c0: 20 69 6e 74 6f 20 22 63 61 72 64 73 22 2e 0a 45 into "cards"..E 07d0: 61 63 68 20 63 61 72 64 20 62 65 67 69 6e 73 20 ach card begins 07e0: 77 69 74 68 20 61 20 73 69 6e 67 6c 65 0a 63 68 with a single.ch 07f0: 61 72 61 63 74 65 72 20 22 63 61 72 64 20 74 79 aracter "card ty 0800: 70 65 22 2e 20 20 5a 65 72 6f 20 6f 72 20 6d 6f pe". Zero or mo 0810: 72 65 20 61 72 67 75 6d 65 6e 74 73 20 6d 61 79 re arguments may 0820: 20 66 6f 6c 6c 6f 77 0a 74 68 65 20 63 61 72 64 follow.the card 0830: 20 74 79 70 65 2e 20 20 41 6c 6c 20 61 72 67 75 type. All argu 0840: 6d 65 6e 74 73 20 61 72 65 20 73 65 70 61 72 61 ments are separa 0850: 74 65 64 20 66 72 6f 6d 20 65 61 63 68 20 6f 74 ted from each ot 0860: 68 65 72 0a 61 6e 64 20 66 72 6f 6d 20 74 68 65 her.and from the 0870: 20 63 61 72 64 2d 74 79 70 65 20 63 68 61 72 61 card-type chara 0880: 63 74 65 72 20 62 79 20 61 20 73 69 6e 67 6c 65 cter by a single 0890: 20 73 70 61 63 65 0a 63 68 61 72 61 63 74 65 72 space.character 08a0: 2e 20 20 54 68 65 72 65 20 69 73 20 6e 6f 20 73 . There is no s 08b0: 75 72 70 6c 75 73 20 77 68 69 74 65 20 73 70 61 urplus white spa 08c0: 63 65 20 62 65 74 77 65 65 6e 20 61 72 67 75 6d ce between argum 08d0: 65 6e 74 73 0a 61 6e 64 20 6e 6f 20 6c 65 61 64 ents.and no lead 08e0: 69 6e 67 20 6f 72 20 74 72 61 69 6c 69 6e 67 20 ing or trailing 08f0: 77 68 69 74 65 73 70 61 63 65 20 65 78 63 65 70 whitespace excep 0900: 74 20 66 6f 72 20 74 68 65 20 6e 65 77 6c 69 6e t for the newlin 0910: 65 20 0a 63 68 61 72 61 63 74 65 72 20 74 68 61 e .character tha 0920: 74 20 61 63 74 73 20 61 73 20 74 68 65 20 63 61 t acts as the ca 0930: 72 64 20 73 65 70 61 72 61 74 6f 72 2e 0a 3c 2f rd separator..</ 0940: 70 3e 0a 0a 3c 70 3e 0a 41 6c 6c 20 63 61 72 64 p>..<p>.All card 0950: 73 20 6f 66 20 74 68 65 20 6d 61 6e 69 66 65 73 s of the manifes 0960: 74 20 6f 63 63 75 72 20 69 6e 20 73 74 72 69 63 t occur in stric 0970: 74 20 73 6f 72 74 65 64 20 6c 65 78 69 63 6f 67 t sorted lexicog 0980: 72 61 70 68 69 63 61 6c 20 6f 72 64 65 72 2e 0a raphical order.. 0990: 4e 6f 20 63 61 72 64 20 6d 61 79 20 62 65 20 64 No card may be d 09a0: 75 70 6c 69 63 61 74 65 64 2e 0a 54 68 65 20 65 uplicated..The e 09b0: 6e 74 69 72 65 20 6d 61 6e 69 66 65 73 74 20 6d ntire manifest m 09c0: 61 79 20 62 65 20 50 47 50 20 63 6c 65 61 72 2d ay be PGP clear- 09d0: 73 69 67 6e 65 64 2c 20 62 75 74 20 6f 74 68 65 signed, but othe 09e0: 72 77 69 73 65 20 69 74 0a 6d 61 79 20 63 6f 6e rwise it.may con 09f0: 74 61 69 6e 20 6e 6f 20 61 64 64 69 74 69 6f 6e tain no addition 0a00: 61 6c 20 74 65 78 74 20 6f 72 20 64 61 74 61 20 al text or data 0a10: 62 65 79 6f 6e 64 20 77 68 61 74 20 69 73 20 64 beyond what is d 0a20: 65 73 63 72 69 62 65 64 20 68 65 72 65 2e 0a 3c escribed here..< 0a30: 2f 70 3e 0a 0a 3c 70 3e 0a 41 6c 6c 6f 77 65 64 /p>..<p>.Allowed 0a40: 20 63 61 72 64 73 20 69 6e 20 74 68 65 20 6d 61 cards in the ma 0a50: 6e 69 66 65 73 74 20 61 72 65 20 61 73 20 66 6f nifest are as fo 0a60: 6c 6c 6f 77 73 3a 0a 3c 2f 70 3e 0a 0a 3c 62 6c llows:.</p>..<bl 0a70: 6f 63 6b 71 75 6f 74 65 3e 0a 3c 62 3e 43 3c 2f ockquote>.<b>C</ 0a80: 62 3e 20 3c 69 3e 63 68 65 63 6b 69 6e 2d 63 6f b> <i>checkin-co 0a90: 6d 6d 65 6e 74 3c 2f 69 3e 3c 62 72 3e 0a 3c 62 mment</i><br>.<b 0aa0: 3e 44 3c 2f 62 3e 20 3c 69 3e 74 69 6d 65 2d 61 >D</b> <i>time-a 0ab0: 6e 64 2d 64 61 74 65 2d 73 74 61 6d 70 3c 2f 69 nd-date-stamp</i 0ac0: 3e 3c 62 72 3e 0a 3c 62 3e 46 3c 2f 62 3e 20 3c ><br>.<b>F</b> < 0ad0: 69 3e 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 20 3c i>filename</i> < 0ae0: 69 3e 53 48 41 31 2d 68 61 73 68 3c 2f 69 3e 3c i>SHA1-hash</i>< 0af0: 62 72 3e 0a 3c 62 3e 50 3c 2f 62 3e 20 3c 69 3e br>.<b>P</b> <i> 0b00: 53 48 41 31 2d 68 61 73 68 3c 2f 69 3e 2b 3c 62 SHA1-hash</i>+<b 0b10: 72 3e 0a 3c 62 3e 52 3c 2f 62 3e 20 3c 69 3e 72 r>.<b>R</b> <i>r 0b20: 65 70 6f 73 69 74 6f 72 79 2d 63 68 65 63 6b 73 epository-checks 0b30: 75 6d 3c 2f 69 3e 3c 62 72 3e 0a 3c 62 3e 55 3c um</i><br>.<b>U< 0b40: 2f 62 3e 20 3c 69 3e 75 73 65 72 2d 6c 6f 67 69 /b> <i>user-logi 0b50: 6e 3c 2f 69 3e 3c 62 72 3e 0a 3c 62 3e 5a 3c 2f n</i><br>.<b>Z</ 0b60: 62 3e 20 3c 69 3e 6d 61 6e 69 66 65 73 74 2d 63 b> <i>manifest-c 0b70: 68 65 63 6b 73 75 6d 3c 2f 69 3e 0a 3c 2f 62 6c hecksum</i>.</bl 0b80: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 0a 41 ockquote>..<p>.A 0b90: 20 6d 61 6e 69 66 65 73 74 20 6d 75 73 74 20 68 manifest must h 0ba0: 61 76 65 20 65 78 61 63 74 6c 79 20 6f 6e 65 20 ave exactly one 0bb0: 43 2d 63 61 72 64 2e 20 20 54 68 65 20 73 6f 6c C-card. The sol 0bc0: 65 20 61 72 67 75 6d 65 6e 74 20 74 6f 0a 74 68 e argument to.th 0bd0: 65 20 43 2d 63 61 72 64 20 69 73 20 61 20 63 68 e C-card is a ch 0be0: 65 63 6b 2d 69 6e 20 63 6f 6d 6d 65 6e 74 20 74 eck-in comment t 0bf0: 68 61 74 20 64 65 73 63 72 69 62 65 73 20 74 68 hat describes th 0c00: 65 20 63 68 65 63 6b 2d 69 6e 20 74 68 61 74 0a e check-in that. 0c10: 74 68 65 20 6d 61 6e 69 66 65 73 74 20 64 65 66 the manifest def 0c20: 69 6e 65 73 2e 20 20 54 68 65 20 63 68 65 63 6b ines. The check 0c30: 2d 69 6e 20 63 6f 6d 6d 65 6e 74 20 69 73 20 74 -in comment is t 0c40: 65 78 74 2e 20 20 54 68 65 20 66 6f 6c 6c 6f 77 ext. The follow 0c50: 69 6e 67 0a 65 73 63 61 70 65 20 73 65 71 75 65 ing.escape seque 0c60: 6e 63 65 73 20 61 72 65 20 61 70 70 6c 69 65 64 nces are applied 0c70: 20 74 6f 20 74 68 65 20 74 65 78 74 3a 0a 41 20 to the text:.A 0c80: 73 70 61 63 65 20 28 41 53 43 49 49 20 30 78 32 space (ASCII 0x2 0c90: 30 29 20 69 73 20 72 65 70 72 65 73 65 6e 74 65 0) is represente 0ca0: 64 20 61 73 20 22 5c 73 22 20 28 41 53 43 49 49 d as "\s" (ASCII 0cb0: 20 30 78 35 43 2c 20 30 78 37 33 29 2e 20 20 41 0x5C, 0x73). A 0cc0: 0a 6e 65 77 6c 69 6e 65 20 28 41 53 43 49 49 20 .newline (ASCII 0cd0: 30 78 30 61 29 20 69 73 20 22 5c 6e 22 20 28 41 0x0a) is "\n" (A 0ce0: 53 43 49 49 20 30 78 36 43 2c 20 78 36 45 29 2e SCII 0x6C, x6E). 0cf0: 20 20 41 20 62 61 63 6b 73 6c 61 73 68 20 0a 28 A backslash .( 0d00: 41 53 43 49 49 20 30 78 35 43 29 20 69 73 20 72 ASCII 0x5C) is r 0d10: 65 70 72 65 73 65 6e 74 65 64 20 61 73 20 74 77 epresented as tw 0d20: 6f 20 62 61 63 6b 73 6c 61 73 68 65 73 20 22 5c o backslashes "\ 0d30: 5c 22 2e 20 20 41 70 61 72 74 20 66 72 6f 6d 0a \". Apart from. 0d40: 73 70 61 63 65 20 61 6e 64 20 6e 65 77 6c 69 6e space and newlin 0d50: 65 2c 20 6e 6f 20 6f 74 68 65 72 20 77 68 69 74 e, no other whit 0d60: 65 73 70 61 63 65 20 63 68 61 72 61 63 74 65 72 espace character 0d70: 73 20 61 72 65 20 61 6c 6c 6f 77 65 64 20 69 6e s are allowed in 0d80: 0a 74 68 65 20 63 68 65 63 6b 2d 69 6e 20 63 6f .the check-in co 0d90: 6d 6d 65 6e 74 2e 20 20 4e 6f 72 20 61 72 65 20 mment. Nor are 0da0: 61 6e 79 20 75 6e 70 72 69 6e 74 61 62 6c 65 20 any unprintable 0db0: 63 68 61 72 61 63 74 65 72 73 20 61 6c 6c 6f 77 characters allow 0dc0: 65 64 0a 69 6e 20 74 68 65 20 63 6f 6d 6d 65 6e ed.in the commen 0dd0: 74 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 41 20 6d t..</p>..<p>.A m 0de0: 61 6e 69 66 65 73 74 20 6d 75 73 74 20 68 61 76 anifest must hav 0df0: 65 20 65 78 61 63 74 6c 79 20 6f 6e 65 20 44 2d e exactly one D- 0e00: 63 61 72 64 2e 20 20 54 68 65 20 73 6f 6c 65 20 card. The sole 0e10: 61 72 67 75 6d 65 6e 74 20 74 6f 0a 74 68 65 20 argument to.the 0e20: 44 2d 63 61 72 64 20 69 73 20 61 20 64 61 74 65 D-card is a date 0e30: 2d 74 69 6d 65 20 73 74 61 6d 70 20 69 6e 20 74 -time stamp in t 0e40: 68 65 20 49 53 4f 38 36 30 31 20 66 6f 72 6d 61 he ISO8601 forma 0e50: 74 2e 20 20 54 68 65 0a 64 61 74 65 20 61 6e 64 t. The.date and 0e60: 20 74 69 6d 65 20 73 68 6f 75 6c 64 20 62 65 20 time should be 0e70: 69 6e 20 63 6f 6f 72 64 69 6e 61 74 65 64 20 75 in coordinated u 0e80: 6e 69 76 65 72 73 61 6c 20 74 69 6d 65 20 28 55 niversal time (U 0e90: 54 43 29 2e 0a 54 68 65 20 66 6f 72 6d 61 74 20 TC)..The format 0ea0: 69 73 3a 0a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b is:.</p>..<block 0eb0: 71 75 6f 74 65 3e 0a 3c 69 3e 59 59 59 59 3c 2f quote>.<i>YYYY</ 0ec0: 69 3e 3c 62 3e 2d 3c 2f 62 3e 3c 69 3e 4d 4d 3c i><b>-</b><i>MM< 0ed0: 2f 69 3e 3c 62 3e 2d 3c 2f 62 3e 3c 69 3e 44 44 /i><b>-</b><i>DD 0ee0: 3c 2f 69 3e 3c 62 3e 54 3c 2f 62 3e 3c 69 3e 48 </i><b>T</b><i>H 0ef0: 48 3c 2f 69 3e 3c 62 3e 3a 3c 2f 62 3e 3c 69 3e H</i><b>:</b><i> 0f00: 4d 4d 3c 2f 69 3e 3c 62 3e 3a 3c 2f 62 3e 3c 69 MM</i><b>:</b><i 0f10: 3e 53 53 3c 2f 69 3e 0a 3c 2f 62 6c 6f 63 6b 71 >SS</i>.</blockq 0f20: 75 6f 74 65 3e 0a 0a 3c 70 3e 0a 41 20 6d 61 6e uote>..<p>.A man 0f30: 69 66 65 73 74 20 68 61 73 20 7a 65 72 6f 20 6f ifest has zero o 0f40: 72 20 6d 6f 72 65 20 46 2d 63 61 72 64 73 2e 20 r more F-cards. 0f50: 20 45 61 63 68 20 46 2d 63 61 72 64 20 64 65 66 Each F-card def 0f60: 69 6e 65 73 20 61 20 66 69 6c 65 0a 28 6f 74 68 ines a file.(oth 0f70: 65 72 20 74 68 61 6e 20 74 68 65 20 6d 61 6e 69 er than the mani 0f80: 66 65 73 74 20 69 74 73 65 6c 66 29 20 77 68 69 fest itself) whi 0f90: 63 68 20 69 73 20 70 61 72 74 20 6f 66 20 74 68 ch is part of th 0fa0: 65 20 62 61 73 65 6c 69 6e 65 20 74 68 61 74 0a e baseline that. 0fb0: 74 68 65 20 6d 61 6e 69 66 65 73 74 20 64 65 66 the manifest def 0fc0: 69 6e 65 73 2e 20 20 54 68 65 72 65 20 61 72 65 ines. There are 0fd0: 20 74 77 6f 20 61 72 67 75 6d 65 6e 74 73 2e 20 two arguments. 0fe0: 20 54 68 65 20 66 69 72 73 74 20 61 72 67 6d 65 The first argme 0ff0: 6e 74 0a 69 73 20 74 68 65 20 70 61 74 68 6e 61 nt.is the pathna 1000: 6d 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 69 me of the file i 1010: 6e 20 74 68 65 20 62 61 73 65 6c 69 6e 65 20 72 n the baseline r 1020: 65 6c 61 74 69 76 65 20 74 6f 20 74 68 65 20 72 elative to the r 1030: 6f 6f 74 0a 6f 66 20 74 68 65 20 70 72 6f 6a 65 oot.of the proje 1040: 63 74 20 66 69 6c 65 20 68 69 65 72 61 72 63 68 ct file hierarch 1050: 79 2e 20 20 4e 6f 20 22 2e 2e 22 20 6f 72 20 22 y. No ".." or " 1060: 2e 22 20 64 69 72 65 63 74 6f 72 69 65 73 20 61 ." directories a 1070: 72 65 20 61 6c 6c 6f 77 65 64 0a 77 69 74 68 69 re allowed.withi 1080: 6e 20 74 68 65 20 66 69 6c 65 6e 61 6d 65 2e 20 n the filename. 1090: 20 53 70 61 63 65 20 63 68 61 72 61 63 74 65 72 Space character 10a0: 73 20 61 72 65 20 65 73 63 61 70 65 64 20 61 73 s are escaped as 10b0: 20 69 6e 20 43 2d 63 61 72 64 0a 63 6f 6d 6d 65 in C-card.comme 10c0: 6e 74 20 74 65 78 74 2e 20 20 42 61 63 6b 73 6c nt text. Backsl 10d0: 61 73 68 20 63 68 61 72 61 63 74 65 72 73 20 61 ash characters a 10e0: 6e 64 20 6e 65 77 6c 69 6e 65 73 20 61 72 65 20 nd newlines are 10f0: 6e 6f 74 20 61 6c 6c 6f 77 65 64 0a 77 69 74 68 not allowed.with 1100: 69 6e 20 66 69 6c 65 6e 61 6d 65 73 2e 20 20 54 in filenames. T 1110: 68 65 20 64 69 72 65 63 74 6f 72 79 20 73 65 70 he directory sep 1120: 61 72 61 74 6f 72 20 63 68 61 72 61 63 74 65 72 arator character 1130: 20 69 73 20 61 20 66 6f 72 77 61 72 64 0a 73 6c is a forward.sl 1140: 61 73 68 20 28 41 53 43 49 49 20 30 78 32 46 29 ash (ASCII 0x2F) 1150: 2e 20 20 54 68 65 20 73 65 63 6f 6e 64 20 61 72 . The second ar 1160: 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 46 2d gument to the F- 1170: 63 61 72 64 20 69 73 20 74 68 65 0a 66 75 6c 6c card is the.full 1180: 20 34 30 2d 63 68 61 72 61 63 74 65 72 20 6c 6f 40-character lo 1190: 77 65 72 2d 63 61 73 65 20 68 65 78 61 64 65 63 wer-case hexadec 11a0: 69 6d 61 6c 20 53 48 41 31 20 68 61 73 68 20 6f imal SHA1 hash o 11b0: 66 20 74 68 65 20 63 6f 6e 74 65 6e 74 0a 61 72 f the content.ar 11c0: 74 69 66 61 63 74 2e 0a 3c 2f 70 3e 0a 0a 3c 70 tifact..</p>..<p 11d0: 3e 0a 41 20 6d 61 6e 69 66 65 73 74 20 68 61 73 >.A manifest has 11e0: 20 7a 65 72 6f 20 6f 72 20 6f 6e 65 20 50 2d 63 zero or one P-c 11f0: 61 72 64 73 2e 20 20 4d 6f 73 74 20 6d 61 6e 69 ards. Most mani 1200: 66 65 73 74 73 20 68 61 76 65 20 6f 6e 65 20 50 fests have one P 1210: 2d 63 61 72 64 2e 0a 54 68 65 20 50 2d 63 61 72 -card..The P-car 1220: 64 20 68 61 73 20 61 20 76 61 72 79 69 6e 67 20 d has a varying 1230: 6e 75 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65 number of argume 1240: 6e 74 73 20 74 68 61 74 0a 64 65 66 69 6e 65 73 nts that.defines 1250: 20 6f 74 68 65 72 20 6d 61 6e 69 66 65 73 74 73 other manifests 1260: 20 66 72 6f 6d 20 77 68 69 63 68 20 74 68 65 20 from which the 1270: 63 75 72 72 65 6e 74 20 6d 61 6e 69 66 65 73 74 current manifest 1280: 0a 69 73 20 64 65 72 69 76 65 64 2e 20 20 45 61 .is derived. Ea 1290: 63 68 20 61 72 67 75 6d 65 6e 74 20 69 73 20 61 ch argument is a 12a0: 6e 20 34 30 2d 63 68 61 72 61 63 74 65 72 20 6c n 40-character l 12b0: 6f 77 65 72 63 61 73 65 20 0a 68 65 78 61 64 65 owercase .hexade 12c0: 63 69 6d 61 6c 20 53 48 41 31 20 6f 66 20 74 68 cimal SHA1 of th 12d0: 65 20 70 72 65 64 65 63 65 73 73 6f 72 20 6d 61 e predecessor ma 12e0: 6e 69 66 65 73 74 2e 20 20 41 6c 6c 20 61 72 67 nifest. All arg 12f0: 75 6d 65 6e 74 73 0a 74 6f 20 74 68 65 20 50 2d uments.to the P- 1300: 63 61 72 64 20 6d 75 73 74 20 62 65 20 75 6e 69 card must be uni 1310: 71 75 65 20 74 6f 20 74 68 61 74 20 6c 69 6e 65 que to that line 1320: 2e 0a 54 68 65 20 66 69 72 73 74 20 70 72 65 64 ..The first pred 1330: 65 63 65 73 73 6f 72 20 69 73 20 74 68 65 20 64 ecessor is the d 1340: 69 72 65 63 74 20 61 6e 63 65 73 74 6f 72 20 6f irect ancestor o 1350: 66 20 74 68 65 20 6d 61 6e 69 66 65 73 74 2e 0a f the manifest.. 1360: 4f 74 68 65 72 20 61 72 67 75 6d 65 6e 74 73 20 Other arguments 1370: 64 65 66 69 6e 65 20 6d 61 6e 69 66 65 73 74 73 define manifests 1380: 20 77 69 74 68 20 77 68 69 63 68 20 74 68 65 20 with which the 1390: 66 69 72 73 74 20 77 61 73 0a 6d 65 72 67 65 64 first was.merged 13a0: 20 74 6f 20 79 69 65 6c 64 20 74 68 65 20 63 75 to yield the cu 13b0: 72 72 65 6e 74 20 6d 61 6e 69 66 65 73 74 2e 20 rrent manifest. 13c0: 20 4d 6f 73 74 20 6d 61 6e 69 66 65 73 74 73 20 Most manifests 13d0: 68 61 76 65 0a 61 20 50 2d 63 61 72 64 20 77 69 have.a P-card wi 13e0: 74 68 20 61 20 73 69 6e 67 6c 65 20 61 72 67 75 th a single argu 13f0: 6d 65 6e 74 2e 20 20 54 68 65 20 66 69 72 73 74 ment. The first 1400: 20 6d 61 6e 69 66 65 73 74 20 69 6e 20 74 68 65 manifest in the 1410: 0a 70 72 6f 6a 65 63 74 20 68 61 73 20 6e 6f 20 .project has no 1420: 61 6e 63 65 73 74 6f 72 73 20 61 6e 64 20 74 68 ancestors and th 1430: 75 73 20 68 61 73 20 6e 6f 20 50 2d 63 61 72 64 us has no P-card 1440: 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 41 20 6d 61 ..</p>..<p>.A ma 1450: 6e 69 66 65 73 74 20 6d 61 79 20 6f 70 74 69 6f nifest may optio 1460: 6e 61 6c 6c 79 20 68 61 76 65 20 61 20 73 69 6e nally have a sin 1470: 67 6c 65 20 52 2d 63 61 72 64 2e 20 20 54 68 65 gle R-card. The 1480: 20 52 2d 63 61 72 64 20 68 61 73 0a 61 20 73 69 R-card has.a si 1490: 6e 67 6c 65 20 61 72 67 75 6d 65 6e 74 20 77 68 ngle argument wh 14a0: 69 63 68 20 69 73 20 74 68 65 20 4d 44 35 20 63 ich is the MD5 c 14b0: 68 65 63 6b 73 75 6d 20 6f 66 20 61 6c 6c 20 66 hecksum of all f 14c0: 69 6c 65 73 20 69 6e 20 0a 74 68 65 20 62 61 73 iles in .the bas 14d0: 65 6c 69 6e 65 20 65 78 63 65 70 74 20 74 68 65 eline except the 14e0: 20 6d 61 6e 69 66 65 73 74 20 69 74 73 65 6c 66 manifest itself 14f0: 2e 20 20 54 68 65 20 63 68 65 63 6b 73 75 6d 20 . The checksum 1500: 69 73 20 65 78 70 72 65 73 73 65 64 0a 61 73 20 is expressed.as 1510: 33 32 2d 63 68 61 72 61 63 74 65 72 73 20 6f 66 32-characters of 1520: 20 6c 6f 77 65 72 63 61 73 65 20 68 65 78 61 64 lowercase hexad 1530: 65 63 69 6d 61 6c 2e 20 20 20 54 68 65 20 63 68 ecimal. The ch 1540: 65 63 6b 73 75 6d 20 69 73 0a 63 6f 6d 70 75 74 ecksum is.comput 1550: 65 64 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 20 20 ed as follows: 1560: 46 6f 72 20 65 61 63 68 20 66 69 6c 65 20 69 6e For each file in 1570: 20 74 68 65 20 62 61 73 65 6c 69 6e 65 20 28 65 the baseline (e 1580: 78 63 65 70 74 20 66 6f 72 0a 74 68 65 20 6d 61 xcept for.the ma 1590: 6e 69 66 65 73 74 20 69 74 73 65 6c 66 29 20 69 nifest itself) i 15a0: 6e 20 73 74 72 69 63 74 20 73 6f 72 74 65 64 20 n strict sorted 15b0: 6c 65 78 69 63 6f 67 72 61 70 68 69 63 61 6c 20 lexicographical 15c0: 6f 72 64 65 72 2c 20 0a 74 61 6b 65 20 74 68 65 order, .take the 15d0: 20 70 61 74 68 6e 61 6d 65 20 6f 66 20 74 68 65 pathname of the 15e0: 20 66 69 6c 65 20 72 65 6c 61 74 69 76 65 20 74 file relative t 15f0: 6f 20 74 68 65 20 72 6f 6f 74 20 6f 66 20 74 68 o the root of th 1600: 65 0a 72 65 70 6f 73 69 74 6f 72 79 2c 20 61 70 e.repository, ap 1610: 70 65 6e 64 20 61 20 73 69 6e 67 6c 65 20 73 70 pend a single sp 1620: 61 63 65 20 28 41 53 43 49 49 20 30 78 32 30 29 ace (ASCII 0x20) 1630: 2c 20 74 68 65 0a 73 69 7a 65 20 6f 66 20 74 68 , the.size of th 1640: 65 20 66 69 6c 65 20 69 6e 20 41 53 43 49 49 20 e file in ASCII 1650: 64 65 63 69 6d 61 6c 2c 20 61 20 73 69 6e 67 6c decimal, a singl 1660: 65 20 6e 65 77 6c 69 6e 65 0a 63 68 61 72 61 63 e newline.charac 1670: 74 65 72 20 28 41 53 43 49 49 20 30 78 30 41 29 ter (ASCII 0x0A) 1680: 2c 20 61 6e 64 20 74 68 65 20 63 6f 6d 70 6c 65 , and the comple 1690: 74 65 20 74 65 78 74 20 6f 66 20 74 68 65 20 66 te text of the f 16a0: 69 6c 65 2e 0a 43 6f 6d 70 75 74 65 20 74 68 65 ile..Compute the 16b0: 20 4d 44 35 20 63 68 65 63 6b 73 75 6d 20 6f 66 MD5 checksum of 16c0: 20 74 68 65 20 74 68 65 20 72 65 73 75 6c 74 2e the the result. 16d0: 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 45 61 63 68 20 .</p>..<p>.Each 16e0: 6d 61 6e 69 66 65 73 74 20 68 61 73 20 61 20 73 manifest has a s 16f0: 69 6e 67 6c 65 20 55 2d 63 61 72 64 2e 20 20 54 ingle U-card. T 1700: 68 65 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 he argument to t 1710: 68 65 20 55 2d 63 61 72 64 20 69 73 0a 74 68 65 he U-card is.the 1720: 20 6c 6f 67 69 6e 20 6f 66 20 74 68 65 20 75 73 login of the us 1730: 65 72 20 77 68 6f 20 63 72 65 61 74 65 64 20 74 er who created t 1740: 68 65 20 6d 61 6e 69 66 65 73 74 2e 20 20 54 68 he manifest. Th 1750: 65 20 6c 6f 67 69 6e 20 6e 61 6d 65 0a 69 73 20 e login name.is 1760: 65 6e 63 6f 64 65 64 20 75 73 69 6e 67 20 74 68 encoded using th 1770: 65 20 73 61 6d 65 20 63 68 61 72 61 63 74 65 72 e same character 1780: 20 65 73 63 61 70 65 73 20 61 73 20 69 73 20 75 escapes as is u 1790: 73 65 64 20 66 6f 72 20 74 68 65 0a 63 68 65 63 sed for the.chec 17a0: 6b 2d 69 6e 20 63 6f 6d 6d 65 6e 74 20 61 72 67 k-in comment arg 17b0: 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 43 2d 63 ument to the C-c 17c0: 61 72 64 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 41 ard..</p>..<p>.A 17d0: 20 6d 61 6e 69 66 65 73 74 20 68 61 73 20 61 6e manifest has an 17e0: 20 6f 70 74 69 6f 6e 20 5a 2d 63 61 72 64 20 61 option Z-card a 17f0: 73 20 69 74 73 20 6c 61 73 74 20 6c 69 6e 65 2e s its last line. 1800: 20 20 54 68 65 20 61 72 67 75 6d 65 6e 74 0a 74 The argument.t 1810: 6f 20 74 68 65 20 5a 2d 63 61 72 64 20 69 73 20 o the Z-card is 1820: 61 20 33 32 2d 63 68 61 72 61 63 74 65 72 20 6c a 32-character l 1830: 6f 77 65 72 63 61 73 65 20 68 65 78 61 64 65 63 owercase hexadec 1840: 69 6d 61 6c 20 4d 44 35 20 68 61 73 68 0a 6f 66 imal MD5 hash.of 1850: 20 61 6c 6c 20 70 72 69 6f 72 20 6c 69 6e 65 73 all prior lines 1860: 20 6f 66 20 74 68 65 20 6d 61 6e 69 66 65 73 74 of the manifest 1870: 20 75 70 20 74 6f 20 61 6e 64 20 69 6e 63 6c 75 up to and inclu 1880: 64 69 6e 67 20 74 68 65 20 6e 65 77 6c 69 6e 65 ding the newline 1890: 20 0a 63 68 61 72 61 63 74 65 72 20 74 68 61 74 .character that 18a0: 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 70 72 65 immediately pre 18b0: 63 65 65 64 73 20 74 68 65 20 22 5a 22 2e 20 20 ceeds the "Z". 18c0: 54 68 65 20 5a 2d 63 61 72 64 20 69 73 20 6a 75 The Z-card is ju 18d0: 73 74 0a 61 20 73 61 6e 69 74 79 20 63 68 65 63 st.a sanity chec 18e0: 6b 20 74 6f 20 70 72 6f 76 65 20 74 68 61 74 20 k to prove that 18f0: 74 68 65 20 6d 61 6e 69 66 65 73 74 20 69 73 20 the manifest is 1900: 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 61 6e 64 0a well-formed and. 1910: 63 6f 6e 73 69 73 74 65 6e 74 2e 0a 3c 2f 70 3e consistent..</p> 1920: 0a 0a 3c 68 32 3e 32 2e 30 20 43 6c 75 73 74 65 ..<h2>2.0 Cluste 1930: 72 73 3c 2f 68 32 3e 0a 0a 3c 70 3e 0a 41 20 63 rs</h2>..<p>.A c 1940: 6c 75 73 74 65 72 20 69 73 20 61 20 61 72 74 69 luster is a arti 1950: 66 61 63 74 20 74 68 61 74 20 64 65 63 6c 61 72 fact that declar 1960: 65 73 20 74 68 65 20 65 78 69 73 74 61 6e 63 65 es the existance 1970: 20 6f 66 20 6f 74 68 65 72 20 61 72 74 69 66 61 of other artifa 1980: 63 74 73 2e 0a 43 6c 75 73 74 65 72 73 20 61 72 cts..Clusters ar 1990: 65 20 75 73 65 64 20 64 75 72 69 6e 67 20 72 65 e used during re 19a0: 70 6f 73 69 74 6f 72 79 20 73 79 6e 63 68 72 6f pository synchro 19b0: 6e 69 7a 61 74 69 6f 6e 20 74 6f 20 68 65 6c 70 nization to help 19c0: 20 0a 72 65 64 75 63 65 20 6e 65 74 77 6f 72 6b .reduce network 19d0: 20 74 72 61 66 66 69 63 2e 20 20 41 73 20 73 75 traffic. As su 19e0: 63 68 2c 20 63 6c 75 73 74 65 72 73 20 61 72 65 ch, clusters are 19f0: 20 61 6e 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e an optimization 1a00: 20 61 6e 64 0a 6d 61 79 20 62 65 20 72 65 6d 6f and.may be remo 1a10: 76 65 64 20 66 72 6f 6d 20 61 20 72 65 70 6f 73 ved from a repos 1a20: 69 74 6f 72 79 20 77 69 74 68 6f 75 74 20 6c 6f itory without lo 1a30: 73 73 20 6f 72 20 64 61 6d 61 67 65 20 74 6f 20 ss or damage to 1a40: 74 68 65 0a 75 6e 64 65 72 6c 79 69 6e 67 20 70 the.underlying p 1a50: 72 6f 6a 65 63 74 20 63 6f 64 65 2e 0a 3c 2f 70 roject code..</p 1a60: 3e 0a 0a 3c 70 3e 0a 43 6c 75 73 74 65 72 73 20 >..<p>.Clusters 1a70: 66 6f 6c 6c 6f 77 20 61 20 73 79 6e 74 61 78 20 follow a syntax 1a80: 74 68 61 74 20 69 73 20 76 65 72 79 20 73 69 6d that is very sim 1a90: 69 6c 61 72 20 74 6f 20 6d 61 6e 69 66 65 73 74 ilar to manifest 1aa0: 73 2e 0a 41 20 43 6c 75 73 74 65 72 20 69 73 20 s..A Cluster is 1ab0: 61 20 6c 69 6e 65 2d 6f 72 69 65 6e 74 65 64 20 a line-oriented 1ac0: 74 65 78 74 20 66 69 6c 65 2e 20 20 4e 65 77 6c text file. Newl 1ad0: 69 6e 65 20 63 68 61 72 61 63 74 65 72 73 0a 28 ine characters.( 1ae0: 41 53 43 49 49 20 30 78 30 61 29 20 73 65 70 61 ASCII 0x0a) sepa 1af0: 72 61 74 65 20 74 68 65 20 61 72 74 69 66 61 63 rate the artifac 1b00: 74 20 69 6e 74 6f 20 63 61 72 64 73 2e 20 20 45 t into cards. E 1b10: 61 63 68 20 63 61 72 64 20 62 65 67 69 6e 73 20 ach card begins 1b20: 77 69 74 68 20 61 20 73 69 6e 67 6c 65 0a 63 68 with a single.ch 1b30: 61 72 61 63 74 65 72 20 22 63 61 72 64 20 74 79 aracter "card ty 1b40: 70 65 22 2e 20 20 5a 65 72 6f 20 6f 72 20 6d 6f pe". Zero or mo 1b50: 72 65 20 61 72 67 75 6d 65 6e 74 73 20 6d 61 79 re arguments may 1b60: 20 66 6f 6c 6c 6f 77 0a 74 68 65 20 63 61 72 64 follow.the card 1b70: 20 74 79 70 65 2e 20 20 41 6c 6c 20 61 72 67 75 type. All argu 1b80: 6d 65 6e 74 73 20 61 72 65 20 73 65 70 61 72 61 ments are separa 1b90: 74 65 64 20 66 72 6f 6d 20 65 61 63 68 20 6f 74 ted from each ot 1ba0: 68 65 72 0a 61 6e 64 20 66 72 6f 6d 20 74 68 65 her.and from the 1bb0: 20 63 61 72 64 2d 74 79 70 65 20 63 68 61 72 61 card-type chara 1bc0: 63 74 65 72 20 62 79 20 61 20 73 69 6e 67 6c 65 cter by a single 1bd0: 20 73 70 61 63 65 0a 63 68 61 72 61 63 74 65 72 space.character 1be0: 2e 20 20 54 68 65 72 65 20 69 73 20 6e 6f 20 73 . There is no s 1bf0: 75 72 70 6c 75 73 20 77 68 69 74 65 20 73 70 61 urplus white spa 1c00: 63 65 20 62 65 74 77 65 65 6e 20 61 72 67 75 6d ce between argum 1c10: 65 6e 74 73 0a 61 6e 64 20 6e 6f 20 6c 65 61 64 ents.and no lead 1c20: 69 6e 67 20 6f 72 20 74 72 61 69 6c 69 6e 67 20 ing or trailing 1c30: 77 68 69 74 65 73 70 61 63 65 20 65 78 63 65 70 whitespace excep 1c40: 74 20 66 6f 72 20 74 68 65 20 6e 65 77 6c 69 6e t for the newlin 1c50: 65 20 0a 63 68 61 72 61 63 74 65 72 20 74 68 61 e .character tha 1c60: 74 20 61 63 74 73 20 61 73 20 74 68 65 20 63 61 t acts as the ca 1c70: 72 64 20 73 65 70 61 72 61 74 6f 72 2e 0a 41 6c rd separator..Al 1c80: 6c 20 63 61 72 64 73 20 6f 66 20 61 20 63 6c 75 l cards of a clu 1c90: 74 65 72 20 6f 63 63 75 72 20 69 6e 20 73 74 72 ter occur in str 1ca0: 69 63 74 20 73 6f 72 74 65 64 20 6c 65 78 69 63 ict sorted lexic 1cb0: 6f 67 72 61 70 68 69 63 61 6c 20 6f 72 64 65 72 ographical order 1cc0: 2e 0a 4e 6f 20 63 61 72 64 20 6d 61 79 20 62 65 ..No card may be 1cd0: 20 64 75 70 6c 69 63 61 74 65 64 2e 0a 54 68 65 duplicated..The 1ce0: 20 63 6c 75 73 74 65 72 20 6d 61 79 20 6e 6f 74 cluster may not 1cf0: 20 63 6f 6e 74 61 69 6e 20 61 64 64 69 74 69 6f contain additio 1d00: 6e 61 6c 20 74 65 78 74 20 6f 72 20 64 61 74 61 nal text or data 1d10: 20 62 65 79 6f 6e 64 20 0a 77 68 61 74 20 69 73 beyond .what is 1d20: 20 64 65 73 63 72 69 62 65 64 20 68 65 72 65 2e described here. 1d30: 0a 55 6e 6c 69 6b 65 20 6d 61 6e 69 66 65 73 74 .Unlike manifest 1d40: 73 2c 20 63 6c 75 73 74 65 72 73 20 61 72 65 20 s, clusters are 1d50: 6e 65 76 65 72 20 50 47 50 20 73 69 67 6e 65 64 never PGP signed 1d60: 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 41 6c 6c 6f ..</p>..<p>.Allo 1d70: 77 65 64 20 63 61 72 64 73 20 69 6e 20 74 68 65 wed cards in the 1d80: 20 63 6c 75 73 74 65 72 20 61 72 65 20 61 73 20 cluster are as 1d90: 66 6f 6c 6c 6f 77 73 3a 0a 3c 2f 70 3e 0a 0a 3c follows:.</p>..< 1da0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 62 3e 4d blockquote>.<b>M 1db0: 3c 2f 62 3e 20 3c 69 3e 75 75 69 64 3c 2f 69 3e </b> <i>uuid</i> 1dc0: 3c 62 72 20 2f 3e 0a 3c 62 3e 5a 3c 2f 62 3e 20 <br />.<b>Z</b> 1dd0: 3c 69 3e 63 68 65 63 6b 73 75 6d 3c 2f 69 3e 0a <i>checksum</i>. 1de0: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c </blockquote>..< 1df0: 70 3e 0a 41 20 63 6c 75 73 74 65 72 20 63 6f 6e p>.A cluster con 1e00: 74 61 69 6e 73 20 6f 6e 65 20 6f 72 20 6d 6f 72 tains one or mor 1e10: 65 20 22 4d 22 20 63 61 72 64 73 20 66 6f 6c 6c e "M" cards foll 1e20: 6f 77 65 64 20 62 79 20 61 20 73 69 6e 67 6c 65 owed by a single 1e30: 20 22 5a 22 0a 6c 69 6e 65 2e 20 20 45 61 63 68 "Z".line. Each 1e40: 20 4d 20 63 61 72 64 20 68 61 73 20 61 20 73 69 M card has a si 1e50: 6e 67 6c 65 20 61 72 67 75 6d 65 6e 74 20 77 68 ngle argument wh 1e60: 69 63 68 20 69 73 20 74 68 65 20 55 55 49 44 20 ich is the UUID 1e70: 6f 66 20 0a 61 6e 6f 74 68 65 72 20 61 72 74 69 of .another arti 1e80: 66 61 63 74 20 69 6e 20 74 68 65 20 72 65 70 6f fact in the repo 1e90: 73 69 74 6f 72 79 2e 20 20 54 68 65 20 5a 20 63 sitory. The Z c 1ea0: 61 72 64 20 77 6f 72 6b 20 65 78 61 63 74 6c 79 ard work exactly 1eb0: 20 6c 69 6b 65 0a 74 68 65 20 5a 20 63 61 72 64 like.the Z card 1ec0: 20 6f 66 20 61 20 6d 61 6e 69 66 65 73 74 2e 20 of a manifest. 1ed0: 20 54 68 65 20 61 72 67 75 6d 65 6e 74 20 74 6f The argument to 1ee0: 20 74 68 65 20 5a 20 63 61 72 64 20 69 73 20 74 the Z card is t 1ef0: 68 65 0a 6c 6f 77 65 72 2d 63 61 73 65 20 68 65 he.lower-case he 1f00: 78 61 64 65 63 69 6d 61 6c 20 72 65 70 72 65 73 xadecimal repres 1f10: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 entation of the 1f20: 4d 44 35 20 63 68 65 63 6b 73 75 6d 20 6f 66 20 MD5 checksum of 1f30: 61 6c 6c 0a 70 72 69 6f 72 20 63 61 72 64 73 20 all.prior cards 1f40: 69 6e 20 74 68 65 20 63 6c 75 73 74 65 72 2e 20 in the cluster. 1f50: 20 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 5a Note that the Z 1f60: 20 63 61 72 64 20 69 73 20 72 65 71 75 69 72 65 card is require 1f70: 64 0a 6f 6e 20 61 20 63 6c 75 73 74 65 72 2e 0a d.on a cluster.. 1f80: 3c 2f 70 3e 0a 0a 0a 3c 68 32 3e 33 2e 30 20 43 </p>...<h2>3.0 C 1f90: 6f 6e 74 72 6f 6c 20 41 72 74 69 66 61 63 74 73 ontrol Artifacts 1fa0: 3c 2f 68 32 3e 0a 0a 3c 70 3e 0a 43 6f 6e 74 72 </h2>..<p>.Contr 1fb0: 6f 6c 20 61 72 74 69 66 61 63 74 73 20 61 72 65 ol artifacts are 1fc0: 20 75 73 65 64 20 74 6f 20 61 73 73 69 67 6e 20 used to assign 1fd0: 70 72 6f 70 65 72 74 69 65 73 20 74 6f 20 6f 74 properties to ot 1fe0: 68 65 72 20 61 72 74 69 66 61 63 74 73 0a 77 69 her artifacts.wi 1ff0: 74 68 69 6e 20 74 68 65 20 72 65 70 6f 73 69 74 thin the reposit 2000: 6f 72 79 2e 20 20 54 68 65 20 62 61 73 69 63 20 ory. The basic 2010: 66 6f 72 6d 61 74 20 6f 66 20 61 20 63 6f 6e 74 format of a cont 2020: 72 6f 6c 20 61 72 74 69 66 61 63 74 20 69 73 0a rol artifact is. 2030: 74 68 65 20 73 61 6d 65 20 61 73 20 61 20 6d 61 the same as a ma 2040: 6e 69 66 65 73 74 20 6f 72 20 63 6c 75 73 74 65 nifest or cluste 2050: 72 2e 20 20 41 20 63 6f 6e 74 72 6f 6c 20 61 72 r. A control ar 2060: 74 69 66 61 63 74 20 69 73 20 61 20 74 65 78 74 tifact is a text 2070: 0a 66 69 6c 65 73 20 64 69 76 69 64 65 64 20 69 .files divided i 2080: 6e 74 6f 20 63 61 72 64 73 20 62 79 20 6e 65 77 nto cards by new 2090: 6c 69 6e 65 20 63 68 61 72 61 63 74 65 72 73 2e line characters. 20a0: 20 20 45 61 63 68 20 63 61 72 64 20 68 61 73 20 Each card has 20b0: 61 0a 73 69 6e 67 6c 65 2d 63 68 61 72 61 63 74 a.single-charact 20c0: 65 72 20 63 61 72 64 20 74 79 70 65 20 66 6f 6c er card type fol 20d0: 6c 6f 77 65 64 20 62 79 20 61 72 67 75 6d 65 6e lowed by argumen 20e0: 74 73 2e 20 20 53 70 61 63 65 73 20 73 65 70 61 ts. Spaces sepa 20f0: 72 61 74 65 0a 74 68 65 20 63 61 72 64 20 74 79 rate.the card ty 2100: 70 65 20 61 6e 64 20 74 68 65 20 61 72 67 75 6d pe and the argum 2110: 65 6e 74 73 2e 20 20 4e 6f 20 73 75 72 70 6c 75 ents. No surplu 2120: 73 20 77 68 69 74 65 73 70 61 63 65 20 69 73 20 s whitespace is 2130: 61 6c 6c 6f 77 65 64 2e 0a 41 6c 6c 20 63 61 72 allowed..All car 2140: 64 73 20 6d 75 73 74 20 6f 63 63 75 72 20 69 6e ds must occur in 2150: 20 73 74 72 69 63 74 20 6c 65 78 69 67 72 61 70 strict lexigrap 2160: 68 69 63 61 6c 20 6f 72 64 65 72 2e 0a 3c 2f 70 hical order..</p 2170: 3e 0a 0a 3c 70 3e 0a 41 6c 6c 6f 77 65 64 20 63 >..<p>.Allowed c 2180: 61 72 64 73 20 69 6e 20 61 20 63 6f 6e 74 72 6f ards in a contro 2190: 6c 20 61 72 74 69 66 61 63 74 20 61 72 65 20 61 l artifact are a 21a0: 73 20 66 6f 6c 6c 6f 77 73 3a 0a 3c 2f 70 3e 0a s follows:.</p>. 21b0: 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 62 .<blockquote>.<b 21c0: 3e 44 3c 2f 62 3e 20 3c 69 3e 74 69 6d 65 2d 61 >D</b> <i>time-a 21d0: 6e 64 2d 64 61 74 65 2d 73 74 61 6d 70 3c 2f 69 nd-date-stamp</i 21e0: 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 54 3c 2f 62 3e ><br />.<b>T</b> 21f0: 20 28 3c 62 3e 2b 3c 2f 62 3e 7c 3c 62 3e 2d 3c (<b>+</b>|<b>-< 2200: 2f 62 3e 7c 3c 62 3e 2a 3c 2f 62 3e 29 3c 69 3e /b>|<b>*</b>)<i> 2210: 74 61 67 2d 6e 61 6d 65 20 20 75 75 69 64 20 20 tag-name uuid 2220: 3f 76 61 6c 75 65 3f 3c 2f 69 3e 3c 62 72 20 2f ?value?</i><br / 2230: 3e 0a 3c 62 3e 5a 3c 2f 62 3e 20 3c 69 3e 63 68 >.<b>Z</b> <i>ch 2240: 65 63 6b 73 75 6d 3c 2f 69 3e 3c 62 72 20 2f 3e ecksum</i><br /> 2250: 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a .</blockquote>.. 2260: 3c 70 3e 0a 41 20 63 6f 6e 74 72 6f 6c 20 61 72 <p>.A control ar 2270: 74 69 66 61 63 74 20 6d 75 73 74 20 68 61 76 65 tifact must have 2280: 20 6f 6e 65 20 44 20 63 61 72 64 20 61 6e 64 20 one D card and 2290: 6f 6e 65 20 5a 20 63 61 72 64 20 61 6e 64 0a 6f one Z card and.o 22a0: 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 72 20 6d 6f ne or more or mo 22b0: 72 65 20 54 20 63 61 72 64 73 2e 20 20 4e 6f 20 re T cards. No 22c0: 6f 74 68 65 72 20 63 61 72 64 73 20 6f 72 20 6f other cards or o 22d0: 74 68 65 72 20 74 65 78 74 20 69 73 0a 61 6c 6c ther text is.all 22e0: 6f 77 65 64 20 69 6e 20 61 20 63 6f 6e 74 72 6f owed in a contro 22f0: 6c 20 61 72 74 69 66 61 63 74 2e 20 20 43 6f 6e l artifact. Con 2300: 74 72 6f 6c 20 61 72 74 69 66 61 63 74 73 20 6d trol artifacts m 2310: 69 67 68 74 20 62 65 20 50 47 50 0a 63 6c 65 61 ight be PGP.clea 2320: 72 73 69 67 6e 65 64 2e 3c 2f 70 3e 0a 0a 3c 70 rsigned.</p>..<p 2330: 3e 54 68 65 20 44 20 63 61 72 64 20 61 6e 64 20 >The D card and 2340: 74 68 65 20 5a 20 63 61 72 64 20 6f 66 20 61 20 the Z card of a 2350: 63 6f 6e 74 72 6f 6c 20 61 72 74 69 66 61 63 74 control artifact 2360: 20 61 72 65 20 74 68 65 20 73 61 6d 65 0a 61 73 are the same.as 2370: 20 69 6e 20 61 20 6d 61 6e 69 66 65 73 74 2e 3c in a manifest.< 2380: 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 54 20 63 61 /p>..<p>The T ca 2390: 72 64 20 72 65 70 72 65 73 65 6e 74 73 20 61 20 rd represents a 23a0: 22 74 61 67 22 20 6f 72 20 70 72 6f 70 65 72 74 "tag" or propert 23b0: 79 20 74 68 61 74 20 69 73 20 61 70 70 6c 69 65 y that is applie 23c0: 64 20 74 6f 0a 73 6f 6d 65 20 6f 74 68 65 72 20 d to.some other 23d0: 61 72 74 69 66 61 63 74 2e 20 20 54 68 65 20 54 artifact. The T 23e0: 20 63 61 72 64 20 68 61 73 20 74 77 6f 20 6f 72 card has two or 23f0: 20 74 68 72 65 65 20 76 61 6c 75 65 73 2e 20 20 three values. 2400: 54 68 65 0a 73 65 63 6f 6e 64 20 61 72 67 75 6d The.second argum 2410: 65 6e 74 20 69 73 20 74 68 65 20 34 30 20 63 68 ent is the 40 ch 2420: 61 72 61 63 74 65 72 20 6c 6f 77 65 72 63 61 73 aracter lowercas 2430: 65 20 55 55 49 44 20 6f 66 20 74 68 65 20 61 72 e UUID of the ar 2440: 74 69 66 61 63 74 0a 74 6f 20 77 68 69 63 68 20 tifact.to which 2450: 74 68 65 20 74 61 67 20 69 73 20 74 6f 20 62 65 the tag is to be 2460: 20 61 70 70 6c 69 65 64 2e 20 54 68 65 0a 66 69 applied. The.fi 2470: 72 73 74 20 76 61 6c 75 65 20 69 73 20 74 68 65 rst value is the 2480: 20 74 61 67 20 6e 61 6d 65 2e 20 20 54 68 65 20 tag name. The 2490: 66 69 72 73 74 20 63 68 61 72 61 63 74 65 72 20 first character 24a0: 6f 66 20 74 68 65 20 74 61 67 0a 69 73 20 65 69 of the tag.is ei 24b0: 74 68 65 72 20 22 2b 22 2c 20 22 2d 22 2c 20 6f ther "+", "-", o 24c0: 72 20 22 2a 22 2e 20 20 41 20 22 2b 22 20 6d 65 r "*". A "+" me 24d0: 61 6e 73 20 74 68 65 20 74 61 67 20 73 68 6f 75 ans the tag shou 24e0: 6c 64 20 62 65 20 61 64 64 65 64 0a 74 6f 20 74 ld be added.to t 24f0: 68 65 20 61 72 74 69 66 61 63 74 2e 20 20 54 68 he artifact. Th 2500: 65 20 22 2d 22 20 6d 65 61 6e 73 20 74 68 65 20 e "-" means the 2510: 74 61 67 20 73 68 6f 75 6c 64 20 62 65 20 72 65 tag should be re 2520: 6d 6f 76 65 64 2e 0a 54 68 65 20 22 2a 22 20 63 moved..The "*" c 2530: 68 61 72 61 63 74 65 72 20 6d 65 61 6e 73 20 74 haracter means t 2540: 68 65 20 74 61 67 20 73 68 6f 75 6c 64 20 62 65 he tag should be 2550: 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 61 72 added to the ar 2560: 74 69 66 61 63 74 0a 61 6e 64 20 61 6c 6c 20 64 tifact.and all d 2570: 69 72 65 63 74 20 64 65 63 65 6e 64 61 6e 74 73 irect decendants 2580: 20 28 62 75 74 20 6e 6f 74 20 62 72 61 6e 63 68 (but not branch 2590: 65 73 29 20 6f 66 20 74 68 65 20 61 72 74 69 66 es) of the artif 25a0: 61 63 74 20 64 6f 77 6e 0a 74 6f 20 62 75 74 20 act down.to but 25b0: 6e 6f 74 20 69 6e 63 6c 75 64 69 6e 67 20 74 68 not including th 25c0: 65 20 66 69 72 73 74 20 64 65 63 65 6e 64 61 6e e first decendan 25d0: 74 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 t that contains 25e0: 61 20 0a 6d 6f 72 65 20 72 65 63 65 6e 74 20 22 a .more recent " 25f0: 2d 22 20 74 61 67 20 77 69 74 68 20 74 68 65 20 -" tag with the 2600: 73 61 6d 65 20 6e 61 6d 65 2e 0a 54 68 65 20 6f same name..The o 2610: 70 74 69 6f 6e 61 6c 20 74 68 69 72 64 20 61 72 ptional third ar 2620: 67 75 6d 65 6e 74 20 69 73 20 74 68 65 20 76 61 gument is the va 2630: 6c 75 65 20 6f 66 20 74 68 65 20 74 61 67 2e 20 lue of the tag. 2640: 20 41 20 74 61 67 0a 77 69 74 68 6f 75 74 20 61 A tag.without a 2650: 20 76 61 6c 75 65 20 69 73 20 61 20 62 6f 6f 6c value is a bool 2660: 65 61 6e 2e 3c 2f 70 3e 0a 0a 3c 70 3e 57 68 65 ean.</p>..<p>Whe 2670: 6e 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 74 61 n two or more ta 2680: 67 73 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 gs with the same 2690: 20 6e 61 6d 65 20 61 72 65 20 61 70 70 6c 69 65 name are applie 26a0: 64 20 74 6f 20 74 68 65 0a 73 61 6d 65 20 61 72 d to the.same ar 26b0: 74 69 66 61 63 74 2c 20 74 68 65 20 74 61 67 20 tifact, the tag 26c0: 77 69 74 68 20 74 68 65 20 6c 61 74 65 73 74 20 with the latest 26d0: 28 6d 6f 73 74 20 72 65 63 65 6e 74 29 20 64 61 (most recent) da 26e0: 74 65 20 69 73 0a 75 73 65 64 2e 3c 2f 70 3e 0a te is.used.</p>. 26f0: 0a 3c 70 3e 53 6f 6d 65 20 74 61 67 73 20 68 61 .<p>Some tags ha 2700: 76 65 20 73 70 65 63 69 61 6c 20 6d 65 61 6e 69 ve special meani 2710: 6e 67 2e 20 20 54 68 65 20 22 63 6f 6d 6d 65 6e ng. The "commen 2720: 74 22 20 74 61 67 20 77 68 65 6e 20 61 70 70 6c t" tag when appl 2730: 69 65 64 0a 74 6f 20 61 20 62 61 73 65 6c 69 6e ied.to a baselin 2740: 65 20 77 69 6c 6c 20 6f 76 65 72 72 69 64 65 20 e will override 2750: 74 68 65 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d the check-in com 2760: 6d 65 6e 74 20 6f 66 20 74 68 61 74 20 62 61 73 ment of that bas 2770: 65 6c 69 6e 65 0a 66 6f 72 20 64 69 73 70 6c 61 eline.for displa 2780: 79 20 70 75 72 70 6f 73 65 73 2e 3c 2f 70 3e 0a y purposes.</p>. 2790: 0a 3c 68 32 3e 34 2e 30 20 57 69 6b 69 20 50 61 .<h2>4.0 Wiki Pa 27a0: 67 65 73 3c 2f 68 32 3e 0a 0a 3c 70 3e 41 20 77 ges</h2>..<p>A w 27b0: 69 6b 69 20 70 61 67 65 20 69 73 20 61 6e 20 61 iki page is an a 27c0: 72 74 69 66 61 63 74 20 77 69 74 68 20 61 20 66 rtifact with a f 27d0: 6f 72 6d 61 74 20 73 69 6d 69 6c 61 72 20 74 6f ormat similar to 27e0: 20 6d 61 6e 69 66 65 73 74 73 2c 0a 63 6c 75 73 manifests,.clus 27f0: 74 65 72 73 2c 20 61 6e 64 20 63 6f 6e 74 72 6f ters, and contro 2800: 6c 20 61 72 74 69 66 61 63 74 73 2e 20 20 54 68 l artifacts. Th 2810: 65 20 61 72 74 69 66 61 63 74 20 69 73 20 64 69 e artifact is di 2820: 76 69 64 65 64 20 69 6e 74 6f 0a 63 61 72 64 73 vided into.cards 2830: 20 62 79 20 6e 65 77 6c 69 6e 65 20 63 68 61 72 by newline char 2840: 61 63 74 65 72 73 2e 20 20 54 68 65 20 66 6f 72 acters. The for 2850: 6d 61 74 20 6f 66 20 65 61 63 68 20 63 61 72 64 mat of each card 2860: 20 69 73 20 61 73 20 69 6e 0a 6d 61 6e 69 66 65 is as in.manife 2870: 73 74 73 2c 20 63 6c 75 73 74 65 72 73 2c 20 61 sts, clusters, a 2880: 6e 64 20 63 6f 6e 74 72 6f 6c 20 61 72 74 69 66 nd control artif 2890: 61 63 74 73 2e 20 20 57 69 6b 69 20 61 72 74 69 acts. Wiki arti 28a0: 66 61 63 74 73 20 61 63 63 65 70 74 0a 74 68 65 facts accept.the 28b0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 61 72 64 20 following card 28c0: 74 79 70 65 73 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f types:</p>..<blo 28d0: 63 6b 71 75 6f 74 65 3e 0a 3c 62 3e 44 3c 2f 62 ckquote>.<b>D</b 28e0: 3e 20 3c 69 3e 74 69 6d 65 2d 61 6e 64 2d 64 61 > <i>time-and-da 28f0: 74 65 2d 73 74 61 6d 70 3c 2f 69 3e 3c 62 72 20 te-stamp</i><br 2900: 2f 3e 0a 3c 62 3e 4c 3c 2f 62 3e 20 3c 69 3e 77 />.<b>L</b> <i>w 2910: 69 6b 69 2d 74 69 74 6c 65 3c 2f 69 3e 3c 62 72 iki-title</i><br 2920: 20 2f 3e 0a 3c 62 3e 50 3c 2f 62 3e 20 3c 69 3e />.<b>P</b> <i> 2930: 70 61 72 65 6e 74 2d 75 75 69 64 3c 2f 69 3e 2b parent-uuid</i>+ 2940: 3c 62 72 20 2f 3e 0a 3c 62 3e 55 3c 2f 62 3e 20 <br />.<b>U</b> 2950: 3c 69 3e 75 73 65 72 2d 6e 61 6d 65 3c 2f 69 3e <i>user-name</i> 2960: 3c 62 72 20 2f 3e 0a 3c 62 3e 57 3c 2f 62 3e 20 <br />.<b>W</b> 2970: 3c 69 3e 73 69 7a 65 3c 2f 69 3e 20 3c 62 3e 5c <i>size</i> <b>\ 2980: 6e 3c 2f 62 3e 20 3c 69 3e 74 65 78 74 3c 2f 69 n</b> <i>text</i 2990: 3e 20 3c 62 3e 5c 6e 3c 2f 62 3e 3c 62 72 20 2f > <b>\n</b><br / 29a0: 3e 0a 3c 62 3e 5a 3c 2f 62 3e 20 3c 69 3e 63 68 >.<b>Z</b> <i>ch 29b0: 65 63 6b 73 75 6d 3c 2f 69 3e 0a 3c 2f 62 6c 6f ecksum</i>.</blo 29c0: 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 54 68 65 ckquote>..<p>The 29d0: 20 44 20 63 61 72 64 20 69 73 20 74 68 65 20 64 D card is the d 29e0: 61 74 65 20 61 6e 64 20 74 69 6d 65 20 77 68 65 ate and time whe 29f0: 6e 20 74 68 65 20 77 69 6b 69 20 70 61 67 65 20 n the wiki page 2a00: 77 61 73 20 65 64 69 74 65 64 2e 0a 54 68 65 20 was edited..The 2a10: 50 20 63 61 72 64 20 73 70 65 63 69 66 69 65 73 P card specifies 2a20: 20 74 68 65 20 70 61 72 65 6e 74 20 77 69 6b 69 the parent wiki 2a30: 20 70 61 67 65 73 2c 20 69 66 20 61 6e 79 2e 20 pages, if any. 2a40: 20 54 68 65 20 4c 20 63 61 72 64 0a 67 69 76 65 The L card.give 2a50: 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 s the name of th 2a60: 65 20 77 69 6b 69 20 70 61 67 65 2e 20 20 54 68 e wiki page. Th 2a70: 65 20 55 20 63 61 72 64 20 73 70 65 63 69 66 69 e U card specifi 2a80: 65 73 20 74 68 65 20 6c 6f 67 69 6e 0a 6f 66 20 es the login.of 2a90: 74 68 65 20 75 73 65 72 20 77 68 6f 20 6d 61 64 the user who mad 2aa0: 65 20 74 68 69 73 20 65 64 69 74 20 74 6f 20 74 e this edit to t 2ab0: 68 65 20 77 69 6b 69 20 70 61 67 65 2e 20 20 54 he wiki page. T 2ac0: 68 65 20 5a 20 63 61 72 64 20 69 73 0a 74 68 65 he Z card is.the 2ad0: 20 75 73 75 61 6c 20 63 68 65 63 6b 73 75 6d 20 usual checksum 2ae0: 6f 76 65 72 20 74 68 65 20 65 69 74 68 65 72 20 over the either 2af0: 61 72 74 69 66 61 63 74 2e 3c 2f 70 3e 0a 0a 3c artifact.</p>..< 2b00: 70 3e 54 68 65 20 57 20 63 61 72 64 20 69 73 20 p>The W card is 2b10: 75 73 65 64 20 74 6f 20 73 70 65 63 69 66 79 20 used to specify 2b20: 74 68 65 20 74 65 78 74 20 6f 66 20 74 68 65 20 the text of the 2b30: 77 69 6b 69 20 70 61 67 65 2e 20 20 54 68 65 0a wiki page. The. 2b40: 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 argument to the 2b50: 57 20 63 61 72 64 20 69 73 20 61 6e 20 69 6e 74 W card is an int 2b60: 65 67 65 72 20 77 68 69 63 68 20 69 73 20 74 68 eger which is th 2b70: 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 e number of byte 2b80: 73 0a 6f 66 20 74 65 78 74 20 69 6e 20 74 68 65 s.of text in the 2b90: 20 77 69 6b 69 20 70 61 67 65 2e 20 20 54 68 61 wiki page. Tha 2ba0: 74 20 74 65 78 74 20 66 6f 6c 6c 6f 77 73 20 74 t text follows t 2bb0: 68 65 20 6e 65 77 6c 69 6e 65 20 63 68 61 72 61 he newline chara 2bc0: 63 74 65 72 0a 74 68 61 74 20 74 65 72 6d 69 6e cter.that termin 2bd0: 61 74 65 73 20 74 68 65 20 57 20 63 61 72 64 2e ates the W card. 2be0: 20 20 54 68 65 20 77 69 6b 69 20 74 65 78 74 20 The wiki text 2bf0: 69 73 20 61 6c 77 61 79 73 20 66 6f 6c 6c 6f 77 is always follow 2c00: 65 64 20 62 79 20 6f 6e 65 0a 65 78 74 72 61 20 ed by one.extra 2c10: 6e 65 77 6c 69 6e 65 2e 3c 2f 70 3e 0a 0a 3c 61 newline.</p>..<a 2c20: 20 6e 61 6d 65 3d 22 74 6b 74 63 68 6e 67 22 3e name="tktchng"> 2c30: 3c 2f 61 3e 0a 3c 68 32 3e 35 2e 30 20 54 69 63 </a>.<h2>5.0 Tic 2c40: 6b 65 74 20 43 68 61 6e 67 65 73 3c 2f 68 32 3e ket Changes</h2> 2c50: 0a 0a 3c 70 3e 41 20 74 69 63 6b 65 74 2d 63 68 ..<p>A ticket-ch 2c60: 61 6e 67 65 20 61 72 74 69 66 61 63 74 20 72 65 ange artifact re 2c70: 70 72 65 73 65 6e 74 73 20 61 20 63 68 61 6e 67 presents a chang 2c80: 65 20 74 6f 20 61 20 74 72 6f 75 62 6c 65 20 74 e to a trouble t 2c90: 69 63 6b 65 74 2e 0a 54 68 65 20 66 6f 6c 6c 6f icket..The follo 2ca0: 77 69 6e 67 20 63 61 72 64 73 20 61 72 65 20 61 wing cards are a 2cb0: 6c 6c 6f 77 65 64 20 6f 6e 20 61 20 74 69 63 6b llowed on a tick 2cc0: 65 74 20 63 68 61 6e 67 65 20 61 72 74 69 66 61 et change artifa 2cd0: 63 74 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 ct:</p>..<blockq 2ce0: 75 6f 74 65 3e 0a 3c 62 3e 44 3c 2f 62 3e 20 3c uote>.<b>D</b> < 2cf0: 69 3e 74 69 6d 65 2d 61 6e 64 2d 64 61 74 65 2d i>time-and-date- 2d00: 73 74 61 6d 70 3c 2f 69 3e 3c 62 72 20 2f 3e 0a stamp</i><br />. 2d10: 3c 62 3e 4a 3c 2f 62 3e 20 3f 3c 62 3e 2b 3c 2f <b>J</b> ?<b>+</ 2d20: 62 3e 3f 3c 69 3e 6e 61 6d 65 20 76 61 6c 75 65 b>?<i>name value 2d30: 3c 2f 69 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 4b 3c </i><br />.<b>K< 2d40: 2f 62 3e 20 3c 69 3e 74 69 63 6b 65 74 2d 75 75 /b> <i>ticket-uu 2d50: 69 64 3c 2f 69 3e 3c 62 72 20 2f 3e 0a 3c 62 3e id</i><br />.<b> 2d60: 55 3c 2f 62 3e 20 3c 69 3e 75 73 65 72 2d 6e 61 U</b> <i>user-na 2d70: 6d 65 3c 2f 69 3e 3c 62 72 20 2f 3e 0a 3c 62 3e me</i><br />.<b> 2d80: 5a 3c 2f 62 3e 20 3c 69 3e 63 68 65 63 6b 73 75 Z</b> <i>checksu 2d90: 6d 3c 2f 69 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f m</i>.</blockquo 2da0: 74 65 3e 0a 0a 3c 70 3e 0a 54 68 65 20 44 20 63 te>..<p>.The D c 2db0: 61 72 64 20 69 73 20 74 68 65 20 75 73 75 61 6c ard is the usual 2dc0: 20 64 61 74 65 20 61 6e 64 20 74 69 6d 65 20 73 date and time s 2dd0: 74 61 6d 70 20 61 6e 64 20 72 65 70 72 65 73 65 tamp and represe 2de0: 6e 74 73 20 74 68 65 20 70 6f 69 6e 74 0a 69 6e nts the point.in 2df0: 20 74 69 6d 65 20 77 68 65 6e 20 74 68 65 20 63 time when the c 2e00: 68 61 6e 67 65 20 77 61 73 20 65 6e 74 65 72 65 hange was entere 2e10: 64 2e 20 20 54 68 65 20 55 20 63 61 72 64 20 69 d. The U card i 2e20: 73 20 74 68 65 20 6c 6f 67 69 6e 20 6f 66 20 74 s the login of t 2e30: 68 65 0a 70 72 6f 67 72 61 6d 6d 65 72 20 77 68 he.programmer wh 2e40: 6f 20 65 6e 74 65 72 65 64 20 74 68 69 73 20 63 o entered this c 2e50: 68 61 6e 67 65 2e 20 20 54 68 65 20 5a 20 63 61 hange. The Z ca 2e60: 72 64 20 69 73 20 74 68 65 20 63 68 65 63 6b 73 rd is the checks 2e70: 75 6d 20 6f 76 65 72 0a 74 68 65 20 65 6e 74 69 um over.the enti 2e80: 72 65 20 61 72 74 69 66 61 63 74 2e 3c 2f 70 3e re artifact.</p> 2e90: 0a 0a 3c 70 3e 0a 45 76 65 72 79 20 74 69 63 6b ..<p>.Every tick 2ea0: 65 74 20 68 61 73 20 61 20 55 55 49 44 2e 20 20 et has a UUID. 2eb0: 54 68 65 20 74 69 63 6b 65 74 20 74 6f 20 77 68 The ticket to wh 2ec0: 69 63 68 20 74 68 69 73 20 63 68 61 6e 67 65 20 ich this change 2ed0: 69 73 20 61 70 70 6c 69 65 64 0a 69 73 20 73 70 is applied.is sp 2ee0: 65 63 69 66 69 65 64 20 62 79 20 74 68 65 20 4b ecified by the K 2ef0: 20 63 61 72 64 2e 20 20 41 20 74 69 63 6b 65 74 card. A ticket 2f00: 20 65 78 69 73 74 73 20 69 66 20 69 74 20 63 6f exists if it co 2f10: 6e 74 61 69 6e 73 20 6f 6e 65 20 6f 72 0a 6d 6f ntains one or.mo 2f20: 72 65 20 63 68 61 6e 67 65 73 2e 20 20 54 68 65 re changes. The 2f30: 20 66 69 72 73 74 20 22 63 68 61 6e 67 65 22 20 first "change" 2f40: 74 6f 20 61 20 74 69 63 6b 65 74 20 69 73 20 77 to a ticket is w 2f50: 68 61 74 20 62 72 69 6e 67 73 20 74 68 65 0a 74 hat brings the.t 2f60: 69 63 6b 65 74 20 69 6e 74 6f 20 65 78 69 73 74 icket into exist 2f70: 61 6e 63 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 0a 4a ance.</p>..<p>.J 2f80: 20 63 61 72 64 73 20 73 70 65 63 69 66 79 20 63 cards specify c 2f90: 68 61 6e 67 65 73 20 74 6f 20 22 66 69 65 6c 64 hanges to "field 2fa0: 73 22 20 6f 66 20 74 68 65 20 74 69 63 6b 65 74 s" of the ticket 2fb0: 2e 20 20 45 61 63 68 20 66 6f 73 73 69 6c 0a 73 . Each fossil.s 2fc0: 65 72 76 65 72 20 68 61 73 20 61 20 74 69 63 6b erver has a tick 2fd0: 65 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e et configuration 2fe0: 20 77 68 69 63 68 20 73 70 65 63 69 66 69 65 73 which specifies 2ff0: 20 74 68 65 20 66 69 65 6c 64 73 20 69 74 73 0a the fields its. 3000: 75 6e 64 65 72 73 74 61 6e 64 73 2e 20 20 54 68 understands. Th 3010: 69 73 20 69 73 20 6e 6f 74 20 61 20 6c 69 6d 69 is is not a limi 3020: 74 20 6f 6e 20 74 68 65 20 66 69 65 6c 64 73 20 t on the fields 3030: 74 68 61 74 20 63 61 6e 20 61 70 70 65 61 72 0a that can appear. 3040: 6f 6e 20 74 68 65 20 4a 20 63 61 72 64 73 2c 20 on the J cards, 3050: 68 6f 77 65 76 65 72 2e 20 20 49 66 20 61 20 4a however. If a J 3060: 20 63 61 72 64 20 73 70 65 63 69 66 69 65 73 20 card specifies 3070: 61 20 66 69 65 6c 64 20 74 68 61 74 20 61 0a 70 a field that a.p 3080: 61 72 74 69 63 75 6c 61 72 20 66 6f 73 73 69 6c articular fossil 3090: 20 73 65 72 76 65 72 20 64 6f 65 73 20 6e 6f 74 server does not 30a0: 20 72 65 63 6f 67 6e 69 7a 65 2c 20 74 68 65 6e recognize, then 30b0: 20 74 68 61 74 20 4a 20 63 61 72 64 0a 69 73 20 that J card.is 30c0: 73 69 6d 70 6c 79 20 69 67 6e 6f 72 65 64 2e 3c simply ignored.< 30d0: 2f 70 3e 0a 0a 3c 70 3e 0a 54 68 65 20 66 69 72 /p>..<p>.The fir 30e0: 73 74 20 61 72 67 75 6d 65 6e 74 20 6f 66 20 74 st argument of t 30f0: 68 65 20 4a 20 63 61 72 64 20 69 73 20 74 68 65 he J card is the 3100: 20 66 69 65 6c 64 20 6e 61 6d 65 2e 20 20 54 68 field name. Th 3110: 65 20 73 65 63 6f 6e 64 0a 76 61 6c 75 65 20 69 e second.value i 3120: 73 20 74 68 65 20 66 69 65 6c 64 20 76 61 6c 75 s the field valu 3130: 65 2e 20 20 49 66 20 74 68 65 20 66 69 65 6c 64 e. If the field 3140: 20 6e 61 6d 65 20 62 65 67 69 6e 73 20 77 69 74 name begins wit 3150: 68 20 22 2b 22 20 74 68 65 6e 0a 74 68 65 20 76 h "+" then.the v 3160: 61 6c 75 65 20 69 73 20 61 70 70 65 6e 64 65 64 alue is appended 3170: 20 74 6f 20 74 68 65 20 70 72 69 6f 72 20 76 61 to the prior va 3180: 6c 75 65 2e 20 20 4f 74 68 65 72 77 69 73 65 2c lue. Otherwise, 3190: 20 74 68 65 20 76 61 6c 75 65 0a 6f 6e 20 74 68 the value.on th 31a0: 65 20 4a 20 63 61 72 64 20 72 65 70 6c 61 63 65 e J card replace 31b0: 73 20 61 6e 79 20 70 72 65 76 69 6f 75 73 20 76 s any previous v 31c0: 61 6c 75 65 20 6f 66 20 74 68 65 20 66 69 65 6c alue of the fiel 31d0: 64 2e 0a 54 68 65 20 66 69 65 6c 64 20 6e 61 6d d..The field nam 31e0: 65 20 61 6e 64 20 76 61 6c 75 65 20 61 72 65 20 e and value are 31f0: 62 6f 74 68 20 65 6e 63 6f 64 65 64 20 75 73 69 both encoded usi 3200: 6e 67 20 74 68 65 20 63 68 61 72 61 63 74 65 72 ng the character 3210: 0a 65 73 63 61 70 65 73 20 64 65 66 69 6e 65 64 .escapes defined 3220: 20 66 6f 72 20 74 68 65 20 43 20 63 61 72 64 20 for the C card 3230: 6f 66 20 61 20 6d 61 6e 69 66 65 73 74 2e 0a 3c of a manifest..< 3240: 2f 70 3e 0a /p>.