proj-datumgrid/HOWTORELEASE at master · OSGeo/proj-datumgrid · GitHub

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
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
HOWTO RELEASE THE PROJ-DATUMGRID PACKAGE
========================================

Prerequisites:

    - PROJ 4.9.3 or newer. Explained here why:
      http://lists.maptools.org/pipermail/proj/2016-October/007544.html
    - CMake/CPack

0. Make sure the directory into which you have cloned the repository does
   not contain "build" in it !

1. Adjust the version number:

    If preparing a release candidate "RCx" should be added
    to PROJ_DATUMGRID_VERSION_MINOR in CMakeLists.txt.

    If preparing the final release any postfixes to the version
    number should be stripped.

2. Create tarball and zip:

    $ mkdir build
    $ cd build
    $ cmake ..
    $ make dist

3. Check repo for grid changes:

    $ git status

4. Check contents of tarball and zip

    $ tar tvf proj-datumgrid-*.tar.gz
    $ unzip -l proj-datumgrid-*.zip

5. Upload the files to download.osgeo.org/proj

    a) Copy the files: If you are preparing a release, you know how to do this.

    b) Create/update the symbolic link from proj-datumgrid-XXXX.zip to
       proj-datumgrid-latest.zip and proj-datumgrid-XXXX.tar.gz to
       proj-datumgrid-latest.tar.gz

6. Clean up

    $ cd ..
    $ rm -rf build

7. Create git tag

    Only do this for final releases.

    $ git tag $(echo $(grep "set(PROJ_DATUMGRID_VERSION_MAJOR" CMakeLists.txt | awk '{print $2}' | sed 's/)//').$(grep "set(PROJ_DATUMGRID_VERSION_MINOR" CMakeLists.txt | awk '{print $2}' | sed 's/)//'))
    $ git push --tags

    Create a release on GitHub.

8. Bump the version number:

    In CMakeLists.txt add 1 to PROJ_DATUMGRID_VERSION_MINOR
    and add a prerelease postfix so that

        set(PROJ_DATUMGRID_VERSION_MINOR 7)

    becomes

        set(PROJ_DATUMGRID_VERSION_MINOR 8-prerelease)

    Commit the updated CMakeLists.txt

9. Repeat the above stepts for the region specific archives
   if there were changes since the last release

9.1. Oceania

    $ cd oceania

9.1.1. Adjust the version number

    If preparing a release candidate "RCx" should be added
    to PROJ_DATUMGRID_OCEANIA_VERSION_MINOR in CMakeLists.txt.

    If preparing the final release any postfixes to the version
    number should be stripped.

9.1.2. Create tarball and zip:

    $ mkdir build
    $ cd build
    $ cmake ..
    $ make dist

9.1.3. Check repo for grid changes:

    $ git status

9.1.4. Check contents of tarball and zip:

    $ tar tvf proj-datumgrid-oceania-*.tar.gz
    $ unzip -l proj-datumgrid-oceania-*.zip

9.1.5. Upload the files to download.osgeo.org/proj

    a) Copy the files: If you are preparing a release, you know how to do this.

    b) Create/update the symbolic link from proj-datumgrid-oceania-XXXX.zip to
       proj-datumgrid-oceania-latest.zip and proj-datumgrid-oceania-XXXX.tar.gz to
       proj-datumgrid-oceania-latest.tar.gz

9.1.6. Cleanup

    $ cd ..
    $ rm -rf build

9.1.7. Create git tag

    $ git tag oceania-$(echo $(grep "set(PROJ_DATUMGRID_OCEANIA_VERSION_MAJOR" CMakeLists.txt | awk '{print $2}' | sed 's/)//').$(grep "set(PROJ_DATUMGRID_OCEANIA_VERSION_MINOR" CMakeLists.txt | awk '{print $2}' | sed 's/)//'))
    $ git push --tags

    Create a release on GitHub

9.1.8. Bump the version number:

    In CMakeLists.txt add 1 to PROJ_DATUMGRID_OCEANIA_VERSION_MINOR
    and add a prerelease postfix so that

        set(PROJ_DATUMGRID_OCEANIA_VERSION_MINOR 0)

    becomes

        set(PROJ_DATUMGRID_OCEANIA_VERSION_MINOR 1-prerelease)

    Commit the updated CMakeLists.txt