← Back to branch summary

~ubuntu-branches/ubuntu/wily/grass/wily

« back to all changes in this revision

Viewing changes to doc/howto_release.txt

Tags: 7.0.0~rc1+ds1-1~exp1
http://bugs.debian.org/776349
* New upstream release candidate.
* Repack upstream tarball, remove precompiled Python objects.
* Add upstream metadata.
* Update gbp.conf and Vcs-Git URL to use the experimental branch.
* Update watch file for GRASS 7.0.
* Drop build dependencies for Tcl/Tk, add build dependencies:
  python-numpy, libnetcdf-dev, netcdf-bin, libblas-dev, liblapack-dev
* Update Vcs-Browser URL to use cgit instead of gitweb.
* Update paths to use grass70.
* Add configure options: --with-netcdf, --with-blas, --with-lapack,
  remove --with-tcltk-includes.
* Update patches for GRASS 7.
* Update copyright file, changes:
  - Update copyright years
  - Group files by license
  - Remove unused license sections
* Add patches for various typos.
* Fix desktop file with patch instead of d/rules.
* Use minimal dh rules.
* Bump Standards-Version to 3.9.6, no changes.
* Use dpkg-maintscript-helper to replace directories with symlinks.
  (closes: #776349)
* Update my email to use @debian.org address.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/howto_release.txt
1
 
How to release GRASS binaries and source code
 
1
How to release GRASS GIS binaries and source code
2
2
 
3
 
$Date: 2010-08-27 09:18:57 +0200 (Fri, 27 Aug 2010) $
 
3
$Date: 2014-12-22 14:38:58 +0100 (Mon, 22 Dec 2014) $
4
4
 
5
5
Note: This text contains *some* rules only applicable to the
6
 
      development coordinators at CEA (currently Markus Neteler).
 
6
      development coordinator (currently Markus Neteler, PSC Chair).
7
7
 
8
8
 
9
9
###########################################
14
14
###########################################
15
15
(A) HOWTO create a release
16
16
 
17
 
1. Local work (basically at FEM, Italy)
 
17
1. Local work (done by release coordinator)
18
18
 
19
19
   - svn up
20
20
   - check if
21
21
        ( cd doc/raster/r.example/ ; make )
22
22
        ( cd doc/vector/v.example/ ; make )
23
23
      still compile; fix otherwise
 
24
 
 
25
   - Check that autoconf scripts are up-to-date (to do only in RC cycle!):
 
26
 
 
27
      rm -f config.guess config.sub
 
28
      wget http://git.savannah.gnu.org/cgit/config.git/plain/config.guess
 
29
      wget http://git.savannah.gnu.org/cgit/config.git/plain/config.sub
 
30
      svn diff config.guess config.sub
 
31
      autoconf-2.13
 
32
      # check and submit to SVN:
 
33
      svn ci -m"config.guess + config.sub: updated from http://git.savannah.gnu.org/cgit/config.git/plain/" config.guess config.sub configure
 
34
      # test by running ./configure 
 
35
 
24
36
   - make distclean
25
37
 
26
38
   - cleanup rubbish:
 
39
       rm -f locale/templates/*.pot
 
40
       rm -f locale/po/messages.mo
27
41
       find . -name '*~'     | xargs rm
28
42
       find . -name '*.bak'  | xargs rm
29
43
       find . -name '.#*'    | xargs rm
40
54
      vim include/VERSION
41
55
 
42
56
#example:
43
 
6
44
 
4
45
 
0RC7
46
 
2010
 
57
7
 
58
0
 
59
0RC1
 
60
2014
47
61
      rm -f include/VERSION~
48
62
 
 
63
    - Update additionally the winGRASS version
 
64
      grass-addons/tools/wingrass-packager/grass_packager_release.bat
 
65
 
49
66
     #version:
50
67
     MAJOR=`cat include/VERSION | head -1 | tail -1`
51
68
     MINOR=`cat include/VERSION | head -2 | tail -1`
53
70
     VERSION=${MAJOR}.${MINOR}.${RELEASE}
54
71
     echo $VERSION
55
72
 
56
 
     svn ci -m"GRASS $VERSION" include/VERSION
 
73
     svn ci -m"GRASS GIS $VERSION" include/VERSION
57
74
     svn up
58
75
 
59
76
 o Create Changelog file on release branch:
71
88
          echo $RELEASETAG
72
89
 
73
90
          URL=https://svn.osgeo.org/grass
74
 
          svn copy $URL/grass/branches/releasebranch_6_4 \
 
91
          svn copy $URL/grass/branches/releasebranch_7_0 \
75
92
               $URL/grass/tags/$RELEASETAG \
76
93
               -m "Tagging release grass_${MAJOR}_${MINOR}_${RELEASE}"
77
94
      
95
112
    vim include/VERSION
96
113
 
97
114
#example
98
 
6
99
 
4
 
115
7
 
116
0
100
117
0svn
101
 
2010
 
118
2014
102
119
 
103
120
    rm -f include/VERSION~
104
121
    svn ci -m"back to SVN" include/VERSION
105
122
 
106
123
 
107
124
 o Store the source tarball (twice) in (use scp -p FILES grass:):
108
 
    SERVER1=download.osgeo.org:/osgeo/download/grass/grass$MAJOR$MINOR/source/
109
 
    SERVER2=grass.osgeo.org:/osgeo/grass/grass-web-public/grass$MAJOR$MINOR/source/
 
125
    SERVER1=grass.osgeo.org:/osgeo/grass/grass-cms/grass$MAJOR$MINOR/source/
 
126
    SERVER2=download.osgeo.org:/osgeo/download/grass/grass$MAJOR$MINOR/source/
110
127
    echo $SERVER1
111
128
    echo $SERVER2
112
129
 
113
130
   # copy along with associated files:
114
 
     scp -p grass-$VERSION.* AUTHORS COPYING ChangeLog_$VERSION.gz INSTALL \
115
 
         REQUIREMENTS.html SUBMITTING SUBMITTING_DOCS \
116
 
         SUBMITTING_PYTHON SUBMITTING_TCLTK SUBMITTING_SCRIPTS neteler@$SERVER1
117
 
     scp -p grass-$VERSION.* AUTHORS COPYING ChangeLog_$VERSION.gz INSTALL \
118
 
         REQUIREMENTS.html SUBMITTING SUBMITTING_DOCS \
119
 
         SUBMITTING_PYTHON SUBMITTING_TCLTK SUBMITTING_SCRIPTS neteler@$SERVER2
 
131
     scp -p grass-$VERSION.* AUTHORS COPYING ChangeLog_$VERSION.gz \
 
132
         INSTALL REQUIREMENTS.html SUBMITTING neteler@$SERVER1
 
133
     scp -p grass-$VERSION.* AUTHORS COPYING ChangeLog_$VERSION.gz \
 
134
         INSTALL REQUIREMENTS.html SUBMITTING neteler@$SERVER2
 
135
    
120
136
 
121
 
 o update web site to new version (http://trac.osgeo.org/grass/browser/grass-web)
122
 
      - rss.xml (for news section)
123
 
      - download/software.inc
124
 
      - grass$MAJOR$MINOR/main.inc
125
 
      - devel/grasshist.html
126
 
      - devel/grassreleases.html
127
 
      - devel/svntags.inc (add tag)
 
137
 o update web site to new version: CMS
 
138
    - News section
 
139
    - http://grass.osgeo.org/download/software/
 
140
    - http://grass.osgeo.org/download/software/sources/
 
141
    - http://grass.osgeo.org/grass70/
 
142
    - http://grass.osgeo.org/home/history/releases/
 
143
    - http://grass.osgeo.org/development/svn/svn-tags/ (add tag): echo $RELEASETAG
128
144
 
129
145
     write announcement
130
 
      - store in trac: http://trac.osgeo.org/grass/wiki/Release/6.XX.YY-News
131
 
      - store in Web as announces/announce_grass$MAJOR$MINOR$RELEASE.html
 
146
      - store in trac: http://trac.osgeo.org/grass/wiki/Release/7.XX.YY-News
 
147
      - store in Web as announces/announce_grass$MAJOR$MINOR$RELEASE.html <- how? with protected PHP upload page?
132
148
 
133
149
 o upload user HTML manual in case of *final release* from compiled English
134
150
   version at (warning: needs stuff to be compiled).
135
151
      - download new source code package, compile with most settings
136
152
      -  cd dist.$ARCH/docs/html
137
 
         echo www/grass$MAJOR$MINOR/manuals/html$MAJOR${MINOR}_user/
138
 
         scp -r * neteler@download.osgeo.org:/osgeo/download/grass$MAJOR$MINOR/manuals/html$MAJOR${MINOR}_user/
139
 
         scp -r * neteler@grass.osgeo.org:/osgeo/download/grass$MAJOR$MINOR/manuals/html$MAJOR${MINOR}_user/
 
153
         echo www/grass$MAJOR$MINOR/manuals/
 
154
         scp -r * neteler@grass.osgeo.org:/osgeo/grass/grass-cms/grass$MAJOR$MINOR/manuals/
 
155
         scp -r * neteler@download.osgeo.org:/osgeo/download/grass/grass$MAJOR$MINOR/manuals/
140
156
 
141
 
 o stable release: update cronjob 'cron_grass64_release_src_snapshot.sh' to next but one
 
157
 o stable release: update cronjob 'cron_grass_HEAD_src_snapshot.sh' to next but one
142
158
                   release tag for the differences
143
159
 
 
160
 o WinGRASS notes:
 
161
 
 
162
   Update grass_packager_release.bat, eg.
 
163
 
 
164
     set MAJOR=7
 
165
     set MINOR=0
 
166
     set PATCH=0beta3
 
167
 
 
168
   Update addons (grass_addons.sh) rules, eg.
 
169
 
 
170
     compile $SVN_PATH/grass7 $GISBASE_PATH/grass700beta3   $ADDON_PATH/grass700beta3/addons
 
171
 
 
172
   Modify grass_copy_wwwroot.sh accordingly, eg.
 
173
 
 
174
     copy_addon 700beta3 7.0.0beta3
 
175
 
144
176
2. Tell others about it:
145
177
 
146
178
 * If release candidate:
160
192
                         <grass-dev@lists.osgeo.org>
161
193
                       http://lists.osgeo.org/mailman/listinfo/grassuser
162
194
                         <grass-user@lists.osgeo.org>
163
 
                       http://lists.osgeo.org/mailman/listinfo/wingrass
164
 
                         <wingrass@lists.osgeo.org>
165
195
 
166
 
   DebianGIS:          <pkg-grass-general@lists.alioth.debian.org>
 
196
   DebianGIS:          <debian-gis@lists.debian.org>
167
197
   FreeGIS:            <freegis-list@intevation.de>
168
198
   Geowanking:         <geowanking@lists.burri.to>
169
199
   OSGeo.org:          <news_item@osgeo.org>
170
200
 
171
201
 Email:
172
 
   http://www.gismonitor.com/news/submit_news.php (matteo@gismonitor.com)
173
202
   http://www.gis-news.de/  (franz-josef.behr@gismngt.de)
174
203
   http://www.gisdevelopment.net (news@gisdevelopment.net)
175
204
   http://spatialnews.geocomm.com/submitnews.html (not free any more, convince editor@geocomm.com)
176
 
   admin@cartographyonline.com
177
 
   redazionenews@mondogis.net
 
205
   redazione@geoforus.it
178
206
   mfeilner@linuxnewmedia.de
179
207
   info@harzer.de
180
208
   info@j-geoinfo.net
 
209
   pr@geocomm.com
 
210
   editor-geo@geoconnexion.com
181
211
 
182
212
 Web:
 
213
   https://plus.google.com/u/0/communities/111147786674687562495 (G+ GRASS GIS community)
183
214
   http://slashgeo.org/submit.pl
184
215
   http://freshmeat.net/projects/grass/?highlight=GRASS (update, MN)
185
216
   http://linuxtoday.com/contribute.php3
186
 
   http://www.newsforge.com/submit.pl
187
 
   http://osx.macnn.com/    (email to "contact" -> news tips)
188
 
   http://www.giscafe.com/submit_material/submit_options.php#Press (MN)
 
217
   https://joinup.ec.europa.eu/software/grassgis/home (submit news, MN)
 
218
   http://www.macnn.com/contact/newstips/1
 
219
   http://www10.giscafe.com/submit_material/submit_options.php#Press (MN)
189
220
   http://www.freegis.org   (update, MN)
190
 
   http://www.blinkgeo.com (markusN)
191
 
   http://www.directionsmag.com/pressreleases.php (News -> Post Press Release)
 
221
   http://www.directionsmag.com/pressreleases/ (News -> Post Press Release)
192
222
   http://www.gnu.org/directory/science/geography/grass.html
193
223
   http://www.kde-apps.org/content/show.php?content=19776
194
224
   http://www.opendesktop.org/content/show.php?content=19776
195
225
   http://news.eoportal.org/share_news.html (MN) 
196
226
            -> Share your news with the EO community
197
227
   http://www.osdir.com/Downloads+index-req-viewsdownload-sid-206.phtml
198
 
   http://www.foss4g.org/FOSS4G/modules.php?name=Submit_News
199
228
   http://groups.google.com/group/Remote-Sensing-GIS-for-a-New-World
200
229
   http://groups.google.com/group/comp.infosystems.gis
201
230
   http://www.heise.de/software/download/edit_7105 (update, MN)
202
231
 
 
232
   See also: http://grass.osgeo.org/wiki/Contact_Databases
203
233
   ... anywhere else? Please add here.
204
234
 
205
235
###########################################
208
238
1. see SVN book:
209
239
   http://svnbook.red-bean.com/en/1.1/ch04s07.html
210
240
 
211
 
   GRASS 6.4 development branch:
212
 
          BRANCH=develbranch_6
 
241
   GRASS 7.0 release branch:
 
242
          BRANCH=releasebranch_7_0
213
243
          URL=https://svn.osgeo.org/grass
214
244
          svn copy $URL/grass/trunk \
215
245
                   $URL/grass/branches/$BRANCH \
216
 
                   -m "Development branch for GRASS 6.4.x"
 
246
                   -m "Development branch for GRASS 7.0.x"
217
247
 
218
248
 
219
249
   Switching current local copy to above development branch:
220
250
   (http://svnbook.red-bean.com/en/1.1/ch04s05.html)
221
251
           cd /path/to/your/local/copy/trunk
222
 
           svn switch https://svn.osgeo.org/grass/grass/branches/develbranch_6 .
223
 
 
 
252
           svn switch https://svn.osgeo.org/grass/grass/branches/releasebranch_7_0 .
 
253
 
 
254
----------
 
255
GRASS GIS 7.0 release branch creation
 
256
 
 
257
svn copy https://svn.osgeo.org/grass/grass/trunk/ \
 
258
    https://svn.osgeo.org/grass/grass/branches/releasebranch_7_0 \
 
259
    -m "Creating the GRASS GIS 7.0 release branch (development started in 04/2008, r31142)"
224
260