From: <al...@us...> - 2008-05-08 14:39:39
|
Revision: 309 http://gnuplot-py.svn.sourceforge.net/gnuplot-py/?rev=309&view=rev Author: alford Date: 2008-05-08 07:38:57 -0700 (Thu, 08 May 2008) Log Message: ----------- Updated and expanded RELEASES.txt Modified Paths: -------------- trunk/Gnuplot.html trunk/RELEASES.txt Modified: trunk/Gnuplot.html =================================================================== --- trunk/Gnuplot.html 2008-05-04 20:26:08 UTC (rev 308) +++ trunk/Gnuplot.html 2008-05-08 14:38:57 UTC (rev 309) @@ -1,15 +1,17 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html> +<?xml version="1.0" encoding="utf-8"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"> <head> <title>Gnuplot.py</title> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> </head> -<body bgcolor="#ffffff"> +<body> -<center><h1>Gnuplot.py on <a href="http://sourceforge.net"><img +<h1>Gnuplot.py on <a href="http://sourceforge.net"><img src="http://sourceforge.net/sflogo.php?group_id=17434&type=1" -width="88" height="31" border="0" alt="SourceForge Logo"></a></h1></center> + alt="SourceForge Logo"/></a></h1> +<!-- width="88" height="31" border="0" --> <table> <tr> @@ -19,19 +21,19 @@ <td> <ul> <li> The <a - href="http://gnuplot-py.sourceforge.net">Gnuplot.py home page</a> + href="http://gnuplot-py.sourceforge.net">Gnuplot.py home page</a></li> <li> The <a href="http://sourceforge.net/projects/gnuplot-py/">Gnuplot.py - project page</a> on SourceForge. + project page</a> on SourceForge.</li> <li> Download the <a href="http://sourceforge.net/project/showfiles.php?group_id=17434"> - current version (version 1.8)</a> (includes documentation) + current version (version 1.8)</a> (includes documentation)</li> <li> The <a href="http://gnuplot-py.sourceforge.net/doc">online - documentation</a> + documentation</a></li> <li> The <a href="http://lists.sourceforge.net/lists/listinfo/gnuplot-py-users">Gnuplot.py - users' mailing list</a> + users' mailing list</a></li> </ul> </td> </tr> @@ -43,10 +45,10 @@ href="http://www.gnuplot.info/">gnuplot</a>, the popular open-source plotting program. It allows you to use gnuplot from within Python to plot arrays of data from memory, data files, or mathematical -functions. If you use Python to perform computations or as `glue' for +functions. If you use Python to perform computations or as 'glue' for numerical programs, you can use this package to plot data on the fly as they are computed. And the combination with Python makes it is -easy to automate things, including to create crude `animations' by +easy to automate things, including to create crude 'animations' by plotting different datasets one after another. </p> <p> Commands are communicated to gnuplot through a pipe and data @@ -60,16 +62,17 @@ flexibility to set plot options and to run multiple gnuplot sessions simultaneously. If you are more ambitious, it is not difficult to add entirely new types of plottable items by deriving from the -`<tt>PlotItem</tt>' class. </p> +'<tt>PlotItem</tt>' class. </p> <p> The package includes a demonstration that can be run by typing -`<tt>python demo.py</tt>'. </p> +'<tt>python demo.py</tt>'. </p> <h2>News</h2> -<p> (January 2008) Gnuplot.py version 1.8 is out. This version -includes bugfixes and improvements that have piled up since 1.7. +<p> (2 May 2008) Gnuplot.py version 1.8 is out. This version +includes bugfixes and improvements that have piled up since 1.7, +including compatibility with NumPy. For more information, read the <tt>NEWS.txt</tt> file in the distribution. </p> <p> (17 October 2003) Gnuplot.py version 1.7 is out. This version @@ -82,7 +85,7 @@ <h2>Documentation</h2> <p> The quickest way to learn how to use Gnuplot.py is to install it -then run the simple demonstration by typing `<tt>python demo.py</tt>', +then run the simple demonstration by typing '<tt>python demo.py</tt>', then to look at the <tt>demo.py</tt> file to see the commands that create the demo. One of the examples is probably similar to what you want to do. </p> @@ -99,7 +102,7 @@ at the docstrings yourself by opening the python files in an editor. </p> -<p> Finally, there is a new <a +<p> Finally, there is a <a href="mailto:gnu...@li...">mailing list</a> for Gnuplot.py users. For more information about subscribing to the list or viewing the archive of old articles, please click <a @@ -108,9 +111,8 @@ <p> To get good use out of Gnuplot.py, you will want to know something about gnuplot, for which a good source is the gnuplot help (run -gnuplot then type `help', or read it online at <a -href="http://www.gnuplot.info/gnuplot.html"> this -website</a>). You might also want to check out Bernhard Reiter's <a +gnuplot then type 'help', or read it online at <a +href="http://www.gnuplot.info/">the gnuplot website</a>). You might also want to check out Bernhard Reiter's <a href="http://www.usf.uni-osnabrueck.de/~breiter/tools/gnuplot/index.en.html"> gnuplot information page</a>, which has many more links. </p> @@ -122,11 +124,11 @@ <p> Before you can use Gnuplot.py, you will need working versions of </p> <ul> - <li> the <a href="http://www.gnuplot.info">gnuplot</a> program, + <li> the <a href="http://www.gnuplot.info">gnuplot</a> program,</li> <li> <a href="http://www.python.org">Python</a> (version 2.2 or - later), and - <li> the <a href="http://numpy.sourceforge.net/"> Numeric Python - extension</a> + later), and</li> + <li> the <a href="http://numpy.scipy.org/">"NumPy"</a> Numeric + computation package for Python.</li> </ul> <p> If you want to run under MS Windows, make sure you have @@ -137,14 +139,14 @@ <li> <a href="http://sourceforge.net/project/showfiles.php?group_id=17434">Download</a> either <code>gnuplot-py-1.8.tar.gz</code> or <code> - Gnuplot-1.8.zip</code>. + Gnuplot-1.8.zip</code>.</li> <li> Gunzip and untar (or unzip) it, which will create a directory - called <code>gnuplot-1.8</code>. + called <code>gnuplot-1.8</code>.</li> <li> Refer to <tt>README.txt</tt> in that directory for further instructions. Usually it should be enough to type <code>python - setup.py install</code>. + setup.py install</code>.</li> </ol> @@ -162,11 +164,11 @@ into commercial products. See the <a href="LICENSE"> LICENCE</a> file for more information. (If these restrictions are a problem for you, please contact me to discuss the issue.) +</p> <h2>Credits</h2> -<p> The Gnuplot.py package was written by <a -href="http://monsoon.harvard.edu/~mhagger/">Michael Haggerty</a>. </p> +<p> The Gnuplot.py package was written by Michael Haggerty. </p> <p> The package was inspired by and partly derived from the Gnuplot.py module written by <a href="http://starship.python.net/crew/hinsen/"> @@ -187,18 +189,18 @@ <p> Thanks also to many other users who have submitted suggestions, bug fixes, and other feedback. </p> -<hr> +<hr/> +<p> +Written by Michael Haggerty (email <a href="mailto:mh...@al..."> +<<i>mh...@al...</i>></a>)</p> -Written by <a href="http://monsoon.harvard.edu/~mhagger/">Michael -Haggerty</a> (email <a href="mailto:mh...@al..."> -<<i>mh...@al...</i>></a>)<br> - <p> - <a href="http://validator.w3.org/check/referer"> - <img border="0" src="http://www.w3.org/Icons/valid-html401" - alt="Valid HTML 4.01!" height="31" width="88"> -</a> -This page should be viewable on any standards-compliant browser. + <a href="http://validator.w3.org/check?uri=referer"><img + src="http://www.w3.org/Icons/valid-xhtml10" + alt="Valid XHTML 1.0 Strict" height="31" width="88" /></a> </p> +<p> +</p> -</body> </html> +</body> +</html> Modified: trunk/RELEASES.txt =================================================================== --- trunk/RELEASES.txt 2008-05-04 20:26:08 UTC (rev 308) +++ trunk/RELEASES.txt 2008-05-08 14:38:57 UTC (rev 309) @@ -1,26 +1,27 @@ # $Id$ -These are my notes about the steps to make a new release of -Gnuplot.py. +These are notes about the steps to make a new release of Gnuplot.py. -0. Get the current SVN version, and put it in a directory called Gnuplot +0. Get the current SVN version, and put it in a local directory called Gnuplot $ svn co --username=SFNAME https://gnuplot-py.svn.sourceforge.net/svnroot/gnuplot-py/trunk Gnuplot where SFNAME is your sourceforge username. 1. Edit the following files for the release: NEWS.txt -- add the version number at the top of the file and make - sure that the comments are up-to-date. + sure that the comments are up to date. + Remove the "Version ?.?:" line. ANNOUNCE.txt -- add the version number at the top of the file and update the blurbs as appropriate. - Gnuplot.html -- update the version number where it appears. Update - the "News" section. + Gnuplot.html -- update the version number where it appears. + Update the "News" section. - __init__.py -- increment the __version__ string. No "+" on the end. + __init__.py -- increment the __version__ string. If there is a + "+" on the end, remove it. -2. Check the changes into Subversion. +2. Check the changes into Subversion, with an appropriate comment $ svn commit -m "Official version 1.8" 3. Tag the release in Subversion: @@ -30,31 +31,32 @@ 4. Create new documentation using happydoc. cd to the Gnuplot directory, then $ rm -rf doc $ cd .. - $ happydoc -d Gnuplot/doc -t 'Gnuplot.py' Gnuplot - + $ happydoc -d Gnuplot/doc -t 'Gnuplot.py' Gnuplot + Note: + To install happydoc, you download its source from sourceforge, + and unpack it, then + $ cp -r happydoclib/ /usr/lib/python2.5/site-packages/ + $ cp happydoc /usr/local/bin + 5. Generate the source distributions in Gnuplot/dist; cd to Gnuplot and then: - $ python2 ./setup.py sdist --formats=gztar,zip 6. [OMIT THIS] Generate the binary distributions. [I don't think a binary distribution is worthwhile because the place that the files need to be installed is dependent on the version of python being used.] - $ python2 ./setup.py bdist --format=gztar,zip,rpm,wininst - - 7. Release the files on SourceForge: - $ cd dist $ ftp upload.sourceforge.net (username anonymous) cd incoming put gnuplot-py-1.8.tar.gz put gnuplot-py-1.8.zip - a. Go to the "Admin" page. + a. Log in to the sourceforge web interface, choose Gnuplot.py + from "My projects" - b. Go to the "File release system" page. + b. Select Admin -> "File release system" c. Click on "Add Release" for package Gnuplot-py. @@ -62,7 +64,7 @@ Click on "Create This Release" - e. In "Step 1: Edit Existing Release", + e. In "Step 1: Edit Existing Release", check the "Preserve my pre-formatted text." button below the text boxes Paste the "New features in this version" section of ANNOUNCE.txt into the "Paste the notes in" text box. @@ -70,11 +72,11 @@ "Paste The Change Log In" text box Click "Submit/refresh" - f. In "Step 2: Add Files To This Release" section, - Select gnuplot-py-1.8.tar.gz and gnuplot-py-1.8.zip in the then click - "Add files or refresh view" + f. In "Step 2: Add Files To This Release" section, + Select gnuplot-py-1.8.tar.gz and gnuplot-py-1.8.zip in the + list of files, then click "Add files or refresh view" - g. In step 3 "Edit Files In This Release", + g. In "Step 3: Edit Files In This Release", For gnuplot-py-1.8.tar.gz, under "Processor" select "Platform-Independent" and under "file type" select "source .gz", then click "Update/refresh" @@ -85,15 +87,42 @@ h. In "Step 4: Email release notice", check "I'm sure", then click "Send Notice". -8. Send an announcement to gnu...@li... +8. Upload the new web page files (modified in step 1) to sourceforge: + $ sftp SF...@sh... + cd /home/groups/g/gn/gnuplot-py/htdocs + put Gnuplot.html + put ANNOUNCE.txt + put NEWS.txt + quit + This updates the Gnuplot.html home page, http://gnuplot-py.sourceforge.net/ + +9. Update the project news page (http://sourceforge.net/projects/gnuplot-py/) + - log in to sourceforge on the web + - select Gnuplot.py from "My projects" + - Admin -> News -> Submit + Subject: Gnuplot.py version 1.8 released + For the "Details" box, select some stuff from NEWS.txt, eg: + ---- + Version 1.8 of Gnuplot.py has just been released. + Highlights: + + Compatible with NumPy + + Compatible with future python where "with" will be a reserved word + + Added a 'pdf' terminal definition + + hardcopy allows for terminal='svg' + See NEWS.txt for more details. + ---- + Then delete the News item for the previous release: return to + Admin -> News, click on the item for the previous release, + select "displayed", select "delete", and click "submit". -9. Send an announcement to comp.lang.python. +10. Send an announcement to gnu...@li... -10. Append a '+' to the __version__ string in __init__.py to +11. Send an announcement to comp.lang.python. + +12. Append a '+' to the __version__ string in __init__.py to distinguish intermediate Subversion releases from official releases. Add a "Version ?.?:" line to NEWS.txt to receive future change notes. - [Remove backup files (ending with '~')] - Check the changes into Subversion: + Check the changes into Subversion, with a suitable comment, eg: svn commit -m "Version 1.8+" This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |