= How to Release =

This document describes how to release E-Cell SE version3.

== Change Version No. ==

 There are some files to change their version no. for release.

 * ecell3/
  * configure.in
   {{{
ECELL_MAJOR_VERSION=3
ECELL_MINOR_VERSION=1
ECELL_MICRO_VERSION=91
}}}
  * ecell3.doxy.in is need not any change.
 * ecell3/ecell/
  * configure.in
   {{{

ECELL_MAJOR_VERSION=3
ECELL_MINOR_VERSION=1
ECELL_MICRO_VERSION=91
}}}

 * ecell3/test/ecell.spec
   {{{
Summary: E-Cell is a generic software package for cellular modeling and simulation.
Name: ecell
Version: 3.1.91
Release: 1
}}}

 * NEWS
   {{{
ecell-3.1.91: 9-Mar-2003


ecell-3.1.90: 3-Mar-2003


ecell-3.1.6:  22-Feb-2003
}}}

 === Other packages.. ===
 * ecell3/dmtool/
  * configure.in
   {{{
AC_CANONICAL_SYSTEM
AM_INIT_AUTOMAKE(dmtool,0.0)
AC_PROG_MAKE_SET
}}}
 * ecell3/osogo/
  * configure.in
   {{{
AC_INIT(MainWindow.py)
AM_INIT_AUTOMAKE(osogo,0.0)
dnl AM_CONFIG_HEADER(config.h)
}}}

 * ecell3/modeleditor/
  * configure.in
   {{{
ECELL_MAJOR_VERSION=3
ECELL_MINOR_VERSION=1
ECELL_MICRO_VERSION=102
}}}


 === Change version no. of shared libraries. ===
 ''' If you need change it, read and check the libtool Manual.'''
 * ecell3/ecell/libecs/
  * Makefile.am
   {{{
libecs_la_LDFLAGS= -version-info 0:1:0 #-rpath ${libdir}
libecs_la_LIBADD= ${LIBLTDL} -L${KORANDOM_DIR}/korandom/ -lkorandom ${GSL_LIBADD}
libecs_la_SOURCES=\
}}}

 * ecell3/ecell/libemc/
  * Makefile.am
   {{{
CXXFLAGS= @CXXFLAGS@ #-D_REENTRANT

libemc_la_LDFLAGS= -version-info 0:1:0
}}}

== Put Release Tag into CVS Repository ==
 execute the cvs command at top directory of ecell3 source code as follow,
   {{{
holly:~/wrk/ecell3% cvs tag Release_3_1_91
}}}

== Edit description File (If it is needed.)==
 * ecell3/
  * ChangeLog
  * INSTALL
  * NEWS
  * AUTHORS


== Make tarball and check this ==
 * make tarball (including document files)
  {{{
lupin:~/ecell/ecell3% ./autogen.sh
lupin:~/ecell/ecell3% make doc-all
lupin:~/ecell/ecell3% make dist
}}}
 '''and then the installation test is necessary step before release.'''

=== Make RPM package ===
 * check your local X-Windows screen permission (need xhost + )
 * copy the tarball and .SPEC file to src/redhat directory and do some step as follow, 
 {{{
holly:~/wrk/ecell3% sudo su
Password:
[root@holly ecell3]# cp -a ./ecell-3.1.91.tar.gz /usr/src/redhat/SOURCES/
[root@holly ecell3]# cp -a ./test/ecell.spec /usr/src/redhat/SPECS/
[root@holly ecell3]# cd /usr/src/redhat/SPECS/
[root@holly SPECS]# rpmbuild -ba ecell.spec
...
[root@holly SPECS]# ls ../SRPMS/
ecell-3.1.91-1.src.rpm 

[root@holly SPECS]# ls ../RPMS/i386/
ecell-3.1.91-1.i386.rpm 
[root@holly SPECS]#
}}}