Artifact 6a29c06018b431febcc09b5c9b7efb8fbff16d2e:
File www/bugtheory.wiki part of check-in [6ecc392f1c] - Updated documentation to indicate that bug-tracking is now available. Preliminary documentation on bug-tracking. (Much more documentation is needed - also need documentation on how the wiki works.) by drh on 2008-07-20 17:37:10.
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 64 20 74 69 63 ithms shared tic 06d0: 6b 65 74 20 63 68 61 6e 67 65 20 61 72 74 69 66 ket change artif 06e0: 61 63 74 73 0a 62 65 74 77 65 65 6e 20 72 65 70 acts.between rep 06f0: 6f 73 69 74 6f 72 69 65 73 20 69 6e 20 74 68 65 ositories in the 0700: 20 73 61 6d 65 20 77 61 79 20 61 73 20 65 76 65 same way as eve 0710: 72 79 20 6f 74 68 65 72 20 61 72 74 69 66 61 63 ry other artifac 0720: 74 2e 20 20 49 6e 20 66 61 63 74 2c 0a 74 68 65 t. In fact,.the 0730: 20 73 79 6e 63 20 61 6c 67 6f 72 69 74 68 6d 20 sync algorithm 0740: 68 61 73 20 6e 6f 20 6b 6e 6f 77 6c 65 64 67 65 has no knowledge 0750: 20 6f 66 20 74 68 65 20 6d 65 61 6e 69 6e 67 20 of the meaning 0760: 6f 66 20 74 68 65 20 61 72 74 69 66 61 63 74 73 of the artifacts 0770: 20 69 74 0a 69 73 20 73 79 6e 63 69 6e 67 2e 20 it.is syncing. 0780: 20 41 73 20 66 61 72 20 61 73 20 74 68 65 20 73 As far as the s 0790: 79 6e 63 20 61 6c 67 6f 72 69 74 68 6d 20 69 73 ync algorithm is 07a0: 20 63 6f 6e 63 65 72 6e 65 64 2c 20 61 6c 6c 20 concerned, all 07b0: 61 72 74 69 66 61 63 74 73 20 61 72 65 0a 61 6c artifacts are.al 07c0: 69 6b 65 2e 20 20 41 66 74 65 72 20 74 68 65 20 ike. After the 07d0: 73 79 6e 63 20 68 61 73 20 6f 63 63 75 72 73 2c sync has occurs, 07e0: 20 74 68 65 20 69 6e 64 69 76 69 64 75 61 6c 20 the individual 07f0: 72 65 70 6f 73 69 74 6f 72 69 65 73 20 6d 75 73 repositories mus 0800: 74 20 74 72 79 0a 74 6f 20 6d 61 6b 65 20 73 65 t try.to make se 0810: 6e 73 65 20 6f 66 20 74 68 65 20 6d 65 61 6e 69 nse of the meani 0820: 6e 67 20 6f 66 20 74 68 65 20 76 61 72 69 6f 75 ng of the variou 0830: 73 20 61 72 74 69 66 61 63 74 73 20 66 6f 72 20 s artifacts for 0840: 74 68 65 6d 73 65 6c 76 65 73 2e 0a 0a 3c 68 32 themselves...<h2 0850: 3e 49 6e 74 65 72 70 72 65 74 61 74 69 6f 6e 20 >Interpretation 0860: 4f 66 20 54 69 63 6b 65 74 20 43 68 61 6e 67 65 Of Ticket Change 0870: 20 41 72 74 69 66 61 63 74 73 3c 2f 68 32 3e 0a Artifacts</h2>. 0880: 0a 45 76 65 72 79 20 74 69 63 6b 65 74 20 63 68 .Every ticket ch 0890: 61 6e 67 65 20 61 72 74 69 66 61 63 74 20 63 6f ange artifact co 08a0: 6e 74 61 69 6e 73 20 28 61 6d 6f 6e 67 20 6f 74 ntains (among ot 08b0: 68 65 72 20 74 68 69 6e 67 73 29 0a 0a 20 20 2a her things).. * 08c0: 20 20 61 20 74 69 6d 65 73 74 61 6d 70 2c 0a 20 a timestamp,. 08d0: 20 2a 20 20 61 20 74 69 63 6b 65 74 20 55 55 49 * a ticket UUI 08e0: 44 2c 20 61 6e 64 0a 20 20 2a 20 20 6f 6e 65 20 D, and. * one 08f0: 6f 72 20 6d 6f 72 65 20 6e 61 6d 65 2f 76 61 6c or more name/val 0900: 75 65 20 70 61 69 72 73 2e 0a 0a 54 68 65 20 63 ue pairs...The c 0910: 75 72 72 65 6e 74 20 73 74 61 74 65 20 6f 66 20 urrent state of 0920: 61 20 74 69 63 6b 65 74 20 69 73 20 66 6f 75 6e a ticket is foun 0930: 64 20 62 79 20 72 65 70 6c 61 79 69 6e 67 20 61 d by replaying a 0940: 6c 6c 20 74 69 63 6b 65 74 0a 63 68 61 6e 67 65 ll ticket.change 0950: 20 61 72 74 69 66 61 63 74 73 20 77 69 74 68 20 artifacts with 0960: 74 68 65 20 73 61 6d 65 20 74 69 63 6b 65 74 20 the same ticket 0970: 55 55 49 44 20 69 6e 20 74 69 6d 65 73 74 61 6d UUID in timestam 0980: 70 20 6f 72 64 65 72 2e 0a 46 6f 72 20 61 20 67 p order..For a g 0990: 69 76 65 6e 20 74 69 63 6b 65 74 2c 20 61 6c 6c iven ticket, all 09a0: 20 76 61 6c 75 65 73 20 61 72 65 20 69 6e 69 74 values are init 09b0: 69 61 6c 6c 79 20 4e 55 4c 4c 2e 20 20 41 73 20 ially NULL. As 09c0: 65 61 63 68 0a 74 69 63 6b 65 74 20 63 68 61 6e each.ticket chan 09d0: 67 65 20 61 72 74 69 66 61 63 74 20 69 73 20 65 ge artifact is e 09e0: 6e 63 6f 75 6e 74 65 72 65 64 2c 20 76 61 6c 75 ncountered, valu 09f0: 65 73 20 61 72 65 20 65 69 74 68 65 72 20 72 65 es are either re 0a00: 70 6c 61 63 65 64 0a 6f 72 20 61 70 70 65 6e 64 placed.or append 0a10: 65 64 2c 20 61 63 63 6f 72 64 69 6e 67 20 74 6f ed, according to 0a20: 20 61 20 66 6c 61 67 20 6f 6e 20 74 68 65 20 6e a flag on the n 0a30: 61 6d 65 2f 76 61 6c 75 65 20 70 61 69 72 2e 20 ame/value pair. 0a40: 20 54 68 65 20 63 75 72 72 65 6e 74 0a 76 61 6c The current.val 0a50: 75 65 73 20 66 6f 72 20 74 68 65 20 66 69 65 6c ues for the fiel 0a60: 64 73 20 6f 66 20 61 20 74 69 63 6b 65 74 20 61 ds of a ticket a 0a70: 72 65 20 74 68 65 20 76 61 6c 75 65 73 20 74 68 re the values th 0a80: 61 74 20 72 65 6d 61 69 6e 20 61 74 20 74 68 65 at remain at the 0a90: 0a 65 6e 64 20 6f 66 20 74 68 65 20 72 65 70 6c .end of the repl 0aa0: 61 79 20 70 72 6f 63 65 73 73 2e 0a 0a 54 6f 20 ay process...To 0ab0: 63 72 65 61 74 65 20 61 20 6e 65 77 20 74 69 63 create a new tic 0ac0: 6b 65 74 2c 20 6f 6e 20 68 61 73 20 6d 65 72 65 ket, on has mere 0ad0: 6c 79 20 74 6f 20 69 6e 73 65 72 74 20 61 20 74 ly to insert a t 0ae0: 69 63 6b 65 74 20 63 68 61 6e 67 65 0a 61 72 74 icket change.art 0af0: 69 66 61 63 74 20 77 69 74 68 20 61 20 72 61 6e ifact with a ran 0b00: 64 6f 6d 6c 79 20 67 65 6e 65 72 61 74 65 64 20 domly generated 0b10: 74 69 63 6b 65 74 20 55 55 49 44 2e 20 20 54 68 ticket UUID. Th 0b20: 65 20 74 69 63 6b 65 74 20 55 55 49 44 0a 69 73 e ticket UUID.is 0b30: 20 61 20 72 61 6e 64 6f 6d 20 34 30 2d 63 68 61 a random 40-cha 0b40: 72 61 63 74 65 72 20 6c 6f 77 65 72 2d 63 61 73 racter lower-cas 0b50: 65 20 68 65 78 61 64 65 63 69 6d 61 6c 20 6e 75 e hexadecimal nu 0b60: 6d 62 65 72 2e 20 20 4e 65 77 0a 74 69 63 6b 65 mber. New.ticke 0b70: 74 20 55 55 49 44 73 20 73 68 6f 75 6c 64 20 62 t UUIDs should b 0b80: 65 20 63 68 6f 73 65 6e 20 75 73 69 6e 67 20 67 e chosen using g 0b90: 6f 6f 64 20 72 61 6e 64 6f 6d 6e 65 73 73 20 73 ood randomness s 0ba0: 6f 20 74 68 61 74 20 74 77 6f 0a 6f 72 65 20 6d o that two.ore m 0bb0: 6f 72 65 20 75 73 65 72 73 20 64 6f 20 6e 6f 74 ore users do not 0bc0: 20 61 63 63 69 64 65 6e 74 6c 79 20 63 61 75 73 accidently caus 0bd0: 65 20 61 20 63 6f 6e 66 6c 69 63 74 20 62 79 20 e a conflict by 0be0: 67 65 6e 65 72 61 74 69 6e 67 0a 74 68 65 20 73 generating.the s 0bf0: 61 6d 65 20 55 55 49 44 2e 20 20 54 68 65 20 6e ame UUID. The n 0c00: 61 6d 65 2f 76 61 6c 75 65 20 70 61 69 72 73 20 ame/value pairs 0c10: 6f 6e 20 74 68 65 20 69 6e 69 74 69 61 6c 20 74 on the initial t 0c20: 69 63 6b 65 74 20 63 68 61 6e 67 65 0a 61 72 74 icket change.art 0c30: 69 66 61 63 74 20 61 72 65 20 74 68 65 20 69 6e ifact are the in 0c40: 69 74 69 61 6c 20 76 61 6c 75 65 73 20 66 6f 72 itial values for 0c50: 20 74 68 65 20 66 69 65 6c 64 73 20 69 6e 20 74 the fields in t 0c60: 68 65 20 74 69 63 6b 65 74 2e 0a 0a 41 6d 65 6e he ticket...Amen 0c70: 64 69 6e 67 20 61 20 74 69 63 6b 65 74 20 6d 65 ding a ticket me 0c80: 61 6e 73 20 73 69 6d 70 6c 79 20 63 72 65 61 74 ans simply creat 0c90: 69 6e 67 20 61 20 6e 65 77 20 61 72 74 69 66 61 ing a new artifa 0ca0: 63 74 20 77 69 74 68 20 74 68 65 0a 73 61 6d 65 ct with the.same 0cb0: 20 74 69 63 6b 65 74 20 55 55 49 44 20 61 6e 64 ticket UUID and 0cc0: 20 77 69 74 68 20 6e 61 6d 65 2f 76 61 6c 75 65 with name/value 0cd0: 20 70 61 69 72 73 20 66 6f 72 20 74 68 6f 73 65 pairs for those 0ce0: 20 66 69 65 6c 64 73 20 77 68 69 63 68 0a 61 72 fields which.ar 0cf0: 65 20 63 68 61 6e 67 69 6e 67 2e 20 20 46 69 65 e changing. Fie 0d00: 6c 64 73 20 6f 66 20 74 68 65 20 74 69 63 6b 65 lds of the ticke 0d10: 74 20 77 68 69 63 68 20 61 72 65 20 6e 6f 74 20 t which are not 0d20: 62 65 69 6e 67 20 6d 6f 64 69 66 69 65 64 0a 73 being modified.s 0d30: 68 6f 75 6c 64 20 6e 6f 74 20 61 70 70 65 61 72 hould not appear 0d40: 20 61 73 20 6e 61 6d 65 2f 76 61 6c 75 65 20 70 as name/value p 0d50: 61 69 72 73 20 69 6e 20 74 68 65 20 6e 65 77 20 airs in the new 0d60: 61 72 74 69 66 61 63 74 2e 0a 0a 54 68 69 73 20 artifact...This 0d70: 61 70 70 72 6f 61 63 68 20 74 6f 20 73 74 6f 72 approach to stor 0d80: 69 6e 67 20 74 69 63 6b 65 74 20 73 74 61 74 65 ing ticket state 0d90: 20 6d 65 61 6e 73 20 74 68 61 74 20 69 6e 64 65 means that inde 0da0: 70 65 6e 64 65 6e 74 6c 79 20 65 6e 74 65 72 65 pendently entere 0db0: 64 0a 63 68 61 6e 67 65 73 20 61 72 65 20 61 75 d.changes are au 0dc0: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 6d 65 72 67 tomatically merg 0dd0: 65 64 20 74 6f 67 65 74 68 65 72 20 77 68 65 6e ed together when 0de0: 20 61 72 74 69 66 61 63 74 73 20 61 72 65 20 73 artifacts are s 0df0: 68 61 72 65 64 0a 62 65 74 77 65 65 6e 20 72 65 hared.between re 0e00: 70 6f 73 69 74 6f 72 69 65 73 2e 20 20 54 69 63 positories. Tic 0e10: 6b 65 74 73 20 64 6f 20 6e 6f 74 20 62 72 61 6e kets do not bran 0e20: 63 68 2e 20 20 54 68 69 73 20 61 70 70 72 6f 61 ch. This approa 0e30: 63 68 20 61 6c 73 6f 20 6d 61 6b 65 73 0a 69 74 ch also makes.it 0e40: 20 74 72 69 76 69 61 6c 20 74 6f 20 74 72 61 63 trivial to trac 0e50: 6b 20 74 68 65 20 68 69 73 74 6f 72 69 63 20 70 k the historic p 0e60: 72 6f 67 72 65 73 73 69 6f 6e 20 6f 66 20 63 68 rogression of ch 0e70: 61 6e 67 65 73 20 74 6f 20 61 20 74 69 63 6b 65 anges to a ticke 0e80: 74 2e 0a 0a 49 6e 20 6f 72 64 65 72 20 66 6f 72 t...In order for 0e90: 20 74 68 69 73 20 73 63 68 65 6d 65 20 74 6f 20 this scheme to 0ea0: 77 6f 72 6b 2c 20 74 68 65 20 73 79 73 74 65 6d work, the system 0eb0: 20 63 6c 6f 63 6b 73 20 6f 6e 20 6d 61 63 68 69 clocks on machi 0ec0: 6e 65 73 20 74 68 61 74 0a 61 64 64 20 6e 65 77 nes that.add new 0ed0: 20 74 69 63 6b 65 74 20 63 68 61 6e 67 65 73 20 ticket changes 0ee0: 61 72 74 69 66 61 63 74 73 20 68 61 76 65 20 74 artifacts have t 0ef0: 6f 20 62 65 20 73 65 74 20 63 6c 6f 73 65 20 74 o be set close t 0f00: 6f 20 72 65 61 6c 69 74 79 2e 0a 49 74 20 69 73 o reality..It is 0f10: 20 4f 4b 20 66 6f 72 20 61 20 74 69 63 6b 65 74 OK for a ticket 0f20: 20 63 68 61 6e 67 65 20 61 72 74 69 66 61 63 74 change artifact 0f30: 20 74 69 6d 65 73 74 61 6d 70 20 74 6f 20 62 65 timestamp to be 0f40: 20 6f 66 66 20 62 79 20 61 20 66 65 77 0a 6d 69 off by a few.mi 0f50: 6e 75 74 65 73 20 6f 72 20 65 76 65 6e 20 61 20 nutes or even a 0f60: 66 65 77 20 68 6f 75 72 73 2e 20 20 42 75 74 20 few hours. But 0f70: 69 66 20 61 20 74 69 6d 65 73 74 61 6d 70 20 6f if a timestamp o 0f80: 6e 20 61 20 74 69 63 6b 65 74 20 63 68 61 6e 67 n a ticket chang 0f90: 65 0a 61 72 74 69 66 61 63 74 20 69 73 20 6f 66 e.artifact is of 0fa0: 66 20 62 79 20 6d 6f 6e 74 68 73 20 6f 72 20 79 f by months or y 0fb0: 65 61 72 73 2c 20 69 74 20 63 61 6e 20 73 65 72 ears, it can ser 0fc0: 69 6f 75 73 6c 79 20 63 6f 6e 66 75 73 65 20 74 iously confuse t 0fd0: 68 65 0a 72 65 70 6c 61 79 20 61 6c 67 6f 72 69 he.replay algori 0fe0: 74 68 6d 20 66 6f 72 20 64 65 74 65 72 6d 69 6e thm for determin 0ff0: 69 6e 67 20 74 68 65 20 63 75 72 72 65 6e 74 20 ing the current 1000: 74 69 63 6b 65 74 20 73 74 61 74 65 2e 20 20 54 ticket state. T 1010: 68 65 72 65 0a 61 72 65 20 74 65 63 68 6e 69 71 here.are techniq 1020: 75 65 73 20 61 76 61 69 6c 61 62 6c 65 20 74 6f ues available to 1030: 20 63 61 75 73 65 20 72 6f 67 75 65 20 61 72 74 cause rogue art 1040: 69 66 61 63 74 73 20 74 6f 20 62 65 20 69 67 6e ifacts to be ign 1050: 6f 72 65 64 0a 62 79 20 66 6f 73 73 69 6c 2e 20 ored.by fossil. 1060: 20 53 6f 20 69 66 20 61 20 74 69 63 6b 65 74 20 So if a ticket 1070: 63 68 61 6e 67 65 20 61 72 74 69 66 61 63 74 20 change artifact 1080: 77 69 74 68 20 61 20 62 61 64 20 74 69 6d 65 73 with a bad times 1090: 74 61 6d 70 0a 64 6f 65 73 20 67 65 74 20 69 6e tamp.does get in 10a0: 74 6f 20 61 20 72 65 70 6f 73 69 74 6f 72 79 2c to a repository, 10b0: 20 69 74 20 63 61 6e 20 62 65 20 72 65 6d 6f 76 it can be remov 10c0: 65 64 20 62 79 20 61 6e 20 61 64 6d 69 6e 73 74 ed by an adminst 10d0: 72 61 74 6f 72 2e 0a 42 75 74 20 74 68 65 20 62 rator..But the b 10e0: 65 73 74 20 61 70 70 72 6f 61 63 68 20 69 73 20 est approach is 10f0: 74 6f 20 74 61 6b 65 20 73 74 65 70 73 20 74 6f to take steps to 1100: 20 69 6e 73 75 72 65 20 74 68 61 74 20 74 69 6d insure that tim 1110: 65 73 74 61 6d 70 73 0a 61 72 65 20 61 70 70 72 estamps.are appr 1120: 6f 78 69 6d 61 74 65 6c 79 20 63 6f 72 72 65 63 oximately correc 1130: 74 20 69 6e 20 74 68 65 20 66 69 72 73 74 20 70 t in the first p 1140: 6c 61 63 65 2e 0a 0a 3c 68 32 3e 4c 6f 63 61 6c lace...<h2>Local 1150: 20 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3c 2f Configuration</ 1160: 68 32 3e 0a 0a 54 68 65 20 74 69 63 6b 65 74 20 h2>..The ticket 1170: 63 68 61 6e 67 65 20 61 72 74 69 66 61 63 74 73 change artifacts 1180: 20 61 72 65 20 70 61 72 74 20 6f 66 20 74 68 65 are part of the 1190: 20 67 6c 6f 62 61 6c 20 73 74 61 74 65 20 66 6f global state fo 11a0: 72 20 61 20 70 72 6f 6a 65 63 74 2e 0a 54 68 65 r a project..The 11b0: 20 67 6c 6f 62 61 6c 20 73 74 61 74 65 20 69 73 global state is 11c0: 20 74 68 61 74 20 77 68 69 63 68 20 69 73 20 73 that which is s 11d0: 68 61 72 65 64 20 62 65 74 77 65 65 6e 20 72 65 hared between re 11e0: 70 6f 73 69 74 6f 72 69 65 73 20 64 75 72 69 6e positories durin 11f0: 67 0a 61 20 73 79 6e 63 2e 20 20 45 61 63 68 20 g.a sync. Each 1200: 72 65 70 6f 73 69 74 6f 72 79 20 61 6c 73 6f 20 repository also 1210: 68 61 73 20 6c 6f 63 61 6c 20 73 74 61 74 65 20 has local state 1220: 77 68 69 63 68 20 69 73 20 6e 6f 74 20 28 6e 6f which is not (no 1230: 72 6d 61 6c 6c 79 29 0a 73 68 61 72 65 64 2e 20 rmally).shared. 1240: 20 54 68 65 20 6e 61 6d 65 2f 76 61 6c 75 65 20 The name/value 1250: 70 61 69 72 73 20 66 6f 72 20 61 20 74 69 63 6b pairs for a tick 1260: 65 74 20 61 72 65 20 70 61 72 74 20 6f 66 20 67 et are part of g 1270: 6c 6f 62 61 6c 20 73 74 61 74 65 2c 0a 62 75 74 lobal state,.but 1280: 20 74 68 65 20 69 6e 74 65 72 70 72 65 74 61 74 the interpretat 1290: 69 6f 6e 20 61 6e 64 20 64 69 73 70 6c 61 79 20 ion and display 12a0: 6f 66 20 74 68 61 74 20 69 6e 66 6f 72 6d 61 74 of that informat 12b0: 69 6f 6e 20 69 73 20 6c 6f 63 61 6c 20 73 74 61 ion is local sta 12c0: 74 65 2e 0a 48 65 6e 63 65 2c 20 65 61 63 68 20 te..Hence, each 12d0: 72 65 70 6f 73 69 74 6f 72 79 20 69 73 20 66 72 repository is fr 12e0: 65 65 20 74 6f 20 73 65 74 20 75 70 20 69 74 73 ee to set up its 12f0: 20 6f 77 6e 20 74 69 63 6b 65 74 20 64 69 73 70 own ticket disp 1300: 6c 61 79 20 61 6e 64 0a 69 6e 70 75 74 20 66 6f lay and.input fo 1310: 72 6d 61 74 73 20 61 6e 64 20 72 65 70 6f 72 74 rmats and report 1320: 69 6e 67 20 72 75 6c 65 73 20 61 63 63 6f 72 64 ing rules accord 1330: 69 6e 67 20 74 6f 20 69 74 73 20 6f 77 6e 20 70 ing to its own p 1340: 61 72 74 69 63 75 6c 61 72 20 6e 65 65 64 73 2e articular needs. 1350: 0a 0a 45 61 63 68 20 72 65 70 6f 73 69 74 6f 72 ..Each repositor 1360: 79 20 64 65 66 69 6e 65 73 20 69 74 73 20 6f 77 y defines its ow 1370: 6e 20 54 49 43 4b 45 54 20 74 61 62 6c 65 20 69 n TICKET table i 1380: 6e 20 69 74 73 20 64 61 74 61 62 61 73 65 2e 20 n its database. 1390: 20 54 68 65 72 65 20 69 73 0a 6f 6e 65 20 72 6f There is.one ro 13a0: 77 20 69 6e 20 74 68 65 20 54 49 43 4b 45 54 20 w in the TICKET 13b0: 74 61 62 6c 65 20 66 6f 72 20 65 61 63 68 20 75 table for each u 13c0: 6e 69 71 75 65 20 74 69 63 6b 65 74 20 55 55 49 nique ticket UUI 13d0: 44 2e 20 20 54 68 65 0a 6e 61 6d 65 73 20 6f 66 D. The.names of 13e0: 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 columns in the 13f0: 54 49 43 4b 45 54 20 74 61 62 6c 65 20 63 6f 72 TICKET table cor 1400: 72 65 73 70 6f 6e 64 20 74 6f 20 74 68 65 20 6e respond to the n 1410: 61 6d 65 73 20 69 6e 0a 74 68 65 20 6e 61 6d 65 ames in.the name 1420: 2f 76 61 6c 75 65 20 70 61 69 72 73 20 6f 66 20 /value pairs of 1430: 74 69 63 6b 65 74 20 63 68 61 6e 67 65 20 61 72 ticket change ar 1440: 74 69 66 61 63 74 73 2e 20 20 57 68 65 6e 20 72 tifacts. When r 1450: 75 6e 6e 69 6e 67 20 74 68 65 20 72 65 70 6c 61 unning the repla 1460: 79 0a 61 6c 67 6f 72 69 74 68 6d 2c 20 69 66 20 y.algorithm, if 1470: 61 20 6e 61 6d 65 2f 76 61 6c 75 65 20 70 61 69 a name/value pai 1480: 72 20 69 73 20 73 65 65 6e 20 77 68 69 63 68 20 r is seen which 1490: 68 61 73 20 6e 6f 20 63 6f 72 72 65 73 70 6f 6e has no correspon 14a0: 64 69 6e 67 20 63 6f 6c 75 6d 6e 0a 69 6e 20 74 ding column.in t 14b0: 68 65 20 54 49 43 4b 45 54 20 74 61 62 6c 65 2c he TICKET table, 14c0: 20 74 68 65 6e 20 74 68 61 74 20 6e 61 6d 65 2f then that name/ 14d0: 76 61 6c 75 65 20 70 61 69 72 20 69 73 20 69 67 value pair is ig 14e0: 6e 6f 72 65 64 2e 0a 0a 45 61 63 68 20 72 65 70 nored...Each rep 14f0: 6f 73 69 74 6f 72 79 20 61 6c 73 6f 20 64 65 66 ository also def 1500: 69 6e 65 73 20 73 63 72 69 70 74 73 20 75 73 65 ines scripts use 1510: 64 20 74 6f 20 67 65 6e 65 72 61 74 65 20 77 65 d to generate we 1520: 62 20 70 61 67 65 73 20 66 6f 72 0a 63 72 65 61 b pages for.crea 1530: 74 69 6e 67 20 6e 65 77 20 74 69 63 6b 65 74 73 ting new tickets 1540: 2c 20 76 69 65 77 69 6e 67 20 65 78 69 73 74 69 , viewing existi 1550: 6e 67 20 74 69 63 6b 65 74 73 2c 20 61 6e 64 20 ng tickets, and 1560: 6d 6f 64 69 66 79 69 6e 67 20 61 6e 0a 65 78 69 modifying an.exi 1570: 73 74 69 6e 67 20 74 69 63 6b 65 74 2e 20 20 54 sting ticket. T 1580: 68 65 73 65 20 73 63 72 69 70 74 73 20 63 6f 6e hese scripts con 1590: 73 69 73 74 20 6f 66 20 48 54 4d 4c 20 77 69 74 sist of HTML wit 15a0: 68 20 61 6e 20 65 6d 62 65 64 64 65 64 0a 73 63 h an embedded.sc 15b0: 72 69 70 74 73 20 77 72 69 74 74 65 6e 20 61 6e ripts written an 15c0: 20 61 20 54 43 4c 2d 6c 69 6b 65 20 6c 61 6e 67 a TCL-like lang 15d0: 75 61 67 65 20 63 61 6c 6c 65 64 20 22 54 48 31 uage called "TH1 15e0: 22 2e 20 20 45 61 63 68 20 66 6f 73 73 69 6c 0a ". Each fossil. 15f0: 72 65 70 6f 73 69 74 6f 72 79 20 69 73 20 63 72 repository is cr 1600: 65 61 74 65 20 77 69 74 68 20 64 65 66 61 75 6c eate with defaul 1610: 74 20 73 63 72 69 70 74 73 2e 20 20 54 68 65 72 t scripts. Ther 1620: 65 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 6e e is currently n 1630: 6f 0a 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 o.documentation 1640: 6f 6e 20 74 68 65 20 54 48 31 20 6c 61 6e 67 61 on the TH1 langa 1650: 75 61 67 65 2e 20 20 41 64 6d 69 6e 69 73 74 72 uage. Administr 1660: 61 74 6f 72 73 20 77 69 73 68 69 6e 67 20 74 6f ators wishing to 1670: 0a 63 75 73 74 6f 6d 69 7a 65 20 74 68 65 69 72 .customize their 1680: 20 74 69 63 6b 65 74 20 65 6e 74 72 79 2c 20 76 ticket entry, v 1690: 69 65 77 69 6e 67 2c 20 61 6e 64 20 65 64 69 74 iewing, and edit 16a0: 69 6e 67 20 73 63 72 65 65 6e 73 20 73 68 6f 75 ing screens shou 16b0: 6c 64 0a 6d 6f 64 69 66 79 20 74 68 65 20 64 65 ld.modify the de 16c0: 66 61 75 6c 74 20 73 63 72 69 70 74 73 20 74 6f fault scripts to 16d0: 20 73 75 69 74 20 74 68 65 69 72 20 6e 65 65 64 suit their need 16e0: 73 2e 0a s..