tools/README.txt

   1 HOW TO MAKE A RELEASE\r
   2 \r
   3 Originally by Jason Perkins (starkos@industriousone.com)\r
   4 \r
   5 \r
   6 PREREQUISITES\r
   7 \r
   8 In order to build an OpenDE release you'll need:\r
   9 \r
  10 * A Windows system\r
  11 * A Posix-like system (Linux, Mac OS X, Cygwin)\r
  12 * Visual Studio 2003 or later (for C++ release)\r
  13 * Visual Studio 2005 or later (for .NET release)\r
  14 * Subversion (command line version)\r
  15 * 7zip (command line version)\r
  16 * Doxygen\r
  17 \r
  18 All command line binaries (svn, 7z, doxygen) must be available on \r
  19 the system search path. \r
  20 \r
  21 \r
  22 \r
  23 INSTRUCTIONS\r
  24 \r
  25 * Update the version numbers in configure.in\r
  26 \r
  27     AC_INIT(ODE,0.9.0-rc1,ode@ode.org)\r
  28     ODE_CURRENT=0\r
  29     ODE_REVISION=9\r
  30     ODE_AGE=0-rc1\r
  31 \r
  32 \r
  33 * Create a release branch in Subversion. Using TortoiseSVN:\r
  34 \r
  35     Update working copy\r
  36     Right-click working copy folder and choose Branch/Tag\r
  37     To https://opende.svn.sourceforge.net/svnroot/branches/0.9.0-rc1\r
  38     Enter log message "Branching for 0.9.0-rc1 release"\r
  39     OK\r
  40 \r
  41   Using the command line:\r
  42 \r
  43     $ cd ode\r
  44     $ svn update\r
  45     $ svn copy . -m "Branching for..." https://opende.... (see above)\r
  46 \r
  47 \r
  48 * Run msw-release.bat from a Visual Studio command prompt to create\r
  49   the Windows binary package. I've used VS2003 for all releases since\r
  50   0.5, but am thinking about switching up to VS2005. The format of\r
  51   this command is:\r
  52 \r
  53     > msw-release.bat 0.9.0-rc1\r
  54 \r
  55   The version argument supplied to the script must match the name of\r
  56   the release branch in Subversion.\r
  57 \r
  58 \r
  59 * Run dotnet-release.bat to create the .NET bindings package. This\r
  60   script must be run from a Visual Studio 2005 (or later) command\r
  61   prompt. The format of the command is:\r
  62 \r
  63     > dotnet-release.bat 0.9.0-rc1\r
  64 \r
  65   The version argument supplied to the script must match the name of\r
  66   the release branch in Subversion.\r
  67 \r
  68 \r
  69 * Run src-release.sh to create the source package. This script must be\r
  70   run from a Posix-like environment in order to prepare the configure\r
  71   script. I've tried it under Linux, Mac OS X, and Windows with Cygwin.\r
  72 \r
  73     $ ./src-release.sh 0.9.0-rc1\r
  74 \r
  75   The version argument supplied to the script must match the name of\r
  76   the release branch in Subversion.\r
  77 \r
  78 \r
  79 * Visit the project site on SourceForge (http://sf.net/projects/opende)\r
  80   and create a new file release including all of the files.\r
  81   \r
  82   \r
  83 SANITY CHECKING\r
  84 \r
  85 A few optional, but recommeded, checks to make sure that everything\r
  86 worked properly.\r
  87 \r
  88   The binaries exist in lib/\r
  89 \r
  90   include/ode/config.h exists\r
  91 \r
  92   configure script exists (if not, make sure autotools is installed)\r
  93 \r
  94   docs exist in docs/ (if not, make sure doxygen is on the path)\r