From 7ec064b88eac84234776c9cf43f60b2efd0d1d6a Mon Sep 17 00:00:00 2001
From: Gavin Andresen <gavinandresen@gmail.com>
Date: Tue, 25 Oct 2011 12:09:08 -0400
Subject: Update documentation to reflect reality (no win32 gitian builds, new
 Mac process)

---
 doc/release-process.txt | 59 ++++++++++++++++---------------------------------
 1 file changed, 19 insertions(+), 40 deletions(-)

(limited to 'doc/release-process.txt')

diff --git a/doc/release-process.txt b/doc/release-process.txt
index 4d06627006..ceff72483d 100644
--- a/doc/release-process.txt
+++ b/doc/release-process.txt
@@ -5,65 +5,55 @@
 * update (commit) version in OSX app bundle
  contrib/Bitcoin.app/Contents/Info.plist
 
-  * CFBundleShortVersionString should have value like 0.3.23
-  * CFBundleVersion should have value like 323
+  * CFBundleShortVersionString should have value like 0.5.0
+  * CFBundleVersion should have value like 500
 
 * tag version in git
 
-  $ git tag -a v0.3.23
+  $ git tag -a v0.5.0
 
 * write release notes.  git shortlog helps a lot:
 
-  $ git shortlog --no-merges v0.3.22..
+  $ git shortlog --no-merges v0.4.0..
 
 * create source-only archive
 
-  $ git archive --format=tar --prefix=bitcoin-0.3.23/ HEAD | \
-  	gzip -9c > ~/tmp/bitcoin-0.3.23-src.tar.gz 
+  $ git archive --format=tar --prefix=bitcoin-0.5.0/ HEAD | \
+  	gzip -9c > ~/tmp/bitcoin-0.5.0-src.tar.gz 
 
 * perform gitian builds
 
   * From a directory containing the bitcoin source, gitian-builder and gitian.sigs
-  $ export VERSION=0.3.23
+  $ export VERSION=0.5.0
   $ cd ./gitian-builder
   $ ./bin/gbuild --commit bitcoin=v$VERSION ../bitcoin/contrib/gitian-descriptors/gitian.yml
   $ ./bin/gsign --signer (your gitian key, ie bluematt, sipa, etc) --release $VERSION --destination ../gitian.sigs/ ../bitcoin/contrib/gitian-descriptors/gitian.yml
   $ cd build/out
   $ zip bitcoin-$VERSION-linux-gitian.zip *
   $ mv bitcoin-$VERSION-linux-gitian.zip ../../
-  $ ./bin/gbuild --commit bitcoin=v$VERSION ../bitcoin/contrib/gitian-descriptors/gitian-win32.yml
-  $ ./bin/gsign --signer (your gitian key, ie bluematt, sipa, etc) --release $VERSION-win32 --destination ../gitian.sigs/ ../bitcoin/contrib/gitian-descriptors/gitian-win32.yml
-  $ cd build/out
-  $ zip bitcoin-$VERSION-win32-gitian.zip *
-  $ mv bitcoin-$VERSION-win32-gitian.zip ../../
- 
+
+  * NOTE: gitian cross-compiled builds for Windows is broken, we are building
+    Windows binaries using a public Amazon AWS instance for this release.
+
   Build output expected:
   1. linux 32-bit and 64-bit binaries + source (bitcoin-$VERSION-linux-gitian.zip)
-  2. windows 32-bit binary, installer + source (bitcoin-$VERSION-win32-gitian.zip)
-  3. Gitian signatures (in gitian.sigs/$VERSION[-win32]/(your gitian key)/
+  2. Gitian signatures (in gitian.sigs/$VERSION[-win32]/(your gitian key)/
 
 * repackage gitian builds for release as stand-alone zip/tar/installer exe
 
-  * Windows .zip and setup.exe:
-  $ mkdir bitcoin-$VERSION-win32
-  $ cd bitcoin-$VERSION-win32
-  $ unzip bitcoin-$VERSION-win32-gitian.zip
-  $ mv bitcoin-$VERSION-win32-setup.exe ..
-  $ cd ..; zip bitcoin-$VERSION-win32.zip bitcoin-$VERSION-win32
-
   * Linux .tar.gz:
   $ mkdir bitcoin-$VERSION-linux
   $ cd bitcoin-$VERSION-linux
   $ unzip bitcoin-$VERSION-linux-gitian.zip
   $ cd ..; tar czvf bitcoin-$VERSION-linux.tar.gz bitcoin-$VERSION-linux
 
+* Compile Windows .zip and setup.exe on Amazon EC2 instance
+  TODO: document process
+
 * perform Mac build
-  * From the bitcoin source dir
-  $ cd contrib
-  $ ./create_osx_dmg.sh
-  $ mv Bitcoin.dmg bitcoin-$VERSION-macosx.dmg
+  TODO: document process
 
-* upload source and builds to SF
+* upload source and builds to SourceForge
 
 * create SHA1SUMS for builds, and PGP-sign it
 
@@ -80,18 +70,7 @@
   * Collect enough gitian signatures to meet minimum_weight (see contrib/gitian-downloader/*-download-config)
 
   * From a directory containing bitcoin source, gitian.sigs and gitian zips
-  $ export VERSION=0.3.23
-  $ mkdir bitcoin-$VERSION-win32-gitian; cd bitcoin-$VERSION-win32-gitian
-  $ unzip ../bitcoin-$VERSION-win32-gitian.zip
-  $ mkdir gitian
-  $ cp ../bitcoin/contrib/gitian-downloader/*.pgp ./gitian/
-  $ for file in `ls ../gitian.sigs/$VERSION-win32/`; do
-  $   cp ../gitian.sigs/$VERSION-win32/$file/bitcoin-build.assert ./gitian/$file-build.assert
-  $   cp ../gitian.sigs/$VERSION-win32/$file/bitcoin-build.assert.sig ./gitian/$file-build.assert.sig
-  $ done
-  $ zip bitcoin-$VERSION-win32-gitian.zip *
-  $ cp bitcoin-$VERSION-win32-gitian.zip ../
-  $ cd ..
+  $ export VERSION=0.5.0
   $ mkdir bitcoin-$VERSION-linux-gitian; cd bitcoin-$VERSION-linux-gitian
   $ unzip ../bitcoin-$VERSION-linux-gitian.zip
   $ mkdir gitian
@@ -103,6 +82,6 @@
   $ zip bitcoin-$VERSION-linux-gitian.zip *
   $ cp bitcoin-$VERSION-linux-gitian.zip ../
 
-  * Upload gitian zips to SF
+  * Upload gitian zips to SourceForge
 
 
-- 
cgit v1.2.3