Artifact b809c20d72cf39859dea9f23009b576799d1b806:
File www/bugtheory.wiki part of check-in [7a39dde24b] - Clean up and merge updates from trunk by robert on 2009-09-26 08:17:33. Also file www/bugtheory.wiki part of check-in [109114baf4] - Update documentation to include links to the mailing list and mailing list archives and to Paul Ruizendaal's TH1 documentation. by drh on 2009-09-21 15:08:49.
0000: 3c 74 69 74 6c 65 3e 46 6f 73 73 69 6c 20 44 6f <title>Fossil Do 0010: 63 75 6d 65 6e 74 61 74 69 6f 6e 3c 2f 74 69 74 cumentation</tit 0020: 6c 65 3e 0a 3c 68 31 3e 42 75 67 2d 54 72 61 63 le>.<h1>Bug-Trac 0030: 6b 69 6e 67 20 49 6e 20 3c 61 20 68 72 65 66 3d king In <a href= 0040: 22 69 6e 64 65 78 2e 77 69 6b 69 22 3e 46 6f 73 "index.wiki">Fos 0050: 73 69 6c 3c 2f 61 3e 3c 2f 68 31 3e 0a 0a 41 20 sil</a></h1>..A 0060: 62 75 67 2d 72 65 70 6f 72 74 20 69 6e 20 66 6f bug-report in fo 0070: 73 73 69 6c 20 69 73 20 63 61 6c 6c 65 64 20 61 ssil is called a 0080: 20 22 74 69 63 6b 65 74 22 2e 20 20 54 69 63 6b "ticket". Tick 0090: 65 74 73 20 61 72 65 20 74 72 61 63 6b 65 64 0a ets are tracked. 00a0: 73 65 70 61 72 61 74 65 6c 79 20 66 72 6f 6d 20 separately from 00b0: 63 6f 64 65 20 63 68 65 63 6b 2d 69 6e 73 2e 0a code check-ins.. 00c0: 0a 53 6f 6d 65 20 6f 74 68 65 72 20 64 69 73 74 .Some other dist 00d0: 72 69 62 75 74 65 64 20 62 75 67 2d 74 72 61 63 ributed bug-trac 00e0: 6b 69 6e 67 20 73 79 73 74 65 6d 73 20 73 74 6f king systems sto 00f0: 72 65 20 74 69 63 6b 65 74 73 20 61 73 20 66 69 re tickets as fi 0100: 6c 65 73 20 77 69 74 68 69 6e 0a 74 68 65 20 73 les within.the s 0110: 6f 75 72 63 65 20 74 72 65 65 20 61 6e 64 20 74 ource tree and t 0120: 68 65 72 65 62 79 20 6c 65 76 65 72 61 67 65 20 hereby leverage 0130: 74 68 65 20 73 79 6e 63 69 6e 67 20 61 6e 64 20 the syncing and 0140: 6d 65 72 67 69 6e 67 20 63 61 70 61 62 69 6c 69 merging capabili 0150: 74 69 65 73 0a 6f 66 20 74 68 65 20 76 65 72 73 ties.of the vers 0160: 69 6f 6e 69 6e 67 20 73 79 73 74 65 6d 20 74 6f ioning system to 0170: 20 73 79 6e 63 20 61 6e 64 20 6d 65 72 67 65 20 sync and merge 0180: 74 69 63 6b 65 74 73 2e 20 20 54 68 69 73 20 61 tickets. This a 0190: 70 70 72 6f 61 63 68 20 69 73 0a 72 65 6a 65 63 pproach is.rejec 01a0: 74 65 64 20 69 6e 20 66 6f 73 73 69 6c 20 66 6f ted in fossil fo 01b0: 72 20 74 68 72 65 65 20 72 65 61 73 6f 6e 73 3a r three reasons: 01c0: 0a 0a 20 20 31 2e 20 20 43 68 65 63 6b 2d 69 6e .. 1. Check-in 01d0: 73 20 69 6e 20 66 6f 73 73 69 6c 20 61 72 65 20 s in fossil are 01e0: 69 6d 6d 75 74 61 62 6c 65 2e 20 20 53 6f 20 69 immutable. So i 01f0: 66 0a 20 20 20 20 20 20 74 69 63 6b 65 74 73 20 f. tickets 0200: 77 65 72 65 20 70 61 72 74 20 6f 66 20 74 68 65 were part of the 0210: 20 63 68 65 63 6b 2d 69 6e 2c 20 74 68 65 6e 20 check-in, then 0220: 74 68 65 72 65 20 77 6f 75 6c 64 20 62 65 20 6e there would be n 0230: 6f 20 77 61 79 20 74 6f 20 61 64 64 0a 20 20 20 o way to add. 0240: 20 20 20 6e 65 77 20 74 69 63 6b 65 74 73 20 74 new tickets t 0250: 6f 20 61 20 63 68 65 63 6b 2d 69 6e 20 61 73 20 o a check-in as 0260: 6e 65 77 20 62 75 67 73 20 61 72 65 20 64 69 73 new bugs are dis 0270: 63 6f 76 65 72 65 64 2e 0a 0a 20 20 32 2e 20 20 covered... 2. 0280: 41 6e 79 20 70 72 6f 6a 65 63 74 20 6f 66 20 72 Any project of r 0290: 65 61 73 6f 6e 61 62 6c 65 20 73 69 7a 65 20 61 easonable size a 02a0: 6e 64 20 63 6f 6d 70 6c 65 78 69 74 79 20 77 69 nd complexity wi 02b0: 6c 6c 20 67 65 6e 65 72 61 74 65 20 74 68 6f 75 ll generate thou 02c0: 73 61 6e 64 73 0a 20 20 20 20 20 20 61 6e 64 20 sands. and 02d0: 74 68 6f 75 73 61 6e 64 73 20 6f 66 20 74 69 63 thousands of tic 02e0: 6b 65 74 73 2c 20 61 6e 64 20 77 65 20 64 6f 20 kets, and we do 02f0: 6e 6f 74 20 77 61 6e 74 20 61 6c 6c 20 74 68 6f not want all tho 0300: 73 65 20 74 69 63 6b 65 74 20 66 69 6c 65 73 0a se ticket files. 0310: 20 20 20 20 20 20 63 6c 75 74 74 65 72 69 6e 67 cluttering 0320: 20 74 68 65 20 73 6f 75 72 63 65 20 74 72 65 65 the source tree 0330: 2e 0a 0a 20 20 33 2e 20 20 57 65 20 77 61 6e 74 ... 3. We want 0340: 20 74 69 63 6b 65 74 73 20 74 6f 20 62 65 20 6d tickets to be m 0350: 61 6e 61 67 65 64 20 66 72 6f 6d 20 74 68 65 20 anaged from the 0360: 77 65 62 20 69 6e 74 65 72 66 61 63 65 20 61 6e web interface an 0370: 64 20 74 6f 20 68 61 76 65 20 61 0a 20 20 20 20 d to have a. 0380: 20 20 70 65 72 6d 69 73 73 69 6f 6e 20 73 79 73 permission sys 0390: 74 65 6d 20 74 68 61 74 20 69 73 20 64 69 73 74 tem that is dist 03a0: 69 6e 63 74 20 66 72 6f 6d 20 63 68 65 63 6b 2d inct from check- 03b0: 69 6e 20 70 65 72 6d 69 73 73 69 6f 6e 73 2e 0a in permissions.. 03c0: 20 20 20 20 20 20 49 6e 20 6f 74 68 65 72 20 77 In other w 03d0: 6f 72 64 73 2c 20 77 65 20 64 6f 20 6e 6f 74 20 ords, we do not 03e0: 77 61 6e 74 20 74 6f 20 72 65 73 74 72 69 63 74 want to restrict 03f0: 20 74 68 65 20 63 72 65 61 74 69 6f 6e 20 61 6e the creation an 0400: 64 20 65 64 69 74 69 6e 67 0a 20 20 20 20 20 20 d editing. 0410: 6f 66 20 74 69 63 6b 65 74 73 20 74 6f 20 64 65 of tickets to de 0420: 76 65 6c 6f 70 65 72 73 20 77 69 74 68 20 63 68 velopers with ch 0430: 65 63 6b 2d 69 6e 20 70 72 69 76 69 6c 65 67 65 eck-in privilege 0440: 73 20 61 6e 64 20 61 6e 20 69 6e 73 74 61 6c 6c s and an install 0450: 65 64 0a 20 20 20 20 20 20 63 6f 70 79 20 6f 66 ed. copy of 0460: 20 74 68 65 20 66 6f 73 73 69 6c 20 65 78 65 63 the fossil exec 0470: 75 74 61 62 6c 65 2e 20 20 43 61 73 75 61 6c 20 utable. Casual 0480: 70 61 73 73 65 72 73 2d 62 79 20 6f 6e 20 74 68 passers-by on th 0490: 65 20 69 6e 74 65 72 6e 65 74 20 73 68 6f 75 6c e internet shoul 04a0: 64 0a 20 20 20 20 20 20 62 65 20 70 65 72 6d 69 d. be permi 04b0: 74 74 65 64 20 74 6f 20 63 72 65 61 74 65 20 74 tted to create t 04c0: 69 63 6b 65 74 73 2e 0a 0a 52 65 63 61 6c 6c 20 ickets...Recall 04d0: 74 68 61 74 20 61 20 66 6f 73 73 69 6c 20 72 65 that a fossil re 04e0: 70 6f 73 69 74 6f 72 79 20 63 6f 6e 73 69 73 74 pository consist 04f0: 73 20 6f 66 20 61 6e 0a 75 6e 6f 72 64 65 72 65 s of an.unordere 0500: 64 20 63 6f 6c 6c 65 63 74 69 6f 6e 20 6f 66 20 d collection of 0510: 3c 69 3e 61 72 74 69 66 61 63 74 73 3c 2f 69 3e <i>artifacts</i> 0520: 2e 20 20 28 53 65 65 20 74 68 65 0a 3c 61 20 68 . (See the.<a h 0530: 72 65 66 3d 22 66 69 6c 65 66 6f 72 6d 61 74 2e ref="fileformat. 0540: 77 69 6b 69 22 3e 66 69 6c 65 20 66 6f 72 6d 61 wiki">file forma 0550: 74 20 64 6f 63 75 6d 65 6e 74 3c 2f 61 3e 20 66 t document</a> f 0560: 6f 72 20 64 65 74 61 69 6c 73 2e 29 0a 53 6f 6d or details.).Som 0570: 65 20 61 72 74 69 66 61 63 74 73 20 68 61 76 65 e artifacts have 0580: 20 61 20 73 70 65 63 69 61 6c 20 66 6f 72 6d 61 a special forma 0590: 74 2c 20 61 6e 64 20 61 6d 6f 6e 67 20 74 68 6f t, and among tho 05a0: 73 65 20 61 72 65 0a 3c 61 20 68 72 65 66 3d 22 se are.<a href=" 05b0: 66 69 6c 65 66 6f 72 6d 61 74 2e 77 69 6b 69 23 fileformat.wiki# 05c0: 74 6b 74 63 68 6e 67 22 3e 54 69 63 6b 65 74 20 tktchng">Ticket 05d0: 43 68 61 6e 67 65 20 41 72 74 69 66 61 63 74 73 Change Artifacts 05e0: 3c 2f 61 3e 2e 0a 4f 6e 65 20 6f 72 20 6d 6f 72 </a>..One or mor 05f0: 65 20 74 69 63 6b 65 74 20 63 68 61 6e 67 65 20 e ticket change 0600: 61 72 74 69 66 61 63 74 73 20 61 72 65 20 61 73 artifacts are as 0610: 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 65 61 sociated with ea 0620: 63 68 20 0a 74 69 63 6b 65 74 2e 20 20 41 20 74 ch .ticket. A t 0630: 69 63 6b 65 74 20 69 73 20 63 72 65 61 74 65 64 icket is created 0640: 20 62 79 20 61 20 74 69 63 6b 65 74 20 63 68 61 by a ticket cha 0650: 6e 67 65 20 61 72 74 69 66 61 63 74 2e 0a 45 61 nge artifact..Ea 0660: 63 68 20 73 75 62 73 65 71 75 65 6e 74 20 6d 6f ch subsequent mo 0670: 64 69 66 69 63 61 74 69 6f 6e 20 6f 66 20 74 68 dification of th 0680: 65 20 74 69 63 6b 65 74 20 69 73 20 61 20 73 65 e ticket is a se 0690: 70 61 72 61 74 65 20 61 72 74 69 66 61 63 74 2e parate artifact. 06a0: 0a 0a 54 68 65 20 22 70 75 73 68 22 2c 20 22 70 ..The "push", "p 06b0: 75 6c 6c 22 2c 20 61 6e 64 20 22 73 79 6e 63 22 ull", and "sync" 06c0: 20 61 6c 67 6f 72 69 74 68 6d 73 20 73 68 61 72 algorithms shar 06d0: 65 20 74 69 63 6b 65 74 20 63 68 61 6e 67 65 20 e ticket change 06e0: 61 72 74 69 66 61 63 74 73 0a 62 65 74 77 65 65 artifacts.betwee 06f0: 6e 20 72 65 70 6f 73 69 74 6f 72 69 65 73 20 69 n repositories i 0700: 6e 20 74 68 65 20 73 61 6d 65 20 77 61 79 20 61 n the same way a 0710: 73 20 65 76 65 72 79 20 6f 74 68 65 72 20 61 72 s every other ar 0720: 74 69 66 61 63 74 2e 20 20 49 6e 20 66 61 63 74 tifact. In fact 0730: 2c 0a 74 68 65 20 73 79 6e 63 20 61 6c 67 6f 72 ,.the sync algor 0740: 69 74 68 6d 20 68 61 73 20 6e 6f 20 6b 6e 6f 77 ithm has no know 0750: 6c 65 64 67 65 20 6f 66 20 74 68 65 20 6d 65 61 ledge of the mea 0760: 6e 69 6e 67 20 6f 66 20 74 68 65 20 61 72 74 69 ning of the arti 0770: 66 61 63 74 73 20 69 74 0a 69 73 20 73 79 6e 63 facts it.is sync 0780: 69 6e 67 2e 20 20 41 73 20 66 61 72 20 61 73 20 ing. As far as 0790: 74 68 65 20 73 79 6e 63 20 61 6c 67 6f 72 69 74 the sync algorit 07a0: 68 6d 20 69 73 20 63 6f 6e 63 65 72 6e 65 64 2c hm is concerned, 07b0: 20 61 6c 6c 20 61 72 74 69 66 61 63 74 73 20 61 all artifacts a 07c0: 72 65 0a 61 6c 69 6b 65 2e 20 20 41 66 74 65 72 re.alike. After 07d0: 20 74 68 65 20 73 79 6e 63 20 68 61 73 20 6f 63 the sync has oc 07e0: 63 75 72 73 2c 20 74 68 65 20 69 6e 64 69 76 69 curs, the indivi 07f0: 64 75 61 6c 20 72 65 70 6f 73 69 74 6f 72 69 65 dual repositorie 0800: 73 20 6d 75 73 74 0a 6d 61 6b 65 20 73 65 6e 73 s must.make sens 0810: 65 20 6f 66 20 74 68 65 20 6d 65 61 6e 69 6e 67 e of the meaning 0820: 20 6f 66 20 74 68 65 20 76 61 72 69 6f 75 73 20 of the various 0830: 61 72 74 69 66 61 63 74 73 20 66 6f 72 20 74 68 artifacts for th 0840: 65 6d 73 65 6c 76 65 73 2e 0a 0a 3c 68 32 3e 49 emselves...<h2>I 0850: 6e 74 65 72 70 72 65 74 61 74 69 6f 6e 20 4f 66 nterpretation Of 0860: 20 54 69 63 6b 65 74 20 43 68 61 6e 67 65 20 41 Ticket Change A 0870: 72 74 69 66 61 63 74 73 3c 2f 68 32 3e 0a 0a 3c rtifacts</h2>..< 0880: 69 3e 4e 6f 74 65 3a 20 54 68 65 20 66 6f 6c 6c i>Note: The foll 0890: 6f 77 69 6e 67 20 69 73 20 69 6d 70 6c 65 6d 65 owing is impleme 08a0: 6e 74 61 74 69 6f 6e 20 64 65 74 61 69 6c 20 77 ntation detail w 08b0: 68 69 63 68 20 63 61 6e 20 62 65 20 73 61 66 65 hich can be safe 08c0: 6c 79 20 69 67 6e 6f 72 65 64 20 62 79 0a 63 61 ly ignored by.ca 08d0: 73 75 61 6c 20 75 73 65 72 73 20 6f 66 20 66 6f sual users of fo 08e0: 73 73 69 6c 2e 3c 2f 69 3e 0a 0a 45 76 65 72 79 ssil.</i>..Every 08f0: 20 74 69 63 6b 65 74 20 63 68 61 6e 67 65 20 61 ticket change a 0900: 72 74 69 66 61 63 74 20 63 6f 6e 74 61 69 6e 73 rtifact contains 0910: 20 28 61 6d 6f 6e 67 20 6f 74 68 65 72 20 74 68 (among other th 0920: 69 6e 67 73 29 0a 0a 20 20 2a 20 20 61 20 74 69 ings).. * a ti 0930: 6d 65 73 74 61 6d 70 2c 0a 20 20 2a 20 20 61 20 mestamp,. * a 0940: 74 69 63 6b 65 74 20 49 44 2c 20 61 6e 64 0a 20 ticket ID, and. 0950: 20 2a 20 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 * one or more 0960: 6e 61 6d 65 2f 76 61 6c 75 65 20 70 61 69 72 73 name/value pairs 0970: 2e 0a 0a 54 68 65 20 63 75 72 72 65 6e 74 20 73 ...The current s 0980: 74 61 74 65 20 6f 66 20 61 20 74 69 63 6b 65 74 tate of a ticket 0990: 20 69 73 20 66 6f 75 6e 64 20 62 79 20 72 65 70 is found by rep 09a0: 6c 61 79 69 6e 67 20 61 6c 6c 20 74 69 63 6b 65 laying all ticke 09b0: 74 0a 63 68 61 6e 67 65 20 61 72 74 69 66 61 63 t.change artifac 09c0: 74 73 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 ts with the same 09d0: 20 74 69 63 6b 65 74 20 49 44 20 69 6e 20 74 69 ticket ID in ti 09e0: 6d 65 73 74 61 6d 70 20 6f 72 64 65 72 2e 0a 46 mestamp order..F 09f0: 6f 72 20 61 20 67 69 76 65 6e 20 74 69 63 6b 65 or a given ticke 0a00: 74 2c 20 61 6c 6c 20 76 61 6c 75 65 73 20 61 72 t, all values ar 0a10: 65 20 69 6e 69 74 69 61 6c 6c 79 20 4e 55 4c 4c e initially NULL 0a20: 2e 20 20 41 73 20 65 61 63 68 0a 74 69 63 6b 65 . As each.ticke 0a30: 74 20 63 68 61 6e 67 65 20 61 72 74 69 66 61 63 t change artifac 0a40: 74 20 69 73 20 65 6e 63 6f 75 6e 74 65 72 65 64 t is encountered 0a50: 2c 20 76 61 6c 75 65 73 20 61 72 65 20 65 69 74 , values are eit 0a60: 68 65 72 20 72 65 70 6c 61 63 65 64 0a 6f 72 20 her replaced.or 0a70: 61 70 70 65 6e 64 65 64 2c 20 61 63 63 6f 72 64 appended, accord 0a80: 69 6e 67 20 74 6f 20 61 20 66 6c 61 67 20 6f 6e ing to a flag on 0a90: 20 74 68 65 20 6e 61 6d 65 2f 76 61 6c 75 65 20 the name/value 0aa0: 70 61 69 72 2e 20 20 54 68 65 20 63 75 72 72 65 pair. The curre 0ab0: 6e 74 0a 76 61 6c 75 65 73 20 66 6f 72 20 74 68 nt.values for th 0ac0: 65 20 66 69 65 6c 64 73 20 6f 66 20 61 20 74 69 e fields of a ti 0ad0: 63 6b 65 74 20 61 72 65 20 74 68 65 20 76 61 6c cket are the val 0ae0: 75 65 73 20 74 68 61 74 20 72 65 6d 61 69 6e 20 ues that remain 0af0: 61 74 20 74 68 65 0a 65 6e 64 20 6f 66 20 74 68 at the.end of th 0b00: 65 20 72 65 70 6c 61 79 20 70 72 6f 63 65 73 73 e replay process 0b10: 2e 0a 0a 54 6f 20 63 72 65 61 74 65 20 61 20 6e ...To create a n 0b20: 65 77 20 74 69 63 6b 65 74 2c 20 6f 6e 65 20 69 ew ticket, one i 0b30: 6e 73 65 72 74 73 20 61 20 74 69 63 6b 65 74 20 nserts a ticket 0b40: 63 68 61 6e 67 65 0a 61 72 74 69 66 61 63 74 20 change.artifact 0b50: 77 69 74 68 20 61 20 6e 65 77 20 49 44 2e 20 20 with a new ID. 0b60: 54 68 65 20 74 69 63 6b 65 74 20 49 44 0a 69 73 The ticket ID.is 0b70: 20 61 20 72 61 6e 64 6f 6d 20 34 30 2d 63 68 61 a random 40-cha 0b80: 72 61 63 74 65 72 20 6c 6f 77 65 72 2d 63 61 73 racter lower-cas 0b90: 65 20 68 65 78 61 64 65 63 69 6d 61 6c 20 6e 75 e hexadecimal nu 0ba0: 6d 62 65 72 2e 20 20 54 68 65 20 22 74 6b 74 6e mber. The "tktn 0bb0: 65 77 22 0a 70 61 67 65 20 69 6e 20 74 68 65 20 ew".page in the 0bc0: 66 6f 73 73 69 6c 20 77 65 62 20 69 6e 74 65 72 fossil web inter 0bd0: 66 61 63 65 20 63 72 65 61 74 65 73 20 6e 65 77 face creates new 0be0: 20 74 69 63 6b 65 74 20 49 44 73 0a 75 73 69 6e ticket IDs.usin 0bf0: 67 20 61 20 67 6f 6f 64 20 73 6f 75 72 63 65 20 g a good source 0c00: 6f 66 20 72 61 6e 64 6f 6d 6e 65 73 73 20 74 6f of randomness to 0c10: 20 69 6e 73 75 72 65 20 75 6e 69 71 75 65 6e 65 insure uniquene 0c20: 73 73 2e 0a 54 68 65 20 6e 61 6d 65 2f 76 61 6c ss..The name/val 0c30: 75 65 20 70 61 69 72 73 20 6f 6e 20 74 68 65 20 ue pairs on the 0c40: 69 6e 69 74 69 61 6c 20 74 69 63 6b 65 74 20 63 initial ticket c 0c50: 68 61 6e 67 65 0a 61 72 74 69 66 61 63 74 20 61 hange.artifact a 0c60: 72 65 20 74 68 65 20 69 6e 69 74 69 61 6c 20 76 re the initial v 0c70: 61 6c 75 65 73 20 66 6f 72 20 74 68 65 20 66 69 alues for the fi 0c80: 65 6c 64 73 20 69 6e 20 74 68 65 20 74 69 63 6b elds in the tick 0c90: 65 74 2e 0a 0a 41 6d 65 6e 64 69 6e 67 20 61 20 et...Amending a 0ca0: 74 69 63 6b 65 74 20 6d 65 61 6e 73 20 73 69 6d ticket means sim 0cb0: 70 6c 79 20 63 72 65 61 74 69 6e 67 20 61 20 6e ply creating a n 0cc0: 65 77 20 61 72 74 69 66 61 63 74 20 77 69 74 68 ew artifact with 0cd0: 20 74 68 65 0a 73 61 6d 65 20 74 69 63 6b 65 74 the.same ticket 0ce0: 20 49 44 20 61 6e 64 20 77 69 74 68 20 6e 61 6d ID and with nam 0cf0: 65 2f 76 61 6c 75 65 20 70 61 69 72 73 20 66 6f e/value pairs fo 0d00: 72 20 74 68 6f 73 65 20 66 69 65 6c 64 73 20 77 r those fields w 0d10: 68 69 63 68 0a 61 72 65 20 63 68 61 6e 67 69 6e hich.are changin 0d20: 67 2e 20 20 46 69 65 6c 64 73 20 6f 66 20 74 68 g. Fields of th 0d30: 65 20 74 69 63 6b 65 74 20 77 68 69 63 68 20 61 e ticket which a 0d40: 72 65 20 6e 6f 74 20 62 65 69 6e 67 20 6d 6f 64 re not being mod 0d50: 69 66 69 65 64 0a 73 68 6f 75 6c 64 20 6e 6f 74 ified.should not 0d60: 20 61 70 70 65 61 72 20 61 73 20 6e 61 6d 65 2f appear as name/ 0d70: 76 61 6c 75 65 20 70 61 69 72 73 20 69 6e 20 74 value pairs in t 0d80: 68 65 20 6e 65 77 20 61 72 74 69 66 61 63 74 2e he new artifact. 0d90: 0a 0a 54 68 69 73 20 61 70 70 72 6f 61 63 68 20 ..This approach 0da0: 74 6f 20 73 74 6f 72 69 6e 67 20 74 69 63 6b 65 to storing ticke 0db0: 74 20 73 74 61 74 65 20 6d 65 61 6e 73 20 74 68 t state means th 0dc0: 61 74 20 69 6e 64 65 70 65 6e 64 65 6e 74 6c 79 at independently 0dd0: 20 65 6e 74 65 72 65 64 0a 63 68 61 6e 67 65 73 entered.changes 0de0: 20 61 72 65 20 61 75 74 6f 6d 61 74 69 63 61 6c are automatical 0df0: 6c 79 20 6d 65 72 67 65 64 20 74 6f 67 65 74 68 ly merged togeth 0e00: 65 72 20 77 68 65 6e 20 61 72 74 69 66 61 63 74 er when artifact 0e10: 73 20 61 72 65 20 73 68 61 72 65 64 0a 62 65 74 s are shared.bet 0e20: 77 65 65 6e 20 72 65 70 6f 73 69 74 6f 72 69 65 ween repositorie 0e30: 73 2e 20 20 54 69 63 6b 65 74 73 20 64 6f 20 6e s. Tickets do n 0e40: 6f 74 20 62 72 61 6e 63 68 2e 20 20 54 68 69 73 ot branch. This 0e50: 20 61 70 70 72 6f 61 63 68 20 61 6c 73 6f 20 6d approach also m 0e60: 61 6b 65 73 0a 69 74 20 74 72 69 76 69 61 6c 20 akes.it trivial 0e70: 74 6f 20 74 72 61 63 6b 20 74 68 65 20 68 69 73 to track the his 0e80: 74 6f 72 69 63 20 70 72 6f 67 72 65 73 73 69 6f toric progressio 0e90: 6e 20 6f 66 20 63 68 61 6e 67 65 73 20 74 6f 20 n of changes to 0ea0: 61 20 74 69 63 6b 65 74 2e 0a 0a 49 6e 20 6f 72 a ticket...In or 0eb0: 64 65 72 20 66 6f 72 20 74 68 69 73 20 73 63 68 der for this sch 0ec0: 65 6d 65 20 74 6f 20 77 6f 72 6b 2c 20 74 68 65 eme to work, the 0ed0: 20 73 79 73 74 65 6d 20 63 6c 6f 63 6b 73 20 6f system clocks o 0ee0: 6e 20 6d 61 63 68 69 6e 65 73 20 74 68 61 74 0a n machines that. 0ef0: 61 64 64 20 6e 65 77 20 74 69 63 6b 65 74 20 63 add new ticket c 0f00: 68 61 6e 67 65 73 20 61 72 74 69 66 61 63 74 73 hanges artifacts 0f10: 20 68 61 76 65 20 74 6f 20 62 65 20 73 65 74 20 have to be set 0f20: 63 6c 6f 73 65 20 74 6f 20 72 65 61 6c 69 74 79 close to reality 0f30: 2e 0a 49 74 20 69 73 20 4f 4b 20 66 6f 72 20 61 ..It is OK for a 0f40: 20 74 69 63 6b 65 74 20 63 68 61 6e 67 65 20 61 ticket change a 0f50: 72 74 69 66 61 63 74 20 74 69 6d 65 73 74 61 6d rtifact timestam 0f60: 70 20 74 6f 20 62 65 20 6f 66 66 20 62 79 20 61 p to be off by a 0f70: 20 66 65 77 0a 6d 69 6e 75 74 65 73 20 6f 72 20 few.minutes or 0f80: 65 76 65 6e 20 61 20 66 65 77 20 68 6f 75 72 73 even a few hours 0f90: 2e 20 20 42 75 74 20 69 66 20 61 20 74 69 6d 65 . But if a time 0fa0: 73 74 61 6d 70 20 6f 6e 20 61 20 74 69 63 6b 65 stamp on a ticke 0fb0: 74 20 63 68 61 6e 67 65 0a 61 72 74 69 66 61 63 t change.artifac 0fc0: 74 20 69 73 20 6f 66 66 20 62 79 20 6d 6f 6e 74 t is off by mont 0fd0: 68 73 20 6f 72 20 79 65 61 72 73 2c 20 69 74 20 hs or years, it 0fe0: 63 61 6e 20 73 65 72 69 6f 75 73 6c 79 20 63 6f can seriously co 0ff0: 6e 66 75 73 65 20 74 68 65 0a 72 65 70 6c 61 79 nfuse the.replay 1000: 20 61 6c 67 6f 72 69 74 68 6d 20 66 6f 72 20 64 algorithm for d 1010: 65 74 65 72 6d 69 6e 69 6e 67 20 74 68 65 20 63 etermining the c 1020: 75 72 72 65 6e 74 20 74 69 63 6b 65 74 20 73 74 urrent ticket st 1030: 61 74 65 2e 20 20 54 68 65 72 65 0a 61 72 65 20 ate. There.are 1040: 74 65 63 68 6e 69 71 75 65 73 20 61 76 61 69 6c techniques avail 1050: 61 62 6c 65 20 74 6f 20 63 61 75 73 65 20 72 6f able to cause ro 1060: 67 75 65 20 61 72 74 69 66 61 63 74 73 20 74 6f gue artifacts to 1070: 20 62 65 20 69 67 6e 6f 72 65 64 0a 62 79 20 66 be ignored.by f 1080: 6f 73 73 69 6c 2e 20 20 53 6f 20 69 66 20 61 20 ossil. So if a 1090: 74 69 63 6b 65 74 20 63 68 61 6e 67 65 20 61 72 ticket change ar 10a0: 74 69 66 61 63 74 20 77 69 74 68 20 61 20 62 61 tifact with a ba 10b0: 64 20 74 69 6d 65 73 74 61 6d 70 0a 64 6f 65 73 d timestamp.does 10c0: 20 67 65 74 20 69 6e 74 6f 20 61 20 72 65 70 6f get into a repo 10d0: 73 69 74 6f 72 79 2c 20 69 74 20 63 61 6e 20 62 sitory, it can b 10e0: 65 20 72 65 6d 6f 76 65 64 20 62 79 20 61 6e 20 e removed by an 10f0: 61 64 6d 69 6e 69 73 74 72 61 74 6f 72 2e 0a 42 administrator..B 1100: 75 74 20 74 68 65 20 62 65 73 74 20 61 70 70 72 ut the best appr 1110: 6f 61 63 68 20 69 73 20 74 6f 20 74 61 6b 65 20 oach is to take 1120: 73 74 65 70 73 20 74 6f 20 69 6e 73 75 72 65 20 steps to insure 1130: 74 68 61 74 20 74 69 6d 65 73 74 61 6d 70 73 0a that timestamps. 1140: 61 72 65 20 61 70 70 72 6f 78 69 6d 61 74 65 6c are approximatel 1150: 79 20 63 6f 72 72 65 63 74 20 69 6e 20 74 68 65 y correct in the 1160: 20 66 69 72 73 74 20 70 6c 61 63 65 2e 0a 0a 3c first place...< 1170: 68 32 3e 4c 6f 63 61 6c 20 43 6f 6e 66 69 67 75 h2>Local Configu 1180: 72 61 74 69 6f 6e 3c 2f 68 32 3e 0a 0a 54 68 65 ration</h2>..The 1190: 20 74 69 63 6b 65 74 20 63 68 61 6e 67 65 20 61 ticket change a 11a0: 72 74 69 66 61 63 74 73 20 61 72 65 20 70 61 72 rtifacts are par 11b0: 74 20 6f 66 20 74 68 65 20 67 6c 6f 62 61 6c 20 t of the global 11c0: 73 74 61 74 65 20 66 6f 72 20 61 20 70 72 6f 6a state for a proj 11d0: 65 63 74 2e 0a 54 68 65 20 67 6c 6f 62 61 6c 20 ect..The global 11e0: 73 74 61 74 65 20 69 73 20 74 68 61 74 20 77 68 state is that wh 11f0: 69 63 68 20 69 73 20 73 68 61 72 65 64 20 62 65 ich is shared be 1200: 74 77 65 65 6e 20 72 65 70 6f 73 69 74 6f 72 69 tween repositori 1210: 65 73 20 64 75 72 69 6e 67 0a 61 20 73 79 6e 63 es during.a sync 1220: 2e 20 20 45 61 63 68 20 72 65 70 6f 73 69 74 6f . Each reposito 1230: 72 79 20 61 6c 73 6f 20 68 61 73 20 6c 6f 63 61 ry also has loca 1240: 6c 20 73 74 61 74 65 20 77 68 69 63 68 20 69 73 l state which is 1250: 20 6e 6f 74 20 28 6e 6f 72 6d 61 6c 6c 79 29 0a not (normally). 1260: 73 68 61 72 65 64 2e 20 20 54 68 65 20 6e 61 6d shared. The nam 1270: 65 2f 76 61 6c 75 65 20 70 61 69 72 73 20 66 6f e/value pairs fo 1280: 72 20 61 20 74 69 63 6b 65 74 20 61 72 65 20 70 r a ticket are p 1290: 61 72 74 20 6f 66 20 67 6c 6f 62 61 6c 20 73 74 art of global st 12a0: 61 74 65 2c 0a 62 75 74 20 74 68 65 20 69 6e 74 ate,.but the int 12b0: 65 72 70 72 65 74 61 74 69 6f 6e 20 61 6e 64 20 erpretation and 12c0: 64 69 73 70 6c 61 79 20 6f 66 20 74 68 61 74 20 display of that 12d0: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 73 20 6c information is l 12e0: 6f 63 61 6c 20 73 74 61 74 65 2e 0a 48 65 6e 63 ocal state..Henc 12f0: 65 2c 20 65 61 63 68 20 72 65 70 6f 73 69 74 6f e, each reposito 1300: 72 79 20 69 73 20 66 72 65 65 20 74 6f 20 73 65 ry is free to se 1310: 74 20 75 70 20 69 74 73 20 6f 77 6e 20 74 69 63 t up its own tic 1320: 6b 65 74 20 64 69 73 70 6c 61 79 20 61 6e 64 0a ket display and. 1330: 69 6e 70 75 74 20 66 6f 72 6d 61 74 73 20 61 6e input formats an 1340: 64 20 72 65 70 6f 72 74 69 6e 67 20 72 75 6c 65 d reporting rule 1350: 73 20 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 69 s according to i 1360: 74 73 20 6f 77 6e 20 70 61 72 74 69 63 75 6c 61 ts own particula 1370: 72 20 6e 65 65 64 73 2e 0a 0a 45 61 63 68 20 72 r needs...Each r 1380: 65 70 6f 73 69 74 6f 72 79 20 64 65 66 69 6e 65 epository define 1390: 73 20 69 74 73 20 6f 77 6e 20 54 49 43 4b 45 54 s its own TICKET 13a0: 20 74 61 62 6c 65 20 69 6e 20 69 74 73 20 64 61 table in its da 13b0: 74 61 62 61 73 65 2e 20 20 54 68 65 72 65 20 69 tabase. There i 13c0: 73 0a 6f 6e 65 20 72 6f 77 20 69 6e 20 74 68 65 s.one row in the 13d0: 20 54 49 43 4b 45 54 20 74 61 62 6c 65 20 66 6f TICKET table fo 13e0: 72 20 65 61 63 68 20 75 6e 69 71 75 65 20 74 69 r each unique ti 13f0: 63 6b 65 74 20 49 44 2e 20 20 54 68 65 0a 6e 61 cket ID. The.na 1400: 6d 65 73 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 mes of columns i 1410: 6e 20 74 68 65 20 54 49 43 4b 45 54 20 74 61 62 n the TICKET tab 1420: 6c 65 20 63 6f 72 72 65 73 70 6f 6e 64 20 74 6f le correspond to 1430: 20 74 68 65 20 6e 61 6d 65 73 20 69 6e 0a 74 68 the names in.th 1440: 65 20 6e 61 6d 65 2f 76 61 6c 75 65 20 70 61 69 e name/value pai 1450: 72 73 20 6f 66 20 74 69 63 6b 65 74 20 63 68 61 rs of ticket cha 1460: 6e 67 65 20 61 72 74 69 66 61 63 74 73 2e 20 20 nge artifacts. 1470: 57 68 65 6e 20 72 75 6e 6e 69 6e 67 20 74 68 65 When running the 1480: 20 72 65 70 6c 61 79 0a 61 6c 67 6f 72 69 74 68 replay.algorith 1490: 6d 2c 20 69 66 20 61 20 6e 61 6d 65 2f 76 61 6c m, if a name/val 14a0: 75 65 20 70 61 69 72 20 69 73 20 73 65 65 6e 20 ue pair is seen 14b0: 77 68 69 63 68 20 68 61 73 20 6e 6f 20 63 6f 72 which has no cor 14c0: 72 65 73 70 6f 6e 64 69 6e 67 20 63 6f 6c 75 6d responding colum 14d0: 6e 0a 69 6e 20 74 68 65 20 54 49 43 4b 45 54 20 n.in the TICKET 14e0: 74 61 62 6c 65 2c 20 74 68 65 6e 20 74 68 61 74 table, then that 14f0: 20 6e 61 6d 65 2f 76 61 6c 75 65 20 70 61 69 72 name/value pair 1500: 20 69 73 20 69 67 6e 6f 72 65 64 2e 20 20 43 6f is ignored. Co 1510: 6c 75 6d 6e 73 20 63 61 6e 0a 62 65 20 61 64 64 lumns can.be add 1520: 65 64 20 6f 72 20 72 65 6d 6f 76 65 64 20 66 72 ed or removed fr 1530: 6f 6d 20 74 68 65 20 54 49 43 4b 45 54 20 74 61 om the TICKET ta 1540: 62 6c 65 20 61 74 20 61 6e 79 20 74 69 6d 65 2e ble at any time. 1550: 20 20 57 68 65 6e 65 76 65 72 20 74 68 65 0a 54 Whenever the.T 1560: 49 43 4b 45 54 20 74 61 62 6c 65 20 69 73 20 6d ICKET table is m 1570: 6f 64 69 66 69 65 64 2c 20 74 68 65 20 72 65 70 odified, the rep 1580: 6c 61 79 20 61 6c 67 6f 72 69 74 68 6d 20 61 75 lay algorithm au 1590: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 72 65 72 75 tomatically reru 15a0: 6e 73 0a 74 6f 20 72 65 70 6f 70 75 6c 61 74 65 ns.to repopulate 15b0: 20 74 68 65 20 74 61 62 6c 65 20 75 73 69 6e 67 the table using 15c0: 20 74 68 65 20 6e 65 77 20 63 6f 6c 75 6d 6e 20 the new column 15d0: 6e 61 6d 65 73 2e 20 20 4e 6f 74 65 20 74 68 61 names. Note tha 15e0: 74 20 74 68 65 20 54 49 43 4b 45 54 0a 74 61 62 t the TICKET.tab 15f0: 6c 65 20 73 63 68 65 6d 61 20 61 6e 64 20 63 6f le schema and co 1600: 6e 74 65 6e 74 20 69 73 20 70 61 72 74 20 6f 66 ntent is part of 1610: 20 74 68 65 20 6c 6f 63 61 6c 20 73 74 61 74 65 the local state 1620: 20 6f 66 20 61 20 72 65 70 6f 73 69 74 6f 72 79 of a repository 1630: 0a 61 6e 64 20 69 73 20 6e 6f 74 20 73 68 61 72 .and is not shar 1640: 65 64 20 77 69 74 68 20 6f 74 68 65 72 20 72 65 ed with other re 1650: 70 6f 73 69 74 6f 72 69 65 73 20 64 75 72 69 6e positories durin 1660: 67 20 61 20 73 79 6e 63 2c 20 70 75 73 68 2c 20 g a sync, push, 1670: 6f 72 20 70 75 6c 6c 2e 0a 0a 45 61 63 68 20 72 or pull...Each r 1680: 65 70 6f 73 69 74 6f 72 79 20 61 6c 73 6f 20 64 epository also d 1690: 65 66 69 6e 65 73 20 73 63 72 69 70 74 73 20 75 efines scripts u 16a0: 73 65 64 20 74 6f 20 67 65 6e 65 72 61 74 65 20 sed to generate 16b0: 77 65 62 20 70 61 67 65 73 20 66 6f 72 0a 63 72 web pages for.cr 16c0: 65 61 74 69 6e 67 20 6e 65 77 20 74 69 63 6b 65 eating new ticke 16d0: 74 73 2c 20 76 69 65 77 69 6e 67 20 65 78 69 73 ts, viewing exis 16e0: 74 69 6e 67 20 74 69 63 6b 65 74 73 2c 20 61 6e ting tickets, an 16f0: 64 20 6d 6f 64 69 66 79 69 6e 67 20 61 6e 0a 65 d modifying an.e 1700: 78 69 73 74 69 6e 67 20 74 69 63 6b 65 74 2e 20 xisting ticket. 1710: 20 54 68 65 73 65 20 73 63 72 69 70 74 73 20 63 These scripts c 1720: 6f 6e 73 69 73 74 20 6f 66 20 48 54 4d 4c 20 77 onsist of HTML w 1730: 69 74 68 20 61 6e 20 65 6d 62 65 64 64 65 64 0a ith an embedded. 1740: 73 63 72 69 70 74 73 20 77 72 69 74 74 65 6e 20 scripts written 1750: 61 6e 20 61 20 54 63 6c 2d 6c 69 6b 65 20 6c 61 an a Tcl-like la 1760: 6e 67 75 61 67 65 20 63 61 6c 6c 65 64 20 22 54 nguage called "T 1770: 48 31 22 2e 20 20 45 76 65 72 79 20 6e 65 77 20 H1". Every new 1780: 66 6f 73 73 69 6c 0a 72 65 70 6f 73 69 74 6f 72 fossil.repositor 1790: 79 20 69 73 20 63 72 65 61 74 65 64 20 77 69 74 y is created wit 17a0: 68 20 64 65 66 61 75 6c 74 20 73 63 72 69 70 74 h default script 17b0: 73 2e 20 20 50 61 75 6c 20 52 75 69 7a 65 6e 64 s. Paul Ruizend 17c0: 61 61 6c 20 68 61 73 20 77 72 69 74 74 65 6e 0a aal has written. 17d0: 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 6f 6e documentation on 17e0: 20 74 68 65 20 54 48 31 20 6c 61 6e 67 75 61 67 the TH1 languag 17f0: 65 20 74 68 61 74 20 69 73 20 61 76 61 69 6c 61 e that is availa 1800: 62 6c 65 20 61 74 0a 5b 68 74 74 70 3a 2f 2f 77 ble at.[http://w 1810: 77 77 2e 73 71 6c 69 74 65 63 6f 6e 63 65 70 74 ww.sqliteconcept 1820: 73 2e 6f 72 67 2f 54 48 4d 61 6e 75 61 6c 2e 70 s.org/THManual.p 1830: 64 66 5d 2e 20 20 41 64 6d 69 6e 69 73 74 72 61 df]. Administra 1840: 74 6f 72 73 20 77 69 73 68 69 6e 67 20 74 6f 0a tors wishing to. 1850: 63 75 73 74 6f 6d 69 7a 65 20 74 68 65 69 72 20 customize their 1860: 74 69 63 6b 65 74 20 65 6e 74 72 79 2c 20 76 69 ticket entry, vi 1870: 65 77 69 6e 67 2c 20 61 6e 64 20 65 64 69 74 69 ewing, and editi 1880: 6e 67 20 73 63 72 65 65 6e 73 20 73 68 6f 75 6c ng screens shoul 1890: 64 0a 6d 6f 64 69 66 79 20 74 68 65 20 64 65 66 d.modify the def 18a0: 61 75 6c 74 20 73 63 72 69 70 74 73 20 74 6f 20 ault scripts to 18b0: 73 75 69 74 20 74 68 65 69 72 20 6e 65 65 64 73 suit their needs 18c0: 2e 20 20 54 68 65 73 65 20 73 63 72 65 65 6e 20 . These screen 18d0: 67 65 6e 65 72 61 74 6f 72 0a 73 63 72 69 70 74 generator.script 18e0: 73 20 61 72 65 20 70 61 72 74 20 6f 66 20 74 68 s are part of th 18f0: 65 20 6c 6f 63 61 6c 20 73 74 61 74 65 20 6f 66 e local state of 1900: 20 61 20 72 65 70 6f 73 69 74 6f 72 79 20 61 6e a repository an 1910: 64 20 61 72 65 20 6e 6f 74 20 73 68 61 72 65 64 d are not shared 1920: 0a 77 69 74 68 20 6f 74 68 65 72 20 72 65 70 6f .with other repo 1930: 73 69 74 6f 72 69 65 73 20 64 75 72 69 6e 67 20 sitories during 1940: 61 20 73 79 6e 63 2c 20 70 75 73 68 2c 20 6f 72 a sync, push, or 1950: 20 70 75 6c 6c 2e 0a 0a 3c 69 3e 54 6f 20 62 65 pull...<i>To be 1960: 20 63 6f 6e 74 69 6e 75 65 64 2e 2e 2e 3c 2f 69 continued...</i 1970: 3e 0a >.