Artifact 346d6f32933d8e57d6b84e17d5c8da0b7bb9e5fb:
File www/fileformat.wiki part of check-in [d87ca60c58] - initial ports of static .html to static /doc .wiki by stephan on 2008-05-15 20:25:46. Also file www/fileformat.wiki part of check-in [f94f7e5f49] - Merge the fork back together. by drh on 2008-05-16 00:27:49.
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 0a 54 68 65 20 67 6c 6f 62 61 6c 20 73 74 p>.The global st 0040: 61 74 65 20 6f 66 20 61 20 66 6f 73 73 69 6c 20 ate of a fossil 0050: 72 65 70 6f 73 69 74 6f 72 79 20 69 73 20 64 65 repository is de 0060: 74 65 72 6d 69 6e 65 64 20 62 79 20 61 6e 20 75 termined by an u 0070: 6e 6f 72 64 65 72 65 64 0a 73 65 74 20 6f 66 20 nordered.set of 0080: 61 72 74 69 66 61 63 74 73 2e 0a 41 6e 20 61 72 artifacts..An ar 0090: 74 69 66 61 63 74 20 6d 69 67 68 74 20 62 65 20 tifact might be 00a0: 61 20 73 6f 75 72 63 65 20 63 6f 64 65 20 66 69 a source code fi 00b0: 6c 65 2c 20 74 68 65 20 74 65 78 74 20 6f 66 20 le, the text of 00c0: 61 20 77 69 6b 69 20 70 61 67 65 2c 0a 70 61 72 a wiki page,.par 00d0: 74 20 6f 66 20 61 20 74 72 6f 75 62 6c 65 20 74 t of a trouble t 00e0: 69 63 6b 65 74 2c 20 6f 72 20 6f 6e 65 20 6f 66 icket, or one of 00f0: 20 73 65 76 65 72 61 6c 20 73 70 65 63 69 61 6c several special 0100: 20 63 6f 6e 74 72 6f 6c 20 61 72 74 69 66 61 63 control artifac 0110: 74 73 0a 75 73 65 64 20 74 6f 20 73 68 6f 77 20 ts.used to show 0120: 74 68 65 20 72 65 6c 61 74 69 6f 6e 73 68 69 70 the relationship 0130: 73 20 62 65 74 77 65 65 6e 20 6f 74 68 65 72 20 s between other 0140: 61 72 74 69 66 61 63 74 73 20 77 69 74 68 69 6e artifacts within 0150: 20 74 68 65 0a 70 72 6f 6a 65 63 74 2e 20 20 41 the.project. A 0160: 72 74 69 66 61 63 74 73 20 63 61 6e 20 62 65 20 rtifacts can be 0170: 74 65 78 74 20 6f 72 20 62 69 6e 61 72 79 2e 0a text or binary.. 0180: 3c 2f 70 3e 0a 0a 3c 70 3e 0a 45 61 63 68 20 61 </p>..<p>.Each a 0190: 72 74 69 66 61 63 74 20 69 6e 20 74 68 65 20 72 rtifact in the r 01a0: 65 70 6f 73 69 74 6f 72 79 20 69 73 20 6e 61 6d epository is nam 01b0: 65 64 20 62 79 20 69 74 73 20 53 48 41 31 20 68 ed by its SHA1 h 01c0: 61 73 68 2e 0a 4e 6f 20 70 72 65 66 69 78 65 73 ash..No prefixes 01d0: 20 6f 72 20 6d 65 74 61 20 69 6e 66 6f 72 6d 61 or meta informa 01e0: 74 69 6f 6e 20 69 73 20 61 64 64 65 64 20 74 6f tion is added to 01f0: 20 61 20 61 72 74 69 66 61 63 74 20 62 65 66 6f a artifact befo 0200: 72 65 0a 69 74 73 20 68 61 73 68 20 69 73 20 63 re.its hash is c 0210: 6f 6d 70 75 74 65 64 2e 20 20 54 68 65 20 6e 61 omputed. The na 0220: 6d 65 20 6f 66 20 61 20 61 72 74 69 66 61 63 74 me of a artifact 0230: 20 69 6e 20 74 68 65 20 72 65 70 6f 73 69 74 6f in the reposito 0240: 72 79 0a 69 73 20 65 78 61 63 74 6c 79 20 74 68 ry.is exactly th 0250: 65 20 73 61 6d 65 20 53 48 41 31 20 68 61 73 68 e same SHA1 hash 0260: 20 74 68 61 74 20 69 73 20 63 6f 6d 70 75 74 65 that is compute 0270: 64 20 62 79 20 73 68 61 31 73 75 6d 20 0a 6f 6e d by sha1sum .on 0280: 20 74 68 65 20 66 69 6c 65 20 61 73 20 69 74 20 the file as it 0290: 65 78 69 73 74 73 20 69 6e 20 79 6f 75 72 20 73 exists in your s 02a0: 6f 75 72 63 65 20 74 72 65 65 2e 3c 2f 70 3e 0a ource tree.</p>. 02b0: 0a 3c 70 3e 0a 53 6f 6d 65 20 61 72 74 69 66 61 .<p>.Some artifa 02c0: 63 74 73 20 68 61 76 65 20 61 20 70 61 72 74 69 cts have a parti 02d0: 63 75 6c 61 72 20 66 6f 72 6d 61 74 20 77 68 69 cular format whi 02e0: 63 68 20 67 69 76 65 73 20 74 68 65 6d 20 73 70 ch gives them sp 02f0: 65 63 69 61 6c 0a 6d 65 61 6e 69 6e 67 20 74 6f ecial.meaning to 0300: 20 66 6f 73 73 69 6c 2e 20 20 46 6f 73 73 69 6c fossil. Fossil 0310: 20 72 65 63 6f 67 6e 69 7a 65 73 3a 3c 2f 70 3e recognizes:</p> 0320: 0a 0a 3c 75 6c 3e 0a 3c 6c 69 3e 20 4d 61 6e 69 ..<ul>.<li> Mani 0330: 66 65 73 74 73 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e fests </li>.<li> 0340: 20 43 6c 75 73 74 65 72 73 20 3c 2f 6c 69 3e 0a Clusters </li>. 0350: 3c 6c 69 3e 20 43 6f 6e 74 72 6f 6c 20 41 72 74 <li> Control Art 0360: 69 66 61 63 74 73 20 3c 2f 6c 69 3e 0a 3c 6c 69 ifacts </li>.<li 0370: 3e 20 57 69 6b 69 20 50 61 67 65 73 20 3c 2f 6c > Wiki Pages </l 0380: 69 3e 0a 3c 6c 69 3e 20 54 69 63 6b 65 74 20 43 i>.<li> Ticket C 0390: 68 61 6e 67 65 73 20 3c 2f 6c 69 3e 0a 3c 2f 75 hanges </li>.</u 03a0: 6c 3e 0a 0a 3c 70 3e 54 68 65 73 65 20 66 69 76 l>..<p>These fiv 03b0: 65 20 61 72 74 69 66 61 63 74 20 74 79 70 65 73 e artifact types 03c0: 20 61 72 65 20 64 65 73 63 72 69 62 65 64 20 69 are described i 03d0: 6e 20 74 68 65 20 73 65 71 75 65 6c 2e 3c 2f 70 n the sequel.</p 03e0: 3e 0a 0a 3c 68 32 3e 31 2e 30 20 54 68 65 20 4d >..<h2>1.0 The M 03f0: 61 6e 69 66 65 73 74 3c 2f 68 32 3e 0a 0a 3c 70 anifest</h2>..<p 0400: 3e 41 20 6d 61 6e 69 66 65 73 74 20 64 65 66 69 >A manifest defi 0410: 6e 65 73 20 61 20 62 61 73 65 6c 69 6e 65 20 6f nes a baseline o 0420: 72 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 r version of the 0430: 20 70 72 6f 6a 65 63 74 0a 73 6f 75 72 63 65 20 project.source 0440: 74 72 65 65 2e 20 20 54 68 65 20 6d 61 6e 69 66 tree. The manif 0450: 65 73 74 20 63 6f 6e 74 61 69 6e 73 20 61 20 6c est contains a l 0460: 69 73 74 20 6f 66 20 61 72 74 69 66 61 63 74 73 ist of artifacts 0470: 20 66 6f 72 0a 65 61 63 68 20 66 69 6c 65 20 69 for.each file i 0480: 6e 20 74 68 65 20 70 72 6f 6a 65 63 74 20 61 6e n the project an 0490: 64 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 d the correspond 04a0: 69 6e 67 20 66 69 6c 65 6e 61 6d 65 73 2c 20 61 ing filenames, a 04b0: 73 0a 77 65 6c 6c 20 61 73 20 69 6e 66 6f 72 6d s.well as inform 04c0: 61 74 69 6f 6e 20 73 75 63 68 20 61 73 20 70 61 ation such as pa 04d0: 72 65 6e 74 20 62 61 73 65 6c 69 6e 65 73 2c 20 rent baselines, 04e0: 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 0a the name of the. 04f0: 70 72 6f 67 72 61 6d 6d 65 72 20 77 68 6f 20 63 programmer who c 0500: 72 65 61 74 65 64 20 74 68 65 20 62 61 73 65 6c reated the basel 0510: 69 6e 65 2c 20 74 68 65 20 64 61 74 65 20 61 6e ine, the date an 0520: 64 20 74 69 6d 65 20 77 68 65 6e 0a 74 68 65 20 d time when.the 0530: 62 61 73 65 6c 69 6e 65 20 77 61 73 20 63 72 65 baseline was cre 0540: 61 74 65 64 2c 20 61 6e 64 20 61 6e 79 20 63 68 ated, and any ch 0550: 65 63 6b 2d 69 6e 20 63 6f 6d 6d 65 6e 74 73 20 eck-in comments 0560: 61 73 73 6f 63 69 61 74 65 64 0a 77 69 74 68 20 associated.with 0570: 74 68 65 20 62 61 73 65 6c 69 6e 65 2e 3c 2f 70 the baseline.</p 0580: 3e 0a 0a 3c 70 3e 0a 41 6e 79 20 61 72 74 69 66 >..<p>.Any artif 0590: 61 63 74 20 69 6e 20 74 68 65 20 72 65 70 6f 73 act in the repos 05a0: 69 74 6f 72 79 20 74 68 61 74 20 66 6f 6c 6c 6f itory that follo 05b0: 77 73 20 74 68 65 20 73 79 6e 74 61 63 74 69 63 ws the syntactic 05c0: 20 72 75 6c 65 73 0a 6f 66 20 61 20 6d 61 6e 69 rules.of a mani 05d0: 66 65 73 74 20 69 73 20 61 20 6d 61 6e 69 66 65 fest is a manife 05e0: 73 74 2e 20 20 4e 6f 74 65 20 74 68 61 74 20 61 st. Note that a 05f0: 20 6d 61 6e 69 66 65 73 74 20 63 61 6e 0a 62 65 manifest can.be 0600: 20 62 6f 74 68 20 61 20 72 65 61 6c 20 6d 61 6e both a real man 0610: 69 66 65 73 74 20 61 6e 64 20 61 6c 73 6f 20 61 ifest and also a 0620: 20 63 6f 6e 74 65 6e 74 20 66 69 6c 65 2c 20 74 content file, t 0630: 68 6f 75 67 68 20 74 68 69 73 0a 69 73 20 72 61 hough this.is ra 0640: 72 65 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 41 20 re..</p>..<p>.A 0650: 6d 61 6e 69 66 65 73 74 20 69 73 20 61 20 74 65 manifest is a te 0660: 78 74 20 66 69 6c 65 2e 20 20 4e 65 77 6c 69 6e xt file. Newlin 0670: 65 20 63 68 61 72 61 63 74 65 72 73 0a 28 41 53 e characters.(AS 0680: 43 49 49 20 30 78 30 61 29 20 73 65 70 61 72 61 CII 0x0a) separa 0690: 74 65 20 74 68 65 20 66 69 6c 65 20 69 6e 74 6f te the file into 06a0: 20 22 63 61 72 64 73 22 2e 0a 45 61 63 68 20 63 "cards"..Each c 06b0: 61 72 64 20 62 65 67 69 6e 73 20 77 69 74 68 20 ard begins with 06c0: 61 20 73 69 6e 67 6c 65 0a 63 68 61 72 61 63 74 a single.charact 06d0: 65 72 20 22 63 61 72 64 20 74 79 70 65 22 2e 20 er "card type". 06e0: 20 5a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 61 72 Zero or more ar 06f0: 67 75 6d 65 6e 74 73 20 6d 61 79 20 66 6f 6c 6c guments may foll 0700: 6f 77 0a 74 68 65 20 63 61 72 64 20 74 79 70 65 ow.the card type 0710: 2e 20 20 41 6c 6c 20 61 72 67 75 6d 65 6e 74 73 . All arguments 0720: 20 61 72 65 20 73 65 70 61 72 61 74 65 64 20 66 are separated f 0730: 72 6f 6d 20 65 61 63 68 20 6f 74 68 65 72 0a 61 rom each other.a 0740: 6e 64 20 66 72 6f 6d 20 74 68 65 20 63 61 72 64 nd from the card 0750: 2d 74 79 70 65 20 63 68 61 72 61 63 74 65 72 20 -type character 0760: 62 79 20 61 20 73 69 6e 67 6c 65 20 73 70 61 63 by a single spac 0770: 65 0a 63 68 61 72 61 63 74 65 72 2e 20 20 54 68 e.character. Th 0780: 65 72 65 20 69 73 20 6e 6f 20 73 75 72 70 6c 75 ere is no surplu 0790: 73 20 77 68 69 74 65 20 73 70 61 63 65 20 62 65 s white space be 07a0: 74 77 65 65 6e 20 61 72 67 75 6d 65 6e 74 73 0a tween arguments. 07b0: 61 6e 64 20 6e 6f 20 6c 65 61 64 69 6e 67 20 6f and no leading o 07c0: 72 20 74 72 61 69 6c 69 6e 67 20 77 68 69 74 65 r trailing white 07d0: 73 70 61 63 65 20 65 78 63 65 70 74 20 66 6f 72 space except for 07e0: 20 74 68 65 20 6e 65 77 6c 69 6e 65 20 0a 63 68 the newline .ch 07f0: 61 72 61 63 74 65 72 20 74 68 61 74 20 61 63 74 aracter that act 0800: 73 20 61 73 20 74 68 65 20 63 61 72 64 20 73 65 s as the card se 0810: 70 61 72 61 74 6f 72 2e 0a 3c 2f 70 3e 0a 0a 3c parator..</p>..< 0820: 70 3e 0a 41 6c 6c 20 63 61 72 64 73 20 6f 66 20 p>.All cards of 0830: 74 68 65 20 6d 61 6e 69 66 65 73 74 20 6f 63 63 the manifest occ 0840: 75 72 20 69 6e 20 73 74 72 69 63 74 20 73 6f 72 ur in strict sor 0850: 74 65 64 20 6c 65 78 69 63 6f 67 72 61 70 68 69 ted lexicographi 0860: 63 61 6c 20 6f 72 64 65 72 2e 0a 4e 6f 20 63 61 cal order..No ca 0870: 72 64 20 6d 61 79 20 62 65 20 64 75 70 6c 69 63 rd may be duplic 0880: 61 74 65 64 2e 0a 54 68 65 20 65 6e 74 69 72 65 ated..The entire 0890: 20 6d 61 6e 69 66 65 73 74 20 6d 61 79 20 62 65 manifest may be 08a0: 20 50 47 50 20 63 6c 65 61 72 2d 73 69 67 6e 65 PGP clear-signe 08b0: 64 2c 20 62 75 74 20 6f 74 68 65 72 77 69 73 65 d, but otherwise 08c0: 20 69 74 0a 6d 61 79 20 63 6f 6e 74 61 69 6e 20 it.may contain 08d0: 6e 6f 20 61 64 64 69 74 69 6f 6e 61 6c 20 74 65 no additional te 08e0: 78 74 20 6f 72 20 64 61 74 61 20 62 65 79 6f 6e xt or data beyon 08f0: 64 20 77 68 61 74 20 69 73 20 64 65 73 63 72 69 d what is descri 0900: 62 65 64 20 68 65 72 65 2e 0a 3c 2f 70 3e 0a 0a bed here..</p>.. 0910: 3c 70 3e 0a 41 6c 6c 6f 77 65 64 20 63 61 72 64 <p>.Allowed card 0920: 73 20 69 6e 20 74 68 65 20 6d 61 6e 69 66 65 73 s in the manifes 0930: 74 20 61 72 65 20 61 73 20 66 6f 6c 6c 6f 77 73 t are as follows 0940: 3a 0a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 :.</p>..<blockqu 0950: 6f 74 65 3e 0a 3c 62 3e 43 3c 2f 62 3e 20 3c 69 ote>.<b>C</b> <i 0960: 3e 63 68 65 63 6b 69 6e 2d 63 6f 6d 6d 65 6e 74 >checkin-comment 0970: 3c 2f 69 3e 3c 62 72 3e 0a 3c 62 3e 44 3c 2f 62 </i><br>.<b>D</b 0980: 3e 20 3c 69 3e 74 69 6d 65 2d 61 6e 64 2d 64 61 > <i>time-and-da 0990: 74 65 2d 73 74 61 6d 70 3c 2f 69 3e 3c 62 72 3e te-stamp</i><br> 09a0: 0a 3c 62 3e 46 3c 2f 62 3e 20 3c 69 3e 66 69 6c .<b>F</b> <i>fil 09b0: 65 6e 61 6d 65 3c 2f 69 3e 20 3c 69 3e 53 48 41 ename</i> <i>SHA 09c0: 31 2d 68 61 73 68 3c 2f 69 3e 3c 62 72 3e 0a 3c 1-hash</i><br>.< 09d0: 62 3e 50 3c 2f 62 3e 20 3c 69 3e 53 48 41 31 2d b>P</b> <i>SHA1- 09e0: 68 61 73 68 3c 2f 69 3e 2b 3c 62 72 3e 0a 3c 62 hash</i>+<br>.<b 09f0: 3e 52 3c 2f 62 3e 20 3c 69 3e 72 65 70 6f 73 69 >R</b> <i>reposi 0a00: 74 6f 72 79 2d 63 68 65 63 6b 73 75 6d 3c 2f 69 tory-checksum</i 0a10: 3e 3c 62 72 3e 0a 3c 62 3e 55 3c 2f 62 3e 20 3c ><br>.<b>U</b> < 0a20: 69 3e 75 73 65 72 2d 6c 6f 67 69 6e 3c 2f 69 3e i>user-login</i> 0a30: 3c 62 72 3e 0a 3c 62 3e 5a 3c 2f 62 3e 20 3c 69 <br>.<b>Z</b> <i 0a40: 3e 6d 61 6e 69 66 65 73 74 2d 63 68 65 63 6b 73 >manifest-checks 0a50: 75 6d 3c 2f 69 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 um</i>.</blockqu 0a60: 6f 74 65 3e 0a 0a 3c 70 3e 0a 41 20 6d 61 6e 69 ote>..<p>.A mani 0a70: 66 65 73 74 20 6d 75 73 74 20 68 61 76 65 20 65 fest must have e 0a80: 78 61 63 74 6c 79 20 6f 6e 65 20 43 2d 63 61 72 xactly one C-car 0a90: 64 2e 20 20 54 68 65 20 73 6f 6c 65 20 61 72 67 d. The sole arg 0aa0: 75 6d 65 6e 74 20 74 6f 0a 74 68 65 20 43 2d 63 ument to.the C-c 0ab0: 61 72 64 20 69 73 20 61 20 63 68 65 63 6b 2d 69 ard is a check-i 0ac0: 6e 20 63 6f 6d 6d 65 6e 74 20 74 68 61 74 20 64 n comment that d 0ad0: 65 73 63 72 69 62 65 73 20 74 68 65 20 63 68 65 escribes the che 0ae0: 63 6b 2d 69 6e 20 74 68 61 74 0a 74 68 65 20 6d ck-in that.the m 0af0: 61 6e 69 66 65 73 74 20 64 65 66 69 6e 65 73 2e anifest defines. 0b00: 20 20 54 68 65 20 63 68 65 63 6b 2d 69 6e 20 63 The check-in c 0b10: 6f 6d 6d 65 6e 74 20 69 73 20 74 65 78 74 2e 20 omment is text. 0b20: 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 65 The following.e 0b30: 73 63 61 70 65 20 73 65 71 75 65 6e 63 65 73 20 scape sequences 0b40: 61 72 65 20 61 70 70 6c 69 65 64 20 74 6f 20 74 are applied to t 0b50: 68 65 20 74 65 78 74 3a 0a 41 20 73 70 61 63 65 he text:.A space 0b60: 20 28 41 53 43 49 49 20 30 78 32 30 29 20 69 73 (ASCII 0x20) is 0b70: 20 72 65 70 72 65 73 65 6e 74 65 64 20 61 73 20 represented as 0b80: 22 5c 73 22 20 28 41 53 43 49 49 20 30 78 35 43 "\s" (ASCII 0x5C 0b90: 2c 20 30 78 37 33 29 2e 20 20 41 0a 6e 65 77 6c , 0x73). A.newl 0ba0: 69 6e 65 20 28 41 53 43 49 49 20 30 78 30 61 29 ine (ASCII 0x0a) 0bb0: 20 69 73 20 22 5c 6e 22 20 28 41 53 43 49 49 20 is "\n" (ASCII 0bc0: 30 78 36 43 2c 20 78 36 45 29 2e 20 20 41 20 62 0x6C, x6E). A b 0bd0: 61 63 6b 73 6c 61 73 68 20 0a 28 41 53 43 49 49 ackslash .(ASCII 0be0: 20 30 78 35 43 29 20 69 73 20 72 65 70 72 65 73 0x5C) is repres 0bf0: 65 6e 74 65 64 20 61 73 20 74 77 6f 20 62 61 63 ented as two bac 0c00: 6b 73 6c 61 73 68 65 73 20 22 5c 5c 22 2e 20 20 kslashes "\\". 0c10: 41 70 61 72 74 20 66 72 6f 6d 0a 73 70 61 63 65 Apart from.space 0c20: 20 61 6e 64 20 6e 65 77 6c 69 6e 65 2c 20 6e 6f and newline, no 0c30: 20 6f 74 68 65 72 20 77 68 69 74 65 73 70 61 63 other whitespac 0c40: 65 20 63 68 61 72 61 63 74 65 72 73 20 61 72 65 e characters are 0c50: 20 61 6c 6c 6f 77 65 64 20 69 6e 0a 74 68 65 20 allowed in.the 0c60: 63 68 65 63 6b 2d 69 6e 20 63 6f 6d 6d 65 6e 74 check-in comment 0c70: 2e 20 20 4e 6f 72 20 61 72 65 20 61 6e 79 20 75 . Nor are any u 0c80: 6e 70 72 69 6e 74 61 62 6c 65 20 63 68 61 72 61 nprintable chara 0c90: 63 74 65 72 73 20 61 6c 6c 6f 77 65 64 0a 69 6e cters allowed.in 0ca0: 20 74 68 65 20 63 6f 6d 6d 65 6e 74 2e 0a 3c 2f the comment..</ 0cb0: 70 3e 0a 0a 3c 70 3e 0a 41 20 6d 61 6e 69 66 65 p>..<p>.A manife 0cc0: 73 74 20 6d 75 73 74 20 68 61 76 65 20 65 78 61 st must have exa 0cd0: 63 74 6c 79 20 6f 6e 65 20 44 2d 63 61 72 64 2e ctly one D-card. 0ce0: 20 20 54 68 65 20 73 6f 6c 65 20 61 72 67 75 6d The sole argum 0cf0: 65 6e 74 20 74 6f 0a 74 68 65 20 44 2d 63 61 72 ent to.the D-car 0d00: 64 20 69 73 20 61 20 64 61 74 65 2d 74 69 6d 65 d is a date-time 0d10: 20 73 74 61 6d 70 20 69 6e 20 74 68 65 20 49 53 stamp in the IS 0d20: 4f 38 36 30 31 20 66 6f 72 6d 61 74 2e 20 20 54 O8601 format. T 0d30: 68 65 0a 64 61 74 65 20 61 6e 64 20 74 69 6d 65 he.date and time 0d40: 20 73 68 6f 75 6c 64 20 62 65 20 69 6e 20 63 6f should be in co 0d50: 6f 72 64 69 6e 61 74 65 64 20 75 6e 69 76 65 72 ordinated univer 0d60: 73 61 6c 20 74 69 6d 65 20 28 55 54 43 29 2e 0a sal time (UTC).. 0d70: 54 68 65 20 66 6f 72 6d 61 74 20 69 73 3a 0a 3c The format is:.< 0d80: 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 /p>..<blockquote 0d90: 3e 0a 3c 69 3e 59 59 59 59 3c 2f 69 3e 3c 62 3e >.<i>YYYY</i><b> 0da0: 2d 3c 2f 62 3e 3c 69 3e 4d 4d 3c 2f 69 3e 3c 62 -</b><i>MM</i><b 0db0: 3e 2d 3c 2f 62 3e 3c 69 3e 44 44 3c 2f 69 3e 3c >-</b><i>DD</i>< 0dc0: 62 3e 54 3c 2f 62 3e 3c 69 3e 48 48 3c 2f 69 3e b>T</b><i>HH</i> 0dd0: 3c 62 3e 3a 3c 2f 62 3e 3c 69 3e 4d 4d 3c 2f 69 <b>:</b><i>MM</i 0de0: 3e 3c 62 3e 3a 3c 2f 62 3e 3c 69 3e 53 53 3c 2f ><b>:</b><i>SS</ 0df0: 69 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e i>.</blockquote> 0e00: 0a 0a 3c 70 3e 0a 41 20 6d 61 6e 69 66 65 73 74 ..<p>.A manifest 0e10: 20 68 61 73 20 7a 65 72 6f 20 6f 72 20 6d 6f 72 has zero or mor 0e20: 65 20 46 2d 63 61 72 64 73 2e 20 20 45 61 63 68 e F-cards. Each 0e30: 20 46 2d 63 61 72 64 20 64 65 66 69 6e 65 73 20 F-card defines 0e40: 61 20 66 69 6c 65 0a 28 6f 74 68 65 72 20 74 68 a file.(other th 0e50: 61 6e 20 74 68 65 20 6d 61 6e 69 66 65 73 74 20 an the manifest 0e60: 69 74 73 65 6c 66 29 20 77 68 69 63 68 20 69 73 itself) which is 0e70: 20 70 61 72 74 20 6f 66 20 74 68 65 20 62 61 73 part of the bas 0e80: 65 6c 69 6e 65 20 74 68 61 74 0a 74 68 65 20 6d eline that.the m 0e90: 61 6e 69 66 65 73 74 20 64 65 66 69 6e 65 73 2e anifest defines. 0ea0: 20 20 54 68 65 72 65 20 61 72 65 20 74 77 6f 20 There are two 0eb0: 61 72 67 75 6d 65 6e 74 73 2e 20 20 54 68 65 20 arguments. The 0ec0: 66 69 72 73 74 20 61 72 67 6d 65 6e 74 0a 69 73 first argment.is 0ed0: 20 74 68 65 20 70 61 74 68 6e 61 6d 65 20 6f 66 the pathname of 0ee0: 20 74 68 65 20 66 69 6c 65 20 69 6e 20 74 68 65 the file in the 0ef0: 20 62 61 73 65 6c 69 6e 65 20 72 65 6c 61 74 69 baseline relati 0f00: 76 65 20 74 6f 20 74 68 65 20 72 6f 6f 74 0a 6f ve to the root.o 0f10: 66 20 74 68 65 20 70 72 6f 6a 65 63 74 20 66 69 f the project fi 0f20: 6c 65 20 68 69 65 72 61 72 63 68 79 2e 20 20 4e le hierarchy. N 0f30: 6f 20 22 2e 2e 22 20 6f 72 20 22 2e 22 20 64 69 o ".." or "." di 0f40: 72 65 63 74 6f 72 69 65 73 20 61 72 65 20 61 6c rectories are al 0f50: 6c 6f 77 65 64 0a 77 69 74 68 69 6e 20 74 68 65 lowed.within the 0f60: 20 66 69 6c 65 6e 61 6d 65 2e 20 20 53 70 61 63 filename. Spac 0f70: 65 20 63 68 61 72 61 63 74 65 72 73 20 61 72 65 e characters are 0f80: 20 65 73 63 61 70 65 64 20 61 73 20 69 6e 20 43 escaped as in C 0f90: 2d 63 61 72 64 0a 63 6f 6d 6d 65 6e 74 20 74 65 -card.comment te 0fa0: 78 74 2e 20 20 42 61 63 6b 73 6c 61 73 68 20 63 xt. Backslash c 0fb0: 68 61 72 61 63 74 65 72 73 20 61 6e 64 20 6e 65 haracters and ne 0fc0: 77 6c 69 6e 65 73 20 61 72 65 20 6e 6f 74 20 61 wlines are not a 0fd0: 6c 6c 6f 77 65 64 0a 77 69 74 68 69 6e 20 66 69 llowed.within fi 0fe0: 6c 65 6e 61 6d 65 73 2e 20 20 54 68 65 20 64 69 lenames. The di 0ff0: 72 65 63 74 6f 72 79 20 73 65 70 61 72 61 74 6f rectory separato 1000: 72 20 63 68 61 72 61 63 74 65 72 20 69 73 20 61 r character is a 1010: 20 66 6f 72 77 61 72 64 0a 73 6c 61 73 68 20 28 forward.slash ( 1020: 41 53 43 49 49 20 30 78 32 46 29 2e 20 20 54 68 ASCII 0x2F). Th 1030: 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e e second argumen 1040: 74 20 74 6f 20 74 68 65 20 46 2d 63 61 72 64 20 t to the F-card 1050: 69 73 20 74 68 65 0a 66 75 6c 6c 20 34 30 2d 63 is the.full 40-c 1060: 68 61 72 61 63 74 65 72 20 6c 6f 77 65 72 2d 63 haracter lower-c 1070: 61 73 65 20 68 65 78 61 64 65 63 69 6d 61 6c 20 ase hexadecimal 1080: 53 48 41 31 20 68 61 73 68 20 6f 66 20 74 68 65 SHA1 hash of the 1090: 20 63 6f 6e 74 65 6e 74 0a 61 72 74 69 66 61 63 content.artifac 10a0: 74 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 41 20 6d t..</p>..<p>.A m 10b0: 61 6e 69 66 65 73 74 20 68 61 73 20 7a 65 72 6f anifest has zero 10c0: 20 6f 72 20 6f 6e 65 20 50 2d 63 61 72 64 73 2e or one P-cards. 10d0: 20 20 4d 6f 73 74 20 6d 61 6e 69 66 65 73 74 73 Most manifests 10e0: 20 68 61 76 65 20 6f 6e 65 20 50 2d 63 61 72 64 have one P-card 10f0: 2e 0a 54 68 65 20 50 2d 63 61 72 64 20 68 61 73 ..The P-card has 1100: 20 61 20 76 61 72 79 69 6e 67 20 6e 75 6d 62 65 a varying numbe 1110: 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 20 74 r of arguments t 1120: 68 61 74 0a 64 65 66 69 6e 65 73 20 6f 74 68 65 hat.defines othe 1130: 72 20 6d 61 6e 69 66 65 73 74 73 20 66 72 6f 6d r manifests from 1140: 20 77 68 69 63 68 20 74 68 65 20 63 75 72 72 65 which the curre 1150: 6e 74 20 6d 61 6e 69 66 65 73 74 0a 69 73 20 64 nt manifest.is d 1160: 65 72 69 76 65 64 2e 20 20 45 61 63 68 20 61 72 erived. Each ar 1170: 67 75 6d 65 6e 74 20 69 73 20 61 6e 20 34 30 2d gument is an 40- 1180: 63 68 61 72 61 63 74 65 72 20 6c 6f 77 65 72 63 character lowerc 1190: 61 73 65 20 0a 68 65 78 61 64 65 63 69 6d 61 6c ase .hexadecimal 11a0: 20 53 48 41 31 20 6f 66 20 74 68 65 20 70 72 65 SHA1 of the pre 11b0: 64 65 63 65 73 73 6f 72 20 6d 61 6e 69 66 65 73 decessor manifes 11c0: 74 2e 20 20 41 6c 6c 20 61 72 67 75 6d 65 6e 74 t. All argument 11d0: 73 0a 74 6f 20 74 68 65 20 50 2d 63 61 72 64 20 s.to the P-card 11e0: 6d 75 73 74 20 62 65 20 75 6e 69 71 75 65 20 74 must be unique t 11f0: 6f 20 74 68 61 74 20 6c 69 6e 65 2e 0a 54 68 65 o that line..The 1200: 20 66 69 72 73 74 20 70 72 65 64 65 63 65 73 73 first predecess 1210: 6f 72 20 69 73 20 74 68 65 20 64 69 72 65 63 74 or is the direct 1220: 20 61 6e 63 65 73 74 6f 72 20 6f 66 20 74 68 65 ancestor of the 1230: 20 6d 61 6e 69 66 65 73 74 2e 0a 4f 74 68 65 72 manifest..Other 1240: 20 61 72 67 75 6d 65 6e 74 73 20 64 65 66 69 6e arguments defin 1250: 65 20 6d 61 6e 69 66 65 73 74 73 20 77 69 74 68 e manifests with 1260: 20 77 68 69 63 68 20 74 68 65 20 66 69 72 73 74 which the first 1270: 20 77 61 73 0a 6d 65 72 67 65 64 20 74 6f 20 79 was.merged to y 1280: 69 65 6c 64 20 74 68 65 20 63 75 72 72 65 6e 74 ield the current 1290: 20 6d 61 6e 69 66 65 73 74 2e 20 20 4d 6f 73 74 manifest. Most 12a0: 20 6d 61 6e 69 66 65 73 74 73 20 68 61 76 65 0a manifests have. 12b0: 61 20 50 2d 63 61 72 64 20 77 69 74 68 20 61 20 a P-card with a 12c0: 73 69 6e 67 6c 65 20 61 72 67 75 6d 65 6e 74 2e single argument. 12d0: 20 20 54 68 65 20 66 69 72 73 74 20 6d 61 6e 69 The first mani 12e0: 66 65 73 74 20 69 6e 20 74 68 65 0a 70 72 6f 6a fest in the.proj 12f0: 65 63 74 20 68 61 73 20 6e 6f 20 61 6e 63 65 73 ect has no ances 1300: 74 6f 72 73 20 61 6e 64 20 74 68 75 73 20 68 61 tors and thus ha 1310: 73 20 6e 6f 20 50 2d 63 61 72 64 2e 0a 3c 2f 70 s no P-card..</p 1320: 3e 0a 0a 3c 70 3e 0a 41 20 6d 61 6e 69 66 65 73 >..<p>.A manifes 1330: 74 20 6d 61 79 20 6f 70 74 69 6f 6e 61 6c 6c 79 t may optionally 1340: 20 68 61 76 65 20 61 20 73 69 6e 67 6c 65 20 52 have a single R 1350: 2d 63 61 72 64 2e 20 20 54 68 65 20 52 2d 63 61 -card. The R-ca 1360: 72 64 20 68 61 73 0a 61 20 73 69 6e 67 6c 65 20 rd has.a single 1370: 61 72 67 75 6d 65 6e 74 20 77 68 69 63 68 20 69 argument which i 1380: 73 20 74 68 65 20 4d 44 35 20 63 68 65 63 6b 73 s the MD5 checks 1390: 75 6d 20 6f 66 20 61 6c 6c 20 66 69 6c 65 73 20 um of all files 13a0: 69 6e 20 0a 74 68 65 20 62 61 73 65 6c 69 6e 65 in .the baseline 13b0: 20 65 78 63 65 70 74 20 74 68 65 20 6d 61 6e 69 except the mani 13c0: 66 65 73 74 20 69 74 73 65 6c 66 2e 20 20 54 68 fest itself. Th 13d0: 65 20 63 68 65 63 6b 73 75 6d 20 69 73 20 65 78 e checksum is ex 13e0: 70 72 65 73 73 65 64 0a 61 73 20 33 32 2d 63 68 pressed.as 32-ch 13f0: 61 72 61 63 74 65 72 73 20 6f 66 20 6c 6f 77 65 aracters of lowe 1400: 72 63 61 73 65 20 68 65 78 61 64 65 63 69 6d 61 rcase hexadecima 1410: 6c 2e 20 20 20 54 68 65 20 63 68 65 63 6b 73 75 l. The checksu 1420: 6d 20 69 73 0a 63 6f 6d 70 75 74 65 64 20 61 73 m is.computed as 1430: 20 66 6f 6c 6c 6f 77 73 3a 20 20 46 6f 72 20 65 follows: For e 1440: 61 63 68 20 66 69 6c 65 20 69 6e 20 74 68 65 20 ach file in the 1450: 62 61 73 65 6c 69 6e 65 20 28 65 78 63 65 70 74 baseline (except 1460: 20 66 6f 72 0a 74 68 65 20 6d 61 6e 69 66 65 73 for.the manifes 1470: 74 20 69 74 73 65 6c 66 29 20 69 6e 20 73 74 72 t itself) in str 1480: 69 63 74 20 73 6f 72 74 65 64 20 6c 65 78 69 63 ict sorted lexic 1490: 6f 67 72 61 70 68 69 63 61 6c 20 6f 72 64 65 72 ographical order 14a0: 2c 20 0a 74 61 6b 65 20 74 68 65 20 70 61 74 68 , .take the path 14b0: 6e 61 6d 65 20 6f 66 20 74 68 65 20 66 69 6c 65 name of the file 14c0: 20 72 65 6c 61 74 69 76 65 20 74 6f 20 74 68 65 relative to the 14d0: 20 72 6f 6f 74 20 6f 66 20 74 68 65 0a 72 65 70 root of the.rep 14e0: 6f 73 69 74 6f 72 79 2c 20 61 70 70 65 6e 64 20 ository, append 14f0: 61 20 73 69 6e 67 6c 65 20 73 70 61 63 65 20 28 a single space ( 1500: 41 53 43 49 49 20 30 78 32 30 29 2c 20 74 68 65 ASCII 0x20), the 1510: 0a 73 69 7a 65 20 6f 66 20 74 68 65 20 66 69 6c .size of the fil 1520: 65 20 69 6e 20 41 53 43 49 49 20 64 65 63 69 6d e in ASCII decim 1530: 61 6c 2c 20 61 20 73 69 6e 67 6c 65 20 6e 65 77 al, a single new 1540: 6c 69 6e 65 0a 63 68 61 72 61 63 74 65 72 20 28 line.character ( 1550: 41 53 43 49 49 20 30 78 30 41 29 2c 20 61 6e 64 ASCII 0x0A), and 1560: 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 20 74 65 the complete te 1570: 78 74 20 6f 66 20 74 68 65 20 66 69 6c 65 2e 0a xt of the file.. 1580: 43 6f 6d 70 75 74 65 20 74 68 65 20 4d 44 35 20 Compute the MD5 1590: 63 68 65 63 6b 73 75 6d 20 6f 66 20 74 68 65 20 checksum of the 15a0: 74 68 65 20 72 65 73 75 6c 74 2e 0a 3c 2f 70 3e the result..</p> 15b0: 0a 0a 3c 70 3e 0a 45 61 63 68 20 6d 61 6e 69 66 ..<p>.Each manif 15c0: 65 73 74 20 68 61 73 20 61 20 73 69 6e 67 6c 65 est has a single 15d0: 20 55 2d 63 61 72 64 2e 20 20 54 68 65 20 61 72 U-card. The ar 15e0: 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 55 2d gument to the U- 15f0: 63 61 72 64 20 69 73 0a 74 68 65 20 6c 6f 67 69 card is.the logi 1600: 6e 20 6f 66 20 74 68 65 20 75 73 65 72 20 77 68 n of the user wh 1610: 6f 20 63 72 65 61 74 65 64 20 74 68 65 20 6d 61 o created the ma 1620: 6e 69 66 65 73 74 2e 20 20 54 68 65 20 6c 6f 67 nifest. The log 1630: 69 6e 20 6e 61 6d 65 0a 69 73 20 65 6e 63 6f 64 in name.is encod 1640: 65 64 20 75 73 69 6e 67 20 74 68 65 20 73 61 6d ed using the sam 1650: 65 20 63 68 61 72 61 63 74 65 72 20 65 73 63 61 e character esca 1660: 70 65 73 20 61 73 20 69 73 20 75 73 65 64 20 66 pes as is used f 1670: 6f 72 20 74 68 65 0a 63 68 65 63 6b 2d 69 6e 20 or the.check-in 1680: 63 6f 6d 6d 65 6e 74 20 61 72 67 75 6d 65 6e 74 comment argument 1690: 20 74 6f 20 74 68 65 20 43 2d 63 61 72 64 2e 0a to the C-card.. 16a0: 3c 2f 70 3e 0a 0a 3c 70 3e 0a 41 20 6d 61 6e 69 </p>..<p>.A mani 16b0: 66 65 73 74 20 68 61 73 20 61 6e 20 6f 70 74 69 fest has an opti 16c0: 6f 6e 20 5a 2d 63 61 72 64 20 61 73 20 69 74 73 on Z-card as its 16d0: 20 6c 61 73 74 20 6c 69 6e 65 2e 20 20 54 68 65 last line. The 16e0: 20 61 72 67 75 6d 65 6e 74 0a 74 6f 20 74 68 65 argument.to the 16f0: 20 5a 2d 63 61 72 64 20 69 73 20 61 20 33 32 2d Z-card is a 32- 1700: 63 68 61 72 61 63 74 65 72 20 6c 6f 77 65 72 63 character lowerc 1710: 61 73 65 20 68 65 78 61 64 65 63 69 6d 61 6c 20 ase hexadecimal 1720: 4d 44 35 20 68 61 73 68 0a 6f 66 20 61 6c 6c 20 MD5 hash.of all 1730: 70 72 69 6f 72 20 6c 69 6e 65 73 20 6f 66 20 74 prior lines of t 1740: 68 65 20 6d 61 6e 69 66 65 73 74 20 75 70 20 74 he manifest up t 1750: 6f 20 61 6e 64 20 69 6e 63 6c 75 64 69 6e 67 20 o and including 1760: 74 68 65 20 6e 65 77 6c 69 6e 65 20 0a 63 68 61 the newline .cha 1770: 72 61 63 74 65 72 20 74 68 61 74 20 69 6d 6d 65 racter that imme 1780: 64 69 61 74 65 6c 79 20 70 72 65 63 65 65 64 73 diately preceeds 1790: 20 74 68 65 20 22 5a 22 2e 20 20 54 68 65 20 5a the "Z". The Z 17a0: 2d 63 61 72 64 20 69 73 20 6a 75 73 74 0a 61 20 -card is just.a 17b0: 73 61 6e 69 74 79 20 63 68 65 63 6b 20 74 6f 20 sanity check to 17c0: 70 72 6f 76 65 20 74 68 61 74 20 74 68 65 20 6d prove that the m 17d0: 61 6e 69 66 65 73 74 20 69 73 20 77 65 6c 6c 2d anifest is well- 17e0: 66 6f 72 6d 65 64 20 61 6e 64 0a 63 6f 6e 73 69 formed and.consi 17f0: 73 74 65 6e 74 2e 0a 3c 2f 70 3e 0a 0a 3c 68 32 stent..</p>..<h2 1800: 3e 32 2e 30 20 43 6c 75 73 74 65 72 73 3c 2f 68 >2.0 Clusters</h 1810: 32 3e 0a 0a 3c 70 3e 0a 41 20 63 6c 75 73 74 65 2>..<p>.A cluste 1820: 72 20 69 73 20 61 20 61 72 74 69 66 61 63 74 20 r is a artifact 1830: 74 68 61 74 20 64 65 63 6c 61 72 65 73 20 74 68 that declares th 1840: 65 20 65 78 69 73 74 61 6e 63 65 20 6f 66 20 6f e existance of o 1850: 74 68 65 72 20 61 72 74 69 66 61 63 74 73 2e 0a ther artifacts.. 1860: 43 6c 75 73 74 65 72 73 20 61 72 65 20 75 73 65 Clusters are use 1870: 64 20 64 75 72 69 6e 67 20 72 65 70 6f 73 69 74 d during reposit 1880: 6f 72 79 20 73 79 6e 63 68 72 6f 6e 69 7a 61 74 ory synchronizat 1890: 69 6f 6e 20 74 6f 20 68 65 6c 70 20 0a 72 65 64 ion to help .red 18a0: 75 63 65 20 6e 65 74 77 6f 72 6b 20 74 72 61 66 uce network traf 18b0: 66 69 63 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 43 fic..</p>..<p>.C 18c0: 6c 75 73 74 65 72 73 20 66 6f 6c 6c 6f 77 20 61 lusters follow a 18d0: 20 73 79 6e 74 61 78 20 74 68 61 74 20 69 73 20 syntax that is 18e0: 76 65 72 79 20 73 69 6d 69 6c 61 72 20 74 6f 20 very similar to 18f0: 6d 61 6e 69 66 65 73 74 73 2e 0a 41 20 43 6c 75 manifests..A Clu 1900: 73 74 65 72 20 69 73 20 61 20 6c 69 6e 65 2d 6f ster is a line-o 1910: 72 69 65 6e 74 65 64 20 74 65 78 74 20 66 69 6c riented text fil 1920: 65 2e 20 20 4e 65 77 6c 69 6e 65 20 63 68 61 72 e. Newline char 1930: 61 63 74 65 72 73 0a 28 41 53 43 49 49 20 30 78 acters.(ASCII 0x 1940: 30 61 29 20 73 65 70 61 72 61 74 65 20 74 68 65 0a) separate the 1950: 20 61 72 74 69 66 61 63 74 20 69 6e 74 6f 20 63 artifact into c 1960: 61 72 64 73 2e 20 20 45 61 63 68 20 63 61 72 64 ards. Each card 1970: 20 62 65 67 69 6e 73 20 77 69 74 68 20 61 20 73 begins with a s 1980: 69 6e 67 6c 65 0a 63 68 61 72 61 63 74 65 72 20 ingle.character 1990: 22 63 61 72 64 20 74 79 70 65 22 2e 20 20 5a 65 "card type". Ze 19a0: 72 6f 20 6f 72 20 6d 6f 72 65 20 61 72 67 75 6d ro or more argum 19b0: 65 6e 74 73 20 6d 61 79 20 66 6f 6c 6c 6f 77 0a ents may follow. 19c0: 74 68 65 20 63 61 72 64 20 74 79 70 65 2e 20 20 the card type. 19d0: 41 6c 6c 20 61 72 67 75 6d 65 6e 74 73 20 61 72 All arguments ar 19e0: 65 20 73 65 70 61 72 61 74 65 64 20 66 72 6f 6d e separated from 19f0: 20 65 61 63 68 20 6f 74 68 65 72 0a 61 6e 64 20 each other.and 1a00: 66 72 6f 6d 20 74 68 65 20 63 61 72 64 2d 74 79 from the card-ty 1a10: 70 65 20 63 68 61 72 61 63 74 65 72 20 62 79 20 pe character by 1a20: 61 20 73 69 6e 67 6c 65 20 73 70 61 63 65 0a 63 a single space.c 1a30: 68 61 72 61 63 74 65 72 2e 20 20 54 68 65 72 65 haracter. There 1a40: 20 69 73 20 6e 6f 20 73 75 72 70 6c 75 73 20 77 is no surplus w 1a50: 68 69 74 65 20 73 70 61 63 65 20 62 65 74 77 65 hite space betwe 1a60: 65 6e 20 61 72 67 75 6d 65 6e 74 73 0a 61 6e 64 en arguments.and 1a70: 20 6e 6f 20 6c 65 61 64 69 6e 67 20 6f 72 20 74 no leading or t 1a80: 72 61 69 6c 69 6e 67 20 77 68 69 74 65 73 70 61 railing whitespa 1a90: 63 65 20 65 78 63 65 70 74 20 66 6f 72 20 74 68 ce except for th 1aa0: 65 20 6e 65 77 6c 69 6e 65 20 0a 63 68 61 72 61 e newline .chara 1ab0: 63 74 65 72 20 74 68 61 74 20 61 63 74 73 20 61 cter that acts a 1ac0: 73 20 74 68 65 20 63 61 72 64 20 73 65 70 61 72 s the card separ 1ad0: 61 74 6f 72 2e 0a 41 6c 6c 20 63 61 72 64 73 20 ator..All cards 1ae0: 6f 66 20 61 20 63 6c 75 74 65 72 20 6f 63 63 75 of a cluter occu 1af0: 72 20 69 6e 20 73 74 72 69 63 74 20 73 6f 72 74 r in strict sort 1b00: 65 64 20 6c 65 78 69 63 6f 67 72 61 70 68 69 63 ed lexicographic 1b10: 61 6c 20 6f 72 64 65 72 2e 0a 4e 6f 20 63 61 72 al order..No car 1b20: 64 20 6d 61 79 20 62 65 20 64 75 70 6c 69 63 61 d may be duplica 1b30: 74 65 64 2e 0a 54 68 65 20 63 6c 75 73 74 65 72 ted..The cluster 1b40: 20 6d 61 79 20 6e 6f 74 20 63 6f 6e 74 61 69 6e may not contain 1b50: 20 61 64 64 69 74 69 6f 6e 61 6c 20 74 65 78 74 additional text 1b60: 20 6f 72 20 64 61 74 61 20 62 65 79 6f 6e 64 20 or data beyond 1b70: 0a 77 68 61 74 20 69 73 20 64 65 73 63 72 69 62 .what is describ 1b80: 65 64 20 68 65 72 65 2e 0a 55 6e 6c 69 6b 65 20 ed here..Unlike 1b90: 6d 61 6e 69 66 65 73 74 73 2c 20 63 6c 75 73 74 manifests, clust 1ba0: 65 72 73 20 61 72 65 20 6e 65 76 65 72 20 50 47 ers are never PG 1bb0: 50 20 73 69 67 6e 65 64 2e 0a 3c 2f 70 3e 0a 0a P signed..</p>.. 1bc0: 3c 70 3e 0a 41 6c 6c 6f 77 65 64 20 63 61 72 64 <p>.Allowed card 1bd0: 73 20 69 6e 20 74 68 65 20 63 6c 75 73 74 65 72 s in the cluster 1be0: 20 61 72 65 20 61 73 20 66 6f 6c 6c 6f 77 73 3a are as follows: 1bf0: 0a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f .</p>..<blockquo 1c00: 74 65 3e 0a 3c 62 3e 4d 3c 2f 62 3e 20 3c 69 3e te>.<b>M</b> <i> 1c10: 75 75 69 64 3c 2f 69 3e 3c 62 72 20 2f 3e 0a 3c uuid</i><br />.< 1c20: 62 3e 5a 3c 2f 62 3e 20 3c 69 3e 63 68 65 63 6b b>Z</b> <i>check 1c30: 73 75 6d 3c 2f 69 3e 0a 3c 2f 62 6c 6f 63 6b 71 sum</i>.</blockq 1c40: 75 6f 74 65 3e 0a 0a 3c 70 3e 0a 41 20 63 6c 75 uote>..<p>.A clu 1c50: 73 74 65 72 20 63 6f 6e 74 61 69 6e 73 20 6f 6e ster contains on 1c60: 65 20 6f 72 20 6d 6f 72 65 20 22 4d 22 20 63 61 e or more "M" ca 1c70: 72 64 73 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 rds followed by 1c80: 61 20 73 69 6e 67 6c 65 20 22 5a 22 0a 6c 69 6e a single "Z".lin 1c90: 65 2e 20 20 45 61 63 68 20 4d 20 63 61 72 64 20 e. Each M card 1ca0: 68 61 73 20 61 20 73 69 6e 67 6c 65 20 61 72 67 has a single arg 1cb0: 75 6d 65 6e 74 20 77 68 69 63 68 20 69 73 20 74 ument which is t 1cc0: 68 65 20 55 55 49 44 20 6f 66 20 0a 61 6e 6f 74 he UUID of .anot 1cd0: 68 65 72 20 61 72 74 69 66 61 63 74 20 69 6e 20 her artifact in 1ce0: 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 2e 20 the repository. 1cf0: 20 54 68 65 20 5a 20 63 61 72 64 20 77 6f 72 6b The Z card work 1d00: 20 65 78 61 63 74 6c 79 20 6c 69 6b 65 0a 74 68 exactly like.th 1d10: 65 20 5a 20 63 61 72 64 20 6f 66 20 61 20 6d 61 e Z card of a ma 1d20: 6e 69 66 65 73 74 2e 20 20 54 68 65 20 61 72 67 nifest. The arg 1d30: 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 5a 20 63 ument to the Z c 1d40: 61 72 64 20 69 73 20 74 68 65 0a 6c 6f 77 65 72 ard is the.lower 1d50: 2d 63 61 73 65 20 68 65 78 61 64 65 63 69 6d 61 -case hexadecima 1d60: 6c 20 72 65 70 72 65 73 65 6e 74 61 74 69 6f 6e l representation 1d70: 20 6f 66 20 74 68 65 20 4d 44 35 20 63 68 65 63 of the MD5 chec 1d80: 6b 73 75 6d 20 6f 66 20 61 6c 6c 0a 70 72 69 6f ksum of all.prio 1d90: 72 20 63 61 72 64 73 20 69 6e 20 74 68 65 20 63 r cards in the c 1da0: 6c 75 73 74 65 72 2e 20 20 4e 6f 74 65 20 74 68 luster. Note th 1db0: 61 74 20 74 68 65 20 5a 20 63 61 72 64 20 69 73 at the Z card is 1dc0: 20 72 65 71 75 69 72 65 64 0a 6f 6e 20 61 20 63 required.on a c 1dd0: 6c 75 73 74 65 72 2e 0a 3c 2f 70 3e 0a 0a 0a 3c luster..</p>...< 1de0: 68 32 3e 33 2e 30 20 43 6f 6e 74 72 6f 6c 20 41 h2>3.0 Control A 1df0: 72 74 69 66 61 63 74 73 3c 2f 68 32 3e 0a 0a 3c rtifacts</h2>..< 1e00: 70 3e 0a 43 6f 6e 74 72 6f 6c 20 61 72 74 69 66 p>.Control artif 1e10: 61 63 74 73 20 61 72 65 20 75 73 65 64 20 74 6f acts are used to 1e20: 20 61 73 73 69 67 6e 20 70 72 6f 70 65 72 74 69 assign properti 1e30: 65 73 20 74 6f 20 6f 74 68 65 72 20 61 72 74 69 es to other arti 1e40: 66 61 63 74 73 0a 77 69 74 68 69 6e 20 74 68 65 facts.within the 1e50: 20 72 65 70 6f 73 69 74 6f 72 79 2e 20 20 54 68 repository. Th 1e60: 65 20 62 61 73 69 63 20 66 6f 72 6d 61 74 20 6f e basic format o 1e70: 66 20 61 20 63 6f 6e 74 72 6f 6c 20 61 72 74 69 f a control arti 1e80: 66 61 63 74 20 69 73 0a 74 68 65 20 73 61 6d 65 fact is.the same 1e90: 20 61 73 20 61 20 6d 61 6e 69 66 65 73 74 20 6f as a manifest o 1ea0: 72 20 63 6c 75 73 74 65 72 2e 20 20 41 20 63 6f r cluster. A co 1eb0: 6e 74 72 6f 6c 20 61 72 74 69 66 61 63 74 20 69 ntrol artifact i 1ec0: 73 20 61 20 74 65 78 74 0a 66 69 6c 65 73 20 64 s a text.files d 1ed0: 69 76 69 64 65 64 20 69 6e 74 6f 20 63 61 72 64 ivided into card 1ee0: 73 20 62 79 20 6e 65 77 6c 69 6e 65 20 63 68 61 s by newline cha 1ef0: 72 61 63 74 65 72 73 2e 20 20 45 61 63 68 20 63 racters. Each c 1f00: 61 72 64 20 68 61 73 20 61 0a 73 69 6e 67 6c 65 ard has a.single 1f10: 2d 63 68 61 72 61 63 74 65 72 20 63 61 72 64 20 -character card 1f20: 74 79 70 65 20 66 6f 6c 6c 6f 77 65 64 20 62 79 type followed by 1f30: 20 61 72 67 75 6d 65 6e 74 73 2e 20 20 53 70 61 arguments. Spa 1f40: 63 65 73 20 73 65 70 61 72 61 74 65 0a 74 68 65 ces separate.the 1f50: 20 63 61 72 64 20 74 79 70 65 20 61 6e 64 20 74 card type and t 1f60: 68 65 20 61 72 67 75 6d 65 6e 74 73 2e 20 20 4e he arguments. N 1f70: 6f 20 73 75 72 70 6c 75 73 20 77 68 69 74 65 73 o surplus whites 1f80: 70 61 63 65 20 69 73 20 61 6c 6c 6f 77 65 64 2e pace is allowed. 1f90: 0a 41 6c 6c 20 63 61 72 64 73 20 6d 75 73 74 20 .All cards must 1fa0: 6f 63 63 75 72 20 69 6e 20 73 74 72 69 63 74 20 occur in strict 1fb0: 6c 65 78 69 67 72 61 70 68 69 63 61 6c 20 6f 72 lexigraphical or 1fc0: 64 65 72 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 41 der..</p>..<p>.A 1fd0: 6c 6c 6f 77 65 64 20 63 61 72 64 73 20 69 6e 20 llowed cards in 1fe0: 61 20 63 6f 6e 74 72 6f 6c 20 61 72 74 69 66 61 a control artifa 1ff0: 63 74 20 61 72 65 20 61 73 20 66 6f 6c 6c 6f 77 ct are as follow 2000: 73 3a 0a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 s:.</p>..<blockq 2010: 75 6f 74 65 3e 0a 3c 62 3e 44 3c 2f 62 3e 20 3c uote>.<b>D</b> < 2020: 69 3e 74 69 6d 65 2d 61 6e 64 2d 64 61 74 65 2d i>time-and-date- 2030: 73 74 61 6d 70 3c 2f 69 3e 3c 62 72 20 2f 3e 0a stamp</i><br />. 2040: 3c 62 3e 54 3c 2f 62 3e 20 28 3c 62 3e 2b 3c 2f <b>T</b> (<b>+</ 2050: 62 3e 7c 3c 62 3e 2d 3c 2f 62 3e 7c 3c 62 3e 2a b>|<b>-</b>|<b>* 2060: 3c 2f 62 3e 29 3c 69 3e 74 61 67 2d 6e 61 6d 65 </b>)<i>tag-name 2070: 20 20 75 75 69 64 20 20 3f 76 61 6c 75 65 3f 3c uuid ?value?< 2080: 2f 69 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 5a 3c 2f /i><br />.<b>Z</ 2090: 62 3e 20 3c 69 3e 63 68 65 63 6b 73 75 6d 3c 2f b> <i>checksum</ 20a0: 69 3e 3c 62 72 20 2f 3e 0a 3c 2f 62 6c 6f 63 6b i><br />.</block 20b0: 71 75 6f 74 65 3e 0a 0a 3c 70 3e 0a 41 20 63 6f quote>..<p>.A co 20c0: 6e 74 72 6f 6c 20 61 72 74 69 66 61 63 74 20 6d ntrol artifact m 20d0: 75 73 74 20 68 61 76 65 20 6f 6e 65 20 44 20 63 ust have one D c 20e0: 61 72 64 20 61 6e 64 20 6f 6e 65 20 5a 20 63 61 ard and one Z ca 20f0: 72 64 20 61 6e 64 0a 6f 6e 65 20 6f 72 20 6d 6f rd and.one or mo 2100: 72 65 20 6f 72 20 6d 6f 72 65 20 54 20 63 61 72 re or more T car 2110: 64 73 2e 20 20 4e 6f 20 6f 74 68 65 72 20 63 61 ds. No other ca 2120: 72 64 73 20 6f 72 20 6f 74 68 65 72 20 74 65 78 rds or other tex 2130: 74 20 69 73 0a 61 6c 6c 6f 77 65 64 20 69 6e 20 t is.allowed in 2140: 61 20 63 6f 6e 74 72 6f 6c 20 61 72 74 69 66 61 a control artifa 2150: 63 74 2e 20 20 43 6f 6e 74 72 6f 6c 20 61 72 74 ct. Control art 2160: 69 66 61 63 74 73 20 6d 69 67 68 74 20 62 65 20 ifacts might be 2170: 50 47 50 0a 63 6c 65 61 72 73 69 67 6e 65 64 2e PGP.clearsigned. 2180: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 44 20 63 </p>..<p>The D c 2190: 61 72 64 20 61 6e 64 20 74 68 65 20 5a 20 63 61 ard and the Z ca 21a0: 72 64 20 6f 66 20 61 20 63 6f 6e 74 72 6f 6c 20 rd of a control 21b0: 61 72 74 69 66 61 63 74 20 61 72 65 20 74 68 65 artifact are the 21c0: 20 73 61 6d 65 0a 61 73 20 69 6e 20 61 20 6d 61 same.as in a ma 21d0: 6e 69 66 65 73 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e nifest.</p>..<p> 21e0: 54 68 65 20 54 20 63 61 72 64 20 72 65 70 72 65 The T card repre 21f0: 73 65 6e 74 73 20 61 20 22 74 61 67 22 20 6f 72 sents a "tag" or 2200: 20 70 72 6f 70 65 72 74 79 20 74 68 61 74 20 69 property that i 2210: 73 20 61 70 70 6c 69 65 64 20 74 6f 0a 73 6f 6d s applied to.som 2220: 65 20 6f 74 68 65 72 20 61 72 74 69 66 61 63 74 e other artifact 2230: 2e 20 20 54 68 65 20 54 20 63 61 72 64 20 68 61 . The T card ha 2240: 73 20 74 77 6f 20 6f 72 20 74 68 72 65 65 20 76 s two or three v 2250: 61 6c 75 65 73 2e 20 20 54 68 65 0a 73 65 63 6f alues. The.seco 2260: 6e 64 20 61 72 67 75 6d 65 6e 74 20 69 73 20 74 nd argument is t 2270: 68 65 20 34 30 20 63 68 61 72 61 63 74 65 72 20 he 40 character 2280: 6c 6f 77 65 72 63 61 73 65 20 55 55 49 44 20 6f lowercase UUID o 2290: 66 20 74 68 65 20 61 72 74 69 66 61 63 74 0a 74 f the artifact.t 22a0: 6f 20 77 68 69 63 68 20 74 68 65 20 74 61 67 20 o which the tag 22b0: 69 73 20 74 6f 20 62 65 20 61 70 70 6c 69 65 64 is to be applied 22c0: 2e 20 54 68 65 0a 66 69 72 73 74 20 76 61 6c 75 . The.first valu 22d0: 65 20 69 73 20 74 68 65 20 74 61 67 20 6e 61 6d e is the tag nam 22e0: 65 2e 20 20 54 68 65 20 66 69 72 73 74 20 63 68 e. The first ch 22f0: 61 72 61 63 74 65 72 20 6f 66 20 74 68 65 20 74 aracter of the t 2300: 61 67 0a 69 73 20 65 69 74 68 65 72 20 22 2b 22 ag.is either "+" 2310: 2c 20 22 2d 22 2c 20 6f 72 20 22 2a 22 2e 20 20 , "-", or "*". 2320: 41 20 22 2b 22 20 6d 65 61 6e 73 20 74 68 65 20 A "+" means the 2330: 74 61 67 20 73 68 6f 75 6c 64 20 62 65 20 61 64 tag should be ad 2340: 64 65 64 0a 74 6f 20 74 68 65 20 61 72 74 69 66 ded.to the artif 2350: 61 63 74 2e 20 20 54 68 65 20 22 2d 22 20 6d 65 act. The "-" me 2360: 61 6e 73 20 74 68 65 20 74 61 67 20 73 68 6f 75 ans the tag shou 2370: 6c 64 20 62 65 20 72 65 6d 6f 76 65 64 2e 0a 54 ld be removed..T 2380: 68 65 20 22 2a 22 20 63 68 61 72 61 63 74 65 72 he "*" character 2390: 20 6d 65 61 6e 73 20 74 68 65 20 74 61 67 20 73 means the tag s 23a0: 68 6f 75 6c 64 20 62 65 20 61 64 64 65 64 20 74 hould be added t 23b0: 6f 20 74 68 65 20 61 72 74 69 66 61 63 74 0a 61 o the artifact.a 23c0: 6e 64 20 61 6c 6c 20 64 69 72 65 63 74 20 64 65 nd all direct de 23d0: 63 65 6e 64 61 6e 74 73 20 28 62 75 74 20 6e 6f cendants (but no 23e0: 74 20 62 72 61 6e 63 68 65 73 29 20 6f 66 20 74 t branches) of t 23f0: 68 65 20 61 72 74 69 66 61 63 74 20 64 6f 77 6e he artifact down 2400: 0a 74 6f 20 62 75 74 20 6e 6f 74 20 69 6e 63 6c .to but not incl 2410: 75 64 69 6e 67 20 74 68 65 20 66 69 72 73 74 20 uding the first 2420: 64 65 63 65 6e 64 61 6e 74 20 74 68 61 74 20 63 decendant that c 2430: 6f 6e 74 61 69 6e 73 20 61 20 0a 6d 6f 72 65 20 ontains a .more 2440: 72 65 63 65 6e 74 20 22 2d 22 20 74 61 67 20 77 recent "-" tag w 2450: 69 74 68 20 74 68 65 20 73 61 6d 65 20 6e 61 6d ith the same nam 2460: 65 2e 0a 54 68 65 20 6f 70 74 69 6f 6e 61 6c 20 e..The optional 2470: 74 68 69 72 64 20 61 72 67 75 6d 65 6e 74 20 69 third argument i 2480: 73 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 s the value of t 2490: 68 65 20 74 61 67 2e 20 20 41 20 74 61 67 0a 77 he tag. A tag.w 24a0: 69 74 68 6f 75 74 20 61 20 76 61 6c 75 65 20 69 ithout a value i 24b0: 73 20 61 20 62 6f 6f 6c 65 61 6e 2e 3c 2f 70 3e s a boolean.</p> 24c0: 0a 0a 3c 70 3e 57 68 65 6e 20 74 77 6f 20 6f 72 ..<p>When two or 24d0: 20 6d 6f 72 65 20 74 61 67 73 20 77 69 74 68 20 more tags with 24e0: 74 68 65 20 73 61 6d 65 20 6e 61 6d 65 20 61 72 the same name ar 24f0: 65 20 61 70 70 6c 69 65 64 20 74 6f 20 74 68 65 e applied to the 2500: 0a 73 61 6d 65 20 61 72 74 69 66 61 63 74 2c 20 .same artifact, 2510: 74 68 65 20 74 61 67 20 77 69 74 68 20 74 68 65 the tag with the 2520: 20 6c 61 74 65 73 74 20 28 6d 6f 73 74 20 72 65 latest (most re 2530: 63 65 6e 74 29 20 64 61 74 65 20 69 73 0a 75 73 cent) date is.us 2540: 65 64 2e 3c 2f 70 3e 0a 0a 3c 70 3e 53 6f 6d 65 ed.</p>..<p>Some 2550: 20 74 61 67 73 20 68 61 76 65 20 73 70 65 63 69 tags have speci 2560: 61 6c 20 6d 65 61 6e 69 6e 67 2e 20 20 54 68 65 al meaning. The 2570: 20 22 63 6f 6d 6d 65 6e 74 22 20 74 61 67 20 77 "comment" tag w 2580: 68 65 6e 20 61 70 70 6c 69 65 64 0a 74 6f 20 61 hen applied.to a 2590: 20 62 61 73 65 6c 69 6e 65 20 77 69 6c 6c 20 6f baseline will o 25a0: 76 65 72 72 69 64 65 20 74 68 65 20 63 68 65 63 verride the chec 25b0: 6b 2d 69 6e 20 63 6f 6d 6d 65 6e 74 20 6f 66 20 k-in comment of 25c0: 74 68 61 74 20 62 61 73 65 6c 69 6e 65 0a 66 6f that baseline.fo 25d0: 72 20 64 69 73 70 6c 61 79 20 70 75 72 70 6f 73 r display purpos 25e0: 65 73 2e 3c 2f 70 3e 0a 0a 3c 68 32 3e 34 2e 30 es.</p>..<h2>4.0 25f0: 20 57 69 6b 69 20 50 61 67 65 73 3c 2f 68 32 3e Wiki Pages</h2> 2600: 0a 0a 3c 70 3e 41 20 77 69 6b 69 20 70 61 67 65 ..<p>A wiki page 2610: 20 69 73 20 61 6e 20 61 72 74 69 66 61 63 74 20 is an artifact 2620: 77 69 74 68 20 61 20 66 6f 72 6d 61 74 20 73 69 with a format si 2630: 6d 69 6c 61 72 20 74 6f 20 6d 61 6e 69 66 65 73 milar to manifes 2640: 74 73 2c 0a 63 6c 75 73 74 65 72 73 2c 20 61 6e ts,.clusters, an 2650: 64 20 63 6f 6e 74 72 6f 6c 20 61 72 74 69 66 61 d control artifa 2660: 63 74 73 2e 20 20 54 68 65 20 61 72 74 69 66 61 cts. The artifa 2670: 63 74 20 69 73 20 64 69 76 69 64 65 64 20 69 6e ct is divided in 2680: 74 6f 0a 63 61 72 64 73 20 62 79 20 6e 65 77 6c to.cards by newl 2690: 69 6e 65 20 63 68 61 72 61 63 74 65 72 73 2e 20 ine characters. 26a0: 20 54 68 65 20 66 6f 72 6d 61 74 20 6f 66 20 65 The format of e 26b0: 61 63 68 20 63 61 72 64 20 69 73 20 61 73 20 69 ach card is as i 26c0: 6e 0a 6d 61 6e 69 66 65 73 74 73 2c 20 63 6c 75 n.manifests, clu 26d0: 73 74 65 72 73 2c 20 61 6e 64 20 63 6f 6e 74 72 sters, and contr 26e0: 6f 6c 20 61 72 74 69 66 61 63 74 73 2e 20 20 57 ol artifacts. W 26f0: 69 6b 69 20 61 72 74 69 66 61 63 74 73 20 61 63 iki artifacts ac 2700: 63 65 70 74 0a 74 68 65 20 66 6f 6c 6c 6f 77 69 cept.the followi 2710: 6e 67 20 63 61 72 64 20 74 79 70 65 73 3a 3c 2f ng card types:</ 2720: 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e p>..<blockquote> 2730: 0a 3c 62 3e 44 3c 2f 62 3e 20 3c 69 3e 74 69 6d .<b>D</b> <i>tim 2740: 65 2d 61 6e 64 2d 64 61 74 65 2d 73 74 61 6d 70 e-and-date-stamp 2750: 3c 2f 69 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 4c 3c </i><br />.<b>L< 2760: 2f 62 3e 20 3c 69 3e 77 69 6b 69 2d 74 69 74 6c /b> <i>wiki-titl 2770: 65 3c 2f 69 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 50 e</i><br />.<b>P 2780: 3c 2f 62 3e 20 3c 69 3e 70 61 72 65 6e 74 2d 75 </b> <i>parent-u 2790: 75 69 64 3c 2f 69 3e 2b 3c 62 72 20 2f 3e 0a 3c uid</i>+<br />.< 27a0: 62 3e 55 3c 2f 62 3e 20 3c 69 3e 75 73 65 72 2d b>U</b> <i>user- 27b0: 6e 61 6d 65 3c 2f 69 3e 3c 62 72 20 2f 3e 0a 3c name</i><br />.< 27c0: 62 3e 57 3c 2f 62 3e 20 3c 69 3e 73 69 7a 65 3c b>W</b> <i>size< 27d0: 2f 69 3e 20 3c 62 3e 5c 6e 3c 2f 62 3e 20 3c 69 /i> <b>\n</b> <i 27e0: 3e 74 65 78 74 3c 2f 69 3e 20 3c 62 3e 5c 6e 3c >text</i> <b>\n< 27f0: 2f 62 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 5a 3c 2f /b><br />.<b>Z</ 2800: 62 3e 20 3c 69 3e 63 68 65 63 6b 73 75 6d 3c 2f b> <i>checksum</ 2810: 69 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e i>.</blockquote> 2820: 0a 0a 3c 70 3e 54 68 65 20 44 20 63 61 72 64 20 ..<p>The D card 2830: 69 73 20 74 68 65 20 64 61 74 65 20 61 6e 64 20 is the date and 2840: 74 69 6d 65 20 77 68 65 6e 20 74 68 65 20 77 69 time when the wi 2850: 6b 69 20 70 61 67 65 20 77 61 73 20 65 64 69 74 ki page was edit 2860: 65 64 2e 0a 54 68 65 20 50 20 63 61 72 64 20 73 ed..The P card s 2870: 70 65 63 69 66 69 65 73 20 74 68 65 20 70 61 72 pecifies the par 2880: 65 6e 74 20 77 69 6b 69 20 70 61 67 65 73 2c 20 ent wiki pages, 2890: 69 66 20 61 6e 79 2e 20 20 54 68 65 20 4c 20 63 if any. The L c 28a0: 61 72 64 0a 67 69 76 65 73 20 74 68 65 20 6e 61 ard.gives the na 28b0: 6d 65 20 6f 66 20 74 68 65 20 77 69 6b 69 20 70 me of the wiki p 28c0: 61 67 65 2e 20 20 54 68 65 20 55 20 63 61 72 64 age. The U card 28d0: 20 73 70 65 63 69 66 69 65 73 20 74 68 65 20 6c specifies the l 28e0: 6f 67 69 6e 0a 6f 66 20 74 68 65 20 75 73 65 72 ogin.of the user 28f0: 20 77 68 6f 20 6d 61 64 65 20 74 68 69 73 20 65 who made this e 2900: 64 69 74 20 74 6f 20 74 68 65 20 77 69 6b 69 20 dit to the wiki 2910: 70 61 67 65 2e 20 20 54 68 65 20 5a 20 63 61 72 page. The Z car 2920: 64 20 69 73 0a 74 68 65 20 75 73 75 61 6c 20 63 d is.the usual c 2930: 68 65 63 6b 73 75 6d 20 6f 76 65 72 20 74 68 65 hecksum over the 2940: 20 65 69 74 68 65 72 20 61 72 74 69 66 61 63 74 either artifact 2950: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 57 20 .</p>..<p>The W 2960: 63 61 72 64 20 69 73 20 75 73 65 64 20 74 6f 20 card is used to 2970: 73 70 65 63 69 66 79 20 74 68 65 20 74 65 78 74 specify the text 2980: 20 6f 66 20 74 68 65 20 77 69 6b 69 20 70 61 67 of the wiki pag 2990: 65 2e 20 20 54 68 65 0a 61 72 67 75 6d 65 6e 74 e. The.argument 29a0: 20 74 6f 20 74 68 65 20 57 20 63 61 72 64 20 69 to the W card i 29b0: 73 20 61 6e 20 69 6e 74 65 67 65 72 20 77 68 69 s an integer whi 29c0: 63 68 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 ch is the number 29d0: 20 6f 66 20 62 79 74 65 73 0a 6f 66 20 74 65 78 of bytes.of tex 29e0: 74 20 69 6e 20 74 68 65 20 77 69 6b 69 20 70 61 t in the wiki pa 29f0: 67 65 2e 20 20 54 68 61 74 20 74 65 78 74 20 66 ge. That text f 2a00: 6f 6c 6c 6f 77 73 20 74 68 65 20 6e 65 77 6c 69 ollows the newli 2a10: 6e 65 20 63 68 61 72 61 63 74 65 72 0a 74 68 61 ne character.tha 2a20: 74 20 74 65 72 6d 69 6e 61 74 65 73 20 74 68 65 t terminates the 2a30: 20 57 20 63 61 72 64 2e 20 20 54 68 65 20 77 69 W card. The wi 2a40: 6b 69 20 74 65 78 74 20 69 73 20 61 6c 77 61 79 ki text is alway 2a50: 73 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 6f 6e s followed by on 2a60: 65 0a 65 78 74 72 61 20 6e 65 77 6c 69 6e 65 2e e.extra newline. 2a70: 3c 2f 70 3e 0a 0a 3c 68 32 3e 35 2e 30 20 54 69 </p>..<h2>5.0 Ti 2a80: 63 6b 65 74 20 43 68 61 6e 67 65 73 3c 2f 68 32 cket Changes</h2 2a90: 3e 0a 0a 3c 70 3e 41 20 74 69 63 6b 65 74 2d 63 >..<p>A ticket-c 2aa0: 68 61 6e 67 65 20 61 72 74 69 66 61 63 74 20 72 hange artifact r 2ab0: 65 70 72 65 73 65 6e 74 73 20 61 20 63 68 61 6e epresents a chan 2ac0: 67 65 20 74 6f 20 61 20 74 72 6f 75 62 6c 65 20 ge to a trouble 2ad0: 74 69 63 6b 65 74 2e 0a 54 68 65 20 66 6f 6c 6c ticket..The foll 2ae0: 6f 77 69 6e 67 20 63 61 72 64 73 20 61 72 65 20 owing cards are 2af0: 61 6c 6c 6f 77 65 64 20 6f 6e 20 61 20 74 69 63 allowed on a tic 2b00: 6b 65 74 20 63 68 61 6e 67 65 20 61 72 74 69 66 ket change artif 2b10: 61 63 74 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b act:</p>..<block 2b20: 71 75 6f 74 65 3e 0a 3c 62 3e 44 3c 2f 62 3e 20 quote>.<b>D</b> 2b30: 3c 69 3e 74 69 6d 65 2d 61 6e 64 2d 64 61 74 65 <i>time-and-date 2b40: 2d 73 74 61 6d 70 3c 2f 69 3e 3c 62 72 20 2f 3e -stamp</i><br /> 2b50: 0a 3c 62 3e 4a 3c 2f 62 3e 20 3f 3c 62 3e 2b 3c .<b>J</b> ?<b>+< 2b60: 2f 62 3e 3f 3c 69 3e 6e 61 6d 65 20 76 61 6c 75 /b>?<i>name valu 2b70: 65 3c 2f 69 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 4b e</i><br />.<b>K 2b80: 3c 2f 62 3e 20 3c 69 3e 74 69 63 6b 65 74 2d 75 </b> <i>ticket-u 2b90: 75 69 64 3c 2f 69 3e 3c 62 72 20 2f 3e 0a 3c 62 uid</i><br />.<b 2ba0: 3e 55 3c 2f 62 3e 20 3c 69 3e 75 73 65 72 2d 6e >U</b> <i>user-n 2bb0: 61 6d 65 3c 2f 69 3e 3c 62 72 20 2f 3e 0a 3c 62 ame</i><br />.<b 2bc0: 3e 5a 3c 2f 62 3e 20 3c 69 3e 63 68 65 63 6b 73 >Z</b> <i>checks 2bd0: 75 6d 3c 2f 69 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 um</i>.</blockqu 2be0: 6f 74 65 3e 0a 0a 3c 70 3e 0a 54 68 65 20 44 20 ote>..<p>.The D 2bf0: 63 61 72 64 20 69 73 20 74 68 65 20 75 73 75 61 card is the usua 2c00: 6c 20 64 61 74 65 20 61 6e 64 20 74 69 6d 65 20 l date and time 2c10: 73 74 61 6d 70 20 61 6e 64 20 72 65 70 72 65 73 stamp and repres 2c20: 65 6e 74 73 20 74 68 65 20 70 6f 69 6e 74 0a 69 ents the point.i 2c30: 6e 20 74 69 6d 65 20 77 68 65 6e 20 74 68 65 20 n time when the 2c40: 63 68 61 6e 67 65 20 77 61 73 20 65 6e 74 65 72 change was enter 2c50: 65 64 2e 20 20 54 68 65 20 55 20 63 61 72 64 20 ed. The U card 2c60: 69 73 20 74 68 65 20 6c 6f 67 69 6e 20 6f 66 20 is the login of 2c70: 74 68 65 0a 70 72 6f 67 72 61 6d 6d 65 72 20 77 the.programmer w 2c80: 68 6f 20 65 6e 74 65 72 65 64 20 74 68 69 73 20 ho entered this 2c90: 63 68 61 6e 67 65 2e 20 20 54 68 65 20 5a 20 63 change. The Z c 2ca0: 61 72 64 20 69 73 20 74 68 65 20 63 68 65 63 6b ard is the check 2cb0: 73 75 6d 20 6f 76 65 72 0a 74 68 65 20 65 6e 74 sum over.the ent 2cc0: 69 72 65 20 61 72 74 69 66 61 63 74 2e 3c 2f 70 ire artifact.</p 2cd0: 3e 0a 0a 3c 70 3e 0a 45 76 65 72 79 20 74 69 63 >..<p>.Every tic 2ce0: 6b 65 74 20 68 61 73 20 61 20 55 55 49 44 2e 20 ket has a UUID. 2cf0: 20 54 68 65 20 74 69 63 6b 65 74 20 74 6f 20 77 The ticket to w 2d00: 68 69 63 68 20 74 68 69 73 20 63 68 61 6e 67 65 hich this change 2d10: 20 69 73 20 61 70 70 6c 69 65 64 0a 69 73 20 73 is applied.is s 2d20: 70 65 63 69 66 69 65 64 20 62 79 20 74 68 65 20 pecified by the 2d30: 4b 20 63 61 72 64 2e 20 20 41 20 74 69 63 6b 65 K card. A ticke 2d40: 74 20 65 78 69 73 74 73 20 69 66 20 69 74 20 63 t exists if it c 2d50: 6f 6e 74 61 69 6e 73 20 6f 6e 65 20 6f 72 0a 6d ontains one or.m 2d60: 6f 72 65 20 63 68 61 6e 67 65 73 2e 20 20 54 68 ore changes. Th 2d70: 65 20 66 69 72 73 74 20 22 63 68 61 6e 67 65 22 e first "change" 2d80: 20 74 6f 20 61 20 74 69 63 6b 65 74 20 69 73 20 to a ticket is 2d90: 77 68 61 74 20 62 72 69 6e 67 73 20 74 68 65 0a what brings the. 2da0: 74 69 63 6b 65 74 20 69 6e 74 6f 20 65 78 69 73 ticket into exis 2db0: 74 61 6e 63 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 0a tance.</p>..<p>. 2dc0: 4a 20 63 61 72 64 73 20 73 70 65 63 69 66 79 20 J cards specify 2dd0: 63 68 61 6e 67 65 73 20 74 6f 20 22 66 69 65 6c changes to "fiel 2de0: 64 73 22 20 6f 66 20 74 68 65 20 74 69 63 6b 65 ds" of the ticke 2df0: 74 2e 20 20 45 61 63 68 20 66 6f 73 73 69 6c 0a t. Each fossil. 2e00: 73 65 72 76 65 72 20 68 61 73 20 61 20 74 69 63 server has a tic 2e10: 6b 65 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f ket configuratio 2e20: 6e 20 77 68 69 63 68 20 73 70 65 63 69 66 69 65 n which specifie 2e30: 73 20 74 68 65 20 66 69 65 6c 64 73 20 69 74 73 s the fields its 2e40: 0a 75 6e 64 65 72 73 74 61 6e 64 73 2e 20 20 54 .understands. T 2e50: 68 69 73 20 69 73 20 6e 6f 74 20 61 20 6c 69 6d his is not a lim 2e60: 69 74 20 6f 6e 20 74 68 65 20 66 69 65 6c 64 73 it on the fields 2e70: 20 74 68 61 74 20 63 61 6e 20 61 70 70 65 61 72 that can appear 2e80: 0a 6f 6e 20 74 68 65 20 4a 20 63 61 72 64 73 2c .on the J cards, 2e90: 20 68 6f 77 65 76 65 72 2e 20 20 49 66 20 61 20 however. If a 2ea0: 4a 20 63 61 72 64 20 73 70 65 63 69 66 69 65 73 J card specifies 2eb0: 20 61 20 66 69 65 6c 64 20 74 68 61 74 20 61 0a a field that a. 2ec0: 70 61 72 74 69 63 75 6c 61 72 20 66 6f 73 73 69 particular fossi 2ed0: 6c 20 73 65 72 76 65 72 20 64 6f 65 73 20 6e 6f l server does no 2ee0: 74 20 72 65 63 6f 67 6e 69 7a 65 2c 20 74 68 65 t recognize, the 2ef0: 6e 20 74 68 61 74 20 4a 20 63 61 72 64 0a 69 73 n that J card.is 2f00: 20 73 69 6d 70 6c 79 20 69 67 6e 6f 72 65 64 2e simply ignored. 2f10: 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54 68 65 20 66 69 </p>..<p>.The fi 2f20: 72 73 74 20 61 72 67 75 6d 65 6e 74 20 6f 66 20 rst argument of 2f30: 74 68 65 20 4a 20 63 61 72 64 20 69 73 20 74 68 the J card is th 2f40: 65 20 66 69 65 6c 64 20 6e 61 6d 65 2e 20 20 54 e field name. T 2f50: 68 65 20 73 65 63 6f 6e 64 0a 76 61 6c 75 65 20 he second.value 2f60: 69 73 20 74 68 65 20 66 69 65 6c 64 20 76 61 6c is the field val 2f70: 75 65 2e 20 20 49 66 20 74 68 65 20 66 69 65 6c ue. If the fiel 2f80: 64 20 6e 61 6d 65 20 62 65 67 69 6e 73 20 77 69 d name begins wi 2f90: 74 68 20 22 2b 22 20 74 68 65 6e 0a 74 68 65 20 th "+" then.the 2fa0: 76 61 6c 75 65 20 69 73 20 61 70 70 65 6e 64 65 value is appende 2fb0: 64 20 74 6f 20 74 68 65 20 70 72 69 6f 72 20 76 d to the prior v 2fc0: 61 6c 75 65 2e 20 20 4f 74 68 65 72 77 69 73 65 alue. Otherwise 2fd0: 2c 20 74 68 65 20 76 61 6c 75 65 0a 6f 6e 20 74 , the value.on t 2fe0: 68 65 20 4a 20 63 61 72 64 20 72 65 70 6c 61 63 he J card replac 2ff0: 65 73 20 61 6e 79 20 70 72 65 76 69 6f 75 73 20 es any previous 3000: 76 61 6c 75 65 20 6f 66 20 74 68 65 20 66 69 65 value of the fie 3010: 6c 64 2e 0a 54 68 65 20 66 69 65 6c 64 20 6e 61 ld..The field na 3020: 6d 65 20 61 6e 64 20 76 61 6c 75 65 20 61 72 65 me and value are 3030: 20 62 6f 74 68 20 65 6e 63 6f 64 65 64 20 75 73 both encoded us 3040: 69 6e 67 20 74 68 65 20 63 68 61 72 61 63 74 65 ing the characte 3050: 72 0a 65 73 63 61 70 65 73 20 64 65 66 69 6e 65 r.escapes define 3060: 64 20 66 6f 72 20 74 68 65 20 43 20 63 61 72 64 d for the C card 3070: 20 6f 66 20 61 20 6d 61 6e 69 66 65 73 74 2e 0a of a manifest.. 3080: 3c 2f 70 3e 0a </p>.