Artifact 062a9acd52bbd4fe9a6ae3ab5d56ab943f54ca98:
File www/bugtheory.wiki part of check-in [904ee40b93] - Change "baseline" to "check-in" in the on-line documentation. by drh on 2009-01-23 00:16:26.
0000: 3c 68 31 3e 42 75 67 2d 54 72 61 63 6b 69 6e 67 <h1>Bug-Tracking 0010: 20 49 6e 20 3c 61 20 68 72 65 66 3d 22 69 6e 64 In <a href="ind 0020: 65 78 2e 77 69 6b 69 22 3e 46 6f 73 73 69 6c 3c ex.wiki">Fossil< 0030: 2f 61 3e 3c 2f 68 31 3e 0a 0a 41 20 62 75 67 2d /a></h1>..A bug- 0040: 72 65 70 6f 72 74 20 69 6e 20 66 6f 73 73 69 6c report in fossil 0050: 20 69 73 20 63 61 6c 6c 65 64 20 61 20 22 74 69 is called a "ti 0060: 63 6b 65 74 22 2e 20 20 54 69 63 6b 65 74 73 20 cket". Tickets 0070: 61 72 65 20 74 72 61 63 6b 65 64 0a 73 65 70 61 are tracked.sepa 0080: 72 61 74 65 6c 79 20 66 72 6f 6d 20 63 6f 64 65 rately from code 0090: 20 63 68 65 63 6b 2d 69 6e 73 2e 0a 0a 53 6f 6d check-ins...Som 00a0: 65 20 6f 74 68 65 72 20 64 69 73 74 72 69 62 75 e other distribu 00b0: 74 65 64 20 62 75 67 2d 74 72 61 63 6b 69 6e 67 ted bug-tracking 00c0: 20 73 79 73 74 65 6d 73 20 73 74 6f 72 65 20 74 systems store t 00d0: 69 63 6b 65 74 73 20 61 73 20 66 69 6c 65 73 20 ickets as files 00e0: 77 69 74 68 69 6e 0a 74 68 65 20 73 6f 75 72 63 within.the sourc 00f0: 65 20 74 72 65 65 20 61 6e 64 20 74 68 65 72 65 e tree and there 0100: 62 79 20 6c 65 76 65 72 61 67 65 20 74 68 65 20 by leverage the 0110: 73 79 6e 63 69 6e 67 20 61 6e 64 20 6d 65 72 67 syncing and merg 0120: 69 6e 67 20 63 61 70 61 62 69 6c 69 74 69 65 73 ing capabilities 0130: 0a 6f 66 20 74 68 65 20 76 65 72 73 69 6f 6e 69 .of the versioni 0140: 6e 67 20 73 79 73 74 65 6d 20 74 6f 20 73 79 6e ng system to syn 0150: 63 20 61 6e 64 20 6d 65 72 67 65 20 74 69 63 6b c and merge tick 0160: 65 74 73 2e 20 20 54 68 69 73 20 61 70 70 72 6f ets. This appro 0170: 61 63 68 20 69 73 0a 72 65 6a 65 63 74 65 64 20 ach is.rejected 0180: 69 6e 20 66 6f 73 73 69 6c 20 66 6f 72 20 74 68 in fossil for th 0190: 72 65 65 20 72 65 61 73 6f 6e 73 3a 0a 0a 20 20 ree reasons:.. 01a0: 31 2e 20 20 43 68 65 63 6b 2d 69 6e 73 20 69 6e 1. Check-ins in 01b0: 20 66 6f 73 73 69 6c 20 61 72 65 20 69 6d 6d 75 fossil are immu 01c0: 74 61 62 6c 65 2e 20 20 53 6f 20 69 66 0a 20 20 table. So if. 01d0: 20 20 20 20 74 69 63 6b 65 74 73 20 77 65 72 65 tickets were 01e0: 20 70 61 72 74 20 6f 66 20 74 68 65 20 63 68 65 part of the che 01f0: 63 6b 2d 69 6e 2c 20 74 68 65 6e 20 74 68 65 72 ck-in, then ther 0200: 65 20 77 6f 75 6c 64 20 62 65 20 6e 6f 20 77 61 e would be no wa 0210: 79 20 74 6f 20 61 64 64 0a 20 20 20 20 20 20 6e y to add. n 0220: 65 77 20 74 69 63 6b 65 74 73 20 74 6f 20 61 20 ew tickets to a 0230: 63 68 65 63 6b 2d 69 6e 20 61 73 20 6e 65 77 20 check-in as new 0240: 62 75 67 73 20 61 72 65 20 64 69 73 63 6f 76 65 bugs are discove 0250: 72 65 64 2e 0a 0a 20 20 32 2e 20 20 41 6e 79 20 red... 2. Any 0260: 70 72 6f 6a 65 63 74 20 6f 66 20 72 65 61 73 6f project of reaso 0270: 6e 61 62 6c 65 20 73 69 7a 65 20 61 6e 64 20 63 nable size and c 0280: 6f 6d 70 6c 65 78 69 74 79 20 77 69 6c 6c 20 67 omplexity will g 0290: 65 6e 65 72 61 74 65 20 74 68 6f 75 73 61 6e 64 enerate thousand 02a0: 73 0a 20 20 20 20 20 20 61 6e 64 20 74 68 6f 75 s. and thou 02b0: 73 61 6e 64 73 20 6f 66 20 74 69 63 6b 65 74 73 sands of tickets 02c0: 2c 20 61 6e 64 20 77 65 20 64 6f 20 6e 6f 74 20 , and we do not 02d0: 77 61 6e 74 20 61 6c 6c 20 74 68 6f 73 65 20 74 want all those t 02e0: 69 63 6b 65 74 20 66 69 6c 65 73 0a 20 20 20 20 icket files. 02f0: 20 20 63 6c 75 74 74 65 72 69 6e 67 20 74 68 65 cluttering the 0300: 20 73 6f 75 72 63 65 20 74 72 65 65 2e 0a 0a 20 source tree... 0310: 20 33 2e 20 20 57 65 20 77 61 6e 74 20 74 69 63 3. We want tic 0320: 6b 65 74 73 20 74 6f 20 62 65 20 6d 61 6e 61 67 kets to be manag 0330: 65 64 20 66 72 6f 6d 20 74 68 65 20 77 65 62 20 ed from the web 0340: 69 6e 74 65 72 66 61 63 65 20 61 6e 64 20 74 6f interface and to 0350: 20 68 61 76 65 20 61 0a 20 20 20 20 20 20 70 65 have a. pe 0360: 72 6d 69 73 73 69 6f 6e 20 73 79 73 74 65 6d 20 rmission system 0370: 74 68 61 74 20 69 73 20 64 69 73 74 69 6e 63 74 that is distinct 0380: 20 66 72 6f 6d 20 63 68 65 63 6b 2d 69 6e 20 70 from check-in p 0390: 65 72 6d 69 73 73 69 6f 6e 73 2e 0a 20 20 20 20 ermissions.. 03a0: 20 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 In other words 03b0: 2c 20 77 65 20 64 6f 20 6e 6f 74 20 77 61 6e 74 , we do not want 03c0: 20 74 6f 20 72 65 73 74 72 69 63 74 20 74 68 65 to restrict the 03d0: 20 63 72 65 61 74 69 6f 6e 20 61 6e 64 20 65 64 creation and ed 03e0: 69 74 69 6e 67 0a 20 20 20 20 20 20 6f 66 20 74 iting. of t 03f0: 69 63 6b 65 74 73 20 74 6f 20 64 65 76 65 6c 6f ickets to develo 0400: 70 65 72 73 20 77 69 74 68 20 63 68 65 63 6b 2d pers with check- 0410: 69 6e 20 70 72 69 76 69 6c 65 67 65 73 20 61 6e in privileges an 0420: 64 20 61 6e 20 69 6e 73 74 61 6c 6c 65 64 0a 20 d an installed. 0430: 20 20 20 20 20 63 6f 70 79 20 6f 66 20 74 68 65 copy of the 0440: 20 66 6f 73 73 69 6c 20 65 78 65 63 75 74 61 62 fossil executab 0450: 6c 65 2e 20 20 43 61 73 75 61 6c 20 70 61 73 73 le. Casual pass 0460: 65 72 73 2d 62 79 20 6f 6e 20 74 68 65 20 69 6e ers-by on the in 0470: 74 65 72 6e 65 74 20 73 68 6f 75 6c 64 0a 20 20 ternet should. 0480: 20 20 20 20 62 65 20 70 65 72 6d 69 74 74 65 64 be permitted 0490: 20 74 6f 20 63 72 65 61 74 65 20 74 69 63 6b 65 to create ticke 04a0: 74 73 2e 0a 0a 52 65 63 61 6c 6c 20 74 68 61 74 ts...Recall that 04b0: 20 61 20 66 6f 73 73 69 6c 20 72 65 70 6f 73 69 a fossil reposi 04c0: 74 6f 72 79 20 63 6f 6e 73 69 73 74 73 20 6f 66 tory consists of 04d0: 20 61 6e 0a 75 6e 6f 72 64 65 72 65 64 20 63 6f an.unordered co 04e0: 6c 6c 65 63 74 69 6f 6e 20 6f 66 20 3c 69 3e 61 llection of <i>a 04f0: 72 74 69 66 61 63 74 73 3c 2f 69 3e 2e 20 20 28 rtifacts</i>. ( 0500: 53 65 65 20 74 68 65 0a 3c 61 20 68 72 65 66 3d See the.<a href= 0510: 22 66 69 6c 65 66 6f 72 6d 61 74 2e 77 69 6b 69 "fileformat.wiki 0520: 22 3e 66 69 6c 65 20 66 6f 72 6d 61 74 20 64 6f ">file format do 0530: 63 75 6d 65 6e 74 3c 2f 61 3e 20 66 6f 72 20 64 cument</a> for d 0540: 65 74 61 69 6c 73 2e 29 0a 53 6f 6d 65 20 61 72 etails.).Some ar 0550: 74 69 66 61 63 74 73 20 68 61 76 65 20 61 20 73 tifacts have a s 0560: 70 65 63 69 61 6c 20 66 6f 72 6d 61 74 2c 20 61 pecial format, a 0570: 6e 64 20 61 6d 6f 6e 67 20 74 68 6f 73 65 20 61 nd among those a 0580: 72 65 0a 3c 61 20 68 72 65 66 3d 22 66 69 6c 65 re.<a href="file 0590: 66 6f 72 6d 61 74 2e 77 69 6b 69 23 74 6b 74 63 format.wiki#tktc 05a0: 68 6e 67 22 3e 54 69 63 6b 65 74 20 43 68 61 6e hng">Ticket Chan 05b0: 67 65 20 41 72 74 69 66 61 63 74 73 3c 2f 61 3e ge Artifacts</a> 05c0: 2e 0a 4f 6e 65 20 6f 72 20 6d 6f 72 65 20 74 69 ..One or more ti 05d0: 63 6b 65 74 20 63 68 61 6e 67 65 20 61 72 74 69 cket change arti 05e0: 66 61 63 74 73 20 61 72 65 20 61 73 73 6f 63 69 facts are associ 05f0: 61 74 65 64 20 77 69 74 68 20 65 61 63 68 20 0a ated with each . 0600: 74 69 63 6b 65 74 2e 20 20 41 20 74 69 63 6b 65 ticket. A ticke 0610: 74 20 69 73 20 63 72 65 61 74 65 64 20 62 79 20 t is created by 0620: 61 20 74 69 63 6b 65 74 20 63 68 61 6e 67 65 20 a ticket change 0630: 61 72 74 69 66 61 63 74 2e 0a 45 61 63 68 20 73 artifact..Each s 0640: 75 62 73 65 71 75 65 6e 74 20 6d 6f 64 69 66 69 ubsequent modifi 0650: 63 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 74 69 cation of the ti 0660: 63 6b 65 74 20 69 73 20 61 20 73 65 70 61 72 61 cket is a separa 0670: 74 65 20 61 72 74 69 66 61 63 74 2e 0a 0a 54 68 te artifact...Th 0680: 65 20 22 70 75 73 68 22 2c 20 22 70 75 6c 6c 22 e "push", "pull" 0690: 2c 20 61 6e 64 20 22 73 79 6e 63 22 20 61 6c 67 , and "sync" alg 06a0: 6f 72 69 74 68 6d 73 20 73 68 61 72 65 20 74 69 orithms share ti 06b0: 63 6b 65 74 20 63 68 61 6e 67 65 20 61 72 74 69 cket change arti 06c0: 66 61 63 74 73 0a 62 65 74 77 65 65 6e 20 72 65 facts.between re 06d0: 70 6f 73 69 74 6f 72 69 65 73 20 69 6e 20 74 68 positories in th 06e0: 65 20 73 61 6d 65 20 77 61 79 20 61 73 20 65 76 e same way as ev 06f0: 65 72 79 20 6f 74 68 65 72 20 61 72 74 69 66 61 ery other artifa 0700: 63 74 2e 20 20 49 6e 20 66 61 63 74 2c 0a 74 68 ct. In fact,.th 0710: 65 20 73 79 6e 63 20 61 6c 67 6f 72 69 74 68 6d e sync algorithm 0720: 20 68 61 73 20 6e 6f 20 6b 6e 6f 77 6c 65 64 67 has no knowledg 0730: 65 20 6f 66 20 74 68 65 20 6d 65 61 6e 69 6e 67 e of the meaning 0740: 20 6f 66 20 74 68 65 20 61 72 74 69 66 61 63 74 of the artifact 0750: 73 20 69 74 0a 69 73 20 73 79 6e 63 69 6e 67 2e s it.is syncing. 0760: 20 20 41 73 20 66 61 72 20 61 73 20 74 68 65 20 As far as the 0770: 73 79 6e 63 20 61 6c 67 6f 72 69 74 68 6d 20 69 sync algorithm i 0780: 73 20 63 6f 6e 63 65 72 6e 65 64 2c 20 61 6c 6c s concerned, all 0790: 20 61 72 74 69 66 61 63 74 73 20 61 72 65 0a 61 artifacts are.a 07a0: 6c 69 6b 65 2e 20 20 41 66 74 65 72 20 74 68 65 like. After the 07b0: 20 73 79 6e 63 20 68 61 73 20 6f 63 63 75 72 73 sync has occurs 07c0: 2c 20 74 68 65 20 69 6e 64 69 76 69 64 75 61 6c , the individual 07d0: 20 72 65 70 6f 73 69 74 6f 72 69 65 73 20 6d 75 repositories mu 07e0: 73 74 0a 6d 61 6b 65 20 73 65 6e 73 65 20 6f 66 st.make sense of 07f0: 20 74 68 65 20 6d 65 61 6e 69 6e 67 20 6f 66 20 the meaning of 0800: 74 68 65 20 76 61 72 69 6f 75 73 20 61 72 74 69 the various arti 0810: 66 61 63 74 73 20 66 6f 72 20 74 68 65 6d 73 65 facts for themse 0820: 6c 76 65 73 2e 0a 0a 3c 68 32 3e 49 6e 74 65 72 lves...<h2>Inter 0830: 70 72 65 74 61 74 69 6f 6e 20 4f 66 20 54 69 63 pretation Of Tic 0840: 6b 65 74 20 43 68 61 6e 67 65 20 41 72 74 69 66 ket Change Artif 0850: 61 63 74 73 3c 2f 68 32 3e 0a 0a 45 76 65 72 79 acts</h2>..Every 0860: 20 74 69 63 6b 65 74 20 63 68 61 6e 67 65 20 61 ticket change a 0870: 72 74 69 66 61 63 74 20 63 6f 6e 74 61 69 6e 73 rtifact contains 0880: 20 28 61 6d 6f 6e 67 20 6f 74 68 65 72 20 74 68 (among other th 0890: 69 6e 67 73 29 0a 0a 20 20 2a 20 20 61 20 74 69 ings).. * a ti 08a0: 6d 65 73 74 61 6d 70 2c 0a 20 20 2a 20 20 61 20 mestamp,. * a 08b0: 74 69 63 6b 65 74 20 49 44 2c 20 61 6e 64 0a 20 ticket ID, and. 08c0: 20 2a 20 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 * one or more 08d0: 6e 61 6d 65 2f 76 61 6c 75 65 20 70 61 69 72 73 name/value pairs 08e0: 2e 0a 0a 54 68 65 20 63 75 72 72 65 6e 74 20 73 ...The current s 08f0: 74 61 74 65 20 6f 66 20 61 20 74 69 63 6b 65 74 tate of a ticket 0900: 20 69 73 20 66 6f 75 6e 64 20 62 79 20 72 65 70 is found by rep 0910: 6c 61 79 69 6e 67 20 61 6c 6c 20 74 69 63 6b 65 laying all ticke 0920: 74 0a 63 68 61 6e 67 65 20 61 72 74 69 66 61 63 t.change artifac 0930: 74 73 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 ts with the same 0940: 20 74 69 63 6b 65 74 20 49 44 20 69 6e 20 74 69 ticket ID in ti 0950: 6d 65 73 74 61 6d 70 20 6f 72 64 65 72 2e 0a 46 mestamp order..F 0960: 6f 72 20 61 20 67 69 76 65 6e 20 74 69 63 6b 65 or a given ticke 0970: 74 2c 20 61 6c 6c 20 76 61 6c 75 65 73 20 61 72 t, all values ar 0980: 65 20 69 6e 69 74 69 61 6c 6c 79 20 4e 55 4c 4c e initially NULL 0990: 2e 20 20 41 73 20 65 61 63 68 0a 74 69 63 6b 65 . As each.ticke 09a0: 74 20 63 68 61 6e 67 65 20 61 72 74 69 66 61 63 t change artifac 09b0: 74 20 69 73 20 65 6e 63 6f 75 6e 74 65 72 65 64 t is encountered 09c0: 2c 20 76 61 6c 75 65 73 20 61 72 65 20 65 69 74 , values are eit 09d0: 68 65 72 20 72 65 70 6c 61 63 65 64 0a 6f 72 20 her replaced.or 09e0: 61 70 70 65 6e 64 65 64 2c 20 61 63 63 6f 72 64 appended, accord 09f0: 69 6e 67 20 74 6f 20 61 20 66 6c 61 67 20 6f 6e ing to a flag on 0a00: 20 74 68 65 20 6e 61 6d 65 2f 76 61 6c 75 65 20 the name/value 0a10: 70 61 69 72 2e 20 20 54 68 65 20 63 75 72 72 65 pair. The curre 0a20: 6e 74 0a 76 61 6c 75 65 73 20 66 6f 72 20 74 68 nt.values for th 0a30: 65 20 66 69 65 6c 64 73 20 6f 66 20 61 20 74 69 e fields of a ti 0a40: 63 6b 65 74 20 61 72 65 20 74 68 65 20 76 61 6c cket are the val 0a50: 75 65 73 20 74 68 61 74 20 72 65 6d 61 69 6e 20 ues that remain 0a60: 61 74 20 74 68 65 0a 65 6e 64 20 6f 66 20 74 68 at the.end of th 0a70: 65 20 72 65 70 6c 61 79 20 70 72 6f 63 65 73 73 e replay process 0a80: 2e 0a 0a 54 6f 20 63 72 65 61 74 65 20 61 20 6e ...To create a n 0a90: 65 77 20 74 69 63 6b 65 74 2c 20 6f 6e 65 20 69 ew ticket, one i 0aa0: 6e 73 65 72 74 73 20 61 20 74 69 63 6b 65 74 20 nserts a ticket 0ab0: 63 68 61 6e 67 65 0a 61 72 74 69 66 61 63 74 20 change.artifact 0ac0: 77 69 74 68 20 61 20 6e 65 77 20 49 44 2e 20 20 with a new ID. 0ad0: 54 68 65 20 74 69 63 6b 65 74 20 49 44 0a 69 73 The ticket ID.is 0ae0: 20 61 20 72 61 6e 64 6f 6d 20 34 30 2d 63 68 61 a random 40-cha 0af0: 72 61 63 74 65 72 20 6c 6f 77 65 72 2d 63 61 73 racter lower-cas 0b00: 65 20 68 65 78 61 64 65 63 69 6d 61 6c 20 6e 75 e hexadecimal nu 0b10: 6d 62 65 72 2e 20 20 54 68 65 20 22 74 6b 74 6e mber. The "tktn 0b20: 65 77 22 0a 70 61 67 65 20 69 6e 20 74 68 65 20 ew".page in the 0b30: 66 6f 73 73 69 6c 20 77 65 62 20 69 6e 74 65 72 fossil web inter 0b40: 66 61 63 65 20 63 72 65 61 74 65 73 20 6e 65 77 face creates new 0b50: 20 74 69 63 6b 65 74 20 49 44 73 0a 75 73 69 6e ticket IDs.usin 0b60: 67 20 61 20 67 6f 6f 64 20 73 6f 75 72 63 65 20 g a good source 0b70: 6f 66 20 72 61 6e 64 6f 6d 6e 65 73 73 20 74 6f of randomness to 0b80: 20 69 6e 73 75 72 65 20 75 6e 69 71 75 65 6e 65 insure uniquene 0b90: 73 73 2e 0a 54 68 65 20 6e 61 6d 65 2f 76 61 6c ss..The name/val 0ba0: 75 65 20 70 61 69 72 73 20 6f 6e 20 74 68 65 20 ue pairs on the 0bb0: 69 6e 69 74 69 61 6c 20 74 69 63 6b 65 74 20 63 initial ticket c 0bc0: 68 61 6e 67 65 0a 61 72 74 69 66 61 63 74 20 61 hange.artifact a 0bd0: 72 65 20 74 68 65 20 69 6e 69 74 69 61 6c 20 76 re the initial v 0be0: 61 6c 75 65 73 20 66 6f 72 20 74 68 65 20 66 69 alues for the fi 0bf0: 65 6c 64 73 20 69 6e 20 74 68 65 20 74 69 63 6b elds in the tick 0c00: 65 74 2e 0a 0a 41 6d 65 6e 64 69 6e 67 20 61 20 et...Amending a 0c10: 74 69 63 6b 65 74 20 6d 65 61 6e 73 20 73 69 6d ticket means sim 0c20: 70 6c 79 20 63 72 65 61 74 69 6e 67 20 61 20 6e ply creating a n 0c30: 65 77 20 61 72 74 69 66 61 63 74 20 77 69 74 68 ew artifact with 0c40: 20 74 68 65 0a 73 61 6d 65 20 74 69 63 6b 65 74 the.same ticket 0c50: 20 49 44 20 61 6e 64 20 77 69 74 68 20 6e 61 6d ID and with nam 0c60: 65 2f 76 61 6c 75 65 20 70 61 69 72 73 20 66 6f e/value pairs fo 0c70: 72 20 74 68 6f 73 65 20 66 69 65 6c 64 73 20 77 r those fields w 0c80: 68 69 63 68 0a 61 72 65 20 63 68 61 6e 67 69 6e hich.are changin 0c90: 67 2e 20 20 46 69 65 6c 64 73 20 6f 66 20 74 68 g. Fields of th 0ca0: 65 20 74 69 63 6b 65 74 20 77 68 69 63 68 20 61 e ticket which a 0cb0: 72 65 20 6e 6f 74 20 62 65 69 6e 67 20 6d 6f 64 re not being mod 0cc0: 69 66 69 65 64 0a 73 68 6f 75 6c 64 20 6e 6f 74 ified.should not 0cd0: 20 61 70 70 65 61 72 20 61 73 20 6e 61 6d 65 2f appear as name/ 0ce0: 76 61 6c 75 65 20 70 61 69 72 73 20 69 6e 20 74 value pairs in t 0cf0: 68 65 20 6e 65 77 20 61 72 74 69 66 61 63 74 2e he new artifact. 0d00: 0a 0a 54 68 69 73 20 61 70 70 72 6f 61 63 68 20 ..This approach 0d10: 74 6f 20 73 74 6f 72 69 6e 67 20 74 69 63 6b 65 to storing ticke 0d20: 74 20 73 74 61 74 65 20 6d 65 61 6e 73 20 74 68 t state means th 0d30: 61 74 20 69 6e 64 65 70 65 6e 64 65 6e 74 6c 79 at independently 0d40: 20 65 6e 74 65 72 65 64 0a 63 68 61 6e 67 65 73 entered.changes 0d50: 20 61 72 65 20 61 75 74 6f 6d 61 74 69 63 61 6c are automatical 0d60: 6c 79 20 6d 65 72 67 65 64 20 74 6f 67 65 74 68 ly merged togeth 0d70: 65 72 20 77 68 65 6e 20 61 72 74 69 66 61 63 74 er when artifact 0d80: 73 20 61 72 65 20 73 68 61 72 65 64 0a 62 65 74 s are shared.bet 0d90: 77 65 65 6e 20 72 65 70 6f 73 69 74 6f 72 69 65 ween repositorie 0da0: 73 2e 20 20 54 69 63 6b 65 74 73 20 64 6f 20 6e s. Tickets do n 0db0: 6f 74 20 62 72 61 6e 63 68 2e 20 20 54 68 69 73 ot branch. This 0dc0: 20 61 70 70 72 6f 61 63 68 20 61 6c 73 6f 20 6d approach also m 0dd0: 61 6b 65 73 0a 69 74 20 74 72 69 76 69 61 6c 20 akes.it trivial 0de0: 74 6f 20 74 72 61 63 6b 20 74 68 65 20 68 69 73 to track the his 0df0: 74 6f 72 69 63 20 70 72 6f 67 72 65 73 73 69 6f toric progressio 0e00: 6e 20 6f 66 20 63 68 61 6e 67 65 73 20 74 6f 20 n of changes to 0e10: 61 20 74 69 63 6b 65 74 2e 0a 0a 49 6e 20 6f 72 a ticket...In or 0e20: 64 65 72 20 66 6f 72 20 74 68 69 73 20 73 63 68 der for this sch 0e30: 65 6d 65 20 74 6f 20 77 6f 72 6b 2c 20 74 68 65 eme to work, the 0e40: 20 73 79 73 74 65 6d 20 63 6c 6f 63 6b 73 20 6f system clocks o 0e50: 6e 20 6d 61 63 68 69 6e 65 73 20 74 68 61 74 0a n machines that. 0e60: 61 64 64 20 6e 65 77 20 74 69 63 6b 65 74 20 63 add new ticket c 0e70: 68 61 6e 67 65 73 20 61 72 74 69 66 61 63 74 73 hanges artifacts 0e80: 20 68 61 76 65 20 74 6f 20 62 65 20 73 65 74 20 have to be set 0e90: 63 6c 6f 73 65 20 74 6f 20 72 65 61 6c 69 74 79 close to reality 0ea0: 2e 0a 49 74 20 69 73 20 4f 4b 20 66 6f 72 20 61 ..It is OK for a 0eb0: 20 74 69 63 6b 65 74 20 63 68 61 6e 67 65 20 61 ticket change a 0ec0: 72 74 69 66 61 63 74 20 74 69 6d 65 73 74 61 6d rtifact timestam 0ed0: 70 20 74 6f 20 62 65 20 6f 66 66 20 62 79 20 61 p to be off by a 0ee0: 20 66 65 77 0a 6d 69 6e 75 74 65 73 20 6f 72 20 few.minutes or 0ef0: 65 76 65 6e 20 61 20 66 65 77 20 68 6f 75 72 73 even a few hours 0f00: 2e 20 20 42 75 74 20 69 66 20 61 20 74 69 6d 65 . But if a time 0f10: 73 74 61 6d 70 20 6f 6e 20 61 20 74 69 63 6b 65 stamp on a ticke 0f20: 74 20 63 68 61 6e 67 65 0a 61 72 74 69 66 61 63 t change.artifac 0f30: 74 20 69 73 20 6f 66 66 20 62 79 20 6d 6f 6e 74 t is off by mont 0f40: 68 73 20 6f 72 20 79 65 61 72 73 2c 20 69 74 20 hs or years, it 0f50: 63 61 6e 20 73 65 72 69 6f 75 73 6c 79 20 63 6f can seriously co 0f60: 6e 66 75 73 65 20 74 68 65 0a 72 65 70 6c 61 79 nfuse the.replay 0f70: 20 61 6c 67 6f 72 69 74 68 6d 20 66 6f 72 20 64 algorithm for d 0f80: 65 74 65 72 6d 69 6e 69 6e 67 20 74 68 65 20 63 etermining the c 0f90: 75 72 72 65 6e 74 20 74 69 63 6b 65 74 20 73 74 urrent ticket st 0fa0: 61 74 65 2e 20 20 54 68 65 72 65 0a 61 72 65 20 ate. There.are 0fb0: 74 65 63 68 6e 69 71 75 65 73 20 61 76 61 69 6c techniques avail 0fc0: 61 62 6c 65 20 74 6f 20 63 61 75 73 65 20 72 6f able to cause ro 0fd0: 67 75 65 20 61 72 74 69 66 61 63 74 73 20 74 6f gue artifacts to 0fe0: 20 62 65 20 69 67 6e 6f 72 65 64 0a 62 79 20 66 be ignored.by f 0ff0: 6f 73 73 69 6c 2e 20 20 53 6f 20 69 66 20 61 20 ossil. So if a 1000: 74 69 63 6b 65 74 20 63 68 61 6e 67 65 20 61 72 ticket change ar 1010: 74 69 66 61 63 74 20 77 69 74 68 20 61 20 62 61 tifact with a ba 1020: 64 20 74 69 6d 65 73 74 61 6d 70 0a 64 6f 65 73 d timestamp.does 1030: 20 67 65 74 20 69 6e 74 6f 20 61 20 72 65 70 6f get into a repo 1040: 73 69 74 6f 72 79 2c 20 69 74 20 63 61 6e 20 62 sitory, it can b 1050: 65 20 72 65 6d 6f 76 65 64 20 62 79 20 61 6e 20 e removed by an 1060: 61 64 6d 69 6e 69 73 74 72 61 74 6f 72 2e 0a 42 administrator..B 1070: 75 74 20 74 68 65 20 62 65 73 74 20 61 70 70 72 ut the best appr 1080: 6f 61 63 68 20 69 73 20 74 6f 20 74 61 6b 65 20 oach is to take 1090: 73 74 65 70 73 20 74 6f 20 69 6e 73 75 72 65 20 steps to insure 10a0: 74 68 61 74 20 74 69 6d 65 73 74 61 6d 70 73 0a that timestamps. 10b0: 61 72 65 20 61 70 70 72 6f 78 69 6d 61 74 65 6c are approximatel 10c0: 79 20 63 6f 72 72 65 63 74 20 69 6e 20 74 68 65 y correct in the 10d0: 20 66 69 72 73 74 20 70 6c 61 63 65 2e 0a 0a 3c first place...< 10e0: 68 32 3e 4c 6f 63 61 6c 20 43 6f 6e 66 69 67 75 h2>Local Configu 10f0: 72 61 74 69 6f 6e 3c 2f 68 32 3e 0a 0a 54 68 65 ration</h2>..The 1100: 20 74 69 63 6b 65 74 20 63 68 61 6e 67 65 20 61 ticket change a 1110: 72 74 69 66 61 63 74 73 20 61 72 65 20 70 61 72 rtifacts are par 1120: 74 20 6f 66 20 74 68 65 20 67 6c 6f 62 61 6c 20 t of the global 1130: 73 74 61 74 65 20 66 6f 72 20 61 20 70 72 6f 6a state for a proj 1140: 65 63 74 2e 0a 54 68 65 20 67 6c 6f 62 61 6c 20 ect..The global 1150: 73 74 61 74 65 20 69 73 20 74 68 61 74 20 77 68 state is that wh 1160: 69 63 68 20 69 73 20 73 68 61 72 65 64 20 62 65 ich is shared be 1170: 74 77 65 65 6e 20 72 65 70 6f 73 69 74 6f 72 69 tween repositori 1180: 65 73 20 64 75 72 69 6e 67 0a 61 20 73 79 6e 63 es during.a sync 1190: 2e 20 20 45 61 63 68 20 72 65 70 6f 73 69 74 6f . Each reposito 11a0: 72 79 20 61 6c 73 6f 20 68 61 73 20 6c 6f 63 61 ry also has loca 11b0: 6c 20 73 74 61 74 65 20 77 68 69 63 68 20 69 73 l state which is 11c0: 20 6e 6f 74 20 28 6e 6f 72 6d 61 6c 6c 79 29 0a not (normally). 11d0: 73 68 61 72 65 64 2e 20 20 54 68 65 20 6e 61 6d shared. The nam 11e0: 65 2f 76 61 6c 75 65 20 70 61 69 72 73 20 66 6f e/value pairs fo 11f0: 72 20 61 20 74 69 63 6b 65 74 20 61 72 65 20 70 r a ticket are p 1200: 61 72 74 20 6f 66 20 67 6c 6f 62 61 6c 20 73 74 art of global st 1210: 61 74 65 2c 0a 62 75 74 20 74 68 65 20 69 6e 74 ate,.but the int 1220: 65 72 70 72 65 74 61 74 69 6f 6e 20 61 6e 64 20 erpretation and 1230: 64 69 73 70 6c 61 79 20 6f 66 20 74 68 61 74 20 display of that 1240: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 73 20 6c information is l 1250: 6f 63 61 6c 20 73 74 61 74 65 2e 0a 48 65 6e 63 ocal state..Henc 1260: 65 2c 20 65 61 63 68 20 72 65 70 6f 73 69 74 6f e, each reposito 1270: 72 79 20 69 73 20 66 72 65 65 20 74 6f 20 73 65 ry is free to se 1280: 74 20 75 70 20 69 74 73 20 6f 77 6e 20 74 69 63 t up its own tic 1290: 6b 65 74 20 64 69 73 70 6c 61 79 20 61 6e 64 0a ket display and. 12a0: 69 6e 70 75 74 20 66 6f 72 6d 61 74 73 20 61 6e input formats an 12b0: 64 20 72 65 70 6f 72 74 69 6e 67 20 72 75 6c 65 d reporting rule 12c0: 73 20 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 69 s according to i 12d0: 74 73 20 6f 77 6e 20 70 61 72 74 69 63 75 6c 61 ts own particula 12e0: 72 20 6e 65 65 64 73 2e 0a 0a 45 61 63 68 20 72 r needs...Each r 12f0: 65 70 6f 73 69 74 6f 72 79 20 64 65 66 69 6e 65 epository define 1300: 73 20 69 74 73 20 6f 77 6e 20 54 49 43 4b 45 54 s its own TICKET 1310: 20 74 61 62 6c 65 20 69 6e 20 69 74 73 20 64 61 table in its da 1320: 74 61 62 61 73 65 2e 20 20 54 68 65 72 65 20 69 tabase. There i 1330: 73 0a 6f 6e 65 20 72 6f 77 20 69 6e 20 74 68 65 s.one row in the 1340: 20 54 49 43 4b 45 54 20 74 61 62 6c 65 20 66 6f TICKET table fo 1350: 72 20 65 61 63 68 20 75 6e 69 71 75 65 20 74 69 r each unique ti 1360: 63 6b 65 74 20 49 44 2e 20 20 54 68 65 0a 6e 61 cket ID. The.na 1370: 6d 65 73 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 mes of columns i 1380: 6e 20 74 68 65 20 54 49 43 4b 45 54 20 74 61 62 n the TICKET tab 1390: 6c 65 20 63 6f 72 72 65 73 70 6f 6e 64 20 74 6f le correspond to 13a0: 20 74 68 65 20 6e 61 6d 65 73 20 69 6e 0a 74 68 the names in.th 13b0: 65 20 6e 61 6d 65 2f 76 61 6c 75 65 20 70 61 69 e name/value pai 13c0: 72 73 20 6f 66 20 74 69 63 6b 65 74 20 63 68 61 rs of ticket cha 13d0: 6e 67 65 20 61 72 74 69 66 61 63 74 73 2e 20 20 nge artifacts. 13e0: 57 68 65 6e 20 72 75 6e 6e 69 6e 67 20 74 68 65 When running the 13f0: 20 72 65 70 6c 61 79 0a 61 6c 67 6f 72 69 74 68 replay.algorith 1400: 6d 2c 20 69 66 20 61 20 6e 61 6d 65 2f 76 61 6c m, if a name/val 1410: 75 65 20 70 61 69 72 20 69 73 20 73 65 65 6e 20 ue pair is seen 1420: 77 68 69 63 68 20 68 61 73 20 6e 6f 20 63 6f 72 which has no cor 1430: 72 65 73 70 6f 6e 64 69 6e 67 20 63 6f 6c 75 6d responding colum 1440: 6e 0a 69 6e 20 74 68 65 20 54 49 43 4b 45 54 20 n.in the TICKET 1450: 74 61 62 6c 65 2c 20 74 68 65 6e 20 74 68 61 74 table, then that 1460: 20 6e 61 6d 65 2f 76 61 6c 75 65 20 70 61 69 72 name/value pair 1470: 20 69 73 20 69 67 6e 6f 72 65 64 2e 20 20 43 6f is ignored. Co 1480: 6c 75 6d 6e 73 20 63 61 6e 0a 62 65 20 61 64 64 lumns can.be add 1490: 65 64 20 6f 72 20 72 65 6d 6f 76 65 64 20 66 72 ed or removed fr 14a0: 6f 6d 20 74 68 65 20 54 49 43 4b 45 54 20 74 61 om the TICKET ta 14b0: 62 6c 65 20 61 74 20 61 6e 79 20 74 69 6d 65 2e ble at any time. 14c0: 20 20 57 68 65 6e 65 76 65 72 20 74 68 65 0a 54 Whenever the.T 14d0: 49 43 4b 45 54 20 74 61 62 6c 65 20 69 73 20 6d ICKET table is m 14e0: 6f 64 69 66 69 65 64 2c 20 74 68 65 20 72 65 70 odified, the rep 14f0: 6c 61 79 20 61 6c 67 6f 72 69 74 68 6d 20 61 75 lay algorithm au 1500: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 72 65 72 75 tomatically reru 1510: 6e 73 0a 74 6f 20 72 65 70 6f 70 75 6c 61 74 65 ns.to repopulate 1520: 20 74 68 65 20 74 61 62 6c 65 20 75 73 69 6e 67 the table using 1530: 20 74 68 65 20 6e 65 77 20 63 6f 6c 75 6d 6e 20 the new column 1540: 6e 61 6d 65 73 2e 20 20 4e 6f 74 65 20 74 68 61 names. Note tha 1550: 74 20 74 68 65 20 54 49 43 4b 45 54 0a 74 61 62 t the TICKET.tab 1560: 6c 65 20 73 63 68 65 6d 61 20 61 6e 64 20 63 6f le schema and co 1570: 6e 74 65 6e 74 20 69 73 20 70 61 72 74 20 6f 66 ntent is part of 1580: 20 74 68 65 20 6c 6f 63 61 6c 20 73 74 61 74 65 the local state 1590: 20 6f 66 20 61 20 72 65 70 6f 73 69 74 6f 72 79 of a repository 15a0: 0a 61 6e 64 20 69 73 20 6e 6f 74 20 73 68 61 72 .and is not shar 15b0: 65 64 20 77 69 74 68 20 6f 74 68 65 72 20 72 65 ed with other re 15c0: 70 6f 73 69 74 6f 72 69 65 73 20 64 75 72 69 6e positories durin 15d0: 67 20 61 20 73 79 6e 63 2c 20 70 75 73 68 2c 20 g a sync, push, 15e0: 6f 72 20 70 75 6c 6c 2e 0a 0a 45 61 63 68 20 72 or pull...Each r 15f0: 65 70 6f 73 69 74 6f 72 79 20 61 6c 73 6f 20 64 epository also d 1600: 65 66 69 6e 65 73 20 73 63 72 69 70 74 73 20 75 efines scripts u 1610: 73 65 64 20 74 6f 20 67 65 6e 65 72 61 74 65 20 sed to generate 1620: 77 65 62 20 70 61 67 65 73 20 66 6f 72 0a 63 72 web pages for.cr 1630: 65 61 74 69 6e 67 20 6e 65 77 20 74 69 63 6b 65 eating new ticke 1640: 74 73 2c 20 76 69 65 77 69 6e 67 20 65 78 69 73 ts, viewing exis 1650: 74 69 6e 67 20 74 69 63 6b 65 74 73 2c 20 61 6e ting tickets, an 1660: 64 20 6d 6f 64 69 66 79 69 6e 67 20 61 6e 0a 65 d modifying an.e 1670: 78 69 73 74 69 6e 67 20 74 69 63 6b 65 74 2e 20 xisting ticket. 1680: 20 54 68 65 73 65 20 73 63 72 69 70 74 73 20 63 These scripts c 1690: 6f 6e 73 69 73 74 20 6f 66 20 48 54 4d 4c 20 77 onsist of HTML w 16a0: 69 74 68 20 61 6e 20 65 6d 62 65 64 64 65 64 0a ith an embedded. 16b0: 73 63 72 69 70 74 73 20 77 72 69 74 74 65 6e 20 scripts written 16c0: 61 6e 20 61 20 54 63 6c 2d 6c 69 6b 65 20 6c 61 an a Tcl-like la 16d0: 6e 67 75 61 67 65 20 63 61 6c 6c 65 64 20 22 54 nguage called "T 16e0: 48 31 22 2e 20 20 45 76 65 72 79 20 6e 65 77 20 H1". Every new 16f0: 66 6f 73 73 69 6c 0a 72 65 70 6f 73 69 74 6f 72 fossil.repositor 1700: 79 20 69 73 20 63 72 65 61 74 65 64 20 77 69 74 y is created wit 1710: 68 20 64 65 66 61 75 6c 74 20 73 63 72 69 70 74 h default script 1720: 73 2e 20 20 54 68 65 72 65 20 69 73 20 63 75 72 s. There is cur 1730: 72 65 6e 74 6c 79 20 6e 6f 0a 64 6f 63 75 6d 65 rently no.docume 1740: 6e 74 61 74 69 6f 6e 20 6f 6e 20 74 68 65 20 54 ntation on the T 1750: 48 31 20 6c 61 6e 67 75 61 67 65 2e 20 20 41 64 H1 language. Ad 1760: 6d 69 6e 69 73 74 72 61 74 6f 72 73 20 77 69 73 ministrators wis 1770: 68 69 6e 67 20 74 6f 0a 63 75 73 74 6f 6d 69 7a hing to.customiz 1780: 65 20 74 68 65 69 72 20 74 69 63 6b 65 74 20 65 e their ticket e 1790: 6e 74 72 79 2c 20 76 69 65 77 69 6e 67 2c 20 61 ntry, viewing, a 17a0: 6e 64 20 65 64 69 74 69 6e 67 20 73 63 72 65 65 nd editing scree 17b0: 6e 73 20 73 68 6f 75 6c 64 0a 6d 6f 64 69 66 79 ns should.modify 17c0: 20 74 68 65 20 64 65 66 61 75 6c 74 20 73 63 72 the default scr 17d0: 69 70 74 73 20 74 6f 20 73 75 69 74 20 74 68 65 ipts to suit the 17e0: 69 72 20 6e 65 65 64 73 2e 20 20 54 68 65 73 65 ir needs. These 17f0: 20 73 63 72 65 65 6e 20 67 65 6e 65 72 61 74 6f screen generato 1800: 72 0a 73 63 72 69 70 74 73 20 61 72 65 20 70 61 r.scripts are pa 1810: 72 74 20 6f 66 20 74 68 65 20 6c 6f 63 61 6c 20 rt of the local 1820: 73 74 61 74 65 20 6f 66 20 61 20 72 65 70 6f 73 state of a repos 1830: 69 74 6f 72 79 20 61 6e 64 20 61 72 65 20 6e 6f itory and are no 1840: 74 20 73 68 61 72 65 64 0a 77 69 74 68 20 6f 74 t shared.with ot 1850: 68 65 72 20 72 65 70 6f 73 69 74 6f 72 69 65 73 her repositories 1860: 20 64 75 72 69 6e 67 20 61 20 73 79 6e 63 2c 20 during a sync, 1870: 70 75 73 68 2c 20 6f 72 20 70 75 6c 6c 2e 0a 0a push, or pull... 1880: 3c 69 3e 54 6f 20 62 65 20 63 6f 6e 74 69 6e 75 <i>To be continu 1890: 65 64 2e 2e 2e 3c 2f 69 3e 0a ed...</i>.