mirror of https://github.com/CGAL/cgal
107 lines
4.5 KiB
Plaintext
107 lines
4.5 KiB
Plaintext
This is what you need to do to create a release:
|
|
------------------------------------------------
|
|
|
|
SVN Release Branch:
|
|
-------------------
|
|
|
|
Before releasing proper, you need to create a branch, and run the internal
|
|
release process on this branch for some time. Experience shows (at least in
|
|
3.1) that there is very few development (on the packages to be released) on the
|
|
trunc. So it seems best to branch as late as possible, in order to avoid the
|
|
(small) pain of commiting things twice during the final stabilization phase.
|
|
|
|
For branching, you need to :
|
|
- have write access to all packages
|
|
- export svncgal=svn+ssh://scm.gforge.inria.fr/svn/cgal
|
|
- svn co $svncgal/trunk
|
|
- svn cp $svncgal/trunk $svncgal/tags/CGAL_M_m_branch_tag
|
|
- svn cp $svncgal/trunk $svncgal/branches/CGAL_M_m_branch
|
|
|
|
Releasing:
|
|
----------
|
|
|
|
For the library:
|
|
|
|
Let <release_dir> be the directory in which you plan to build the release.
|
|
|
|
1. update the CHANGES file in this package to correspond to this
|
|
release
|
|
2. copy the latest internal release to <release_dir>
|
|
3. unpack it and rename the directory CGAL-M.m
|
|
4. edit the script release_scripts/make_public_release as instructed
|
|
in the script
|
|
5. cd CGAL-M.m
|
|
6. run the script release_scripts/make_public_release to
|
|
Remove non-public parts.
|
|
Find all .C and .h files and collect them in a file
|
|
Edit include/CGAL/version.h
|
|
7. Copy Release/CHANGES
|
|
|
|
For the manuals:
|
|
|
|
1. Check out the package Manual from the SVN server and follow the
|
|
instructions in the INSTALL file
|
|
2. cd Manual
|
|
3. install_manual_files ?.?-I-?? (number of latest internal release)
|
|
4. follow the directions in Manual/README to create the
|
|
manuals (but don't install them yet)
|
|
5. in the CGAL-M.m directory, create doc_ps, doc_pdf and
|
|
doc_html/installation directories to hold the installation
|
|
doc. Copy the appropriate files from directory
|
|
Manual/CGAL-M.m_doc_tex/installation to these directories.
|
|
|
|
6. For the HTML version in CGAL-M.m/doc_html (NOT in the Manual
|
|
directory), do the following bit of editing:
|
|
remove the navigation links to bibliography, index and title;
|
|
remove the files title.html and manual_index.html, to_html.log.
|
|
|
|
Package the code:
|
|
1. In directory <release_dir> do
|
|
find CGAL-M.m -exec touch 01221530 {} \;
|
|
in order to touch all files (Here the date/time Jan 22, 15:30 was
|
|
used as an example)
|
|
2. Make CGAL-M.m.tar.gz with tar and gzip and CGAL-M.m.zip with zip.
|
|
gtar zcf CGAL-M.m.gtar.gz CGAL-M.m
|
|
tar cf CGAL-M.m.tar CGAL-M.m
|
|
gzip CGAL-M.m.tar
|
|
zip -r CGAL-M.m.zip CGAL-M.m
|
|
3. The .zip file for the code needs to be repackaged for use with
|
|
InstallShield. Contact the person in charge of Windows support.
|
|
|
|
For the web pages:
|
|
1. edit the following web pages (at least)
|
|
Web_pages/news.html
|
|
Web_pages/in_progress.html
|
|
Web_pages/download/download.html
|
|
Web_pages/download/license.html
|
|
Web_pages/home.html
|
|
Web_pages/releases.html
|
|
Web_pages/platforms.html
|
|
change release number in:
|
|
(edit and use Manual/script/rename_version)
|
|
Manual/web_pages/doc_html/frameset/panel*.html
|
|
Manual/web_pages/doc_html/html_tar.html
|
|
Manual/web_pages/doc_ps/index.html
|
|
Manual/web_pages/doc_pdf/index.html
|
|
2. update the cgi-bin/cgal_download.pl script to add the new release,
|
|
goes then to /www/pub/cgi-bin/www.cgal.org/
|
|
3. Perhaps update the download/CGALWin directory with new versions
|
|
of the library for new platforms. [obsolete since CGAL 3.0, Lutz]
|
|
|
|
Install everything:
|
|
1. install the manual (and include files) in
|
|
/www/pub/www.cgal.org/Manual using "make install"
|
|
2. copy the .tar.gz and .zip files for the library and
|
|
the documentation to /ftp/pub/outgoing/CGAL/
|
|
(can be done with "make pack" for the documentation)
|
|
3. zip the individual .ps files for the documentation using
|
|
make dest_zip_ps
|
|
4. install the new web pages, i.e., make a svn commit in Web_pages/,
|
|
and a 'svn up' in /www/pub/www.cgal.org/
|
|
5. cp cgi-bin/cgal_download.pl /www/pub/cgi-bin/www.cgal.org/
|
|
6. tag SVN : svn tag CGAL_M_m_release
|
|
|
|
Then finally ...
|
|
7. announce the release (see announcement directory)
|
|
|