Artifact 677a2a9b1991a47a592f8594e093063afb5a669c:
File www/fileformat.html part of check-in [6458f020fc] - Change the spelling of "descendant" to use the -ant suffix everywhere, including in the filename "descendant.c". The adjective form can be spelled either -ant or -ent, but the noun form requires -ant, or so says American Heritage. by drh on 2008-05-14 02:03:45.
0000: 3c 68 74 6d 6c 3e 0a 3c 68 65 61 64 3e 0a 3c 74 <html>.<head>.<t 0010: 69 74 6c 65 3e 46 6f 73 73 69 6c 20 46 69 6c 65 itle>Fossil File 0020: 20 46 6f 72 6d 61 74 3c 2f 74 69 74 6c 65 3e 0a Format</title>. 0030: 3c 2f 68 65 61 64 3e 0a 3c 62 6f 64 79 20 62 67 </head>.<body bg 0040: 63 6f 6c 6f 72 3d 22 77 68 69 74 65 22 3e 0a 3c color="white">.< 0050: 70 3e 5b 20 3c 61 20 68 72 65 66 3d 22 69 6e 64 p>[ <a href="ind 0060: 65 78 2e 68 74 6d 6c 22 3e 49 6e 64 65 78 3c 2f ex.html">Index</ 0070: 61 3e 20 5d 3c 2f 70 3e 0a 3c 68 72 3e 0a 3c 68 a> ]</p>.<hr>.<h 0080: 31 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65 72 22 1 align="center" 0090: 3e 0a 46 6f 73 73 69 6c 20 46 69 6c 65 20 46 6f >.Fossil File Fo 00a0: 72 6d 61 74 73 0a 3c 2f 68 31 3e 0a 0a 3c 70 3e rmats.</h1>..<p> 00b0: 0a 54 68 65 20 67 6c 6f 62 61 6c 20 73 74 61 74 .The global stat 00c0: 65 20 6f 66 20 61 20 66 6f 73 73 69 6c 20 72 65 e of a fossil re 00d0: 70 6f 73 69 74 6f 72 79 20 69 73 20 64 65 74 65 pository is dete 00e0: 72 6d 69 6e 65 64 20 62 79 20 61 6e 20 75 6e 6f rmined by an uno 00f0: 72 64 65 72 65 64 0a 73 65 74 20 6f 66 20 61 72 rdered.set of ar 0100: 74 69 66 61 63 74 73 2e 0a 41 6e 20 61 72 74 69 tifacts..An arti 0110: 66 61 63 74 20 6d 69 67 68 74 20 62 65 20 61 20 fact might be a 0120: 73 6f 75 72 63 65 20 63 6f 64 65 20 66 69 6c 65 source code file 0130: 2c 20 74 68 65 20 74 65 78 74 20 6f 66 20 61 20 , the text of a 0140: 77 69 6b 69 20 70 61 67 65 2c 0a 70 61 72 74 20 wiki page,.part 0150: 6f 66 20 61 20 74 72 6f 75 62 6c 65 20 74 69 63 of a trouble tic 0160: 6b 65 74 2c 20 6f 72 20 6f 6e 65 20 6f 66 20 73 ket, or one of s 0170: 65 76 65 72 61 6c 20 73 70 65 63 69 61 6c 20 63 everal special c 0180: 6f 6e 74 72 6f 6c 20 61 72 74 69 66 61 63 74 73 ontrol artifacts 0190: 0a 75 73 65 64 20 74 6f 20 73 68 6f 77 20 74 68 .used to show th 01a0: 65 20 72 65 6c 61 74 69 6f 6e 73 68 69 70 73 20 e relationships 01b0: 62 65 74 77 65 65 6e 20 6f 74 68 65 72 20 61 72 between other ar 01c0: 74 69 66 61 63 74 73 20 77 69 74 68 69 6e 20 74 tifacts within t 01d0: 68 65 0a 70 72 6f 6a 65 63 74 2e 20 20 41 72 74 he.project. Art 01e0: 69 66 61 63 74 73 20 63 61 6e 20 62 65 20 74 65 ifacts can be te 01f0: 78 74 20 6f 72 20 62 69 6e 61 72 79 2e 0a 3c 2f xt or binary..</ 0200: 70 3e 0a 0a 3c 70 3e 0a 45 61 63 68 20 61 72 74 p>..<p>.Each art 0210: 69 66 61 63 74 20 69 6e 20 74 68 65 20 72 65 70 ifact in the rep 0220: 6f 73 69 74 6f 72 79 20 69 73 20 6e 61 6d 65 64 ository is named 0230: 20 62 79 20 69 74 73 20 53 48 41 31 20 68 61 73 by its SHA1 has 0240: 68 2e 0a 4e 6f 20 70 72 65 66 69 78 65 73 20 6f h..No prefixes o 0250: 72 20 6d 65 74 61 20 69 6e 66 6f 72 6d 61 74 69 r meta informati 0260: 6f 6e 20 69 73 20 61 64 64 65 64 20 74 6f 20 61 on is added to a 0270: 20 61 72 74 69 66 61 63 74 20 62 65 66 6f 72 65 artifact before 0280: 0a 69 74 73 20 68 61 73 68 20 69 73 20 63 6f 6d .its hash is com 0290: 70 75 74 65 64 2e 20 20 54 68 65 20 6e 61 6d 65 puted. The name 02a0: 20 6f 66 20 61 20 61 72 74 69 66 61 63 74 20 69 of a artifact i 02b0: 6e 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 n the repository 02c0: 0a 69 73 20 65 78 61 63 74 6c 79 20 74 68 65 20 .is exactly the 02d0: 73 61 6d 65 20 53 48 41 31 20 68 61 73 68 20 74 same SHA1 hash t 02e0: 68 61 74 20 69 73 20 63 6f 6d 70 75 74 65 64 20 hat is computed 02f0: 62 79 20 73 68 61 31 73 75 6d 20 0a 6f 6e 20 74 by sha1sum .on t 0300: 68 65 20 66 69 6c 65 20 61 73 20 69 74 20 65 78 he file as it ex 0310: 69 73 74 73 20 69 6e 20 79 6f 75 72 20 73 6f 75 ists in your sou 0320: 72 63 65 20 74 72 65 65 2e 3c 2f 70 3e 0a 0a 3c rce tree.</p>..< 0330: 70 3e 0a 53 6f 6d 65 20 61 72 74 69 66 61 63 74 p>.Some artifact 0340: 73 20 68 61 76 65 20 61 20 70 61 72 74 69 63 75 s have a particu 0350: 6c 61 72 20 66 6f 72 6d 61 74 20 77 68 69 63 68 lar format which 0360: 20 67 69 76 65 73 20 74 68 65 6d 20 73 70 65 63 gives them spec 0370: 69 61 6c 0a 6d 65 61 6e 69 6e 67 20 74 6f 20 66 ial.meaning to f 0380: 6f 73 73 69 6c 2e 20 20 46 6f 73 73 69 6c 20 72 ossil. Fossil r 0390: 65 63 6f 67 6e 69 7a 65 73 3a 3c 2f 70 3e 0a 0a ecognizes:</p>.. 03a0: 3c 75 6c 3e 0a 3c 6c 69 3e 20 4d 61 6e 69 66 65 <ul>.<li> Manife 03b0: 73 74 73 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 43 sts </li>.<li> C 03c0: 6c 75 73 74 65 72 73 20 3c 2f 6c 69 3e 0a 3c 6c lusters </li>.<l 03d0: 69 3e 20 43 6f 6e 74 72 6f 6c 20 41 72 74 69 66 i> Control Artif 03e0: 61 63 74 73 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e 20 acts </li>.<li> 03f0: 57 69 6b 69 20 50 61 67 65 73 20 3c 2f 6c 69 3e Wiki Pages </li> 0400: 0a 3c 6c 69 3e 20 54 69 63 6b 65 74 20 43 68 61 .<li> Ticket Cha 0410: 6e 67 65 73 20 3c 2f 6c 69 3e 0a 3c 2f 75 6c 3e nges </li>.</ul> 0420: 0a 0a 3c 70 3e 54 68 65 73 65 20 66 69 76 65 20 ..<p>These five 0430: 61 72 74 69 66 61 63 74 20 74 79 70 65 73 20 61 artifact types a 0440: 72 65 20 64 65 73 63 72 69 62 65 64 20 69 6e 20 re described in 0450: 74 68 65 20 73 65 71 75 65 6c 2e 3c 2f 70 3e 0a the sequel.</p>. 0460: 0a 3c 68 32 3e 31 2e 30 20 54 68 65 20 4d 61 6e .<h2>1.0 The Man 0470: 69 66 65 73 74 3c 2f 68 32 3e 0a 0a 3c 70 3e 41 ifest</h2>..<p>A 0480: 20 6d 61 6e 69 66 65 73 74 20 64 65 66 69 6e 65 manifest define 0490: 73 20 61 20 62 61 73 65 6c 69 6e 65 20 6f 72 20 s a baseline or 04a0: 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 70 version of the p 04b0: 72 6f 6a 65 63 74 0a 73 6f 75 72 63 65 20 74 72 roject.source tr 04c0: 65 65 2e 20 20 54 68 65 20 6d 61 6e 69 66 65 73 ee. The manifes 04d0: 74 20 63 6f 6e 74 61 69 6e 73 20 61 20 6c 69 73 t contains a lis 04e0: 74 20 6f 66 20 61 72 74 69 66 61 63 74 73 20 66 t of artifacts f 04f0: 6f 72 0a 65 61 63 68 20 66 69 6c 65 20 69 6e 20 or.each file in 0500: 74 68 65 20 70 72 6f 6a 65 63 74 20 61 6e 64 20 the project and 0510: 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e the correspondin 0520: 67 20 66 69 6c 65 6e 61 6d 65 73 2c 20 61 73 0a g filenames, as. 0530: 77 65 6c 6c 20 61 73 20 69 6e 66 6f 72 6d 61 74 well as informat 0540: 69 6f 6e 20 73 75 63 68 20 61 73 20 70 61 72 65 ion such as pare 0550: 6e 74 20 62 61 73 65 6c 69 6e 65 73 2c 20 74 68 nt baselines, th 0560: 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 0a 70 72 e name of the.pr 0570: 6f 67 72 61 6d 6d 65 72 20 77 68 6f 20 63 72 65 ogrammer who cre 0580: 61 74 65 64 20 74 68 65 20 62 61 73 65 6c 69 6e ated the baselin 0590: 65 2c 20 74 68 65 20 64 61 74 65 20 61 6e 64 20 e, the date and 05a0: 74 69 6d 65 20 77 68 65 6e 0a 74 68 65 20 62 61 time when.the ba 05b0: 73 65 6c 69 6e 65 20 77 61 73 20 63 72 65 61 74 seline was creat 05c0: 65 64 2c 20 61 6e 64 20 61 6e 79 20 63 68 65 63 ed, and any chec 05d0: 6b 2d 69 6e 20 63 6f 6d 6d 65 6e 74 73 20 61 73 k-in comments as 05e0: 73 6f 63 69 61 74 65 64 0a 77 69 74 68 20 74 68 sociated.with th 05f0: 65 20 62 61 73 65 6c 69 6e 65 2e 3c 2f 70 3e 0a e baseline.</p>. 0600: 0a 3c 70 3e 0a 41 6e 79 20 61 72 74 69 66 61 63 .<p>.Any artifac 0610: 74 20 69 6e 20 74 68 65 20 72 65 70 6f 73 69 74 t in the reposit 0620: 6f 72 79 20 74 68 61 74 20 66 6f 6c 6c 6f 77 73 ory that follows 0630: 20 74 68 65 20 73 79 6e 74 61 63 74 69 63 20 72 the syntactic r 0640: 75 6c 65 73 0a 6f 66 20 61 20 6d 61 6e 69 66 65 ules.of a manife 0650: 73 74 20 69 73 20 61 20 6d 61 6e 69 66 65 73 74 st is a manifest 0660: 2e 20 20 4e 6f 74 65 20 74 68 61 74 20 61 20 6d . Note that a m 0670: 61 6e 69 66 65 73 74 20 63 61 6e 0a 62 65 20 62 anifest can.be b 0680: 6f 74 68 20 61 20 72 65 61 6c 20 6d 61 6e 69 66 oth a real manif 0690: 65 73 74 20 61 6e 64 20 61 6c 73 6f 20 61 20 63 est and also a c 06a0: 6f 6e 74 65 6e 74 20 66 69 6c 65 2c 20 74 68 6f ontent file, tho 06b0: 75 67 68 20 74 68 69 73 0a 69 73 20 72 61 72 65 ugh this.is rare 06c0: 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 41 20 6d 61 ..</p>..<p>.A ma 06d0: 6e 69 66 65 73 74 20 69 73 20 61 20 74 65 78 74 nifest is a text 06e0: 20 66 69 6c 65 2e 20 20 4e 65 77 6c 69 6e 65 20 file. Newline 06f0: 63 68 61 72 61 63 74 65 72 73 0a 28 41 53 43 49 characters.(ASCI 0700: 49 20 30 78 30 61 29 20 73 65 70 61 72 61 74 65 I 0x0a) separate 0710: 20 74 68 65 20 66 69 6c 65 20 69 6e 74 6f 20 22 the file into " 0720: 63 61 72 64 73 22 2e 0a 45 61 63 68 20 63 61 72 cards"..Each car 0730: 64 20 62 65 67 69 6e 73 20 77 69 74 68 20 61 20 d begins with a 0740: 73 69 6e 67 6c 65 0a 63 68 61 72 61 63 74 65 72 single.character 0750: 20 22 63 61 72 64 20 74 79 70 65 22 2e 20 20 5a "card type". Z 0760: 65 72 6f 20 6f 72 20 6d 6f 72 65 20 61 72 67 75 ero or more argu 0770: 6d 65 6e 74 73 20 6d 61 79 20 66 6f 6c 6c 6f 77 ments may follow 0780: 0a 74 68 65 20 63 61 72 64 20 74 79 70 65 2e 20 .the card type. 0790: 20 41 6c 6c 20 61 72 67 75 6d 65 6e 74 73 20 61 All arguments a 07a0: 72 65 20 73 65 70 61 72 61 74 65 64 20 66 72 6f re separated fro 07b0: 6d 20 65 61 63 68 20 6f 74 68 65 72 0a 61 6e 64 m each other.and 07c0: 20 66 72 6f 6d 20 74 68 65 20 63 61 72 64 2d 74 from the card-t 07d0: 79 70 65 20 63 68 61 72 61 63 74 65 72 20 62 79 ype character by 07e0: 20 61 20 73 69 6e 67 6c 65 20 73 70 61 63 65 0a a single space. 07f0: 63 68 61 72 61 63 74 65 72 2e 20 20 54 68 65 72 character. Ther 0800: 65 20 69 73 20 6e 6f 20 73 75 72 70 6c 75 73 20 e is no surplus 0810: 77 68 69 74 65 20 73 70 61 63 65 20 62 65 74 77 white space betw 0820: 65 65 6e 20 61 72 67 75 6d 65 6e 74 73 0a 61 6e een arguments.an 0830: 64 20 6e 6f 20 6c 65 61 64 69 6e 67 20 6f 72 20 d no leading or 0840: 74 72 61 69 6c 69 6e 67 20 77 68 69 74 65 73 70 trailing whitesp 0850: 61 63 65 20 65 78 63 65 70 74 20 66 6f 72 20 74 ace except for t 0860: 68 65 20 6e 65 77 6c 69 6e 65 20 0a 63 68 61 72 he newline .char 0870: 61 63 74 65 72 20 74 68 61 74 20 61 63 74 73 20 acter that acts 0880: 61 73 20 74 68 65 20 63 61 72 64 20 73 65 70 61 as the card sepa 0890: 72 61 74 6f 72 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e rator..</p>..<p> 08a0: 0a 41 6c 6c 20 63 61 72 64 73 20 6f 66 20 74 68 .All cards of th 08b0: 65 20 6d 61 6e 69 66 65 73 74 20 6f 63 63 75 72 e manifest occur 08c0: 20 69 6e 20 73 74 72 69 63 74 20 73 6f 72 74 65 in strict sorte 08d0: 64 20 6c 65 78 69 63 6f 67 72 61 70 68 69 63 61 d lexicographica 08e0: 6c 20 6f 72 64 65 72 2e 0a 4e 6f 20 63 61 72 64 l order..No card 08f0: 20 6d 61 79 20 62 65 20 64 75 70 6c 69 63 61 74 may be duplicat 0900: 65 64 2e 0a 54 68 65 20 65 6e 74 69 72 65 20 6d ed..The entire m 0910: 61 6e 69 66 65 73 74 20 6d 61 79 20 62 65 20 50 anifest may be P 0920: 47 50 20 63 6c 65 61 72 2d 73 69 67 6e 65 64 2c GP clear-signed, 0930: 20 62 75 74 20 6f 74 68 65 72 77 69 73 65 20 69 but otherwise i 0940: 74 0a 6d 61 79 20 63 6f 6e 74 61 69 6e 20 6e 6f t.may contain no 0950: 20 61 64 64 69 74 69 6f 6e 61 6c 20 74 65 78 74 additional text 0960: 20 6f 72 20 64 61 74 61 20 62 65 79 6f 6e 64 20 or data beyond 0970: 77 68 61 74 20 69 73 20 64 65 73 63 72 69 62 65 what is describe 0980: 64 20 68 65 72 65 2e 0a 3c 2f 70 3e 0a 0a 3c 70 d here..</p>..<p 0990: 3e 0a 41 6c 6c 6f 77 65 64 20 63 61 72 64 73 20 >.Allowed cards 09a0: 69 6e 20 74 68 65 20 6d 61 6e 69 66 65 73 74 20 in the manifest 09b0: 61 72 65 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a are as follows:. 09c0: 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 </p>..<blockquot 09d0: 65 3e 0a 3c 62 3e 43 3c 2f 62 3e 20 3c 69 3e 63 e>.<b>C</b> <i>c 09e0: 68 65 63 6b 69 6e 2d 63 6f 6d 6d 65 6e 74 3c 2f heckin-comment</ 09f0: 69 3e 3c 62 72 3e 0a 3c 62 3e 44 3c 2f 62 3e 20 i><br>.<b>D</b> 0a00: 3c 69 3e 74 69 6d 65 2d 61 6e 64 2d 64 61 74 65 <i>time-and-date 0a10: 2d 73 74 61 6d 70 3c 2f 69 3e 3c 62 72 3e 0a 3c -stamp</i><br>.< 0a20: 62 3e 46 3c 2f 62 3e 20 3c 69 3e 66 69 6c 65 6e b>F</b> <i>filen 0a30: 61 6d 65 3c 2f 69 3e 20 3c 69 3e 53 48 41 31 2d ame</i> <i>SHA1- 0a40: 68 61 73 68 3c 2f 69 3e 3c 62 72 3e 0a 3c 62 3e hash</i><br>.<b> 0a50: 50 3c 2f 62 3e 20 3c 69 3e 53 48 41 31 2d 68 61 P</b> <i>SHA1-ha 0a60: 73 68 3c 2f 69 3e 2b 3c 62 72 3e 0a 3c 62 3e 52 sh</i>+<br>.<b>R 0a70: 3c 2f 62 3e 20 3c 69 3e 72 65 70 6f 73 69 74 6f </b> <i>reposito 0a80: 72 79 2d 63 68 65 63 6b 73 75 6d 3c 2f 69 3e 3c ry-checksum</i>< 0a90: 62 72 3e 0a 3c 62 3e 55 3c 2f 62 3e 20 3c 69 3e br>.<b>U</b> <i> 0aa0: 75 73 65 72 2d 6c 6f 67 69 6e 3c 2f 69 3e 3c 62 user-login</i><b 0ab0: 72 3e 0a 3c 62 3e 5a 3c 2f 62 3e 20 3c 69 3e 6d r>.<b>Z</b> <i>m 0ac0: 61 6e 69 66 65 73 74 2d 63 68 65 63 6b 73 75 6d anifest-checksum 0ad0: 3c 2f 69 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 </i>.</blockquot 0ae0: 65 3e 0a 0a 3c 70 3e 0a 41 20 6d 61 6e 69 66 65 e>..<p>.A manife 0af0: 73 74 20 6d 75 73 74 20 68 61 76 65 20 65 78 61 st must have exa 0b00: 63 74 6c 79 20 6f 6e 65 20 43 2d 63 61 72 64 2e ctly one C-card. 0b10: 20 20 54 68 65 20 73 6f 6c 65 20 61 72 67 75 6d The sole argum 0b20: 65 6e 74 20 74 6f 0a 74 68 65 20 43 2d 63 61 72 ent to.the C-car 0b30: 64 20 69 73 20 61 20 63 68 65 63 6b 2d 69 6e 20 d is a check-in 0b40: 63 6f 6d 6d 65 6e 74 20 74 68 61 74 20 64 65 73 comment that des 0b50: 63 72 69 62 65 73 20 74 68 65 20 63 68 65 63 6b cribes the check 0b60: 2d 69 6e 20 74 68 61 74 0a 74 68 65 20 6d 61 6e -in that.the man 0b70: 69 66 65 73 74 20 64 65 66 69 6e 65 73 2e 20 20 ifest defines. 0b80: 54 68 65 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d The check-in com 0b90: 6d 65 6e 74 20 69 73 20 74 65 78 74 2e 20 20 54 ment is text. T 0ba0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 65 73 63 he following.esc 0bb0: 61 70 65 20 73 65 71 75 65 6e 63 65 73 20 61 72 ape sequences ar 0bc0: 65 20 61 70 70 6c 69 65 64 20 74 6f 20 74 68 65 e applied to the 0bd0: 20 74 65 78 74 3a 0a 41 20 73 70 61 63 65 20 28 text:.A space ( 0be0: 41 53 43 49 49 20 30 78 32 30 29 20 69 73 20 72 ASCII 0x20) is r 0bf0: 65 70 72 65 73 65 6e 74 65 64 20 61 73 20 22 5c epresented as "\ 0c00: 73 22 20 28 41 53 43 49 49 20 30 78 35 43 2c 20 s" (ASCII 0x5C, 0c10: 30 78 37 33 29 2e 20 20 41 0a 6e 65 77 6c 69 6e 0x73). A.newlin 0c20: 65 20 28 41 53 43 49 49 20 30 78 30 61 29 20 69 e (ASCII 0x0a) i 0c30: 73 20 22 5c 6e 22 20 28 41 53 43 49 49 20 30 78 s "\n" (ASCII 0x 0c40: 36 43 2c 20 78 36 45 29 2e 20 20 41 20 62 61 63 6C, x6E). A bac 0c50: 6b 73 6c 61 73 68 20 0a 28 41 53 43 49 49 20 30 kslash .(ASCII 0 0c60: 78 35 43 29 20 69 73 20 72 65 70 72 65 73 65 6e x5C) is represen 0c70: 74 65 64 20 61 73 20 74 77 6f 20 62 61 63 6b 73 ted as two backs 0c80: 6c 61 73 68 65 73 20 22 5c 5c 22 2e 20 20 41 70 lashes "\\". Ap 0c90: 61 72 74 20 66 72 6f 6d 0a 73 70 61 63 65 20 61 art from.space a 0ca0: 6e 64 20 6e 65 77 6c 69 6e 65 2c 20 6e 6f 20 6f nd newline, no o 0cb0: 74 68 65 72 20 77 68 69 74 65 73 70 61 63 65 20 ther whitespace 0cc0: 63 68 61 72 61 63 74 65 72 73 20 61 72 65 20 61 characters are a 0cd0: 6c 6c 6f 77 65 64 20 69 6e 0a 74 68 65 20 63 68 llowed in.the ch 0ce0: 65 63 6b 2d 69 6e 20 63 6f 6d 6d 65 6e 74 2e 20 eck-in comment. 0cf0: 20 4e 6f 72 20 61 72 65 20 61 6e 79 20 75 6e 70 Nor are any unp 0d00: 72 69 6e 74 61 62 6c 65 20 63 68 61 72 61 63 74 rintable charact 0d10: 65 72 73 20 61 6c 6c 6f 77 65 64 0a 69 6e 20 74 ers allowed.in t 0d20: 68 65 20 63 6f 6d 6d 65 6e 74 2e 0a 3c 2f 70 3e he comment..</p> 0d30: 0a 0a 3c 70 3e 0a 41 20 6d 61 6e 69 66 65 73 74 ..<p>.A manifest 0d40: 20 6d 75 73 74 20 68 61 76 65 20 65 78 61 63 74 must have exact 0d50: 6c 79 20 6f 6e 65 20 44 2d 63 61 72 64 2e 20 20 ly one D-card. 0d60: 54 68 65 20 73 6f 6c 65 20 61 72 67 75 6d 65 6e The sole argumen 0d70: 74 20 74 6f 0a 74 68 65 20 44 2d 63 61 72 64 20 t to.the D-card 0d80: 69 73 20 61 20 64 61 74 65 2d 74 69 6d 65 20 73 is a date-time s 0d90: 74 61 6d 70 20 69 6e 20 74 68 65 20 49 53 4f 38 tamp in the ISO8 0da0: 36 30 31 20 66 6f 72 6d 61 74 2e 20 20 54 68 65 601 format. The 0db0: 0a 64 61 74 65 20 61 6e 64 20 74 69 6d 65 20 73 .date and time s 0dc0: 68 6f 75 6c 64 20 62 65 20 69 6e 20 63 6f 6f 72 hould be in coor 0dd0: 64 69 6e 61 74 65 64 20 75 6e 69 76 65 72 73 61 dinated universa 0de0: 6c 20 74 69 6d 65 20 28 55 54 43 29 2e 0a 54 68 l time (UTC)..Th 0df0: 65 20 66 6f 72 6d 61 74 20 69 73 3a 0a 3c 2f 70 e format is:.</p 0e00: 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a >..<blockquote>. 0e10: 3c 69 3e 59 59 59 59 3c 2f 69 3e 3c 62 3e 2d 3c <i>YYYY</i><b>-< 0e20: 2f 62 3e 3c 69 3e 4d 4d 3c 2f 69 3e 3c 62 3e 2d /b><i>MM</i><b>- 0e30: 3c 2f 62 3e 3c 69 3e 44 44 3c 2f 69 3e 3c 62 3e </b><i>DD</i><b> 0e40: 54 3c 2f 62 3e 3c 69 3e 48 48 3c 2f 69 3e 3c 62 T</b><i>HH</i><b 0e50: 3e 3a 3c 2f 62 3e 3c 69 3e 4d 4d 3c 2f 69 3e 3c >:</b><i>MM</i>< 0e60: 62 3e 3a 3c 2f 62 3e 3c 69 3e 53 53 3c 2f 69 3e b>:</b><i>SS</i> 0e70: 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a .</blockquote>.. 0e80: 3c 70 3e 0a 41 20 6d 61 6e 69 66 65 73 74 20 68 <p>.A manifest h 0e90: 61 73 20 7a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 as zero or more 0ea0: 46 2d 63 61 72 64 73 2e 20 20 45 61 63 68 20 46 F-cards. Each F 0eb0: 2d 63 61 72 64 20 64 65 66 69 6e 65 73 20 61 20 -card defines a 0ec0: 66 69 6c 65 0a 28 6f 74 68 65 72 20 74 68 61 6e file.(other than 0ed0: 20 74 68 65 20 6d 61 6e 69 66 65 73 74 20 69 74 the manifest it 0ee0: 73 65 6c 66 29 20 77 68 69 63 68 20 69 73 20 70 self) which is p 0ef0: 61 72 74 20 6f 66 20 74 68 65 20 62 61 73 65 6c art of the basel 0f00: 69 6e 65 20 74 68 61 74 0a 74 68 65 20 6d 61 6e ine that.the man 0f10: 69 66 65 73 74 20 64 65 66 69 6e 65 73 2e 20 20 ifest defines. 0f20: 54 68 65 72 65 20 61 72 65 20 74 77 6f 20 61 72 There are two ar 0f30: 67 75 6d 65 6e 74 73 2e 20 20 54 68 65 20 66 69 guments. The fi 0f40: 72 73 74 20 61 72 67 6d 65 6e 74 0a 69 73 20 74 rst argment.is t 0f50: 68 65 20 70 61 74 68 6e 61 6d 65 20 6f 66 20 74 he pathname of t 0f60: 68 65 20 66 69 6c 65 20 69 6e 20 74 68 65 20 62 he file in the b 0f70: 61 73 65 6c 69 6e 65 20 72 65 6c 61 74 69 76 65 aseline relative 0f80: 20 74 6f 20 74 68 65 20 72 6f 6f 74 0a 6f 66 20 to the root.of 0f90: 74 68 65 20 70 72 6f 6a 65 63 74 20 66 69 6c 65 the project file 0fa0: 20 68 69 65 72 61 72 63 68 79 2e 20 20 4e 6f 20 hierarchy. No 0fb0: 22 2e 2e 22 20 6f 72 20 22 2e 22 20 64 69 72 65 ".." or "." dire 0fc0: 63 74 6f 72 69 65 73 20 61 72 65 20 61 6c 6c 6f ctories are allo 0fd0: 77 65 64 0a 77 69 74 68 69 6e 20 74 68 65 20 66 wed.within the f 0fe0: 69 6c 65 6e 61 6d 65 2e 20 20 53 70 61 63 65 20 ilename. Space 0ff0: 63 68 61 72 61 63 74 65 72 73 20 61 72 65 20 65 characters are e 1000: 73 63 61 70 65 64 20 61 73 20 69 6e 20 43 2d 63 scaped as in C-c 1010: 61 72 64 0a 63 6f 6d 6d 65 6e 74 20 74 65 78 74 ard.comment text 1020: 2e 20 20 42 61 63 6b 73 6c 61 73 68 20 63 68 61 . Backslash cha 1030: 72 61 63 74 65 72 73 20 61 6e 64 20 6e 65 77 6c racters and newl 1040: 69 6e 65 73 20 61 72 65 20 6e 6f 74 20 61 6c 6c ines are not all 1050: 6f 77 65 64 0a 77 69 74 68 69 6e 20 66 69 6c 65 owed.within file 1060: 6e 61 6d 65 73 2e 20 20 54 68 65 20 64 69 72 65 names. The dire 1070: 63 74 6f 72 79 20 73 65 70 61 72 61 74 6f 72 20 ctory separator 1080: 63 68 61 72 61 63 74 65 72 20 69 73 20 61 20 66 character is a f 1090: 6f 72 77 61 72 64 0a 73 6c 61 73 68 20 28 41 53 orward.slash (AS 10a0: 43 49 49 20 30 78 32 46 29 2e 20 20 54 68 65 20 CII 0x2F). The 10b0: 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 second argument 10c0: 74 6f 20 74 68 65 20 46 2d 63 61 72 64 20 69 73 to the F-card is 10d0: 20 74 68 65 0a 66 75 6c 6c 20 34 30 2d 63 68 61 the.full 40-cha 10e0: 72 61 63 74 65 72 20 6c 6f 77 65 72 2d 63 61 73 racter lower-cas 10f0: 65 20 68 65 78 61 64 65 63 69 6d 61 6c 20 53 48 e hexadecimal SH 1100: 41 31 20 68 61 73 68 20 6f 66 20 74 68 65 20 63 A1 hash of the c 1110: 6f 6e 74 65 6e 74 0a 61 72 74 69 66 61 63 74 2e ontent.artifact. 1120: 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 41 20 6d 61 6e .</p>..<p>.A man 1130: 69 66 65 73 74 20 68 61 73 20 7a 65 72 6f 20 6f ifest has zero o 1140: 72 20 6f 6e 65 20 50 2d 63 61 72 64 73 2e 20 20 r one P-cards. 1150: 4d 6f 73 74 20 6d 61 6e 69 66 65 73 74 73 20 68 Most manifests h 1160: 61 76 65 20 6f 6e 65 20 50 2d 63 61 72 64 2e 0a ave one P-card.. 1170: 54 68 65 20 50 2d 63 61 72 64 20 68 61 73 20 61 The P-card has a 1180: 20 76 61 72 79 69 6e 67 20 6e 75 6d 62 65 72 20 varying number 1190: 6f 66 20 61 72 67 75 6d 65 6e 74 73 20 74 68 61 of arguments tha 11a0: 74 0a 64 65 66 69 6e 65 73 20 6f 74 68 65 72 20 t.defines other 11b0: 6d 61 6e 69 66 65 73 74 73 20 66 72 6f 6d 20 77 manifests from w 11c0: 68 69 63 68 20 74 68 65 20 63 75 72 72 65 6e 74 hich the current 11d0: 20 6d 61 6e 69 66 65 73 74 0a 69 73 20 64 65 72 manifest.is der 11e0: 69 76 65 64 2e 20 20 45 61 63 68 20 61 72 67 75 ived. Each argu 11f0: 6d 65 6e 74 20 69 73 20 61 6e 20 34 30 2d 63 68 ment is an 40-ch 1200: 61 72 61 63 74 65 72 20 6c 6f 77 65 72 63 61 73 aracter lowercas 1210: 65 20 0a 68 65 78 61 64 65 63 69 6d 61 6c 20 53 e .hexadecimal S 1220: 48 41 31 20 6f 66 20 74 68 65 20 70 72 65 64 65 HA1 of the prede 1230: 63 65 73 73 6f 72 20 6d 61 6e 69 66 65 73 74 2e cessor manifest. 1240: 20 20 41 6c 6c 20 61 72 67 75 6d 65 6e 74 73 0a All arguments. 1250: 74 6f 20 74 68 65 20 50 2d 63 61 72 64 20 6d 75 to the P-card mu 1260: 73 74 20 62 65 20 75 6e 69 71 75 65 20 74 6f 20 st be unique to 1270: 74 68 61 74 20 6c 69 6e 65 2e 0a 54 68 65 20 66 that line..The f 1280: 69 72 73 74 20 70 72 65 64 65 63 65 73 73 6f 72 irst predecessor 1290: 20 69 73 20 74 68 65 20 64 69 72 65 63 74 20 61 is the direct a 12a0: 6e 63 65 73 74 6f 72 20 6f 66 20 74 68 65 20 6d ncestor of the m 12b0: 61 6e 69 66 65 73 74 2e 0a 4f 74 68 65 72 20 61 anifest..Other a 12c0: 72 67 75 6d 65 6e 74 73 20 64 65 66 69 6e 65 20 rguments define 12d0: 6d 61 6e 69 66 65 73 74 73 20 77 69 74 68 20 77 manifests with w 12e0: 68 69 63 68 20 74 68 65 20 66 69 72 73 74 20 77 hich the first w 12f0: 61 73 0a 6d 65 72 67 65 64 20 74 6f 20 79 69 65 as.merged to yie 1300: 6c 64 20 74 68 65 20 63 75 72 72 65 6e 74 20 6d ld the current m 1310: 61 6e 69 66 65 73 74 2e 20 20 4d 6f 73 74 20 6d anifest. Most m 1320: 61 6e 69 66 65 73 74 73 20 68 61 76 65 0a 61 20 anifests have.a 1330: 50 2d 63 61 72 64 20 77 69 74 68 20 61 20 73 69 P-card with a si 1340: 6e 67 6c 65 20 61 72 67 75 6d 65 6e 74 2e 20 20 ngle argument. 1350: 54 68 65 20 66 69 72 73 74 20 6d 61 6e 69 66 65 The first manife 1360: 73 74 20 69 6e 20 74 68 65 0a 70 72 6f 6a 65 63 st in the.projec 1370: 74 20 68 61 73 20 6e 6f 20 61 6e 63 65 73 74 6f t has no ancesto 1380: 72 73 20 61 6e 64 20 74 68 75 73 20 68 61 73 20 rs and thus has 1390: 6e 6f 20 50 2d 63 61 72 64 2e 0a 3c 2f 70 3e 0a no P-card..</p>. 13a0: 0a 3c 70 3e 0a 41 20 6d 61 6e 69 66 65 73 74 20 .<p>.A manifest 13b0: 6d 61 79 20 6f 70 74 69 6f 6e 61 6c 6c 79 20 68 may optionally h 13c0: 61 76 65 20 61 20 73 69 6e 67 6c 65 20 52 2d 63 ave a single R-c 13d0: 61 72 64 2e 20 20 54 68 65 20 52 2d 63 61 72 64 ard. The R-card 13e0: 20 68 61 73 0a 61 20 73 69 6e 67 6c 65 20 61 72 has.a single ar 13f0: 67 75 6d 65 6e 74 20 77 68 69 63 68 20 69 73 20 gument which is 1400: 74 68 65 20 4d 44 35 20 63 68 65 63 6b 73 75 6d the MD5 checksum 1410: 20 6f 66 20 61 6c 6c 20 66 69 6c 65 73 20 69 6e of all files in 1420: 20 0a 74 68 65 20 62 61 73 65 6c 69 6e 65 20 65 .the baseline e 1430: 78 63 65 70 74 20 74 68 65 20 6d 61 6e 69 66 65 xcept the manife 1440: 73 74 20 69 74 73 65 6c 66 2e 20 20 54 68 65 20 st itself. The 1450: 63 68 65 63 6b 73 75 6d 20 69 73 20 65 78 70 72 checksum is expr 1460: 65 73 73 65 64 0a 61 73 20 33 32 2d 63 68 61 72 essed.as 32-char 1470: 61 63 74 65 72 73 20 6f 66 20 6c 6f 77 65 72 63 acters of lowerc 1480: 61 73 65 20 68 65 78 61 64 65 63 69 6d 61 6c 2e ase hexadecimal. 1490: 20 20 20 54 68 65 20 63 68 65 63 6b 73 75 6d 20 The checksum 14a0: 69 73 0a 63 6f 6d 70 75 74 65 64 20 61 73 20 66 is.computed as f 14b0: 6f 6c 6c 6f 77 73 3a 20 20 46 6f 72 20 65 61 63 ollows: For eac 14c0: 68 20 66 69 6c 65 20 69 6e 20 74 68 65 20 62 61 h file in the ba 14d0: 73 65 6c 69 6e 65 20 28 65 78 63 65 70 74 20 66 seline (except f 14e0: 6f 72 0a 74 68 65 20 6d 61 6e 69 66 65 73 74 20 or.the manifest 14f0: 69 74 73 65 6c 66 29 20 69 6e 20 73 74 72 69 63 itself) in stric 1500: 74 20 73 6f 72 74 65 64 20 6c 65 78 69 63 6f 67 t sorted lexicog 1510: 72 61 70 68 69 63 61 6c 20 6f 72 64 65 72 2c 20 raphical order, 1520: 0a 74 61 6b 65 20 74 68 65 20 70 61 74 68 6e 61 .take the pathna 1530: 6d 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 72 me of the file r 1540: 65 6c 61 74 69 76 65 20 74 6f 20 74 68 65 20 72 elative to the r 1550: 6f 6f 74 20 6f 66 20 74 68 65 0a 72 65 70 6f 73 oot of the.repos 1560: 69 74 6f 72 79 2c 20 61 70 70 65 6e 64 20 61 20 itory, append a 1570: 73 69 6e 67 6c 65 20 73 70 61 63 65 20 28 41 53 single space (AS 1580: 43 49 49 20 30 78 32 30 29 2c 20 74 68 65 0a 73 CII 0x20), the.s 1590: 69 7a 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 ize of the file 15a0: 69 6e 20 41 53 43 49 49 20 64 65 63 69 6d 61 6c in ASCII decimal 15b0: 2c 20 61 20 73 69 6e 67 6c 65 20 6e 65 77 6c 69 , a single newli 15c0: 6e 65 0a 63 68 61 72 61 63 74 65 72 20 28 41 53 ne.character (AS 15d0: 43 49 49 20 30 78 30 41 29 2c 20 61 6e 64 20 74 CII 0x0A), and t 15e0: 68 65 20 63 6f 6d 70 6c 65 74 65 20 74 65 78 74 he complete text 15f0: 20 6f 66 20 74 68 65 20 66 69 6c 65 2e 0a 43 6f of the file..Co 1600: 6d 70 75 74 65 20 74 68 65 20 4d 44 35 20 63 68 mpute the MD5 ch 1610: 65 63 6b 73 75 6d 20 6f 66 20 74 68 65 20 74 68 ecksum of the th 1620: 65 20 72 65 73 75 6c 74 2e 0a 3c 2f 70 3e 0a 0a e result..</p>.. 1630: 3c 70 3e 0a 45 61 63 68 20 6d 61 6e 69 66 65 73 <p>.Each manifes 1640: 74 20 68 61 73 20 61 20 73 69 6e 67 6c 65 20 55 t has a single U 1650: 2d 63 61 72 64 2e 20 20 54 68 65 20 61 72 67 75 -card. The argu 1660: 6d 65 6e 74 20 74 6f 20 74 68 65 20 55 2d 63 61 ment to the U-ca 1670: 72 64 20 69 73 0a 74 68 65 20 6c 6f 67 69 6e 20 rd is.the login 1680: 6f 66 20 74 68 65 20 75 73 65 72 20 77 68 6f 20 of the user who 1690: 63 72 65 61 74 65 64 20 74 68 65 20 6d 61 6e 69 created the mani 16a0: 66 65 73 74 2e 20 20 54 68 65 20 6c 6f 67 69 6e fest. The login 16b0: 20 6e 61 6d 65 0a 69 73 20 65 6e 63 6f 64 65 64 name.is encoded 16c0: 20 75 73 69 6e 67 20 74 68 65 20 73 61 6d 65 20 using the same 16d0: 63 68 61 72 61 63 74 65 72 20 65 73 63 61 70 65 character escape 16e0: 73 20 61 73 20 69 73 20 75 73 65 64 20 66 6f 72 s as is used for 16f0: 20 74 68 65 0a 63 68 65 63 6b 2d 69 6e 20 63 6f the.check-in co 1700: 6d 6d 65 6e 74 20 61 72 67 75 6d 65 6e 74 20 74 mment argument t 1710: 6f 20 74 68 65 20 43 2d 63 61 72 64 2e 0a 3c 2f o the C-card..</ 1720: 70 3e 0a 0a 3c 70 3e 0a 41 20 6d 61 6e 69 66 65 p>..<p>.A manife 1730: 73 74 20 68 61 73 20 61 6e 20 6f 70 74 69 6f 6e st has an option 1740: 20 5a 2d 63 61 72 64 20 61 73 20 69 74 73 20 6c Z-card as its l 1750: 61 73 74 20 6c 69 6e 65 2e 20 20 54 68 65 20 61 ast line. The a 1760: 72 67 75 6d 65 6e 74 0a 74 6f 20 74 68 65 20 5a rgument.to the Z 1770: 2d 63 61 72 64 20 69 73 20 61 20 33 32 2d 63 68 -card is a 32-ch 1780: 61 72 61 63 74 65 72 20 6c 6f 77 65 72 63 61 73 aracter lowercas 1790: 65 20 68 65 78 61 64 65 63 69 6d 61 6c 20 4d 44 e hexadecimal MD 17a0: 35 20 68 61 73 68 0a 6f 66 20 61 6c 6c 20 70 72 5 hash.of all pr 17b0: 69 6f 72 20 6c 69 6e 65 73 20 6f 66 20 74 68 65 ior lines of the 17c0: 20 6d 61 6e 69 66 65 73 74 20 75 70 20 74 6f 20 manifest up to 17d0: 61 6e 64 20 69 6e 63 6c 75 64 69 6e 67 20 74 68 and including th 17e0: 65 20 6e 65 77 6c 69 6e 65 20 0a 63 68 61 72 61 e newline .chara 17f0: 63 74 65 72 20 74 68 61 74 20 69 6d 6d 65 64 69 cter that immedi 1800: 61 74 65 6c 79 20 70 72 65 63 65 65 64 73 20 74 ately preceeds t 1810: 68 65 20 22 5a 22 2e 20 20 54 68 65 20 5a 2d 63 he "Z". The Z-c 1820: 61 72 64 20 69 73 20 6a 75 73 74 0a 61 20 73 61 ard is just.a sa 1830: 6e 69 74 79 20 63 68 65 63 6b 20 74 6f 20 70 72 nity check to pr 1840: 6f 76 65 20 74 68 61 74 20 74 68 65 20 6d 61 6e ove that the man 1850: 69 66 65 73 74 20 69 73 20 77 65 6c 6c 2d 66 6f ifest is well-fo 1860: 72 6d 65 64 20 61 6e 64 0a 63 6f 6e 73 69 73 74 rmed and.consist 1870: 65 6e 74 2e 0a 3c 2f 70 3e 0a 0a 3c 68 32 3e 32 ent..</p>..<h2>2 1880: 2e 30 20 43 6c 75 73 74 65 72 73 3c 2f 68 32 3e .0 Clusters</h2> 1890: 0a 0a 3c 70 3e 0a 41 20 63 6c 75 73 74 65 72 20 ..<p>.A cluster 18a0: 69 73 20 61 20 61 72 74 69 66 61 63 74 20 74 68 is a artifact th 18b0: 61 74 20 64 65 63 6c 61 72 65 73 20 74 68 65 20 at declares the 18c0: 65 78 69 73 74 61 6e 63 65 20 6f 66 20 6f 74 68 existance of oth 18d0: 65 72 20 61 72 74 69 66 61 63 74 73 2e 0a 43 6c er artifacts..Cl 18e0: 75 73 74 65 72 73 20 61 72 65 20 75 73 65 64 20 usters are used 18f0: 64 75 72 69 6e 67 20 72 65 70 6f 73 69 74 6f 72 during repositor 1900: 79 20 73 79 6e 63 68 72 6f 6e 69 7a 61 74 69 6f y synchronizatio 1910: 6e 20 74 6f 20 68 65 6c 70 20 0a 72 65 64 75 63 n to help .reduc 1920: 65 20 6e 65 74 77 6f 72 6b 20 74 72 61 66 66 69 e network traffi 1930: 63 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 43 6c 75 c..</p>..<p>.Clu 1940: 73 74 65 72 73 20 66 6f 6c 6c 6f 77 20 61 20 73 sters follow a s 1950: 79 6e 74 61 78 20 74 68 61 74 20 69 73 20 76 65 yntax that is ve 1960: 72 79 20 73 69 6d 69 6c 61 72 20 74 6f 20 6d 61 ry similar to ma 1970: 6e 69 66 65 73 74 73 2e 0a 41 20 43 6c 75 73 74 nifests..A Clust 1980: 65 72 20 69 73 20 61 20 6c 69 6e 65 2d 6f 72 69 er is a line-ori 1990: 65 6e 74 65 64 20 74 65 78 74 20 66 69 6c 65 2e ented text file. 19a0: 20 20 4e 65 77 6c 69 6e 65 20 63 68 61 72 61 63 Newline charac 19b0: 74 65 72 73 0a 28 41 53 43 49 49 20 30 78 30 61 ters.(ASCII 0x0a 19c0: 29 20 73 65 70 61 72 61 74 65 20 74 68 65 20 61 ) separate the a 19d0: 72 74 69 66 61 63 74 20 69 6e 74 6f 20 63 61 72 rtifact into car 19e0: 64 73 2e 20 20 45 61 63 68 20 63 61 72 64 20 62 ds. Each card b 19f0: 65 67 69 6e 73 20 77 69 74 68 20 61 20 73 69 6e egins with a sin 1a00: 67 6c 65 0a 63 68 61 72 61 63 74 65 72 20 22 63 gle.character "c 1a10: 61 72 64 20 74 79 70 65 22 2e 20 20 5a 65 72 6f ard type". Zero 1a20: 20 6f 72 20 6d 6f 72 65 20 61 72 67 75 6d 65 6e or more argumen 1a30: 74 73 20 6d 61 79 20 66 6f 6c 6c 6f 77 0a 74 68 ts may follow.th 1a40: 65 20 63 61 72 64 20 74 79 70 65 2e 20 20 41 6c e card type. Al 1a50: 6c 20 61 72 67 75 6d 65 6e 74 73 20 61 72 65 20 l arguments are 1a60: 73 65 70 61 72 61 74 65 64 20 66 72 6f 6d 20 65 separated from e 1a70: 61 63 68 20 6f 74 68 65 72 0a 61 6e 64 20 66 72 ach other.and fr 1a80: 6f 6d 20 74 68 65 20 63 61 72 64 2d 74 79 70 65 om the card-type 1a90: 20 63 68 61 72 61 63 74 65 72 20 62 79 20 61 20 character by a 1aa0: 73 69 6e 67 6c 65 20 73 70 61 63 65 0a 63 68 61 single space.cha 1ab0: 72 61 63 74 65 72 2e 20 20 54 68 65 72 65 20 69 racter. There i 1ac0: 73 20 6e 6f 20 73 75 72 70 6c 75 73 20 77 68 69 s no surplus whi 1ad0: 74 65 20 73 70 61 63 65 20 62 65 74 77 65 65 6e te space between 1ae0: 20 61 72 67 75 6d 65 6e 74 73 0a 61 6e 64 20 6e arguments.and n 1af0: 6f 20 6c 65 61 64 69 6e 67 20 6f 72 20 74 72 61 o leading or tra 1b00: 69 6c 69 6e 67 20 77 68 69 74 65 73 70 61 63 65 iling whitespace 1b10: 20 65 78 63 65 70 74 20 66 6f 72 20 74 68 65 20 except for the 1b20: 6e 65 77 6c 69 6e 65 20 0a 63 68 61 72 61 63 74 newline .charact 1b30: 65 72 20 74 68 61 74 20 61 63 74 73 20 61 73 20 er that acts as 1b40: 74 68 65 20 63 61 72 64 20 73 65 70 61 72 61 74 the card separat 1b50: 6f 72 2e 0a 41 6c 6c 20 63 61 72 64 73 20 6f 66 or..All cards of 1b60: 20 61 20 63 6c 75 74 65 72 20 6f 63 63 75 72 20 a cluter occur 1b70: 69 6e 20 73 74 72 69 63 74 20 73 6f 72 74 65 64 in strict sorted 1b80: 20 6c 65 78 69 63 6f 67 72 61 70 68 69 63 61 6c lexicographical 1b90: 20 6f 72 64 65 72 2e 0a 4e 6f 20 63 61 72 64 20 order..No card 1ba0: 6d 61 79 20 62 65 20 64 75 70 6c 69 63 61 74 65 may be duplicate 1bb0: 64 2e 0a 54 68 65 20 63 6c 75 73 74 65 72 20 6d d..The cluster m 1bc0: 61 79 20 6e 6f 74 20 63 6f 6e 74 61 69 6e 20 61 ay not contain a 1bd0: 64 64 69 74 69 6f 6e 61 6c 20 74 65 78 74 20 6f dditional text o 1be0: 72 20 64 61 74 61 20 62 65 79 6f 6e 64 20 0a 77 r data beyond .w 1bf0: 68 61 74 20 69 73 20 64 65 73 63 72 69 62 65 64 hat is described 1c00: 20 68 65 72 65 2e 0a 55 6e 6c 69 6b 65 20 6d 61 here..Unlike ma 1c10: 6e 69 66 65 73 74 73 2c 20 63 6c 75 73 74 65 72 nifests, cluster 1c20: 73 20 61 72 65 20 6e 65 76 65 72 20 50 47 50 20 s are never PGP 1c30: 73 69 67 6e 65 64 2e 0a 3c 2f 70 3e 0a 0a 3c 70 signed..</p>..<p 1c40: 3e 0a 41 6c 6c 6f 77 65 64 20 63 61 72 64 73 20 >.Allowed cards 1c50: 69 6e 20 74 68 65 20 63 6c 75 73 74 65 72 20 61 in the cluster a 1c60: 72 65 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 3c re as follows:.< 1c70: 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 /p>..<blockquote 1c80: 3e 0a 3c 62 3e 4d 3c 2f 62 3e 20 3c 69 3e 75 75 >.<b>M</b> <i>uu 1c90: 69 64 3c 2f 69 3e 3c 62 72 20 2f 3e 0a 3c 62 3e id</i><br />.<b> 1ca0: 5a 3c 2f 62 3e 20 3c 69 3e 63 68 65 63 6b 73 75 Z</b> <i>checksu 1cb0: 6d 3c 2f 69 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f m</i>.</blockquo 1cc0: 74 65 3e 0a 0a 3c 70 3e 0a 41 20 63 6c 75 73 74 te>..<p>.A clust 1cd0: 65 72 20 63 6f 6e 74 61 69 6e 73 20 6f 6e 65 20 er contains one 1ce0: 6f 72 20 6d 6f 72 65 20 22 4d 22 20 63 61 72 64 or more "M" card 1cf0: 73 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 61 20 s followed by a 1d00: 73 69 6e 67 6c 65 20 22 5a 22 0a 6c 69 6e 65 2e single "Z".line. 1d10: 20 20 45 61 63 68 20 4d 20 63 61 72 64 20 68 61 Each M card ha 1d20: 73 20 61 20 73 69 6e 67 6c 65 20 61 72 67 75 6d s a single argum 1d30: 65 6e 74 20 77 68 69 63 68 20 69 73 20 74 68 65 ent which is the 1d40: 20 55 55 49 44 20 6f 66 20 0a 61 6e 6f 74 68 65 UUID of .anothe 1d50: 72 20 61 72 74 69 66 61 63 74 20 69 6e 20 74 68 r artifact in th 1d60: 65 20 72 65 70 6f 73 69 74 6f 72 79 2e 20 20 54 e repository. T 1d70: 68 65 20 5a 20 63 61 72 64 20 77 6f 72 6b 20 65 he Z card work e 1d80: 78 61 63 74 6c 79 20 6c 69 6b 65 0a 74 68 65 20 xactly like.the 1d90: 5a 20 63 61 72 64 20 6f 66 20 61 20 6d 61 6e 69 Z card of a mani 1da0: 66 65 73 74 2e 20 20 54 68 65 20 61 72 67 75 6d fest. The argum 1db0: 65 6e 74 20 74 6f 20 74 68 65 20 5a 20 63 61 72 ent to the Z car 1dc0: 64 20 69 73 20 74 68 65 0a 6c 6f 77 65 72 2d 63 d is the.lower-c 1dd0: 61 73 65 20 68 65 78 61 64 65 63 69 6d 61 6c 20 ase hexadecimal 1de0: 72 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 6f representation o 1df0: 66 20 74 68 65 20 4d 44 35 20 63 68 65 63 6b 73 f the MD5 checks 1e00: 75 6d 20 6f 66 20 61 6c 6c 0a 70 72 69 6f 72 20 um of all.prior 1e10: 63 61 72 64 73 20 69 6e 20 74 68 65 20 63 6c 75 cards in the clu 1e20: 73 74 65 72 2e 20 20 4e 6f 74 65 20 74 68 61 74 ster. Note that 1e30: 20 74 68 65 20 5a 20 63 61 72 64 20 69 73 20 72 the Z card is r 1e40: 65 71 75 69 72 65 64 0a 6f 6e 20 61 20 63 6c 75 equired.on a clu 1e50: 73 74 65 72 2e 0a 3c 2f 70 3e 0a 0a 0a 3c 68 32 ster..</p>...<h2 1e60: 3e 33 2e 30 20 43 6f 6e 74 72 6f 6c 20 41 72 74 >3.0 Control Art 1e70: 69 66 61 63 74 73 3c 2f 68 32 3e 0a 0a 3c 70 3e ifacts</h2>..<p> 1e80: 0a 43 6f 6e 74 72 6f 6c 20 61 72 74 69 66 61 63 .Control artifac 1e90: 74 73 20 61 72 65 20 75 73 65 64 20 74 6f 20 61 ts are used to a 1ea0: 73 73 69 67 6e 20 70 72 6f 70 65 72 74 69 65 73 ssign properties 1eb0: 20 74 6f 20 6f 74 68 65 72 20 61 72 74 69 66 61 to other artifa 1ec0: 63 74 73 0a 77 69 74 68 69 6e 20 74 68 65 20 72 cts.within the r 1ed0: 65 70 6f 73 69 74 6f 72 79 2e 20 20 54 68 65 20 epository. The 1ee0: 62 61 73 69 63 20 66 6f 72 6d 61 74 20 6f 66 20 basic format of 1ef0: 61 20 63 6f 6e 74 72 6f 6c 20 61 72 74 69 66 61 a control artifa 1f00: 63 74 20 69 73 0a 74 68 65 20 73 61 6d 65 20 61 ct is.the same a 1f10: 73 20 61 20 6d 61 6e 69 66 65 73 74 20 6f 72 20 s a manifest or 1f20: 63 6c 75 73 74 65 72 2e 20 20 41 20 63 6f 6e 74 cluster. A cont 1f30: 72 6f 6c 20 61 72 74 69 66 61 63 74 20 69 73 20 rol artifact is 1f40: 61 20 74 65 78 74 0a 66 69 6c 65 73 20 64 69 76 a text.files div 1f50: 69 64 65 64 20 69 6e 74 6f 20 63 61 72 64 73 20 ided into cards 1f60: 62 79 20 6e 65 77 6c 69 6e 65 20 63 68 61 72 61 by newline chara 1f70: 63 74 65 72 73 2e 20 20 45 61 63 68 20 63 61 72 cters. Each car 1f80: 64 20 68 61 73 20 61 0a 73 69 6e 67 6c 65 2d 63 d has a.single-c 1f90: 68 61 72 61 63 74 65 72 20 63 61 72 64 20 74 79 haracter card ty 1fa0: 70 65 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 61 pe followed by a 1fb0: 72 67 75 6d 65 6e 74 73 2e 20 20 53 70 61 63 65 rguments. Space 1fc0: 73 20 73 65 70 61 72 61 74 65 0a 74 68 65 20 63 s separate.the c 1fd0: 61 72 64 20 74 79 70 65 20 61 6e 64 20 74 68 65 ard type and the 1fe0: 20 61 72 67 75 6d 65 6e 74 73 2e 20 20 4e 6f 20 arguments. No 1ff0: 73 75 72 70 6c 75 73 20 77 68 69 74 65 73 70 61 surplus whitespa 2000: 63 65 20 69 73 20 61 6c 6c 6f 77 65 64 2e 0a 41 ce is allowed..A 2010: 6c 6c 20 63 61 72 64 73 20 6d 75 73 74 20 6f 63 ll cards must oc 2020: 63 75 72 20 69 6e 20 73 74 72 69 63 74 20 6c 65 cur in strict le 2030: 78 69 67 72 61 70 68 69 63 61 6c 20 6f 72 64 65 xigraphical orde 2040: 72 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 41 6c 6c r..</p>..<p>.All 2050: 6f 77 65 64 20 63 61 72 64 73 20 69 6e 20 61 20 owed cards in a 2060: 63 6f 6e 74 72 6f 6c 20 61 72 74 69 66 61 63 74 control artifact 2070: 20 61 72 65 20 61 73 20 66 6f 6c 6c 6f 77 73 3a are as follows: 2080: 0a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f .</p>..<blockquo 2090: 74 65 3e 0a 3c 62 3e 44 3c 2f 62 3e 20 3c 69 3e te>.<b>D</b> <i> 20a0: 74 69 6d 65 2d 61 6e 64 2d 64 61 74 65 2d 73 74 time-and-date-st 20b0: 61 6d 70 3c 2f 69 3e 3c 62 72 20 2f 3e 0a 3c 62 amp</i><br />.<b 20c0: 3e 54 3c 2f 62 3e 20 28 3c 62 3e 2b 3c 2f 62 3e >T</b> (<b>+</b> 20d0: 7c 3c 62 3e 2d 3c 2f 62 3e 7c 3c 62 3e 2a 3c 2f |<b>-</b>|<b>*</ 20e0: 62 3e 29 3c 69 3e 74 61 67 2d 6e 61 6d 65 20 20 b>)<i>tag-name 20f0: 75 75 69 64 20 20 3f 76 61 6c 75 65 3f 3c 2f 69 uuid ?value?</i 2100: 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 5a 3c 2f 62 3e ><br />.<b>Z</b> 2110: 20 3c 69 3e 63 68 65 63 6b 73 75 6d 3c 2f 69 3e <i>checksum</i> 2120: 3c 62 72 20 2f 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 <br />.</blockqu 2130: 6f 74 65 3e 0a 0a 3c 70 3e 0a 41 20 63 6f 6e 74 ote>..<p>.A cont 2140: 72 6f 6c 20 61 72 74 69 66 61 63 74 20 6d 75 73 rol artifact mus 2150: 74 20 68 61 76 65 20 6f 6e 65 20 44 20 63 61 72 t have one D car 2160: 64 20 61 6e 64 20 6f 6e 65 20 5a 20 63 61 72 64 d and one Z card 2170: 20 61 6e 64 0a 6f 6e 65 20 6f 72 20 6d 6f 72 65 and.one or more 2180: 20 6f 72 20 6d 6f 72 65 20 54 20 63 61 72 64 73 or more T cards 2190: 2e 20 20 4e 6f 20 6f 74 68 65 72 20 63 61 72 64 . No other card 21a0: 73 20 6f 72 20 6f 74 68 65 72 20 74 65 78 74 20 s or other text 21b0: 69 73 0a 61 6c 6c 6f 77 65 64 20 69 6e 20 61 20 is.allowed in a 21c0: 63 6f 6e 74 72 6f 6c 20 61 72 74 69 66 61 63 74 control artifact 21d0: 2e 20 20 43 6f 6e 74 72 6f 6c 20 61 72 74 69 66 . Control artif 21e0: 61 63 74 73 20 6d 69 67 68 74 20 62 65 20 50 47 acts might be PG 21f0: 50 0a 63 6c 65 61 72 73 69 67 6e 65 64 2e 3c 2f P.clearsigned.</ 2200: 70 3e 0a 0a 3c 70 3e 54 68 65 20 44 20 63 61 72 p>..<p>The D car 2210: 64 20 61 6e 64 20 74 68 65 20 5a 20 63 61 72 64 d and the Z card 2220: 20 6f 66 20 61 20 63 6f 6e 74 72 6f 6c 20 61 72 of a control ar 2230: 74 69 66 61 63 74 20 61 72 65 20 74 68 65 20 73 tifact are the s 2240: 61 6d 65 0a 61 73 20 69 6e 20 61 20 6d 61 6e 69 ame.as in a mani 2250: 66 65 73 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 fest.</p>..<p>Th 2260: 65 20 54 20 63 61 72 64 20 72 65 70 72 65 73 65 e T card represe 2270: 6e 74 73 20 61 20 22 74 61 67 22 20 6f 72 20 70 nts a "tag" or p 2280: 72 6f 70 65 72 74 79 20 74 68 61 74 20 69 73 20 roperty that is 2290: 61 70 70 6c 69 65 64 20 74 6f 0a 73 6f 6d 65 20 applied to.some 22a0: 6f 74 68 65 72 20 61 72 74 69 66 61 63 74 2e 20 other artifact. 22b0: 20 54 68 65 20 54 20 63 61 72 64 20 68 61 73 20 The T card has 22c0: 74 77 6f 20 6f 72 20 74 68 72 65 65 20 76 61 6c two or three val 22d0: 75 65 73 2e 20 20 54 68 65 0a 73 65 63 6f 6e 64 ues. The.second 22e0: 20 61 72 67 75 6d 65 6e 74 20 69 73 20 74 68 65 argument is the 22f0: 20 34 30 20 63 68 61 72 61 63 74 65 72 20 6c 6f 40 character lo 2300: 77 65 72 63 61 73 65 20 55 55 49 44 20 6f 66 20 wercase UUID of 2310: 74 68 65 20 61 72 74 69 66 61 63 74 0a 74 6f 20 the artifact.to 2320: 77 68 69 63 68 20 74 68 65 20 74 61 67 20 69 73 which the tag is 2330: 20 74 6f 20 62 65 20 61 70 70 6c 69 65 64 2e 20 to be applied. 2340: 54 68 65 0a 66 69 72 73 74 20 76 61 6c 75 65 20 The.first value 2350: 69 73 20 74 68 65 20 74 61 67 20 6e 61 6d 65 2e is the tag name. 2360: 20 20 54 68 65 20 66 69 72 73 74 20 63 68 61 72 The first char 2370: 61 63 74 65 72 20 6f 66 20 74 68 65 20 74 61 67 acter of the tag 2380: 0a 69 73 20 65 69 74 68 65 72 20 22 2b 22 2c 20 .is either "+", 2390: 22 2d 22 2c 20 6f 72 20 22 2a 22 2e 20 20 41 20 "-", or "*". A 23a0: 22 2b 22 20 6d 65 61 6e 73 20 74 68 65 20 74 61 "+" means the ta 23b0: 67 20 73 68 6f 75 6c 64 20 62 65 20 61 64 64 65 g should be adde 23c0: 64 0a 74 6f 20 74 68 65 20 61 72 74 69 66 61 63 d.to the artifac 23d0: 74 2e 20 20 54 68 65 20 22 2d 22 20 6d 65 61 6e t. The "-" mean 23e0: 73 20 74 68 65 20 74 61 67 20 73 68 6f 75 6c 64 s the tag should 23f0: 20 62 65 20 72 65 6d 6f 76 65 64 2e 0a 54 68 65 be removed..The 2400: 20 22 2a 22 20 63 68 61 72 61 63 74 65 72 20 6d "*" character m 2410: 65 61 6e 73 20 74 68 65 20 74 61 67 20 73 68 6f eans the tag sho 2420: 75 6c 64 20 62 65 20 61 64 64 65 64 20 74 6f 20 uld be added to 2430: 74 68 65 20 61 72 74 69 66 61 63 74 0a 61 6e 64 the artifact.and 2440: 20 61 6c 6c 20 64 69 72 65 63 74 20 64 65 63 65 all direct dece 2450: 6e 64 61 6e 74 73 20 28 62 75 74 20 6e 6f 74 20 ndants (but not 2460: 62 72 61 6e 63 68 65 73 29 20 6f 66 20 74 68 65 branches) of the 2470: 20 61 72 74 69 66 61 63 74 20 64 6f 77 6e 0a 74 artifact down.t 2480: 6f 20 62 75 74 20 6e 6f 74 20 69 6e 63 6c 75 64 o but not includ 2490: 69 6e 67 20 74 68 65 20 66 69 72 73 74 20 64 65 ing the first de 24a0: 63 65 6e 64 61 6e 74 20 74 68 61 74 20 63 6f 6e cendant that con 24b0: 74 61 69 6e 73 20 61 20 0a 6d 6f 72 65 20 72 65 tains a .more re 24c0: 63 65 6e 74 20 22 2d 22 20 74 61 67 20 77 69 74 cent "-" tag wit 24d0: 68 20 74 68 65 20 73 61 6d 65 20 6e 61 6d 65 2e h the same name. 24e0: 0a 54 68 65 20 6f 70 74 69 6f 6e 61 6c 20 74 68 .The optional th 24f0: 69 72 64 20 61 72 67 75 6d 65 6e 74 20 69 73 20 ird argument is 2500: 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 the value of the 2510: 20 74 61 67 2e 20 20 41 20 74 61 67 0a 77 69 74 tag. A tag.wit 2520: 68 6f 75 74 20 61 20 76 61 6c 75 65 20 69 73 20 hout a value is 2530: 61 20 62 6f 6f 6c 65 61 6e 2e 3c 2f 70 3e 0a 0a a boolean.</p>.. 2540: 3c 70 3e 57 68 65 6e 20 74 77 6f 20 6f 72 20 6d <p>When two or m 2550: 6f 72 65 20 74 61 67 73 20 77 69 74 68 20 74 68 ore tags with th 2560: 65 20 73 61 6d 65 20 6e 61 6d 65 20 61 72 65 20 e same name are 2570: 61 70 70 6c 69 65 64 20 74 6f 20 74 68 65 0a 73 applied to the.s 2580: 61 6d 65 20 61 72 74 69 66 61 63 74 2c 20 74 68 ame artifact, th 2590: 65 20 74 61 67 20 77 69 74 68 20 74 68 65 20 6c e tag with the l 25a0: 61 74 65 73 74 20 28 6d 6f 73 74 20 72 65 63 65 atest (most rece 25b0: 6e 74 29 20 64 61 74 65 20 69 73 0a 75 73 65 64 nt) date is.used 25c0: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 53 6f 6d 65 20 74 .</p>..<p>Some t 25d0: 61 67 73 20 68 61 76 65 20 73 70 65 63 69 61 6c ags have special 25e0: 20 6d 65 61 6e 69 6e 67 2e 20 20 54 68 65 20 22 meaning. The " 25f0: 63 6f 6d 6d 65 6e 74 22 20 74 61 67 20 77 68 65 comment" tag whe 2600: 6e 20 61 70 70 6c 69 65 64 0a 74 6f 20 61 20 62 n applied.to a b 2610: 61 73 65 6c 69 6e 65 20 77 69 6c 6c 20 6f 76 65 aseline will ove 2620: 72 72 69 64 65 20 74 68 65 20 63 68 65 63 6b 2d rride the check- 2630: 69 6e 20 63 6f 6d 6d 65 6e 74 20 6f 66 20 74 68 in comment of th 2640: 61 74 20 62 61 73 65 6c 69 6e 65 0a 66 6f 72 20 at baseline.for 2650: 64 69 73 70 6c 61 79 20 70 75 72 70 6f 73 65 73 display purposes 2660: 2e 3c 2f 70 3e 0a 0a 3c 68 32 3e 34 2e 30 20 57 .</p>..<h2>4.0 W 2670: 69 6b 69 20 50 61 67 65 73 3c 2f 68 32 3e 0a 0a iki Pages</h2>.. 2680: 3c 70 3e 41 20 77 69 6b 69 20 70 61 67 65 20 69 <p>A wiki page i 2690: 73 20 61 6e 20 61 72 74 69 66 61 63 74 20 77 69 s an artifact wi 26a0: 74 68 20 61 20 66 6f 72 6d 61 74 20 73 69 6d 69 th a format simi 26b0: 6c 61 72 20 74 6f 20 6d 61 6e 69 66 65 73 74 73 lar to manifests 26c0: 2c 0a 63 6c 75 73 74 65 72 73 2c 20 61 6e 64 20 ,.clusters, and 26d0: 63 6f 6e 74 72 6f 6c 20 61 72 74 69 66 61 63 74 control artifact 26e0: 73 2e 20 20 54 68 65 20 61 72 74 69 66 61 63 74 s. The artifact 26f0: 20 69 73 20 64 69 76 69 64 65 64 20 69 6e 74 6f is divided into 2700: 0a 63 61 72 64 73 20 62 79 20 6e 65 77 6c 69 6e .cards by newlin 2710: 65 20 63 68 61 72 61 63 74 65 72 73 2e 20 20 54 e characters. T 2720: 68 65 20 66 6f 72 6d 61 74 20 6f 66 20 65 61 63 he format of eac 2730: 68 20 63 61 72 64 20 69 73 20 61 73 20 69 6e 0a h card is as in. 2740: 6d 61 6e 69 66 65 73 74 73 2c 20 63 6c 75 73 74 manifests, clust 2750: 65 72 73 2c 20 61 6e 64 20 63 6f 6e 74 72 6f 6c ers, and control 2760: 20 61 72 74 69 66 61 63 74 73 2e 20 20 57 69 6b artifacts. Wik 2770: 69 20 61 72 74 69 66 61 63 74 73 20 61 63 63 65 i artifacts acce 2780: 70 74 0a 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 pt.the following 2790: 20 63 61 72 64 20 74 79 70 65 73 3a 3c 2f 70 3e card types:</p> 27a0: 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c ..<blockquote>.< 27b0: 62 3e 44 3c 2f 62 3e 20 3c 69 3e 74 69 6d 65 2d b>D</b> <i>time- 27c0: 61 6e 64 2d 64 61 74 65 2d 73 74 61 6d 70 3c 2f and-date-stamp</ 27d0: 69 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 4c 3c 2f 62 i><br />.<b>L</b 27e0: 3e 20 3c 69 3e 77 69 6b 69 2d 74 69 74 6c 65 3c > <i>wiki-title< 27f0: 2f 69 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 50 3c 2f /i><br />.<b>P</ 2800: 62 3e 20 3c 69 3e 70 61 72 65 6e 74 2d 75 75 69 b> <i>parent-uui 2810: 64 3c 2f 69 3e 2b 3c 62 72 20 2f 3e 0a 3c 62 3e d</i>+<br />.<b> 2820: 55 3c 2f 62 3e 20 3c 69 3e 75 73 65 72 2d 6e 61 U</b> <i>user-na 2830: 6d 65 3c 2f 69 3e 3c 62 72 20 2f 3e 0a 3c 62 3e me</i><br />.<b> 2840: 57 3c 2f 62 3e 20 3c 69 3e 73 69 7a 65 3c 2f 69 W</b> <i>size</i 2850: 3e 20 3c 62 3e 5c 6e 3c 2f 62 3e 20 3c 69 3e 74 > <b>\n</b> <i>t 2860: 65 78 74 3c 2f 69 3e 20 3c 62 3e 5c 6e 3c 2f 62 ext</i> <b>\n</b 2870: 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 5a 3c 2f 62 3e ><br />.<b>Z</b> 2880: 20 3c 69 3e 63 68 65 63 6b 73 75 6d 3c 2f 69 3e <i>checksum</i> 2890: 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a .</blockquote>.. 28a0: 3c 70 3e 54 68 65 20 44 20 63 61 72 64 20 69 73 <p>The D card is 28b0: 20 74 68 65 20 64 61 74 65 20 61 6e 64 20 74 69 the date and ti 28c0: 6d 65 20 77 68 65 6e 20 74 68 65 20 77 69 6b 69 me when the wiki 28d0: 20 70 61 67 65 20 77 61 73 20 65 64 69 74 65 64 page was edited 28e0: 2e 0a 54 68 65 20 50 20 63 61 72 64 20 73 70 65 ..The P card spe 28f0: 63 69 66 69 65 73 20 74 68 65 20 70 61 72 65 6e cifies the paren 2900: 74 20 77 69 6b 69 20 70 61 67 65 73 2c 20 69 66 t wiki pages, if 2910: 20 61 6e 79 2e 20 20 54 68 65 20 4c 20 63 61 72 any. The L car 2920: 64 0a 67 69 76 65 73 20 74 68 65 20 6e 61 6d 65 d.gives the name 2930: 20 6f 66 20 74 68 65 20 77 69 6b 69 20 70 61 67 of the wiki pag 2940: 65 2e 20 20 54 68 65 20 55 20 63 61 72 64 20 73 e. The U card s 2950: 70 65 63 69 66 69 65 73 20 74 68 65 20 6c 6f 67 pecifies the log 2960: 69 6e 0a 6f 66 20 74 68 65 20 75 73 65 72 20 77 in.of the user w 2970: 68 6f 20 6d 61 64 65 20 74 68 69 73 20 65 64 69 ho made this edi 2980: 74 20 74 6f 20 74 68 65 20 77 69 6b 69 20 70 61 t to the wiki pa 2990: 67 65 2e 20 20 54 68 65 20 5a 20 63 61 72 64 20 ge. The Z card 29a0: 69 73 0a 74 68 65 20 75 73 75 61 6c 20 63 68 65 is.the usual che 29b0: 63 6b 73 75 6d 20 6f 76 65 72 20 74 68 65 20 65 cksum over the e 29c0: 69 74 68 65 72 20 61 72 74 69 66 61 63 74 2e 3c ither artifact.< 29d0: 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 57 20 63 61 /p>..<p>The W ca 29e0: 72 64 20 69 73 20 75 73 65 64 20 74 6f 20 73 70 rd is used to sp 29f0: 65 63 69 66 79 20 74 68 65 20 74 65 78 74 20 6f ecify the text o 2a00: 66 20 74 68 65 20 77 69 6b 69 20 70 61 67 65 2e f the wiki page. 2a10: 20 20 54 68 65 0a 61 72 67 75 6d 65 6e 74 20 74 The.argument t 2a20: 6f 20 74 68 65 20 57 20 63 61 72 64 20 69 73 20 o the W card is 2a30: 61 6e 20 69 6e 74 65 67 65 72 20 77 68 69 63 68 an integer which 2a40: 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f is the number o 2a50: 66 20 62 79 74 65 73 0a 6f 66 20 74 65 78 74 20 f bytes.of text 2a60: 69 6e 20 74 68 65 20 77 69 6b 69 20 70 61 67 65 in the wiki page 2a70: 2e 20 20 54 68 61 74 20 74 65 78 74 20 66 6f 6c . That text fol 2a80: 6c 6f 77 73 20 74 68 65 20 6e 65 77 6c 69 6e 65 lows the newline 2a90: 20 63 68 61 72 61 63 74 65 72 0a 74 68 61 74 20 character.that 2aa0: 74 65 72 6d 69 6e 61 74 65 73 20 74 68 65 20 57 terminates the W 2ab0: 20 63 61 72 64 2e 20 20 54 68 65 20 77 69 6b 69 card. The wiki 2ac0: 20 74 65 78 74 20 69 73 20 61 6c 77 61 79 73 20 text is always 2ad0: 66 6f 6c 6c 6f 77 65 64 20 62 79 20 6f 6e 65 0a followed by one. 2ae0: 65 78 74 72 61 20 6e 65 77 6c 69 6e 65 2e 3c 2f extra newline.</ 2af0: 70 3e 0a 0a 3c 68 32 3e 35 2e 30 20 54 69 63 6b p>..<h2>5.0 Tick 2b00: 65 74 20 43 68 61 6e 67 65 73 3c 2f 68 32 3e 0a et Changes</h2>. 2b10: 0a 3c 70 3e 41 20 74 69 63 6b 65 74 2d 63 68 61 .<p>A ticket-cha 2b20: 6e 67 65 20 61 72 74 69 66 61 63 74 20 72 65 70 nge artifact rep 2b30: 72 65 73 65 6e 74 73 20 61 20 63 68 61 6e 67 65 resents a change 2b40: 20 74 6f 20 61 20 74 72 6f 75 62 6c 65 20 74 69 to a trouble ti 2b50: 63 6b 65 74 2e 0a 54 68 65 20 66 6f 6c 6c 6f 77 cket..The follow 2b60: 69 6e 67 20 63 61 72 64 73 20 61 72 65 20 61 6c ing cards are al 2b70: 6c 6f 77 65 64 20 6f 6e 20 61 20 74 69 63 6b 65 lowed on a ticke 2b80: 74 20 63 68 61 6e 67 65 20 61 72 74 69 66 61 63 t change artifac 2b90: 74 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 t:</p>..<blockqu 2ba0: 6f 74 65 3e 0a 3c 62 3e 44 3c 2f 62 3e 20 3c 69 ote>.<b>D</b> <i 2bb0: 3e 74 69 6d 65 2d 61 6e 64 2d 64 61 74 65 2d 73 >time-and-date-s 2bc0: 74 61 6d 70 3c 2f 69 3e 3c 62 72 20 2f 3e 0a 3c tamp</i><br />.< 2bd0: 62 3e 4a 3c 2f 62 3e 20 3f 3c 62 3e 2b 3c 2f 62 b>J</b> ?<b>+</b 2be0: 3e 3f 3c 69 3e 6e 61 6d 65 20 76 61 6c 75 65 3c >?<i>name value< 2bf0: 2f 69 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 4b 3c 2f /i><br />.<b>K</ 2c00: 62 3e 20 3c 69 3e 74 69 63 6b 65 74 2d 75 75 69 b> <i>ticket-uui 2c10: 64 3c 2f 69 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 55 d</i><br />.<b>U 2c20: 3c 2f 62 3e 20 3c 69 3e 75 73 65 72 2d 6e 61 6d </b> <i>user-nam 2c30: 65 3c 2f 69 3e 3c 62 72 20 2f 3e 0a 3c 62 3e 5a e</i><br />.<b>Z 2c40: 3c 2f 62 3e 20 3c 69 3e 63 68 65 63 6b 73 75 6d </b> <i>checksum 2c50: 3c 2f 69 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 </i>.</blockquot 2c60: 65 3e 0a 0a 3c 70 3e 0a 54 68 65 20 44 20 63 61 e>..<p>.The D ca 2c70: 72 64 20 69 73 20 74 68 65 20 75 73 75 61 6c 20 rd is the usual 2c80: 64 61 74 65 20 61 6e 64 20 74 69 6d 65 20 73 74 date and time st 2c90: 61 6d 70 20 61 6e 64 20 72 65 70 72 65 73 65 6e amp and represen 2ca0: 74 73 20 74 68 65 20 70 6f 69 6e 74 0a 69 6e 20 ts the point.in 2cb0: 74 69 6d 65 20 77 68 65 6e 20 74 68 65 20 63 68 time when the ch 2cc0: 61 6e 67 65 20 77 61 73 20 65 6e 74 65 72 65 64 ange was entered 2cd0: 2e 20 20 54 68 65 20 55 20 63 61 72 64 20 69 73 . The U card is 2ce0: 20 74 68 65 20 6c 6f 67 69 6e 20 6f 66 20 74 68 the login of th 2cf0: 65 0a 70 72 6f 67 72 61 6d 6d 65 72 20 77 68 6f e.programmer who 2d00: 20 65 6e 74 65 72 65 64 20 74 68 69 73 20 63 68 entered this ch 2d10: 61 6e 67 65 2e 20 20 54 68 65 20 5a 20 63 61 72 ange. The Z car 2d20: 64 20 69 73 20 74 68 65 20 63 68 65 63 6b 73 75 d is the checksu 2d30: 6d 20 6f 76 65 72 0a 74 68 65 20 65 6e 74 69 72 m over.the entir 2d40: 65 20 61 72 74 69 66 61 63 74 2e 3c 2f 70 3e 0a e artifact.</p>. 2d50: 0a 3c 70 3e 0a 45 76 65 72 79 20 74 69 63 6b 65 .<p>.Every ticke 2d60: 74 20 68 61 73 20 61 20 55 55 49 44 2e 20 20 54 t has a UUID. T 2d70: 68 65 20 74 69 63 6b 65 74 20 74 6f 20 77 68 69 he ticket to whi 2d80: 63 68 20 74 68 69 73 20 63 68 61 6e 67 65 20 69 ch this change i 2d90: 73 20 61 70 70 6c 69 65 64 0a 69 73 20 73 70 65 s applied.is spe 2da0: 63 69 66 69 65 64 20 62 79 20 74 68 65 20 4b 20 cified by the K 2db0: 63 61 72 64 2e 20 20 41 20 74 69 63 6b 65 74 20 card. A ticket 2dc0: 65 78 69 73 74 73 20 69 66 20 69 74 20 63 6f 6e exists if it con 2dd0: 74 61 69 6e 73 20 6f 6e 65 20 6f 72 0a 6d 6f 72 tains one or.mor 2de0: 65 20 63 68 61 6e 67 65 73 2e 20 20 54 68 65 20 e changes. The 2df0: 66 69 72 73 74 20 22 63 68 61 6e 67 65 22 20 74 first "change" t 2e00: 6f 20 61 20 74 69 63 6b 65 74 20 69 73 20 77 68 o a ticket is wh 2e10: 61 74 20 62 72 69 6e 67 73 20 74 68 65 0a 74 69 at brings the.ti 2e20: 63 6b 65 74 20 69 6e 74 6f 20 65 78 69 73 74 61 cket into exista 2e30: 6e 63 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 0a 4a 20 nce.</p>..<p>.J 2e40: 63 61 72 64 73 20 73 70 65 63 69 66 79 20 63 68 cards specify ch 2e50: 61 6e 67 65 73 20 74 6f 20 22 66 69 65 6c 64 73 anges to "fields 2e60: 22 20 6f 66 20 74 68 65 20 74 69 63 6b 65 74 2e " of the ticket. 2e70: 20 20 45 61 63 68 20 66 6f 73 73 69 6c 0a 73 65 Each fossil.se 2e80: 72 76 65 72 20 68 61 73 20 61 20 74 69 63 6b 65 rver has a ticke 2e90: 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 t configuration 2ea0: 77 68 69 63 68 20 73 70 65 63 69 66 69 65 73 20 which specifies 2eb0: 74 68 65 20 66 69 65 6c 64 73 20 69 74 73 0a 75 the fields its.u 2ec0: 6e 64 65 72 73 74 61 6e 64 73 2e 20 20 54 68 69 nderstands. Thi 2ed0: 73 20 69 73 20 6e 6f 74 20 61 20 6c 69 6d 69 74 s is not a limit 2ee0: 20 6f 6e 20 74 68 65 20 66 69 65 6c 64 73 20 74 on the fields t 2ef0: 68 61 74 20 63 61 6e 20 61 70 70 65 61 72 0a 6f hat can appear.o 2f00: 6e 20 74 68 65 20 4a 20 63 61 72 64 73 2c 20 68 n the J cards, h 2f10: 6f 77 65 76 65 72 2e 20 20 49 66 20 61 20 4a 20 owever. If a J 2f20: 63 61 72 64 20 73 70 65 63 69 66 69 65 73 20 61 card specifies a 2f30: 20 66 69 65 6c 64 20 74 68 61 74 20 61 0a 70 61 field that a.pa 2f40: 72 74 69 63 75 6c 61 72 20 66 6f 73 73 69 6c 20 rticular fossil 2f50: 73 65 72 76 65 72 20 64 6f 65 73 20 6e 6f 74 20 server does not 2f60: 72 65 63 6f 67 6e 69 7a 65 2c 20 74 68 65 6e 20 recognize, then 2f70: 74 68 61 74 20 4a 20 63 61 72 64 0a 69 73 20 73 that J card.is s 2f80: 69 6d 70 6c 79 20 69 67 6e 6f 72 65 64 2e 3c 2f imply ignored.</ 2f90: 70 3e 0a 0a 3c 70 3e 0a 54 68 65 20 66 69 72 73 p>..<p>.The firs 2fa0: 74 20 61 72 67 75 6d 65 6e 74 20 6f 66 20 74 68 t argument of th 2fb0: 65 20 4a 20 63 61 72 64 20 69 73 20 74 68 65 20 e J card is the 2fc0: 66 69 65 6c 64 20 6e 61 6d 65 2e 20 20 54 68 65 field name. The 2fd0: 20 73 65 63 6f 6e 64 0a 76 61 6c 75 65 20 69 73 second.value is 2fe0: 20 74 68 65 20 66 69 65 6c 64 20 76 61 6c 75 65 the field value 2ff0: 2e 20 20 49 66 20 74 68 65 20 66 69 65 6c 64 20 . If the field 3000: 6e 61 6d 65 20 62 65 67 69 6e 73 20 77 69 74 68 name begins with 3010: 20 22 2b 22 20 74 68 65 6e 0a 74 68 65 20 76 61 "+" then.the va 3020: 6c 75 65 20 69 73 20 61 70 70 65 6e 64 65 64 20 lue is appended 3030: 74 6f 20 74 68 65 20 70 72 69 6f 72 20 76 61 6c to the prior val 3040: 75 65 2e 20 20 4f 74 68 65 72 77 69 73 65 2c 20 ue. Otherwise, 3050: 74 68 65 20 76 61 6c 75 65 0a 6f 6e 20 74 68 65 the value.on the 3060: 20 4a 20 63 61 72 64 20 72 65 70 6c 61 63 65 73 J card replaces 3070: 20 61 6e 79 20 70 72 65 76 69 6f 75 73 20 76 61 any previous va 3080: 6c 75 65 20 6f 66 20 74 68 65 20 66 69 65 6c 64 lue of the field 3090: 2e 0a 54 68 65 20 66 69 65 6c 64 20 6e 61 6d 65 ..The field name 30a0: 20 61 6e 64 20 76 61 6c 75 65 20 61 72 65 20 62 and value are b 30b0: 6f 74 68 20 65 6e 63 6f 64 65 64 20 75 73 69 6e oth encoded usin 30c0: 67 20 74 68 65 20 63 68 61 72 61 63 74 65 72 0a g the character. 30d0: 65 73 63 61 70 65 73 20 64 65 66 69 6e 65 64 20 escapes defined 30e0: 66 6f 72 20 74 68 65 20 43 20 63 61 72 64 20 6f for the C card o 30f0: 66 20 61 20 6d 61 6e 69 66 65 73 74 2e 0a 3c 2f f a manifest..</ 3100: 70 3e 0a p>.