-
Notifications
You must be signed in to change notification settings - Fork 0
/
CREATINGARELEASE
93 lines (74 loc) · 3.42 KB
/
CREATINGARELEASE
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
This is an checlist of the steps in creating a new release.
In hopes this will prevent omissions.
DavidA. 30 November 2012
Source here means libdwarf/dwarfdump/dwarfgen source (in Git).
Tests here means the regression tests (in another Git repository).
In the Source:
Update the source and build with your changes.
Update the appropriate ChangeLog file so every
file in Git which changes (except ChangeLog and NEWS)
are in ChangeLog.
(at year end, move ChangeLog to ChangeLogyyyy
where yyyy is the year ending and create a new
empty ChangeLog)
Use dicheck (also in sourceforge) to verify indentation of
all .h .cc and .c files is consistent.
Ensure all interfaces in libdwarf that are call able by users
are in libdwarf.h and are documented in libdwarf2.1.mm or
libdwarf2p.1.mm and that any changes in the .mm also
mean you inserted a version and date change
in the date lines near the front of that .mm.
Then regenerate the pdf if any changes.
Run any small preliminary tests that seem applicable.
In the Tests:
Create any new tests that seem applicable.
Add the appropriate lines to DWARFTEST.sh which
actually does the test running.
RUNALL.sh
Runs one test of the new dwarfdump/libdwarf executable
against the previously saved dwarfdump/libdwarf executable.
The notion of keeping baseline test output and simply
comparing output of a previous release vs the new
candiate release would involve saving some really large files.
So the present test suite instead runs each test with
two dwarfdump* versions and compares the output.
To run all the tests, most of which
compare the (committed in tests) dwarfdump
against your new source:
sh PICKUPBIN # This picks up latest source and compiles
# (for some files multiple times)
# It is essential before each test run.
sh RUNALL.sh # This runs the tests 3 times with different
# dwarfdump[2] and different comparisons
To check for failure:
grep FAIL ALL*
If there are any FAILS decide if they are real failures
(in which case fix the Source and retest) or are in fact
the output change that is expected given the Source changes.
In case all tests pass:
cp dwarfdump dwarfdump.O
commit the updated .O executables as the new baseline good
dwarfdump for the next test run.
In the Source:
sh UPDATEDWARFDUMPVERSION.sh #updates the version string in 4 places
update dwarfdump[2]/ChangeLog files to reflect the new version.
commit the new version string. If this has been done recently
enough that users won't see the current version string
it need not be done at this time.
sh BLD #to verify it still builds
git push origin master # Push to sourceforge.
# We use 20121130 as an example below, use the current date.
sh CPTOPUBLIC # To copy relevant Source to a temp directory
sh BLDLIBDWARFTAR 20121130 # (use current date) to create a tar.gz
# like libdwarf-20121130.tar.gz
md5sum libdwarf-20121130.tar.gz
sha512sum libdwarf-20121130.tar.gz
# To get unforgeable checksums for the tar.gz file
git tag -a 20121130 -m 'Release 20121130'
git push origin 20121130 # push the tag
In the Tests:
git push origin master
git tag -a 20121130 -m 'Release 20121130'
git push origin 20121130 # push the tag
Update web pages so that the new release is visble to users
and copy the tar.gz to the appropriate web site.