Update release procedures

1 files changed, 62 insertions, 46 deletions

diff --git a/doc/release b/doc/release
index 22c4bfc..f56ddea 100644
--- a/doc/release
+++ b/doc/release
@@ -2,25 +2,41 @@
 
 [X] Test with the latest GCC snapshot.
 
-    - Build latest snapshot (see etc1/gcc/from-source.txt) and install
-      in /usr/local
+    - Build latest snapshot (see etc1/gcc/from-source.txt) and install in
+      /usr/local. See previous snapshot build for configure command line.
+
     - Configure ODB manually in /tmp/odb and smoke-test
 
       Will need from-source.txt and
       export LD_LIBRARY_PATH=/usr/local/lib64:$LD_LIBRARY_PATH
 
-    - Run (replace 4.9)
+      Build one of the test directories with this ODB:
+
+      make odb=/tmp/odb/odb/odb
+
+      Then compare with the same directory built with the previous
+      version of GCC to detect any changes in the generated code.
+      To clear the directories, use:
+
+      find . -name '*.o' -o -name '*.d' -o -name driver | xargs rm
+
+    - Run (replace -5)
 
     ./dist.sh -j 22 -complete -test -db pgsql -mssql-test-options \
 --with-mssql-server=tcp:windows2008r2,1435 \
--ccp gcc-4.9 -cxxp g++-4.9 -cxxpflags "-W -Wall -O3" \
--cc gcc-4.9 -cxx g++-4.9 -cxxflags "-W -Wall -O3 -Wno-unknown-pragmas" \
+-ccp gcc-5 -cxxp g++-5 -cxxpflags "-W -Wall -O3" \
+-cc gcc-5 -cxx g++-5 -cxxflags "-W -Wall -Wno-unknown-pragmas" \
 2>&1 | tee dist.log
 
-    - check dist.log for new warnings
+    - Check dist.log for new warnings
+
+    - Uninstall snapshot from /usr/local
 
 [X] Grep through @@.
 
+    cd ~/work/odb/odb
+    grep -r '@@' odb | grep '@@' | grep -v forward | grep -v Wextra
+
     - Make sure new simple value pragmas are added to the map in pragma.cxx
 
     - Make sure newly added options support database prefix, if necessary.
@@ -38,19 +54,19 @@
 [X] Make sure correct license headers are used in respective runtimes
     (search for GPL, NCUEL).
 
-[X] Update version information, dates in: version, version.hxx, man pages,
+[ ] Update version information, dates in: version, version.hxx, man pages,
     manual. Grep the source code for the previous version.
 
-[X] Proofread NEWS file.
+[ ] Proofread NEWS file.
 
-[X] Update/add prerequisites in INSTALL files.
+[ ] Update/add prerequisites in INSTALL files.
 
-[X] Check documentation: manual XHTML, manual PDF, man pages, usage.
+[ ] Check documentation: manual XHTML, manual PDF, man pages, usage.
 
 
 2. Source, Binary Packages and Testing
 
-[X] Run tests and examples from the build tree:
+[ ] Run tests and examples from the build tree:
 
     make clean
     make -j 16 2>&1 | tee build.log
@@ -59,7 +75,7 @@
 
     Run multi-database tests.
 
-[X] Run alternative configuration tests:
+[ ] Run alternative configuration tests:
 
     * Other DB versions
     * Other compilers/versions
@@ -104,7 +120,7 @@
 --with-mssql-server=tcp:windows2008r2,1435 -cc clang -cxx clang++ \
 -cxxflags "-std=c++11 -W -Wall -Wno-unknown-pragmas -O0" 2>&1 | tee dist.log
 
-[X] Run adhoc-test/multi-db
+[ ] Run adhoc-test/multi-db
 
     On Linux:
 
@@ -133,13 +149,13 @@
     - Open new Command Prompt, run setenv.sh, then cd to test-adhoc and
       run test.bat
 
-[X] Package and test distribution (result in /tmp/pack/):
+[ ] Package and test distribution (result in /tmp/pack/):
 
     ./dist.sh -j 22 -complete -test -mssql-test-options \
 --with-mssql-server=tcp:windows2008r2,1435 2>&1 | tee dist.log
     grep -i warning dist.log
 
-[X] Test UNIX install:
+[ ] Test UNIX install:
 
     * Watch out for disk space; build in $HOME to be able to uninstall *
 
@@ -148,7 +164,7 @@
 --with-mssql-server=tcp:windows2008r2,1435 -j 22 2>&1 | tee build.log
     grep -i warning build.log
 
-[X] Test Embedded:
+[ ] Test Embedded:
 
     Copy libodb, libodb-sqlite, and odb-examples .tar.gz packages
     from /tmp/pack to adhoc-tests/raspi.
@@ -182,12 +198,12 @@
 
     ./clean
 
-[X] Build Windows binary (new terminal):
+[ ] Build Windows binary (new terminal):
 
     cd ~/work/odb/build/mingw-w64
     ./build-dist -j 22 -rebuild -pack 2>&1 | tee build.log
 
-[X] Test on Windows with VC 8:
+[ ] Test on Windows with VC 8:
 
     Connect drive T:
 
@@ -197,7 +213,7 @@
       ./all 0 8 all all all 2>&1 | tee all.log
       grep -i warning all.log
 
-[X] Test on Windows with VC 9:
+[ ] Test on Windows with VC 9:
 
     Connect drive T:
 
@@ -207,7 +223,7 @@
       ./all 4 9 all all all 2>&1 | tee all.log
       grep -i warning all.log
 
-[X] Test on Windows with MinGW:
+[ ] Test on Windows with MinGW:
 
     @@ UNIX install test.
     @@ C++11 build (maybe).
