From: <ai...@us...> - 2007-03-31 17:06:20
|
Revision: 7655 http://plplot.svn.sourceforge.net/plplot/?rev=7655&view=rev Author: airwin Date: 2007-03-31 10:06:21 -0700 (Sat, 31 Mar 2007) Log Message: ----------- Identify some areas in the release process where some changes have to be made because we now use subversion rather than cvs. Modified Paths: -------------- trunk/README.Release_Manager_Cookbook Modified: trunk/README.Release_Manager_Cookbook =================================================================== --- trunk/README.Release_Manager_Cookbook 2007-03-31 01:17:33 UTC (rev 7654) +++ trunk/README.Release_Manager_Cookbook 2007-03-31 17:06:21 UTC (rev 7655) @@ -60,8 +60,8 @@ Update configure.ac to reflect the current version. -Commit the above changes & update your local cvs repository in case anyone -else has made any last minute changes. +Using svn, commit the above changes & update your local working copy of +PLplot in case anyone else has made any last minute changes. Verify that your computer has the right date and time using the command date. @@ -81,8 +81,9 @@ Jan 22/23 2007. -Change directory to your plplot cvs directory and enter the following command: -./scripts/make_tarball.sh -c -i /a/install/directory 2>&1 | tee build.log +Change directory to your updated plplot working copy and enter the following +command: ./scripts/make_tarball.sh -c -i /a/install/directory 2>&1 | tee +build.log This script will take a several minutes to execute and will ask you for your SourceForge password several times. The script does not otherwise @@ -104,7 +105,7 @@ cd /tmp/plplot-dist-prep/build_dir/doc/docbook/src make www-install - +NEEDS SVN CHANGE (create an svn tag by doing "svn copy" see the svn book). Tag the cvs repository (go back to the cvs plplot directory): cvs rtag -r cvs-tarball-<date>-<time> vX_X_X plplot @@ -117,7 +118,8 @@ A list of your GPG keys can be obtained using the command "gpg --list-keys". - +NEEDS SVN CHANGE (use svn2cl [http://ch.tudelft.nl/~arthur/svn2cl/] instead +which has different syntax). Prepare the ChangeLog file: cvs2cl -l "-d< today" --stdout > ChangeLog.release @@ -185,15 +187,16 @@ Update the project web page, including the examples: edit www/index.html to include a link to the latest release. edit www/examples/index.html.in to reflect the current release number. -commit the updated pages to cvs. +svn commit the updated pages. -Create a directory containing a fresh cvs checkout of PLplot, including the +Create a directory containing a fresh svn checkout of PLplot, including the www scripts. Run the following commands in that directory: ./scripts/htdocs-gen_plot-examples.sh cd www make - +NEEDS SVN CHANGE (to remove an svn tag use the svn delete command, see the +svn book). Remove the temporary tags on the CVS archives: ./scripts/rm-cvs-tarball-tags.pl This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ai...@us...> - 2007-05-20 17:17:37
|
Revision: 7691 http://plplot.svn.sourceforge.net/plplot/?rev=7691&view=rev Author: airwin Date: 2007-05-20 10:17:39 -0700 (Sun, 20 May 2007) Log Message: ----------- Add instructions for editing platform-specific file release pages. Modified Paths: -------------- trunk/README.Release_Manager_Cookbook Modified: trunk/README.Release_Manager_Cookbook =================================================================== --- trunk/README.Release_Manager_Cookbook 2007-05-01 16:23:52 UTC (rev 7690) +++ trunk/README.Release_Manager_Cookbook 2007-05-20 17:17:39 UTC (rev 7691) @@ -172,7 +172,6 @@ Select that you are sure that you want to send an e-mail to those who are monitoring the PLplot releases. - Prepare the release notes: Return the PLplot project page Select Admin -> News @@ -183,6 +182,19 @@ changed). Click on submit. +Edit the platform-specific download pages to point to the new release: +Return the PLplot project page Select Admin -> File Releases -> Create / +Edit Download Page This page is a little confusing, but basically you have +the choice of editing any one of a number of different download platforms. +Pick the Default platform. Then click on the pencil icons to change the +primary download file, and the corresponding armored ascii signature file. +(I would leave the references to the previous 5.6.1 files and the historical +cd release as is.) Then preview and once you are satisfied with the Default +platform, then save it. After that, use the first menu box to change from +the Default platform to the Copy To function to copy the Default platform to +all the additional platforms (taken one at a time). N.B. I could not get any +of this functionality to work with my usual browser (konqueror) or an old +version of firefox. But a modern version (Ubuntu Dapper) of firefox worked. Update the project web page, including the examples: edit www/index.html to include a link to the latest release. This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <hba...@us...> - 2007-05-22 02:38:02
|
Revision: 7694 http://plplot.svn.sourceforge.net/plplot/?rev=7694&view=rev Author: hbabcock Date: 2007-05-21 19:38:01 -0700 (Mon, 21 May 2007) Log Message: ----------- A first pass at an update that reflects how we plan to handle releases using SVN. Modified Paths: -------------- trunk/README.Release_Manager_Cookbook Modified: trunk/README.Release_Manager_Cookbook =================================================================== --- trunk/README.Release_Manager_Cookbook 2007-05-21 16:52:36 UTC (rev 7693) +++ trunk/README.Release_Manager_Cookbook 2007-05-22 02:38:01 UTC (rev 7694) @@ -60,10 +60,11 @@ Update configure.ac to reflect the current version. -Using svn, commit the above changes & update your local working copy of -PLplot in case anyone else has made any last minute changes. +Using svn, commit the above changes. +(While it is useful to have the correct time on your computer, this is no +longer strictly necessary). Verify that your computer has the right date and time using the command date. The easiest way to make sure the time and date are correct is to do the following: @@ -81,12 +82,45 @@ Jan 22/23 2007. -Change directory to your updated plplot working copy and enter the following -command: ./scripts/make_tarball.sh -c -i /a/install/directory 2>&1 | tee -build.log +Based on suggestions in the svn manual, the PLplot svn archive is configured +as follows: -This script will take a several minutes to execute and will ask you for -your SourceForge password several times. The script does not otherwise +/trunk/plplot +/tags/older_plplot_versions +/branches/?? + +For the release, you will be creating (and eventually committing) what is +essentially a branch of PLplot that is a record of the project at the time +of the release. This branch will be located in the /tags directory and +should follow the current naming convention, vX_Y_Z (v5_7_0 for example). + +The easiest way to get started is to make a directory on your computer +called, for example plplot_releases. Then in this directory enter the +following command: + +svn co https://plplot.svn.sourceforge.net/svnroot/plplot plplot + +This will check out the *entire* plplot project, including all the old +versions. Strictly speaking this is not necessary, all you really need +are the trunk and the tags directories, but you'll only have to do this +once and hard drives are pretty big these days. + +If you already have this directory, you will need to make sure that +trunk is up to date. In the trunk directory, type: + +svn update + +Now to create the branch for the new PLplot release, type the following +command in the root plplot directory: + +svn copy trunk/ tags/vX_Y_Z + + +cd to tags/vX_Y_Z and enter the following command: + +./scripts/make_tarball.sh -c -i /a/install/directory 2>&1 | tee build.log + +This script will take a several minutes to execute and does not otherwise provide a lot of feedback so it will appear as if it is doing nothing for long periods of time (at least on a slower computer). Be patient. When the script is finished, the release tarball will be available in the directory @@ -101,27 +135,29 @@ that the examples build and that plplot_test.sh executes without errors. +In the event that problems are found in PLplot during the release process, +corrections should be made to trunk/ and then merged into the tags/vX_Y_Z +branch as follows: + +cd tags/vX_Y_Z +svn merge -r A:B /path/to/trunk + +Where A and B specify the range of revisions in trunk to be applied +to tags/vX_Y_Z in the merge process. These can be determined by commit +messages. + + Install the documentation on the PLplot website: cd /tmp/plplot-dist-prep/build_dir/doc/docbook/src make www-install -NEEDS SVN CHANGE (create an svn tag by doing "svn copy" see the svn book). -Tag the cvs repository (go back to the cvs plplot directory): -cvs rtag -r cvs-tarball-<date>-<time> vX_X_X plplot - -Where cvs-tarball-<date>-<time> was obtained earlier (you can also get -this from the build.log file). - - Sign the release with your plplot Release Manager gpg key: gpg --default-key YYYYYYYY --detach-sign --armor /tmp/plplot-dist-prep/plplot-X.X.X.tar.gz A list of your GPG keys can be obtained using the command "gpg --list-keys". -NEEDS SVN CHANGE (use svn2cl [http://ch.tudelft.nl/~arthur/svn2cl/] instead -which has different syntax). -Prepare the ChangeLog file: -cvs2cl -l "-d< today" --stdout > ChangeLog.release +Prepare the ChangeLog file (in the trunk/ directory): +svn log -v > ChangeLog.release Edit ChangeLog.release to be the appropriate date range (i.e. only the changes that were made since the last release should be included). @@ -207,11 +243,9 @@ cd www make -NEEDS SVN CHANGE (to remove an svn tag use the svn delete command, see the -svn book). -Remove the temporary tags on the CVS archives: -./scripts/rm-cvs-tarball-tags.pl +Finally, commit the release directory to Sourceforge using the following +command: +svn commit -m "Creating tags/vX_Y_Z containing the latest PLplot release." DONE!!! - This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <hba...@us...> - 2007-08-14 02:45:06
|
Revision: 7793 http://plplot.svn.sourceforge.net/plplot/?rev=7793&view=rev Author: hbabcock Date: 2007-08-13 19:45:09 -0700 (Mon, 13 Aug 2007) Log Message: ----------- Updated release instructions. (1) Added a description of how to commit the new tag. (2) Corrected the explanation of how to use make_tarball.sh. (3) Removed the final note about commiting the tag since this is no longer necessary. Modified Paths: -------------- trunk/README.Release_Manager_Cookbook Modified: trunk/README.Release_Manager_Cookbook =================================================================== --- trunk/README.Release_Manager_Cookbook 2007-08-14 01:17:49 UTC (rev 7792) +++ trunk/README.Release_Manager_Cookbook 2007-08-14 02:45:09 UTC (rev 7793) @@ -115,11 +115,15 @@ svn copy trunk/ tags/vX_Y_Z +The commit the new tag: -cd to tags/vX_Y_Z and enter the following command: +cd tags/vX_Y_Z +svn commit -m "Adding a tag for the X.Y.Z release." -./scripts/make_tarball.sh -c -i /a/install/directory 2>&1 | tee build.log +cd to tags/ and enter the following command: +./scripts/make_tarball.sh -t v5_7_4 2>&1 | tee build.log + This script will take a several minutes to execute and does not otherwise provide a lot of feedback so it will appear as if it is doing nothing for long periods of time (at least on a slower computer). Be patient. When the @@ -243,9 +247,4 @@ cd www make -Finally, commit the release directory to Sourceforge using the following -command: - -svn commit -m "Creating tags/vX_Y_Z containing the latest PLplot release." - DONE!!! This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ai...@us...> - 2007-08-14 03:14:39
|
Revision: 7794 http://plplot.svn.sourceforge.net/plplot/?rev=7794&view=rev Author: airwin Date: 2007-08-13 20:00:47 -0700 (Mon, 13 Aug 2007) Log Message: ----------- Simplify instructions for download page editing since there is no necessity for having platform-specific download pages. Modified Paths: -------------- trunk/README.Release_Manager_Cookbook Modified: trunk/README.Release_Manager_Cookbook =================================================================== --- trunk/README.Release_Manager_Cookbook 2007-08-14 02:45:09 UTC (rev 7793) +++ trunk/README.Release_Manager_Cookbook 2007-08-14 03:00:47 UTC (rev 7794) @@ -230,11 +230,11 @@ primary download file, and the corresponding armored ascii signature file. (I would leave the references to the previous 5.6.1 files and the historical cd release as is.) Then preview and once you are satisfied with the Default -platform, then save it. After that, use the first menu box to change from -the Default platform to the Copy To function to copy the Default platform to -all the additional platforms (taken one at a time). N.B. I could not get any -of this functionality to work with my usual browser (konqueror) or an old -version of firefox. But a modern version (Ubuntu Dapper) of firefox worked. +platform, then save it. At this stage, I don't think there is any necessity +of copying information to platform-specific download pages. N.B. I could not +get any of this functionality to work with my usual browser (konqueror) or +an old version of firefox. But a modern version (Ubuntu Dapper) of firefox +worked. Update the project web page, including the examples: edit www/index.html to include a link to the latest release. This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <hba...@us...> - 2007-08-15 00:58:31
|
Revision: 7798 http://plplot.svn.sourceforge.net/plplot/?rev=7798&view=rev Author: hbabcock Date: 2007-08-14 17:58:35 -0700 (Tue, 14 Aug 2007) Log Message: ----------- Updated instructions for using make_tarball.sh so that the documentation will be installable using the command make www-install. Modified Paths: -------------- trunk/README.Release_Manager_Cookbook Modified: trunk/README.Release_Manager_Cookbook =================================================================== --- trunk/README.Release_Manager_Cookbook 2007-08-15 00:53:46 UTC (rev 7797) +++ trunk/README.Release_Manager_Cookbook 2007-08-15 00:58:35 UTC (rev 7798) @@ -122,7 +122,8 @@ cd to tags/ and enter the following command: -./scripts/make_tarball.sh -t v5_7_4 2>&1 | tee build.log +export WWW_USER=your_sf_user_name +../trunk/scripts/make_tarball.sh -c -i /tmp/vX_Y_Z -t vX_Y_Z 2>&1 | tee build.log This script will take a several minutes to execute and does not otherwise provide a lot of feedback so it will appear as if it is doing nothing for @@ -133,7 +134,7 @@ The "-c" option says to unpack the created tarball, build it with "cmake" and "make", then test that result with ctest. -The "-i /a/install/directory" specifies the install prefix for the tarball +The "-i /tmp/vX_Y_Z" specifies the install prefix for the tarball test configure and runs "make install" after cmake, make and ctest. When the above command finishes executing you should go to this directory and verify that the examples build and that plplot_test.sh executes without errors. @@ -150,7 +151,6 @@ to tags/vX_Y_Z in the merge process. These can be determined by commit messages. - Install the documentation on the PLplot website: cd /tmp/plplot-dist-prep/build_dir/doc/docbook/src make www-install This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <hba...@us...> - 2007-10-17 00:56:32
|
Revision: 7936 http://plplot.svn.sourceforge.net/plplot/?rev=7936&view=rev Author: hbabcock Date: 2007-10-16 17:56:34 -0700 (Tue, 16 Oct 2007) Log Message: ----------- Added instructions for creating a local copy of the PLplot website for testing purposes. Modified Paths: -------------- trunk/README.Release_Manager_Cookbook Modified: trunk/README.Release_Manager_Cookbook =================================================================== --- trunk/README.Release_Manager_Cookbook 2007-10-15 12:41:48 UTC (rev 7935) +++ trunk/README.Release_Manager_Cookbook 2007-10-17 00:56:34 UTC (rev 7936) @@ -1,7 +1,8 @@ INDEX (1) GNU Privacy Guard (gpg). (2) A Note on Autotools. -(3) Creating a PLplot Release. +(3) Installing a Local Copy of the PLplot Webpage. +(4) Creating a PLplot Release. (1) GNU Privacy Guard (gpg) @@ -37,8 +38,29 @@ ltmain.sh (GNU libtool) 1.5.22 -(3) Creating a PLplot Release +(3) Installing a Local Copy of the PLplot Webpage. +It can be convenient for testing purposes to install a local copy of the +PLplot webpage (http://plplot.sourceforge.net/index.html) on your machine. +The first step is to install Apache and PHP (if you don't already have +them). You will also need to be able to build PLplot with the cairo device +driver. After you have installed these items do the following: + + 1. In the root directory of a working copy of PLplot (say plplot-www) + execute the following command: + WWW_USER=username WWW_GROUP=group WWW_HOST=localhost WWW_DIR=/var/www/plplot ./scripts/htdocs-gen_plot-examples.sh + 2. Then, in plplot-www/www execute the following command: + make WWW_USER=username WWW_GROUP=group WWW_HOST=localhost WWW_DIR=/var/www/plplot/htdocs + +Where username and group are your username and group. + +If everything works as it should, you should be able to browse the local +site at: +http://127.0.0.1/plplot/htdocs/index.html + + +(4) Creating a PLplot Release + Update the docbook documentation to reflect any new drivers or new functionality that has been added to PLplot. Or alternatively, press those who made the changes to update the documentation. This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ai...@us...> - 2007-10-21 23:53:04
|
Revision: 7961 http://plplot.svn.sourceforge.net/plplot/?rev=7961&view=rev Author: airwin Date: 2007-10-21 16:53:08 -0700 (Sun, 21 Oct 2007) Log Message: ----------- Drop special download page instructions since that not needed any more (default page works fine). Modified Paths: -------------- trunk/README.Release_Manager_Cookbook Modified: trunk/README.Release_Manager_Cookbook =================================================================== --- trunk/README.Release_Manager_Cookbook 2007-10-21 19:51:03 UTC (rev 7960) +++ trunk/README.Release_Manager_Cookbook 2007-10-21 23:53:08 UTC (rev 7961) @@ -244,20 +244,6 @@ changed). Click on submit. -Edit the platform-specific download pages to point to the new release: -Return the PLplot project page Select Admin -> File Releases -> Create / -Edit Download Page This page is a little confusing, but basically you have -the choice of editing any one of a number of different download platforms. -Pick the Default platform. Then click on the pencil icons to change the -primary download file, and the corresponding armored ascii signature file. -(I would leave the references to the previous 5.6.1 files and the historical -cd release as is.) Then preview and once you are satisfied with the Default -platform, then save it. At this stage, I don't think there is any necessity -of copying information to platform-specific download pages. N.B. I could not -get any of this functionality to work with my usual browser (konqueror) or -an old version of firefox. But a modern version (Ubuntu Dapper) of firefox -worked. - Update the project web page, including the examples: edit www/index.html to include a link to the latest release. edit www/examples/index.html.in to reflect the current release number. This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ai...@us...> - 2007-11-24 22:14:58
|
Revision: 8036 http://plplot.svn.sourceforge.net/plplot/?rev=8036&view=rev Author: airwin Date: 2007-11-24 14:14:56 -0800 (Sat, 24 Nov 2007) Log Message: ----------- Drop anything to do with autotools in instructions. Add another local test of website generation. Modified Paths: -------------- trunk/README.Release_Manager_Cookbook Modified: trunk/README.Release_Manager_Cookbook =================================================================== --- trunk/README.Release_Manager_Cookbook 2007-11-24 18:28:31 UTC (rev 8035) +++ trunk/README.Release_Manager_Cookbook 2007-11-24 22:14:56 UTC (rev 8036) @@ -1,8 +1,7 @@ INDEX (1) GNU Privacy Guard (gpg). -(2) A Note on Autotools. -(3) Installing a Local Copy of the PLplot Webpage. -(4) Creating a PLplot Release. +(2) Installing a Local Copy of the PLplot Webpage. +(3) Creating a PLplot Release. (1) GNU Privacy Guard (gpg) @@ -22,45 +21,76 @@ (where 6C58D1AC is replaced with the appropriate value from the list-keys command) +(2) Installing a Local Copy of the PLplot Webpage. -(2) A Note on Autotools +It can be convenient for testing purposes to install a local copy of the +PLplot webpage (http://plplot.sourceforge.net/index.html) on your machine. +The first step is to install Apache and PHP (if you don't already have +them). You will also need to be able to build PLplot with the cairo device +driver. After you have installed these items do the following three steps +(N.B. each with the same prefix for WWW_DIR but with a deliberately different +suffix for WWW_DIR): -Our old autotools build system is now deprecated in favour of our new CMake -build system, but nevertheless our release tarball includes -autotools-generated files such as configure for those users who have not -made the switch yet. Since autotools users are completely dependent on the -autotools versions that you will use when running cf/bootstrap.sh (called by -make_tarball.sh below) you must have the correct autotools versions. -Currently these are: + 1. Build a local version of the documentation and install it to the + local copy of the PLplot webpage. + + N.B. this build puts some documentation results into the source tree so + we use a throwaway source tree for this. + + N.B. this build completely removes WWW_DIR on the local machine + (localhost) so be careful how you specify the -DWWW_DIR option! -autoconf (GNU Autoconf) 2.59 -automake (GNU automake) 1.9.6 -ltmain.sh (GNU libtool) 1.5.22 +rm -rf /tmp/plplotdoc +mkdir -p /tmp/plplotdoc/build +cd /tmp/plplotdoc +svn export https://plplot.svn.sourceforge.net/svnroot/plplot/trunk \ +plplot_source +cd /tmp/plplotdoc/build +cmake +-DWWW_USER=username \ +-DWWW_GROUP=group \ +-DWWW_HOST=localhost \ +-DWWW_DIR=/var/www/plplot/htdocs/docbook-manual \ +-DCMAKE_VERBOSE_MAKEFILE=ON \ +-DDEFAULT_NO_BINDINGS=ON -DDEFAULT_NO_DEVICES=ON \ +-DPREBUILD_DIST=ON +-DBUILD_DOC=ON \ +../plplot_source \ +>& cmake.out +make prebuild_dist >& make_prebuild.out + + 2. In the root directory of a throwaway copy of the PLplot source tree (say + /tmp/plplotdoc/plplot_source from step 1 above) execute the following + command: -(3) Installing a Local Copy of the PLplot Webpage. + N.B. this command completely removes WWW_DIR on the local machine + (localhost) so be careful how you specify WWW_DIR! -It can be convenient for testing purposes to install a local copy of the -PLplot webpage (http://plplot.sourceforge.net/index.html) on your machine. -The first step is to install Apache and PHP (if you don't already have -them). You will also need to be able to build PLplot with the cairo device -driver. After you have installed these items do the following: +WWW_USER=username \ +WWW_GROUP=group \ +WWW_HOST=localhost \ +WWW_DIR=/var/www/plplot \ +./scripts/htdocs-gen_plot-examples.sh - 1. In the root directory of a working copy of PLplot (say plplot-www) - execute the following command: - WWW_USER=username WWW_GROUP=group WWW_HOST=localhost WWW_DIR=/var/www/plplot ./scripts/htdocs-gen_plot-examples.sh - 2. Then, in plplot-www/www execute the following command: - make WWW_USER=username WWW_GROUP=group WWW_HOST=localhost WWW_DIR=/var/www/plplot/htdocs + 3. Then, in /tmp/plplotdoc/plplot_source/www execute the following command: + N.B. this command completely removes WWW_DIR on the local machine + (localhost) so be careful how you specify WWW_DIR! +make \ +WWW_USER=username \ +WWW_GROUP=group \ +WWW_HOST=localhost \ +WWW_DIR=/var/www/plplot/htdocs + Where username and group are your username and group. If everything works as it should, you should be able to browse the local site at: http://127.0.0.1/plplot/htdocs/index.html +(3) Creating a PLplot Release -(4) Creating a PLplot Release - Update the docbook documentation to reflect any new drivers or new functionality that has been added to PLplot. Or alternatively, press those who made the changes to update the documentation. @@ -78,13 +108,8 @@ follow the instructions in this file for updating the SOVERSION, the minor number and the patch number. - -Update configure.ac to reflect the current version. - - Using svn, commit the above changes. - (While it is useful to have the correct time on your computer, this is no longer strictly necessary). Verify that your computer has the right date and time using the command date. This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ai...@us...> - 2007-11-25 00:16:10
|
Revision: 8040 http://plplot.svn.sourceforge.net/plplot/?rev=8040&view=rev Author: airwin Date: 2007-11-24 16:16:15 -0800 (Sat, 24 Nov 2007) Log Message: ----------- Insert section for optional testing of a tarball created from trunk. Modified Paths: -------------- trunk/README.Release_Manager_Cookbook Modified: trunk/README.Release_Manager_Cookbook =================================================================== --- trunk/README.Release_Manager_Cookbook 2007-11-24 22:30:26 UTC (rev 8039) +++ trunk/README.Release_Manager_Cookbook 2007-11-25 00:16:15 UTC (rev 8040) @@ -1,7 +1,8 @@ INDEX (1) GNU Privacy Guard (gpg). (2) Installing a Local Copy of the PLplot Webpage. -(3) Creating a PLplot Release. +(3) Creating a test tarball from trunk. +(4) Creating a PLplot Release. (1) GNU Privacy Guard (gpg) @@ -89,8 +90,64 @@ site at: http://127.0.0.1/plplot/htdocs/index.html -(3) Creating a PLplot Release +(3) Creating a test tarball from trunk +This optional step is only required if you have some concerns about how +recent changes may have affected the generated source tarball, and you want +to generate that tarball and test it _before_ you create a tag for the +release. (The release process for the tag below also generates a tarball +from the tag directory and tests it which is why this trunk version of the +same is optional.) + +cd /tmp +/path-to-trunk-source/scripts/make_tarball.sh \ +-w https://plplot.svn.sourceforge.net/svnroot/plplot +-c -i /tmp/trunk_install -t trunk 2>&1 | tee build.log + +The above exports the current trunk +and uses + +/tmp/plplot-dist-prep/build_dir + +to build the distribution source tarball + +and uses + +/tmp/plplot-dist-prep/ctest_build_dir + +to configure and build PLplot from the unpacked tarball, ctest the build +tree, and install the built PLplot in /tmp/trunk_install + +Here are the *.out files generated by this process which should be checked. + +/tmp/plplot-dist-prep/build_dir/cmake.out +/tmp/plplot-dist-prep/build_dir/make_prebuild_dist.out +/tmp/plplot-dist-prep/build_dir/make_package_source.out +/tmp/plplot-dist-prep/ctest_build_dir/cmake.out +/tmp/plplot-dist-prep/ctest_build_dir/make.out +/tmp/plplot-dist-prep/ctest_build_dir/ctest.out +/tmp/plplot-dist-prep/ctest_build_dir/make_install.out + +Here is how the install location should be checked: + +cd /tmp/trunk_install/share/plplotX.Y.Z/examples +make >& make_examples.out +./plplot-test.sh --help #to see what kinds of tests can be run +./plplot-test.sh --device=psc +./plplot-test.sh --device=pscairo +./plplot-test.sh --device=pngcairo +./plplot-test.sh --device=png + +etc. Check the results with, e.g., + +display x01c.pngcairo.01 +display x08c.pscairo + +where "display" is the general image viewer from the imagemagick suite +of programmes. + +(4) Creating a PLplot Release + Update the docbook documentation to reflect any new drivers or new functionality that has been added to PLplot. Or alternatively, press those who made the changes to update the documentation. This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ai...@us...> - 2007-12-03 18:27:36
|
Revision: 8058 http://plplot.svn.sourceforge.net/plplot/?rev=8058&view=rev Author: airwin Date: 2007-12-03 10:27:41 -0800 (Mon, 03 Dec 2007) Log Message: ----------- Put in section at the end about immediate preparation for next release cycle. Modified Paths: -------------- trunk/README.Release_Manager_Cookbook Modified: trunk/README.Release_Manager_Cookbook =================================================================== --- trunk/README.Release_Manager_Cookbook 2007-12-03 17:08:51 UTC (rev 8057) +++ trunk/README.Release_Manager_Cookbook 2007-12-03 18:27:41 UTC (rev 8058) @@ -148,19 +148,12 @@ (4) Creating a PLplot Release +Update the README.release file. + Update the docbook documentation to reflect any new drivers or new functionality that has been added to PLplot. Or alternatively, press those who made the changes to update the documentation. - -Update the README.release file. - a. Append the README.release file from the last release onto the front of - the OLD-README.release file. This is done to preserve a record of the - significant changes between versions of PLplot. - b. Update README.release file to reflect significant changes made between - the current release and the last release. - - Update cmake/module/plplot_version.cmake to reflect the current version. Also, follow the instructions in this file for updating the SOVERSION, the minor number and the patch number. @@ -337,4 +330,12 @@ cd www make +Immediate preparation for next release cycle + + a. Append the README.release file from the current release onto the front of + the OLD-README.release file. This is done to preserve a record of the + significant changes between versions of PLplot. + b. Update README.release file to reflect significant changes made between + the current release and the last release. + DONE!!! This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |