Artifact 74c6e6ad6e9de17aea46d3b3fe23b89217c5dea7:
File www/bugtheory.wiki part of check-in [e8c4f69c50] - Change all mentions of "UUID" in the documentation and help screens into either "artifact ID" or "baseline ID" or "ticket ID" as appropriate. "UUID" has a widely recognized meaning that is different from its meaning in fossil. "UUID" is still used in code comments and in variable names. by drh on 2008-10-24 13:27:53.
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 49 44 2c 20 61 6e 64 0a 20 20 2a cket ID, and. * 08e0: 20 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6e 61 one or more na 08f0: 6d 65 2f 76 61 6c 75 65 20 70 61 69 72 73 2e 0a me/value pairs.. 0900: 0a 54 68 65 20 63 75 72 72 65 6e 74 20 73 74 61 .The current sta 0910: 74 65 20 6f 66 20 61 20 74 69 63 6b 65 74 20 69 te of a ticket i 0920: 73 20 66 6f 75 6e 64 20 62 79 20 72 65 70 6c 61 s found by repla 0930: 79 69 6e 67 20 61 6c 6c 20 74 69 63 6b 65 74 0a ying all ticket. 0940: 63 68 61 6e 67 65 20 61 72 74 69 66 61 63 74 73 change artifacts 0950: 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 20 74 with the same t 0960: 69 63 6b 65 74 20 49 44 20 69 6e 20 74 69 6d 65 icket ID in time 0970: 73 74 61 6d 70 20 6f 72 64 65 72 2e 0a 46 6f 72 stamp order..For 0980: 20 61 20 67 69 76 65 6e 20 74 69 63 6b 65 74 2c a given ticket, 0990: 20 61 6c 6c 20 76 61 6c 75 65 73 20 61 72 65 20 all values are 09a0: 69 6e 69 74 69 61 6c 6c 79 20 4e 55 4c 4c 2e 20 initially NULL. 09b0: 20 41 73 20 65 61 63 68 0a 74 69 63 6b 65 74 20 As each.ticket 09c0: 63 68 61 6e 67 65 20 61 72 74 69 66 61 63 74 20 change artifact 09d0: 69 73 20 65 6e 63 6f 75 6e 74 65 72 65 64 2c 20 is encountered, 09e0: 76 61 6c 75 65 73 20 61 72 65 20 65 69 74 68 65 values are eithe 09f0: 72 20 72 65 70 6c 61 63 65 64 0a 6f 72 20 61 70 r replaced.or ap 0a00: 70 65 6e 64 65 64 2c 20 61 63 63 6f 72 64 69 6e pended, accordin 0a10: 67 20 74 6f 20 61 20 66 6c 61 67 20 6f 6e 20 74 g to a flag on t 0a20: 68 65 20 6e 61 6d 65 2f 76 61 6c 75 65 20 70 61 he name/value pa 0a30: 69 72 2e 20 20 54 68 65 20 63 75 72 72 65 6e 74 ir. The current 0a40: 0a 76 61 6c 75 65 73 20 66 6f 72 20 74 68 65 20 .values for the 0a50: 66 69 65 6c 64 73 20 6f 66 20 61 20 74 69 63 6b fields of a tick 0a60: 65 74 20 61 72 65 20 74 68 65 20 76 61 6c 75 65 et are the value 0a70: 73 20 74 68 61 74 20 72 65 6d 61 69 6e 20 61 74 s that remain at 0a80: 20 74 68 65 0a 65 6e 64 20 6f 66 20 74 68 65 20 the.end of the 0a90: 72 65 70 6c 61 79 20 70 72 6f 63 65 73 73 2e 0a replay process.. 0aa0: 0a 54 6f 20 63 72 65 61 74 65 20 61 20 6e 65 77 .To create a new 0ab0: 20 74 69 63 6b 65 74 2c 20 6f 6e 65 20 69 6e 73 ticket, one ins 0ac0: 65 72 74 73 20 61 20 74 69 63 6b 65 74 20 63 68 erts a ticket ch 0ad0: 61 6e 67 65 0a 61 72 74 69 66 61 63 74 20 77 69 ange.artifact wi 0ae0: 74 68 20 61 20 6e 65 77 20 49 44 2e 20 20 54 68 th a new ID. Th 0af0: 65 20 74 69 63 6b 65 74 20 49 44 0a 69 73 20 61 e ticket ID.is a 0b00: 20 72 61 6e 64 6f 6d 20 34 30 2d 63 68 61 72 61 random 40-chara 0b10: 63 74 65 72 20 6c 6f 77 65 72 2d 63 61 73 65 20 cter lower-case 0b20: 68 65 78 61 64 65 63 69 6d 61 6c 20 6e 75 6d 62 hexadecimal numb 0b30: 65 72 2e 20 20 54 68 65 20 22 74 6b 74 6e 65 77 er. The "tktnew 0b40: 22 0a 70 61 67 65 20 69 6e 20 74 68 65 20 66 6f ".page in the fo 0b50: 73 73 69 6c 20 77 65 62 20 69 6e 74 65 72 66 61 ssil web interfa 0b60: 63 65 20 63 72 65 61 74 65 73 20 6e 65 77 20 74 ce creates new t 0b70: 69 63 6b 65 74 20 49 44 73 0a 75 73 69 6e 67 20 icket IDs.using 0b80: 61 20 67 6f 6f 64 20 73 6f 75 72 63 65 20 6f 66 a good source of 0b90: 20 72 61 6e 64 6f 6d 6e 65 73 73 20 74 6f 20 69 randomness to i 0ba0: 6e 73 75 72 65 20 75 6e 69 71 75 65 6e 65 73 73 nsure uniqueness 0bb0: 2e 0a 54 68 65 20 6e 61 6d 65 2f 76 61 6c 75 65 ..The name/value 0bc0: 20 70 61 69 72 73 20 6f 6e 20 74 68 65 20 69 6e pairs on the in 0bd0: 69 74 69 61 6c 20 74 69 63 6b 65 74 20 63 68 61 itial ticket cha 0be0: 6e 67 65 0a 61 72 74 69 66 61 63 74 20 61 72 65 nge.artifact are 0bf0: 20 74 68 65 20 69 6e 69 74 69 61 6c 20 76 61 6c the initial val 0c00: 75 65 73 20 66 6f 72 20 74 68 65 20 66 69 65 6c ues for the fiel 0c10: 64 73 20 69 6e 20 74 68 65 20 74 69 63 6b 65 74 ds in the ticket 0c20: 2e 0a 0a 41 6d 65 6e 64 69 6e 67 20 61 20 74 69 ...Amending a ti 0c30: 63 6b 65 74 20 6d 65 61 6e 73 20 73 69 6d 70 6c cket means simpl 0c40: 79 20 63 72 65 61 74 69 6e 67 20 61 20 6e 65 77 y creating a new 0c50: 20 61 72 74 69 66 61 63 74 20 77 69 74 68 20 74 artifact with t 0c60: 68 65 0a 73 61 6d 65 20 74 69 63 6b 65 74 20 49 he.same ticket I 0c70: 44 20 61 6e 64 20 77 69 74 68 20 6e 61 6d 65 2f D and with name/ 0c80: 76 61 6c 75 65 20 70 61 69 72 73 20 66 6f 72 20 value pairs for 0c90: 74 68 6f 73 65 20 66 69 65 6c 64 73 20 77 68 69 those fields whi 0ca0: 63 68 0a 61 72 65 20 63 68 61 6e 67 69 6e 67 2e ch.are changing. 0cb0: 20 20 46 69 65 6c 64 73 20 6f 66 20 74 68 65 20 Fields of the 0cc0: 74 69 63 6b 65 74 20 77 68 69 63 68 20 61 72 65 ticket which are 0cd0: 20 6e 6f 74 20 62 65 69 6e 67 20 6d 6f 64 69 66 not being modif 0ce0: 69 65 64 0a 73 68 6f 75 6c 64 20 6e 6f 74 20 61 ied.should not a 0cf0: 70 70 65 61 72 20 61 73 20 6e 61 6d 65 2f 76 61 ppear as name/va 0d00: 6c 75 65 20 70 61 69 72 73 20 69 6e 20 74 68 65 lue pairs in the 0d10: 20 6e 65 77 20 61 72 74 69 66 61 63 74 2e 0a 0a new artifact... 0d20: 54 68 69 73 20 61 70 70 72 6f 61 63 68 20 74 6f This approach to 0d30: 20 73 74 6f 72 69 6e 67 20 74 69 63 6b 65 74 20 storing ticket 0d40: 73 74 61 74 65 20 6d 65 61 6e 73 20 74 68 61 74 state means that 0d50: 20 69 6e 64 65 70 65 6e 64 65 6e 74 6c 79 20 65 independently e 0d60: 6e 74 65 72 65 64 0a 63 68 61 6e 67 65 73 20 61 ntered.changes a 0d70: 72 65 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 re automatically 0d80: 20 6d 65 72 67 65 64 20 74 6f 67 65 74 68 65 72 merged together 0d90: 20 77 68 65 6e 20 61 72 74 69 66 61 63 74 73 20 when artifacts 0da0: 61 72 65 20 73 68 61 72 65 64 0a 62 65 74 77 65 are shared.betwe 0db0: 65 6e 20 72 65 70 6f 73 69 74 6f 72 69 65 73 2e en repositories. 0dc0: 20 20 54 69 63 6b 65 74 73 20 64 6f 20 6e 6f 74 Tickets do not 0dd0: 20 62 72 61 6e 63 68 2e 20 20 54 68 69 73 20 61 branch. This a 0de0: 70 70 72 6f 61 63 68 20 61 6c 73 6f 20 6d 61 6b pproach also mak 0df0: 65 73 0a 69 74 20 74 72 69 76 69 61 6c 20 74 6f es.it trivial to 0e00: 20 74 72 61 63 6b 20 74 68 65 20 68 69 73 74 6f track the histo 0e10: 72 69 63 20 70 72 6f 67 72 65 73 73 69 6f 6e 20 ric progression 0e20: 6f 66 20 63 68 61 6e 67 65 73 20 74 6f 20 61 20 of changes to a 0e30: 74 69 63 6b 65 74 2e 0a 0a 49 6e 20 6f 72 64 65 ticket...In orde 0e40: 72 20 66 6f 72 20 74 68 69 73 20 73 63 68 65 6d r for this schem 0e50: 65 20 74 6f 20 77 6f 72 6b 2c 20 74 68 65 20 73 e to work, the s 0e60: 79 73 74 65 6d 20 63 6c 6f 63 6b 73 20 6f 6e 20 ystem clocks on 0e70: 6d 61 63 68 69 6e 65 73 20 74 68 61 74 0a 61 64 machines that.ad 0e80: 64 20 6e 65 77 20 74 69 63 6b 65 74 20 63 68 61 d new ticket cha 0e90: 6e 67 65 73 20 61 72 74 69 66 61 63 74 73 20 68 nges artifacts h 0ea0: 61 76 65 20 74 6f 20 62 65 20 73 65 74 20 63 6c ave to be set cl 0eb0: 6f 73 65 20 74 6f 20 72 65 61 6c 69 74 79 2e 0a ose to reality.. 0ec0: 49 74 20 69 73 20 4f 4b 20 66 6f 72 20 61 20 74 It is OK for a t 0ed0: 69 63 6b 65 74 20 63 68 61 6e 67 65 20 61 72 74 icket change art 0ee0: 69 66 61 63 74 20 74 69 6d 65 73 74 61 6d 70 20 ifact timestamp 0ef0: 74 6f 20 62 65 20 6f 66 66 20 62 79 20 61 20 66 to be off by a f 0f00: 65 77 0a 6d 69 6e 75 74 65 73 20 6f 72 20 65 76 ew.minutes or ev 0f10: 65 6e 20 61 20 66 65 77 20 68 6f 75 72 73 2e 20 en a few hours. 0f20: 20 42 75 74 20 69 66 20 61 20 74 69 6d 65 73 74 But if a timest 0f30: 61 6d 70 20 6f 6e 20 61 20 74 69 63 6b 65 74 20 amp on a ticket 0f40: 63 68 61 6e 67 65 0a 61 72 74 69 66 61 63 74 20 change.artifact 0f50: 69 73 20 6f 66 66 20 62 79 20 6d 6f 6e 74 68 73 is off by months 0f60: 20 6f 72 20 79 65 61 72 73 2c 20 69 74 20 63 61 or years, it ca 0f70: 6e 20 73 65 72 69 6f 75 73 6c 79 20 63 6f 6e 66 n seriously conf 0f80: 75 73 65 20 74 68 65 0a 72 65 70 6c 61 79 20 61 use the.replay a 0f90: 6c 67 6f 72 69 74 68 6d 20 66 6f 72 20 64 65 74 lgorithm for det 0fa0: 65 72 6d 69 6e 69 6e 67 20 74 68 65 20 63 75 72 ermining the cur 0fb0: 72 65 6e 74 20 74 69 63 6b 65 74 20 73 74 61 74 rent ticket stat 0fc0: 65 2e 20 20 54 68 65 72 65 0a 61 72 65 20 74 65 e. There.are te 0fd0: 63 68 6e 69 71 75 65 73 20 61 76 61 69 6c 61 62 chniques availab 0fe0: 6c 65 20 74 6f 20 63 61 75 73 65 20 72 6f 67 75 le to cause rogu 0ff0: 65 20 61 72 74 69 66 61 63 74 73 20 74 6f 20 62 e artifacts to b 1000: 65 20 69 67 6e 6f 72 65 64 0a 62 79 20 66 6f 73 e ignored.by fos 1010: 73 69 6c 2e 20 20 53 6f 20 69 66 20 61 20 74 69 sil. So if a ti 1020: 63 6b 65 74 20 63 68 61 6e 67 65 20 61 72 74 69 cket change arti 1030: 66 61 63 74 20 77 69 74 68 20 61 20 62 61 64 20 fact with a bad 1040: 74 69 6d 65 73 74 61 6d 70 0a 64 6f 65 73 20 67 timestamp.does g 1050: 65 74 20 69 6e 74 6f 20 61 20 72 65 70 6f 73 69 et into a reposi 1060: 74 6f 72 79 2c 20 69 74 20 63 61 6e 20 62 65 20 tory, it can be 1070: 72 65 6d 6f 76 65 64 20 62 79 20 61 6e 20 61 64 removed by an ad 1080: 6d 69 6e 73 74 72 61 74 6f 72 2e 0a 42 75 74 20 minstrator..But 1090: 74 68 65 20 62 65 73 74 20 61 70 70 72 6f 61 63 the best approac 10a0: 68 20 69 73 20 74 6f 20 74 61 6b 65 20 73 74 65 h is to take ste 10b0: 70 73 20 74 6f 20 69 6e 73 75 72 65 20 74 68 61 ps to insure tha 10c0: 74 20 74 69 6d 65 73 74 61 6d 70 73 0a 61 72 65 t timestamps.are 10d0: 20 61 70 70 72 6f 78 69 6d 61 74 65 6c 79 20 63 approximately c 10e0: 6f 72 72 65 63 74 20 69 6e 20 74 68 65 20 66 69 orrect in the fi 10f0: 72 73 74 20 70 6c 61 63 65 2e 0a 0a 3c 68 32 3e rst place...<h2> 1100: 4c 6f 63 61 6c 20 43 6f 6e 66 69 67 75 72 61 74 Local Configurat 1110: 69 6f 6e 3c 2f 68 32 3e 0a 0a 54 68 65 20 74 69 ion</h2>..The ti 1120: 63 6b 65 74 20 63 68 61 6e 67 65 20 61 72 74 69 cket change arti 1130: 66 61 63 74 73 20 61 72 65 20 70 61 72 74 20 6f facts are part o 1140: 66 20 74 68 65 20 67 6c 6f 62 61 6c 20 73 74 61 f the global sta 1150: 74 65 20 66 6f 72 20 61 20 70 72 6f 6a 65 63 74 te for a project 1160: 2e 0a 54 68 65 20 67 6c 6f 62 61 6c 20 73 74 61 ..The global sta 1170: 74 65 20 69 73 20 74 68 61 74 20 77 68 69 63 68 te is that which 1180: 20 69 73 20 73 68 61 72 65 64 20 62 65 74 77 65 is shared betwe 1190: 65 6e 20 72 65 70 6f 73 69 74 6f 72 69 65 73 20 en repositories 11a0: 64 75 72 69 6e 67 0a 61 20 73 79 6e 63 2e 20 20 during.a sync. 11b0: 45 61 63 68 20 72 65 70 6f 73 69 74 6f 72 79 20 Each repository 11c0: 61 6c 73 6f 20 68 61 73 20 6c 6f 63 61 6c 20 73 also has local s 11d0: 74 61 74 65 20 77 68 69 63 68 20 69 73 20 6e 6f tate which is no 11e0: 74 20 28 6e 6f 72 6d 61 6c 6c 79 29 0a 73 68 61 t (normally).sha 11f0: 72 65 64 2e 20 20 54 68 65 20 6e 61 6d 65 2f 76 red. The name/v 1200: 61 6c 75 65 20 70 61 69 72 73 20 66 6f 72 20 61 alue pairs for a 1210: 20 74 69 63 6b 65 74 20 61 72 65 20 70 61 72 74 ticket are part 1220: 20 6f 66 20 67 6c 6f 62 61 6c 20 73 74 61 74 65 of global state 1230: 2c 0a 62 75 74 20 74 68 65 20 69 6e 74 65 72 70 ,.but the interp 1240: 72 65 74 61 74 69 6f 6e 20 61 6e 64 20 64 69 73 retation and dis 1250: 70 6c 61 79 20 6f 66 20 74 68 61 74 20 69 6e 66 play of that inf 1260: 6f 72 6d 61 74 69 6f 6e 20 69 73 20 6c 6f 63 61 ormation is loca 1270: 6c 20 73 74 61 74 65 2e 0a 48 65 6e 63 65 2c 20 l state..Hence, 1280: 65 61 63 68 20 72 65 70 6f 73 69 74 6f 72 79 20 each repository 1290: 69 73 20 66 72 65 65 20 74 6f 20 73 65 74 20 75 is free to set u 12a0: 70 20 69 74 73 20 6f 77 6e 20 74 69 63 6b 65 74 p its own ticket 12b0: 20 64 69 73 70 6c 61 79 20 61 6e 64 0a 69 6e 70 display and.inp 12c0: 75 74 20 66 6f 72 6d 61 74 73 20 61 6e 64 20 72 ut formats and r 12d0: 65 70 6f 72 74 69 6e 67 20 72 75 6c 65 73 20 61 eporting rules a 12e0: 63 63 6f 72 64 69 6e 67 20 74 6f 20 69 74 73 20 ccording to its 12f0: 6f 77 6e 20 70 61 72 74 69 63 75 6c 61 72 20 6e own particular n 1300: 65 65 64 73 2e 0a 0a 45 61 63 68 20 72 65 70 6f eeds...Each repo 1310: 73 69 74 6f 72 79 20 64 65 66 69 6e 65 73 20 69 sitory defines i 1320: 74 73 20 6f 77 6e 20 54 49 43 4b 45 54 20 74 61 ts own TICKET ta 1330: 62 6c 65 20 69 6e 20 69 74 73 20 64 61 74 61 62 ble in its datab 1340: 61 73 65 2e 20 20 54 68 65 72 65 20 69 73 0a 6f ase. There is.o 1350: 6e 65 20 72 6f 77 20 69 6e 20 74 68 65 20 54 49 ne row in the TI 1360: 43 4b 45 54 20 74 61 62 6c 65 20 66 6f 72 20 65 CKET table for e 1370: 61 63 68 20 75 6e 69 71 75 65 20 74 69 63 6b 65 ach unique ticke 1380: 74 20 49 44 2e 20 20 54 68 65 0a 6e 61 6d 65 73 t ID. The.names 1390: 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 of columns in t 13a0: 68 65 20 54 49 43 4b 45 54 20 74 61 62 6c 65 20 he TICKET table 13b0: 63 6f 72 72 65 73 70 6f 6e 64 20 74 6f 20 74 68 correspond to th 13c0: 65 20 6e 61 6d 65 73 20 69 6e 0a 74 68 65 20 6e e names in.the n 13d0: 61 6d 65 2f 76 61 6c 75 65 20 70 61 69 72 73 20 ame/value pairs 13e0: 6f 66 20 74 69 63 6b 65 74 20 63 68 61 6e 67 65 of ticket change 13f0: 20 61 72 74 69 66 61 63 74 73 2e 20 20 57 68 65 artifacts. Whe 1400: 6e 20 72 75 6e 6e 69 6e 67 20 74 68 65 20 72 65 n running the re 1410: 70 6c 61 79 0a 61 6c 67 6f 72 69 74 68 6d 2c 20 play.algorithm, 1420: 69 66 20 61 20 6e 61 6d 65 2f 76 61 6c 75 65 20 if a name/value 1430: 70 61 69 72 20 69 73 20 73 65 65 6e 20 77 68 69 pair is seen whi 1440: 63 68 20 68 61 73 20 6e 6f 20 63 6f 72 72 65 73 ch has no corres 1450: 70 6f 6e 64 69 6e 67 20 63 6f 6c 75 6d 6e 0a 69 ponding column.i 1460: 6e 20 74 68 65 20 54 49 43 4b 45 54 20 74 61 62 n the TICKET tab 1470: 6c 65 2c 20 74 68 65 6e 20 74 68 61 74 20 6e 61 le, then that na 1480: 6d 65 2f 76 61 6c 75 65 20 70 61 69 72 20 69 73 me/value pair is 1490: 20 69 67 6e 6f 72 65 64 2e 20 20 43 6f 6c 75 6d ignored. Colum 14a0: 6e 73 20 63 61 6e 0a 62 65 20 61 64 64 65 64 20 ns can.be added 14b0: 6f 72 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d 20 or removed from 14c0: 74 68 65 20 54 49 43 4b 45 54 20 74 61 62 6c 65 the TICKET table 14d0: 20 61 74 20 61 6e 79 20 74 69 6d 65 2e 20 20 57 at any time. W 14e0: 68 65 6e 65 76 65 72 20 74 68 65 0a 54 49 43 4b henever the.TICK 14f0: 45 54 20 74 61 62 6c 65 20 69 73 20 6d 6f 64 69 ET table is modi 1500: 66 69 65 64 2c 20 74 68 65 20 72 65 70 6c 61 79 fied, the replay 1510: 20 61 6c 67 6f 72 69 74 68 6d 20 61 75 74 6f 6d algorithm autom 1520: 61 74 69 63 61 6c 6c 79 20 72 65 72 75 6e 73 0a atically reruns. 1530: 74 6f 20 72 65 70 6f 70 75 6c 61 74 65 20 74 68 to repopulate th 1540: 65 20 74 61 62 6c 65 20 75 73 69 6e 67 20 74 68 e table using th 1550: 65 20 6e 65 77 20 63 6f 6c 75 6d 6e 20 6e 61 6d e new column nam 1560: 65 73 2e 20 20 4e 6f 74 65 20 74 68 61 74 20 74 es. Note that t 1570: 68 65 20 54 49 43 4b 45 54 0a 74 61 62 6c 65 20 he TICKET.table 1580: 73 63 68 65 6d 61 20 61 6e 64 20 63 6f 6e 74 65 schema and conte 1590: 6e 74 20 69 73 20 70 61 72 74 20 6f 66 20 74 68 nt is part of th 15a0: 65 20 6c 6f 63 61 6c 20 73 74 61 74 65 20 6f 66 e local state of 15b0: 20 61 20 72 65 73 70 6f 73 69 74 6f 72 79 0a 61 a respository.a 15c0: 6e 64 20 69 73 20 6e 6f 74 20 73 68 61 72 65 64 nd is not shared 15d0: 20 77 69 74 68 20 6f 74 68 65 72 20 72 65 70 6f with other repo 15e0: 73 69 74 6f 72 69 65 73 20 64 75 72 69 6e 67 20 sitories during 15f0: 61 20 73 79 6e 63 2c 20 70 75 73 68 2c 20 6f 72 a sync, push, or 1600: 20 70 75 6c 6c 2e 0a 0a 45 61 63 68 20 72 65 70 pull...Each rep 1610: 6f 73 69 74 6f 72 79 20 61 6c 73 6f 20 64 65 66 ository also def 1620: 69 6e 65 73 20 73 63 72 69 70 74 73 20 75 73 65 ines scripts use 1630: 64 20 74 6f 20 67 65 6e 65 72 61 74 65 20 77 65 d to generate we 1640: 62 20 70 61 67 65 73 20 66 6f 72 0a 63 72 65 61 b pages for.crea 1650: 74 69 6e 67 20 6e 65 77 20 74 69 63 6b 65 74 73 ting new tickets 1660: 2c 20 76 69 65 77 69 6e 67 20 65 78 69 73 74 69 , viewing existi 1670: 6e 67 20 74 69 63 6b 65 74 73 2c 20 61 6e 64 20 ng tickets, and 1680: 6d 6f 64 69 66 79 69 6e 67 20 61 6e 0a 65 78 69 modifying an.exi 1690: 73 74 69 6e 67 20 74 69 63 6b 65 74 2e 20 20 54 sting ticket. T 16a0: 68 65 73 65 20 73 63 72 69 70 74 73 20 63 6f 6e hese scripts con 16b0: 73 69 73 74 20 6f 66 20 48 54 4d 4c 20 77 69 74 sist of HTML wit 16c0: 68 20 61 6e 20 65 6d 62 65 64 64 65 64 0a 73 63 h an embedded.sc 16d0: 72 69 70 74 73 20 77 72 69 74 74 65 6e 20 61 6e ripts written an 16e0: 20 61 20 54 43 4c 2d 6c 69 6b 65 20 6c 61 6e 67 a TCL-like lang 16f0: 75 61 67 65 20 63 61 6c 6c 65 64 20 22 54 48 31 uage called "TH1 1700: 22 2e 20 20 45 76 65 72 79 20 6e 65 77 20 66 6f ". Every new fo 1710: 73 73 69 6c 0a 72 65 70 6f 73 69 74 6f 72 79 20 ssil.repository 1720: 69 73 20 63 72 65 61 74 65 64 20 77 69 74 68 20 is created with 1730: 64 65 66 61 75 6c 74 20 73 63 72 69 70 74 73 2e default scripts. 1740: 20 20 54 68 65 72 65 20 69 73 20 63 75 72 72 65 There is curre 1750: 6e 74 6c 79 20 6e 6f 0a 64 6f 63 75 6d 65 6e 74 ntly no.document 1760: 61 74 69 6f 6e 20 6f 6e 20 74 68 65 20 54 48 31 ation on the TH1 1770: 20 6c 61 6e 67 61 75 61 67 65 2e 20 20 41 64 6d langauage. Adm 1780: 69 6e 69 73 74 72 61 74 6f 72 73 20 77 69 73 68 inistrators wish 1790: 69 6e 67 20 74 6f 0a 63 75 73 74 6f 6d 69 7a 65 ing to.customize 17a0: 20 74 68 65 69 72 20 74 69 63 6b 65 74 20 65 6e their ticket en 17b0: 74 72 79 2c 20 76 69 65 77 69 6e 67 2c 20 61 6e try, viewing, an 17c0: 64 20 65 64 69 74 69 6e 67 20 73 63 72 65 65 6e d editing screen 17d0: 73 20 73 68 6f 75 6c 64 0a 6d 6f 64 69 66 79 20 s should.modify 17e0: 74 68 65 20 64 65 66 61 75 6c 74 20 73 63 72 69 the default scri 17f0: 70 74 73 20 74 6f 20 73 75 69 74 20 74 68 65 69 pts to suit thei 1800: 72 20 6e 65 65 64 73 2e 20 20 54 68 65 73 65 20 r needs. These 1810: 73 63 72 65 65 6e 20 67 65 6e 65 72 61 74 6f 72 screen generator 1820: 0a 73 63 72 69 70 74 73 20 61 72 65 20 70 61 72 .scripts are par 1830: 74 20 6f 66 20 74 68 65 20 6c 6f 63 61 6c 20 73 t of the local s 1840: 74 61 74 65 20 6f 66 20 61 20 72 65 70 6f 73 69 tate of a reposi 1850: 74 6f 72 79 20 61 6e 64 20 61 72 65 20 6e 6f 74 tory and are not 1860: 20 73 68 61 72 65 64 0a 77 69 74 68 20 6f 74 68 shared.with oth 1870: 65 72 20 72 65 70 6f 73 69 74 6f 72 69 65 73 20 er repositories 1880: 64 75 72 69 6e 67 20 61 20 73 79 6e 63 2c 20 70 during a sync, p 1890: 75 73 68 2c 20 6f 72 20 70 75 6c 6c 2e 0a 0a 3c ush, or pull...< 18a0: 69 3e 54 6f 20 62 65 20 63 6f 6e 74 69 6e 75 65 i>To be continue 18b0: 64 2e 2e 2e 3c 2f 69 3e 0a d...</i>.