]> https://gitweb.dealii.org/ - release-papers.git/commitdiff
update release tasks
authorMatthias Maier <tamiko@43-1.org>
Sat, 5 May 2018 03:04:58 +0000 (22:04 -0500)
committerMatthias Maier <tamiko@43-1.org>
Sat, 5 May 2018 03:04:58 +0000 (22:04 -0500)
release-tasks

index 14643c261182a8be1e4a3531a24aa7325a6e9738..0bf004b72834320935564d7ccb2fad6ce82fcb17 100644 (file)
@@ -16,7 +16,7 @@ Subject: Release preparations
 
 All,
 
-we would like to start the release process for deal.II 8.3.0 soon. Please let us
+we would like to start the release process for deal.II 9.0.0 soon. Please let us
 know if you have any last minute things that need to be addressed (bugs,
 documentation issues, configuration problems, etc.).
 
@@ -99,7 +99,7 @@ Best
            sort |uniq
 
      Compare with the commit list:
-       git log --date=short --format="%an %aE" v8.3.0..HEAD | sort | uniq
+       git log --date=short --format="%an %aE" v8.5.0..HEAD | sort | uniq
 
 
 
@@ -247,7 +247,7 @@ Contributors for 9.0: (updated 2018-04-19)
 
 
 *** Caveat: for a minor version x.y.Z,
-*** 1-3 must be performed on the corresponding release branch, e.g. 'dealii-8.2'
+*** 1-3 must be performed on the corresponding release branch, e.g. 'dealii-9.0'
 *** AND on HEAD
 
 
@@ -260,11 +260,11 @@ Contributors for 9.0: (updated 2018-04-19)
         cd build-doc
         cmake ../dealii -DDEAL_II_COMPONENT_DOCUMENTATION=ON
         make documentation
-        cp doc/news/changes.h ../dealii/doc/news/8.4.2-vs-8.5.0.h
+        cp doc/news/changes.h ../dealii/doc/news/8.5.0-vs-9.0.0.h
         cd ../dealii
         git checkout -b update-changes-file
