Artifact fa1904916942cb9dbb0c720acf62ebe087db7300:
File www/bugtheory.wiki part of check-in [9d10726d48] - Documentation updates. by drh on 2008-07-29 13:07:17.
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 20 28 62 61 73 65 check-ins (base 00a0: 6c 69 6e 65 73 29 2e 0a 0a 53 6f 6d 65 20 6f 74 lines)...Some ot 00b0: 68 65 72 20 64 69 73 74 72 69 62 75 74 65 64 20 her distributed 00c0: 62 75 67 2d 74 72 61 63 6b 69 6e 67 20 73 79 73 bug-tracking sys 00d0: 74 65 6d 73 20 73 74 6f 72 65 20 74 69 63 6b 65 tems store ticke 00e0: 74 73 20 61 73 20 66 69 6c 65 73 20 77 69 74 68 ts as files with 00f0: 69 6e 0a 74 68 65 20 73 6f 75 72 63 65 20 74 72 in.the source tr 0100: 65 65 20 61 6e 64 20 74 68 65 72 65 62 79 20 6c ee and thereby l 0110: 65 76 65 72 61 67 65 20 74 68 65 20 73 79 6e 63 everage the sync 0120: 69 6e 67 20 61 6e 64 20 6d 65 72 67 69 6e 67 20 ing and merging 0130: 63 61 70 61 62 69 6c 69 74 69 65 73 0a 6f 66 20 capabilities.of 0140: 74 68 65 20 76 65 72 73 69 6f 6e 69 6e 67 20 73 the versioning s 0150: 79 73 74 65 6d 20 74 6f 20 73 79 6e 63 20 61 6e ystem to sync an 0160: 64 20 6d 65 72 67 65 20 74 69 63 6b 65 74 73 2e d merge tickets. 0170: 20 20 54 68 69 73 20 61 70 70 72 6f 61 63 68 20 This approach 0180: 69 73 0a 72 65 6a 65 63 74 65 64 20 69 6e 20 66 is.rejected in f 0190: 6f 73 73 69 6c 20 66 6f 72 20 74 68 72 65 65 20 ossil for three 01a0: 72 65 61 73 6f 6e 73 3a 0a 0a 20 20 31 2e 20 20 reasons:.. 1. 01b0: 43 68 65 63 6b 2d 69 6e 73 20 28 61 2e 6b 2e 61 Check-ins (a.k.a 01c0: 2e 20 22 62 61 73 65 6c 69 6e 65 73 22 29 20 69 . "baselines") i 01d0: 6e 20 66 6f 73 73 69 6c 20 61 72 65 20 69 6d 6d n fossil are imm 01e0: 75 74 61 62 6c 65 2e 20 20 53 6f 20 69 66 0a 20 utable. So if. 01f0: 20 20 20 20 20 74 69 63 6b 65 74 73 20 77 65 72 tickets wer 0200: 65 20 70 61 72 74 20 6f 66 20 74 68 65 20 63 68 e part of the ch 0210: 65 63 6b 2d 69 6e 2c 20 74 68 65 6e 20 74 68 65 eck-in, then the 0220: 72 65 20 77 6f 75 6c 64 20 6e 6f 20 77 61 79 20 re would no way 0230: 74 6f 20 61 64 64 0a 20 20 20 20 20 20 6e 65 77 to add. new 0240: 20 74 69 63 6b 65 74 73 20 74 6f 20 61 20 63 68 tickets to a ch 0250: 65 63 6b 2d 69 6e 20 61 73 20 6e 65 77 20 62 75 eck-in as new bu 0260: 67 73 20 61 72 65 20 64 69 73 63 6f 76 65 72 65 gs are discovere 0270: 64 2e 0a 0a 20 20 32 2e 20 20 41 6e 79 20 70 72 d... 2. Any pr 0280: 6f 6a 65 63 74 20 6f 66 20 72 65 61 73 6f 6e 61 oject of reasona 0290: 62 6c 65 20 73 69 7a 65 20 61 6e 64 20 63 6f 6d ble size and com 02a0: 70 6c 65 78 69 74 79 20 77 69 6c 6c 20 67 65 6e plexity will gen 02b0: 65 72 61 74 65 20 74 68 6f 75 73 61 6e 64 73 0a erate thousands. 02c0: 20 20 20 20 20 20 61 6e 64 20 74 68 6f 75 73 61 and thousa 02d0: 6e 64 73 20 6f 66 20 74 69 63 6b 65 74 73 2c 20 nds of tickets, 02e0: 61 6e 64 20 77 65 20 64 6f 20 6e 6f 74 20 77 61 and we do not wa 02f0: 6e 74 20 61 6c 6c 20 74 68 6f 73 65 20 74 69 63 nt all those tic 0300: 6b 65 74 20 66 69 6c 65 73 0a 20 20 20 20 20 20 ket files. 0310: 63 6c 75 74 74 65 72 69 6e 67 20 74 68 65 20 73 cluttering the s 0320: 6f 75 72 63 65 20 74 72 65 65 2e 0a 0a 20 20 33 ource tree... 3 0330: 2e 20 20 57 65 20 77 61 6e 74 20 74 69 63 6b 65 . We want ticke 0340: 74 73 20 74 6f 20 62 65 20 6d 61 6e 61 67 65 64 ts to be managed 0350: 20 66 72 6f 6d 20 74 68 65 20 77 65 62 20 69 6e from the web in 0360: 74 65 72 66 61 63 65 20 61 6e 64 20 74 6f 20 68 terface and to h 0370: 61 76 65 20 61 0a 20 20 20 20 20 20 70 65 72 6d ave a. perm 0380: 69 73 73 69 6f 6e 20 73 79 73 74 65 6d 20 74 68 ission system th 0390: 61 74 20 69 73 20 64 69 73 74 69 6e 63 74 20 66 at is distinct f 03a0: 72 6f 6d 20 63 68 65 63 6b 2d 69 6e 20 70 65 72 rom check-in per 03b0: 6d 69 73 73 69 6f 6e 73 2e 0a 20 20 20 20 20 20 missions.. 03c0: 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 In other words, 03d0: 77 65 20 64 6f 20 6e 6f 74 20 77 61 6e 74 20 74 we do not want t 03e0: 6f 20 72 65 73 74 72 69 63 74 20 74 68 65 20 63 o restrict the c 03f0: 72 65 61 74 69 6f 6e 20 61 6e 64 20 65 64 69 74 reation and edit 0400: 69 6e 67 0a 20 20 20 20 20 20 6f 66 20 74 69 63 ing. of tic 0410: 6b 65 74 73 20 74 6f 20 64 65 76 65 6c 6f 70 65 kets to develope 0420: 72 73 20 77 69 74 68 20 63 68 65 63 6b 2d 69 6e rs with check-in 0430: 20 70 72 69 76 69 6c 65 67 65 73 20 61 6e 64 20 privileges and 0440: 61 6e 20 69 6e 73 74 61 6c 6c 65 64 0a 20 20 20 an installed. 0450: 20 20 20 63 6f 70 79 20 6f 66 20 74 68 65 20 66 copy of the f 0460: 6f 73 73 69 6c 20 65 78 65 63 75 74 61 62 6c 65 ossil executable 0470: 2e 20 20 43 61 73 75 61 6c 20 70 61 73 73 65 72 . Casual passer 0480: 73 2d 62 79 20 6f 6e 20 74 68 65 20 69 6e 74 65 s-by on the inte 0490: 72 6e 65 74 20 73 68 6f 75 6c 64 0a 20 20 20 20 rnet should. 04a0: 20 20 62 65 20 70 65 72 6d 69 74 74 65 64 20 74 be permitted t 04b0: 6f 20 63 72 65 61 74 65 20 74 69 63 6b 65 74 73 o create tickets 04c0: 2e 0a 0a 52 65 63 61 6c 6c 20 74 68 61 74 20 61 ...Recall that a 04d0: 20 66 6f 73 73 69 6c 20 72 65 70 6f 73 69 74 6f fossil reposito 04e0: 72 79 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 ry consists of a 04f0: 6e 0a 75 6e 6f 72 64 65 72 65 64 20 63 6f 6c 6c n.unordered coll 0500: 65 63 74 69 6f 6e 20 6f 66 20 3c 69 3e 61 72 74 ection of <i>art 0510: 69 66 61 63 74 73 3c 2f 69 3e 2e 20 20 28 53 65 ifacts</i>. (Se 0520: 65 20 74 68 65 0a 3c 61 20 68 72 65 66 3d 22 66 e the.<a href="f 0530: 69 6c 65 66 6f 72 6d 61 74 2e 77 69 6b 69 22 3e ileformat.wiki"> 0540: 66 69 6c 65 20 66 6f 72 6d 61 74 20 64 6f 63 75 file format docu 0550: 6d 65 6e 74 3c 2f 61 3e 20 66 6f 72 20 64 65 74 ment</a> for det 0560: 61 69 6c 73 2e 29 0a 53 6f 6d 65 20 61 72 74 69 ails.).Some arti 0570: 66 61 63 74 73 20 68 61 76 65 20 61 20 73 70 65 facts have a spe 0580: 63 69 61 6c 20 66 6f 72 6d 61 74 2c 20 61 6e 64 cial format, and 0590: 20 61 6d 6f 6e 67 20 74 68 6f 73 65 20 61 72 65 among those are 05a0: 0a 3c 61 20 68 72 65 66 3d 22 66 69 6c 65 66 6f .<a href="filefo 05b0: 72 6d 61 74 2e 77 69 6b 69 23 74 6b 74 63 68 6e rmat.wiki#tktchn 05c0: 67 22 3e 54 69 63 6b 65 74 20 43 68 61 6e 67 65 g">Ticket Change 05d0: 20 41 72 74 69 66 61 63 74 73 3c 2f 61 3e 2e 0a Artifacts</a>.. 05e0: 4f 6e 65 20 6f 72 20 6d 6f 72 65 20 74 69 63 6b One or more tick 05f0: 65 74 20 63 68 61 6e 67 65 20 61 72 74 69 66 61 et change artifa 0600: 63 74 73 20 61 72 65 20 61 73 73 6f 63 69 61 74 cts are associat 0610: 65 64 20 77 69 74 68 20 65 61 63 68 20 0a 74 69 ed with each .ti 0620: 63 6b 65 74 2e 20 20 41 20 74 69 63 6b 65 74 20 cket. A ticket 0630: 69 73 20 63 72 65 61 74 65 64 20 62 79 20 61 20 is created by a 0640: 74 69 63 6b 65 74 20 63 68 61 6e 67 65 20 61 72 ticket change ar 0650: 74 69 66 61 63 74 2e 0a 45 61 63 68 20 73 75 62 tifact..Each sub 0660: 73 65 71 75 65 6e 74 20 6d 6f 64 69 66 69 63 61 sequent modifica 0670: 74 69 6f 6e 20 6f 66 20 74 68 65 20 74 69 63 6b tion of the tick 0680: 65 74 20 69 73 20 61 20 73 65 70 61 72 61 74 65 et is a separate 0690: 20 61 72 74 69 66 61 63 74 2e 0a 0a 54 68 65 20 artifact...The 06a0: 22 70 75 73 68 22 2c 20 22 70 75 6c 6c 22 2c 20 "push", "pull", 06b0: 61 6e 64 20 22 73 79 6e 63 22 20 61 6c 67 6f 72 and "sync" algor 06c0: 69 74 68 6d 73 20 73 68 61 72 65 20 74 69 63 6b ithms share tick 06d0: 65 74 20 63 68 61 6e 67 65 20 61 72 74 69 66 61 et change artifa 06e0: 63 74 73 0a 62 65 74 77 65 65 6e 20 72 65 70 6f cts.between repo 06f0: 73 69 74 6f 72 69 65 73 20 69 6e 20 74 68 65 20 sitories in the 0700: 73 61 6d 65 20 77 61 79 20 61 73 20 65 76 65 72 same way as ever 0710: 79 20 6f 74 68 65 72 20 61 72 74 69 66 61 63 74 y other artifact 0720: 2e 20 20 49 6e 20 66 61 63 74 2c 0a 74 68 65 20 . In fact,.the 0730: 73 79 6e 63 20 61 6c 67 6f 72 69 74 68 6d 20 68 sync algorithm h 0740: 61 73 20 6e 6f 20 6b 6e 6f 77 6c 65 64 67 65 20 as no knowledge 0750: 6f 66 20 74 68 65 20 6d 65 61 6e 69 6e 67 20 6f of the meaning o 0760: 66 20 74 68 65 20 61 72 74 69 66 61 63 74 73 20 f the artifacts 0770: 69 74 0a 69 73 20 73 79 6e 63 69 6e 67 2e 20 20 it.is syncing. 0780: 41 73 20 66 61 72 20 61 73 20 74 68 65 20 73 79 As far as the sy 0790: 6e 63 20 61 6c 67 6f 72 69 74 68 6d 20 69 73 20 nc algorithm is 07a0: 63 6f 6e 63 65 72 6e 65 64 2c 20 61 6c 6c 20 61 concerned, all a 07b0: 72 74 69 66 61 63 74 73 20 61 72 65 0a 61 6c 69 rtifacts are.ali 07c0: 6b 65 2e 20 20 41 66 74 65 72 20 74 68 65 20 73 ke. After the s 07d0: 79 6e 63 20 68 61 73 20 6f 63 63 75 72 73 2c 20 ync has occurs, 07e0: 74 68 65 20 69 6e 64 69 76 69 64 75 61 6c 20 72 the individual r 07f0: 65 70 6f 73 69 74 6f 72 69 65 73 20 6d 75 73 74 epositories must 0800: 0a 6d 61 6b 65 20 73 65 6e 73 65 20 6f 66 20 74 .make sense of t 0810: 68 65 20 6d 65 61 6e 69 6e 67 20 6f 66 20 74 68 he meaning of th 0820: 65 20 76 61 72 69 6f 75 73 20 61 72 74 69 66 61 e various artifa 0830: 63 74 73 20 66 6f 72 20 74 68 65 6d 73 65 6c 76 cts for themselv 0840: 65 73 2e 0a 0a 3c 68 32 3e 49 6e 74 65 72 70 72 es...<h2>Interpr 0850: 65 74 61 74 69 6f 6e 20 4f 66 20 54 69 63 6b 65 etation Of Ticke 0860: 74 20 43 68 61 6e 67 65 20 41 72 74 69 66 61 63 t Change Artifac 0870: 74 73 3c 2f 68 32 3e 0a 0a 45 76 65 72 79 20 74 ts</h2>..Every t 0880: 69 63 6b 65 74 20 63 68 61 6e 67 65 20 61 72 74 icket change art 0890: 69 66 61 63 74 20 63 6f 6e 74 61 69 6e 73 20 28 ifact contains ( 08a0: 61 6d 6f 6e 67 20 6f 74 68 65 72 20 74 68 69 6e among other thin 08b0: 67 73 29 0a 0a 20 20 2a 20 20 61 20 74 69 6d 65 gs).. * a time 08c0: 73 74 61 6d 70 2c 0a 20 20 2a 20 20 61 20 74 69 stamp,. * a ti 08d0: 63 6b 65 74 20 55 55 49 44 2c 20 61 6e 64 0a 20 cket UUID, and. 08e0: 20 2a 20 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 * one or more 08f0: 6e 61 6d 65 2f 76 61 6c 75 65 20 70 61 69 72 73 name/value pairs 0900: 2e 0a 0a 54 68 65 20 63 75 72 72 65 6e 74 20 73 ...The current s 0910: 74 61 74 65 20 6f 66 20 61 20 74 69 63 6b 65 74 tate of a ticket 0920: 20 69 73 20 66 6f 75 6e 64 20 62 79 20 72 65 70 is found by rep 0930: 6c 61 79 69 6e 67 20 61 6c 6c 20 74 69 63 6b 65 laying all ticke 0940: 74 0a 63 68 61 6e 67 65 20 61 72 74 69 66 61 63 t.change artifac 0950: 74 73 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 ts with the same 0960: 20 74 69 63 6b 65 74 20 55 55 49 44 20 69 6e 20 ticket UUID in 0970: 74 69 6d 65 73 74 61 6d 70 20 6f 72 64 65 72 2e timestamp order. 0980: 0a 46 6f 72 20 61 20 67 69 76 65 6e 20 74 69 63 .For a given tic 0990: 6b 65 74 2c 20 61 6c 6c 20 76 61 6c 75 65 73 20 ket, all values 09a0: 61 72 65 20 69 6e 69 74 69 61 6c 6c 79 20 4e 55 are initially NU 09b0: 4c 4c 2e 20 20 41 73 20 65 61 63 68 0a 74 69 63 LL. As each.tic 09c0: 6b 65 74 20 63 68 61 6e 67 65 20 61 72 74 69 66 ket change artif 09d0: 61 63 74 20 69 73 20 65 6e 63 6f 75 6e 74 65 72 act is encounter 09e0: 65 64 2c 20 76 61 6c 75 65 73 20 61 72 65 20 65 ed, values are e 09f0: 69 74 68 65 72 20 72 65 70 6c 61 63 65 64 0a 6f ither replaced.o 0a00: 72 20 61 70 70 65 6e 64 65 64 2c 20 61 63 63 6f r appended, acco 0a10: 72 64 69 6e 67 20 74 6f 20 61 20 66 6c 61 67 20 rding to a flag 0a20: 6f 6e 20 74 68 65 20 6e 61 6d 65 2f 76 61 6c 75 on the name/valu 0a30: 65 20 70 61 69 72 2e 20 20 54 68 65 20 63 75 72 e pair. The cur 0a40: 72 65 6e 74 0a 76 61 6c 75 65 73 20 66 6f 72 20 rent.values for 0a50: 74 68 65 20 66 69 65 6c 64 73 20 6f 66 20 61 20 the fields of a 0a60: 74 69 63 6b 65 74 20 61 72 65 20 74 68 65 20 76 ticket are the v 0a70: 61 6c 75 65 73 20 74 68 61 74 20 72 65 6d 61 69 alues that remai 0a80: 6e 20 61 74 20 74 68 65 0a 65 6e 64 20 6f 66 20 n at the.end of 0a90: 74 68 65 20 72 65 70 6c 61 79 20 70 72 6f 63 65 the replay proce 0aa0: 73 73 2e 0a 0a 54 6f 20 63 72 65 61 74 65 20 61 ss...To create a 0ab0: 20 6e 65 77 20 74 69 63 6b 65 74 2c 20 6f 6e 65 new ticket, one 0ac0: 20 69 6e 73 65 72 74 73 20 61 20 74 69 63 6b 65 inserts a ticke 0ad0: 74 20 63 68 61 6e 67 65 0a 61 72 74 69 66 61 63 t change.artifac 0ae0: 74 20 77 69 74 68 20 61 20 6e 65 77 20 55 55 49 t with a new UUI 0af0: 44 2e 20 20 54 68 65 20 74 69 63 6b 65 74 20 55 D. The ticket U 0b00: 55 49 44 0a 69 73 20 61 20 72 61 6e 64 6f 6d 20 UID.is a random 0b10: 34 30 2d 63 68 61 72 61 63 74 65 72 20 6c 6f 77 40-character low 0b20: 65 72 2d 63 61 73 65 20 68 65 78 61 64 65 63 69 er-case hexadeci 0b30: 6d 61 6c 20 6e 75 6d 62 65 72 2e 20 20 54 68 65 mal number. The 0b40: 20 22 74 6b 74 6e 65 77 22 0a 70 61 67 65 20 69 "tktnew".page i 0b50: 6e 20 74 68 65 20 66 6f 73 73 69 6c 20 77 65 62 n the fossil web 0b60: 20 69 6e 74 65 72 66 61 63 65 20 63 72 65 61 74 interface creat 0b70: 65 73 20 6e 65 77 20 74 69 63 6b 65 74 20 55 55 es new ticket UU 0b80: 49 44 73 0a 75 73 69 6e 67 20 61 20 67 6f 6f 64 IDs.using a good 0b90: 20 73 6f 75 72 63 65 20 6f 66 20 72 61 6e 64 6f source of rando 0ba0: 6d 6e 65 73 73 20 74 6f 20 69 6e 73 75 72 65 20 mness to insure 0bb0: 75 6e 69 71 75 65 6e 65 73 73 2e 0a 54 68 65 20 uniqueness..The 0bc0: 6e 61 6d 65 2f 76 61 6c 75 65 20 70 61 69 72 73 name/value pairs 0bd0: 20 6f 6e 20 74 68 65 20 69 6e 69 74 69 61 6c 20 on the initial 0be0: 74 69 63 6b 65 74 20 63 68 61 6e 67 65 0a 61 72 ticket change.ar 0bf0: 74 69 66 61 63 74 20 61 72 65 20 74 68 65 20 69 tifact are the i 0c00: 6e 69 74 69 61 6c 20 76 61 6c 75 65 73 20 66 6f nitial values fo 0c10: 72 20 74 68 65 20 66 69 65 6c 64 73 20 69 6e 20 r the fields in 0c20: 74 68 65 20 74 69 63 6b 65 74 2e 0a 0a 41 6d 65 the ticket...Ame 0c30: 6e 64 69 6e 67 20 61 20 74 69 63 6b 65 74 20 6d nding a ticket m 0c40: 65 61 6e 73 20 73 69 6d 70 6c 79 20 63 72 65 61 eans simply crea 0c50: 74 69 6e 67 20 61 20 6e 65 77 20 61 72 74 69 66 ting a new artif 0c60: 61 63 74 20 77 69 74 68 20 74 68 65 0a 73 61 6d act with the.sam 0c70: 65 20 74 69 63 6b 65 74 20 55 55 49 44 20 61 6e e ticket UUID an 0c80: 64 20 77 69 74 68 20 6e 61 6d 65 2f 76 61 6c 75 d with name/valu 0c90: 65 20 70 61 69 72 73 20 66 6f 72 20 74 68 6f 73 e pairs for thos 0ca0: 65 20 66 69 65 6c 64 73 20 77 68 69 63 68 0a 61 e fields which.a 0cb0: 72 65 20 63 68 61 6e 67 69 6e 67 2e 20 20 46 69 re changing. Fi 0cc0: 65 6c 64 73 20 6f 66 20 74 68 65 20 74 69 63 6b elds of the tick 0cd0: 65 74 20 77 68 69 63 68 20 61 72 65 20 6e 6f 74 et which are not 0ce0: 20 62 65 69 6e 67 20 6d 6f 64 69 66 69 65 64 0a being modified. 0cf0: 73 68 6f 75 6c 64 20 6e 6f 74 20 61 70 70 65 61 should not appea 0d00: 72 20 61 73 20 6e 61 6d 65 2f 76 61 6c 75 65 20 r as name/value 0d10: 70 61 69 72 73 20 69 6e 20 74 68 65 20 6e 65 77 pairs in the new 0d20: 20 61 72 74 69 66 61 63 74 2e 0a 0a 54 68 69 73 artifact...This 0d30: 20 61 70 70 72 6f 61 63 68 20 74 6f 20 73 74 6f approach to sto 0d40: 72 69 6e 67 20 74 69 63 6b 65 74 20 73 74 61 74 ring ticket stat 0d50: 65 20 6d 65 61 6e 73 20 74 68 61 74 20 69 6e 64 e means that ind 0d60: 65 70 65 6e 64 65 6e 74 6c 79 20 65 6e 74 65 72 ependently enter 0d70: 65 64 0a 63 68 61 6e 67 65 73 20 61 72 65 20 61 ed.changes are a 0d80: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 6d 65 72 utomatically mer 0d90: 67 65 64 20 74 6f 67 65 74 68 65 72 20 77 68 65 ged together whe 0da0: 6e 20 61 72 74 69 66 61 63 74 73 20 61 72 65 20 n artifacts are 0db0: 73 68 61 72 65 64 0a 62 65 74 77 65 65 6e 20 72 shared.between r 0dc0: 65 70 6f 73 69 74 6f 72 69 65 73 2e 20 20 54 69 epositories. Ti 0dd0: 63 6b 65 74 73 20 64 6f 20 6e 6f 74 20 62 72 61 ckets do not bra 0de0: 6e 63 68 2e 20 20 54 68 69 73 20 61 70 70 72 6f nch. This appro 0df0: 61 63 68 20 61 6c 73 6f 20 6d 61 6b 65 73 0a 69 ach also makes.i 0e00: 74 20 74 72 69 76 69 61 6c 20 74 6f 20 74 72 61 t trivial to tra 0e10: 63 6b 20 74 68 65 20 68 69 73 74 6f 72 69 63 20 ck the historic 0e20: 70 72 6f 67 72 65 73 73 69 6f 6e 20 6f 66 20 63 progression of c 0e30: 68 61 6e 67 65 73 20 74 6f 20 61 20 74 69 63 6b hanges to a tick 0e40: 65 74 2e 0a 0a 49 6e 20 6f 72 64 65 72 20 66 6f et...In order fo 0e50: 72 20 74 68 69 73 20 73 63 68 65 6d 65 20 74 6f r this scheme to 0e60: 20 77 6f 72 6b 2c 20 74 68 65 20 73 79 73 74 65 work, the syste 0e70: 6d 20 63 6c 6f 63 6b 73 20 6f 6e 20 6d 61 63 68 m clocks on mach 0e80: 69 6e 65 73 20 74 68 61 74 0a 61 64 64 20 6e 65 ines that.add ne 0e90: 77 20 74 69 63 6b 65 74 20 63 68 61 6e 67 65 73 w ticket changes 0ea0: 20 61 72 74 69 66 61 63 74 73 20 68 61 76 65 20 artifacts have 0eb0: 74 6f 20 62 65 20 73 65 74 20 63 6c 6f 73 65 20 to be set close 0ec0: 74 6f 20 72 65 61 6c 69 74 79 2e 0a 49 74 20 69 to reality..It i 0ed0: 73 20 4f 4b 20 66 6f 72 20 61 20 74 69 63 6b 65 s OK for a ticke 0ee0: 74 20 63 68 61 6e 67 65 20 61 72 74 69 66 61 63 t change artifac 0ef0: 74 20 74 69 6d 65 73 74 61 6d 70 20 74 6f 20 62 t timestamp to b 0f00: 65 20 6f 66 66 20 62 79 20 61 20 66 65 77 0a 6d e off by a few.m 0f10: 69 6e 75 74 65 73 20 6f 72 20 65 76 65 6e 20 61 inutes or even a 0f20: 20 66 65 77 20 68 6f 75 72 73 2e 20 20 42 75 74 few hours. But 0f30: 20 69 66 20 61 20 74 69 6d 65 73 74 61 6d 70 20 if a timestamp 0f40: 6f 6e 20 61 20 74 69 63 6b 65 74 20 63 68 61 6e on a ticket chan 0f50: 67 65 0a 61 72 74 69 66 61 63 74 20 69 73 20 6f ge.artifact is o 0f60: 66 66 20 62 79 20 6d 6f 6e 74 68 73 20 6f 72 20 ff by months or 0f70: 79 65 61 72 73 2c 20 69 74 20 63 61 6e 20 73 65 years, it can se 0f80: 72 69 6f 75 73 6c 79 20 63 6f 6e 66 75 73 65 20 riously confuse 0f90: 74 68 65 0a 72 65 70 6c 61 79 20 61 6c 67 6f 72 the.replay algor 0fa0: 69 74 68 6d 20 66 6f 72 20 64 65 74 65 72 6d 69 ithm for determi 0fb0: 6e 69 6e 67 20 74 68 65 20 63 75 72 72 65 6e 74 ning the current 0fc0: 20 74 69 63 6b 65 74 20 73 74 61 74 65 2e 20 20 ticket state. 0fd0: 54 68 65 72 65 0a 61 72 65 20 74 65 63 68 6e 69 There.are techni 0fe0: 71 75 65 73 20 61 76 61 69 6c 61 62 6c 65 20 74 ques available t 0ff0: 6f 20 63 61 75 73 65 20 72 6f 67 75 65 20 61 72 o cause rogue ar 1000: 74 69 66 61 63 74 73 20 74 6f 20 62 65 20 69 67 tifacts to be ig 1010: 6e 6f 72 65 64 0a 62 79 20 66 6f 73 73 69 6c 2e nored.by fossil. 1020: 20 20 53 6f 20 69 66 20 61 20 74 69 63 6b 65 74 So if a ticket 1030: 20 63 68 61 6e 67 65 20 61 72 74 69 66 61 63 74 change artifact 1040: 20 77 69 74 68 20 61 20 62 61 64 20 74 69 6d 65 with a bad time 1050: 73 74 61 6d 70 0a 64 6f 65 73 20 67 65 74 20 69 stamp.does get i 1060: 6e 74 6f 20 61 20 72 65 70 6f 73 69 74 6f 72 79 nto a repository 1070: 2c 20 69 74 20 63 61 6e 20 62 65 20 72 65 6d 6f , it can be remo 1080: 76 65 64 20 62 79 20 61 6e 20 61 64 6d 69 6e 73 ved by an admins 1090: 74 72 61 74 6f 72 2e 0a 42 75 74 20 74 68 65 20 trator..But the 10a0: 62 65 73 74 20 61 70 70 72 6f 61 63 68 20 69 73 best approach is 10b0: 20 74 6f 20 74 61 6b 65 20 73 74 65 70 73 20 74 to take steps t 10c0: 6f 20 69 6e 73 75 72 65 20 74 68 61 74 20 74 69 o insure that ti 10d0: 6d 65 73 74 61 6d 70 73 0a 61 72 65 20 61 70 70 mestamps.are app 10e0: 72 6f 78 69 6d 61 74 65 6c 79 20 63 6f 72 72 65 roximately corre 10f0: 63 74 20 69 6e 20 74 68 65 20 66 69 72 73 74 20 ct in the first 1100: 70 6c 61 63 65 2e 0a 0a 3c 68 32 3e 4c 6f 63 61 place...<h2>Loca 1110: 6c 20 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3c l Configuration< 1120: 2f 68 32 3e 0a 0a 54 68 65 20 74 69 63 6b 65 74 /h2>..The ticket 1130: 20 63 68 61 6e 67 65 20 61 72 74 69 66 61 63 74 change artifact 1140: 73 20 61 72 65 20 70 61 72 74 20 6f 66 20 74 68 s are part of th 1150: 65 20 67 6c 6f 62 61 6c 20 73 74 61 74 65 20 66 e global state f 1160: 6f 72 20 61 20 70 72 6f 6a 65 63 74 2e 0a 54 68 or a project..Th 1170: 65 20 67 6c 6f 62 61 6c 20 73 74 61 74 65 20 69 e global state i 1180: 73 20 74 68 61 74 20 77 68 69 63 68 20 69 73 20 s that which is 1190: 73 68 61 72 65 64 20 62 65 74 77 65 65 6e 20 72 shared between r 11a0: 65 70 6f 73 69 74 6f 72 69 65 73 20 64 75 72 69 epositories duri 11b0: 6e 67 0a 61 20 73 79 6e 63 2e 20 20 45 61 63 68 ng.a sync. Each 11c0: 20 72 65 70 6f 73 69 74 6f 72 79 20 61 6c 73 6f repository also 11d0: 20 68 61 73 20 6c 6f 63 61 6c 20 73 74 61 74 65 has local state 11e0: 20 77 68 69 63 68 20 69 73 20 6e 6f 74 20 28 6e which is not (n 11f0: 6f 72 6d 61 6c 6c 79 29 0a 73 68 61 72 65 64 2e ormally).shared. 1200: 20 20 54 68 65 20 6e 61 6d 65 2f 76 61 6c 75 65 The name/value 1210: 20 70 61 69 72 73 20 66 6f 72 20 61 20 74 69 63 pairs for a tic 1220: 6b 65 74 20 61 72 65 20 70 61 72 74 20 6f 66 20 ket are part of 1230: 67 6c 6f 62 61 6c 20 73 74 61 74 65 2c 0a 62 75 global state,.bu 1240: 74 20 74 68 65 20 69 6e 74 65 72 70 72 65 74 61 t the interpreta 1250: 74 69 6f 6e 20 61 6e 64 20 64 69 73 70 6c 61 79 tion and display 1260: 20 6f 66 20 74 68 61 74 20 69 6e 66 6f 72 6d 61 of that informa 1270: 74 69 6f 6e 20 69 73 20 6c 6f 63 61 6c 20 73 74 tion is local st 1280: 61 74 65 2e 0a 48 65 6e 63 65 2c 20 65 61 63 68 ate..Hence, each 1290: 20 72 65 70 6f 73 69 74 6f 72 79 20 69 73 20 66 repository is f 12a0: 72 65 65 20 74 6f 20 73 65 74 20 75 70 20 69 74 ree to set up it 12b0: 73 20 6f 77 6e 20 74 69 63 6b 65 74 20 64 69 73 s own ticket dis 12c0: 70 6c 61 79 20 61 6e 64 0a 69 6e 70 75 74 20 66 play and.input f 12d0: 6f 72 6d 61 74 73 20 61 6e 64 20 72 65 70 6f 72 ormats and repor 12e0: 74 69 6e 67 20 72 75 6c 65 73 20 61 63 63 6f 72 ting rules accor 12f0: 64 69 6e 67 20 74 6f 20 69 74 73 20 6f 77 6e 20 ding to its own 1300: 70 61 72 74 69 63 75 6c 61 72 20 6e 65 65 64 73 particular needs 1310: 2e 0a 0a 45 61 63 68 20 72 65 70 6f 73 69 74 6f ...Each reposito 1320: 72 79 20 64 65 66 69 6e 65 73 20 69 74 73 20 6f ry defines its o 1330: 77 6e 20 54 49 43 4b 45 54 20 74 61 62 6c 65 20 wn TICKET table 1340: 69 6e 20 69 74 73 20 64 61 74 61 62 61 73 65 2e in its database. 1350: 20 20 54 68 65 72 65 20 69 73 0a 6f 6e 65 20 72 There is.one r 1360: 6f 77 20 69 6e 20 74 68 65 20 54 49 43 4b 45 54 ow in the TICKET 1370: 20 74 61 62 6c 65 20 66 6f 72 20 65 61 63 68 20 table for each 1380: 75 6e 69 71 75 65 20 74 69 63 6b 65 74 20 55 55 unique ticket UU 1390: 49 44 2e 20 20 54 68 65 0a 6e 61 6d 65 73 20 6f ID. The.names o 13a0: 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 f columns in the 13b0: 20 54 49 43 4b 45 54 20 74 61 62 6c 65 20 63 6f TICKET table co 13c0: 72 72 65 73 70 6f 6e 64 20 74 6f 20 74 68 65 20 rrespond to the 13d0: 6e 61 6d 65 73 20 69 6e 0a 74 68 65 20 6e 61 6d names in.the nam 13e0: 65 2f 76 61 6c 75 65 20 70 61 69 72 73 20 6f 66 e/value pairs of 13f0: 20 74 69 63 6b 65 74 20 63 68 61 6e 67 65 20 61 ticket change a 1400: 72 74 69 66 61 63 74 73 2e 20 20 57 68 65 6e 20 rtifacts. When 1410: 72 75 6e 6e 69 6e 67 20 74 68 65 20 72 65 70 6c running the repl 1420: 61 79 0a 61 6c 67 6f 72 69 74 68 6d 2c 20 69 66 ay.algorithm, if 1430: 20 61 20 6e 61 6d 65 2f 76 61 6c 75 65 20 70 61 a name/value pa 1440: 69 72 20 69 73 20 73 65 65 6e 20 77 68 69 63 68 ir is seen which 1450: 20 68 61 73 20 6e 6f 20 63 6f 72 72 65 73 70 6f has no correspo 1460: 6e 64 69 6e 67 20 63 6f 6c 75 6d 6e 0a 69 6e 20 nding column.in 1470: 74 68 65 20 54 49 43 4b 45 54 20 74 61 62 6c 65 the TICKET table 1480: 2c 20 74 68 65 6e 20 74 68 61 74 20 6e 61 6d 65 , then that name 1490: 2f 76 61 6c 75 65 20 70 61 69 72 20 69 73 20 69 /value pair is i 14a0: 67 6e 6f 72 65 64 2e 20 20 43 6f 6c 75 6d 6e 73 gnored. Columns 14b0: 20 63 61 6e 0a 62 65 20 61 64 64 65 64 20 6f 72 can.be added or 14c0: 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 removed from th 14d0: 65 20 54 49 43 4b 45 54 20 74 61 62 6c 65 20 61 e TICKET table a 14e0: 74 20 61 6e 79 20 74 69 6d 65 2e 20 20 57 68 65 t any time. Whe 14f0: 6e 65 76 65 72 20 74 68 65 0a 54 49 43 4b 45 54 never the.TICKET 1500: 20 74 61 62 6c 65 20 69 73 20 6d 6f 64 69 66 69 table is modifi 1510: 65 64 2c 20 74 68 65 20 72 65 70 6c 61 79 20 61 ed, the replay a 1520: 6c 67 6f 72 69 74 68 6d 20 61 75 74 6f 6d 61 74 lgorithm automat 1530: 69 63 61 6c 6c 79 20 72 65 72 75 6e 73 0a 74 6f ically reruns.to 1540: 20 72 65 70 6f 70 75 6c 61 74 65 20 74 68 65 20 repopulate the 1550: 74 61 62 6c 65 20 75 73 69 6e 67 20 74 68 65 20 table using the 1560: 6e 65 77 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 73 new column names 1570: 2e 20 20 4e 6f 74 65 20 74 68 61 74 20 74 68 65 . Note that the 1580: 20 54 49 43 4b 45 54 0a 74 61 62 6c 65 20 73 63 TICKET.table sc 1590: 68 65 6d 61 20 61 6e 64 20 63 6f 6e 74 65 6e 74 hema and content 15a0: 20 69 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 is part of the 15b0: 6c 6f 63 61 6c 20 73 74 61 74 65 20 6f 66 20 61 local state of a 15c0: 20 72 65 73 70 6f 73 69 74 6f 72 79 0a 61 6e 64 respository.and 15d0: 20 69 73 20 6e 6f 74 20 73 68 61 72 65 64 20 77 is not shared w 15e0: 69 74 68 20 6f 74 68 65 72 20 72 65 70 6f 73 69 ith other reposi 15f0: 74 6f 72 69 65 73 20 64 75 72 69 6e 67 20 61 20 tories during a 1600: 73 79 6e 63 2c 20 70 75 73 68 2c 20 6f 72 20 70 sync, push, or p 1610: 75 6c 6c 2e 0a 0a 45 61 63 68 20 72 65 70 6f 73 ull...Each repos 1620: 69 74 6f 72 79 20 61 6c 73 6f 20 64 65 66 69 6e itory also defin 1630: 65 73 20 73 63 72 69 70 74 73 20 75 73 65 64 20 es scripts used 1640: 74 6f 20 67 65 6e 65 72 61 74 65 20 77 65 62 20 to generate web 1650: 70 61 67 65 73 20 66 6f 72 0a 63 72 65 61 74 69 pages for.creati 1660: 6e 67 20 6e 65 77 20 74 69 63 6b 65 74 73 2c 20 ng new tickets, 1670: 76 69 65 77 69 6e 67 20 65 78 69 73 74 69 6e 67 viewing existing 1680: 20 74 69 63 6b 65 74 73 2c 20 61 6e 64 20 6d 6f tickets, and mo 1690: 64 69 66 79 69 6e 67 20 61 6e 0a 65 78 69 73 74 difying an.exist 16a0: 69 6e 67 20 74 69 63 6b 65 74 2e 20 20 54 68 65 ing ticket. The 16b0: 73 65 20 73 63 72 69 70 74 73 20 63 6f 6e 73 69 se scripts consi 16c0: 73 74 20 6f 66 20 48 54 4d 4c 20 77 69 74 68 20 st of HTML with 16d0: 61 6e 20 65 6d 62 65 64 64 65 64 0a 73 63 72 69 an embedded.scri 16e0: 70 74 73 20 77 72 69 74 74 65 6e 20 61 6e 20 61 pts written an a 16f0: 20 54 43 4c 2d 6c 69 6b 65 20 6c 61 6e 67 75 61 TCL-like langua 1700: 67 65 20 63 61 6c 6c 65 64 20 22 54 48 31 22 2e ge called "TH1". 1710: 20 20 45 76 65 72 79 20 6e 65 77 20 66 6f 73 73 Every new foss 1720: 69 6c 0a 72 65 70 6f 73 69 74 6f 72 79 20 69 73 il.repository is 1730: 20 63 72 65 61 74 65 64 20 77 69 74 68 20 64 65 created with de 1740: 66 61 75 6c 74 20 73 63 72 69 70 74 73 2e 20 20 fault scripts. 1750: 54 68 65 72 65 20 69 73 20 63 75 72 72 65 6e 74 There is current 1760: 6c 79 20 6e 6f 0a 64 6f 63 75 6d 65 6e 74 61 74 ly no.documentat 1770: 69 6f 6e 20 6f 6e 20 74 68 65 20 54 48 31 20 6c ion on the TH1 l 1780: 61 6e 67 61 75 61 67 65 2e 20 20 41 64 6d 69 6e angauage. Admin 1790: 69 73 74 72 61 74 6f 72 73 20 77 69 73 68 69 6e istrators wishin 17a0: 67 20 74 6f 0a 63 75 73 74 6f 6d 69 7a 65 20 74 g to.customize t 17b0: 68 65 69 72 20 74 69 63 6b 65 74 20 65 6e 74 72 heir ticket entr 17c0: 79 2c 20 76 69 65 77 69 6e 67 2c 20 61 6e 64 20 y, viewing, and 17d0: 65 64 69 74 69 6e 67 20 73 63 72 65 65 6e 73 20 editing screens 17e0: 73 68 6f 75 6c 64 0a 6d 6f 64 69 66 79 20 74 68 should.modify th 17f0: 65 20 64 65 66 61 75 6c 74 20 73 63 72 69 70 74 e default script 1800: 73 20 74 6f 20 73 75 69 74 20 74 68 65 69 72 20 s to suit their 1810: 6e 65 65 64 73 2e 20 20 54 68 65 73 65 20 73 63 needs. These sc 1820: 72 65 65 6e 20 67 65 6e 65 72 61 74 6f 72 0a 73 reen generator.s 1830: 63 72 69 70 74 73 20 61 72 65 20 70 61 72 74 20 cripts are part 1840: 6f 66 20 74 68 65 20 6c 6f 63 61 6c 20 73 74 61 of the local sta 1850: 74 65 20 6f 66 20 61 20 72 65 70 6f 73 69 74 6f te of a reposito 1860: 72 79 20 61 6e 64 20 61 72 65 20 6e 6f 74 20 73 ry and are not s 1870: 68 61 72 65 64 0a 77 69 74 68 20 6f 74 68 65 72 hared.with other 1880: 20 72 65 70 6f 73 69 74 6f 72 69 65 73 20 64 75 repositories du 1890: 72 69 6e 67 20 61 20 73 79 6e 63 2c 20 70 75 73 ring a sync, pus 18a0: 68 2c 20 6f 72 20 70 75 6c 6c 2e 0a 0a 3c 69 3e h, or pull...<i> 18b0: 54 6f 20 62 65 20 63 6f 6e 74 69 6e 75 65 64 2e To be continued. 18c0: 2e 2e 3c 2f 69 3e 0a ..</i>.