Artifact 5f6ed2b26bd0a1680ba70da8b04c78eafc40b272:
File www/bugtheory.wiki part of check-in [7083eb1a1c] - Change the markup in the index.wiki page from HTML to wiki. Extend the wikitheory.wiki page. Other documentation tweaks. by drh on 2008-11-20 03:14:22.
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 62 65 20 6e 6f 20 77 re would be no w 0230: 61 79 20 74 6f 20 61 64 64 0a 20 20 20 20 20 20 ay to add. 0240: 6e 65 77 20 74 69 63 6b 65 74 73 20 74 6f 20 61 new tickets to a 0250: 20 63 68 65 63 6b 2d 69 6e 20 61 73 20 6e 65 77 check-in as new 0260: 20 62 75 67 73 20 61 72 65 20 64 69 73 63 6f 76 bugs are discov 0270: 65 72 65 64 2e 0a 0a 20 20 32 2e 20 20 41 6e 79 ered... 2. Any 0280: 20 70 72 6f 6a 65 63 74 20 6f 66 20 72 65 61 73 project of reas 0290: 6f 6e 61 62 6c 65 20 73 69 7a 65 20 61 6e 64 20 onable size and 02a0: 63 6f 6d 70 6c 65 78 69 74 79 20 77 69 6c 6c 20 complexity will 02b0: 67 65 6e 65 72 61 74 65 20 74 68 6f 75 73 61 6e generate thousan 02c0: 64 73 0a 20 20 20 20 20 20 61 6e 64 20 74 68 6f ds. and tho 02d0: 75 73 61 6e 64 73 20 6f 66 20 74 69 63 6b 65 74 usands of ticket 02e0: 73 2c 20 61 6e 64 20 77 65 20 64 6f 20 6e 6f 74 s, and we do not 02f0: 20 77 61 6e 74 20 61 6c 6c 20 74 68 6f 73 65 20 want all those 0300: 74 69 63 6b 65 74 20 66 69 6c 65 73 0a 20 20 20 ticket files. 0310: 20 20 20 63 6c 75 74 74 65 72 69 6e 67 20 74 68 cluttering th 0320: 65 20 73 6f 75 72 63 65 20 74 72 65 65 2e 0a 0a e source tree... 0330: 20 20 33 2e 20 20 57 65 20 77 61 6e 74 20 74 69 3. We want ti 0340: 63 6b 65 74 73 20 74 6f 20 62 65 20 6d 61 6e 61 ckets to be mana 0350: 67 65 64 20 66 72 6f 6d 20 74 68 65 20 77 65 62 ged from the web 0360: 20 69 6e 74 65 72 66 61 63 65 20 61 6e 64 20 74 interface and t 0370: 6f 20 68 61 76 65 20 61 0a 20 20 20 20 20 20 70 o have a. p 0380: 65 72 6d 69 73 73 69 6f 6e 20 73 79 73 74 65 6d ermission system 0390: 20 74 68 61 74 20 69 73 20 64 69 73 74 69 6e 63 that is distinc 03a0: 74 20 66 72 6f 6d 20 63 68 65 63 6b 2d 69 6e 20 t from check-in 03b0: 70 65 72 6d 69 73 73 69 6f 6e 73 2e 0a 20 20 20 permissions.. 03c0: 20 20 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 In other word 03d0: 73 2c 20 77 65 20 64 6f 20 6e 6f 74 20 77 61 6e s, we do not wan 03e0: 74 20 74 6f 20 72 65 73 74 72 69 63 74 20 74 68 t to restrict th 03f0: 65 20 63 72 65 61 74 69 6f 6e 20 61 6e 64 20 65 e creation and e 0400: 64 69 74 69 6e 67 0a 20 20 20 20 20 20 6f 66 20 diting. of 0410: 74 69 63 6b 65 74 73 20 74 6f 20 64 65 76 65 6c tickets to devel 0420: 6f 70 65 72 73 20 77 69 74 68 20 63 68 65 63 6b opers with check 0430: 2d 69 6e 20 70 72 69 76 69 6c 65 67 65 73 20 61 -in privileges a 0440: 6e 64 20 61 6e 20 69 6e 73 74 61 6c 6c 65 64 0a nd an installed. 0450: 20 20 20 20 20 20 63 6f 70 79 20 6f 66 20 74 68 copy of th 0460: 65 20 66 6f 73 73 69 6c 20 65 78 65 63 75 74 61 e fossil executa 0470: 62 6c 65 2e 20 20 43 61 73 75 61 6c 20 70 61 73 ble. Casual pas 0480: 73 65 72 73 2d 62 79 20 6f 6e 20 74 68 65 20 69 sers-by on the i 0490: 6e 74 65 72 6e 65 74 20 73 68 6f 75 6c 64 0a 20 nternet should. 04a0: 20 20 20 20 20 62 65 20 70 65 72 6d 69 74 74 65 be permitte 04b0: 64 20 74 6f 20 63 72 65 61 74 65 20 74 69 63 6b d to create tick 04c0: 65 74 73 2e 0a 0a 52 65 63 61 6c 6c 20 74 68 61 ets...Recall tha 04d0: 74 20 61 20 66 6f 73 73 69 6c 20 72 65 70 6f 73 t a fossil repos 04e0: 69 74 6f 72 79 20 63 6f 6e 73 69 73 74 73 20 6f itory consists o 04f0: 66 20 61 6e 0a 75 6e 6f 72 64 65 72 65 64 20 63 f an.unordered c 0500: 6f 6c 6c 65 63 74 69 6f 6e 20 6f 66 20 3c 69 3e ollection of <i> 0510: 61 72 74 69 66 61 63 74 73 3c 2f 69 3e 2e 20 20 artifacts</i>. 0520: 28 53 65 65 20 74 68 65 0a 3c 61 20 68 72 65 66 (See the.<a href 0530: 3d 22 66 69 6c 65 66 6f 72 6d 61 74 2e 77 69 6b ="fileformat.wik 0540: 69 22 3e 66 69 6c 65 20 66 6f 72 6d 61 74 20 64 i">file format d 0550: 6f 63 75 6d 65 6e 74 3c 2f 61 3e 20 66 6f 72 20 ocument</a> for 0560: 64 65 74 61 69 6c 73 2e 29 0a 53 6f 6d 65 20 61 details.).Some a 0570: 72 74 69 66 61 63 74 73 20 68 61 76 65 20 61 20 rtifacts have a 0580: 73 70 65 63 69 61 6c 20 66 6f 72 6d 61 74 2c 20 special format, 0590: 61 6e 64 20 61 6d 6f 6e 67 20 74 68 6f 73 65 20 and among those 05a0: 61 72 65 0a 3c 61 20 68 72 65 66 3d 22 66 69 6c are.<a href="fil 05b0: 65 66 6f 72 6d 61 74 2e 77 69 6b 69 23 74 6b 74 eformat.wiki#tkt 05c0: 63 68 6e 67 22 3e 54 69 63 6b 65 74 20 43 68 61 chng">Ticket Cha 05d0: 6e 67 65 20 41 72 74 69 66 61 63 74 73 3c 2f 61 nge Artifacts</a 05e0: 3e 2e 0a 4f 6e 65 20 6f 72 20 6d 6f 72 65 20 74 >..One or more t 05f0: 69 63 6b 65 74 20 63 68 61 6e 67 65 20 61 72 74 icket change art 0600: 69 66 61 63 74 73 20 61 72 65 20 61 73 73 6f 63 ifacts are assoc 0610: 69 61 74 65 64 20 77 69 74 68 20 65 61 63 68 20 iated with each 0620: 0a 74 69 63 6b 65 74 2e 20 20 41 20 74 69 63 6b .ticket. A tick 0630: 65 74 20 69 73 20 63 72 65 61 74 65 64 20 62 79 et is created by 0640: 20 61 20 74 69 63 6b 65 74 20 63 68 61 6e 67 65 a ticket change 0650: 20 61 72 74 69 66 61 63 74 2e 0a 45 61 63 68 20 artifact..Each 0660: 73 75 62 73 65 71 75 65 6e 74 20 6d 6f 64 69 66 subsequent modif 0670: 69 63 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 74 ication of the t 0680: 69 63 6b 65 74 20 69 73 20 61 20 73 65 70 61 72 icket is a separ 0690: 61 74 65 20 61 72 74 69 66 61 63 74 2e 0a 0a 54 ate artifact...T 06a0: 68 65 20 22 70 75 73 68 22 2c 20 22 70 75 6c 6c he "push", "pull 06b0: 22 2c 20 61 6e 64 20 22 73 79 6e 63 22 20 61 6c ", and "sync" al 06c0: 67 6f 72 69 74 68 6d 73 20 73 68 61 72 65 20 74 gorithms share t 06d0: 69 63 6b 65 74 20 63 68 61 6e 67 65 20 61 72 74 icket change art 06e0: 69 66 61 63 74 73 0a 62 65 74 77 65 65 6e 20 72 ifacts.between r 06f0: 65 70 6f 73 69 74 6f 72 69 65 73 20 69 6e 20 74 epositories in t 0700: 68 65 20 73 61 6d 65 20 77 61 79 20 61 73 20 65 he same way as e 0710: 76 65 72 79 20 6f 74 68 65 72 20 61 72 74 69 66 very other artif 0720: 61 63 74 2e 20 20 49 6e 20 66 61 63 74 2c 0a 74 act. In fact,.t 0730: 68 65 20 73 79 6e 63 20 61 6c 67 6f 72 69 74 68 he sync algorith 0740: 6d 20 68 61 73 20 6e 6f 20 6b 6e 6f 77 6c 65 64 m has no knowled 0750: 67 65 20 6f 66 20 74 68 65 20 6d 65 61 6e 69 6e ge of the meanin 0760: 67 20 6f 66 20 74 68 65 20 61 72 74 69 66 61 63 g of the artifac 0770: 74 73 20 69 74 0a 69 73 20 73 79 6e 63 69 6e 67 ts it.is syncing 0780: 2e 20 20 41 73 20 66 61 72 20 61 73 20 74 68 65 . As far as the 0790: 20 73 79 6e 63 20 61 6c 67 6f 72 69 74 68 6d 20 sync algorithm 07a0: 69 73 20 63 6f 6e 63 65 72 6e 65 64 2c 20 61 6c is concerned, al 07b0: 6c 20 61 72 74 69 66 61 63 74 73 20 61 72 65 0a l artifacts are. 07c0: 61 6c 69 6b 65 2e 20 20 41 66 74 65 72 20 74 68 alike. After th 07d0: 65 20 73 79 6e 63 20 68 61 73 20 6f 63 63 75 72 e sync has occur 07e0: 73 2c 20 74 68 65 20 69 6e 64 69 76 69 64 75 61 s, the individua 07f0: 6c 20 72 65 70 6f 73 69 74 6f 72 69 65 73 20 6d l repositories m 0800: 75 73 74 0a 6d 61 6b 65 20 73 65 6e 73 65 20 6f ust.make sense o 0810: 66 20 74 68 65 20 6d 65 61 6e 69 6e 67 20 6f 66 f the meaning of 0820: 20 74 68 65 20 76 61 72 69 6f 75 73 20 61 72 74 the various art 0830: 69 66 61 63 74 73 20 66 6f 72 20 74 68 65 6d 73 ifacts for thems 0840: 65 6c 76 65 73 2e 0a 0a 3c 68 32 3e 49 6e 74 65 elves...<h2>Inte 0850: 72 70 72 65 74 61 74 69 6f 6e 20 4f 66 20 54 69 rpretation Of Ti 0860: 63 6b 65 74 20 43 68 61 6e 67 65 20 41 72 74 69 cket Change Arti 0870: 66 61 63 74 73 3c 2f 68 32 3e 0a 0a 45 76 65 72 facts</h2>..Ever 0880: 79 20 74 69 63 6b 65 74 20 63 68 61 6e 67 65 20 y ticket change 0890: 61 72 74 69 66 61 63 74 20 63 6f 6e 74 61 69 6e artifact contain 08a0: 73 20 28 61 6d 6f 6e 67 20 6f 74 68 65 72 20 74 s (among other t 08b0: 68 69 6e 67 73 29 0a 0a 20 20 2a 20 20 61 20 74 hings).. * a t 08c0: 69 6d 65 73 74 61 6d 70 2c 0a 20 20 2a 20 20 61 imestamp,. * a 08d0: 20 74 69 63 6b 65 74 20 49 44 2c 20 61 6e 64 0a ticket ID, and. 08e0: 20 20 2a 20 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 * one or more 08f0: 20 6e 61 6d 65 2f 76 61 6c 75 65 20 70 61 69 72 name/value pair 0900: 73 2e 0a 0a 54 68 65 20 63 75 72 72 65 6e 74 20 s...The current 0910: 73 74 61 74 65 20 6f 66 20 61 20 74 69 63 6b 65 state of a ticke 0920: 74 20 69 73 20 66 6f 75 6e 64 20 62 79 20 72 65 t is found by re 0930: 70 6c 61 79 69 6e 67 20 61 6c 6c 20 74 69 63 6b playing all tick 0940: 65 74 0a 63 68 61 6e 67 65 20 61 72 74 69 66 61 et.change artifa 0950: 63 74 73 20 77 69 74 68 20 74 68 65 20 73 61 6d cts with the sam 0960: 65 20 74 69 63 6b 65 74 20 49 44 20 69 6e 20 74 e ticket ID in t 0970: 69 6d 65 73 74 61 6d 70 20 6f 72 64 65 72 2e 0a imestamp order.. 0980: 46 6f 72 20 61 20 67 69 76 65 6e 20 74 69 63 6b For a given tick 0990: 65 74 2c 20 61 6c 6c 20 76 61 6c 75 65 73 20 61 et, all values a 09a0: 72 65 20 69 6e 69 74 69 61 6c 6c 79 20 4e 55 4c re initially NUL 09b0: 4c 2e 20 20 41 73 20 65 61 63 68 0a 74 69 63 6b L. As each.tick 09c0: 65 74 20 63 68 61 6e 67 65 20 61 72 74 69 66 61 et change artifa 09d0: 63 74 20 69 73 20 65 6e 63 6f 75 6e 74 65 72 65 ct is encountere 09e0: 64 2c 20 76 61 6c 75 65 73 20 61 72 65 20 65 69 d, values are ei 09f0: 74 68 65 72 20 72 65 70 6c 61 63 65 64 0a 6f 72 ther replaced.or 0a00: 20 61 70 70 65 6e 64 65 64 2c 20 61 63 63 6f 72 appended, accor 0a10: 64 69 6e 67 20 74 6f 20 61 20 66 6c 61 67 20 6f ding to a flag o 0a20: 6e 20 74 68 65 20 6e 61 6d 65 2f 76 61 6c 75 65 n the name/value 0a30: 20 70 61 69 72 2e 20 20 54 68 65 20 63 75 72 72 pair. The curr 0a40: 65 6e 74 0a 76 61 6c 75 65 73 20 66 6f 72 20 74 ent.values for t 0a50: 68 65 20 66 69 65 6c 64 73 20 6f 66 20 61 20 74 he fields of a t 0a60: 69 63 6b 65 74 20 61 72 65 20 74 68 65 20 76 61 icket are the va 0a70: 6c 75 65 73 20 74 68 61 74 20 72 65 6d 61 69 6e lues that remain 0a80: 20 61 74 20 74 68 65 0a 65 6e 64 20 6f 66 20 74 at the.end of t 0a90: 68 65 20 72 65 70 6c 61 79 20 70 72 6f 63 65 73 he replay proces 0aa0: 73 2e 0a 0a 54 6f 20 63 72 65 61 74 65 20 61 20 s...To create a 0ab0: 6e 65 77 20 74 69 63 6b 65 74 2c 20 6f 6e 65 20 new ticket, one 0ac0: 69 6e 73 65 72 74 73 20 61 20 74 69 63 6b 65 74 inserts a ticket 0ad0: 20 63 68 61 6e 67 65 0a 61 72 74 69 66 61 63 74 change.artifact 0ae0: 20 77 69 74 68 20 61 20 6e 65 77 20 49 44 2e 20 with a new ID. 0af0: 20 54 68 65 20 74 69 63 6b 65 74 20 49 44 0a 69 The ticket ID.i 0b00: 73 20 61 20 72 61 6e 64 6f 6d 20 34 30 2d 63 68 s a random 40-ch 0b10: 61 72 61 63 74 65 72 20 6c 6f 77 65 72 2d 63 61 aracter lower-ca 0b20: 73 65 20 68 65 78 61 64 65 63 69 6d 61 6c 20 6e se hexadecimal n 0b30: 75 6d 62 65 72 2e 20 20 54 68 65 20 22 74 6b 74 umber. The "tkt 0b40: 6e 65 77 22 0a 70 61 67 65 20 69 6e 20 74 68 65 new".page in the 0b50: 20 66 6f 73 73 69 6c 20 77 65 62 20 69 6e 74 65 fossil web inte 0b60: 72 66 61 63 65 20 63 72 65 61 74 65 73 20 6e 65 rface creates ne 0b70: 77 20 74 69 63 6b 65 74 20 49 44 73 0a 75 73 69 w ticket IDs.usi 0b80: 6e 67 20 61 20 67 6f 6f 64 20 73 6f 75 72 63 65 ng a good source 0b90: 20 6f 66 20 72 61 6e 64 6f 6d 6e 65 73 73 20 74 of randomness t 0ba0: 6f 20 69 6e 73 75 72 65 20 75 6e 69 71 75 65 6e o insure uniquen 0bb0: 65 73 73 2e 0a 54 68 65 20 6e 61 6d 65 2f 76 61 ess..The name/va 0bc0: 6c 75 65 20 70 61 69 72 73 20 6f 6e 20 74 68 65 lue pairs on the 0bd0: 20 69 6e 69 74 69 61 6c 20 74 69 63 6b 65 74 20 initial ticket 0be0: 63 68 61 6e 67 65 0a 61 72 74 69 66 61 63 74 20 change.artifact 0bf0: 61 72 65 20 74 68 65 20 69 6e 69 74 69 61 6c 20 are the initial 0c00: 76 61 6c 75 65 73 20 66 6f 72 20 74 68 65 20 66 values for the f 0c10: 69 65 6c 64 73 20 69 6e 20 74 68 65 20 74 69 63 ields in the tic 0c20: 6b 65 74 2e 0a 0a 41 6d 65 6e 64 69 6e 67 20 61 ket...Amending a 0c30: 20 74 69 63 6b 65 74 20 6d 65 61 6e 73 20 73 69 ticket means si 0c40: 6d 70 6c 79 20 63 72 65 61 74 69 6e 67 20 61 20 mply creating a 0c50: 6e 65 77 20 61 72 74 69 66 61 63 74 20 77 69 74 new artifact wit 0c60: 68 20 74 68 65 0a 73 61 6d 65 20 74 69 63 6b 65 h the.same ticke 0c70: 74 20 49 44 20 61 6e 64 20 77 69 74 68 20 6e 61 t ID and with na 0c80: 6d 65 2f 76 61 6c 75 65 20 70 61 69 72 73 20 66 me/value pairs f 0c90: 6f 72 20 74 68 6f 73 65 20 66 69 65 6c 64 73 20 or those fields 0ca0: 77 68 69 63 68 0a 61 72 65 20 63 68 61 6e 67 69 which.are changi 0cb0: 6e 67 2e 20 20 46 69 65 6c 64 73 20 6f 66 20 74 ng. Fields of t 0cc0: 68 65 20 74 69 63 6b 65 74 20 77 68 69 63 68 20 he ticket which 0cd0: 61 72 65 20 6e 6f 74 20 62 65 69 6e 67 20 6d 6f are not being mo 0ce0: 64 69 66 69 65 64 0a 73 68 6f 75 6c 64 20 6e 6f dified.should no 0cf0: 74 20 61 70 70 65 61 72 20 61 73 20 6e 61 6d 65 t appear as name 0d00: 2f 76 61 6c 75 65 20 70 61 69 72 73 20 69 6e 20 /value pairs in 0d10: 74 68 65 20 6e 65 77 20 61 72 74 69 66 61 63 74 the new artifact 0d20: 2e 0a 0a 54 68 69 73 20 61 70 70 72 6f 61 63 68 ...This approach 0d30: 20 74 6f 20 73 74 6f 72 69 6e 67 20 74 69 63 6b to storing tick 0d40: 65 74 20 73 74 61 74 65 20 6d 65 61 6e 73 20 74 et state means t 0d50: 68 61 74 20 69 6e 64 65 70 65 6e 64 65 6e 74 6c hat independentl 0d60: 79 20 65 6e 74 65 72 65 64 0a 63 68 61 6e 67 65 y entered.change 0d70: 73 20 61 72 65 20 61 75 74 6f 6d 61 74 69 63 61 s are automatica 0d80: 6c 6c 79 20 6d 65 72 67 65 64 20 74 6f 67 65 74 lly merged toget 0d90: 68 65 72 20 77 68 65 6e 20 61 72 74 69 66 61 63 her when artifac 0da0: 74 73 20 61 72 65 20 73 68 61 72 65 64 0a 62 65 ts are shared.be 0db0: 74 77 65 65 6e 20 72 65 70 6f 73 69 74 6f 72 69 tween repositori 0dc0: 65 73 2e 20 20 54 69 63 6b 65 74 73 20 64 6f 20 es. Tickets do 0dd0: 6e 6f 74 20 62 72 61 6e 63 68 2e 20 20 54 68 69 not branch. Thi 0de0: 73 20 61 70 70 72 6f 61 63 68 20 61 6c 73 6f 20 s approach also 0df0: 6d 61 6b 65 73 0a 69 74 20 74 72 69 76 69 61 6c makes.it trivial 0e00: 20 74 6f 20 74 72 61 63 6b 20 74 68 65 20 68 69 to track the hi 0e10: 73 74 6f 72 69 63 20 70 72 6f 67 72 65 73 73 69 storic progressi 0e20: 6f 6e 20 6f 66 20 63 68 61 6e 67 65 73 20 74 6f on of changes to 0e30: 20 61 20 74 69 63 6b 65 74 2e 0a 0a 49 6e 20 6f a ticket...In o 0e40: 72 64 65 72 20 66 6f 72 20 74 68 69 73 20 73 63 rder for this sc 0e50: 68 65 6d 65 20 74 6f 20 77 6f 72 6b 2c 20 74 68 heme to work, th 0e60: 65 20 73 79 73 74 65 6d 20 63 6c 6f 63 6b 73 20 e system clocks 0e70: 6f 6e 20 6d 61 63 68 69 6e 65 73 20 74 68 61 74 on machines that 0e80: 0a 61 64 64 20 6e 65 77 20 74 69 63 6b 65 74 20 .add new ticket 0e90: 63 68 61 6e 67 65 73 20 61 72 74 69 66 61 63 74 changes artifact 0ea0: 73 20 68 61 76 65 20 74 6f 20 62 65 20 73 65 74 s have to be set 0eb0: 20 63 6c 6f 73 65 20 74 6f 20 72 65 61 6c 69 74 close to realit 0ec0: 79 2e 0a 49 74 20 69 73 20 4f 4b 20 66 6f 72 20 y..It is OK for 0ed0: 61 20 74 69 63 6b 65 74 20 63 68 61 6e 67 65 20 a ticket change 0ee0: 61 72 74 69 66 61 63 74 20 74 69 6d 65 73 74 61 artifact timesta 0ef0: 6d 70 20 74 6f 20 62 65 20 6f 66 66 20 62 79 20 mp to be off by 0f00: 61 20 66 65 77 0a 6d 69 6e 75 74 65 73 20 6f 72 a few.minutes or 0f10: 20 65 76 65 6e 20 61 20 66 65 77 20 68 6f 75 72 even a few hour 0f20: 73 2e 20 20 42 75 74 20 69 66 20 61 20 74 69 6d s. But if a tim 0f30: 65 73 74 61 6d 70 20 6f 6e 20 61 20 74 69 63 6b estamp on a tick 0f40: 65 74 20 63 68 61 6e 67 65 0a 61 72 74 69 66 61 et change.artifa 0f50: 63 74 20 69 73 20 6f 66 66 20 62 79 20 6d 6f 6e ct is off by mon 0f60: 74 68 73 20 6f 72 20 79 65 61 72 73 2c 20 69 74 ths or years, it 0f70: 20 63 61 6e 20 73 65 72 69 6f 75 73 6c 79 20 63 can seriously c 0f80: 6f 6e 66 75 73 65 20 74 68 65 0a 72 65 70 6c 61 onfuse the.repla 0f90: 79 20 61 6c 67 6f 72 69 74 68 6d 20 66 6f 72 20 y algorithm for 0fa0: 64 65 74 65 72 6d 69 6e 69 6e 67 20 74 68 65 20 determining the 0fb0: 63 75 72 72 65 6e 74 20 74 69 63 6b 65 74 20 73 current ticket s 0fc0: 74 61 74 65 2e 20 20 54 68 65 72 65 0a 61 72 65 tate. There.are 0fd0: 20 74 65 63 68 6e 69 71 75 65 73 20 61 76 61 69 techniques avai 0fe0: 6c 61 62 6c 65 20 74 6f 20 63 61 75 73 65 20 72 lable to cause r 0ff0: 6f 67 75 65 20 61 72 74 69 66 61 63 74 73 20 74 ogue artifacts t 1000: 6f 20 62 65 20 69 67 6e 6f 72 65 64 0a 62 79 20 o be ignored.by 1010: 66 6f 73 73 69 6c 2e 20 20 53 6f 20 69 66 20 61 fossil. So if a 1020: 20 74 69 63 6b 65 74 20 63 68 61 6e 67 65 20 61 ticket change a 1030: 72 74 69 66 61 63 74 20 77 69 74 68 20 61 20 62 rtifact with a b 1040: 61 64 20 74 69 6d 65 73 74 61 6d 70 0a 64 6f 65 ad timestamp.doe 1050: 73 20 67 65 74 20 69 6e 74 6f 20 61 20 72 65 70 s get into a rep 1060: 6f 73 69 74 6f 72 79 2c 20 69 74 20 63 61 6e 20 ository, it can 1070: 62 65 20 72 65 6d 6f 76 65 64 20 62 79 20 61 6e be removed by an 1080: 20 61 64 6d 69 6e 69 73 74 72 61 74 6f 72 2e 0a administrator.. 1090: 42 75 74 20 74 68 65 20 62 65 73 74 20 61 70 70 But the best app 10a0: 72 6f 61 63 68 20 69 73 20 74 6f 20 74 61 6b 65 roach is to take 10b0: 20 73 74 65 70 73 20 74 6f 20 69 6e 73 75 72 65 steps to insure 10c0: 20 74 68 61 74 20 74 69 6d 65 73 74 61 6d 70 73 that timestamps 10d0: 0a 61 72 65 20 61 70 70 72 6f 78 69 6d 61 74 65 .are approximate 10e0: 6c 79 20 63 6f 72 72 65 63 74 20 69 6e 20 74 68 ly correct in th 10f0: 65 20 66 69 72 73 74 20 70 6c 61 63 65 2e 0a 0a e first place... 1100: 3c 68 32 3e 4c 6f 63 61 6c 20 43 6f 6e 66 69 67 <h2>Local Config 1110: 75 72 61 74 69 6f 6e 3c 2f 68 32 3e 0a 0a 54 68 uration</h2>..Th 1120: 65 20 74 69 63 6b 65 74 20 63 68 61 6e 67 65 20 e ticket change 1130: 61 72 74 69 66 61 63 74 73 20 61 72 65 20 70 61 artifacts are pa 1140: 72 74 20 6f 66 20 74 68 65 20 67 6c 6f 62 61 6c rt of the global 1150: 20 73 74 61 74 65 20 66 6f 72 20 61 20 70 72 6f state for a pro 1160: 6a 65 63 74 2e 0a 54 68 65 20 67 6c 6f 62 61 6c ject..The global 1170: 20 73 74 61 74 65 20 69 73 20 74 68 61 74 20 77 state is that w 1180: 68 69 63 68 20 69 73 20 73 68 61 72 65 64 20 62 hich is shared b 1190: 65 74 77 65 65 6e 20 72 65 70 6f 73 69 74 6f 72 etween repositor 11a0: 69 65 73 20 64 75 72 69 6e 67 0a 61 20 73 79 6e ies during.a syn 11b0: 63 2e 20 20 45 61 63 68 20 72 65 70 6f 73 69 74 c. Each reposit 11c0: 6f 72 79 20 61 6c 73 6f 20 68 61 73 20 6c 6f 63 ory also has loc 11d0: 61 6c 20 73 74 61 74 65 20 77 68 69 63 68 20 69 al state which i 11e0: 73 20 6e 6f 74 20 28 6e 6f 72 6d 61 6c 6c 79 29 s not (normally) 11f0: 0a 73 68 61 72 65 64 2e 20 20 54 68 65 20 6e 61 .shared. The na 1200: 6d 65 2f 76 61 6c 75 65 20 70 61 69 72 73 20 66 me/value pairs f 1210: 6f 72 20 61 20 74 69 63 6b 65 74 20 61 72 65 20 or a ticket are 1220: 70 61 72 74 20 6f 66 20 67 6c 6f 62 61 6c 20 73 part of global s 1230: 74 61 74 65 2c 0a 62 75 74 20 74 68 65 20 69 6e tate,.but the in 1240: 74 65 72 70 72 65 74 61 74 69 6f 6e 20 61 6e 64 terpretation and 1250: 20 64 69 73 70 6c 61 79 20 6f 66 20 74 68 61 74 display of that 1260: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 73 20 information is 1270: 6c 6f 63 61 6c 20 73 74 61 74 65 2e 0a 48 65 6e local state..Hen 1280: 63 65 2c 20 65 61 63 68 20 72 65 70 6f 73 69 74 ce, each reposit 1290: 6f 72 79 20 69 73 20 66 72 65 65 20 74 6f 20 73 ory is free to s 12a0: 65 74 20 75 70 20 69 74 73 20 6f 77 6e 20 74 69 et up its own ti 12b0: 63 6b 65 74 20 64 69 73 70 6c 61 79 20 61 6e 64 cket display and 12c0: 0a 69 6e 70 75 74 20 66 6f 72 6d 61 74 73 20 61 .input formats a 12d0: 6e 64 20 72 65 70 6f 72 74 69 6e 67 20 72 75 6c nd reporting rul 12e0: 65 73 20 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 es according to 12f0: 69 74 73 20 6f 77 6e 20 70 61 72 74 69 63 75 6c its own particul 1300: 61 72 20 6e 65 65 64 73 2e 0a 0a 45 61 63 68 20 ar needs...Each 1310: 72 65 70 6f 73 69 74 6f 72 79 20 64 65 66 69 6e repository defin 1320: 65 73 20 69 74 73 20 6f 77 6e 20 54 49 43 4b 45 es its own TICKE 1330: 54 20 74 61 62 6c 65 20 69 6e 20 69 74 73 20 64 T table in its d 1340: 61 74 61 62 61 73 65 2e 20 20 54 68 65 72 65 20 atabase. There 1350: 69 73 0a 6f 6e 65 20 72 6f 77 20 69 6e 20 74 68 is.one row in th 1360: 65 20 54 49 43 4b 45 54 20 74 61 62 6c 65 20 66 e TICKET table f 1370: 6f 72 20 65 61 63 68 20 75 6e 69 71 75 65 20 74 or each unique t 1380: 69 63 6b 65 74 20 49 44 2e 20 20 54 68 65 0a 6e icket ID. The.n 1390: 61 6d 65 73 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 ames of columns 13a0: 69 6e 20 74 68 65 20 54 49 43 4b 45 54 20 74 61 in the TICKET ta 13b0: 62 6c 65 20 63 6f 72 72 65 73 70 6f 6e 64 20 74 ble correspond t 13c0: 6f 20 74 68 65 20 6e 61 6d 65 73 20 69 6e 0a 74 o the names in.t 13d0: 68 65 20 6e 61 6d 65 2f 76 61 6c 75 65 20 70 61 he name/value pa 13e0: 69 72 73 20 6f 66 20 74 69 63 6b 65 74 20 63 68 irs of ticket ch 13f0: 61 6e 67 65 20 61 72 74 69 66 61 63 74 73 2e 20 ange artifacts. 1400: 20 57 68 65 6e 20 72 75 6e 6e 69 6e 67 20 74 68 When running th 1410: 65 20 72 65 70 6c 61 79 0a 61 6c 67 6f 72 69 74 e replay.algorit 1420: 68 6d 2c 20 69 66 20 61 20 6e 61 6d 65 2f 76 61 hm, if a name/va 1430: 6c 75 65 20 70 61 69 72 20 69 73 20 73 65 65 6e lue pair is seen 1440: 20 77 68 69 63 68 20 68 61 73 20 6e 6f 20 63 6f which has no co 1450: 72 72 65 73 70 6f 6e 64 69 6e 67 20 63 6f 6c 75 rresponding colu 1460: 6d 6e 0a 69 6e 20 74 68 65 20 54 49 43 4b 45 54 mn.in the TICKET 1470: 20 74 61 62 6c 65 2c 20 74 68 65 6e 20 74 68 61 table, then tha 1480: 74 20 6e 61 6d 65 2f 76 61 6c 75 65 20 70 61 69 t name/value pai 1490: 72 20 69 73 20 69 67 6e 6f 72 65 64 2e 20 20 43 r is ignored. C 14a0: 6f 6c 75 6d 6e 73 20 63 61 6e 0a 62 65 20 61 64 olumns can.be ad 14b0: 64 65 64 20 6f 72 20 72 65 6d 6f 76 65 64 20 66 ded or removed f 14c0: 72 6f 6d 20 74 68 65 20 54 49 43 4b 45 54 20 74 rom the TICKET t 14d0: 61 62 6c 65 20 61 74 20 61 6e 79 20 74 69 6d 65 able at any time 14e0: 2e 20 20 57 68 65 6e 65 76 65 72 20 74 68 65 0a . Whenever the. 14f0: 54 49 43 4b 45 54 20 74 61 62 6c 65 20 69 73 20 TICKET table is 1500: 6d 6f 64 69 66 69 65 64 2c 20 74 68 65 20 72 65 modified, the re 1510: 70 6c 61 79 20 61 6c 67 6f 72 69 74 68 6d 20 61 play algorithm a 1520: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 72 65 72 utomatically rer 1530: 75 6e 73 0a 74 6f 20 72 65 70 6f 70 75 6c 61 74 uns.to repopulat 1540: 65 20 74 68 65 20 74 61 62 6c 65 20 75 73 69 6e e the table usin 1550: 67 20 74 68 65 20 6e 65 77 20 63 6f 6c 75 6d 6e g the new column 1560: 20 6e 61 6d 65 73 2e 20 20 4e 6f 74 65 20 74 68 names. Note th 1570: 61 74 20 74 68 65 20 54 49 43 4b 45 54 0a 74 61 at the TICKET.ta 1580: 62 6c 65 20 73 63 68 65 6d 61 20 61 6e 64 20 63 ble schema and c 1590: 6f 6e 74 65 6e 74 20 69 73 20 70 61 72 74 20 6f ontent is part o 15a0: 66 20 74 68 65 20 6c 6f 63 61 6c 20 73 74 61 74 f the local stat 15b0: 65 20 6f 66 20 61 20 72 65 70 6f 73 69 74 6f 72 e of a repositor 15c0: 79 0a 61 6e 64 20 69 73 20 6e 6f 74 20 73 68 61 y.and is not sha 15d0: 72 65 64 20 77 69 74 68 20 6f 74 68 65 72 20 72 red with other r 15e0: 65 70 6f 73 69 74 6f 72 69 65 73 20 64 75 72 69 epositories duri 15f0: 6e 67 20 61 20 73 79 6e 63 2c 20 70 75 73 68 2c ng a sync, push, 1600: 20 6f 72 20 70 75 6c 6c 2e 0a 0a 45 61 63 68 20 or pull...Each 1610: 72 65 70 6f 73 69 74 6f 72 79 20 61 6c 73 6f 20 repository also 1620: 64 65 66 69 6e 65 73 20 73 63 72 69 70 74 73 20 defines scripts 1630: 75 73 65 64 20 74 6f 20 67 65 6e 65 72 61 74 65 used to generate 1640: 20 77 65 62 20 70 61 67 65 73 20 66 6f 72 0a 63 web pages for.c 1650: 72 65 61 74 69 6e 67 20 6e 65 77 20 74 69 63 6b reating new tick 1660: 65 74 73 2c 20 76 69 65 77 69 6e 67 20 65 78 69 ets, viewing exi 1670: 73 74 69 6e 67 20 74 69 63 6b 65 74 73 2c 20 61 sting tickets, a 1680: 6e 64 20 6d 6f 64 69 66 79 69 6e 67 20 61 6e 0a nd modifying an. 1690: 65 78 69 73 74 69 6e 67 20 74 69 63 6b 65 74 2e existing ticket. 16a0: 20 20 54 68 65 73 65 20 73 63 72 69 70 74 73 20 These scripts 16b0: 63 6f 6e 73 69 73 74 20 6f 66 20 48 54 4d 4c 20 consist of HTML 16c0: 77 69 74 68 20 61 6e 20 65 6d 62 65 64 64 65 64 with an embedded 16d0: 0a 73 63 72 69 70 74 73 20 77 72 69 74 74 65 6e .scripts written 16e0: 20 61 6e 20 61 20 54 63 6c 2d 6c 69 6b 65 20 6c an a Tcl-like l 16f0: 61 6e 67 75 61 67 65 20 63 61 6c 6c 65 64 20 22 anguage called " 1700: 54 48 31 22 2e 20 20 45 76 65 72 79 20 6e 65 77 TH1". Every new 1710: 20 66 6f 73 73 69 6c 0a 72 65 70 6f 73 69 74 6f fossil.reposito 1720: 72 79 20 69 73 20 63 72 65 61 74 65 64 20 77 69 ry is created wi 1730: 74 68 20 64 65 66 61 75 6c 74 20 73 63 72 69 70 th default scrip 1740: 74 73 2e 20 20 54 68 65 72 65 20 69 73 20 63 75 ts. There is cu 1750: 72 72 65 6e 74 6c 79 20 6e 6f 0a 64 6f 63 75 6d rrently no.docum 1760: 65 6e 74 61 74 69 6f 6e 20 6f 6e 20 74 68 65 20 entation on the 1770: 54 48 31 20 6c 61 6e 67 75 61 67 65 2e 20 20 41 TH1 language. A 1780: 64 6d 69 6e 69 73 74 72 61 74 6f 72 73 20 77 69 dministrators wi 1790: 73 68 69 6e 67 20 74 6f 0a 63 75 73 74 6f 6d 69 shing to.customi 17a0: 7a 65 20 74 68 65 69 72 20 74 69 63 6b 65 74 20 ze their ticket 17b0: 65 6e 74 72 79 2c 20 76 69 65 77 69 6e 67 2c 20 entry, viewing, 17c0: 61 6e 64 20 65 64 69 74 69 6e 67 20 73 63 72 65 and editing scre 17d0: 65 6e 73 20 73 68 6f 75 6c 64 0a 6d 6f 64 69 66 ens should.modif 17e0: 79 20 74 68 65 20 64 65 66 61 75 6c 74 20 73 63 y the default sc 17f0: 72 69 70 74 73 20 74 6f 20 73 75 69 74 20 74 68 ripts to suit th 1800: 65 69 72 20 6e 65 65 64 73 2e 20 20 54 68 65 73 eir needs. Thes 1810: 65 20 73 63 72 65 65 6e 20 67 65 6e 65 72 61 74 e screen generat 1820: 6f 72 0a 73 63 72 69 70 74 73 20 61 72 65 20 70 or.scripts are p 1830: 61 72 74 20 6f 66 20 74 68 65 20 6c 6f 63 61 6c art of the local 1840: 20 73 74 61 74 65 20 6f 66 20 61 20 72 65 70 6f state of a repo 1850: 73 69 74 6f 72 79 20 61 6e 64 20 61 72 65 20 6e sitory and are n 1860: 6f 74 20 73 68 61 72 65 64 0a 77 69 74 68 20 6f ot shared.with o 1870: 74 68 65 72 20 72 65 70 6f 73 69 74 6f 72 69 65 ther repositorie 1880: 73 20 64 75 72 69 6e 67 20 61 20 73 79 6e 63 2c s during a sync, 1890: 20 70 75 73 68 2c 20 6f 72 20 70 75 6c 6c 2e 0a push, or pull.. 18a0: 0a 3c 69 3e 54 6f 20 62 65 20 63 6f 6e 74 69 6e .<i>To be contin 18b0: 75 65 64 2e 2e 2e 3c 2f 69 3e 0a ued...</i>.