-        git add  doc/news/8.4.2-vs-8.5.0.h
-        git commit -m "Update the changelog file for the release." doc/news/8.4.2-vs-8.5.0.h
+        git add  doc/news/8.5.0-vs-9.0.0.h
+        git commit -m "Update the changelog file for the release." doc/news/8.5.0-vs-9.0.0.h
         git rm doc/news/changes/{major,minor,incompatibilities}/*
         git commit -m "Remove now obsolete files." doc/news/changes/{major,minor,incompatibilities}
         git push origin update-changes-file
@@ -277,37 +277,37 @@ Contributors for 9.0: (updated 2018-04-19)
 
 4/  If a x.y.0 release, it is now time to create a release branch:
 
-  git branch dealii-8.2       # exactly 'dealii-X.Y' to remain consistent!
+  git branch dealii-9.0       # exactly 'dealii-X.Y' to remain consistent!
 
-  # Update VERSION from 8.2.0-pre to 8.2.0-rc1
+  # Update VERSION from 9.0.0-pre to 9.0.0-rc0
   #
-  # Note: Please do not use "8.2.0" directly because the soname is derived
-  # from the current version number. Therefore, 8.2.0 must only be used for
-  # the final, tagged and distributed code.
+  # Note: Please do not use "9.0.0" (or "9.0.0-rc1") directly because the
+  # soname is derived from the current version number. Therefore, 9.0.0
+  # must only be used for the final, tagged and distributed code.
 
   git commit -a -m "update VERSION"
 
-  git push origin dealii-8.2  # where origin is the remote pointing to
+  git push origin dealii-9.0  # where origin is the remote pointing to
                               # github.com/dealii/dealii.git
 
   Note: Without a pull request!
 
-5/ Update the VERSION from 8.2.0-pre to 8.3.0-pre on master
+5/ Update the VERSION from 9.0.0-pre to 9.1.0-pre on master
 
   git commit -a -m "update VERSION"
 
   [ pull request for master branch ]
 
-6/ update the official tester to test on the release branch dealii-8.2
+6/ update the official tester to test on the release branch dealii-9.0
 
-   An empty checkout in a folder 'dealii-8.2' can be obtained via
+   An empty checkout in a folder 'dealii-9.0' can be obtained via
 
-   git clone --branch dealii-8.2 git://github.com/dealii/dealii.git deal-8.2
+   git clone --branch dealii-9.0 git://github.com/dealii/dealii.git deal-9.0
 
 6a/ On mainline, do something like this to require the current dev version
     for the tutorials and in the documentation:
 
-    perl -pi -e 's/8.4 QUIET/8.5.0 QUIET/g;' examples/*/CMakeLists.txt
+    perl -pi -e 's/8.5.0 QUIET/9.0.0 QUIET/g;' examples/*/CMakeLists.txt
  
     also check doc/users/* and tests/*:
 
@@ -348,7 +348,7 @@ It would be great if you could test it on your machine with your typical
 configuration. For this update your git repository and switch to the
 release branch:
   git remote update
-  git checkout dealii-8.3
+  git checkout dealii-9.0
 
 If no further regressions show up we will release [planned date]
 
@@ -357,7 +357,7 @@ Thanks!
 
 
 8/ Remove unfinished tutorial programs.
-   For 8.5, these are steps 47, 50
+   For 9.0, these are steps 47, 50
 
    a) Delete directories on the branch:
 
@@ -375,7 +375,7 @@ Thanks!
       https://svnhp.dealii.org/trunk/homepage/images/steps/readme.txt
 
 
-9/  Write up a short release note and save it as announce-8.3
+9/  Write up a short release note and save it as announce-9.0
 9a/ Write the release paper in the release-papers/ subdirectory
 
 10/ Test the branch thoroughly:
@@ -398,7 +398,7 @@ Thanks!
      very least compile. If possible, also run them to make sure they
      don't trip up any exceptions.
 
-11/ In a clean source directory of the dealii-8.2 branch, do
+11/ In a clean source directory of the dealii-9.0 branch, do
       mkdir builddoc
       cd builddoc
       cmake -DDEAL_II_COMPONENT_DOCUMENTATION=ON -DCMAKE_INSTALL_PREFIX=$PWD/../installeddoc ../
@@ -426,24 +426,24 @@ Thanks!
 
 12/ Push the button:
 
-    a) Change VERSION to 8.2.0 for a release and to 8.2.0-rc1 for a release
+    a) Change VERSION to 9.0.0 for a release and to 9.0.0-rc1 for a release
        candiate and commit:
        git commit -m "update VERSION for release"
 
     b) (Signed) tag the commit with:
 
       # for the final release:
-      git tag -s -m "deal.II Version 8.3.0" v8.3.0
+      git tag -s -m "deal.II Version 9.0.0" v9.0.0
       # or alternatively for a release candidate:
-      git tag -s -m "deal.II Pre-Release Version 8.3.0-rc1" v8.3.0-rc1
+      git tag -s -m "deal.II Pre-Release Version 9.0.0-rc1" v9.0.0-rc1
 
       You need a working gnupg key for this. (You should have anyway :-P)
 
     c) Push changes to github:
 
       # where origin is the remote pointing to github.com/dealii/dealii.git
-      git push origin dealii-8.3
-      git push origin v8.3.0
+      git push origin dealii-9.0
+      git push origin v9.0.0
 
 
 13/ Create the tar files:
@@ -455,9 +455,9 @@ Thanks!
     what we expect, e.g.
 
       # in a clean git repository:
-      git checkout v8.2.0 # or git checkout v8.2.0-rc1
+      git checkout v9.0.0 # or git checkout v9.0.0-rc1
       rm -r *
-      tar --strip-components=1 -xvf dealii-8.2.0.tar.gz (or dealii-8.2.rc1.tar.gz)
+      tar --strip-components=1 -xvf dealii-9.0.0.tar.gz (or dealii-8.2.rc1.tar.gz)
       git status
 
     Now, the last git status must not show any modified contents!
@@ -465,7 +465,7 @@ Thanks!
 
     Cryptographically sign it (detached, armored signature):
 
-      gpg --detach-sign --armor dealii-8.2.0.tar.gz
+      gpg --detach-sign --armor dealii-9.0.0.tar.gz
 
       (Guido, Timo and Matthias have a suitable gpg in the "pgp strong set")
 
@@ -473,56 +473,56 @@ Thanks!
 
     In a clean working copy of the tagged release version run the script
 
-      ./make_offline_doc.sh 8 2 0
+      ./make_offline_doc.sh 9.0.0
       # or alternatively for a release candidate
-      ./make_offline_doc.sh 8 2 0-rc1
+      ./make_offline_doc.sh 9.0.0-rc1
 
-    to create dealii-8.2.0-offline_documentation.tar.gz
-    (dealii-8.2.0-rc1-offline_documentation.tar.gz). This step needs to be
+    to create dealii-9.0.0-offline_documentation.tar.gz
+    (dealii-9.0.0-rc1-offline_documentation.tar.gz). This step needs to be
     done on a machine that has both a reasonably new doxygen version as
     well as a dot version that can produce pngs. wolfgang's bloc507d has
     both of these programs installed in /home/bangerth/bin/x86/bin.
 
     d) Also sign it:
 
-      gpg --detach-sign --armor dealii-8.2.0-offline_documentation.tar.gz
+      gpg --detach-sign --armor dealii-9.0.0-offline_documentation.tar.gz
 
 
 14a/ Create a pre-release on github:
 
   https://github.com/dealii/dealii/releases/new
 
-    Tag: dealii-8.2.0-rc1 @master
-    Release title: deal.II pre-release version 8.2.0-rc1
+    Tag: dealii-9.0.0-rc1 @master
+    Release title: deal.II pre-release version 9.0.0-rc1
 
     Description: ""
 
-    Attach dealii-8.2.0-rc1.tar.gz (yes, once again)
-    Attach dealii-8.2.0-rc1.tar.gz.asc
-    Attach dealii-8.2.0-rc1-offline_documentation.tar.gz
-    Attach dealii-8.2.0-rc1-offline_documentation.tar.gz.asc
+    Attach dealii-9.0.0-rc1.tar.gz (yes, once again)
+    Attach dealii-9.0.0-rc1.tar.gz.asc
+    Attach dealii-9.0.0-rc1-offline_documentation.tar.gz
+    Attach dealii-9.0.0-rc1-offline_documentation.tar.gz.asc
 
 14b/ Create a release on github:
 
   https://github.com/dealii/dealii/releases/new
 
-    Tag: dealii-8.2.0 @master
-    Release title: deal.II version 8.2.0
+    Tag: dealii-9.0.0 @master
+    Release title: deal.II version 9.0.0
 
     Description:
     [Short version of release notes as found in announce-8.2]
     A full list of changes can be found at
     http://www.dealii.org/developer/doxygen/deal.II/changes_between_8_2_1_and_8_3.html
 
-    Attach dealii-8.2.0.tar.gz (yes, once again)
-    Attach dealii-8.2.0.tar.gz.asc
-    Attach dealii-8.2.0-offline_documentation.tar.gz
-    Attach dealii-8.2.0-offline_documentation.tar.gz.asc
+    Attach dealii-9.0.0.tar.gz (yes, once again)
+    Attach dealii-9.0.0.tar.gz.asc
+    Attach dealii-9.0.0-offline_documentation.tar.gz
+    Attach dealii-9.0.0-offline_documentation.tar.gz.asc
 
 
 ***
 *** Caveat: Every further commit on an actual release at this point forces
-*** an increase in the patch number, i.e. 8.2.0 -> 8.2.1.
+*** an increase in the patch number, i.e. 9.0.0 -> 8.2.1.
 ***
 *** Go back to 12/ until a release is tagged
 ***
@@ -539,7 +539,7 @@ Thanks!
 
 17/ Ask Luca for Mac packages. Those can be added as additional download
     options to the freshly created release. Mention new naming convention
-    "dealii-8.2.0-.*" for attachments
+    "dealii-9.0.0-.*" for attachments
 
 
 18/ Finish writing the announcement
@@ -552,7 +552,7 @@ Thanks!
 
 19/ announce the release by sending an email to announce-list (file in this
     directory) with subject:
-      Finite Element Software deal.II Version 8.4.0 released
+      Finite Element Software deal.II Version 9.0.0 released
 
 
 19a/ Send a note to the Facebook and Google+ accounts

In the beginning the Universe was created. This has made a lot of people very angry and has been widely regarded as a bad move.

Douglas Adams


Typeset in Trocchi and Trocchi Bold Sans Serif.