Artifact f05433096a91b7d12739d1429744e57ca3d9240a:
- File test/release-checklist.wiki — part of check-in [b00e462ffc] at 2012-08-17 18:14:12 on branch trunk — Fixed a number of "the the" duplications in comments, documentation, and HTML (templates). Left the 17 occurences of same in sqlite.c alone. (user: andreask size: 2216) [more...]
0000: 3c 74 69 74 6c 65 3e 52 65 6c 65 61 73 65 20 43 <title>Release C 0010: 68 65 63 6b 6c 69 73 74 3c 2f 74 69 74 6c 65 3e hecklist</title> 0020: 0a 0a 54 68 69 73 20 66 69 6c 65 20 64 65 73 63 ..This file desc 0030: 72 69 62 65 73 20 74 68 65 20 74 65 73 74 69 6e ribes the testin 0040: 67 20 70 72 6f 63 65 64 75 72 65 73 20 66 6f 72 g procedures for 0050: 20 46 6f 73 73 69 6c 20 70 72 69 6f 72 20 74 6f Fossil prior to 0060: 20 61 6e 0a 6f 66 66 69 63 69 61 6c 20 72 65 6c an.official rel 0070: 65 61 73 65 2e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 3e ease...<ol>.<li> 0080: 3c 70 3e 0a 46 72 6f 6d 20 61 20 70 72 69 76 61 <p>.From a priva 0090: 74 65 20 64 69 72 65 63 74 6f 72 79 20 28 6e 6f te directory (no 00a0: 74 20 74 68 65 20 73 6f 75 72 63 65 20 74 72 65 t the source tre 00b0: 65 29 20 72 75 6e 20 0a 22 3c 62 3e 74 63 6c 73 e) run ."<b>tcls 00c0: 68 20 24 53 52 43 2f 74 65 73 74 2f 74 65 73 74 h $SRC/test/test 00d0: 65 72 2e 74 63 6c 20 24 46 4f 53 53 49 4c 3c 2f er.tcl $FOSSIL</ 00e0: 62 3e 22 20 77 68 65 72 65 20 24 46 4f 53 53 49 b>" where $FOSSI 00f0: 4c 20 69 73 20 74 68 65 0a 6e 61 6d 65 20 6f 66 L is the.name of 0100: 20 74 68 65 20 65 78 65 63 75 74 61 62 6c 65 20 the executable 0110: 75 6e 64 65 72 20 74 65 73 74 20 61 6e 64 20 24 under test and $ 0120: 53 52 43 20 69 73 20 74 68 65 20 73 6f 75 72 63 SRC is the sourc 0130: 65 20 74 72 65 65 2e 0a 56 65 72 69 66 79 20 74 e tree..Verify t 0140: 68 61 74 20 74 68 65 72 65 20 61 72 65 20 6e 6f hat there are no 0150: 20 65 72 72 6f 72 73 2e 0a 0a 3c 6c 69 3e 3c 70 errors...<li><p 0160: 3e 0a 43 6c 69 63 6b 20 6f 6e 20 65 61 63 68 20 >.Click on each 0170: 6f 66 20 74 68 65 20 6c 69 6e 6b 73 20 69 6e 20 of the links in 0180: 69 6e 20 74 68 65 0a 5b 2e 2f 67 72 61 70 68 2d in the.[./graph- 0190: 74 65 73 74 2d 31 2e 77 69 6b 69 5d 20 64 6f 63 test-1.wiki] doc 01a0: 75 6d 65 6e 74 20 61 6e 64 20 76 65 72 69 66 79 ument and verify 01b0: 20 74 68 61 74 20 61 6c 6c 20 67 72 61 70 68 73 that all graphs 01c0: 20 61 72 65 0a 72 65 6e 64 65 72 65 64 20 63 6f are.rendered co 01d0: 72 72 65 63 74 6c 79 2e 0a 0a 3c 6c 69 3e 3c 70 rrectly...<li><p 01e0: 3e 0a 43 6c 69 63 6b 20 6f 6e 20 65 61 63 68 20 >.Click on each 01f0: 6f 66 20 74 68 65 20 6c 69 6e 6b 73 20 69 6e 20 of the links in 0200: 69 6e 20 74 68 65 0a 5b 2e 2f 64 69 66 66 2d 74 in the.[./diff-t 0210: 65 73 74 2d 31 2e 77 69 6b 69 5d 20 64 6f 63 75 est-1.wiki] docu 0220: 6d 65 6e 74 20 61 6e 64 20 76 65 72 69 66 79 20 ment and verify 0230: 74 68 61 74 20 61 6c 6c 20 64 69 66 66 73 20 61 that all diffs a 0240: 72 65 0a 72 65 6e 64 65 72 65 64 20 63 6f 72 72 re.rendered corr 0250: 65 63 74 6c 79 2e 0a 0a 3c 6c 69 3e 3c 70 3e 0a ectly...<li><p>. 0260: 56 65 72 69 66 79 20 63 6f 72 72 65 63 74 20 6e Verify correct n 0270: 61 6d 65 2d 63 68 61 6e 67 65 20 74 72 61 63 6b ame-change track 0280: 69 6e 67 20 62 65 68 61 76 69 6f 72 20 28 6e 6f ing behavior (no 0290: 20 6e 65 74 20 63 68 61 6e 67 65 73 29 20 66 6f net changes) fo 02a0: 72 3a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c r:.<blockquote>< 02b0: 62 3e 0a 66 6f 73 73 69 6c 20 74 65 73 74 2d 6e b>.fossil test-n 02c0: 61 6d 65 2d 63 68 61 6e 67 65 73 20 2d 2d 64 65 ame-changes --de 02d0: 62 75 67 20 20 62 31 32 30 62 63 38 62 32 36 32 bug b120bc8b262 02e0: 61 63 20 33 37 34 39 32 30 62 32 30 39 34 34 62 ac 374920b20944b 02f0: 0a 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 .</b></blockquot 0300: 65 3e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 43 6f 6d 70 e>..<li><p>.Comp 0310: 69 6c 65 20 66 6f 72 20 61 6c 6c 20 6f 66 20 74 ile for all of t 0320: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 70 6c 61 he following pla 0330: 74 66 6f 72 6d 73 3a 0a 3c 6f 6c 20 74 79 70 65 tforms:.<ol type 0340: 3d 22 61 22 3e 0a 3c 6c 69 3e 20 4c 69 6e 75 78 ="a">.<li> Linux 0350: 20 78 38 36 0a 3c 6c 69 3e 20 4c 69 6e 75 78 20 x86.<li> Linux 0360: 78 38 36 5f 36 34 0a 3c 6c 69 3e 20 4d 61 63 20 x86_64.<li> Mac 0370: 78 38 36 0a 3c 6c 69 3e 20 4d 61 63 20 78 38 36 x86.<li> Mac x86 0380: 5f 36 34 0a 3c 6c 69 3e 20 57 69 6e 64 6f 77 73 _64.<li> Windows 0390: 20 28 6d 69 6e 67 77 29 0a 3c 6c 69 3e 20 57 69 (mingw).<li> Wi 03a0: 6e 64 6f 77 73 20 28 76 63 2b 2b 29 0a 3c 6c 69 ndows (vc++).<li 03b0: 3e 20 4f 70 65 6e 42 53 44 0a 3c 2f 6f 6c 3e 0a > OpenBSD.</ol>. 03c0: 0a 3c 6c 69 3e 3c 70 3e 0a 52 75 6e 20 61 74 20 .<li><p>.Run at 03d0: 6c 65 61 73 74 20 6f 6e 65 20 6f 63 63 75 72 72 least one occurr 03e0: 65 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c ence of the foll 03f0: 6f 77 69 6e 67 20 63 6f 6d 6d 61 6e 64 73 20 6f owing commands o 0400: 6e 20 65 76 65 72 79 0a 70 6c 61 74 66 6f 72 6d n every.platform 0410: 3a 0a 3c 6f 6c 20 74 79 70 65 3d 22 61 22 3e 0a :.<ol type="a">. 0420: 3c 6c 69 3e 20 3c 62 3e 66 6f 73 73 69 6c 20 72 <li> <b>fossil r 0430: 65 62 75 69 6c 64 3c 2f 62 3e 0a 3c 6c 69 3e 20 ebuild</b>.<li> 0440: 3c 62 3e 66 6f 73 73 69 6c 20 73 79 6e 63 3c 2f <b>fossil sync</ 0450: 62 3e 0a 3c 6c 69 3e 20 3c 62 3e 66 6f 73 73 69 b>.<li> <b>fossi 0460: 6c 20 74 65 73 74 2d 69 6e 74 65 67 72 69 74 79 l test-integrity 0470: 3c 2f 62 3e 0a 3c 2f 6f 6c 3e 0a 0a 3c 6c 69 3e </b>.</ol>..<li> 0480: 3c 70 3e 0a 52 75 6e 20 74 68 65 20 66 6f 6c 6c <p>.Run the foll 0490: 6f 77 69 6e 67 20 63 6f 6d 6d 61 6e 64 73 20 6f owing commands o 04a0: 6e 20 4c 69 6e 75 78 20 61 6e 64 20 76 65 72 69 n Linux and veri 04b0: 66 79 20 6e 6f 20 6d 61 6a 6f 72 20 6d 65 6d 6f fy no major memo 04c0: 72 79 20 6c 65 61 6b 73 0a 61 6e 64 20 6e 6f 20 ry leaks.and no 04d0: 72 75 6e 2d 74 69 6d 65 20 65 72 72 6f 72 73 20 run-time errors 04e0: 6f 72 20 77 61 72 6e 69 6e 67 73 20 28 65 78 63 or warnings (exc 04f0: 65 70 74 20 66 6f 72 20 74 68 65 20 77 65 6c 6c ept for the well 0500: 2d 6b 6e 6f 77 6e 20 6a 75 6d 70 20 6f 6e 20 61 -known jump on a 0510: 6e 0a 75 6e 69 6e 69 74 69 61 6c 69 7a 65 64 20 n.uninitialized 0520: 76 61 6c 75 65 20 74 68 61 74 20 6f 63 63 75 72 value that occur 0530: 73 20 77 69 74 68 69 6e 20 7a 6c 69 62 29 2e 0a s within zlib).. 0540: 3c 6f 6c 20 74 79 70 65 3d 22 61 22 3e 0a 3c 6c <ol type="a">.<l 0550: 69 3e 20 3c 62 3e 76 61 6c 67 72 69 6e 64 20 66 i> <b>valgrind f 0560: 6f 73 73 69 6c 20 72 65 62 75 69 6c 64 3c 2f 62 ossil rebuild</b 0570: 3e 0a 3c 6c 69 3e 20 3c 62 3e 76 61 6c 67 72 69 >.<li> <b>valgri 0580: 6e 64 20 66 6f 73 73 69 6c 20 73 79 6e 63 3c 2f nd fossil sync</ 0590: 62 3e 0a 3c 2f 6f 6c 3e 0a 0a 3c 6c 69 3e 3c 70 b>.</ol>..<li><p 05a0: 3e 0a 49 6e 73 70 65 63 74 20 61 6c 6c 20 63 6f >.Inspect all co 05b0: 64 65 20 63 68 61 6e 67 65 73 20 73 69 6e 63 65 de changes since 05c0: 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 72 65 the previous re 05d0: 6c 65 61 73 65 2c 20 70 61 79 69 6e 67 20 70 61 lease, paying pa 05e0: 72 74 69 63 75 6c 61 72 0a 61 74 74 65 6e 74 69 rticular.attenti 05f0: 6f 6e 20 74 6f 20 74 68 65 20 66 6f 6c 6c 6f 77 on to the follow 0600: 69 6e 67 20 64 65 74 61 69 6c 73 3a 0a 3c 6f 6c ing details:.<ol 0610: 20 74 79 70 65 3d 22 61 22 3e 0a 3c 6c 69 3e 20 type="a">.<li> 0620: 43 61 6e 20 61 20 6d 61 6c 69 63 69 6f 75 73 20 Can a malicious 0630: 48 54 54 50 20 72 65 71 75 65 73 74 20 63 61 75 HTTP request cau 0640: 73 65 20 61 20 62 75 66 66 65 72 20 6f 76 65 72 se a buffer over 0650: 72 75 6e 2e 0a 3c 6c 69 3e 20 43 61 6e 20 61 20 run..<li> Can a 0660: 6d 61 6c 69 63 69 6f 75 73 20 48 54 54 50 20 72 malicious HTTP r 0670: 65 71 75 65 73 74 20 65 78 70 6f 73 65 20 70 72 equest expose pr 0680: 69 76 69 6c 65 67 65 64 20 69 6e 66 6f 72 6d 61 ivileged informa 0690: 74 69 6f 6e 20 74 6f 0a 20 20 20 20 20 75 6e 61 tion to. una 06a0: 75 74 68 6f 72 69 7a 65 64 20 75 73 65 72 73 2e uthorized users. 06b0: 0a 3c 2f 6f 6c 3e 0a 0a 0a 3c 6c 69 3e 3c 70 3e .</ol>...<li><p> 06c0: 0a 55 73 65 20 74 68 65 20 72 65 6c 65 61 73 65 .Use the release 06d0: 20 63 61 6e 64 69 64 61 74 65 20 76 65 72 73 69 candidate versi 06e0: 6f 6e 20 6f 66 20 66 6f 73 73 69 6c 20 69 6e 20 on of fossil in 06f0: 70 72 6f 64 75 63 74 69 6f 6e 20 6f 6e 20 74 68 production on th 0700: 65 0a 5b 68 74 74 70 3a 2f 2f 77 77 77 2e 66 6f e.[http://www.fo 0710: 73 73 69 6c 2d 73 63 6d 2e 6f 72 67 2f 5d 20 77 ssil-scm.org/] w 0720: 65 62 73 69 74 65 20 66 6f 72 20 61 74 20 6c 65 ebsite for at le 0730: 61 73 74 20 34 38 20 68 6f 75 72 73 20 28 77 69 ast 48 hours (wi 0740: 74 68 6f 75 74 0a 69 6e 63 69 64 65 6e 74 29 20 thout.incident) 0750: 70 72 69 6f 72 20 74 6f 20 6d 61 6b 69 6e 67 20 prior to making 0760: 74 68 65 20 72 65 6c 65 61 73 65 20 6f 66 66 69 the release offi 0770: 63 69 61 6c 2e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 56 cial...<li><p>.V 0780: 65 72 69 66 79 20 74 68 61 74 20 74 68 65 20 5b erify that the [ 0790: 2e 2e 2f 77 77 77 2f 63 68 61 6e 67 65 73 2e 77 ../www/changes.w 07a0: 69 6b 69 20 7c 20 43 68 61 6e 67 65 20 4c 6f 67 iki | Change Log 07b0: 5d 20 69 73 20 63 6f 72 72 65 63 74 20 61 6e 64 ] is correct and 07c0: 0a 75 70 2d 74 6f 2d 64 61 74 65 2e 0a 3c 2f 6f .up-to-date..</o 07d0: 6c 3e 0a 0a 3c 68 72 3e 0a 0a 55 70 6f 6e 20 73 l>..<hr>..Upon s 07e0: 75 63 63 65 73 73 66 75 6c 20 63 6f 6d 70 6c 65 uccessful comple 07f0: 74 69 6f 6e 20 6f 66 20 61 6c 6c 20 74 65 73 74 tion of all test 0800: 73 20 61 62 6f 76 65 2c 20 74 61 67 20 74 68 65 s above, tag the 0810: 20 72 65 6c 65 61 73 65 20 63 61 6e 64 69 64 61 release candida 0820: 74 65 0a 77 69 74 68 20 74 68 65 20 22 72 65 6c te.with the "rel 0830: 65 61 73 65 22 20 74 61 67 20 61 6e 64 20 73 65 ease" tag and se 0840: 74 20 69 74 73 20 62 61 63 6b 67 72 6f 75 6e 64 t its background 0850: 20 63 6f 6c 6f 72 20 74 6f 20 22 23 64 30 63 30 color to "#d0c0 0860: 66 66 22 2e 20 20 55 70 64 61 74 65 0a 74 68 65 ff". Update.the 0870: 20 77 77 77 2f 63 68 61 6e 67 65 73 2e 77 69 6b www/changes.wik 0880: 69 20 66 69 6c 65 20 74 6f 20 73 68 6f 77 20 74 i file to show t 0890: 68 65 20 64 61 74 65 20 6f 66 20 74 68 65 20 72 he date of the r 08a0: 65 6c 65 61 73 65 2e 0a elease..