@@ -221,7 +237,7 @@
       ./build -rebuild -test 2>&1 | tee build.log
       grep -i warning build.log
 
-[X] Test on Windows with VC 10:
+[ ] Test on Windows with VC 10:
 
     Connect drive T:
 
@@ -234,9 +250,9 @@
 
       grep -i warning all.log
 
-[X] Run multi-db test on Windows (see above).
+[ ] Run multi-db test on Windows (see above).
 
-[X] Test on Windows with VC 11:
+[ ] Test on Windows with VC 11:
 
     Connect drive T:
 
@@ -246,7 +262,7 @@
       ./all 4 11 all all all 2>&1 | tee all.log
       grep -i warning all.log
 
-[X] Build and Test Solaris x86 binary:
+[ ] Build and Test Solaris x86 binary:
 
     cd ~/work/odb/build
     ./pack solaris
@@ -264,7 +280,7 @@
     ./build-test -rebuild -test -j 1 ./cc-i686-12u2-stlport 2>&1 | tee build.log
     grep -i warning build.log
 
-[X] Build and Test Solaris SPARC binary:
+[ ] Build and Test Solaris SPARC binary:
 
     cd ~/work/odb/build
     ./pack solaris
@@ -279,7 +295,7 @@
     grep -i warning build.log
 
 
-[X] Build and Test MacOS X x86 binary:
+[ ] Build and Test MacOS X x86 binary:
 
     cd ~/work/odb/build
     ./pack darwin
@@ -300,7 +316,7 @@
     ./build-test -rebuild -test -j 1 ./gcc-qt 2>&1 | tee build.log
     grep -i warning build.log
 
-[X] Build and Test GNU/Linux x86 binary:
+[ ] Build and Test GNU/Linux x86 binary:
 
     @@ Verify features.h is removed from include-fixed.
 
@@ -321,7 +337,7 @@
       ./build-test -rebuild -test -j 16 ./gcc 2>&1 | tee build.log
       grep -i warning build.log
 
-[X] Build and Test GNU/Linux x86-64 binary:
+[ ] Build and Test GNU/Linux x86-64 binary:
 
     @@ Verify features.h is removed from include-fixed.
 
@@ -346,7 +362,7 @@
       @@ TODO test with mysql, pgsql, and sqlite, Use gcc-minimal or
       install Boost and Qt.
 
-[X] Build .deb packages
+[ ] Build .deb packages
 
     Copy standard linux packages to build/debian/, unpack them:
 
@@ -378,7 +394,7 @@
     man odb
     sudo dpkg -P odb
 
-[X] Build .rpm packages
+[ ] Build .rpm packages
 
     Save standard linux packages in /tmp/pack and rebuild them with
     the -libexec libexec option. Copy them to ~/rmp/SOURCES/
@@ -407,19 +423,19 @@
     man odb
     sudo rpm -e odb
 
-[X] Tag the new version:
+[ ] Tag the new version:
 
     ./tag.sh X.Y.Z
 
 
 3. Dependencies
 
-[X] Release all dependencies that have changes.
+[ ] Release all dependencies that have changes.
 
 
 4. Publishing
 
-[X] Generate .sha1-sums, latest links for binaries and source distributions:
+[ ] Generate .sha1-sums, latest links for binaries and source distributions:
 
     cd ~/work/codesynthesis.com/public/download/odb/X.Y
     ../../../../procedures/odb-sha1.sh X.Y.Z
@@ -429,7 +445,7 @@
 
     ../../../../procedures/odb-latest.sh X.Y.Z-N
 
-[X] Project page modifications:
+[ ] Project page modifications:
 
     - overview (if major new features worth mentioning)
     - features
@@ -440,7 +456,7 @@
 
     Proofread changes.
 
-[X] Copy doc/ leaving only .css, .png, .xhtml, .ps, and .pdf files. Make
+[ ] Copy doc/ leaving only .css, .png, .xhtml, .ps, and .pdf files. Make
     the following modifications to the .xhtml files:
 
     1. Remove XML declaration (the first line).
@@ -448,22 +464,22 @@
 
        <!--[if lt IE 7]><link rel="stylesheet" type="text/css" href="/default-ie.css"/><![endif]-->
 
-[X] Update download links in the download page. Add new packages if any.
+[ ] Update download links in the download page. Add new packages if any.
 
-[X] Test sandbox.
+[ ] Test sandbox.
 
-[X] Sync sandbox with production (do --dry-run first):
+[ ] Sync sandbox with production (do --dry-run first):
 
     cd ~/work/codesynthesis.com
     rsync -avz --copy-unsafe-links --dry-run public/ codesynthesis.com:/var/www/codesynthesis.com/public/
 
-[X] While uploading, prepare mailing list announcement.
+[ ] While uploading, prepare mailing list announcement.
 
-[X] Test production.
+[ ] Test production.
 
-[X] Announce on the odb-users, odb-announcement mailing list.
+[ ] Announce on the odb-users, odb-announcement mailing list.
 
-[X] Write shorter version of the announcement and update the following pages
+[ ] Write shorter version of the announcement and update the following pages
     and feeds:
 
     /products/odb/index.xhtml  (News box)
@@ -477,11 +493,11 @@
 
 5. Announcements
 
-[X] Update version/release date in Wikipedia: main page and ORM comparison.
+[ ] Update version/release date in Wikipedia: main page and ORM comparison.
 
-[X] Write a blog post.
+[ ] Write a blog post.
 
-[X] Write and send external announcement. See seperate page for the list
+[ ] Write and send external announcement. See seperate page for the list
     of places.
 
-[X] Update Wikipedia page with new major features, if any.
+[ ] Update Wikipedia page with new major features, if any.