plplot-cvs — For PLplot svn commit messages

[Plplot-cvs] SF.net SVN: plplot:[12564] trunk/README.release

[<ai...@us...>]

Revision: 12564
          http://sourceforge.net/p/plplot/code/12564
Author:   airwin
Date:     2013-10-01 18:02:35 +0000 (Tue, 01 Oct 2013)
Log Message:
-----------
Substantial reorganization to put the most recent information at
the top of the file.

Modified Paths:
--------------
    trunk/README.release

Modified: trunk/README.release
===================================================================
--- trunk/README.release	2013-10-01 16:51:17 UTC (rev 12563)
+++ trunk/README.release	2013-10-01 18:02:35 UTC (rev 12564)
@@ -17,98 +17,109 @@
 
 INDEX
 
-OFFICIAL NOTICES FOR USERS
+1. OFFICIAL NOTICES FOR USERS SINCE 5.9.10 (the previous development release)
 
-CHANGES
+2. Tests made for release 5.9.11
 
-0. Tests made for release 5.9.11
+3. Changes relative to PLplot 5.9.10 (the previous development release)
 
-1. Changes relative to PLplot 5.9.10 (the previous development release)
+4. OFFICIAL NOTICES FOR USERS SINCE 5.8.0 (the previous stable release)
 
-2. Changes relative to PLplot 5.8.0 (the previous stable release)
+5. Changes relative to PLplot 5.8.0 (the previous stable release)
 
-2.1 All autotools-related files have now been removed
-2.2 Build system bug fixes
-2.3 Build system improvements
-2.4 Implement build-system infrastructure for installed Ada bindings and
+5.1 All autotools-related files have now been removed
+5.2 Build system bug fixes
+5.3 Build system improvements
+5.4 Implement build-system infrastructure for installed Ada bindings and
 examples
-2.5 Code cleanup
-2.6 Date / time labels for axes
-2.7 Alpha value support
-2.8 New PLplot functions
-2.9 External libLASi library improvements affecting our psttf device
-2.10 Improvements to the cairo driver family
-2.11 wxWidgets driver improvements
-2.12 pdf driver improvements
-2.13 svg driver improvements
-2.14 Ada language support
-2.15 OCaml language support
-2.16 Perl/PDL language support
-2.17 Update to various language bindings
-2.18 Update to various examples
-2.19 Extension of our test framework
-2.20 Rename test subdirectory to plplot_test
-2.21 Website support files updated
-2.22 Internal changes to function visibility
-2.23 Dynamic driver support in Windows
-2.24 Documentation updates
-2.25 libnistcd (a.k.a. libcd) now built internally for -dev cgm
-2.26 get-drv-info now changed to test-drv-info
-2.27 Text clipping now enabled by default for the cairo devices
-2.28 A powerful qt device driver has been implemented
-2.29 The PLplot API is now accessible from Qt GUI applications
-2.30 NaN / Inf support for some PLplot functions
-2.31 Various bug fixes
-2.32 Cairo driver improvements
-2.33 PyQt changes
-2.34 Color Palettes
-2.35 Re-implementation of a "soft landing" when a bad/missing compiler is
+5.5 Code cleanup
+5.6 Date / time labels for axes
+5.7 Alpha value support
+5.8 New PLplot functions
+5.9 External libLASi library improvements affecting our psttf device
+5.10 Improvements to the cairo driver family
+5.11 wxWidgets driver improvements
+5.12 pdf driver improvements
+5.13 svg driver improvements
+5.14 Ada language support
+5.15 OCaml language support
+5.16 Perl/PDL language support
+5.17 Update to various language bindings
+5.18 Update to various examples
+5.19 Extension of our test framework
+5.20 Rename test subdirectory to plplot_test
+5.21 Website support files updated
+5.22 Internal changes to function visibility
+5.23 Dynamic driver support in Windows
+5.24 Documentation updates
+5.25 libnistcd (a.k.a. libcd) now built internally for -dev cgm
+5.26 get-drv-info now changed to test-drv-info
+5.27 Text clipping now enabled by default for the cairo devices
+5.28 A powerful qt device driver has been implemented
+5.29 The PLplot API is now accessible from Qt GUI applications
+5.30 NaN / Inf support for some PLplot functions
+5.31 Various bug fixes
+5.32 Cairo driver improvements
+5.33 PyQt changes
+5.34 Color Palettes
+5.35 Re-implementation of a "soft landing" when a bad/missing compiler is
 detected
-2.36 Make PLplot aware of LC_NUMERIC locale
-2.37 Linear gradients have been implemented
-2.38 Cairo Windows driver implemented
-2.39 Custom axis labelling implemented
-2.40 Universal coordinate transform implemented
-2.41 Support for arbitrary storage of 2D user data
-2.42 Font improvements
-2.42 Alpha value support for plotting in memory.
-2.43 Add a Qt device for in memory plotting.
-2.44 Add discrete legend capability.
-2.45 Add full bindings and examples for the D language.
-2.46 The plstring and plstring3 functions have been added
-2.47 The pllegend API has been finalized
-2.48 Octave bindings now implemented with swig
-2.49 Documentation redone for our swig-generated Python and Octave bindings
-2.50 Support large polygons
-2.51 Complete set of PLplot parameters now available for Fortran
-2.52 The plarc function has been added
-2.53 The format for map data used by plmap has changed
-2.54 Python support for Numeric has been dropped
-2.55 Backwards-incompatible API change to non-integer line widths
-2.56 Improvements to the build system for the Cygwin case
-2.57 The plcolorbar API has been finalized
-2.58 Documentation of the new legend and color bar capabilities of PLplot
-2.59 The D bindings and examples have been converted from the
+5.36 Make PLplot aware of LC_NUMERIC locale
+5.37 Linear gradients have been implemented
+5.38 Cairo Windows driver implemented
+5.39 Custom axis labelling implemented
+5.40 Universal coordinate transform implemented
+5.41 Support for arbitrary storage of 2D user data
+5.42 Font improvements
+5.42 Alpha value support for plotting in memory.
+5.43 Add a Qt device for in memory plotting.
+5.44 Add discrete legend capability.
+5.45 Add full bindings and examples for the D language.
+5.46 The plstring and plstring3 functions have been added
+5.47 The pllegend API has been finalized
+5.48 Octave bindings now implemented with swig
+5.49 Documentation redone for our swig-generated Python and Octave bindings
+5.50 Support large polygons
+5.51 Complete set of PLplot parameters now available for Fortran
+5.52 The plarc function has been added
+5.53 The format for map data used by plmap has changed
+5.54 Python support for Numeric has been dropped
+5.55 Backwards-incompatible API change to non-integer line widths
+5.56 Improvements to the build system for the Cygwin case
+5.57 The plcolorbar API has been finalized
+5.58 Documentation of the new legend and color bar capabilities of PLplot
+5.59 The D bindings and examples have been converted from the
 old version of D (D1) to the new version of D (D2)
-2.60 The DocBook documentation for PLplot is now generated using modern
+5.60 The DocBook documentation for PLplot is now generated using modern
 XML/XSL backend tools for DocBook
-2.61 Implement experimental build_projects sub-project
-2.62 Implement extremely simple "00" example
-2.63 Convert to using the Allura form of SourceForge software
-2.64 Use NON_TRANSITIVE linking by default for the shared libraries case for
+5.61 Implement experimental build_projects sub-project
+5.62 Implement extremely simple "00" example
+5.63 Convert to using the Allura form of SourceForge software
+5.64 Use NON_TRANSITIVE linking by default for the shared libraries case for
 all non-windows systems
-2.65 Update f95 examples to take larger advantage of Fortran 95 capabilities
-2.66 Substantial additions to the doxygen documentation
+5.65 Update f95 examples to take larger advantage of Fortran 95 capabilities
+5.66 Substantial additions to the doxygen documentation
 
+1. OFFICIAL NOTICES FOR USERS SINCE 5.9.10 (the previous development release)
 
-OFFICIAL NOTICES FOR USERS
+None at this time.
 
-(5.9.10) The minimum version of CMake has been bumped to 2.8.9.  This
+2. Tests made for release 5.9.11
+
+None at this time.
+
+3. Changes relative to PLplot 5.9.10 (the previous development release)
+
+None at this time.
+
+4. OFFICIAL NOTICES FOR USERS SINCE 5.8.0 (the previous stable release)
+
+(5.9.10) The minimum version of CMake has been bumped to 5.8.9.  This
 change allows our build system to take advantage of CMake features
 introduced in later versions of CMake.  Even more importantly it also
 updates user's builds to the CMake policy conventions (important
 backwards-incompatible changes in CMake behaviour introduced in later
-versions of CMake) to the default CMake policy used for 2.8.9.
+versions of CMake) to the default CMake policy used for 5.8.9.
 
 (5.9.10) The long deprecated support for the python Numeric package has been
 dropped. This is no longer supported and is superseded by numpy. Support for
@@ -249,7 +260,7 @@
 with "PL_" for themselves.  For a complete list of the affected
 constants, see the #defines in swig-support/plplotcapi.i which are
 used internally to help generate the plplot module.  See also Index
-item 2.51 below.
+item 5.51 below.
 
 (5.9.8) There has been widespread const modifier changes in the API
 for libplplotd and libplplotcxxd.  Those backwards-incompatible API
@@ -389,7 +400,7 @@
 (5.9.4) We have deprecated the pbm device driver (containing the pbm
 device) because glibc detects a catastrophic double free.
 
-(5.9.3) Our build system requires CMake version 2.6.0 or higher.
+(5.9.3) Our build system requires CMake version 5.6.0 or higher.
 
 (5.9.3) We have deprecated the gcw device driver and the related
 gnome2 and pygcw bindings since these are essentially unmaintained.
@@ -436,7 +447,7 @@
 build system.  Instead, use the CMake-based build system following the
 directions in the INSTALL file.
 
-(5.9.1) We no longer support Octave-2.1.73 which has a variety of
+(5.9.1) We no longer support Octave-5.1.73 which has a variety of
 run-time issues in our tests of the Octave examples on different
 platforms. In contrast our tests show we get good run-time results
 with all our Octave examples for Octave-3.0.1. Also, that is the
@@ -457,23 +468,17 @@
 may notice some small changes to your plot results if you use these
 stream variables directly (only possible in C/C++) or use plgvpw.
 
-CHANGES
+5. Changes relative to PLplot 5.8.0 (the previous stable release)
 
-0. Tests made for release 5.9.11
-
-1. Changes relative to PLplot 5.9.10 (the previous development release)
-
-2. Changes relative to PLplot 5.8.0 (the previous stable release)
-
 N.B. This release includes many code cleanups and fixes relative to
 5.8.0 that are not mentioned in the list below.
 
-2.1 All autotools-related files have now been removed
+5.1 All autotools-related files have now been removed
 
 CMake is now the only supported build system. It has been tested on
 Linux / Unix, Mac OS-X and Windows platforms.
 
-2.2 Build system bug fixes
+5.2 Build system bug fixes
 
 Various fixes include the following:
 
@@ -485,7 +490,7 @@
 Various dependency fixes to ensure that parallel builds (using make -j)
 work under unix.
 
-2.3 Build system improvements
+5.3 Build system improvements
 
 We now transform link flag results delivered to the CMake environment by
 pkg-config into the preferred CMake form of library information.  The
@@ -494,7 +499,7 @@
 build system both for the build tree and the install tree so you don't have
 to fiddle with LD_LIBRARY_PATH, etc.
 
-2.4 Implement build-system infrastructure for installed Ada bindings and
+5.4 Implement build-system infrastructure for installed Ada bindings and
 examples
 
 Install source files, library information files, and the plplotada library
@@ -502,20 +507,20 @@
 for the plplotada library.  Install the Ada examples and a configured Makefile
 to build them in the install tree.
 
-2.5 Code cleanup
+5.5 Code cleanup
 
 The PLplot source code has been cleaned up to make consistent use of
 (const char *) and (char *) throughout. Some API functions have changed
 to use const char * instead of char * to make it clear that the strings
 are not modified by the function. The C and C++ examples have been updated
 consistent with this. These changes fix a large number of warnings
-with gcc-4.2. Note: this should not require programs using PLplot to be
+with gcc-4.5. Note: this should not require programs using PLplot to be
 recompiled as it is not a binary API change.
 
 There has also been some cleanup of include files in the C++ examples
 so the code will compile with the forthcoming gcc-4.3.
 
-2.6 Date / time labels for axes
+5.6 Date / time labels for axes
 
 PLplot now allows date / time labels to be used on axes. A new option
 ('d') is available for the xopt and yopt arguments to plbox which
@@ -544,7 +549,7 @@
 part of our date/time PLplot API that uses POSIX time routines will be
 changed.
 
-2.7 Alpha value support
+5.7 Alpha value support
 
 PLplot core has been modified to support a transparency or alpha value
 channel for each color in color map 0 and 1. In addition a number of new
@@ -558,7 +563,7 @@
 aquaterm drivers support alpha values. There are some limitations with the gd
 driver due to transparency support in the underlying libgd library.
 
-2.8 New PLplot functions
+5.8 New PLplot functions
 
 An enhanced version of plimage, plimagefr has been added. This allows images
 to be plotted using coordinate transformation, and also for the dynamic range
@@ -570,7 +575,7 @@
 the library. plrandd will return a PLFLT random number in the range 0.0-1.0.
 plseed will allow the random number generator to be seeded.
 
-2.9 External libLASi library improvements affecting our psttf device
+5.9 External libLASi library improvements affecting our psttf device
 
 Our psttf device depends on the libLASi library. libLASi-1.1.0 has just been
 released at http://sourceforge.net/svn/?group_id=187113 .  We recommend
@@ -579,7 +584,7 @@
 information returned by pango/cairo/fontconfig that on rare occasions is not
 suitable for use by libLASi.
 
-2.10 Improvements to the cairo driver family
+5.10 Improvements to the cairo driver family
 
 Jonathan Woithe improved the xcairo driver so that it can optionally be
 used with an external user supplied X Drawable. This enables a nice
@@ -588,10 +593,10 @@
 functional. Additionally, a new extcairo driver was added that will plot
 into a user supplied cairo context.
 
-2.11 wxWidgets driver improvements
+5.11 wxWidgets driver improvements
 
 Complete reorganization of the driver code. A new backend was added, based
-on the wxGraphicsContext class, which is available for wxWidgets 2.8.4
+on the wxGraphicsContext class, which is available for wxWidgets 5.8.4
 and later. This backend produces antialiased output similar to the
 AGG backend but has no dependency on the AGG library. The basic wxDC
 backend and the wxGraphicsContext backend process the text output
@@ -613,7 +618,7 @@
    implemented, where graphics input events are processed and translated
    to world coordinates
 
-2.12 pdf driver improvements
+5.12 pdf driver improvements
 
 The pdf driver (which is based on the haru library http://www.libharu.org)
 processes the text output now on its own. So far only the Adobe Type1
@@ -628,7 +633,7 @@
  - hrshsym: Use Hershey symbol set (hrshsym=0|1)
  - pagesize: Set page size (pagesize=A4|letter|A3|A5)
 
-2.13 svg driver improvements
+5.13 svg driver improvements
 
 This device driver has had the following improvements: schema for generated
 file now validates properly at http://validator.w3.org/ for the
@@ -650,7 +655,7 @@
 inkscape and scribus-ng (but not scribus!) give outstanding looking results
 for files generated by our svg device driver.
 
-2.14 Ada language support
+5.14 Ada language support
 
 We now have a complete Ada bindings implemented for PLplot. We also have a
 complete set of our standard examples implemented in Ada which give results
@@ -659,7 +664,7 @@
 enable Ada by default for our users and request widespread testing of this
 new feature.
 
-2.15 OCaml language support
+5.15 OCaml language support
 
 Thanks primarily to Hezekiah M. Carty's efforts we now have a complete OCaml
 bindings implemented for PLplot. We also have a complete set of our standard
@@ -668,7 +673,7 @@
 of a large subset of the OCaml bindings. We now enable OCaml by default for
 our users and request widespread testing of this new feature.
 
-2.16 Perl/PDL language support
+5.16 Perl/PDL language support
 
 Thanks to Doug Hunt's efforts the external Perl/PDL module,
 PDL::Graphics::PLplot version 0.46 available at
@@ -686,7 +691,7 @@
 complement of PLplot commands is available to you from Perl/PDL, but
 otherwise not.
 
-2.17 Updates to various language bindings
+5.17 Updates to various language bindings
 
 A concerted effort has been made to bring all the language bindings up to
 date with recently added functions. Ada, C++, f77, f95, Java, OCaml, Octave,
@@ -695,7 +700,7 @@
 bindings due to technical issues.) This is a significant step forward for
 those using languages other than C.
 
-2.18 Updates to various examples
+5.18 Updates to various examples
 
 To help test the updates to the language bindings the examples have been
 thoroughly checked. Ada, C, C++, f77, f95, and OCaml now contain a full set
@@ -714,7 +719,7 @@
 of the standard ctest tests because it can be _very_ slow for a complete
 set of language bindings and device drivers.
 
-2.19 Extension of our test framework
+5.19 Extension of our test framework
 
 The standard test suite for PLplot now carries out a comparison of the
 stdout output (especially important for example 31 which tests most of our
@@ -726,19 +731,19 @@
 us track down a number of bugs, and it should make it much easier for us
 to maintain high quality for our ongoing PLplot releases.
 
-2.20 Rename test subdirectory to plplot_test
+5.20 Rename test subdirectory to plplot_test
 
 This change was necessary to quit clashing with the "make test" target which
 now works for the first time ever (by executing ctest).
 
-2.21 Website support files updated
+5.21 Website support files updated
 
 Our new website content is generated with PHP and uses CSS (cascaded style
 sheets) to implement a consistent style.  This new approach demanded lots of
 changes in the website support files that are used to generate and upload
 our website and which are automatically included with the release.
 
-2.22 Internal changes to function visibility
+5.22 Internal changes to function visibility
 
 The internal definitions of functions in PLplot have been significantly
 tidied up to allow the use of the -fvisibility=hidden option with newer
@@ -746,7 +751,7 @@
 to the user where possible. This extends the existing support for this
 on windows.
 
-2.23 Dynamic driver support in Windows
+5.23 Dynamic driver support in Windows
 
 An interface based on the ltdl library function calls was established
 which allows to open and close dynamic link libraries (DLL) during
@@ -755,14 +760,14 @@
 PLplot DLL also in Windows. The cmake option ENABLE_DYNDRIVERS is now
 ON by default for Windows if a shared PLplot library is built.
 
-2.24 Documentation updates
+5.24 Documentation updates
 
 The DocBook documentation has been updated to include many of the
 C-specific functions (for example plAlloc2dGrid) which are not part
 of the common API, but are used in the examples and may be helpful
 for PLplot users.
 
-2.25 libnistcd (a.k.a. libcd) now built internally for -dev cgm
+5.25 libnistcd (a.k.a. libcd) now built internally for -dev cgm
 
 CGM format is a long-established (since 1987) open standard for vector
 graphics that is supported by w3c (see http://www.w3.org/Graphics/WebCGM/).
@@ -792,7 +797,7 @@
 non-Hershey fonts, but both those should be possible using libnistcd according
 to the text that is shown by lib/nistcd/cdtext.cgm and lib/nistcd/cdexp1.cgm.
 
-2.26 get-drv-info now changed to test-drv-info
+5.26 get-drv-info now changed to test-drv-info
 
 To make cross-building much easier for PLplot we now configure the *.rc
 files that are used to describe our various dynamic devices rather than
@@ -805,7 +810,7 @@
 *.rc file with the one configured by cmake to be sure the dynamic device
 has been built correctly.
 
-2.27 Text clipping now enabled by default for the cairo devices
+5.27 Text clipping now enabled by default for the cairo devices
 
 When correct text clipping was first implemented for cairo devices, it was
 discovered that the libcairo library of that era (2007-08) did that clipping
@@ -817,7 +822,7 @@
 your cairo device plots (and accept the improperly clipped text results that
 might occur with that option).  Better yet, use libcairo 1.6.4 or later.
 
-2.28 A powerful qt device driver has been implemented
+5.28 A powerful qt device driver has been implemented
 
 Thanks to the efforts of Alban Rochel of the QSAS team, we now have a new qt
 device driver which delivers the following 9 (!) devices: qtwidget, bmpqt,
@@ -861,7 +866,7 @@
 qmake in your path, and cmake does the rest).  If the problem persists for
 Qt-4.5, then it is worth reporting a qt bug.
 
-2.29 The PLplot API is now accessible from Qt GUI applications
+5.29 The PLplot API is now accessible from Qt GUI applications
 
 This important new feature has been implemented by Alban Rochel of the QSAS
 team as a spin-off of the qt device driver project using the extqt device
@@ -871,7 +876,7 @@
 approach. Our build system has been enhanced to configure the necessary
 plplotd-qt.pc file.
 
-2.30 NaN / Inf support for some PLplot functions
+5.30 NaN / Inf support for some PLplot functions
 
 Some PLplot now correctly handle Nan or Inf values in the data to be plotted.
 Line plotting (plline etc) and image plotting (plimage, plimagefr) will
@@ -879,7 +884,7 @@
 routines do not handle NaN / Inf values. This functionality will
 depend on whether the language binding used supports NaN / Inf values.
 
-2.31 Various bug fixes
+5.31 Various bug fixes
 
 Various bugs in the 5.9.3 release have been fixed including:
 
@@ -890,12 +895,12 @@
 - Fix pkg-config files to work correctly with Debug / Release build types set
 - Make Fortran command line argument parsing work with shared libraries on Windows
 
-2.32 Cairo driver improvements
+5.32 Cairo driver improvements
 
 Improvements to the cairo driver to give better results for bitmap
 formats when used with anti-aliasing file viewers.
 
-2.33 PyQt changes
+5.33 PyQt changes
 
 Years ago we got a donation of a hand-crafted pyqt3 interface to PLplot
 (some of the functions in plplot_widgetmodule.c in bindings/python) and a
@@ -910,7 +915,7 @@
 have therefore decided to concentrate on pyqt4 and remove the pyqt3 PLplot
 interface and example completely.
 
-2.34 Color Palettes
+5.34 Color Palettes
 
 Support has been added to PLplot for user defined color palette files.
 These files can be loaded at the command line using the -cmap0 or
@@ -922,7 +927,7 @@
 plplot-source/data directory or the PLplot installed directory
 (typically /usr/local/share/plplotx.y.z/ on Linux).
 
-2.35 Reimplementation of a "soft landing" when a bad/missing compiler is
+5.35 Reimplementation of a "soft landing" when a bad/missing compiler is
 detected
 
 The PLplot core library is written in C so our CMake-based build system will
@@ -948,7 +953,7 @@
 specifying compilers and compiler options will automatically be recognized
 as a result.
 
-2.36 Make PLplot aware of LC_NUMERIC locale
+5.36 Make PLplot aware of LC_NUMERIC locale
 
 For POSIX-compliant systems, locale is set globally so any external
 applications or libraries that use the PLplot library or any external
@@ -1011,7 +1016,7 @@
 applications that resulted in a comma decimal separator that did not work
 correctly for the critical areas.
 
-2.37 Linear gradients have been implemented
+5.37 Linear gradients have been implemented
 
 The new plgradient routine draws a linear gradient (based on the
 current color map 1) at a specified angle with the x axis for a
@@ -1024,15 +1029,15 @@
 to use native gradient capability whenever that is possible for any of
 our devices.  Currently, this has been implemented for our svg, qt,
 and cairo devices.  The result is nice-looking smooth transparency
-gradients for those devices, for, e.g., example 30, page 2.
+gradients for those devices, for, e.g., example 30, page 5.
 
-2.38 Cairo Windows driver implemented
+5.38 Cairo Windows driver implemented
 
 A cairo Windows driver has been implemented. This provides an
 interactive cairo driver for Windows similar to xcairo on Linux.
 Work to improve its functionality is ongoing.
 
-2.39 Custom axis labelling implemented
+5.39 Custom axis labelling implemented
 
 Axis text labels can now be customized using the new plslabelfunc function.
 This allows a user to specify what text should be draw at a given position
@@ -1040,14 +1045,14 @@
 use through labelling geographic coordinates in degrees North, South, East and
 West.
 
-2.40 Universal coordinate transform implemented
+5.40 Universal coordinate transform implemented
 
 A custom coordinate transformation function can be set using plstransform.
 This transformation function affects all subsequent plot function calls which
 work with plot window coordinates.  Testing and refinement of this support is
 ongoing.
 
-2.41 Support for arbitrary storage of 2D user data
+5.41 Support for arbitrary storage of 2D user data
 
 This improvement courtesy of David MacMahon adds support for arbitrary
 storage of 2D user data.  This is very similar to the technique employed
@@ -1101,7 +1106,7 @@
 3) PLFLT z[nx*ny]; /* row major order */
 4) PLFLT z[nx*ny]; /* column major order */
 
-2.42 Font improvements
+5.42 Font improvements
 
 We have added the underscore to the Hershey glyphs (thanks to David
 MacMahon) and slightly rearranged the ascii index to the Hershey
@@ -1125,7 +1130,7 @@
 versa) whenever there is a glyph lookup failure in the Type1 font
 device drivers (ps and pdf).
 
-2.42 Alpha value support for plotting in memory.
+5.42 Alpha value support for plotting in memory.
 
 The function plsmema() was added to the PLplot API. This allows the user
 to supply a RGBA formatted array that PLplot can use to do in memory
@@ -1134,12 +1139,12 @@
 for the time being, only supports RGB formatted memory and will exit
 if the user attempts to give it RGBA formatted memory to plot in.
 
-2.43 Add a Qt device for in memory plotting.
+5.43 Add a Qt device for in memory plotting.
 
 A new device called memqt has been added for in memory plotting using
 Qt. This device is the Qt equivalent of the memcairo device.
 
-2.44 Add discrete legend capability.
+5.44 Add discrete legend capability.
 
 A new routine called pllegend has been added to our core C API.
 (N.B. This is an experimental API that may be subject to further
@@ -1151,7 +1156,7 @@
 (most of which are optional) within that legend. The resulting legend
 is clipped at the boundaries of the current subpage
 
-2.45 Add full bindings and examples for the D language.
+5.45 Add full bindings and examples for the D language.
 
 As of release 5.9.5 we added full bindings and examples for the D
 language.  The results for the D examples are generally consistent
@@ -1167,7 +1172,7 @@
 alternative d compiler (the Digital Mars compiler is reported to be
 good).
 
-2.46 The plstring and plstring3 functions have been added
+5.46 The plstring and plstring3 functions have been added
 
 The plstring function largely supersedes plpoin and plsym
 because many(!) more glyphs are accessible with plstring.  The glyph
@@ -1180,7 +1185,7 @@
 The plstring3 function largely supersedes plpoin3 for the same (access
 to many more glyphs) reasons.  Standard example 18 uses plstring3.
 
-2.47 The pllegend API has been finalized
+5.47 The pllegend API has been finalized
 
 The function pllegend allows users to create a discrete plot legend
 with a plotted colored box, line, and/or line of symbols for each
@@ -1197,7 +1202,7 @@
 the pllegend API was labelled experimental for 5.9.7, we will not be
 bumping the soversions of the affected PLplot libraries.
 
-2.48 Octave bindings now implemented with swig
+5.48 Octave bindings now implemented with swig
 
 Octave is a powerful platform that demands a first-class PLplot
 solution, but we were finding it difficult to realize that goal
@@ -1217,7 +1222,7 @@
 However, because of the power of swig we now have some confidence we
 can solve this issue in the future.
 
-2.49 Documentation redone for our swig-generated Python and Octave bindings
+5.49 Documentation redone for our swig-generated Python and Octave bindings
 
 Through the docstring %feature, swig can generate documentation
 strings for certain of the languages it supports (currently Python,
@@ -1240,7 +1245,7 @@
 high-quality user-documentation would be available for that language
 as well.
 
-2.50 Support large polygons
+5.50 Support large polygons
 
 Previous releases had an implicit limitation with respect to the
 number of vertices in a polygon. This was due to the use of statically
@@ -1251,7 +1256,7 @@
 are used and for large polygons new arrays are allocated and freed.
 This strategy has been applied to all relevant source files.
 
-2.51 Complete set of PLplot parameters now available for Fortran
+5.51 Complete set of PLplot parameters now available for Fortran
 
 The #defines in bindings/swig-support/plplotcapi.i (which are
 consistent with those in include/plplot.h) define the complete set of
@@ -1284,12 +1289,12 @@
 but, in general, changes will have to be made for existing apps. (See
 announcement XX above for the details).
 
-2.52 The plarc function has been added
+5.52 The plarc function has been added
 
 The plarc function allows drawing filled and outlined arcs in PLplot.
 Standard example 3 uses plarc.
 
-2.53 The format for map data used by plmap has changed
+5.53 The format for map data used by plmap has changed
 
 The format for map data used by plmap is now the shapefile format.
 This is a widely used standard format and there are many sources of data
@@ -1301,14 +1306,14 @@
 PL_DEPRECATED cmake variable, but this support will be removed in a
 subsequent PLplot release.
 
-2.54 Python support for Numeric has been dropped
+5.54 Python support for Numeric has been dropped
 
 Support for the python Numeric package has been dropped. This has been
 deprecated since 5.9.6. Numeric is no longer supported and is superseded
 by numpy. Support for numpy has been the default in plplot for a number
 of years so most users should notice no difference.
 
-2.55 Backwards-incompatible API change to non-integer line widths
+5.55 Backwards-incompatible API change to non-integer line widths
 
 All functions which take line width arguments (plwidth, plshade*,
 pllegend) now use PLFLT values for the line width. This allows device
@@ -1320,7 +1325,7 @@
 from previous releases and the soname of libraries has been bumped
 accordingly (which forces users to recompile PLplot).
 
-2.56 Improvements to the build system for the Cygwin case
+5.56 Improvements to the build system for the Cygwin case
 
 The Cygwin platform provides a full-featured Unix environment on
 Windows.  CMake has recently been changed (at the request of Cygwin
@@ -1339,7 +1344,7 @@
 access to the many high-quality PLplot devices that are available with
 these two different device drivers.
 
-2.57 The plcolorbar API has been finalized
+5.57 The plcolorbar API has been finalized
 
 The function plcolorbar allows users to create a color bar (an
 annotated subplot representing a continuous range of colors within the
@@ -1354,7 +1359,7 @@
 plcolorbar calls to be compatible with the argument list of the latest
 version.
 
-2.58 Documentation of the new legend and color bar capabilities of PLplot
+5.58 Documentation of the new legend and color bar capabilities of PLplot
 
 The pllegend and plcolorbar API has been documented in both doxygen
 and DocBook forms.  In addition, the "advanced use" chapter of the
@@ -1369,7 +1374,7 @@
 additional experience with these powerful capabilities.  In general,
 we would welcome such feature requests.
 
-2.59 The D bindings and examples have been converted from the
+5.59 The D bindings and examples have been converted from the
 old version of D (D1) to the new version of D (D2)
 
 This change should make PLplot much more relevant for D users
@@ -1378,7 +1383,7 @@
 See http://en.wikipedia.org/wiki/D_(programming_language)#History for
 a discussion of the differences between these two variants of D.
 
-2.60 The DocBook documentation for PLplot is now generated using modern
+5.60 The DocBook documentation for PLplot is now generated using modern
 XML/XSL backend tools for DocBook
 
 These modern backend tools (such as xmlto) replace the
@@ -1388,7 +1393,7 @@
 some improvements in the results (e.g., the table of Greek letters) as
 well as some minor style changes.
 
-2.61 Implement experimental build_projects sub-project
+5.61 Implement experimental build_projects sub-project
 
 The idea here (see cmake/build_projects) is to automate the build of
 all PLplot dependencies and the build and test of PLplot itself for
@@ -1398,13 +1403,13 @@
 This project is beginning to work properly for the Linux case, but
 still needs lots of work for the Windows case.
 
-2.62 Implement extremely simple "00" example
+5.62 Implement extremely simple "00" example
 
 The point of this standard example is to give the users an extremely
 simple tutorial example to help them to get started with 2D plotting
 with PLplot.
 
-2.63 Convert to using the Allura form of SourceForge software
+5.63 Convert to using the Allura form of SourceForge software
 
 We use sourceforge.net as our software hosting facility.  Early in
 2013 Sourceforge updated essentially all their support software as
@@ -1416,7 +1421,7 @@
 
 http://svn.code.sf.net/p/plplot/code/trunk/
 
-2.64 Use NON_TRANSITIVE linking by default for the shared libraries case for
+5.64 Use NON_TRANSITIVE linking by default for the shared libraries case for
 all non-windows systems
 
 The point of this change is to reduce overlinking and therefore
@@ -1427,16 +1432,14 @@
 resolve undefined symbols, i.e., do not link to a library just because
 it is a dependency of a dependency.
 
-2.65 Update f95 examples to take larger advantage of Fortran 95 capabilities
+5.65 Update f95 examples to take larger advantage of Fortran 95 capabilities
 
 Previously our f95 examples tended to use legacy Fortran capabilities, but
 that situation has substantially changed for this release.
 
-2.66 Substantial additions to the doxygen documentation
+5.66 Substantial additions to the doxygen documentation
 
 One of the on-going documentation projects is to create doxygen
 documentation of every single argument of the public API for PLplot.
 A substantial increase in such documentation has been implemented
 in this release cycle.
-
-

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Plplot-cvs] SF.net SVN: plplot:[12563] trunk/README.Release_Manager_Cookbook

[<ai...@us...>]

Revision: 12563
          http://sourceforge.net/p/plplot/code/12563
Author:   airwin
Date:     2013-10-01 16:51:17 +0000 (Tue, 01 Oct 2013)
Log Message:
-----------
Another refinement of the release manager cookbook.

These instructions are still pretty rough, but it contains the essence
of what I did in a realistic order, and for the next release I will
refine these instructions some more.

Modified Paths:
--------------
    trunk/README.Release_Manager_Cookbook

Modified: trunk/README.Release_Manager_Cookbook
===================================================================
--- trunk/README.Release_Manager_Cookbook	2013-10-01 06:30:27 UTC (rev 12562)
+++ trunk/README.Release_Manager_Cookbook	2013-10-01 16:51:17 UTC (rev 12563)
@@ -266,7 +266,7 @@
 library created by the PLplot build.
 
 (8) Create (a preliminary version of) the release tarball and check the result
-for errors.
+for errors
 
 This step depends on the steps above entitled
 
@@ -315,26 +315,8 @@
 Enter results of these and all other tests of this release into
 README.release.
 
-(10) Install and test a local copy of the PLplot website
+(10) Create ChangeLog.release
 
-This step depends on the steps above entitled
-
-"Prepare and test the documentation"
-"Update website-related files"
-"Update release date and versions"
-
-The step below entitled
-
-"Upload the local website to SourceForge"
-
-depends on this one.
-
-Follow the exact steps given above in "Install and test a
-(preliminary) local copy of the PLplot website" but this time with the
-correct RELEASE_DATE and VERSION.
-
-(11) Create ChangeLog.release
-
 N.B. commit all local changes to the repository so they will be
 reflected in the ChangeLog, tagged version of the release, and the release
 tarball.  And if there are committed changes after this one
@@ -361,86 +343,72 @@
 last commit for the trunk version of PLplot (see remarks above
 about when it is necessary to repeat this step).
 
-(12) Create the PLplot Release
+(11) Create the PLplot Release
 
 Based on suggestions in the svn manual, the PLplot svn archive is configured
 as follows:
 
-/trunk/plplot
+/trunk
 /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).
+For the release, you will be using svn to copy the /trunk version to
+/tags/vX_Y_Z (v5_9_10 for example to follow the previous naming
+conventions).
 
-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:
+To do this strictly on the server side with no local files involved at all
+use the following commands:
 
-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:
-
+# Check that you have committed everything and there are no other updates you
+# are unaware of.
 svn update
+svn status
+# Complete server side copy using new SourceForge Allura version of repository.
+# This is _much_ faster than copying from the local version.
+svn copy https://svn.code.sf.net/p/plplot/code/trunk https://svn.code.sf.net/p/plplot/code/tags/v5_9_10
 
-Now to create the branch for the new PLplot release, type the following
-command in the root plplot directory:
+# Check out this release tag
 
-svn copy trunk/ tags/vX_Y_Z
+svn checkout https://svn.code.sf.net/p/plplot/code/tags/v5_9_10 plplot_tags_5.9.10
 
-The commit the new tag:
+In the event that problems are found in the release tarball generated
+from the release tag, then trunk should be fixed, the trunk
+ChangeLog.release
+file recreated and committed (see instructions above).  Then merge the
+trunk version into the tags/vX_Y_Z branch as follows:
 
 cd tags/vX_Y_Z
-svn commit -m "Adding a tag for the X.Y.Z release."
+svn merge -r A:B /path/to/trunk
 
-cd to tags/ and enter the following commands: 
+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.
 
 
-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
-/tmp/plplot-dist-prep/
+# IMPORTANT: use this tagged version to create the website and tarball
+cd plplot_tags_5.9.10
 
-The "-c" option says to unpack the created tarball, build it with "cmake" and
-"make", then test that result with ctest.
+(11a) Install and test a local copy of the PLplot website
 
-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.
+This step depends on the steps above entitled
 
-The build will fail (without any warning messages on the console) if you 
-do not have the necessary tools to build the documentation. It is a good 
-idea to verify that you can build the documentation (-DBUILD_DOC=ON).
+"Prepare and test the documentation"
+"Update website-related files"
+"Update release date and versions"
 
-In the event that problems are found in PLplot during the release
-process, corrections should be made to trunk/, the ChangeLog.release
-file recreated and committed (see instructions above).  Then merge the
-trunk version into the tags/vX_Y_Z branch as follows:
+The step below entitled
 
-cd tags/vX_Y_Z
-svn merge -r A:B /path/to/trunk
+"Upload the local website to SourceForge"
 
-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.
+depends on this one.
 
-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
+Follow the exact steps given above in "Install and test a
+(preliminary) local copy of the PLplot website" but this time with the
+correct RELEASE_DATE and VERSION and also do this
+using the files from the tagged release directory, e.g., plplot_tags_5.9.10
 
-A list of your GPG keys can be obtained using the command "gpg --list-keys".
+(11b) Upload the local website to SourceForge
 
-(13) Upload the local website to SourceForge
-
 Once you are satisfied with the local website, you should upload it to
 SourceForge with rsync.
 
@@ -465,35 +433,99 @@
 N.B. the --dry-run option for rsync is a god-send and tells you exactly what
 will happen without actually doing it.
 
-(14) Prepare a file release
+Note that when changing release managers, the SF permissions are not set
+up correctly to delete files belonging to the old release manager
+using rsync.  (Or else we need to learn more about how to change
+ownership using rsync.)
 
-Login to sf.net.
-Go to the PLplot SourceForge project page.
+So you need to use sftp to do that, e.g.,
 
-Upload the Release:
-Select Files.
-Click on the plplot folder & select "Add folder".
-Enter the release name as the "New folder name:", e.g. X.Y.Z Source.
-Click on the release folder pop-up menu & select "upload", upload the
-release and the gpg signature file from /tmp/plplot-dist-prep/. This can
-take a few minutes without much feedback.
-Concatenate the README.release and ChangeLog.release files into a single 
-README.release file.
-Upload the concatenated README.release file.
-Click on the "i" or "info" button to mark the tar.gz file as the default 
-file to download for all platforms.
+sftp airwin,pl...@we...
 
+Then use the 
 
-Create a news item for the Release:
-Select Develop / News
-Click "Admin", select any older News Item and copy the test.
-Click "Submit"
-  Enter "PLplot Release X.Y.Z" as the subject.
-  Paste in the text from the older release as the Details.
-    Be sure to update the text as appropriate, particularly
-    the release numbers.
+ls -l
 
+command to figure out who owns what and the
 
+rm *
+
+command on the _file_ contents of each subdirectory of htdocs, and use
+the
+
+rmdir <directory name>
+
+command on empty directories.
+
+Note, sftp has no recursive feature so you have to figure out the
+directory structure and cd to the correct directory levels to remove
+the files in each directory, ugh.  I did try the sftp chown command,
+but that did not work so the only possibility I could find was the above
+commands to remove htdocs and everything below it in a piece-meal fashion.
+
+(11c) Create a final release tarball and check the result for errors
+
+Follow the above step entitled 
+
+"Create (a preliminary version of) the release tarball and check the result for errors"
+
+but this time for the tagged release to make sure the tarball is exactly
+consistent with the release tag.
+
+(11d) Sign the release with your plplot Release Manager gpg key:
+gpg --default-key YYYYYYYY --detach-sign --armor /tmp/plplot-dist-prep/plplot-X.Y.Z.tar.gz
+
+A list of your GPG keys can be obtained using the command "gpg --list-keys <name>".
+
+(11e) Verify the release tarball signing
+gpg --verify /tmp/plplot-dist-prep/plplot-X.Y.Z.tar.gz.asc
+
+(11f) Prepare a file release
+
+#IMPORTANT
+cd /tmp/plplot-dist-prep/
+
+sftp airwin,pl...@fr...
+cd /home/frs/project/p/pl/plplot/plplot
+mkdir 5.9.10\ Source
+cd 5.9.10\ Source
+put plplot-5.9.10.tar.gz.asc
+put plplot-5.9.10.tar.gz
+exit
+
+# Save a local copy of the release tarball for future reference.
+cd /home/software/plplot_svn/HEAD/export #(or wherever)
+cp -a /tmp/plplot-dist-prep/plplot-5.9.10.tar.gz* .
+gpg --verify plplot-5.9.10.tar.gz.asc
+
+cd plplot_tags_5.9.10
+echo "
+
+DETAILED CHANGELOG FOR THIS RELEASE
+
+" | cat README.release - ChangeLog.release >| /tmp/README.release
+
+cd /tmp
+sftp airwin,pl...@fr...
+cd /home/frs/project/p/pl/plplot/plplot/5.9.10\ Source
+put /tmp/README.release
+exit
+
+Create a news item for this release largely following previous
+news items (or even identical to them but with a changed title).
+
+Point your browser to http://sf.net/projects/plplot and login.  A
+news item will then be available on the menu bar.  Click that, then
+"new post".
+
+Enter the title (e.g., PLplot Release 5.9.10) and the text.  Surround
+the URL's in the text with angle brackets, e.g.
+<http://sourceforge.net/projects/plplot/files/plplot>.
+
+For now I simply make all paragraphs one giant line which seems
+to give reasonable default results.
+
+
 (15) Publicize the release announcement
 
 Jerry: macresearch.org
@@ -502,9 +534,14 @@
 
 (16) Prepare immediately for the 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.
+  a. Preserve the historical record of the
+     significant changes between versions of PLplot in one file by
+     prepending README.release for 5.9.10 to OLD-README.release
+
+cat README.release OLD-README.release > OLD-README.release_new
+mv OLD-README.release_new OLD-README.release
+
+
   b. Update README.release file to reflect significant changes made between
      the current release and the last release.
 

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Plplot-cvs] SF.net SVN: plplot:[12562] trunk/README.release

[<ai...@us...>]

Revision: 12562
          http://sourceforge.net/p/plplot/code/12562
Author:   airwin
Date:     2013-10-01 06:30:27 +0000 (Tue, 01 Oct 2013)
Log Message:
-----------
Prepare new version of this file (currently with no changes relative
to 5.9.10) to be used by every active developer during the course of the
of 5.9.11 release cycle to record their notable changes.

Modified Paths:
--------------
    trunk/README.release

Modified: trunk/README.release
===================================================================
--- trunk/README.release	2013-10-01 06:22:48 UTC (rev 12561)
+++ trunk/README.release	2013-10-01 06:30:27 UTC (rev 12562)
@@ -1,4 +1,4 @@
-PLplot Release 5.9.10
+PLplot Release 5.9.11
 ~~~~~~~~~~~~~~~~~~~~
 This is a development release of PLplot. It represents the ongoing efforts
 of the community to improve the PLplot plotting package. Development
@@ -21,32 +21,10 @@
 
 CHANGES
 
--1. Important changes we should have mentioned in previous release announcements.
+0. Tests made for release 5.9.11
 
--1.1 Add full bindings and examples for the D language.
+1. Changes relative to PLplot 5.9.10 (the previous development release)
 
-0. Tests made for release 5.9.10
-
-1. Changes relative to PLplot 5.9.9 (the previous development release)
-
-1.1 The format for map data used by plmap has changed
-1.2 Python support for Numeric has been dropped
-1.3 Backwards-incompatible API change to non-integer line widths
-1.4 Improvements to the build system for the Cygwin case
-1.5 The plcolorbar API has been finalized
-1.6 Documentation of the new legend and color bar capabilities of PLplot
-1.7 The D bindings and examples have been converted from the
-old version of D (D1) to the new version of D (D2)
-1.8 The DocBook documentation for PLplot is now generated using modern
-XML/XSL backend tools for DocBook
-1.9 Implement experimental build_projects sub-project
-1.10 Implement extremely simple "00" example
-1.11 Convert to using the Allura form of SourceForge software
-1.12 Use NON_TRANSITIVE linking by default for the shared libraries case for
-all non-windows systems
-1.13 Update f95 examples to take larger advantage of Fortran 95 capabilities
-1.14 Substantial additions to the doxygen documentation
-
 2. Changes relative to PLplot 5.8.0 (the previous stable release)
 
 2.1 All autotools-related files have now been removed
@@ -481,191 +459,10 @@
 
 CHANGES
 
-0. Tests made for release 5.9.10
+0. Tests made for release 5.9.11
 
-Comprehensive testing that showed no non-zero return codes or other
-obvious run-time issues such as segfaults was done for the Debian
-Wheezy platform.  These tests were done with the
-scripts/comprehensive_test.sh which does 21 major tests.  Those tests
-consist of seven tests (ctest, and "make test_noninteractive" and make
-"test_interactive" results for the build tree, and "make
-test_noninteractive" and make "test_interactive" results for both the
-traditional and CMake-based build systems for the installed examples
-tree) for each of our three major configurations (shared
-libraries/dynamic devices, shared libraries/non-dynamic devices,
-static libraries/non-dynamic devices).
+1. Changes relative to PLplot 5.9.10 (the previous development release)
 
-More limited testing that showed no non-zero return codes or other
-obvious run-time issues such as segfaults was done on a large number
-of different platforms including the following:
-
-Fedora with "Unix Makefiles" generator
-Ubuntu with "Unix Makefiles" generator
-Debian unstable with "Unix Makefiles" generator
-Debian wheezy with "Ninja" generator
-Wine version of Windows with "MSYS Makefiles" generator
-Wine version of Windows with "MinGW Makefiles" generator
-Wine version of Windows with "NMake Makefiles JOM" generator
-Microsoft version of Windows with Cygwin and with "Unix Makefiles" generator
-Microsoft version of Windows with "MinGW Makefiles" generator
-Microsoft version of Windows with "MSYS Makefiles" generator
-Microsoft version of Windows with "NMake Makefiles" generator
-
-1. Changes relative to PLplot 5.9.9 (the previous development release)
-
-N.B. This release includes many code cleanups and fixes relative to
-5.9.9 that are not mentioned in the list below.
-
-1.1 The format for map data used by plmap has changed
-
-The format for map data used by plmap is now the shapefile format.
-This is a widely used standard format and there are many sources of data
-in this format. This replaces the custom binary format that PLplot used
-to use. The support for reading shapefiles is provided by the shapelib
-library, which is a new dependency for PLplot. If users do not have this
-installed then, by default, they will not get any map capabilities with
-PLplot. Support for the old format can still be enabled by setting the
-PL_DEPRECATED cmake variable, but this support will be removed in a
-subsequent PLplot release.
-
-1.2 Python support for Numeric has been dropped
-
-Support for the python Numeric package has been dropped. This has been
-deprecated since 5.9.6. Numeric is no longer supported and is superseded
-by numpy. Support for numpy has been the default in plplot for a number
-of years so most users should notice no difference.
-
-1.3 Backwards-incompatible API change to non-integer line widths
-
-All functions which take line width arguments (plwidth, plshade*,
-pllegend) now use PLFLT values for the line width. This allows device
-drivers which are based on modern graphics libraries such as Qt4 and
-pango/cairo to make full use (e.g., extremely fine line widths) of the
-floating-point line width capabilities of those libraries.  The
-replacement of plwid by plwidth, and the change in argument lists for
-plshade* and pllegend constitute a backwards incompatible API change
-from previous releases and the soname of libraries has been bumped
-accordingly (which forces users to recompile PLplot).
-
-1.4 Improvements to the build system for the Cygwin case
-
-The Cygwin platform provides a full-featured Unix environment on
-Windows.  CMake has recently been changed (at the request of Cygwin
-developers) to emphasize the Unix aspects of the Cygwin platform and
-deemphasize the Windows aspects of that platform.  It was argued this
-change would tend to make CMake builds of software much more reliable
-on Cygwin, and after some small but important changes to our
-CMake-based build system to adjust for these recent CMake changes for
-Cygwin, we have indeed confirmed that prediction for the PLplot case.
-There are still some Cygwin platform issues left which are being
-discussed on our Wiki at http://www.miscdebris.net/plplot_wiki/index.php?title=Setup_cygwin,
-but some fundamental breakthroughs have also been made for the Cygwin case
-that should interest all our Windows users.  For example, for the
-first time ever we have been able to build our cairo and qt device
-drivers on the Cygwin platform giving our Windows users convenient
-access to the many high-quality PLplot devices that are available with
-these two different device drivers.
-
-1.5 The plcolorbar API has been finalized
-
-The function plcolorbar allows users to create a color bar (an
-annotated subplot representing a continuous range of colors within the
-main plot and typically identifying certain colors with certain
-numerical values using an axis).  The plcolorbar capabilities are
-documented in our DocBook (and doxygen) documentation and demonstrated
-in standard examples 16 and 33.
-
-N.B. The previous two releases (5.9.8 and 5.9.9) contained
-unadvertised experimental versions of plcolorbar.  Any PLplot user who
-found and tried those capabilities will have to reprogramme their
-plcolorbar calls to be compatible with the argument list of the latest
-version.
-
-1.6 Documentation of the new legend and color bar capabilities of PLplot
-
-The pllegend and plcolorbar API has been documented in both doxygen
-and DocBook forms.  In addition, the "advanced use" chapter of the
-DocBook form of documentation now contains a section giving an
-overview of pllegend and plcolorbar.
-
-N.B. Although we feel the pllegend and plcolorbar API has now been
-finalized with regard to the PLplot core developers own interests and
-needs, we also realize that as more and more PLplot users take
-advantage of these new PLplot capabilities there will likely be calls
-to add additional features to pllegend or plcolorbar based on
-additional experience with these powerful capabilities.  In general,
-we would welcome such feature requests.
-
-1.7 The D bindings and examples have been converted from the
-old version of D (D1) to the new version of D (D2)
-
-This change should make PLplot much more relevant for D users
-going forward.
-
-See http://en.wikipedia.org/wiki/D_(programming_language)#History for
-a discussion of the differences between these two variants of D.
-
-1.8 The DocBook documentation for PLplot is now generated using modern
-XML/XSL backend tools for DocBook
-
-These modern backend tools (such as xmlto) replace the
-deprecated/unmaintained SGML/DSSL tools we have used before.  For
-developers this means generation of our DocBook generation is much
-easier. much faster, and much less error-prone.  End users will notice
-some improvements in the results (e.g., the table of Greek letters) as
-well as some minor style changes.
-
-1.9 Implement experimental build_projects sub-project
-
-The idea here (see cmake/build_projects) is to automate the build of
-all PLplot dependencies and the build and test of PLplot itself for
-platforms (such as Linux enterprise distributions and all forms of
-Windows platforms other than Cygwin) that do not come with modern
-versions of PLplot soft dependencies such as Pango/Cairo and Qt.
-This project is beginning to work properly for the Linux case, but
-still needs lots of work for the Windows case.
-
-1.10 Implement extremely simple "00" example
-
-The point of this standard example is to give the users an extremely
-simple tutorial example to help them to get started with 2D plotting
-with PLplot.
-
-1.11 Convert to using the Allura form of SourceForge software
-
-We use sourceforge.net as our software hosting facility.  Early in
-2013 Sourceforge updated essentially all their support software as
-part of the so-called Allura project.  This made it necessary to make
-some minor internal PLplot changes such as script changes and different URL's
-in the website referring to SourceForge facilities.  The most important
-change from the user perspective is the URL for the Allura form
-of the svn repository that we use now:
-
-http://svn.code.sf.net/p/plplot/code/trunk/
-
-1.12 Use NON_TRANSITIVE linking by default for the shared libraries case for
-all non-windows systems
-
-The point of this change is to reduce overlinking and therefore
-the problems caused by overlinking that are mentioned
-at http://en.altlinux.org/UnderOverLinkProblems.
-
-Non-transitive linking means link only to libraries that directly
-resolve undefined symbols, i.e., do not link to a library just because
-it is a dependency of a dependency.
-
-1.13 Update f95 examples to take larger advantage of Fortran 95 capabilities
-
-Previously our f95 examples tended to use legacy Fortran capabilities, but
-that situation has substantially changed for this release.
-
-1.14 Substantial additions to the doxygen documentation
-
-One of the on-going documentation projects is to create doxygen
-documentation of every single argument of the public API for PLplot.
-A substantial increase in such documentation has been implemented
-in this release cycle.
-
 2. Changes relative to PLplot 5.8.0 (the previous stable release)
 
 N.B. This release includes many code cleanups and fixes relative to

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Plplot-cvs] SF.net SVN: plplot:[12561] trunk/OLD-README.release

[<ai...@us...>]

Revision: 12561
          http://sourceforge.net/p/plplot/code/12561
Author:   airwin
Date:     2013-10-01 06:22:48 +0000 (Tue, 01 Oct 2013)
Log Message:
-----------
Prepend README.release for 5.9.10 to this file.

Modified Paths:
--------------
    trunk/OLD-README.release

Modified: trunk/OLD-README.release
===================================================================
--- trunk/OLD-README.release	2013-09-30 23:24:39 UTC (rev 12560)
+++ trunk/OLD-README.release	2013-10-01 06:22:48 UTC (rev 12561)
@@ -1,3 +1,1648 @@
+PLplot Release 5.9.10
+~~~~~~~~~~~~~~~~~~~~
+This is a development release of PLplot. It represents the ongoing efforts
+of the community to improve the PLplot plotting package. Development
+releases in the 5.9.x series will be available every few months. The next
+stable release will be 5.10.0.
+
+     If you encounter a problem that is not already documented in the
+PROBLEMS file or on our bug tracker, then please send bug reports to PLplot
+developers via the mailing lists at
+http://sourceforge.net/mail/?group_id=2915 (preferred) or on our bug tracker
+at http://sourceforge.net/tracker/?group_id=2915&atid=102915.
+
+     Please see the license under which this software is distributed
+(LGPL), and the disclaimer of all warranties, given in the COPYING.LIB
+file.
+
+INDEX
+
+OFFICIAL NOTICES FOR USERS
+
+CHANGES
+
+-1. Important changes we should have mentioned in previous release announcements.
+
+-1.1 Add full bindings and examples for the D language.
+
+0. Tests made for release 5.9.10
+
+1. Changes relative to PLplot 5.9.9 (the previous development release)
+
+1.1 The format for map data used by plmap has changed
+1.2 Python support for Numeric has been dropped
+1.3 Backwards-incompatible API change to non-integer line widths
+1.4 Improvements to the build system for the Cygwin case
+1.5 The plcolorbar API has been finalized
+1.6 Documentation of the new legend and color bar capabilities of PLplot
+1.7 The D bindings and examples have been converted from the
+old version of D (D1) to the new version of D (D2)
+1.8 The DocBook documentation for PLplot is now generated using modern
+XML/XSL backend tools for DocBook
+1.9 Implement experimental build_projects sub-project
+1.10 Implement extremely simple "00" example
+1.11 Convert to using the Allura form of SourceForge software
+1.12 Use NON_TRANSITIVE linking by default for the shared libraries case for
+all non-windows systems
+1.13 Update f95 examples to take larger advantage of Fortran 95 capabilities
+1.14 Substantial additions to the doxygen documentation
+
+2. Changes relative to PLplot 5.8.0 (the previous stable release)
+
+2.1 All autotools-related files have now been removed
+2.2 Build system bug fixes
+2.3 Build system improvements
+2.4 Implement build-system infrastructure for installed Ada bindings and
+examples
+2.5 Code cleanup
+2.6 Date / time labels for axes
+2.7 Alpha value support
+2.8 New PLplot functions
+2.9 External libLASi library improvements affecting our psttf device
+2.10 Improvements to the cairo driver family
+2.11 wxWidgets driver improvements
+2.12 pdf driver improvements
+2.13 svg driver improvements
+2.14 Ada language support
+2.15 OCaml language support
+2.16 Perl/PDL language support
+2.17 Update to various language bindings
+2.18 Update to various examples
+2.19 Extension of our test framework
+2.20 Rename test subdirectory to plplot_test
+2.21 Website support files updated
+2.22 Internal changes to function visibility
+2.23 Dynamic driver support in Windows
+2.24 Documentation updates
+2.25 libnistcd (a.k.a. libcd) now built internally for -dev cgm
+2.26 get-drv-info now changed to test-drv-info
+2.27 Text clipping now enabled by default for the cairo devices
+2.28 A powerful qt device driver has been implemented
+2.29 The PLplot API is now accessible from Qt GUI applications
+2.30 NaN / Inf support for some PLplot functions
+2.31 Various bug fixes
+2.32 Cairo driver improvements
+2.33 PyQt changes
+2.34 Color Palettes
+2.35 Re-implementation of a "soft landing" when a bad/missing compiler is
+detected
+2.36 Make PLplot aware of LC_NUMERIC locale
+2.37 Linear gradients have been implemented
+2.38 Cairo Windows driver implemented
+2.39 Custom axis labelling implemented
+2.40 Universal coordinate transform implemented
+2.41 Support for arbitrary storage of 2D user data
+2.42 Font improvements
+2.42 Alpha value support for plotting in memory.
+2.43 Add a Qt device for in memory plotting.
+2.44 Add discrete legend capability.
+2.45 Add full bindings and examples for the D language.
+2.46 The plstring and plstring3 functions have been added
+2.47 The pllegend API has been finalized
+2.48 Octave bindings now implemented with swig
+2.49 Documentation redone for our swig-generated Python and Octave bindings
+2.50 Support large polygons
+2.51 Complete set of PLplot parameters now available for Fortran
+2.52 The plarc function has been added
+2.53 The format for map data used by plmap has changed
+2.54 Python support for Numeric has been dropped
+2.55 Backwards-incompatible API change to non-integer line widths
+2.56 Improvements to the build system for the Cygwin case
+2.57 The plcolorbar API has been finalized
+2.58 Documentation of the new legend and color bar capabilities of PLplot
+2.59 The D bindings and examples have been converted from the
+old version of D (D1) to the new version of D (D2)
+2.60 The DocBook documentation for PLplot is now generated using modern
+XML/XSL backend tools for DocBook
+2.61 Implement experimental build_projects sub-project
+2.62 Implement extremely simple "00" example
+2.63 Convert to using the Allura form of SourceForge software
+2.64 Use NON_TRANSITIVE linking by default for the shared libraries case for
+all non-windows systems
+2.65 Update f95 examples to take larger advantage of Fortran 95 capabilities
+2.66 Substantial additions to the doxygen documentation
+
+
+OFFICIAL NOTICES FOR USERS
+
+(5.9.10) The minimum version of CMake has been bumped to 2.8.9.  This
+change allows our build system to take advantage of CMake features
+introduced in later versions of CMake.  Even more importantly it also
+updates user's builds to the CMake policy conventions (important
+backwards-incompatible changes in CMake behaviour introduced in later
+versions of CMake) to the default CMake policy used for 2.8.9.
+
+(5.9.10) The long deprecated support for the python Numeric package has been
+dropped. This is no longer supported and is superseded by numpy. Support for
+numpy has been the default in PLplot for a number of years so most users
+should notice no difference.
+
+(5.9.10) The current format for maps used by plmap has been deprecated in
+favour of using shapefiles (a standard format widely used for GIS and with
+suitable free data sources available). This requires the shapelib library
+to be installed. If this library is not installed then by default no map
+support will be available. Support for the old binary format is still
+available by setting the cmake variable PL_DEPRECATED, however this
+support will be removed in a future release of PLplot.
+
+(5.9.10) Those who use the Python version of plgriddata will have to
+change their use of this function for this release as follows (see
+examples/xw21.py)
+
+# old version (which overwrites preexisting zg in place):
+zg = reshape(zeros(xp*yp),(xp,yp))
+plgriddata(x, y, z, xg, yg, zg, alg, opt[alg-1])
+
+# new version (which uses a properly returned newly created NumPy array
+# as per the normal Python expectations):
+
+zg = plgriddata(x, y, z, xg, yg, alg, opt[alg-1])
+
+(5.9.10) Significant efforts have been made to ensure the PLplot code
+is standards compliant and free from warnings. Compliance has been
+tested using the gcc compiler suite -std, -pedantic and -W  flags. The
+language standards adopted are
+C: ISO C99 with POSIX.1-2001 base specification (required for a number
+of C library calls)
+C++: ISO C++ 1998 standard plus amendments
+F95: Fortran 95 standard
+
+Specifically, the following gcc / g++ / gfortran flags were used
+
+CFLAGS='-O3 -std=c99 -pedantic -D_POSIX_C_SOURCE=200112L -Wall  \
+-Wextra -Wmissing-prototypes -Wstrict-prototypes -Wnested-externs \
+-Wconversion -Wshadow -Wcast-qual -Wcast-align -Wwrite-strings'
+
+CXXFLAGS='-O3 -fvisibility=hidden -std=c++98 -pedantic -Wall -Wextra '
+
+FFLAGS='-std=f95 -O3 -fall-intrinsics -fvisibility=hidden -pedantic \
+-Wall -Wextra '
+
+Note that the code is not yet quite standards compliant or warning free,
+but this is our aim. We know that a number of common compilers do not
+support these standards "out of the box", so we will continue to develop
+and support workarounds to ensure that PLplot remains easily built on
+a variety of platforms and compilers. Standards compliance should make
+it easier to port to new systems in the future. Using aggressive
+warnings flags will help to detect and eliminate errors or problems in
+the libraries.
+
+The gfortran -fall-intrinsics flag is required for a couple of
+non-standard intrinsics which are used in the code. In the future
+adopting the fortran 2003 or 2008 standard should allow this to be
+removed.
+
+Note: currently this code cleanup does not apply to code generated by
+swig (octave, python, java, lua bindings) which gives a large number of
+code warnings.
+
+(5.9.10) For some years now we have had both FORTRAN 77 and Fortran 95
+bindings, but to the best of our knowledge, there are no longer
+any maintained FORTRAN 77 compilers left that do not also support
+Fortran 95. (g77 for instance has not been maintained for several
+years now. Its successor gfortran supports Fortran 95 and later standards
+as well all g77's legacy features).
+
+An important consequence is that we can not test the implementation for
+compliance to the FORTRAN 77 standard.
+Furthermore, we would prefer to concentrate all our Fortran
+development effort on our f95 bindings and strongly encourage all our
+Fortran users to use those bindings if they haven't switched from the
+f77 version already. Therefore, as of this release we are deprecating
+the f77 bindings and examples and plan no further support for them.
+We signal this deprecation by disabling f77 by default (although our
+users can still get access to these unsupported bindings and examples
+for now by specifying the -DENABLE_f77=ON cmake option).
+
+We plan to completely remove the f77 bindings and examples
+two releases after this one.
+
+(5.9.10) We have found that some distributions of the Windows
+MinGW/gfortran compiler (i.e., MinGW/gfortran 4.6.1 and 4.6.2 from
+http://www.equation.com) may cause a link error due to duplicate
+symbols like __gfortran_setarg_. These errors can be suppressed by
+adding the flag -Wl,--allow-multiple-define. It is very likely that
+this is a bug in these distributions.
+
+As building the libraries and the examples succeeds without any problem
+if you use most other distributions of Windows MinGW/gfortran,
+we have decided not to include this flag in our build system.
+
+Distributions that are known to work:
+- MinGW/gfortran-4.5 from http://www.equation.com,
+- MinGW/gfortran-4.5.2-1 that is installed using the latest
+  mingw-get-inst-20110802 automatic installer available at
+  http://sourceforge.net/projects/mingw/files/Installer/mingw-get-inst
+- MinGW/gfortran-4.6.2 from tdm-gcc.tdragon.net
+
+(Therefore it is not the 4.5.x versus 4.6.x version of MinGW/gfortran
+as such that causes this problem.)
+
+(5.9.9) This is a quick release to deal with two broken build issues
+that were recently discovered for our Windows platform.  Windows users should
+avoid 5.9.8 because of these problems for that release, and instead use
+5.9.9 which has been heavily tested on a number of platforms including
+Windows, see "Tests made for release 5.9.9" below.
+
+(5.9.8) For unicode-aware devices we now follow what is done for the
+Hershey font case for epsilon, theta, and phi.  This means the #ge,
+#gh, and #gf escapes now give users the Greek lunate epsilon, the
+ordinary Greek lower case theta, and the Greek symbol phi for Unicode
+fonts just like has occurred since the dawn of PLplot history for the
+Hershey font case.  Previously these legacy escapes were assigned to
+ordinary Greek lower-case epsilon, the Greek symbol theta (= script
+theta), and the ordinary Greek lower case phi for unicode fonts
+inconsistently with what occurred for Hershey fonts.  This change gets
+rid of this inconsistency, that is the #g escapes should give the best
+unicode approximation to the Hershey glyph result that is possible for
+unicode-aware devices.
+
+In general we encourage users of unicode-aware devices who might
+dislike the Greek glyph Hershey-lookalike choices they get with the
+legacy #g escapes to use instead either PLplot unicode escapes (e.g.,
+"#[0x03b5]" for ordinary Greek lower-case epsilon, see page 3 of
+example 23) or better yet, UTF-8 strings (e.g., "ε") to specify
+exactly what unicode glyph they want.
+
+(5.9.8) The full set of PLplot constants have been made available to
+our Fortran 95 users as part of the plplot module.  This means those
+users will have to remove any parameter statements where they have
+previously defined the PLplot constants (whose names typically start
+with "PL_" for themselves.  For a complete list of the affected
+constants, see the #defines in swig-support/plplotcapi.i which are
+used internally to help generate the plplot module.  See also Index
+item 2.51 below.
+
+(5.9.8) There has been widespread const modifier changes in the API
+for libplplotd and libplplotcxxd.  Those backwards-incompatible API
+changes are indicated in the usual way by a soversion bump in those
+two libraries which will force all apps and libraries that depend on
+those two libraries to be rebuilt.
+
+Specifically, we have changed the following arguments in the C library
+(libplplotd) case
+
+type * name1 ==> const type * name1
+type * name2 ==> const type ** name2
+
+and the following arguments in the C++ library (libplplotcxxd) case
+
+type * name1 ==> const type * name1
+type * name1 ==> const type * const * name2
+
+where name1 is the name of a singly dimensioned array whose values are
+not changed internally by the PLplot libraries and name2 is the name
+of a doubly dimensioned array whose values are not changed internally
+by the PLplot libraries.
+
+The general documentation and safety justification for such const
+modifier changes to our API is given in
+http://www.cprogramming.com/tutorial/const_correctness.html.
+Essentially, the above const modifier changes constitute our guarantee
+that the associated arrays are not changed internally by the PLplot
+libraries.
+
+Although it is necessary to rebuild all apps and libraries that depend
+on libplplotd and/or libplplotcxxd, that rebuild should be possible
+with unchanged source code without build errors in all cases.  For C
+apps and libraries (depending on libplplotd) there will be additional
+build warnings due to a limitation in the C standard discussed at
+http://c-faq.com/ansi/constmismatch.html unless all doubly dimensioned
+arrays (but not singly dimensioned) are explicitly cast to (const type
+**).  However, such source code changes will not be necessary to avoid
+warning messages for the C++ (libplplotcxxd) change because of the
+double use of const in the above "const type * const * name2" change.
+
+(5.9.8) The plarc API has changed in release 5.9.8.  The plarc API now
+has a rotation parameter which will eventually allow for rotated arcs.
+PLplot does not currently support rotated arcs, but the plarc function
+signature has been modified to avoid changing the API when this
+functionality is added.
+
+(5.9.6) We have retired the pbm driver containing the pbm (actually
+portable pixmap) file device. This device is quite primitive and
+poorly maintained. It ignores unicode fonts (i.e., uses the Hershey
+font fallback), falls back to ugly software fills, doesn't support
+alpha transparency, etc.  It also has a serious run-time issue with
+example 2 (double free detected by glibc) which probably indicates
+some fundamental issue with the 100 colors in cmap0 for that
+example. For those who really need portable pixmap results, we suggest
+using the ImageMagick convert programme, e.g., "convert
+examples/x24c01.pngqt test.ppm" or "convert examples/x24c01.pngcairo
+test.ppm" to produce good-looking portable pixmap results from our
+best png device results.
+
+(5.9.6) We have retired the linuxvga driver containing the linuxvga
+interactive device.  This device is quite primitive, difficult to
+test, and poorly maintained. It ignores unicode fonts (i.e., uses the
+Hershey font fallback), falls back to ugly software fills, doesn't
+support alpha transparency, etc.  It is Linux only, can only be run as
+root, and svgalib (the library used by linuxsvga) is not supported by
+some mainstream (e.g., Intel) chipsets.  All of these characteristics
+make it difficult to even test this device much less use it for
+anything serious.  Finally, it has had a well-known issue for years
+(incorrect colors) which has never been fixed indicating nobody is
+interested in maintaining this device.
+
+(5.9.6) We have retired our platform support of djgpp that used to
+reside in sys/dos/djgpp.  The developer (Andrew Roach) who used to
+maintain those support files for djgpp feels that the djgpp platform
+is no longer actively developed, and he no longer uses djgpp himself.
+
+(5.9.6) We have changed plpoin results for ascii codes 92, 94, and 95
+from centred dot, degree symbol, and centred dot glyphs to the correct
+backslash, caret, and underscore glyphs that are associated with those
+ascii indices.  This change is consistent with the documentation of
+plpoin and solves a long-standing issue with backslash, caret, and
+underscore ascii characters in character strings used for example by
+pl[mp]tex.  Those who need access to a centred dot with plpoin should
+use index 1.  The degree symbol is no longer accessible with plpoin,
+but it is available in ordinary text input to PLplot as Hershey escape
+"#(718)", where 718 is the Hershey index of the degree symbol, unicode
+escape "#[0x00B0]" where 0x00B0 is the unicode index for the degree
+symbol or direct UTF8 unicode string "°".
+
+(5.9.6) We have retired the gcw device driver and the related gnome2
+and pygcw bindings since these are unmaintained and there are good
+replacements.  These components of PLplot were deprecated as of
+release 5.9.3.  A good replacement for the gcw device is either the
+xcairo or qtwidget device.  A good replacement for the gnome2 bindings
+is the externally supplied XDrawable or Cairo context associated with
+the xcairo device and the extcairo device (see
+examples/c/README.cairo).  A good replacement for pygcw is our new
+pyqt4 bindings for PLplot.
+
+(5.9.6) We have deprecated support for the python Numeric array
+extensions. Numeric is no longer maintained and users of Numeric are
+advised to migrate to numpy. Numpy has been the standard for PLplot
+for some time. If numpy is not present PLplot will now disable python
+by default. If you still require Numeric support in the short term
+then set USE_NUMERIC to ON in cmake. The PLplot support for Numeric
+will be dropped in a future release.
+
+(5.9.5) We have removed pyqt3 access to PLplot and replaced it by
+pyqt4 access to PLplot (see details below).
+
+(5.9.5) The only method of specifying a non-default compiler (and
+associated compiler options) that we support is the environment
+variable approach, e.g.,
+
+export CC='gcc -g -fvisibility=hidden'
+export CXX='g++ -g -fvisibility=hidden'
+export FC='gfortran -g -fvisibility=hidden'
+
+All other CMake methods of specifying a non-default compiler and
+associated compiler options will not be supported until CMake bug 9220
+is fixed, see discussion below of the soft-landing re-implementation
+for details.
+
+(5.9.5) We have retired the hpgl driver (containing the hp7470,
+hp7580, and lj_hpgl devices), the impress driver (containing the imp
+device), the ljii driver (containing the ljii and ljiip devices), and
+the tek driver (containing the conex, mskermit, tek4107, tek4107f,
+tek4010, tek4010f, versaterm, vlt, and xterm devices).  Retirement
+means we have removed the build options which would allow these
+devices to build and install.  Recent tests have shown a number of
+run-time issues (hpgl, impress, and ljii) or build-time issues (tek)
+with these devices, and as far as we know there is no more user
+interest in them. Therefore, we have decided to retire these devices
+rather than fix them.
+
+(5.9.4) We have deprecated the pbm device driver (containing the pbm
+device) because glibc detects a catastrophic double free.
+
+(5.9.3) Our build system requires CMake version 2.6.0 or higher.
+
+(5.9.3) We have deprecated the gcw device driver and the related
+gnome2 and pygcw bindings since these are essentially unmaintained.
+For example, the gcw device and associated bindings still depends on
+the plfreetype approach for accessing unicode fonts which has known
+issues (inconsistent text offsets, inconvenient font setting
+capabilities, and incorrect rendering of CTL languages).  To avoid
+these issues we advise using the xcairo device and the externally
+supplied XDrawable or Cairo context associated with the xcairo device
+and the extcairo device (see examples/c/README.cairo) instead. If you
+still absolutely must use -dev gcw or the related gnome2 or pygcw
+bindings despite the known problems, then they can still be accessed
+by setting PLD_gcw, ENABLE_gnome2, and/or ENABLE_pygcw to ON.
+
+(5.9.3) We have deprecated the gd device driver which implements the
+png, jpeg, and gif devices.  This device driver is essentially
+unmaintained. For example, it still depends on the plfreetype approach
+for accessing unicode fonts which has known issues (inconsistent text
+offsets, inconvenient font setting capabilities, and incorrect
+rendering of CTL languages).  To avoid these issues for PNG format, we
+advise using the pngcairo or pngqt devices.  To avoid these issues for
+the JPEG format, we advise using the jpgqt device.  PNG is normally
+considered a better raster format than GIF, but if you absolutely
+require GIF format, we advise using the pngcairo or pngqt devices and
+then downgrading the results to the GIF format using the ImageMagick
+"convert" application.  For those platforms where libgd (the
+dependency of the gd device driver) is accessible while the required
+dependencies of the cairo and/or qt devices are not accessible, you
+can still use these deprecated devices by setting PLD_png, PLD_jpeg,
+or PLD_gif to ON.
+
+(5.9.3) We have re-enabled the tk, itk, and itcl components of PLplot
+by default that were disabled by default as of release 5.9.1 due to
+segfaults.  The cause of the segfaults was a bug (now fixed) in how
+pthread support was implemented for the Tk-related components of
+PLplot.
+
+(5.9.2) We have set HAVE_PTHREAD (now called PL_HAVE_PTHREAD as of
+release 5.9.8) to ON by default for all platforms other than Darwin.
+Darwin will follow later once it appears the Apple version of X
+supports it.
+
+(5.9.1) We have removed our previously deprecated autotools-based
+build system.  Instead, use the CMake-based build system following the
+directions in the INSTALL file.
+
+(5.9.1) We no longer support Octave-2.1.73 which has a variety of
+run-time issues in our tests of the Octave examples on different
+platforms. In contrast our tests show we get good run-time results
+with all our Octave examples for Octave-3.0.1. Also, that is the
+recommended stable version of Octave at
+http://www.gnu.org/software/octave/download.html so that is the only
+version of Octave we support at this time.
+
+(5.9.1) We have decided for consistency sake to change the PLplot
+stream variables plsc->vpwxmi, plsc->vpwxma, plsc->vpwymi, and
+plsc->vpwyma and the results returned by plgvpw to reflect the exact
+window limit values input by users using plwind. Previously to this
+change, the stream variables and the values returned by plgvpw
+reflected the internal slightly expanded range of window limits used
+by PLplot so that the user's specified limits would be on the graph.
+Two users noted this slight difference, and we agree with them it
+should not be there. Note that internally, PLplot still uses the
+expanded ranges so most users results will be identical.  However, you
+may notice some small changes to your plot results if you use these
+stream variables directly (only possible in C/C++) or use plgvpw.
+
+CHANGES
+
+0. Tests made for release 5.9.10
+
+Comprehensive testing that showed no non-zero return codes or other
+obvious run-time issues such as segfaults was done for the Debian
+Wheezy platform.  These tests were done with the
+scripts/comprehensive_test.sh which does 21 major tests.  Those tests
+consist of seven tests (ctest, and "make test_noninteractive" and make
+"test_interactive" results for the build tree, and "make
+test_noninteractive" and make "test_interactive" results for both the
+traditional and CMake-based build systems for the installed examples
+tree) for each of our three major configurations (shared
+libraries/dynamic devices, shared libraries/non-dynamic devices,
+static libraries/non-dynamic devices).
+
+More limited testing that showed no non-zero return codes or other
+obvious run-time issues such as segfaults was done on a large number
+of different platforms including the following:
+
+Fedora with "Unix Makefiles" generator
+Ubuntu with "Unix Makefiles" generator
+Debian unstable with "Unix Makefiles" generator
+Debian wheezy with "Ninja" generator
+Wine version of Windows with "MSYS Makefiles" generator
+Wine version of Windows with "MinGW Makefiles" generator
+Wine version of Windows with "NMake Makefiles JOM" generator
+Microsoft version of Windows with Cygwin and with "Unix Makefiles" generator
+Microsoft version of Windows with "MinGW Makefiles" generator
+Microsoft version of Windows with "MSYS Makefiles" generator
+Microsoft version of Windows with "NMake Makefiles" generator
+
+1. Changes relative to PLplot 5.9.9 (the previous development release)
+
+N.B. This release includes many code cleanups and fixes relative to
+5.9.9 that are not mentioned in the list below.
+
+1.1 The format for map data used by plmap has changed
+
+The format for map data used by plmap is now the shapefile format.
+This is a widely used standard format and there are many sources of data
+in this format. This replaces the custom binary format that PLplot used
+to use. The support for reading shapefiles is provided by the shapelib
+library, which is a new dependency for PLplot. If users do not have this
+installed then, by default, they will not get any map capabilities with
+PLplot. Support for the old format can still be enabled by setting the
+PL_DEPRECATED cmake variable, but this support will be removed in a
+subsequent PLplot release.
+
+1.2 Python support for Numeric has been dropped
+
+Support for the python Numeric package has been dropped. This has been
+deprecated since 5.9.6. Numeric is no longer supported and is superseded
+by numpy. Support for numpy has been the default in plplot for a number
+of years so most users should notice no difference.
+
+1.3 Backwards-incompatible API change to non-integer line widths
+
+All functions which take line width arguments (plwidth, plshade*,
+pllegend) now use PLFLT values for the line width. This allows device
+drivers which are based on modern graphics libraries such as Qt4 and
+pango/cairo to make full use (e.g., extremely fine line widths) of the
+floating-point line width capabilities of those libraries.  The
+replacement of plwid by plwidth, and the change in argument lists for
+plshade* and pllegend constitute a backwards incompatible API change
+from previous releases and the soname of libraries has been bumped
+accordingly (which forces users to recompile PLplot).
+
+1.4 Improvements to the build system for the Cygwin case
+
+The Cygwin platform provides a full-featured Unix environment on
+Windows.  CMake has recently been changed (at the request of Cygwin
+developers) to emphasize the Unix aspects of the Cygwin platform and
+deemphasize the Windows aspects of that platform.  It was argued this
+change would tend to make CMake builds of software much more reliable
+on Cygwin, and after some small but important changes to our
+CMake-based build system to adjust for these recent CMake changes for
+Cygwin, we have indeed confirmed that prediction for the PLplot case.
+There are still some Cygwin platform issues left which are being
+discussed on our Wiki at http://www.miscdebris.net/plplot_wiki/index.php?title=Setup_cygwin,
+but some fundamental breakthroughs have also been made for the Cygwin case
+that should interest all our Windows users.  For example, for the
+first time ever we have been able to build our cairo and qt device
+drivers on the Cygwin platform giving our Windows users convenient
+access to the many high-quality PLplot devices that are available with
+these two different device drivers.
+
+1.5 The plcolorbar API has been finalized
+
+The function plcolorbar allows users to create a color bar (an
+annotated subplot representing a continuous range of colors within the
+main plot and typically identifying certain colors with certain
+numerical values using an axis).  The plcolorbar capabilities are
+documented in our DocBook (and doxygen) documentation and demonstrated
+in standard examples 16 and 33.
+
+N.B. The previous two releases (5.9.8 and 5.9.9) contained
+unadvertised experimental versions of plcolorbar.  Any PLplot user who
+found and tried those capabilities will have to reprogramme their
+plcolorbar calls to be compatible with the argument list of the latest
+version.
+
+1.6 Documentation of the new legend and color bar capabilities of PLplot
+
+The pllegend and plcolorbar API has been documented in both doxygen
+and DocBook forms.  In addition, the "advanced use" chapter of the
+DocBook form of documentation now contains a section giving an
+overview of pllegend and plcolorbar.
+
+N.B. Although we feel the pllegend and plcolorbar API has now been
+finalized with regard to the PLplot core developers own interests and
+needs, we also realize that as more and more PLplot users take
+advantage of these new PLplot capabilities there will likely be calls
+to add additional features to pllegend or plcolorbar based on
+additional experience with these powerful capabilities.  In general,
+we would welcome such feature requests.
+
+1.7 The D bindings and examples have been converted from the
+old version of D (D1) to the new version of D (D2)
+
+This change should make PLplot much more relevant for D users
+going forward.
+
+See http://en.wikipedia.org/wiki/D_(programming_language)#History for
+a discussion of the differences between these two variants of D.
+
+1.8 The DocBook documentation for PLplot is now generated using modern
+XML/XSL backend tools for DocBook
+
+These modern backend tools (such as xmlto) replace the
+deprecated/unmaintained SGML/DSSL tools we have used before.  For
+developers this means generation of our DocBook generation is much
+easier. much faster, and much less error-prone.  End users will notice
+some improvements in the results (e.g., the table of Greek letters) as
+well as some minor style changes.
+
+1.9 Implement experimental build_projects sub-project
+
+The idea here (see cmake/build_projects) is to automate the build of
+all PLplot dependencies and the build and test of PLplot itself for
+platforms (such as Linux enterprise distributions and all forms of
+Windows platforms other than Cygwin) that do not come with modern
+versions of PLplot soft dependencies such as Pango/Cairo and Qt.
+This project is beginning to work properly for the Linux case, but
+still needs lots of work for the Windows case.
+
+1.10 Implement extremely simple "00" example
+
+The point of this standard example is to give the users an extremely
+simple tutorial example to help them to get started with 2D plotting
+with PLplot.
+
+1.11 Convert to using the Allura form of SourceForge software
+
+We use sourceforge.net as our software hosting facility.  Early in
+2013 Sourceforge updated essentially all their support software as
+part of the so-called Allura project.  This made it necessary to make
+some minor internal PLplot changes such as script changes and different URL's
+in the website referring to SourceForge facilities.  The most important
+change from the user perspective is the URL for the Allura form
+of the svn repository that we use now:
+
+http://svn.code.sf.net/p/plplot/code/trunk/
+
+1.12 Use NON_TRANSITIVE linking by default for the shared libraries case for
+all non-windows systems
+
+The point of this change is to reduce overlinking and therefore
+the problems caused by overlinking that are mentioned
+at http://en.altlinux.org/UnderOverLinkProblems.
+
+Non-transitive linking means link only to libraries that directly
+resolve undefined symbols, i.e., do not link to a library just because
+it is a dependency of a dependency.
+
+1.13 Update f95 examples to take larger advantage of Fortran 95 capabilities
+
+Previously our f95 examples tended to use legacy Fortran capabilities, but
+that situation has substantially changed for this release.
+
+1.14 Substantial additions to the doxygen documentation
+
+One of the on-going documentation projects is to create doxygen
+documentation of every single argument of the public API for PLplot.
+A substantial increase in such documentation has been implemented
+in this release cycle.
+
+2. Changes relative to PLplot 5.8.0 (the previous stable release)
+
+N.B. This release includes many code cleanups and fixes relative to
+5.8.0 that are not mentioned in the list below.
+
+2.1 All autotools-related files have now been removed
+
+CMake is now the only supported build system. It has been tested on
+Linux / Unix, Mac OS-X and Windows platforms.
+
+2.2 Build system bug fixes
+
+Various fixes include the following:
+
+Ctest will now work correctly when the build tree path includes symlinks.
+
+Dependencies for swig generated files fixed so they are not rebuilt every
+time make is called.
+
+Various dependency fixes to ensure that parallel builds (using make -j)
+work under unix.
+
+2.3 Build system improvements
+
+We now transform link flag results delivered to the CMake environment by
+pkg-config into the preferred CMake form of library information.  The
+practical effect of this improvement is that external libraries in
+non-standard locations now have their rpath options set correctly for our
+build system both for the build tree and the install tree so you don't have
+to fiddle with LD_LIBRARY_PATH, etc.
+
+2.4 Implement build-system infrastructure for installed Ada bindings and
+examples
+
+Install source files, library information files, and the plplotada library
+associated with the Ada bindings.  Configure and install the pkg-config file
+for the plplotada library.  Install the Ada examples and a configured Makefile
+to build them in the install tree.
+
+2.5 Code cleanup
+
+The PLplot source code has been cleaned up to make consistent use of
+(const char *) and (char *) throughout. Some API functions have changed
+to use const char * instead of char * to make it clear that the strings
+are not modified by the function. The C and C++ examples have been updated
+consistent with this. These changes fix a large number of warnings
+with gcc-4.2. Note: this should not require programs using PLplot to be
+recompiled as it is not a binary API change.
+
+There has also been some cleanup of include files in the C++ examples
+so the code will compile with the forthcoming gcc-4.3.
+
+2.6 Date / time labels for axes
+
+PLplot now allows date / time labels to be used on axes. A new option
+('d') is available for the xopt and yopt arguments to plbox which
+indicates that the axis should be interpreted as a date / time. Similarly
+there is a new range of options for plenv to select date / time labels.
+The time format is seconds since the epoch (usually 1 Jan 1970). This
+format is commonly used on most systems. The C gmtime routine can be
+used to calculate this for a given date and time. The format for the
+labels is controlled using a new pltimefmt function, which takes a
+format string. All formatting is done using the C strftime function.
+See documentation for available options on your platform. Example 29
+demonstrates the new capabilities.
+
+N.B. Our reliance on C library POSIX time routines to (1) convert from
+broken-down time to time-epoch, (2) to convert from time-epoch to
+broken-down time, and (3) to format results with strftime have proved
+problematic for non-C languages which have time routines of variable
+quality.  Also, it is not clear that even the POSIX time routines are
+available on Windows. So we have plans afoot to implement high-quality
+versions of (1), (2), and (3) with additional functions to get/set the epoch
+in the PLplot core library itself.  These routines should work on all C
+platforms and should also be uniformly accessible for all our language
+bindings.
+
+WARNING.....  Therefore, assuming these plans are implemented, the present
+part of our date/time PLplot API that uses POSIX time routines will be
+changed.
+
+2.7 Alpha value support
+
+PLplot core has been modified to support a transparency or alpha value
+channel for each color in color map 0 and 1. In addition a number of new
+functions were added the PLplot API so that the user can both set and query
+alpha values for color in the two color maps. These functions have the same
+name as their non-alpha value equivalents, but with a an "a" added to the
+end. Example 30 demonstrates some different ways to use these functions
+and the effects of alpha values, at least for those drivers that support alpha
+values. This change should have no effect on the device drivers that do not
+currently support alpha values. Currently only the cairo, qt, gd, wxwidgets and
+aquaterm drivers support alpha values. There are some limitations with the gd
+driver due to transparency support in the underlying libgd library.
+
+2.8 New PLplot functions
+
+An enhanced version of plimage, plimagefr has been added. This allows images
+to be plotted using coordinate transformation, and also for the dynamic range
+of the plotted values to be altered. Example 20 has been modified to
+demonstrate this new functionality.
+
+To ensure consistent results in example 21 between different platforms and
+language bindings PLplot now includes a small random number generator within
+the library. plrandd will return a PLFLT random number in the range 0.0-1.0.
+plseed will allow the random number generator to be seeded.
+
+2.9 External libLASi library improvements affecting our psttf device
+
+Our psttf device depends on the libLASi library. libLASi-1.1.0 has just been
+released at http://sourceforge.net/svn/?group_id=187113 .  We recommend
+using this latest version of libLASi for building PLplot and the psttf
+device since this version of libLASi is more robust against glyph
+information returned by pango/cairo/fontconfig that on rare occasions is not
+suitable for use by libLASi.
+
+2.10 Improvements to the cairo driver family
+
+Jonathan Woithe improved the xcairo driver so that it can optionally be
+used with an external user supplied X Drawable. This enables a nice
+separation of graphing (PLplot) and window management (Gtk, etc..). Doug
+Hunt fixed the bugs that broke the memcairo driver and it is now fully
+functional. Additionally, a new extcairo driver was added that will plot
+into a user supplied cairo context.
+
+2.11 wxWidgets driver improvements
+
+Complete reorganization of the driver code. A new backend was added, based
+on the wxGraphicsContext class, which is available for wxWidgets 2.8.4
+and later. This backend produces antialiased output similar to the
+AGG backend but has no dependency on the AGG library. The basic wxDC
+backend and the wxGraphicsContext backend process the text output
+on their own, which results in much nicer plots than with the standard
+Hershey fonts and is much faster than using the freetype library. New
+options were introduced in the wxWidgets driver:
+ - backend: Choose backend: (0) standard, (1) using AGG library,
+                            (2) using wxGraphicsContext
+ - hrshsym: Use Hershey symbol set (hrshsym=0|1)
+ - text: Use own text routines (text=0|1)
+ - freetype: Use FreeType library (freetype=0|1)
+The option "text" changed its meaning, since it enabled the FreeType library
+support, while now the option enables the driver's own text routines.
+
+Some other features were added:
+ * the wxWidgets driver now correctly clears the background (or parts of it)
+ * transparency support was added
+ * the "locate mode" (already available in the xwin and tk driver) was
+   implemented, where graphics input events are processed and translated
+   to world coordinates
+
+2.12 pdf driver improvements
+
+The pdf driver (which is based on the haru library http://www.libharu.org)
+processes the text output now on its own. So far only the Adobe Type1
+fonts are supported. TrueType font support will follow. Full unicode
+support will follow after the haru library will support unicode strings. The
+driver is now able to produce A4, letter, A5 and A3 pages. The Hershey font
+may be used only for symbols. Output can now be compressed, resulting in
+much smaller file sizes.
+Added new options:
+ - text: Use own text routines (text=0|1)
+ - compress: Compress pdf output (compress=0|1)
+ - hrshsym: Use Hershey symbol set (hrshsym=0|1)
+ - pagesize: Set page size (pagesize=A4|letter|A3|A5)
+
+2.13 svg driver improvements
+
+This device driver has had the following improvements: schema for generated
+file now validates properly at http://validator.w3.org/ for the
+automatically detected document type of SVG 1.1; -geometry option now works;
+alpha channel transparency has been implemented; file familying for
+multipage examples has been implemented; coordinate scaling has been
+implemented so that full internal PLplot resolution is used; extraneous
+whitespace and line endings that were being injected into text in error have
+now been removed; and differential correction to string justification is now
+applied.
+
+The result of these improvements is that our SVG device now gives the
+best-looking results of all our devices.  However, currently you must be
+careful of which SVG viewer or editor you try because a number of them have
+some bugs that need to be resolved.  For example, there is a librsvg bug in
+text placement (http://bugzilla.gnome.org/show_bug.cgi?id=525023) that
+affects all svg use within GNOME as well as the ImageMagick "display"
+application.  However, at least the latest konqueror and firefox as well as
+inkscape and scribus-ng (but not scribus!) give outstanding looking results
+for files generated by our svg device driver.
+
+2.14 Ada language support
+
+We now have a complete Ada bindings implemented for PLplot. We also have a
+complete set of our standard examples implemented in Ada which give results
+that are identical with corresponding results for the C standard examples.
+This is an excellent test of a large subset of the Ada bindings. We now
+enable Ada by default for our users and request widespread testing of this
+new feature.
+
+2.15 OCaml language support
+
+Thanks primarily to Hezekiah M. Carty's efforts we now have a complete OCaml
+bindings implemented for PLplot. We also have a complete set of our standard
+examples implemented in OCaml which give results that are identical with
+corresponding results for the C standard examples. This is an excellent test
+of a large subset of the OCaml bindings. We now enable OCaml by default for
+our users and request widespread testing of this new feature.
+
+2.16 Perl/PDL language support
+
+Thanks to Doug Hunt's efforts the external Perl/PDL module,
+PDL::Graphics::PLplot version 0.46 available at
+http://search.cpan.org/dist/PDL-Graphics-PLplot has been brought up to date
+to give access to recently added PLplot API.  The instructions for how to
+install this module on top of an official PDL release are given in
+examples/perl/README.perldemos. Doug has also finished implementing a
+complete set of standard examples in Perl/PDL which are part of PLplot and
+which produce identical results to their C counterparts if the above updated
+module has been installed.  Our build system tests the version of
+PDL::Graphics::PLplot that is available, and if it is not 0.46 or later, the
+list of Perl/PDL examples that are run as part of our standard tests is
+substantially reduced to avoid examples that use the new functionality.  In
+sum, if you use PDL::Graphics::PLplot version 0.46 or later the full
+complement of PLplot commands is available to you from Perl/PDL, but
+otherwise not.
+
+2.17 Updates to various language bindings
+
+A concerted effort has been made to bring all the language bindings up to
+date with recently added functions. Ada, C++, f77, f95, Java, OCaml, Octave,
+Perl/PDL, Python, and Tcl now all support the common PLplot API (with the
+exception of the mapping functions which are not yet implemented for all
+bindings due to technical issues.) This is a significant step forward for
+those using languages other than C.
+
+2.18 Updates to various examples
+
+To help test the updates to the language bindings the examples have been
+thoroughly checked. Ada, C, C++, f77, f95, and OCaml now contain a full set
+of non-interactive tests (examples 1-31 excluding 14 and 17). Java, Octave,
+Python and Tcl are missing example 19 because of the issue with the mapping
+functions. The examples have also been checked to ensure consistent results
+between different language bindings. Currently there are still some minor
+differences in the results for the tcl examples, probably due to rounding
+errors.  Some of the Tcl examples (example 21) require Tcl version 8.5 for
+proper support for NaNs.
+
+Also new is an option for the plplot_test.sh script to run the examples
+using a debugging command. This is enabled using the --debug option. The
+default it to use the valgrind memory checker. This has highlighted at
+least one memory leaks in PLplot which have been fixed. It is not part
+of the standard ctest tests because it can be _very_ slow for a complete
+set of language bindings and device drivers.
+
+2.19 Extension of our test framework
+
+The standard test suite for PLplot now carries out a comparison of the
+stdout output (especially important for example 31 which tests most of our
+set and get functions) and PostScript output for different languages as a
+check.  Thanks to the addition of example 31, the inclusion of examples 14
+and 17 in the test suite and other recent extensions of the other
+examples we now have rigorous testing in place for almost the entirety
+of our common API.  This extensive testing framework has already helped
+us track down a number of bugs, and it should make it much easier for us
+to maintain high quality for our ongoing PLplot releases.
+
+2.20 Rename test subdirectory to plplot_test
+
+This change was necessary to quit clashing with the "make test" target which
+now works for the first time ever (by executing ctest).
+
+2.21 Website support files updated
+
+Our new website content is generated with PHP and uses CSS (cascaded style
+sheets) to implement a consistent style.  This new approach demanded lots of
+changes in the website support files that are used to generate and upload
+our website and which are automatically included with the release.
+
+2.22 Internal changes to function visibility
+
+The internal definitions of functions in PLplot have been significantly
+tidied up to allow the use of the -fvisibility=hidden option with newer
+versions of gcc. This prevents internal functions from being exported
+to the user where possible. This extends the existing support for this
+on windows.
+
+2.23 Dynamic driver support in Windows
+
+An interface based on the ltdl library function calls was established
+which allows to open and close dynamic link libraries (DLL) during
+run-time and call functions from these libraries. As a consequence
+drivers can now be compiled into single DLLs separate from the core
+PLplot DLL also in Windows. The cmake option ENABLE_DYNDRIVERS is now
+ON by default for Windows if a shared PLplot library is built.
+
+2.24 Documentation updates
+
+The DocBook documentation has been updated to include many of the
+C-specific functions (for example plAlloc2dGrid) which are not part
+of the common API, but are used in the examples and may be helpful
+for PLplot users.
+
+2.25 libnistcd (a.k.a. libcd) now built internally for -dev cgm
+
+CGM format is a long-established (since 1987) open standard for vector
+graphics that is supported by w3c (see http://www.w3.org/Graphics/WebCGM/).
+PLplot has long had a cgm device driver which depended on the (mostly)
+public domain libcd library that was distributed in the mid 90's by National
+Institute of Standards and Technology (NIST) and which is still available
+from http://www.pa.msu.edu/ftp/pub/unix/cd1.3.tar.gz.  As a convenience
+to our -dev cgm users, we have brought that
+source code in house under lib/nistcd and now build libnistcd routinely
+as part of our ordinary builds.  The only changes we have made to the
+cd1.3 source code is visibility changes in cd.h and swapping the sense of
+the return codes for the test executables so that 0 is returned on success
+and 1 on failure.  If you want to test libnistcd on your platform,
+please run
+
+make test_nistcd
+
+in the top-level build tree.  (That tests runs all the test executables
+that are built as part of cd1.3 and compares the results that are generated
+with the *.cgm files that are supplied as part of cd1.3.)
+
+Two applications that convert and/or display CGM results on Linux are
+ralcgm (which is called by the ImageMagick convert and display applications)
+and uniconvertor.
+
+Some additional work on -dev cgm is required to implement antialiasing and
+non-Hershey fonts, but both those should be possible using libnistcd according
+to the text that is shown by lib/nistcd/cdtext.cgm and lib/nistcd/cdexp1.cgm.
+
+2.26 get-drv-info now changed to test-drv-info
+
+To make cross-building much easier for PLplot we now configure the *.rc
+files that are used to describe our various dynamic devices rather than
+generating the required *.rc files with get-drv-info.  We have changed the
+name of get-drv-info to test-drv-info.  That name is more appropriate
+because that executable has always tested dynamic loading of the driver
+plug-ins as well as generating the *.rc files from the information gleaned
+from that dynamic loading.  Now, we simply run test-drv-info as an option
+(defaults to ON unless cross-building is enabled) and compare the resulting
+*.rc file with the one configured by cmake to be sure the dynamic device
+has been built correctly.
+
+2.27 Text clipping now enabled by default for the cairo devices
+
+When correct text clipping was first implemented for cairo devices, it was
+discovered that the libcairo library of that era (2007-08) did that clipping
+quite inefficiently so text clipping was disabled by default.  Recent tests
+of text clipping for the cairo devices using libcairo 1.6.4 (released in
+2008-04) shows text clipping is quite efficient now.  Therefore, it is now
+enabled by default.  If you notice a significant slowdown for some libcairo
+version prior to 1.6.4 you can use the option -drvopt text_clipping=0 for
+your cairo device plots (and accept the improperly clipped text results that
+might occur with that option).  Better yet, use libcairo 1.6.4 or later.
+
+2.28 A powerful qt device driver has been implemented
+
+Thanks to the efforts of Alban Rochel of the QSAS team, we now have a new qt
+device driver which delivers the following 9 (!) devices: qtwidget, bmpqt,
+jpgqt, pngqt, ppmqt, tiffqt, epsqt, pdfqt, and svgqt. qtwidget is an
+elementary interactive device where, for now, the possible interactions
+consist of resizing the window and right clicking with the mouse (or hitting
+<return> to be consistent with other PLplot interactive devices) to control
+paging.  The qtwidget overall size is expressed in pixels. bmpqt, jpgqt,
+pngqt, ppmqt, and tiffqt are file devices whose overall sizes are specified
+in pixels and whose output is BMP (Windows bitmap), JPEG, PNG, PPM (portable
+pixmap), and TIFF (tagged image file format) formatted files. epsqt, pdfqt,
+svgqt are file devices whose overall sizes are specified in points (1/72 of
+an inch) and whose output is EPS (encapsulated PostScript), PDF, and SVG
+formatted files.  The qt device driver is based on the powerful facilities
+of Qt4 so all qt devices implement variable opacity (alpha channel) effects
+(see example 30).  The qt devices also use system unicode fonts, and deal
+with CTL (complex text layout) languages automatically without any
+intervention required by the user.  (To show this, try qt device results
+from examples 23 [mathematical symbols] and 24 [CTL languages].)
+
+Our exhaustive Linux testing of the qt devices (which consisted of detailed
+comparisons for all our standard examples between qt device results and the
+corresponding cairo device results) indicates this device driver is mature,
+but testing on other platforms is requested to confirm that maturity. Qt-4.5
+(the version we used for most of our tests) has some essential SVG
+functionality so we recommend that version (downloadable from
+http://www.qtsoftware.com/downloads for Linux, Mac OS X, and Windows) for
+svgqt.  One of our developers found that pdfqt was orders of magnitude
+slower than the other qt devices for Qt-4.4.3 on Ubuntu 8.10 installed on a
+64 bit box.  That problem was completely cured by moving to the downloadable
+Qt-4.5 version.  However, we have also had good Qt-4.4.3 pdfqt reports on
+other platforms.  One of our developers also found that all first pages of
+examples were black for just the qtwidget device for Qt-4.5.1 on Mac OS X.
+From the other improvements we see in Qt-4.5.1 relative to Qt-4.4.3 we
+assume this black first page for qtwidget problem also exists for Qt-4.4.3,
+but we haven't tested that combination.
+
+In sum, Qt-4.4.3 is worth trying if it is already installed on your machine,
+but if you run into any difficulty with it please switch to Qt-4.5.x (once
+Qt-4.5.x is installed all you have to do is to put the 4.5.x version of
+qmake in your path, and cmake does the rest).  If the problem persists for
+Qt-4.5, then it is worth reporting a qt bug.
+
+2.29 The PLplot API is now accessible from Qt GUI applications
+
+This important new feature has been implemented by Alban Rochel of the QSAS
+team as a spin-off of the qt device driver project using the extqt device
+(which constitutes the tenth qt device).  See examples/c++/README.qt_example
+for a brief description of a simple Qt example which accesses the PLplot API
+and which is built in the installed examples tree using the pkg-config
+approach. Our build system has been enhanced to configure the necessary
+plplotd-qt.pc file.
+
+2.30 NaN / Inf support for some PLplot functions
+
+Some PLplot now correctly handle Nan or Inf values in the data to be plotted.
+Line plotting (plline etc) and image plotting (plimage, plimagefr) will
+now ignore NaN / Inf values. Currently some of the contour plotting / 3-d
+routines do not handle NaN / Inf values. This functionality will
+depend on whether the language binding used supports NaN / Inf values.
+
+2.31 Various bug fixes
+
+Various bugs in the 5.9.3 release have been fixed including:
+
+- Include missing file needed for the aqt driver on Mac OS X
+- Missing library version number for nistcd
+- Fixes for the qt examples with dynamic drivers disabled
+- Fixes to several tcl examples so they work with plserver
+- Fix pkg-config files to work correctly with Debug / Release build types set
+- Make Fortran command line argument parsing work with shared libraries on Windows
+
+2.32 Cairo driver improvements
+
+Improvements to the cairo driver to give better results for bitmap
+formats when used with anti-aliasing file viewers.
+
+2.33 PyQt changes
+
+Years ago we got a donation of a hand-crafted pyqt3 interface to PLplot
+(some of the functions in plplot_widgetmodule.c in bindings/python) and a
+proof-of-concept example (prova.py and qplplot.py in examples/python), but
+this code did not gain any developer interest and was therefore not
+understood or maintained. Recently one of our core developers has
+implemented a sip-generated pyqt4 interface to PLplot (controlled by
+plplot_pyqt4.sip in bindings/qt_gui/pyqt4) that builds without problems as a
+python extension module, and a good-looking pyqt4 example (pyqt4_example.py
+in examples/python) that works well.  Since this pyqt4 approach is
+maintained by a PLplot developer it appears to have a good future, and we
+have therefore decided to concentrate on pyqt4 and remove the pyqt3 PLplot
+interface and example completely.
+
+2.34 Color Palettes
+
+Support has been added to PLplot for user defined color palette files.
+These files can be loaded at the command line using the -cmap0 or
+-cmap1 commands, or via the API using the plspal0 and plspal1 commands.
+The commands cmap0 / plspal0 are used to load cmap0 type files which
+specify the colors in PLplot's color table 0. The commands cmap1 /
+plspal1 are used to load cmap1 type files which specify PLplot's color
+table 1. Examples of both types of files can be found in either the
+plplot-source/data directory or the PLplot installed directory
+(typically /usr/local/share/plplotx.y.z/ on Linux).
+
+2.35 Reimplementation of a "soft landing" when a bad/missing compiler is
+detected
+
+The PLplot core library is written in C so our CMake-based build system will
+error out if it doesn't detect a working C compiler.  However all other
+compiled languages (Ada, C++, D, Fortran, Java, and OCaml) we support are
+optional.  If a working compiler is not available, we give a "soft landing"
+(give a warning message, disable the optional component, and keep going).
+The old implementation of the soft landing was not applied consistently (C++
+was unnecessarily mandatory before) and also caused problems for ccmake (a
+CLI front-end to the cmake application) and cmake-gui (a CMake GUI front-end
+to the cmake application) which incorrectly dropped languages as a result
+even when there was a working compiler.
+
+We now have completely reimplemented the soft landing logic.  The result
+works well for cmake, ccmake, and cmake-gui.  The one limitation of this new
+method that we are aware of is it only recognizes either the default
+compiler chosen by the generator or else a compiler specified by the
+environment variable approach (see Official Notice XII above).  Once CMake
+bug 9220 has been fixed (so that the OPTIONAL signature of the
+enable_language command actually works without erroring out), then our
+soft-landing approach (which is a workaround for bug 9220) will be replaced
+by the OPTIONAL signature of enable_language, and all CMake methods of
+specifying compilers and compiler options will automatically be recognized
+as a result.
+
+2.36 Make PLplot aware of LC_NUMERIC locale
+
+For POSIX-compliant systems, locale is set globally so any external
+applications or libraries that use the PLplot library or any external
+libraries used by the PLplot library or PLplot device drivers could
+potentially change the LC_NUMERIC locale used by PLplot to anything those
+external applications and libraries choose. The principal consequence of
+such choice is the decimal separator could be a comma (for some locales)
+rather than the period assumed for the "C" locale.  For previous versions of
+PLplot a comma decimal separator would have lead to a large number of
+errors, but this issue is now addressed with a side benefit that our plots
+now have the capability of displaying the comma (e.g., in axis labels) for
+the decimal separator for those locales which require that.
+
+If you are not satisfied with the results for the default PLplot locale set
+by external applications and libraries, then you can now choose the
+LC_NUMERIC locale for PLplot by (a) specifying the new -locale command-line
+option for PLplot (if you do not specify that option, a default loca...
 
[truncated message content]

[Plplot-cvs] SF.net SVN: plplot:[12560] tags

[<ai...@us...>]

Revision: 12560
          http://sourceforge.net/p/plplot/code/12560
Author:   airwin
Date:     2013-09-30 23:24:39 +0000 (Mon, 30 Sep 2013)
Log Message:
-----------
Use correct name for 5.9.10 release tag.

Added Paths:
-----------
    tags/v5_9_10/

Removed Paths:
-------------
    tags/v_5_9_10/

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Plplot-cvs] SF.net SVN: plplot:[12559] tags/v_5_9_10/

[<ai...@us...>]

Revision: 12559
          http://sourceforge.net/p/plplot/code/12559
Author:   airwin
Date:     2013-09-30 23:18:47 +0000 (Mon, 30 Sep 2013)
Log Message:
-----------
Create tag for release 5.9.10

Added Paths:
-----------
    tags/v_5_9_10/

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Plplot-cvs] SF.net SVN: plplot:[12558] trunk/ChangeLog.release

[<ai...@us...>]

Revision: 12558
          http://sourceforge.net/p/plplot/code/12558
Author:   airwin
Date:     2013-09-30 22:58:54 +0000 (Mon, 30 Sep 2013)
Log Message:
-----------
Commit ChangeLog for this release cycle.

Modified Paths:
--------------
    trunk/ChangeLog.release

Modified: trunk/ChangeLog.release
===================================================================
--- trunk/ChangeLog.release	2013-09-30 22:57:22 UTC (rev 12557)
+++ trunk/ChangeLog.release	2013-09-30 22:58:54 UTC (rev 12558)
@@ -1,723 +1,7628 @@
 ------------------------------------------------------------------------
-r11950 | airwin | 2011-10-11 00:07:48 -0400 (Tue, 11 Oct 2011) | 2 lines
+r12557 | airwin | 2013-09-30 15:57:22 -0700 (Mon, 30 Sep 2013) | 2 lines
 Changed paths:
+   M /trunk/README.Release_Manager_Cookbook
+
+This may be the final version of this file for this release.
+
+------------------------------------------------------------------------
+r12556 | airwin | 2013-09-30 14:46:24 -0700 (Mon, 30 Sep 2013) | 2 lines
+Changed paths:
+   M /trunk/cmake/modules/plplot_version.cmake
+
+Bump the release date by one day.
+
+------------------------------------------------------------------------
+r12555 | airwin | 2013-09-30 13:49:54 -0700 (Mon, 30 Sep 2013) | 14 lines
+Changed paths:
+   M /trunk/cmake/modules/docbook.cmake
+   M /trunk/doc/docbook/src/CMakeLists.txt
+
+Fix build-system bug in configuration and installation of
+stylesheet.css for the case where the documentation is prebuilt.
+
+Tested by Alan W. Irwin <ai...@us...> by running
+
+scripts/make_tarball.sh -c -i /tmp/plplot_install
+find /tmp/plplot-dist-prep -name "*.out" |xargs grep -i error
+
+and browsing the resulting documentation that was installed from the
+generated preliminary version of the release tarball in
+/tmp/plplot_install/share/doc/plplot/html while looking carefully
+for stylesheet issues.
+
+
+------------------------------------------------------------------------
+r12554 | airwin | 2013-09-30 00:01:15 -0700 (Mon, 30 Sep 2013) | 8 lines
+Changed paths:
+   M /trunk/scripts/make_tarball.sh
+
+Drop -t and -w options and modify script to create a release tarball
+from the parent directory of wherever the script resides.  Thus, it can
+create preliminary test tarballs from the local copy of svn trunk
+(where this script resides) or a final release tarball from a local
+copy of the appropriate tags release directory (where this script also
+resides).
+
+
+------------------------------------------------------------------------
+r12553 | airwin | 2013-09-29 17:07:44 -0700 (Sun, 29 Sep 2013) | 4 lines
+Changed paths:
+   M /trunk/README.Release_Manager_Cookbook
+
+Interim snapshot commit of the many changes I have made to the release
+process.  However, there is still more edits that will need to be
+made before this is ready for release.
+
+------------------------------------------------------------------------
+r12552 | airwin | 2013-09-29 13:59:14 -0700 (Sun, 29 Sep 2013) | 9 lines
+Changed paths:
+   M /trunk/cmake/build_projects/CMakeLists.txt
+   M /trunk/cmake/build_projects/README
+   M /trunk/cmake/build_projects/docbook-xml/CMakeLists.txt
+   M /trunk/cmake/build_projects/docbook-xml/bp.cmake
+   M /trunk/cmake/build_projects/docbook-xsl/bp.cmake
+   M /trunk/cmake/build_projects/gtk-doc/bp.cmake
+   M /trunk/cmake/build_projects/gtk_packages_add.xml
+   M /trunk/cmake/build_projects/libxml2/bp.cmake
+   M /trunk/cmake/build_projects/patch_gtk_packages.xml
+
+In the interests of committing what I have on my disk to the svn
+repository, commit the current snapshot of build_projects for this
+PLplot release. Note, it has actually been a while since I have been
+working on this subproject so this result should be considered
+experimental and may not even currently work.  But at least
+it preserves a snapshot of my work and will provide a starting
+point for the next time I work on build_projects.
+
+
+------------------------------------------------------------------------
+r12551 | airwin | 2013-09-29 13:54:34 -0700 (Sun, 29 Sep 2013) | 2 lines
+Changed paths:
+   A /trunk/cmake/build_projects/subversion
+   A /trunk/cmake/build_projects/subversion/bp.cmake
+
+Preliminary commit of incomplete subversion build subproject.
+
+------------------------------------------------------------------------
+r12550 | airwin | 2013-09-29 13:53:06 -0700 (Sun, 29 Sep 2013) | 2 lines
+Changed paths:
+   M /trunk/cmake/build_projects/itstool/bp.cmake
+   A /trunk/cmake/build_projects/itstool/itstool-1.2.0-python-location-fixes.patch
+
+Patch itstool with reconfigured autotools-based build system
+
+------------------------------------------------------------------------
+r12549 | airwin | 2013-09-29 13:41:52 -0700 (Sun, 29 Sep 2013) | 2 lines
+Changed paths:
    M /trunk/README.release
 
-Update my valgrind test results.
+Report (good) test results for this release.
 
 ------------------------------------------------------------------------
-r11949 | airwin | 2011-10-11 00:07:01 -0400 (Tue, 11 Oct 2011) | 3 lines
+r12548 | airwin | 2013-09-29 13:41:21 -0700 (Sun, 29 Sep 2013) | 8 lines
 Changed paths:
-   M /trunk/lib/qsastime/qsastime.c
+   M /trunk/examples/CMakeLists.txt
 
-Correctly initialize the index used for the bhunt_search.
-This fix corrects undefined valgrind warnings for example 29.
+Fix rpath issue (couldn't find shapelib) with qt_example for
+traditional build system of installed examples.
 
+Tested by: Alan W. Irwin <ai...@us...> using
+scripts/comprehensive_test.sh for case where shapelib had
+a non-standard location.
+
+
 ------------------------------------------------------------------------
-r11947 | hezekiahcarty | 2011-10-10 10:36:09 -0400 (Mon, 10 Oct 2011) | 1 line
+r12547 | airwin | 2013-09-29 03:21:53 -0700 (Sun, 29 Sep 2013) | 4 lines
 Changed paths:
+   M /trunk/scripts/comprehensive_test.sh
+
+Adjust script so that it can handle version numbers where the major
+number is one numerical digit, the minor number one or more numerical
+digits, and the patch number is one or more numerical digits.
+
+------------------------------------------------------------------------
+r12546 | airwin | 2013-09-29 01:17:29 -0700 (Sun, 29 Sep 2013) | 8 lines
+Changed paths:
+   M /trunk/cmake/modules/plplot_version.cmake
+
+Update release date to 2013-09-29 and version to 5.9.10 in preparation
+for the planned release later today.
+
+Soversion bump for most PLplot libraries in preparation for the
+release because of substantial backwards incompatible API changes
+concerning integer to floating point line width parameters.
+
+
+------------------------------------------------------------------------
+r12545 | airwin | 2013-09-29 00:42:37 -0700 (Sun, 29 Sep 2013) | 8 lines
+Changed paths:
    M /trunk/README.release
 
-Update README.release with further testing results
+Substantial update to reflect all important changes (as revealed by
+the commit messages) since the last release.
+
+Spell check using
+
+aspell check README.release
+
+
 ------------------------------------------------------------------------
-r11946 | hezekiahcarty | 2011-10-10 09:38:01 -0400 (Mon, 10 Oct 2011) | 1 line
+r12544 | airwin | 2013-09-28 10:52:22 -0700 (Sat, 28 Sep 2013) | 4 lines
 Changed paths:
+   M /trunk/bindings/octave/CMakeLists.txt
+
+Only define the check_plplot_octave_def custom target when using the
+matwrapped bindings (which should probably be removed in any case during the
+next release cycle).
+
+------------------------------------------------------------------------
+r12543 | airwin | 2013-09-28 10:50:13 -0700 (Sat, 28 Sep 2013) | 8 lines
+Changed paths:
+   M /trunk/bindings/octave/plplot_octave_def
+
+Regenerate this file (only used for the legacy matwrapped bindings) 
+to make it consistent with the updated #defines in
+bindings/swig-support/plplotcapi.i.  This regeneration is accomplished
+by running the check_plplot_octave_def target and copying the
+comparison file generated in the build tree on top of this source-tree
+file.
+
+
+------------------------------------------------------------------------
+r12542 | airwin | 2013-09-28 10:30:43 -0700 (Sat, 28 Sep 2013) | 2 lines
+Changed paths:
+   M /trunk/bindings/swig-support/CMakeLists.txt
+
+Implement run-time explanatory message for the check_swig_documentation target.
+
+------------------------------------------------------------------------
+r12541 | airwin | 2013-09-28 10:25:21 -0700 (Sat, 28 Sep 2013) | 7 lines
+Changed paths:
+   M /trunk/bindings/f95/plplot_parameters.h
+
+Regenerate this file to make it consistent with the updated #defines
+in bindings/swig-support/plplotcapi.i.  This regeneration is
+accomplished by running the check_f95_parameters target and copying
+the comparison file generated in the build tree on top of this
+source-tree file.
+
+
+------------------------------------------------------------------------
+r12540 | airwin | 2013-09-28 10:18:21 -0700 (Sat, 28 Sep 2013) | 6 lines
+Changed paths:
+   M /trunk/bindings/swig-support/swig_documentation.i
+
+Regenerate this file to make it consistent with the updated
+doc/docbook/src/api.xml.  This regeneration is accomplished by running
+the check_swig_documentation target and copying the comparison file
+generated in the build tree on top of this source-tree file.
+
+
+------------------------------------------------------------------------
+r12539 | airwin | 2013-09-28 09:52:20 -0700 (Sat, 28 Sep 2013) | 2 lines
+Changed paths:
+   M /trunk/bindings/ocaml/CMakeLists.txt
+
+Make check_plplot_h.inc target to check consistency of plplot_h.inc.
+
+------------------------------------------------------------------------
+r12538 | airwin | 2013-09-27 08:53:14 -0700 (Fri, 27 Sep 2013) | 4 lines
+Changed paths:
+   A /trunk/doc/README.doxygen
+
+Initial commit of documentation concerning how to implement,
+configure, build, and test our doxygen form of documentation.
+
+
+------------------------------------------------------------------------
+r12537 | airwin | 2013-09-26 16:28:30 -0700 (Thu, 26 Sep 2013) | 2 lines
+Changed paths:
+   M /trunk/www/credits.php
+
+Update broken or redirected links.
+
+------------------------------------------------------------------------
+r12536 | airwin | 2013-09-26 16:07:02 -0700 (Thu, 26 Sep 2013) | 10 lines
+Changed paths:
+   M /trunk/www/examples.php
+
+Implement a method (used just for example 33 right now) for selecting
+a subset of the pages to display on our website.
+
+Tested by Alan W. Irwin <ai...@us...> by running
+the scripts/generate_website.sh script and looking at the
+website results for each example to make sure all pages
+are displayed except for example 33 where, as expected, the
+correct subset of pages was displayed.
+
+
+------------------------------------------------------------------------
+r12535 | airwin | 2013-09-26 14:59:56 -0700 (Thu, 26 Sep 2013) | 15 lines
+Changed paths:
+   M /trunk/www/examples.php
+
+Add an additional array to demoArray which contains flags to store
+which pages of each example are displayed on the website.  But for
+now this extra array is not used (see ToDo below).
+
+Add an entry in demoArray for example 00
+
+Change demoArray to allow 100 pages for example 33
+
+Drop f77 and Perl/PDL from list of languages whose source code is
+displayed  for each example.
+
+ToDo. Implement using the extra array in demoArray to control which
+pages are displayed on the website.
+
+
+------------------------------------------------------------------------
+r12534 | airwin | 2013-09-26 14:51:35 -0700 (Thu, 26 Sep 2013) | 8 lines
+Changed paths:
+   M /trunk/scripts/htdocs-gen_plot-examples.sh
+
+Drop f77 and Perl/PDL example source code from being copied to website.
+
+Include source code and pngcairo results for x00.
+
+For generated results, allow more than 99 pages.  (N.B. example 33
+currently has 100 pages).
+
+
+------------------------------------------------------------------------
+r12533 | andrewross | 2013-09-26 08:32:18 -0700 (Thu, 26 Sep 2013) | 4 lines
+Changed paths:
+   M /trunk/cmake/modules/wxwidgets.cmake
+
+
+Potential fix for wxWidgets problem on windows.
+
+
+------------------------------------------------------------------------
+r12532 | andrewross | 2013-09-26 08:18:37 -0700 (Thu, 26 Sep 2013) | 5 lines
+Changed paths:
+   M /trunk/examples/ada/x19a.adb
+   M /trunk/examples/ada/xthick19a.adb
+   M /trunk/examples/c/x19c.c
+   M /trunk/examples/c++/x19.cc
+   M /trunk/examples/d/x19d.d
+   M /trunk/examples/f77/x19f.fm4
+   M /trunk/examples/f95/x19f.f90
+   M /trunk/examples/java/x19.java
+   M /trunk/examples/lua/x19.lua
+   M /trunk/examples/ocaml/x19.ml
+   M /trunk/examples/octave/x19c.m
+   M /trunk/examples/perl/x19.pl
+   M /trunk/examples/python/xw19.py
+   M /trunk/examples/tcl/x19.tcl
+
+Fix from Phil Rosenberg for the missing land in example 19, propagated to all languages.
+
+Also, further small fix to f95 example 19 to get the latitude label length right for the case where it is 0. 
+
+
+------------------------------------------------------------------------
+r12531 | andrewross | 2013-09-25 23:44:36 -0700 (Wed, 25 Sep 2013) | 3 lines
+Changed paths:
+   M /trunk/debian/changelog
+   M /trunk/debian/control
+   M /trunk/debian/control.in
+
+Debian packages - bump standards version.
+
+
+------------------------------------------------------------------------
+r12530 | andrewross | 2013-09-25 15:31:44 -0700 (Wed, 25 Sep 2013) | 4 lines
+Changed paths:
+   M /trunk/bindings/d/plplot.d
+   M /trunk/examples/d/x33d.d
+
+Update d bindings for pllegend to allow null arrays.
+Update d example 33 consistent with the C version.
+
+
+------------------------------------------------------------------------
+r12529 | airwin | 2013-09-25 11:07:21 -0700 (Wed, 25 Sep 2013) | 3 lines
+Changed paths:
+   M /trunk/www/corefunctions.php
+
+Make clear distinction between the copyright of the contents and the copyright
+of the design.
+
+------------------------------------------------------------------------
+r12528 | airwin | 2013-09-24 22:44:57 -0700 (Tue, 24 Sep 2013) | 8 lines
+Changed paths:
+   M /trunk/www/corefunctions.php
+
+Update news feed location to be consistent with Allura version
+of SourceForge.
+
+N.B. This change does not deal with the remaining news sidebar issues
+mentioned on list (too many news items, broken rendering of each
+webpage with the sidebar, old version of simplepie software).
+
+
+------------------------------------------------------------------------
+r12527 | jbauck | 2013-09-24 21:34:57 -0700 (Tue, 24 Sep 2013) | 1 line
+Changed paths:
+   M /trunk/doc/docbook/src/ada.xml
+
+Update Ada docs.
+------------------------------------------------------------------------
+r12526 | jbauck | 2013-09-24 19:16:25 -0700 (Tue, 24 Sep 2013) | 1 line
+Changed paths:
+   M /trunk/bindings/ada/plplot_thin.adb
+   M /trunk/bindings/ada/plplot_thin.ads
+   M /trunk/doc/docbook/src/api.xml
+
+Update copyright dates for Ada binding. Fix "redacted" form in docs for plcolorbar.
+------------------------------------------------------------------------
+r12525 | airwin | 2013-09-24 15:21:20 -0700 (Tue, 24 Sep 2013) | 3 lines
+Changed paths:
+   M /trunk/doc/docbook/src/ada.xml
+   M /trunk/doc/docbook/src/deploying.xml
+   M /trunk/doc/docbook/src/drivers.xml
+   M /trunk/doc/docbook/src/intro.xml
+   M /trunk/doc/docbook/src/os_notes.xml
+   M /trunk/doc/docbook/src/perl.xml
+   M /trunk/doc/docbook/src/wish.xml
+
+Fix broken URL's contained inside ulink elements of our DocBook
+documentation.
+
+------------------------------------------------------------------------
+r12524 | airwin | 2013-09-24 09:51:13 -0700 (Tue, 24 Sep 2013) | 4 lines
+Changed paths:
+   M /trunk/www/corefunctions.php
+   M /trunk/www/download.php
+   M /trunk/www/index.php
+
+Fix broken links for the sidebar that occurs for all pages and for the principal
+page and the download page.
+
+
+------------------------------------------------------------------------
+r12523 | jbauck | 2013-09-24 03:27:16 -0700 (Tue, 24 Sep 2013) | 1 line
+Changed paths:
+   M /trunk/bindings/ada/plplot.adb
+   M /trunk/bindings/ada/plplot.ads
+   M /trunk/bindings/ada/plplot_thin.adb
+   M /trunk/bindings/ada/plplot_thin.ads
+   M /trunk/bindings/ada/plplot_traditional.adb
+   M /trunk/bindings/ada/plplot_traditional.ads
+   M /trunk/examples/ada/x16a.adb
+   M /trunk/examples/ada/x33a.adb
+   M /trunk/examples/ada/xthick16a.adb
+   M /trunk/examples/ada/xthick33a.adb
+
+Update Ada bindings and examples 16 and 33 for plcolorbar capability. Also add support for plscmap1_range and plgcmap1_range.
+------------------------------------------------------------------------
+r12522 | airwin | 2013-09-23 22:27:13 -0700 (Mon, 23 Sep 2013) | 2 lines
+Changed paths:
+   M /trunk/www/credits.php
+   M /trunk/www/development.php
+   M /trunk/www/documentation.php.in
+
+Spelling updates generated by aspell check <filename>.
+
+------------------------------------------------------------------------
+r12521 | airwin | 2013-09-23 22:21:15 -0700 (Mon, 23 Sep 2013) | 2 lines
+Changed paths:
+   M /trunk/doc/docbook/src/ada.xml
+   M /trunk/doc/docbook/src/advanced.xml
+   M /trunk/doc/docbook/src/api-c.xml
+   M /trunk/doc/docbook/src/api-compat.xml
+   M /trunk/doc/docbook/src/api.xml
+   M /trunk/doc/docbook/src/bibliography.xml
+   M /trunk/doc/docbook/src/c.xml
+   M /trunk/doc/docbook/src/cplus.xml
+   M /trunk/doc/docbook/src/deploying.xml
+   M /trunk/doc/docbook/src/drivers.xml
+   M /trunk/doc/docbook/src/intro.xml
+   M /trunk/doc/docbook/src/libraries.xml
+   M /trunk/doc/docbook/src/ocaml.xml
+   M /trunk/doc/docbook/src/simple.xml
+   M /trunk/doc/docbook/src/tcl.xml
+   M /trunk/doc/docbook/src/wish.xml
+
+A large number of spelling fixes generated by "aspell check <filename>".
+
+------------------------------------------------------------------------
+r12520 | airwin | 2013-09-23 15:07:57 -0700 (Mon, 23 Sep 2013) | 2 lines
+Changed paths:
+   M /trunk/doc/docbook/bin/api2man.pl.in
+
+Update "AUTHORS" and "SEE ALSO" sections of the generated man pages. 
+
+------------------------------------------------------------------------
+r12519 | airwin | 2013-09-23 14:52:25 -0700 (Mon, 23 Sep 2013) | 3 lines
+Changed paths:
+   M /trunk/cmake/modules/docbook.cmake
+   M /trunk/doc/docbook/src/CMakeLists.txt
+   M /trunk/www/documentation.php.in
+
+Disable generation of DVI form of documentation and drop references to
+it on the generated website.
+
+------------------------------------------------------------------------
+r12518 | airwin | 2013-09-23 12:30:11 -0700 (Mon, 23 Sep 2013) | 8 lines
+Changed paths:
    M /trunk/README.release
 
-Update README.release with more information on the OCaml bindings
+Add sections describing work on plcolorbar and the pllegend and plcolorbar
+documentation.
+
+Reword the section describing the width changes.
+
+colour ==> color.
+
+
 ------------------------------------------------------------------------
-r11945 | hezekiahcarty | 2011-10-10 09:37:55 -0400 (Mon, 10 Oct 2011) | 1 line
+r12517 | airwin | 2013-09-23 12:22:13 -0700 (Mon, 23 Sep 2013) | 2 lines
 Changed paths:
-   M /trunk/cmake/modules/ocaml.cmake
+   M /trunk/doc/docbook/src/advanced.xml
 
-Re-enable the OCaml bindings by default
+colour ==> color.
+
 ------------------------------------------------------------------------
-r11944 | airwin | 2011-10-10 01:47:24 -0400 (Mon, 10 Oct 2011) | 2 lines
+r12516 | airwin | 2013-09-23 11:24:27 -0700 (Mon, 23 Sep 2013) | 3 lines
 Changed paths:
+   M /trunk/doc/docbook/src/advanced.xml
+
+Add section in advanced.xml concerning the pllegend and plcolorbar
+capabilities.
+
+------------------------------------------------------------------------
+r12515 | arjenmarkus | 2013-09-22 03:01:44 -0700 (Sun, 22 Sep 2013) | 1 line
+Changed paths:
    M /trunk/README.release
 
-Update status of OCaml testing.
+Changed the general reference to the Wiki to the specific page regarding Cygwin.
+------------------------------------------------------------------------
+r12514 | airwin | 2013-09-21 22:46:07 -0700 (Sat, 21 Sep 2013) | 5 lines
+Changed paths:
+   M /trunk/src/pllegend.c
 
+Implement sanity check that plcolorbar caller does not specify NULL
+array pointers for one of the label_opts or labels arrays when
+n_labels > 0.
+
+
 ------------------------------------------------------------------------
-r11943 | airwin | 2011-10-09 17:53:58 -0400 (Sun, 09 Oct 2011) | 10 lines
+r12513 | airwin | 2013-09-21 19:20:12 -0700 (Sat, 21 Sep 2013) | 2 lines
 Changed paths:
+   M /trunk/drivers/cairo.c
+
+Style a previous commit.
+
+------------------------------------------------------------------------
+r12512 | airwin | 2013-09-21 19:19:29 -0700 (Sat, 21 Sep 2013) | 2 lines
+Changed paths:
+   M /trunk/bindings/d/plplot.d
+   M /trunk/examples/d/x16d.d
+
+Style a previous commit.
+
+------------------------------------------------------------------------
+r12511 | airwin | 2013-09-21 19:17:11 -0700 (Sat, 21 Sep 2013) | 6 lines
+Changed paths:
+   M /trunk/src/pllegend.c
+
+Implement sanity check that pllegend caller does not specify NULL
+array pointers for one of the box, line, or symbol arrays when
+opt_array contains the relevant bit which would force the array to be
+used.
+
+
+------------------------------------------------------------------------
+r12510 | airwin | 2013-09-21 14:19:22 -0700 (Sat, 21 Sep 2013) | 2 lines
+Changed paths:
    M /trunk/README.release
 
-Reorganize in preparation for the forthcoming 5.9.9 release including removal
-of all the remarks about changes relative to the 5.9.7 release, official
-notices concerning the broken build fixes for Windows, and the disabling
-of ocaml by default.  Also add detailed listing of all the testing done
-for this release.
+Note added concerning recent breakthroughs for the Cygwin platform.
 
-Spell check.
+------------------------------------------------------------------------
+r12509 | airwin | 2013-09-18 12:12:42 -0700 (Wed, 18 Sep 2013) | 4 lines
+Changed paths:
+   M /trunk/src/plctrl.c
 
+In doxygen documentation of plcol1, use the correct (col1 rather than
+icol1) parameter name.
 
 
 ------------------------------------------------------------------------
-r11942 | airwin | 2011-10-09 15:58:44 -0400 (Sun, 09 Oct 2011) | 5 lines
+r12508 | airwin | 2013-09-18 11:51:03 -0700 (Wed, 18 Sep 2013) | 5 lines
 Changed paths:
-   M /trunk/cmake/modules/ocaml.cmake
+   M /trunk/src/pdfutils.c
+   M /trunk/src/plargs.c
+   M /trunk/src/plot3d.c
 
-Disable OCaml by default for this forthcoming release because of the
-segfault issue and other mememory management issues that I have
-spotted with valgrind.
+Update doxygen documentation of PL_UNUSED function parameters to
+eliminate doxygen warning messages concerning such parameters and to
+produce reasonable looking doxygen results for those parameters.
 
 
 ------------------------------------------------------------------------
-r11941 | airwin | 2011-10-08 19:31:57 -0400 (Sat, 08 Oct 2011) | 6 lines
+r12507 | airwin | 2013-09-18 00:26:10 -0700 (Wed, 18 Sep 2013) | 5 lines
 Changed paths:
-   M /trunk/cmake/modules/ocaml.cmake
+   M /trunk/doc/docbook/src/api.xml
+   M /trunk/doc/docbook/src/plplotdoc.xml.in
 
-Disable OCaml by default for static build until rpath issues are
-straightened out.  Note, there is now a new option available called
-ENABLE_ocaml_static which defaults to OFF, but if you set it to ON
-you will get a build of OCaml for that static case.
+Update API documentation of pllegend and plcolorbar consistent with
+the corresponding doxygen documentation of the same functions.  I plan
+no further changes in this API documentation at the present time.
 
 
 ------------------------------------------------------------------------
-r11940 | arjenmarkus | 2011-10-07 03:20:10 -0400 (Fri, 07 Oct 2011) | 3 lines
+r12506 | airwin | 2013-09-18 00:23:49 -0700 (Wed, 18 Sep 2013) | 5 lines
 Changed paths:
-   M /trunk/bindings/f77/plplotf77_ifort.def
-   M /trunk/bindings/f77/plplotf77_mingw.def
-   M /trunk/bindings/f77/plstubs.h
+   M /trunk/src/pllegend.c
 
-Correct a typo in the export definitions for Intel Fortran. Add a missing entry (plsettransform).
-With these changes PLplot is built smoothly for the combination MSVC/C++ (9.0) and Intel Fortran (11.1)
+Update doxgyen documentation of pllegend and plcolorbar and associated
+internal functions.  I plan no further changes in this documentation
+at the present time.
 
+
 ------------------------------------------------------------------------
-r11939 | arjenmarkus | 2011-10-07 03:00:30 -0400 (Fri, 07 Oct 2011) | 1 line
+r12505 | jbauck | 2013-09-12 21:19:42 -0700 (Thu, 12 Sep 2013) | 1 line
 Changed paths:
+   M /trunk/bindings/ada/plplot.adb
+
+Test. Ignore.
+------------------------------------------------------------------------
+r12504 | andrewross | 2013-09-09 15:32:36 -0700 (Mon, 09 Sep 2013) | 6 lines
+Changed paths:
+   M /trunk/drivers/cairo.c
+
+
+Modify xcairo driver to honour the -display option to set the display. 
+
+Also exit if opening the display fails since continuing will lead to a crash anyway.
+
+
+------------------------------------------------------------------------
+r12503 | andrewross | 2013-09-09 07:41:12 -0700 (Mon, 09 Sep 2013) | 5 lines
+Changed paths:
+   M /trunk/bindings/d/plplot.d
+   M /trunk/examples/d/x16d.d
+
+Update D bindings for latest version of plcolorbar. Also add plscmap1_range and plgcmap1_range. 
+
+Update example 16 to use plcolorbar as in the C version.
+
+
+------------------------------------------------------------------------
+r12502 | arjenmarkus | 2013-09-07 01:29:45 -0700 (Sat, 07 Sep 2013) | 3 lines
+Changed paths:
+   M /trunk/cmake/modules/cairo.cmake
+   M /trunk/drivers/cairo.c
+
+Rearrange the order of including header files to avoid a conflict between the Windows header and the X11 header - the latter defines the macro Status which the first uses as an argument name.
+
+Furthermore, because of the routine cairo_win32_surface_create is missing from the cairo library, we can not build the wincairo device. For now this is turned off under Cygwin.
+------------------------------------------------------------------------
+r12501 | airwin | 2013-08-30 12:13:41 -0700 (Fri, 30 Aug 2013) | 21 lines
+Changed paths:
+   M /trunk/doc/docbook/src/CMakeLists.txt
+
+CMake code fixups.
+
+Move creation of jadetex.cfg from a place that is always executed
+to the appropriate Boolean block.
+
+Do not remove info directory that is initially created at cmake time.
+This solves a bug when the info target is reinvoked at make time after
+a change to the docbook source.
+
+Specifically ignore environment variable DESTDIR when xmlto --with-fop
+is invoked.  This works around a bug in xmlto which (on Debian at
+least) craps out when DESTDIR is specified.
+
+Tested by: Alan W. Irwin <ai...@us...> using the
+-DBUILD_DOC=ON -DBUILD_DOX_DOC=ON cmake options and the install
+target invoked in the following ways:
+
+make -j4 install
+make DESTDIR=whatever -j4 install
+
+
+------------------------------------------------------------------------
+r12500 | airwin | 2013-08-30 09:41:29 -0700 (Fri, 30 Aug 2013) | 7 lines
+Changed paths:
+   M /trunk/doc/docbook/src/CMakeLists.txt
+
+install(CODE ... changes.
+
+Attempt to deal with issues found recently by Orion Poplawski on Fedora.
+Suppress warnings about setting policy and change from undocumented to
+documented form of the file(INSTALL ... signature.
+
+
+------------------------------------------------------------------------
+r12499 | airwin | 2013-08-27 18:05:27 -0700 (Tue, 27 Aug 2013) | 3 lines
+Changed paths:
    M /trunk/src/pllegend.c
 
-Change max_opts into a preprocessor macro, because MS Visual C/C++ does not like "automatic" arrays.
+Systematic commentary (including special doxygen commentary) changes
+to replace the word "colorbar" by "color bar". 
+
 ------------------------------------------------------------------------
-r11938 | airwin | 2011-10-06 14:13:58 -0400 (Thu, 06 Oct 2011) | 22 lines
+r12498 | airwin | 2013-08-27 16:03:51 -0700 (Tue, 27 Aug 2013) | 8 lines
 Changed paths:
-   M /trunk/include/ltdl_win32.h
-   M /trunk/src/ltdl_win32.c
+   M /trunk/src/pllegend.c
 
-Fix for Windows broken build for the 5.9.8 release.  This fix supplies
-a needed lt_dlmakeresident routine for ltdl_win32.c so that dynamic
-devices can be built on Windows.  Currently, this version of
-lt_dlmakeresident does nothing but return success.  The net result is
-that on Windows plend will unload all libraries that our dynamic
-devices depend on just like what happened for 5.9.7.
+Add doxygen documentation of plcolorbar arguments that were previously
+undocumented.  This change should finalize the plcolorbar API
+documentation in preparation for copying it to the DocBook API
+chapter.  In addition, this change and a few other minor doxygen
+changes eliminated the last of the argument inconsistency warnings
+previously generated for pllegend.c by doxygen.
 
-Note that for Linux we found that if we did not call the
-lt_dlmakeresident version for libltdl, that calls to plend (which in
-turn call lt_dlexit()) unloaded the external libraries that are
-depended on by our dynamic devices.  That library unloading sometimes
-lead to exit handler errors for those libraries on Linux.  
 
-In the future if library unloading also leads to issues for Windows,
-we will need to add real functionality to the lt_dlmakeresident
-function in ltdl_win32.c to also avoid unloading the libraries in that
-case.  However, we have no reports of such library unloading
-issues on Windows so a lt_dlmakeresident version for ltdl_win32.h that
-does nothing other than return success is all we appear to need at
-the present time.
+------------------------------------------------------------------------
+r12497 | airwin | 2013-08-24 15:39:23 -0700 (Sat, 24 Aug 2013) | 4 lines
+Changed paths:
+   M /trunk/doc/docbook/README.developers
 
+Update these developer directions based on the current xmlto backend
+tools that are being used.  Also include some plans about further
+changes once we allow UTF-8 strings in our documentation.
 
 ------------------------------------------------------------------------
-r11936 | airwin | 2011-09-25 12:40:30 -0400 (Sun, 25 Sep 2011) | 5 lines
+r12496 | airwin | 2013-08-24 15:36:57 -0700 (Sat, 24 Aug 2013) | 5 lines
 Changed paths:
-   M /trunk/src/plcore.c
+   M /trunk/doc/docbook/NEWS
 
-Allow plend to completely remove certain of our device drivers that do
-not depend on any libraries other than libplplotd.  This change restores clean
-valgrind results for, e.g.,  -dev svg and -dev psc.
+Substantial update (including some history that has not been mentioned
+before as well as recent events) of news for PLplot's documentation
+project.
 
 
 ------------------------------------------------------------------------
-r11935 | airwin | 2011-09-25 12:09:38 -0400 (Sun, 25 Sep 2011) | 2 lines
+r12495 | airwin | 2013-08-23 22:34:58 -0700 (Fri, 23 Aug 2013) | 10 lines
 Changed paths:
-   M /trunk/bindings/c++/plstream.cc
-   M /trunk/bindings/qt_gui/plqt.cpp
-   M /trunk/drivers/ps.c
-   M /trunk/drivers/qt.cpp
-   M /trunk/drivers/wxwidgets_gc.cpp
-   M /trunk/examples/c/x27c.c
-   M /trunk/examples/c++/x27.cc
-   M /trunk/examples/d/x27d.d
-   M /trunk/examples/java/x27.java
-   M /trunk/include/qt.h
-   M /trunk/src/plarc.c
-   M /trunk/src/plctrl.c
-   M /trunk/utils/plrender.c
+   M /trunk/cmake/modules/docbook.cmake
+   M /trunk/doc/docbook/src/CMakeLists.txt
+   D /trunk/doc/docbook/src/inline-print.ent
+   A /trunk/doc/docbook/src/inline-print_dsl.ent (from /trunk/doc/docbook/src/inline-print.ent:12492)
+   A /trunk/doc/docbook/src/inline-print_xsl.ent
 
-Style previous changes.
+For default -DDOCBOOK_XML_BACKEND=ON case, implement a dvi build.
 
+N.B. This dvi build only works if the patch given at
+http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=720624 is applied
+to /usr/share/pyshared/dbtexmf/dblatex/unient.py to fix a bug
+in the dblatex package.
+
+Use different inline-print_???.ent files depending on whether
+-DDOCBOOK_XML_BACKEND=ON or OFF.
+
 ------------------------------------------------------------------------
-r11934 | hezekiahcarty | 2011-09-23 09:34:31 -0400 (Fri, 23 Sep 2011) | 1 line
+r12494 | airwin | 2013-08-21 15:10:51 -0700 (Wed, 21 Aug 2013) | 7 lines
 Changed paths:
-   M /trunk/cmake/modules/ocaml.cmake
+   M /trunk/doc/docbook/src/CMakeLists.txt
+   A /trunk/doc/docbook/src/plplotdoc-print.xsl.in
 
-Re-enable OCaml by default now that the interface has been fixed
+Implement XSL configuration method for print results for the default
+-DDOCBOOK_XML_BACKEND=ON case.  Use this configuration method to
+establish ansi style for funcsynopsis for pdf and ps results.
+
+Tested by Alan W. Irwin <ai...@us...> using
+the -DBUILD_DOC=ON cmake option and the pdf_target target.
+
 ------------------------------------------------------------------------
-r11933 | hezekiahcarty | 2011-09-23 09:34:23 -0400 (Fri, 23 Sep 2011) | 6 lines
+r12493 | airwin | 2013-08-21 14:18:36 -0700 (Wed, 21 Aug 2013) | 23 lines
 Changed paths:
-   M /trunk/bindings/ocaml/plplot.mli
+   M /trunk/doc/docbook/src/plplotdoc-html.xsl.in
+   M /trunk/doc/docbook/src/stylesheet.css.xsl.in
 
-Some OCaml interface cleanup
+Change funcsynopsis style to ansi and configure widths of the
+resulting html table to auto (which gives nice looking spacing for the
+arguments).  These changes make the new XML/XSL backend tools produce
+the html form of the API chapter with a style comparable to what was
+produced with the deprecated SGML/DSSSL backend tools.
 
-The old image_colorbar and shade_colorbar implementations no longer exist
-and the interface definitions are shadowed by the new definitions.  This
-patch removes the old definitions for cleanliness and to avoid breaking
-compilation on older versions of OCaml.
+Make some progress toward the goal of representing the overlined "S" and
+underlined "freq" in S(freq) correctly represented in html.  However,
+the final step of inserting the correct form of html needs additional
+XSLT expertise that I currently don't have as mentioned in the
+/plplotdoc-html.xsl.in comments.  So the result validates
+fine but is currently rendered as a blank.
+
+So aside from this one overline/underline issue (which appears just
+before the Table of Greek letters), the complete html
+results for the new XML/XSL backend tools are better (Table of Greek
+letters) or similar (API chapter) to what they were before for the
+deprecated SGML/DSSSL backend tools.
+
+Tested by Alan W. Irwin <ai...@us...> using
+the -DBUILD_DOC=ON cmake option and the "html" target.
+
+
 ------------------------------------------------------------------------
-r11932 | airwin | 2011-09-23 00:52:23 -0400 (Fri, 23 Sep 2011) | 3 lines
+r12492 | airwin | 2013-08-20 12:10:05 -0700 (Tue, 20 Aug 2013) | 12 lines
 Changed paths:
-   M /trunk/cmake/modules/ocaml.cmake
+   M /trunk/doc/docbook/src/CMakeLists.txt
+   M /trunk/doc/docbook/src/plplotdoc-html.xsl.in
+   D /trunk/doc/docbook/src/stylesheet.css
+   A /trunk/doc/docbook/src/stylesheet.css.dsssl.in (from /trunk/doc/docbook/src/stylesheet.css:12482)
+   A /trunk/doc/docbook/src/stylesheet.css.xsl.in
 
-Fresh checkout of ocaml is broken so disable it by default until Hez
-gets a chance to fix it.
+Make stylesheet.css configurable with a separate template file for
+the -DDOCBOOK_XML_BACKEND=OFF and (default) -DDOCBOOK_XML_BACKEND=ON
+cases.  The -DDOCBOOK_XML_BACKEND=OFF case is untested but should work
+since the changes are pretty trivial.  The -DDOCBOOK_XML_BACKEND=ON
+case has been tested and shows the desired coloured output for
+the TABLE.funcprototype-table and .variablelist parts of the
+api documentation that occurs in the many links from the API chapter.
 
+Tested by Alan W. Irwin <ai...@us...> using the
+scripts/generate_website.sh scripts.
+
+
 ------------------------------------------------------------------------
-r11928 | andrewross | 2011-09-16 14:01:56 -0400 (Fri, 16 Sep 2011) | 3 lines
+r12491 | airwin | 2013-08-20 10:16:26 -0700 (Tue, 20 Aug 2013) | 8 lines
 Changed paths:
-   M /trunk/doc/docbook/bin/get-library-structs.pl
-   M /trunk/doc/docbook/bin/get-library-symbols.pl
+   M /trunk/doc/docbook/src/CMakeLists.txt
+   A /trunk/doc/docbook/src/plplotdoc-html.xsl.in
 
-Correct spelling mistake in license.
+Initial XSL customization of docbook html backend output following
+ideas in http://www.sagehill.net/docbookxsl.
 
+The meaningful (rather than numerical) HTML chunk filenames are now
+(quietly) formed from the DocBook id using the chunk.quietly and
+use.id.as.filename parameters.
 
+
 ------------------------------------------------------------------------
-r11927 | andrewross | 2011-09-15 10:55:03 -0400 (Thu, 15 Sep 2011) | 5 lines
+r12490 | airwin | 2013-08-19 19:41:28 -0700 (Mon, 19 Aug 2013) | 15 lines
 Changed paths:
-   M /trunk/src/plfill.c
+   M /trunk/cmake/modules/docbook.cmake
+   M /trunk/doc/docbook/src/CMakeLists.txt
 
-When checking if start / end points of polygon to fill are the same, then check the 
-coordinates after translating into PLplot internal integer format. Prevents spurious 
-postscript file differences due to floating point rounding errors in example 27. 
+Generate (by default) our html, pdf, and ps results from our DocBook
+source using XML/XSLT backend tools (i.e., the xmlto script).
 
+Tested by Alan W. Irwin <ai...@us...> using (1) the
+-DBUILD_DOC=ON cmake option and the install target in doc/docbook/src,
+and (2) using scripts/generate_website.sh (which includes using the
+-DBUILD_DOC=ON cmake option and the prebuild_dist www-install-base,
+and www-install targets, but which does not test the -DPREBUILT_DOC=ON
+case).
 
+ToDo: (1) xmlto does not work correctly to generate dvi results so must explore
+other alternatives for that case. (2) Must explore XSLT opportunities to
+style present results since the current default style is bland.
+
+
 ------------------------------------------------------------------------
-r11925 | airwin | 2011-09-14 21:17:51 -0400 (Wed, 14 Sep 2011) | 5 lines
+r12489 | airwin | 2013-08-19 14:55:31 -0700 (Mon, 19 Aug 2013) | 3 lines
 Changed paths:
+   M /trunk/www/documentation.php.in
+
+Reorder so that doxygen-generated documentation is last in the list on
+our website.
+
+------------------------------------------------------------------------
+r12488 | airwin | 2013-08-19 13:42:06 -0700 (Mon, 19 Aug 2013) | 13 lines
+Changed paths:
+   M /trunk/cmake/modules/docbook.cmake
+   M /trunk/doc/docbook/src/CMakeLists.txt
+
+Implement BUILD_DVI variable in anticipation of the case where
+the dvi build of documentation may not be implemented (for the future
+XML backend case).
+
+Improve build system logic for the case where a component
+of the documentatin build is missing.
+
+Improve build system logic for install of info, man, and html
+documentation files so that there is exact consistency between
+what is in the manifest files and what is installed that than
+relying on file(GLOB...
+
+
+------------------------------------------------------------------------
+r12487 | airwin | 2013-08-19 11:37:30 -0700 (Mon, 19 Aug 2013) | 10 lines
+Changed paths:
+   M /trunk/cmake/modules/docbook.cmake
+   M /trunk/doc/docbook/src/CMakeLists.txt
+
+More changes to improve (i.e., make less obfuscated/more modular) the
+build system for the documentation in preparation for implementing XML
+backend tools.
+
+Tested by Alan W. Irwin <ai...@us...> using
+scripts/generate_website.sh (which includes using the -DBUILD_DOC=ON
+cmake option and the prebuild_dist www-install-base, and www-install
+targets, but which does not test the -DPREBUILT_DOC=ON case).
+
+
+------------------------------------------------------------------------
+r12486 | airwin | 2013-08-17 22:56:52 -0700 (Sat, 17 Aug 2013) | 29 lines
+Changed paths:
+   M /trunk/doc/docbook/src/CMakeLists.txt
+   M /trunk/doc/docbook/src/plplotdoc.xml.in
+
+Improve CMake logic for building DocBook documentation.
+
+Replace destroying and creating the inline.ent symlink idea for
+various forms of the inline entities with properly configured info,
+print, and html variants of plplotdoc-?.xml. This change removes the
+dependencies of the various backend documentation between each other
+since there is no longer the parallel build race condition to be
+avoided for the various kinds of inline.ent symlinks.
+
+Non-configured *.xml and *.ent files are referred to directly in the
+source tree rather than as symlinks in the build tree.  This makes
+establishing file dependencies much more straightforward.
+
+Drop if(PERL_FOUND) logic since that is redundant.  (Earlier in build
+process, BUILD_DOC is set to OFF if perl cannot be found.)
+
+Use actual Linux filesystem commands (like mv) rather than relying on
+FindUnixCommands.cmake to define the ${MV} equivalent of mv.  (ToDo,
+replace Linux filesystem commmands used for the documentation build
+such as "mv" with their cmake -E equivalents just on general
+principles.)
+
+Use slightly improved naming conventions for intermediate files created by info
+target.
+
+Tested by Alan W. Irwin <ai...@us...> using the
+-DBUILD_DOC cmake option and the "all" target in doc/docbook/src.
+
+
+------------------------------------------------------------------------
+r12485 | airwin | 2013-08-16 12:36:39 -0700 (Fri, 16 Aug 2013) | 4 lines
+Changed paths:
+   M /trunk/cmake/modules/docbook.cmake
+
+If perl cannot be found, then do not allow a build of the docbook
+documentation since all backends for that build require perl.
+
+
+------------------------------------------------------------------------
+r12484 | airwin | 2013-08-16 11:02:59 -0700 (Fri, 16 Aug 2013) | 7 lines
+Changed paths:
+   M /trunk/cmake/modules/docbook.cmake
+
+Reorganize CMake logic in preparation for implementing
+DOCBOOK_XML_BACKEND option.
+
+Tested by Alan W. Irwin <ai...@us...> using
+-DBUILD_DOC=ON cmake option and clean followed by all target in doc/docbook/src.
+
+
+------------------------------------------------------------------------
+r12483 | airwin | 2013-08-14 13:58:11 -0700 (Wed, 14 Aug 2013) | 12 lines
+Changed paths:
+   M /trunk/doc/docbook/bin/info-clean.pl
+   M /trunk/doc/docbook/src/CMakeLists.txt
+   M /trunk/doc/docbook/src/inline-info.ent
+
+Generate info form of documentation using utf-8 encoding rather than 
+us-ascii encoding.
+
+This change means we don't have to replace the entities defined in
+math.ent by their written out (in ascii) equivalents for the info
+case, and Table 3-4 looks correct (for the first time ever) in the generated
+info form of our documentation.
+
+Tested by: Alan W. Irwin <ai...@us...> using the
+cmake -DBUILD_DOC=ON option and the "info" target.
+
+
+------------------------------------------------------------------------
+r12482 | airwin | 2013-08-13 04:40:19 -0700 (Tue, 13 Aug 2013) | 20 lines
+Changed paths:
+   M /trunk/doc/docbook/bin/api2man.pl.in
+   M /trunk/doc/docbook/bin/api2swigdoc.pl
+   M /trunk/doc/docbook/bin/api2text.pl
+   M /trunk/doc/docbook/bin/info-clean.pl
+
+Remove fake system identifiers imposed by the perl scripts that parse
+our DocBook XML source documentation.
+
+Those identifiers were required before to work around the issue that
+our source documentation incorrectly did not have a system identifier.
+That has now been rectified with revision 12481 so the fake system
+identifiers imposed by the perl scripts are no longer needed, and, in
+fact, they must be removed because they conflict with the real system
+identifier
+
+"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
+
+which is now configured into plplotdoc.xml(.in) so that
+xmllint validation produces a good result.
+
+Tested by Alan W. Irwin <ai...@us...> using the
+cmake options -DBUILD_TEST=ON -DBUILD_DOC=ON and with the targets
+check_swig_documentation, make_documentation, and all.
+
+
+------------------------------------------------------------------------
+r12481 | airwin | 2013-08-12 16:11:08 -0700 (Mon, 12 Aug 2013) | 13 lines
+Changed paths:
+   M /trunk/cmake/modules/docbook.cmake
+   M /trunk/doc/docbook/src/advanced.xml
+   M /trunk/doc/docbook/src/plplotdoc.xml.in
+
+Change DocBook configuration and source files so that
+
+xmllint --noout --nonet --xinclude --postvalid --noent plplotdoc.xml
+
+validates without errors.  
+
+It appears this validation command (also used by the xmlto script) is
+more sensitive to DocBook XML issues than the onsgmls validator which
+we currently use to validate our DocBook source.  For example, before
+and after the current changes our validate target showed no validation
+issues.
+
+
+------------------------------------------------------------------------
+r12480 | airwin | 2013-08-12 15:59:06 -0700 (Mon, 12 Aug 2013) | 3 lines
+Changed paths:
+   M /trunk/scripts/style_source.sh
+
+The *.h.cmake glob fails now since all of those have been renamed as
+*.h.in.  So remove that glob from the list of C sources to style.
+
+------------------------------------------------------------------------
+r12479 | airwin | 2013-08-09 16:38:29 -0700 (Fri, 09 Aug 2013) | 22 lines
+Changed paths:
+   M /trunk/doc/docbook/src/CMakeLists.txt
+
+Remove \$ENV{DESTDIR} references from install(CODE...) commands and
+also reformat those commands to make them more human-readable.
+
+Note, these are all examples of where file(INSTALL...) is used inside
+install(CODE...).  According to the documentation file(INSTALL...) is
+the workhorse signature normall used for install commands so it is
+reasonable to infer that file(INSTALL...) already does its own
+\$ENV{DESTDIR} handling.  Anyhow, it turns out our own use of
+\$ENV{DESTDIR} is redundant and causes an error (double use of DESTDIR
+for the docbook documentation) found by Orion Poplawski and which I
+have confirmed.  Note, for all other uses of install(CODE...) that
+does not have a call to file(INSTALL...) inside the code fragment
+(e.g., doc/CMakeLists.txt) it is necessary to use \$ENV{DESTDIR}.
+
+Tested by Alan W. Irwin <ai...@us...> using the
+cmake options -DCMAKE_INSTALL_PREFIX=/usr -DBUILD_DOC=ON -DBUILD_DOX_DOC=ON
+and "make -j4 DESTDIR=tmp install >& install.out".  The
+resulting files (including both doxgen-generated ones and
+docbook-generated ones) were all installed to tmp/usr/... in the build_tree
+with no double use of DESTDIR and no attempt to install files to /usr.
+
+
+------------------------------------------------------------------------
+r12478 | airwin | 2013-08-09 15:40:34 -0700 (Fri, 09 Aug 2013) | 6 lines
+Changed paths:
+   M /trunk/doc/Doxyfile.in
+
+Exclude bindings/python/plplot.py (the user-friendly python interface
+to PLplot) from doxygen consideration.  For an unknown reason, that
+file (which includes no specific doxygen commands) generates a doxgyen
+segfault.
+
+
+------------------------------------------------------------------------
+r12477 | airwin | 2013-08-09 14:41:36 -0700 (Fri, 09 Aug 2013) | 9 lines
+Changed paths:
+   M /trunk/doc/Doxyfile.in
+
+Update from Doxyfile 1.7.1 to Doxyfile 1.8.1.2 using the "doxygen -u"
+command.
+
+Note, this update of the configuration file to be consistent with my
+doxygen version did not get rid of a segfault that has been introduced
+by some fairly recent change (either in my doxygen version or in our
+code).
+
+
+------------------------------------------------------------------------
+r12476 | airwin | 2013-08-09 09:48:32 -0700 (Fri, 09 Aug 2013) | 6 lines
+Changed paths:
+   M /trunk/bindings/tcl/tclAPI.c
+
+Style.  This is actually a fairly intrusive change but running the
+test_diff_psc target shows Tcl continues to give the same results as
+previous.
+Tested by Alan W. Irwin <ai...@us...>.
+
+
+------------------------------------------------------------------------
+r12475 | airwin | 2013-08-09 09:21:45 -0700 (Fri, 09 Aug 2013) | 4 lines
+Changed paths:
+   M /trunk/drivers/wxwidgets_dc.cpp
+
+Use correct API for DrawPolygon.  Thanks to Joost Kuckartz for
+spotting this error, and he reports this fix solves an offset issue he
+had with wxwidgets plots.
+
+------------------------------------------------------------------------
+r12474 | airwin | 2013-08-04 11:13:16 -0700 (Sun, 04 Aug 2013) | 10 lines
+Changed paths:
+   M /trunk/cmake/build_projects/patch_gtk_packages.xml
+
+Implement changes to gtk-doc build configuration generation.
+
+Use '--with-xml-catalog=${BP_CMAKE_INSTALL_PREFIX}/etc/xml/catalog' as
+a configure option.
+
+Add docbook-xml and docbook-xsl dependencies.
+
+The updated gtk-doc/bp.cmake file that is generated by this change
+to this patch file has already been committed.
+
+------------------------------------------------------------------------
+r12473 | airwin | 2013-08-04 11:04:25 -0700 (Sun, 04 Aug 2013) | 4 lines
+Changed paths:
+   M /trunk/cmake/build_projects/gtk-doc/bp.cmake
+
+Shift from partially hand-crafted (minor edits after generation) to
+completely generated.  The only change between the two is
+gtk-doc_dependencies_LIST is now alphabetized.
+
+------------------------------------------------------------------------
+r12472 | airwin | 2013-08-04 10:54:28 -0700 (Sun, 04 Aug 2013) | 7 lines
+Changed paths:
+   M /trunk/cmake/build_projects/gtk-doc/bp.cmake
+
+Insert boiler-plate warning into generated */bp.cmake files that those
+files are generated.
+
+Implement use of extra_ignored_dependencies_list (which allows
+platforms to selectively ignore certain dependencies).
+
+
+------------------------------------------------------------------------
+r12471 | airwin | 2013-08-04 10:50:42 -0700 (Sun, 04 Aug 2013) | 7 lines
+Changed paths:
+   M /trunk/cmake/build_projects/template.bp.in
+
+Insert boiler-plate warning into generated */bp.cmake files that those
+files are generated.
+
+Implement use of extra_ignored_dependencies_list (which allows
+platforms to selectively ignore certain dependencies).
+
+
+------------------------------------------------------------------------
+r12470 | airwin | 2013-08-04 10:50:07 -0700 (Sun, 04 Aug 2013) | 7 lines
+Changed paths:
+   M /trunk/cmake/build_projects/cairo/bp.cmake
+   M /trunk/cmake/build_projects/fontconfig/bp.cmake
+   M /trunk/cmake/build_projects/glib/bp.cmake
+   M /trunk/cmake/build_projects/gobject-introspection/bp.cmake
+   M /trunk/cmake/build_projects/harfbuzz/bp.cmake
+   M /trunk/cmake/build_projects/itstool/bp.cmake
+   M /trunk/cmake/build_projects/pango/bp.cmake
+   M /trunk/cmake/build_projects/yelp-tools/bp.cmake
+   M /trunk/cmake/build_projects/yelp-xsl/bp.cmake
+
+Insert boiler-plate warning into generated */bp.cmake files that those
+files are generated.
+
+Implement use of extra_ignored_dependencies_list (which allows
+platforms to selectively ignore certain dependencies).
+
+
+------------------------------------------------------------------------
+r12469 | airwin | 2013-08-04 10:41:48 -0700 (Sun, 04 Aug 2013) | 6 lines
+Changed paths:
+   M /trunk/cmake/build_projects/gperf/bp.cmake
+   M /trunk/cmake/build_projects/intltool/bp.cmake
+   M /trunk/cmake/build_projects/libffi/bp.cmake
+   M /trunk/cmake/build_projects/libxml2/bp.cmake
+   M /trunk/cmake/build_projects/libxslt/bp.cmake
+   M /trunk/cmake/build_projects/pixman/bp.cmake
+   M /trunk/cmake/build_projects/ragel/bp.cmake
+
+Insert boiler-plate warning into generated */bp.cmake files that those
+files are generated.
+
+Implement use of extra_ignored_dependencies_list (which allows
+platforms to selectively ignore certain dependencies).
+
+------------------------------------------------------------------------
+r12468 | airwin | 2013-08-03 11:30:14 -0700 (Sat, 03 Aug 2013) | 3 lines
+Changed paths:
+   M /trunk/cmake/build_projects/update_pango_packages.sh
+
+Save original version of gtk_packages<VERSION>.xml file to make
+it more convenient to update the patch that is applied.
+
+------------------------------------------------------------------------
+r12467 | airwin | 2013-08-03 10:40:53 -0700 (Sat, 03 Aug 2013) | 2 lines
+Changed paths:
+   M /trunk/cmake/build_projects/CMakeLists.txt
+
+Small simplification of CMake logic.
+
+------------------------------------------------------------------------
+r12466 | airwin | 2013-08-03 10:39:54 -0700 (Sat, 03 Aug 2013) | 5 lines
+Changed paths:
+   M /trunk/cmake/build_projects/plplot/bp.cmake
+
+Do not reuse PLPLOT_LOCAL_SOURCE_DIR in loop that configures both
+plplot and plplot_lite.  This fixes a bug where
+z: was being prepended twice for the second time through the loop.
+
+
+------------------------------------------------------------------------
+r12465 | airwin | 2013-08-03 10:35:12 -0700 (Sat, 03 Aug 2013) | 12 lines
+Changed paths:
+   M /trunk/cmake/build_projects/docbook-xml/CMakeLists.txt
+   M /trunk/cmake/build_projects/docbook-xsl/CMakeLists.txt
+
+Sort out all generated catalog issues for the MSYS case.
+
+This gives good results for build_gtk-doc on Linux, but
+that build still fails for the MSYS case because of the
+entity mangling issue for raw xmlcatalog on that platform
+(see https://mail.gnome.org/archives/xml/2013-January/msg00009.html).
+However, for the MSYS case have spot-checked a few of the generated
+catalog results with the xmlcatalog_wrapper.sh script, and they
+seem fine.  Which seems to indicate that the catalogs generated
+by the docbook-x?l packages are fine on MSYS.
+
+
+------------------------------------------------------------------------
+r12464 | airwin | 2013-08-03 10:29:37 -0700 (Sat, 03 Aug 2013) | 21 lines
+Changed paths:
+   A /trunk/cmake/build_projects/xmlcatalog_wrapper.sh
+
+Initial commit of a script that makes it convenient to check XML
+catalogs on MSYS using the xmlcatalog --shell environment.
+
+With two arguments (with the first a reference to a file assumed to be
+a catalog file) this script goes into xmlcatalog shell mode to look up
+entities with both the public and system attributes.  Otherwise, it
+just falls through to the equivalent raw xmlcatalog command.
+
+The only point of this script is it provides a reasonably convenient
+human workaround for the raw xmlcatalog issue on MSYS platforms where
+that environment mangles entity names on the command line (it
+interprets them as a path and does some substitution into the entity
+which completely messes it up, see
+https://mail.gnome.org/archives/xml/2013-January/msg00009.html).  I
+have not been able to figure out how to make this script respond
+identically to what the raw xmlcatalog command should actually be
+doing if the entities didn't get mangled. So this script is only for
+convenient human use to check catalogs, but cannot be used in scripts
+itself as a replacement for raw xmlcatalog.
+
+
+------------------------------------------------------------------------
+r12463 | airwin | 2013-08-02 15:05:10 -0700 (Fri, 02 Aug 2013) | 7 lines
+Changed paths:
+   A /trunk/cmake/build_projects/docbook-xml
+   A /trunk/cmake/build_projects/docbook-xml/CMakeLists.txt
+   A /trunk/cmake/build_projects/docbook-xml/bp.cmake
+   A /trunk/cmake/build_projects/docbook-xsl
+   A /trunk/cmake/build_projects/docbook-xsl/CMakeLists.txt
+   A /trunk/cmake/build_projects/docbook-xsl/bp.cmake
+   M /trunk/cmake/build_projects/gtk-doc/bp.cmake
+
+Add additional docbook-xml and docbook-xsl build dependencies of
+gtk-doc.
+
+ToDo.  The result works on Linux, but there are still some PATH issues I
+am sorting out on MSYS.
+
+
+------------------------------------------------------------------------
+r12462 | airwin | 2013-07-31 21:25:44 -0700 (Wed, 31 Jul 2013) | 3 lines
+Changed paths:
+   A /trunk/cmake/build_projects/update_pango_packages.sh
+
+Initial commit of a bash script to update all the pango-generated
+build configurations.
+
+------------------------------------------------------------------------
+r12461 | airwin | 2013-07-31 21:24:41 -0700 (Wed, 31 Jul 2013) | 5 lines
+Changed paths:
+   M /trunk/cmake/build_projects/cairo/bp.cmake
+   M /trunk/cmake/build_projects/fontconfig/bp.cmake
+   M /trunk/cmake/build_projects/glib/bp.cmake
+   M /trunk/cmake/build_projects/gobject-introspection/bp.cmake
+   M /trunk/cmake/build_projects/gtk-doc/bp.cmake
+   M /trunk/cmake/build_projects/harfbuzz/bp.cmake
+   M /trunk/cmake/build_projects/itstool/bp.cmake
+   M /trunk/cmake/build_projects/pango/bp.cmake
+   M /trunk/cmake/build_projects/yelp-tools/bp.cmake
+   M /trunk/cmake/build_projects/yelp-xsl/bp.cmake
+
+Reconfigure all the build configurations that are pango-generated.
+The net effect of this reconfiguration is libXft is now ignored as a dependency for
+all of these generated build configurations which suppresses a CMake
+warning when build_projects is configured.
+
+------------------------------------------------------------------------
+r12460 | airwin | 2013-07-31 20:59:57 -0700 (Wed, 31 Jul 2013) | 12 lines
+Changed paths:
+   M /trunk/cmake/build_projects/plplot/bp.cmake
+
+Implement a build_plplot_lite target (which disables wxwidgets, qt,
+and cairo device drivers and which therefore has fewer dependencies and
+builds and tests 5 times as fast).
+
+Meanwhile, the build_plplot target now has properly implemented
+wxwidgets and pango build configuration dependencies, i.e., wxwidgets
+and pango and their dependencies will be built first, then plplot
+which will depend on those built and installed results.
+
+Tested by Alan W. Irwin <ai...@us...> using both the
+build_plplot_lite (5 minutes) and build_plplot (25 minutes) targets on Linux.
+
+------------------------------------------------------------------------
+r12459 | airwin | 2013-07-31 13:31:09 -0700 (Wed, 31 Jul 2013) | 14 lines
+Changed paths:
+   M /trunk/cmake/build_projects/gtk_packages_add.xml
+   A /trunk/cmake/build_projects/ragel
+   A /trunk/cmake/build_projects/ragel/bp.cmake
+   M /trunk/cmake/build_projects/update_added_packages.sh
+
+Add ragel build configuration.  This is the last required build
+configuration (other than obvious build tools and libXft) that the
+jhbuild configuration data indicates is required for pango and all
+its dependencies.  So in theory the build of pango should also work
+on MSYS, but undoubtedly there are other dependencies that the
+jhbuild configuration files currently fail to identify.
+
+Tested by Alan W. Irwin <ai...@us...> by running the
+update_added_packages.sh script to automatically generate/regenerate all added
+build_configurations (which now includes ragel) and afterward running the
+build_harfbuzz target (which indirectly runs the build_ragel target) on
+Linux.
+
+
+------------------------------------------------------------------------
+r12458 | airwin | 2013-07-31 12:37:14 -0700 (Wed, 31 Jul 2013) | 10 lines
+Changed paths:
+   A /trunk/cmake/build_projects/update_added_packages.sh
+
+Initial commit of script to automatically generate
+(or regenerate) build configurations for the following
+list of packages:
+
+libffi intltool pixman gperf libxslt libxml2
+
+Tested by Alan W. Irwin <ai...@us...> by
+running the script and testing all the relevant build targets
+for these packages on Linux.
+
+------------------------------------------------------------------------
+r12457 | airwin | 2013-07-31 12:33:53 -0700 (Wed, 31 Jul 2013) | 3 lines
+Changed paths:
+   M /trunk/cmake/build_projects/configure_bp.cmake
+
+Ignore libXft in dependencies for all automatically generated
+build configurations.
+
+------------------------------------------------------------------------
+r12456 | airwin | 2013-07-31 12:32:46 -0700 (Wed, 31 Jul 2013) | 6 lines
+Changed paths:
+   M /trunk/cmake/build_projects/gtk_packages_add.xml
+   A /trunk/cmake/build_projects/libxml2
+   A /trunk/cmake/build_projects/libxml2/bp.cmake
+   A /trunk/cmake/build_projects/libxslt
+   A /trunk/cmake/build_projects/libxslt/bp.cmake
+
+Add (automatically generated) build configurations for
+libxslt and libxml2.
+
+Tested by: Alan W. Irwin <ai...@us...> using the
+build_libxslt target on Linux.
+
+------------------------------------------------------------------------
+r12455 | airwin | 2013-07-31 12:29:47 -0700 (Wed, 31 Jul 2013) | 5 lines
+Changed paths:
+   M /trunk/cmake/build_projects/gperf/bp.cmake
+   M /trun...
 
[truncated message content]

[Plplot-cvs] SF.net SVN: plplot:[12557] trunk/README.Release_Manager_Cookbook

[<ai...@us...>]

Revision: 12557
          http://sourceforge.net/p/plplot/code/12557
Author:   airwin
Date:     2013-09-30 22:57:22 +0000 (Mon, 30 Sep 2013)
Log Message:
-----------
This may be the final version of this file for this release.

Modified Paths:
--------------
    trunk/README.Release_Manager_Cookbook

Modified: trunk/README.Release_Manager_Cookbook
===================================================================
--- trunk/README.Release_Manager_Cookbook	2013-09-30 21:46:24 UTC (rev 12556)
+++ trunk/README.Release_Manager_Cookbook	2013-09-30 22:57:22 UTC (rev 12557)
@@ -1,33 +1,38 @@
 INDEX
-(1) Prepare documentation
+(1) Prepare and test the documentation
 (2) Check and potentially fix internal consistency
 (3) Update website-related files
-(4) Preliminary install and test of a local copy of the PLplot website
-(5) Prepare a preliminary version of the ChangeLog file for this release
-(6) Prepare the README.release file or press those who have made
-(7) Version changes.
-(8) Install and test a local copy of the PLplot website
-(9) Comprehensive test of PLplot.
-(10) Upload the local website to SourceForge:
-(5) Prepare a file release:
-(4) Publicity for the release announcement.
-(5) Immediate preparation for next release cycle
+(4) Install and test a (preliminary) local copy of the PLplot website
+(5) Prepare a (preliminary) version of the ChangeLog file for this release
+(6) Prepare the README.release file and/or press those who have made
+(7) Update Release date and versions
+(8) Create (a preliminary version of) the release tarball and check the result
+(9) Do comprehensive test of PLplot.
+(10) Install and test a local copy of the PLplot website
+(11) Create ChangeLog.release
+(12) Create the PLplot Release
+(13) Upload the local website to SourceForge
+(14) Prepare a file release
+(15) Publicize the release announcement
+(16) Prepare immediately for the next release cycle
 
-
 (A1) GNU Privacy Guard (gpg)
 (A2) Creating a test tarball from trunk
 (A3) Correct computer time
 
-N.B. the order of steps below is important because of the
-dependencies between the steps.
+N.B. the order of steps below is important because of the dependencies
+between the steps which are noted (except for the generation of the
+final release tarball and ChangeLog which depend on virtually all
+prior steps).
 
-(1) Prepare documentation
+(1) Prepare and test the documentation
 
 This step does not depend on other steps.
 
 The steps below entitled 
 
 "Check and potentially fix internal consistency" and
+"Install and test a (preliminary) local copy of the PLplot website"
 "Install and test a local copy of the PLplot website"
 
 depend on this step.
@@ -36,23 +41,22 @@
 documentation (in doc/docbook/src) to reflect any changes (new drivers
 or new PLplot functionality) in the current release cycle.  Or
 alternatively, press those who made the changes to update the
-documentation.
+documentation.  Generate and test our doxygen form of documentation
+following the instructions in doc/README.doxygen.
 
-Generate and test our doxygen form of documentation following the
-instructions in doc/README.doxygen.  Generate and test our Docbook
-documentation following the instructions in
-doc/docbook/README.developers.
+Update, generate and test our Docbook documentation following the
+instructions in doc/docbook/README.developers.
 
 (2) Check and potentially fix internal consistency
 
 This step depends on the step above entitled 
 
-"Prepare documentation".
+"Prepare and test the documentation".
 
 This step potentially affects the swig-generated bindings and
-the f95, tcl, and ocaml bindings.  Thus, the steps below entitled
+the f95, tcl, and ocaml bindings.  Thus, the step below entitled
 
-""
+"Comprehensive test of PLplot"
 
 may depend on this step.
 
@@ -106,9 +110,12 @@
 
 This step does not depend on other steps.
 
-The step below entitled
+The steps below entitled
 
+"Install and test a (preliminary) local copy of the PLplot website"
 "Install and test a local copy of the PLplot website"
+"Create (a preliminary version of) the release tarball and check the result"
+"Create the release tarball and check the result"
 
 depends on this step.
 
@@ -121,9 +128,9 @@
 controls what examples-related files are copied to the website.
 
 Update the project web page, including the examples: edit
-www/examples.php to reflect the forthcoming release version number and
-any changes to the examples themselves (i.e. pages added or removed
-from an existing example or entirely new examples).
+www/examples.php to reflect any changes to the examples themselves
+(i.e. pages added or removed from an existing example or entirely new
+examples).
 
 Note, the xmlto package that must be installed in order to generate
 the DocBook documentation (see doc/docbook/README.developers referred
@@ -132,66 +139,15 @@
 present release announcements for the website if desired.  See
 www/announce/README for just how easy this step would be.
 
-(4) Preliminary install and test of a local copy of the PLplot website
+(4) Install and test a (preliminary) local copy of the PLplot website
 
 This step depends on the steps above entitled
 
-"Prepare documentation" and
+"Prepare and test the documentation" and
 "Update website-related files"
 
 but does not depend on any steps below.
 
-Follow the directions in the step below entitled
-
-"Install and test a local copy of the PLplot website"
-
-exactly which should produce a final tested local version of the
-website except that the RELEASE_DATE might be wrong.
-
-(5) Prepare a preliminary version of the ChangeLog file for this release
-
-# This makes the BASE used below correct.
-svn update
-
-svn log --revision BASE:<LAST_RELEASE_REVISION> --verbose  >| ChangeLog.release_preliminary
-
-where <LAST_RELEASE_REVISION> stands for the last revision number of
-the previous release which can be determined e.g., by viewing the
-ChangeLog.release file from the previous release.  Note the "_preliminary"
-suffix to distinguish this from the final result below.
-
-
-(6) Prepare the README.release file or press those who have made
-changes in this release cycle to update that file.
-
-To double-check that file is complete with regards to all major
-developments during this release cycle, skim all the commit messages in
-ChangeLog.release_preliminary determined above.
-
-(7) Version changes.
-
-Version of PLplot updated above in www/examples.php.  In addition,
-update cmake/modules/plplot_version.cmake to reflect the current
-RELEASE_DATE (which affects the documentation build) and
-version. Also, follow the instructions in that file for updating the
-SOVERSION, the minor number and the patch number for each versioned
-library created by the PLplot build.
-
-(8) Install and test a local copy of the PLplot website
-
-This step depends on the steps above entitled
-
-"Prepare documentation",
-"Update website-related files", and
-"Version changes" (since the documentation build depends on the
-release date).
-
-The step below entitled
-
-""
-
-depends on this one.
-
 To build the local form of the website (including both the doxygen and
 DocBook forms of our documentation) run (on a Linux host that is
 capable of building the documentation for the source tree that has all
@@ -246,7 +202,7 @@
 examples is accessible, etc.  Some iterations with the
 steps above entitled
 
-"Prepare documentation" and
+"Prepare and test the documentation" and
 "Update website-related files"
 
 will likely be required.
@@ -259,9 +215,98 @@
 local website you should commit all your changes so they are available
 for generating the tarball and ChangeLog (see below) for this release.
 
-(9) Comprehensive test of PLplot.
+N.B. The iterated result should be identical to the final result (see
+below) except that the release date (configured as RELEASE_DATE) and
+the PLplot version in www/example.php will be wrong.  Those
+issues are addressed in "Update release date and versions" below.
 
-Do comprehensive test of the interactive results then the noninteractive
+(5) Prepare a (preliminary) version of the ChangeLog file for this release
+
+# This makes the BASE used below correct.
+svn update
+
+svn log --revision BASE:<LAST_RELEASE_REVISION> --verbose  >| ChangeLog.release_preliminary
+
+where <LAST_RELEASE_REVISION> stands for the last revision number of
+the previous release which can be determined e.g., by viewing the
+ChangeLog.release file from the previous release.  Note the
+"_preliminary" suffix to distinguish this from the final result below
+which will contain (if all goes well in the steps below) a record of
+all but the last commit (of the ChangeLog itself) for this release.
+
+(6) Prepare the README.release file and/or press those who have made
+changes in this release cycle to update that file.
+
+This step depends on the step above entitled
+
+"Prepare a (preliminary) version of the ChangeLog file for this release".
+
+To double-check that file is complete with regards to all major
+developments during this release cycle, skim all the commit messages in
+ChangeLog.release_preliminary determined above.
+
+(7) Update Release date and versions
+
+This step depends on no others.
+
+The following steps entitled
+
+"Create (a preliminary version of) the release tarball and check the result
+for errors."
+"Install and test a local copy of the PLplot website"
+"Comprehensive test of PLplot"
+
+depend on this step.
+
+Update PLplot version in www/examples.php.  In addition,
+update cmake/modules/plplot_version.cmake to reflect the current
+RELEASE_DATE (which affects the documentation build) and
+version. Also, follow the instructions in that file for updating the
+SOVERSION, the minor number and the patch number for each versioned
+library created by the PLplot build.
+
+(8) Create (a preliminary version of) the release tarball and check the result
+for errors.
+
+This step depends on the steps above entitled
+
+"Prepare and test documentation"
+"Check and potentially fix internal consistency"
+
+The -c option runs ctest on the directory tree unpacked from the
+release tarball, and the -i option installs a build from that
+directory tree
+
+scripts/make_tarball.sh -c -i /tmp/plplot_install
+
+find /tmp/plplot-dist-prep -name "*.out" |xargs grep -i error
+
+If the above find command discovers any errors, then those errors
+need to be fixed and this step needs to be repeated.
+
+Browse the following install locations that were generated from the
+tarball:
+
+/tmp/plplot_install/share/doc/plplot/html/index.html
+/tmp/plplot_install/share/doc/plplot/plplot-5.9.10.pdf
+/tmp/plplot_install/share/doc/plplot/plplot-5.9.10.ps.gz
+
+Look at a few man pages that were generated from the tarball, e.g.,
+
+nroff -man /tmp/plplot_install/share/man/man3/pllegend.3plplot |less
+
+Look at the info pages that were generated from the tarball using
+
+info /tmp/plplot_install/share/info/plplotdoc.info
+
+(9) Do comprehensive test of PLplot.
+
+This step depends on the steps above entitled
+
+"Check and potentially fix internal consistency"
+"Update date/versions"
+
+Do a comprehensive test of the interactive and noninteractive
 results.
 
 scripts/comprehensive_test.sh --do_ctest no --do_test_noninteractive no
@@ -270,15 +315,32 @@
 Enter results of these and all other tests of this release into
 README.release.
 
-(10) Create ChangeLog.release
+(10) Install and test a local copy of the PLplot website
 
+This step depends on the steps above entitled
+
+"Prepare and test the documentation"
+"Update website-related files"
+"Update release date and versions"
+
+The step below entitled
+
+"Upload the local website to SourceForge"
+
+depends on this one.
+
+Follow the exact steps given above in "Install and test a
+(preliminary) local copy of the PLplot website" but this time with the
+correct RELEASE_DATE and VERSION.
+
+(11) Create ChangeLog.release
+
 N.B. commit all local changes to the repository so they will be
-reflected in the ChangeLog, tagged version of the release, and release
-tarball.  And if there are committed changes after this one (except
-possibly for commits of this file, README.Release_Manager_Cookbook),
+reflected in the ChangeLog, tagged version of the release, and the release
+tarball.  And if there are committed changes after this one
 repeat this step so the ChangeLog.release commit is the last trunk
-commit for this release cycle (with the exception of the current
-file).
+commit for this release cycle (with the possible exception of the current
+file, README.Release_Manager_Cookbook).
 
 Prepare the ChangeLog.release file to keep track of all changes
 made for the release.  Use the following commands:
@@ -299,7 +361,8 @@
 last commit for the trunk version of PLplot (see remarks above
 about when it is necessary to repeat this step).
 
-(11) Creating a PLplot Release:
+(12) Create the PLplot Release
+
 Based on suggestions in the svn manual, the PLplot svn archive is configured
 as follows:
 
@@ -340,8 +403,6 @@
 
 cd to tags/ and enter the following commands: 
 
-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
@@ -378,7 +439,7 @@
 
 A list of your GPG keys can be obtained using the command "gpg --list-keys".
 
-(2) Upload the local website to SourceForge:
+(13) Upload the local website to SourceForge
 
 Once you are satisfied with the local website, you should upload it to
 SourceForge with rsync.
@@ -404,7 +465,7 @@
 N.B. the --dry-run option for rsync is a god-send and tells you exactly what
 will happen without actually doing it.
 
-(5) Prepare a file release:
+(14) Prepare a file release
 
 Login to sf.net.
 Go to the PLplot SourceForge project page.
@@ -433,13 +494,13 @@
     the release numbers.
 
 
-(4) Publicity for the release announcement.
+(15) Publicize the release announcement
 
 Jerry: macresearch.org
 
 Barbara Irwin: linuxtoday.com, lwn.net, lxer.com
 
-(5) Immediate preparation for next release cycle
+(16) Prepare immediately for the 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
@@ -447,8 +508,6 @@
   b. Update README.release file to reflect significant changes made between
      the current release and the last release.
 
-
-
 --- Appendix ---
 
 (A1) GNU Privacy Guard (gpg)

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Plplot-cvs] SF.net SVN: plplot:[12556] trunk/cmake/modules/plplot_version.cmake

[<ai...@us...>]

Revision: 12556
          http://sourceforge.net/p/plplot/code/12556
Author:   airwin
Date:     2013-09-30 21:46:24 +0000 (Mon, 30 Sep 2013)
Log Message:
-----------
Bump the release date by one day.

Modified Paths:
--------------
    trunk/cmake/modules/plplot_version.cmake

Modified: trunk/cmake/modules/plplot_version.cmake
===================================================================
--- trunk/cmake/modules/plplot_version.cmake	2013-09-30 20:49:54 UTC (rev 12555)
+++ trunk/cmake/modules/plplot_version.cmake	2013-09-30 21:46:24 UTC (rev 12556)
@@ -1,6 +1,6 @@
 # For now, must set this by hand before each release.  This value affects
 # at least the documentation build and perhaps other parts of the release.
-set(RELEASE_DATE "2013-09-29")
+set(RELEASE_DATE "2013-09-30")
 
 # Version data that need review and possible modification for each release.
 

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Plplot-cvs] SF.net SVN: plplot:[12555] trunk

[<ai...@us...>]

Revision: 12555
          http://sourceforge.net/p/plplot/code/12555
Author:   airwin
Date:     2013-09-30 20:49:54 +0000 (Mon, 30 Sep 2013)
Log Message:
-----------
Fix build-system bug in configuration and installation of
stylesheet.css for the case where the documentation is prebuilt.

Tested by Alan W. Irwin <ai...@us...> by running

scripts/make_tarball.sh -c -i /tmp/plplot_install
find /tmp/plplot-dist-prep -name "*.out" |xargs grep -i error

and browsing the resulting documentation that was installed from the
generated preliminary version of the release tarball in
/tmp/plplot_install/share/doc/plplot/html while looking carefully
for stylesheet issues.

Modified Paths:
--------------
    trunk/cmake/modules/docbook.cmake
    trunk/doc/docbook/src/CMakeLists.txt

Modified: trunk/cmake/modules/docbook.cmake
===================================================================
--- trunk/cmake/modules/docbook.cmake	2013-09-30 07:01:15 UTC (rev 12554)
+++ trunk/cmake/modules/docbook.cmake	2013-09-30 20:49:54 UTC (rev 12555)
@@ -61,11 +61,13 @@
   message(STATUS "WARNING: validate target will not be available to check for syntax issues in the PLplot DocBook documentation because onsgmls was not found.")
 endif(ONSGMLS )
 
+# This option is used for the BUILD_DOC case below and elsewhere and also
+# for the PREBUILT_DOC case elsewhere (when stylesheet.css is configured).
+option(DOCBOOK_XML_BACKEND "Use DocBook XML/XSLT backend tools to generate our documentation from DocBook source" YES)
+
 # Check for required programs and perl libraries.
 if(BUILD_DOC)
 
-  option(DOCBOOK_XML_BACKEND "Use DocBook XML/XSLT backend tools to generate our documentation from DocBook source" YES)
-
   # The info backend is implemented only with perl and XML/XSLT regardless of
   # DOCBOOK_XML_BACKEND.
   find_program(DB2X_TEXIXML db2x_texixml)

Modified: trunk/doc/docbook/src/CMakeLists.txt
===================================================================
--- trunk/doc/docbook/src/CMakeLists.txt	2013-09-30 07:01:15 UTC (rev 12554)
+++ trunk/doc/docbook/src/CMakeLists.txt	2013-09-30 20:49:54 UTC (rev 12555)
@@ -723,6 +723,18 @@
 endif(BUILD_MAN OR PREBUILT_DOC)
 
 if(BUILD_HTML OR PREBUILT_DOC)
+  if(DOCBOOK_XML_BACKEND)
+    configure_file(
+      ${CMAKE_CURRENT_SOURCE_DIR}/stylesheet.css.xsl.in
+      ${CMAKE_CURRENT_BINARY_DIR}/stylesheet.css
+      )
+  else(DOCBOOK_XML_BACKEND)
+    configure_file(
+      ${CMAKE_CURRENT_SOURCE_DIR}/stylesheet.css.dsssl.in
+      ${CMAKE_CURRENT_BINARY_DIR}/stylesheet.css
+      )
+  endif(DOCBOOK_XML_BACKEND)
+
   install(FILES ${CMAKE_CURRENT_BINARY_DIR}/${HTML_MANIFEST} ${CMAKE_CURRENT_BINARY_DIR}/stylesheet.css DESTINATION ${DOC_DIR}/html )
   install(CODE "
 # Suppress empty element warning.

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Plplot-cvs] SF.net SVN: plplot:[12554] trunk/scripts/make_tarball.sh

[<ai...@us...>]

Revision: 12554
          http://sourceforge.net/p/plplot/code/12554
Author:   airwin
Date:     2013-09-30 07:01:15 +0000 (Mon, 30 Sep 2013)
Log Message:
-----------
Drop -t and -w options and modify script to create a release tarball
from the parent directory of wherever the script resides.  Thus, it can
create preliminary test tarballs from the local copy of svn trunk
(where this script resides) or a final release tarball from a local
copy of the appropriate tags release directory (where this script also
resides).

Modified Paths:
--------------
    trunk/scripts/make_tarball.sh

Modified: trunk/scripts/make_tarball.sh
===================================================================
--- trunk/scripts/make_tarball.sh	2013-09-30 00:07:44 UTC (rev 12553)
+++ trunk/scripts/make_tarball.sh	2013-09-30 07:01:15 UTC (rev 12554)
@@ -6,7 +6,7 @@
 # /tmp/plplot-dist-prep
 
 # Copyright (C) 2003, 2004  Rafael Laboissiere
-# Copyright (C) 2006 Alan W. Irwin
+# Copyright (C) 2006, 2013 Alan W. Irwin
 #
 # This file is part of PLplot.
 #
@@ -28,18 +28,12 @@
 
 usage () {
   local prog=`basename $0`
-  echo "Usage: $prog -t tagname [-n] [-w URL] \\"
+  echo "Usage: $prog [-n] \\"
   echo "          [-c [-i prefix] [-o cmake options]] \\"
   echo "       $prog -d"
   echo "       $prog -h"
   echo
-  echo "Option -t is mandatory and is used for specifying the subdirectory"
-  echo "  of the svn URL.  By default the svn URL points to the tags"
-  echo "  subdirectory so normally the -t option is a version tag"
-  echo "  (e.g., v5_7_4) used for the _already committed_ tags subdirectory"
-  echo "  of the release existing at the SourceForge svn repository."
   echo "Option -n prevents pre-building anything including the DocBook manual."
-  echo "Option -w sets the svn repository URL."
   echo "When option -c is given, the generated tarball is"
   echo "  unpacked, configured with cmake and built with make, and"
   echo "  the ctest (build-tree tests) is run afterward."
@@ -57,7 +51,6 @@
 }
 
 DOC_ARG=${DOC_ARG:--DBUILD_DOC=ON}
-SVN_URL=${SVN_URL:-https://plplot.svn.sourceforge.net/svnroot/plplot/tags}
 # Just easier to always keep this temporary directory in the same location
 SVNTMPDIR=/tmp/plplot-dist-prep
 
@@ -83,7 +76,7 @@
 PREBUILT_DOC_ARG="-DPREBUILT_DOC=ON"
 do_prebuild_dist=yes
 
-while getopts "cdhi:no:t:u:w:" option
+while getopts "cdhi:no:u:" option
 do
   case $option in
     c) do_check=yes ;;
@@ -92,29 +85,36 @@
     i) test -n "$OPTARG" || usage 1 ; prefix=$OPTARG ;;
     n) DOC_ARG=;PREBUILD_ARG=;PREBUILT_DOC_ARG=;do_prebuild_dist=no ;;
     o) config_opt="$config_opt $OPTARG" ;;
-    t) test -n "$OPTARG" || usage 1 ; TAG=$OPTARG ;;
-    w) test -n "$OPTARG" || usage 1 ; SVN_URL=$OPTARG ;;
     *) usage 1 ;;
   esac
 done
 
-test -n "$TAG" || usage 1
-
 cleanup ( ) {
     rm -rf $SVNTMPDIR
 }
 
-#trap "cleanup" 0 HUP INT QUIT PIPE TERM
+# Find absolute PATH of script without using readlink (since readlink is
+# not available on all platforms).  Followed advice at
+# http://fritzthomas.com/open-source/linux/551-how-to-get-absolute-path-within-shell-script-part2/
+ORIGINAL_PATH="$(pwd)"
+cd "$(dirname $0)"
+# Absolute Path of the script
+SCRIPT_PATH="$(pwd)"
+cd "${ORIGINAL_PATH}"
 
+# Assumption: top-level source tree is parent directory of where script
+# is located.
+SOURCE_TREE="$(dirname ${SCRIPT_PATH})"
+
 cleanup
 mkdir $SVNTMPDIR
 cd $SVNTMPDIR
-svn export $SVN_URL/$TAG plplot \
+svn export $SOURCE_TREE plplot \
   && mkdir build_dir \
   && cd build_dir \
   && cmake -DCMAKE_VERBOSE_MAKEFILE=ON \
      ${PREBUILD_ARG} ${DOC_ARG} -DBUILD_DOX_DOC=ON \
-     -DWWW_USER:STRING=${WWW_USER} ../plplot >& cmake.out \
+     ../plplot >& cmake.out \
   && echo "Making distribution." \
   && (if [ "$do_prebuild_dist" = "yes" ] ; then
         make ${make_opt} prebuild_dist >& make_prebuild_dist.out
@@ -131,7 +131,7 @@
   && ( cd ctest_build_dir \
        && cmake ${config_opt} -DCMAKE_INSTALL_PREFIX:PATH=${prefix} \
           -DCMAKE_VERBOSE_MAKEFILE=ON ${PREBUILT_DOC_ARG} -DBUILD_DOX_DOC=ON \
-	  -DWWW_USER:STRING=${WWW_USER} -DBUILD_TEST=ON \
+	  -DBUILD_TEST=ON \
 	  ../plplot >& cmake.out \
        && make ${make_opt} >& make.out \
        && ctest >& ctest.out \

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Plplot-cvs] SF.net SVN: plplot:[12553] trunk/README.Release_Manager_Cookbook

[<ai...@us...>]

Revision: 12553
          http://sourceforge.net/p/plplot/code/12553
Author:   airwin
Date:     2013-09-30 00:07:44 +0000 (Mon, 30 Sep 2013)
Log Message:
-----------
Interim snapshot commit of the many changes I have made to the release
process.  However, there is still more edits that will need to be
made before this is ready for release.

Modified Paths:
--------------
    trunk/README.Release_Manager_Cookbook

Modified: trunk/README.Release_Manager_Cookbook
===================================================================
--- trunk/README.Release_Manager_Cookbook	2013-09-29 20:59:14 UTC (rev 12552)
+++ trunk/README.Release_Manager_Cookbook	2013-09-30 00:07:44 UTC (rev 12553)
@@ -1,51 +1,207 @@
 INDEX
-(1) Install and test a local copy of the PLplot website.
-(2) Upload the local website to SourceForge.
-(3) Creating a PLplot Release.
+(1) Prepare documentation
+(2) Check and potentially fix internal consistency
+(3) Update website-related files
+(4) Preliminary install and test of a local copy of the PLplot website
+(5) Prepare a preliminary version of the ChangeLog file for this release
+(6) Prepare the README.release file or press those who have made
+(7) Version changes.
+(8) Install and test a local copy of the PLplot website
+(9) Comprehensive test of PLplot.
+(10) Upload the local website to SourceForge:
+(5) Prepare a file release:
 (4) Publicity for the release announcement.
 (5) Immediate preparation for next release cycle
 
+
 (A1) GNU Privacy Guard (gpg)
 (A2) Creating a test tarball from trunk
 (A3) Correct computer time
 
-(1) Install and test a local copy of the PLplot website:
+N.B. the order of steps below is important because of the
+dependencies between the steps.
 
-(N.B. this step needs to be done first to insure the associated source tree
-updates get into the release tarball, the svn tags version of the release,
-and associated commit messages get into the ChangeLog for the
-release.)
+(1) Prepare documentation
 
-You should always generate and install from scratch a local copy of the
-PLplot website on some ssh-accessible machine (normally your local machine).
+This step does not depend on other steps.
 
+The steps below entitled 
+
+"Check and potentially fix internal consistency" and
+"Install and test a local copy of the PLplot website"
+
+depend on this step.
+
+Update the doxygen documentation (in our source code) and DocBook
+documentation (in doc/docbook/src) to reflect any changes (new drivers
+or new PLplot functionality) in the current release cycle.  Or
+alternatively, press those who made the changes to update the
+documentation.
+
+Generate and test our doxygen form of documentation following the
+instructions in doc/README.doxygen.  Generate and test our Docbook
+documentation following the instructions in
+doc/docbook/README.developers.
+
+(2) Check and potentially fix internal consistency
+
+This step depends on the step above entitled 
+
+"Prepare documentation".
+
+This step potentially affects the swig-generated bindings and
+the f95, tcl, and ocaml bindings.  Thus, the steps below entitled
+
+""
+
+may depend on this step.
+
+Some of the files in the source tree are generated from other files
+in the source tree using build-system targets.  All targets that
+have "check" in the name prefix are these kind of targets.  So to get
+a complete list of such targets, execute
+
+make help |grep '... check'
+
+in the build tree.  The current such list of targets is
+
+... check_swig_documentation
+... check_f95_parameters
+... check_tcl_parameters
+... check_plplot_h.inc
+
+Note, one of these targets (check_plplot_h.inc) only exists if the
+-DGENERATE_PLPLOT_H_INC=ON cmake option is used which in turn requires
+that at least the OCaml version of the Perl regular expression library
+be installed.  (On debian the associated package name is
+libpcre-ocaml-dev.)  Normally, GENERATE_PLPLOT_H_INC is OFF by default
+to reduce build dependencies, but to make the complete list of such
+targets available you should run the cmake command with the
+-DGENERATE_PLPLOT_H_INC=ON option and make sure there are no
+OCaml-related warnings in the results.
+
+To actually do the internal consistency checks, run each of the above
+targets which typically generate a file in the build tree which is
+then compared (using the Unix cmp command) with the file that is being
+checked in the source tree.  If the two files are inconsistent (which
+can be caused by documentation updates, for example), the cmp command
+complains, and you should follow up by doing a diff between the two
+files to confirm that the changes are reasonable followed by copying
+the build-tree version of the file on top of the source-tree version
+and committing the source-tree version.  When this process is completed,
+all the above targets should run with no cmp or other errors/warnings
+at all, e.g.,
+
+software@raven> make check_swig_documentation check_f95_parameters check_tcl_parameters check_plplot_h.inc
+Check that swig_documentation.i is consistent with doc/docbook/src/api.xml
+Built target check_swig_documentation
+Check that plplot_parameters.h is consistent with the #defines in bindings/swig-support/plplotcapi.i
+Built target check_f95_parameters
+Check that plplot_parameters.h is consistent with the #defines in bindings/swig-support/plplotcapi.i
+Built target check_tcl_parameters
+Check that plplot_h.inc is consistent with touchup.ml and plplot_h
+Built target check_plplot_h.inc
+
+(3) Update website-related files
+
+This step does not depend on other steps.
+
+The step below entitled
+
+"Install and test a local copy of the PLplot website"
+
+depends on this step.
+
 If necessary, update the examples list in
 scripts/htdocs-gen_plot-examples.sh. That list is used to generate the
-website example-related files and copy the results to the website. The list
-automatically controls what example source code is configured (for source
-code that needs that), as well as what example plots and example thumbnails
-are generated.  The list also automatically controls what examples-related
-files are copied to the website.
+website example-related files and copy the results to the website. The
+list automatically controls what example source code is configured
+(for source code that needs that), as well as what example plots and
+example thumbnails are generated.  The list also automatically
+controls what examples-related files are copied to the website.
 
 Update the project web page, including the examples: edit
 www/examples.php to reflect the forthcoming release version number and
 any changes to the examples themselves (i.e. pages added or removed
 from an existing example or entirely new examples).
 
-You also need to install "xmlto" (in the xmlto debian package).
-xmlto is used to generate some of our older release announcements for
-the website, and could also be used to generate present release
-announcements for the website if desired.  See www/announce/README for
-just how easy this step would be.
+Note, the xmlto package that must be installed in order to generate
+the DocBook documentation (see doc/docbook/README.developers referred
+to above) is also used to generate some of our older release
+announcements for the website, and could also be used to generate
+present release announcements for the website if desired.  See
+www/announce/README for just how easy this step would be.
 
-Run (on a Linux host that is capable of building the documentation
-for the source tree that has all local changes)
+(4) Preliminary install and test of a local copy of the PLplot website
 
+This step depends on the steps above entitled
+
+"Prepare documentation" and
+"Update website-related files"
+
+but does not depend on any steps below.
+
+Follow the directions in the step below entitled
+
+"Install and test a local copy of the PLplot website"
+
+exactly which should produce a final tested local version of the
+website except that the RELEASE_DATE might be wrong.
+
+(5) Prepare a preliminary version of the ChangeLog file for this release
+
+# This makes the BASE used below correct.
+svn update
+
+svn log --revision BASE:<LAST_RELEASE_REVISION> --verbose  >| ChangeLog.release_preliminary
+
+where <LAST_RELEASE_REVISION> stands for the last revision number of
+the previous release which can be determined e.g., by viewing the
+ChangeLog.release file from the previous release.  Note the "_preliminary"
+suffix to distinguish this from the final result below.
+
+
+(6) Prepare the README.release file or press those who have made
+changes in this release cycle to update that file.
+
+To double-check that file is complete with regards to all major
+developments during this release cycle, skim all the commit messages in
+ChangeLog.release_preliminary determined above.
+
+(7) Version changes.
+
+Version of PLplot updated above in www/examples.php.  In addition,
+update cmake/modules/plplot_version.cmake to reflect the current
+RELEASE_DATE (which affects the documentation build) and
+version. Also, follow the instructions in that file for updating the
+SOVERSION, the minor number and the patch number for each versioned
+library created by the PLplot build.
+
+(8) Install and test a local copy of the PLplot website
+
+This step depends on the steps above entitled
+
+"Prepare documentation",
+"Update website-related files", and
+"Version changes" (since the documentation build depends on the
+release date).
+
+The step below entitled
+
+""
+
+depends on this one.
+
+To build the local form of the website (including both the doxygen and
+DocBook forms of our documentation) run (on a Linux host that is
+capable of building the documentation for the source tree that has all
+local changes)
+
 scripts/generate_website.sh
 
 with no arguments.  The script asks you four questions, gives you a chance
 to verify your answers, then does all the rest of it (downloading a
-throwaway copy of the PLplot source code, building the documentation,
+throwaway copy of the PLplot source code, building the doxygen and DocBook documentation,
 generating the announcements that are part of the base website, uploading
 the base website, uploading the documentation, building the examples,
 running the examples, uploading the example source code and example results)
@@ -63,8 +219,8 @@
 
 find /tmp/plplotdoc -name '*.out' |xargs grep -i error
 
-You should install both apache and PHP on your computer.  For Debian Testing
-(a.k.a. squeeze) that is done (as root) by installing libapache2-mod-php5
+You should install both apache and PHP on your computer.  For Debian stable
+(a.k.a. wheezy) that is done (as root) by installing libapache2-mod-php5
 and enabling user directories using the command
 
 a2enmod userdir
@@ -84,77 +240,66 @@
 /home/irwin/public_html/plplot/htdocs, browses as
 http://raven/~irwin/plplot/htdocs/.)
 
-I test http://raven/~irwin/plplot/htdocs/ by clicking on most links, checking
-the documentation looks good, checking the examples look good and the
-source code for each language for examples is accessible, etc.
+I test http://raven/~irwin/plplot/htdocs/ by clicking on most links,
+checking the documentation looks good, checking the examples are
+complete and look good and the source code for each language for
+examples is accessible, etc.  Some iterations with the
+steps above entitled
 
+"Prepare documentation" and
+"Update website-related files"
+
+will likely be required.
+
 N.B. scripts/generate_website.sh uses the local source tree where that
 script resides (including all local changes) as the source tree for
 generating the local website.  So there is no need to commit every
-above example and version change until you are completely satisfied
+documentation, example, and version change until you are completely satisfied
 with the local website.  But after you _are_ satisfied with the
 local website you should commit all your changes so they are available
 for generating the tarball and ChangeLog (see below) for this release.
 
-(2) Upload the local website to SourceForge:
+(9) Comprehensive test of PLplot.
 
-Once you are satisfied with the local website, you should upload it to
-SourceForge with rsync.
+Do comprehensive test of the interactive results then the noninteractive
+results.
 
-For the above WEBSITE_PREFIX, here is what worked for me from my computer
-with the hostname of raven where that WEBSITE_PREFIX directory was
-created.
+scripts/comprehensive_test.sh --do_ctest no --do_test_noninteractive no
+scripts/comprehensive_test.sh  --do_test_interactive no
 
-rsync -av --delete \
-/home/irwin/public_html/plplot/htdocs/ \
-airwin,pl...@we...:htdocs 
+Enter results of these and all other tests of this release into
+README.release.
 
-Adjust for your username and WEBSITE_PREFIX.  The ",plplot" part of the
-username makes sure you have the right group permissions and default website
-directory location for PLplot.  
+(10) Create ChangeLog.release
 
-N.B. the trailing slash on the source directory is essential and means rsync
-the contents of this directory with the contents of the destination htdocs
-directory.  Without the trailing slash you would rsync the the contents of
-the source directory with the contents of the htdocs/htdocs destination
-directory which is not what you want to do.  
+N.B. commit all local changes to the repository so they will be
+reflected in the ChangeLog, tagged version of the release, and release
+tarball.  And if there are committed changes after this one (except
+possibly for commits of this file, README.Release_Manager_Cookbook),
+repeat this step so the ChangeLog.release commit is the last trunk
+commit for this release cycle (with the exception of the current
+file).
 
-N.B. the --dry-run option for rsync is a god-send and tells you exactly what
-will happen without actually doing it.
-
-(3) 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 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.
-
-IMPORTANT: commit all local changes to the repository so they
-will be reflected in the ChangeLog, tagged version of the release,
-and release tarball.
-
 Prepare the ChangeLog.release file to keep track of all changes
-made for the release.  (This destroys the ChangeLog.release file
-from the previous release.)
+made for the release.  Use the following commands:
 
 # This makes the BASE used below correct.
 svn update
+
 svn log --revision BASE:<LAST_RELEASE_REVISION> --verbose  >| ChangeLog.release
 
-where <LAST_RELEASE_REVISION> stands for the last revision number of
-the previous release which can be found, e.g., by browsing
-http://plplot.svn.sourceforge.net/viewvc/plplot/tags
+(This destroys the ChangeLog.release file
+from the previous release.)  LAST_REVISION should be the same as in
+the generation of the preliminary version of this file above.
 
 Check that ChangeLog.release is in the appropriate date range (i.e. only the
 changes that were made since the last release should be included) then
 (IMPORTANT) commit it so it will also be available for the tagged
-release version, the release tarball, etc.
+release version, the release tarball, etc.  This should be the
+last commit for the trunk version of PLplot (see remarks above
+about when it is necessary to repeat this step).
 
+(11) Creating a PLplot Release:
 Based on suggestions in the svn manual, the PLplot svn archive is configured
 as follows:
 
@@ -233,8 +378,34 @@
 
 A list of your GPG keys can be obtained using the command "gpg --list-keys".
 
-Prepare a file release:
+(2) Upload the local website to SourceForge:
 
+Once you are satisfied with the local website, you should upload it to
+SourceForge with rsync.
+
+For the above WEBSITE_PREFIX, here is what worked for me from my computer
+with the hostname of raven where that WEBSITE_PREFIX directory was
+created.
+
+rsync -av --delete \
+/home/irwin/public_html/plplot/htdocs/ \
+airwin,pl...@we...:htdocs 
+
+Adjust for your username and WEBSITE_PREFIX.  The ",plplot" part of the
+username makes sure you have the right group permissions and default website
+directory location for PLplot.  
+
+N.B. the trailing slash on the source directory is essential and means rsync
+the contents of this directory with the contents of the destination htdocs
+directory.  Without the trailing slash you would rsync the the contents of
+the source directory with the contents of the htdocs/htdocs destination
+directory which is not what you want to do.  
+
+N.B. the --dry-run option for rsync is a god-send and tells you exactly what
+will happen without actually doing it.
+
+(5) Prepare a file release:
+
 Login to sf.net.
 Go to the PLplot SourceForge project page.
 

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Plplot-cvs] SF.net SVN: plplot:[12552] trunk/cmake/build_projects

[<ai...@us...>]

Revision: 12552
          http://sourceforge.net/p/plplot/code/12552
Author:   airwin
Date:     2013-09-29 20:59:14 +0000 (Sun, 29 Sep 2013)
Log Message:
-----------
In the interests of committing what I have on my disk to the svn
repository, commit the current snapshot of build_projects for this
PLplot release. Note, it has actually been a while since I have been
working on this subproject so this result should be considered
experimental and may not even currently work.  But at least
it preserves a snapshot of my work and will provide a starting
point for the next time I work on build_projects.

Modified Paths:
--------------
    trunk/cmake/build_projects/CMakeLists.txt
    trunk/cmake/build_projects/README
    trunk/cmake/build_projects/docbook-xml/CMakeLists.txt
    trunk/cmake/build_projects/docbook-xml/bp.cmake
    trunk/cmake/build_projects/docbook-xsl/bp.cmake
    trunk/cmake/build_projects/gtk-doc/bp.cmake
    trunk/cmake/build_projects/gtk_packages_add.xml
    trunk/cmake/build_projects/libxml2/bp.cmake
    trunk/cmake/build_projects/patch_gtk_packages.xml

Modified: trunk/cmake/build_projects/CMakeLists.txt
===================================================================
--- trunk/cmake/build_projects/CMakeLists.txt	2013-09-29 20:54:34 UTC (rev 12551)
+++ trunk/cmake/build_projects/CMakeLists.txt	2013-09-29 20:59:14 UTC (rev 12552)
@@ -166,17 +166,22 @@
     determine_msys_path(MSYS_CMAKE_RC_COMPILER "${CMAKE_RC_COMPILER}")
     list(APPEND BP_CMAKE_COMMAND -DCMAKE_RC_COMPILER:FILEPATH=${MSYS_CMAKE_RC_COMPILER})
   endif(CMAKE_RC_COMPILER)
+  # No extra dropped dependencies for the MSYS_PLATFORM case.
+  set(extra_ignored_dependencies_list)
 else(MSYS_PLATFORM)
   # Propagate the overall CMake generator and install prefix to all CMake-based
   # software project builds.
   set(BP_CMAKE_COMMAND ${CMAKE_COMMAND} "-G${CMAKE_GENERATOR}" -DCMAKE_INSTALL_PREFIX:PATH=${CMAKE_INSTALL_PREFIX})
   set(BP_CMAKE_INSTALL_PREFIX ${CMAKE_INSTALL_PREFIX})
+
+  # Drop xmlcatalog-wrapper dependency since that is only suitable for
+  # the MSYS_PLATFORM case.
+  set(extra_ignored_dependencies_list xmlcatalog-wrapper)
 endif(MSYS_PLATFORM)
 
 # Propagate the install prefix to autotools-based builds
 set(BP_CONFIGURE_COMMAND configure --prefix=${BP_CMAKE_INSTALL_PREFIX})
 
-
 if(CMAKE_VERBOSE_MAKEFILE)
   # Not sure whether all contemplated back-ends support this or not, but
   # most should.

Modified: trunk/cmake/build_projects/README
===================================================================
--- trunk/cmake/build_projects/README	2013-09-29 20:54:34 UTC (rev 12551)
+++ trunk/cmake/build_projects/README	2013-09-29 20:59:14 UTC (rev 12552)
@@ -126,11 +126,40 @@
 
 Linux "Unix Makefiles"
 
+--------------
+# Source this file to setup a Linux build_packages build.
+# Put latest CMake on PATH
+PATH=/home/software/cmake/install/bin:$PATH
+
+# Put buildtools that have been built and installed by build_packages on PATH.
+PATH=/home/wine/newstart/build_script/install-linux_buildtools/bin:$PATH
+
+# Put Linux install directory on PATH (so that, e.g., the wxwidgets 
+# configuration tool will be found.
+PATH=/home/wine/newstart/build_script/install-linux/bin:$PATH
+
+# Make *.pc files that are installed by a build_packages build accessible to
+# pkg-config
+export PKG_CONFIG_PATH=/home/wine/newstart/build_script/install-linux/lib/pkgconfig/:/home/wine/newstart/build_script/install-linux/share/pkgconfig
+
+# As temporary measure also use system-installed *.pc files for dependencies
+# which are currently not built.  Put these at the end of PKG_CONFIG_PATH
+# so they are only used as a last resort.
+PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/usr/lib/x86_64-linux-gnu/pkgconfig:/usr/share/pkgconfig
+--------------
+
 wine@raven> mkdir -p /home/wine/newstart/build_script/build_dir-linux
 wine@raven> cd /home/wine/newstart/build_script/build_dir-linux
 wine@raven> rm -rf /home/wine/newstart/build_script/build_dir-linux/*
+wine@raven> cmake -G"Unix Makefiles" -DCMAKE_VERBOSE_MAKEFILE=ON -DCMAKE_INSTALL_PREFIX:PATH=/home/wine/newstart/build_script/install-linux ~software/plplot_svn/HEAD/plplot_allura/cmake/build_projects >& cmake.out
 wine@raven> cmake -G"Unix Makefiles" -DCMAKE_INSTALL_PREFIX:PATH=/home/wine/newstart/build_script/install-linux ~software/plplot_svn/HEAD/plplot_allura/cmake/build_projects >& cmake.out
-wine@raven> make VERBOSE=1 build_plplot >& build_plplot.out
+# wxwidgets and pango are soft dependencies of PLplot which add value to
+# its build.
+wine@raven> make build_wxwidgets >& build_wxwidgets.out
+wine@raven> make build_pango >& build_pango.out
+# Build plplot using the above soft dependencies as well as some hard
+# dependencies it knows about.
+wine@raven> make build_plplot >& build_plplot.out
 
 Windows "MinGW Makefiles"
 
@@ -239,6 +268,10 @@
 # can be configured with a template such as libffi, we use gtk_packages_add.xml
 # (under version control) as follows:
 
-./gtk_transform.py "libffi" 1 <gtk_packages_add.xml 1>| add_packages.data
-./gtk_transform.py "intltool" 1 <gtk_packages_add.xml 1>> add_packages.data
+rm -f add_packages.data
+touch add_packages.data
+PACKAGE_LIST="libffi intltool pixman gperf"
+for PACKAGE in $PACKAGE_LIST; do
+  ./gtk_transform.py $PACKAGE 1 <gtk_packages_add.xml 1>> add_packages.data
+done
 cmake -DFILENAME:FILEPATH=add_packages.data -P configure_bp.cmake

Modified: trunk/cmake/build_projects/docbook-xml/CMakeLists.txt
===================================================================
--- trunk/cmake/build_projects/docbook-xml/CMakeLists.txt	2013-09-29 20:54:34 UTC (rev 12551)
+++ trunk/cmake/build_projects/docbook-xml/CMakeLists.txt	2013-09-29 20:59:14 UTC (rev 12552)
@@ -130,9 +130,13 @@
 
 install_xml_catalog(commands "docbook")
 
+# Do this for every pattern above so using the catalog file as the catalog
+# is equivalent to using the docbook file as the catalog.
 set(commands
+"delegatePublic" "-//OASIS//DTD DocBook XML" "file://${CATALOG_CMAKE_INSTALL_PREFIX}/etc/xml/docbook"
+"delegatePublic" "-//OASIS//DTD XML Exchange" "file://${CATALOG_CMAKE_INSTALL_PREFIX}/etc/xml/docbook"
 "delegatePublic" "-//OASIS//ENTITIES DocBook XML" "file://${CATALOG_CMAKE_INSTALL_PREFIX}/etc/xml/docbook"
-"delegatePublic" "-//OASIS//DTD DocBook XML" "file://${CATALOG_CMAKE_INSTALL_PREFIX}/etc/xml/docbook"
+"delegatePublic" "-//OASIS//ELEMENTS DocBook XML" "file://${CATALOG_CMAKE_INSTALL_PREFIX}/etc/xml/docbook"
 "delegateSystem" "http://www.oasis-open.org/docbook/" "file://${CATALOG_CMAKE_INSTALL_PREFIX}/etc/xml/docbook"
 "delegateURI" "http://www.oasis-open.org/docbook/" "file://${CATALOG_CMAKE_INSTALL_PREFIX}/etc/xml/docbook"
 )
@@ -162,6 +166,9 @@
     )
   install_xml_catalog(commands "docbook")
 
+  # Do this for every pattern above except the "public" one which has already
+  # been taken care of so using the catalog file as the catalog
+  # is equivalent to using the docbook file as the catalog.
   set(commands
     "delegateSystem" "http://www.oasis-open.org/docbook/xml/${DTDVERSION}/" "file://${CATALOG_CMAKE_INSTALL_PREFIX}/etc/xml/docbook"
     "delegateURI" "http://www.oasis-open.org/docbook/xml/${DTDVERSION}/" "file://${CATALOG_CMAKE_INSTALL_PREFIX}/etc/xml/docbook"

Modified: trunk/cmake/build_projects/docbook-xml/bp.cmake
===================================================================
--- trunk/cmake/build_projects/docbook-xml/bp.cmake	2013-09-29 20:54:34 UTC (rev 12551)
+++ trunk/cmake/build_projects/docbook-xml/bp.cmake	2013-09-29 20:59:14 UTC (rev 12552)
@@ -32,7 +32,7 @@
 
 # List of dependencies (most of which are build tools) which should be
 # ignored.
-set(BP_ignored_dependencies_LIST pkg-config;bison;flex;python2-devel;libXft)
+set(BP_ignored_dependencies_LIST pkg-config;bison;flex;python2-devel;libXft ${extra_ignored_dependencies_list})
 
 set(docbook-xml_dependencies_LIST libxml2)
 # Remove dependencies that should be ignored.

Modified: trunk/cmake/build_projects/docbook-xsl/bp.cmake
===================================================================
--- trunk/cmake/build_projects/docbook-xsl/bp.cmake	2013-09-29 20:54:34 UTC (rev 12551)
+++ trunk/cmake/build_projects/docbook-xsl/bp.cmake	2013-09-29 20:59:14 UTC (rev 12552)
@@ -32,7 +32,7 @@
 
 # List of dependencies (most of which are build tools) which should be
 # ignored.
-set(BP_ignored_dependencies_LIST pkg-config;bison;flex;python2-devel;libXft)
+set(BP_ignored_dependencies_LIST pkg-config;bison;flex;python2-devel;libXft ${extra_ignored_dependencies_list})
 
 set(docbook-xsl_dependencies_LIST libxml2)
 # Remove dependencies that should be ignored.

Modified: trunk/cmake/build_projects/gtk-doc/bp.cmake
===================================================================
--- trunk/cmake/build_projects/gtk-doc/bp.cmake	2013-09-29 20:54:34 UTC (rev 12551)
+++ trunk/cmake/build_projects/gtk-doc/bp.cmake	2013-09-29 20:59:14 UTC (rev 12552)
@@ -84,7 +84,7 @@
   DEPENDS ${${BP_PACKAGE}_dependencies_targets}
   URL ${${BP_PACKAGE}_URL}
   URL_HASH ${${BP_PACKAGE}_DOWNLOAD_HASH_TYPE}=${${BP_PACKAGE}_DOWNLOAD_HASH}
-  CONFIGURE_COMMAND ${ENV_EXECUTABLE} PATH=${BP_PATH} ${${BP_PACKAGE}_SET_CFLAGS} ${source_PATH}/${BP_CONFIGURE_COMMAND} --with-xml-catalog=${BP_CMAKE_INSTALL_PREFIX}/etc/xml/catalog
+  CONFIGURE_COMMAND ${ENV_EXECUTABLE} PATH=${BP_PATH} ${${BP_PACKAGE}_SET_CFLAGS} ${source_PATH}/${BP_CONFIGURE_COMMAND} --with-xml-catalog=${CMAKE_INSTALL_PREFIX}/etc/xml/catalog
   BUILD_COMMAND ${ENV_EXECUTABLE} PATH=${BP_PATH} ${BP_PARALLEL_MAKE_COMMAND} 
   BUILD_IN_SOURCE OFF
   INSTALL_COMMAND ${ENV_EXECUTABLE} PATH=${BP_PATH} ${BP_PARALLEL_MAKE_COMMAND}  install

Modified: trunk/cmake/build_projects/gtk_packages_add.xml
===================================================================
--- trunk/cmake/build_projects/gtk_packages_add.xml	2013-09-29 20:54:34 UTC (rev 12551)
+++ trunk/cmake/build_projects/gtk_packages_add.xml	2013-09-29 20:59:14 UTC (rev 12552)
@@ -23,6 +23,14 @@
 -->
   <autotools id="libxml2" makeargs="PYTHON_SITE_PACKAGES=${BP_CMAKE_INSTALL_PREFIX}/lib/python${PYTHON_VERSION}/site-packages">
     <branch hash="md5:9c0cfef285d5c4a5c80d00904ddab380" module="sources/libxml2-2.9.1.tar.gz" repo="http://xmlsoft.org/" size="983500" version="2.9.1"/>
+<!-- This package (which installs nothing on Unix platforms) is
+required as a workaround for the xmlcatalog argument mangling that
+occurs when xmlcatalog (linked with the MinGW runtime as per this
+build of libxml2) is called from a programme (e.g., bash.exe) which is
+linked with the MSYS runtime -->
+    <dependencies>
+      <dep package="xmlcatalog-wrapper"/>
+    </dependencies>
   </autotools>
   <autotools id="libxslt">
     <branch hash="md5:9667bf6f9310b957254fdcf6596600b7" module="sources/libxslt-1.1.28.tar.gz" repo="http://xmlsoft.org/" size="983500" version="1.1.28"/>

Modified: trunk/cmake/build_projects/libxml2/bp.cmake
===================================================================
--- trunk/cmake/build_projects/libxml2/bp.cmake	2013-09-29 20:54:34 UTC (rev 12551)
+++ trunk/cmake/build_projects/libxml2/bp.cmake	2013-09-29 20:59:14 UTC (rev 12552)
@@ -41,7 +41,7 @@
 # ignored.
 set(BP_ignored_dependencies_LIST pkg-config;bison;flex;python2-devel;libXft ${extra_ignored_dependencies_list})
 
-set(libxml2_dependencies_LIST )
+set(libxml2_dependencies_LIST xmlcatalog-wrapper)
 # Remove dependencies that should be ignored.
 if(libxml2_dependencies_LIST)
   list(REMOVE_ITEM libxml2_dependencies_LIST ${BP_ignored_dependencies_LIST})

Modified: trunk/cmake/build_projects/patch_gtk_packages.xml
===================================================================
--- trunk/cmake/build_projects/patch_gtk_packages.xml	2013-09-29 20:54:34 UTC (rev 12551)
+++ trunk/cmake/build_projects/patch_gtk_packages.xml	2013-09-29 20:59:14 UTC (rev 12552)
@@ -1,11 +1,11 @@
 --- gtk_packages_3.9.4.xml_original	2013-08-04 10:48:34.157911200 -0700
-+++ gtk_packages_3.9.4.xml	2013-08-04 10:59:20.797600533 -0700
++++ gtk_packages_3.9.4.xml	2013-08-07 16:08:44.571614474 -0700
 @@ -640,11 +640,13 @@
    <autotools id="gnome-common">
      <branch hash="sha256:2af2d97010d2a9aeb3b99dd2ce07d1ef023e15a27b412ffe4f067f016ff7117b" module="gnome-common/3.7/gnome-common-3.7.4.tar.xz" repo="http://download.gnome.org/sources/" size="151864" version="3.7.4"/>
    </autotools>
 -  <autotools id="gtk-doc">
-+  <autotools autogenargs="--with-xml-catalog=${BP_CMAKE_INSTALL_PREFIX}/etc/xml/catalog" id="gtk-doc">
++  <autotools autogenargs="--with-xml-catalog=${CMAKE_INSTALL_PREFIX}/etc/xml/catalog" id="gtk-doc">
      <branch hash="sha256:27df247fa828433a9390368e2088cc22f954f2ce1f255ddbd12ab6e027b12e68" module="gtk-doc/1.19/gtk-doc-1.19.tar.xz" repo="http://download.gnome.org/sources/" size="597880" version="1.19"/>
      <dependencies>
        <dep package="libxslt"/>

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Plplot-cvs] SF.net SVN: plplot:[12551] trunk/cmake/build_projects

[<ai...@us...>]

Revision: 12551
          http://sourceforge.net/p/plplot/code/12551
Author:   airwin
Date:     2013-09-29 20:54:34 +0000 (Sun, 29 Sep 2013)
Log Message:
-----------
Preliminary commit of incomplete subversion build subproject.

Added Paths:
-----------
    trunk/cmake/build_projects/subversion/
    trunk/cmake/build_projects/subversion/bp.cmake

Added: trunk/cmake/build_projects/subversion/bp.cmake
===================================================================
--- trunk/cmake/build_projects/subversion/bp.cmake	                        (rev 0)
+++ trunk/cmake/build_projects/subversion/bp.cmake	2013-09-29 20:54:34 UTC (rev 12551)
@@ -0,0 +1,95 @@
+# subversion/bp.cmake
+# This file should be included directly or indirectly from a top-level
+# CMakeLists.txt file to configure the build of subversion.
+
+# Copyright (C) 2013 Alan W. Irwin
+
+# This file is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+
+# This file is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+
+# You should have received a copy of the GNU Lesser General Public
+# License along with this file; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+# The top-level CMakeLists.txt file that includes this file should
+# have run "include(ExternalProject)" and set EP_BASE variable (and
+# corresponding directory property) as well as various BP variables
+# used below that configure how the External_Project functions
+# operate.
+
+set(BP_PACKAGE subversion)
+
+# Protect against configuring a build twice in one CMake call
+if(${BP_PACKAGE}_configured)
+  return()
+endif(${BP_PACKAGE}_configured)
+set(${BP_PACKAGE}_configured ON)
+
+# Data that is related to downloads.
+set(${BP_PACKAGE}_URL http://apache.parentingamerica.com/subversion/subversion-1.7.10.tar.bz2)
+# TEMPORARY local version for debugging
+set(${BP_PACKAGE}_URL /home/software/${BP_PACKAGE}/${BP_PACKAGE}-1.7.10.tar.bz2)
+set(${BP_PACKAGE}_URL_MD5 4088a77e14232876c9b4ff1541e6e200)
+
+# Data that is related to the PATH that must be used.
+if(MSYS_PLATFORM)
+  set(BP_PATH_NODLL "${BP_PATH}")
+  set(BP_PATH "${EP_BASE}/Build/build_${BP_PACKAGE}/dll;${BP_PATH_NODLL}")
+  determine_msys_path(BP_PATH "${BP_PATH}")
+  # Must have all elements of env command in MSYS platform form
+  determine_msys_path(source_PATH "${EP_BASE}/Source/build_${BP_PACKAGE}")
+else(MSYS_PLATFORM)
+  set(source_PATH "${EP_BASE}/Source/build_${BP_PACKAGE}")
+endif(MSYS_PLATFORM)
+#message(STATUS "modified BP_PATH for ${BP_PACKAGE} = ${BP_PATH}")
+
+ExternalProject_Add(
+  build_${BP_PACKAGE}
+  URL ${${BP_PACKAGE}_URL}
+  URL_MD5 ${${BP_PACKAGE}_URL_MD5}
+  CONFIGURE_COMMAND ${ENV_EXECUTABLE} PATH=${BP_PATH} ${source_PATH}/${BP_CONFIGURE_COMMAND}
+  BUILD_COMMAND ${ENV_EXECUTABLE} PATH=${BP_PATH} ${BP_PARALLEL_MAKE_COMMAND}
+  INSTALL_COMMAND ${ENV_EXECUTABLE} PATH=${BP_PATH} ${BP_PARALLEL_MAKE_COMMAND} install
+  TEST_BEFORE_INSTALL OFF
+  TEST_COMMAND ${ENV_EXECUTABLE} PATH=${BP_PATH} ${BP_PARALLEL_MAKE_COMMAND} check
+  # STEP_TARGETS download download_extra_source mkdir_fix configure build install test
+  )
+
+# Add custom command to run the special get-deps.sh script
+# to update the source tree with the required
+# dependent library sources to be included in the subversion
+# build that are recommended by the subversion project.
+ExternalProject_Add_Step(
+  build_${BP_PACKAGE} download_extra_source
+  COMMENT "Custom updating of ${BP_PACKAGE} with downloaded source code"
+  DEPENDEES download
+  DEPENDERS configure
+  COMMAND ${ENV_EXECUTABLE} PATH=${BP_PATH} ${BASH_EXECUTABLE} get-deps.sh
+  # N.B. no file dependencies are worthwhile since all data
+  # are automatically downloaded.
+  WORKING_DIRECTORY "${EP_BASE}/Source/build_${BP_PACKAGE}"
+  )
+
+# Add mkdir fix noted at
+# http://mail-archives.apache.org/mod_mbox/subversion-users/201109.mbox/<838...@me...>
+# Why in the world is this simple fix not yet propagated upstream?
+ExternalProject_Add_Step(
+  build_${BP_PACKAGE} mkdir_fix
+  COMMENT "Fix 'mkdir serf/auth' issue"
+  DEPENDEES configure
+  DEPENDERS build
+  COMMAND mkdir serf/auth
+  WORKING_DIRECTORY "${EP_BASE}/Build/build_${BP_PACKAGE}"
+  )
+
+list(APPEND build_target_LIST build_${BP_PACKAGE})
+# Restore BP_PATH to original state.
+set(BP_PATH "${BP_ORIGINAL_NATIVE_PATH}")
+#message(STATUS "${BP_PACKAGE} restored original BP_PATH = ${BP_PATH}")

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Plplot-cvs] SF.net SVN: plplot:[12550] trunk/cmake/build_projects/itstool

[<ai...@us...>]

Revision: 12550
          http://sourceforge.net/p/plplot/code/12550
Author:   airwin
Date:     2013-09-29 20:53:06 +0000 (Sun, 29 Sep 2013)
Log Message:
-----------
Patch itstool with reconfigured autotools-based build system

Modified Paths:
--------------
    trunk/cmake/build_projects/itstool/bp.cmake

Added Paths:
-----------
    trunk/cmake/build_projects/itstool/itstool-1.2.0-python-location-fixes.patch

Modified: trunk/cmake/build_projects/itstool/bp.cmake
===================================================================
--- trunk/cmake/build_projects/itstool/bp.cmake	2013-09-29 20:41:52 UTC (rev 12549)
+++ trunk/cmake/build_projects/itstool/bp.cmake	2013-09-29 20:53:06 UTC (rev 12550)
@@ -64,6 +64,7 @@
 set(${BP_PACKAGE}_URL http://files.itstool.org/itstool/itstool-1.2.0.tar.bz2)
 set(${BP_PACKAGE}_DOWNLOAD_HASH_TYPE SHA256)
 set(${BP_PACKAGE}_DOWNLOAD_HASH 46fed63fb89c72dbfc03097b4477084ff05ad6f171212d8f1f1546ea543978aa)
+set(${BP_PACKAGE}_PATCH itstool-1.2.0-python-location-fixes.patch)
 
 # Data that is related to the PATH that must be used.
 if(MSYS_PLATFORM)
@@ -84,6 +85,7 @@
   DEPENDS ${${BP_PACKAGE}_dependencies_targets}
   URL ${${BP_PACKAGE}_URL}
   URL_HASH ${${BP_PACKAGE}_DOWNLOAD_HASH_TYPE}=${${BP_PACKAGE}_DOWNLOAD_HASH}
+  PATCH_COMMAND ${PATCH_EXECUTABLE} -p1 < ${CMAKE_SOURCE_DIR}/itstool/${${BP_PACKAGE}_PATCH}
   CONFIGURE_COMMAND ${ENV_EXECUTABLE} PATH=${BP_PATH} ${${BP_PACKAGE}_SET_CFLAGS} ${source_PATH}/${BP_CONFIGURE_COMMAND} 
   BUILD_COMMAND ${ENV_EXECUTABLE} PATH=${BP_PATH} ${BP_PARALLEL_MAKE_COMMAND} 
   BUILD_IN_SOURCE OFF

Added: trunk/cmake/build_projects/itstool/itstool-1.2.0-python-location-fixes.patch
===================================================================
--- trunk/cmake/build_projects/itstool/itstool-1.2.0-python-location-fixes.patch	                        (rev 0)
+++ trunk/cmake/build_projects/itstool/itstool-1.2.0-python-location-fixes.patch	2013-09-29 20:53:06 UTC (rev 12550)
@@ -0,0 +1,1347 @@
+diff -Naur build_itstool_old/Makefile.in build_itstool/Makefile.in
+--- build_itstool_old/Makefile.in	2012-06-24 07:29:02.000000000 -0700
++++ build_itstool/Makefile.in	2013-08-07 15:57:47.136103712 -0700
+@@ -1,9 +1,9 @@
+-# Makefile.in generated by automake 1.11.1 from Makefile.am.
++# Makefile.in generated by automake 1.11.6 from Makefile.am.
+ # @configure_input@
+ 
+ # Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002,
+-# 2003, 2004, 2005, 2006, 2007, 2008, 2009  Free Software Foundation,
+-# Inc.
++# 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software
++# Foundation, Inc.
+ # This Makefile.in is free software; the Free Software Foundation
+ # gives unlimited permission to copy and/or distribute it,
+ # with or without modifications, as long as this notice is preserved.
+@@ -16,6 +16,23 @@
+ @SET_MAKE@
+ 
+ VPATH = @srcdir@
++am__make_dryrun = \
++  { \
++    am__dry=no; \
++    case $$MAKEFLAGS in \
++      *\\[\ \	]*) \
++        echo 'am--echo: ; @echo "AM"  OK' | $(MAKE) -f - 2>/dev/null \
++          | grep '^AM OK$$' >/dev/null || am__dry=yes;; \
++      *) \
++        for am__flg in $$MAKEFLAGS; do \
++          case $$am__flg in \
++            *=*|--*) ;; \
++            *n*) am__dry=yes; break;; \
++          esac; \
++        done;; \
++    esac; \
++    test $$am__dry = yes; \
++  }
+ pkgdatadir = $(datadir)/@PACKAGE@
+ pkgincludedir = $(includedir)/@PACKAGE@
+ pkglibdir = $(libdir)/@PACKAGE@
+@@ -67,6 +84,12 @@
+ am__base_list = \
+   sed '$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;s/\n/ /g' | \
+   sed '$$!N;$$!N;$$!N;$$!N;s/\n/ /g'
++am__uninstall_files_from_dir = { \
++  test -z "$$files" \
++    || { test ! -d "$$dir" && test ! -f "$$dir" && test ! -r "$$dir"; } \
++    || { echo " ( cd '$$dir' && rm -f" $$files ")"; \
++         $(am__cd) "$$dir" && rm -f $$files; }; \
++  }
+ am__installdirs = "$(DESTDIR)$(bindir)" "$(DESTDIR)$(man1dir)"
+ SCRIPTS = $(bin_SCRIPTS)
+ SOURCES =
+@@ -78,6 +101,11 @@
+ 	install-pdf-recursive install-ps-recursive install-recursive \
+ 	installcheck-recursive installdirs-recursive pdf-recursive \
+ 	ps-recursive uninstall-recursive
++am__can_run_installinfo = \
++  case $$AM_UPDATE_INFO_DIR in \
++    n|no|NO) false;; \
++    *) (install-info --version) >/dev/null 2>&1;; \
++  esac
+ man1dir = $(mandir)/man1
+ NROFF = nroff
+ MANS = $(man_MANS)
+@@ -93,9 +121,11 @@
+ distdir = $(PACKAGE)-$(VERSION)
+ top_distdir = $(distdir)
+ am__remove_distdir = \
+-  { test ! -d "$(distdir)" \
+-    || { find "$(distdir)" -type d ! -perm -200 -exec chmod u+w {} ';' \
+-         && rm -fr "$(distdir)"; }; }
++  if test -d "$(distdir)"; then \
++    find "$(distdir)" -type d ! -perm -200 -exec chmod u+w {} ';' \
++      && rm -rf "$(distdir)" \
++      || { sleep 5 && rm -rf "$(distdir)"; }; \
++  else :; fi
+ am__relativize = \
+   dir0=`pwd`; \
+   sed_first='s,^\([^/]*\)/.*$$,\1,'; \
+@@ -124,6 +154,8 @@
+ GZIP_ENV = --best
+ DIST_ARCHIVES = $(distdir).tar.bz2
+ distuninstallcheck_listfiles = find . -type f -print
++am__distuninstallcheck_listfiles = $(distuninstallcheck_listfiles) \
++  | sed 's|^\./|$(prefix)/|' | grep -v '$(infodir)/dir$$'
+ distcleancheck_listfiles = find . -type f -print
+ ACLOCAL = @ACLOCAL@
+ AMTAR = @AMTAR@
+@@ -155,6 +187,7 @@
+ PACKAGE_URL = @PACKAGE_URL@
+ PACKAGE_VERSION = @PACKAGE_VERSION@
+ PATH_SEPARATOR = @PATH_SEPARATOR@
++PYTHON = @PYTHON@
+ SET_MAKE = @SET_MAKE@
+ SHELL = @SHELL@
+ STRIP = @STRIP@
+@@ -212,7 +245,7 @@
+ all: all-recursive
+ 
+ .SUFFIXES:
+-am--refresh:
++am--refresh: Makefile
+ 	@:
+ $(srcdir)/Makefile.in:  $(srcdir)/Makefile.am  $(am__configure_deps)
+ 	@for dep in $?; do \
+@@ -252,8 +285,11 @@
+ 	cd $(top_builddir) && $(SHELL) ./config.status $@
+ install-binSCRIPTS: $(bin_SCRIPTS)
+ 	@$(NORMAL_INSTALL)
+-	test -z "$(bindir)" || $(MKDIR_P) "$(DESTDIR)$(bindir)"
+ 	@list='$(bin_SCRIPTS)'; test -n "$(bindir)" || list=; \
++	if test -n "$$list"; then \
++	  echo " $(MKDIR_P) '$(DESTDIR)$(bindir)'"; \
++	  $(MKDIR_P) "$(DESTDIR)$(bindir)" || exit 1; \
++	fi; \
+ 	for p in $$list; do \
+ 	  if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
+ 	  if test -f "$$d$$p"; then echo "$$d$$p"; echo "$$p"; else :; fi; \
+@@ -281,16 +317,21 @@
+ 	@list='$(bin_SCRIPTS)'; test -n "$(bindir)" || exit 0; \
+ 	files=`for p in $$list; do echo "$$p"; done | \
+ 	       sed -e 's,.*/,,;$(transform)'`; \
+-	test -n "$$list" || exit 0; \
+-	echo " ( cd '$(DESTDIR)$(bindir)' && rm -f" $$files ")"; \
+-	cd "$(DESTDIR)$(bindir)" && rm -f $$files
++	dir='$(DESTDIR)$(bindir)'; $(am__uninstall_files_from_dir)
+ install-man1: $(man_MANS)
+ 	@$(NORMAL_INSTALL)
+-	test -z "$(man1dir)" || $(MKDIR_P) "$(DESTDIR)$(man1dir)"
+-	@list=''; test -n "$(man1dir)" || exit 0; \
+-	{ for i in $$list; do echo "$$i"; done; \
+-	l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \
+-	  sed -n '/\.1[a-z]*$$/p'; \
++	@list1=''; \
++	list2='$(man_MANS)'; \
++	test -n "$(man1dir)" \
++	  && test -n "`echo $$list1$$list2`" \
++	  || exit 0; \
++	echo " $(MKDIR_P) '$(DESTDIR)$(man1dir)'"; \
++	$(MKDIR_P) "$(DESTDIR)$(man1dir)" || exit 1; \
++	{ for i in $$list1; do echo "$$i"; done;  \
++	if test -n "$$list2"; then \
++	  for i in $$list2; do echo "$$i"; done \
++	    | sed -n '/\.1[a-z]*$$/p'; \
++	fi; \
+ 	} | while read p; do \
+ 	  if test -f $$p; then d=; else d="$(srcdir)/"; fi; \
+ 	  echo "$$d$$p"; echo "$$p"; \
+@@ -319,9 +360,7 @@
+ 	  sed -n '/\.1[a-z]*$$/p'; \
+ 	} | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \
+ 	      -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \
+-	test -z "$$files" || { \
+-	  echo " ( cd '$(DESTDIR)$(man1dir)' && rm -f" $$files ")"; \
+-	  cd "$(DESTDIR)$(man1dir)" && rm -f $$files; }
++	dir='$(DESTDIR)$(man1dir)'; $(am__uninstall_files_from_dir)
+ 
+ # This directory's subdirectories are mostly independent; you can cd
+ # into them and run `make' without going through this Makefile.
+@@ -505,13 +544,10 @@
+ 	done
+ 	@list='$(DIST_SUBDIRS)'; for subdir in $$list; do \
+ 	  if test "$$subdir" = .; then :; else \
+-	    test -d "$(distdir)/$$subdir" \
+-	    || $(MKDIR_P) "$(distdir)/$$subdir" \
+-	    || exit 1; \
+-	  fi; \
+-	done
+-	@list='$(DIST_SUBDIRS)'; for subdir in $$list; do \
+-	  if test "$$subdir" = .; then :; else \
++	    $(am__make_dryrun) \
++	      || test -d "$(distdir)/$$subdir" \
++	      || $(MKDIR_P) "$(distdir)/$$subdir" \
++	      || exit 1; \
+ 	    dir1=$$subdir; dir2="$(distdir)/$$subdir"; \
+ 	    $(am__relativize); \
+ 	    new_distdir=$$reldir; \
+@@ -542,7 +578,11 @@
+ 	tardir=$(distdir) && $(am__tar) | GZIP=$(GZIP_ENV) gzip -c >$(distdir).tar.gz
+ 	$(am__remove_distdir)
+ dist-bzip2: distdir
+-	tardir=$(distdir) && $(am__tar) | bzip2 -9 -c >$(distdir).tar.bz2
++	tardir=$(distdir) && $(am__tar) | BZIP2=$${BZIP2--9} bzip2 -c >$(distdir).tar.bz2
++	$(am__remove_distdir)
++
++dist-lzip: distdir
++	tardir=$(distdir) && $(am__tar) | lzip -c $${LZIP_OPT--9} >$(distdir).tar.lz
+ 	$(am__remove_distdir)
+ 
+ dist-lzma: distdir
+@@ -550,7 +590,7 @@
+ 	$(am__remove_distdir)
+ 
+ dist-xz: distdir
+-	tardir=$(distdir) && $(am__tar) | xz -c >$(distdir).tar.xz
++	tardir=$(distdir) && $(am__tar) | XZ_OPT=$${XZ_OPT--e} xz -c >$(distdir).tar.xz
+ 	$(am__remove_distdir)
+ 
+ dist-tarZ: distdir
+@@ -567,7 +607,7 @@
+ 	$(am__remove_distdir)
+ 
+ dist dist-all: distdir
+-	tardir=$(distdir) && $(am__tar) | bzip2 -9 -c >$(distdir).tar.bz2
++	tardir=$(distdir) && $(am__tar) | BZIP2=$${BZIP2--9} bzip2 -c >$(distdir).tar.bz2
+ 	$(am__remove_distdir)
+ 
+ # This target untars the dist file and tries a VPATH configuration.  Then
+@@ -581,6 +621,8 @@
+ 	  bzip2 -dc $(distdir).tar.bz2 | $(am__untar) ;;\
+ 	*.tar.lzma*) \
+ 	  lzma -dc $(distdir).tar.lzma | $(am__untar) ;;\
++	*.tar.lz*) \
++	  lzip -dc $(distdir).tar.lz | $(am__untar) ;;\
+ 	*.tar.xz*) \
+ 	  xz -dc $(distdir).tar.xz | $(am__untar) ;;\
+ 	*.tar.Z*) \
+@@ -590,7 +632,7 @@
+ 	*.zip*) \
+ 	  unzip $(distdir).zip ;;\
+ 	esac
+-	chmod -R a-w $(distdir); chmod a+w $(distdir)
++	chmod -R a-w $(distdir); chmod u+w $(distdir)
+ 	mkdir $(distdir)/_build
+ 	mkdir $(distdir)/_inst
+ 	chmod a-w $(distdir)
+@@ -600,6 +642,7 @@
+ 	  && am__cwd=`pwd` \
+ 	  && $(am__cd) $(distdir)/_build \
+ 	  && ../configure --srcdir=.. --prefix="$$dc_install_base" \
++	    $(AM_DISTCHECK_CONFIGURE_FLAGS) \
+ 	    $(DISTCHECK_CONFIGURE_FLAGS) \
+ 	  && $(MAKE) $(AM_MAKEFLAGS) \
+ 	  && $(MAKE) $(AM_MAKEFLAGS) dvi \
+@@ -628,8 +671,16 @@
+ 	  list='$(DIST_ARCHIVES)'; for i in $$list; do echo $$i; done) | \
+ 	  sed -e 1h -e 1s/./=/g -e 1p -e 1x -e '$$p' -e '$$x'
+ distuninstallcheck:
+-	@$(am__cd) '$(distuninstallcheck_dir)' \
+-	&& test `$(distuninstallcheck_listfiles) | wc -l` -le 1 \
++	@test -n '$(distuninstallcheck_dir)' || { \
++	  echo 'ERROR: trying to run $@ with an empty' \
++	       '$$(distuninstallcheck_dir)' >&2; \
++	  exit 1; \
++	}; \
++	$(am__cd) '$(distuninstallcheck_dir)' || { \
++	  echo 'ERROR: cannot chdir into $(distuninstallcheck_dir)' >&2; \
++	  exit 1; \
++	}; \
++	test `$(am__distuninstallcheck_listfiles) | wc -l` -eq 0 \
+ 	   || { echo "ERROR: files left after uninstall:" ; \
+ 	        if test -n "$(DESTDIR)"; then \
+ 	          echo "  (check DESTDIR support)"; \
+@@ -663,10 +714,15 @@
+ 
+ installcheck: installcheck-recursive
+ install-strip:
+-	$(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
+-	  install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
+-	  `test -z '$(STRIP)' || \
+-	    echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install
++	if test -z '$(STRIP)'; then \
++	  $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
++	    install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
++	      install; \
++	else \
++	  $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
++	    install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
++	    "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'" install; \
++	fi
+ mostlyclean-generic:
+ 
+ clean-generic:
+@@ -755,19 +811,19 @@
+ .PHONY: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) CTAGS GTAGS \
+ 	all all-am am--refresh check check-am clean clean-generic \
+ 	ctags ctags-recursive dist dist-all dist-bzip2 dist-gzip \
+-	dist-lzma dist-shar dist-tarZ dist-xz dist-zip distcheck \
+-	distclean distclean-generic distclean-tags distcleancheck \
+-	distdir distuninstallcheck dvi dvi-am html html-am info \
+-	info-am install install-am install-binSCRIPTS install-data \
+-	install-data-am install-dvi install-dvi-am install-exec \
+-	install-exec-am install-html install-html-am install-info \
+-	install-info-am install-man install-man1 install-pdf \
+-	install-pdf-am install-ps install-ps-am install-strip \
+-	installcheck installcheck-am installdirs installdirs-am \
+-	maintainer-clean maintainer-clean-generic mostlyclean \
+-	mostlyclean-generic pdf pdf-am ps ps-am tags tags-recursive \
+-	uninstall uninstall-am uninstall-binSCRIPTS uninstall-man \
+-	uninstall-man1
++	dist-lzip dist-lzma dist-shar dist-tarZ dist-xz dist-zip \
++	distcheck distclean distclean-generic distclean-tags \
++	distcleancheck distdir distuninstallcheck dvi dvi-am html \
++	html-am info info-am install install-am install-binSCRIPTS \
++	install-data install-data-am install-dvi install-dvi-am \
++	install-exec install-exec-am install-html install-html-am \
++	install-info install-info-am install-man install-man1 \
++	install-pdf install-pdf-am install-ps install-ps-am \
++	install-strip installcheck installcheck-am installdirs \
++	installdirs-am maintainer-clean maintainer-clean-generic \
++	mostlyclean mostlyclean-generic pdf pdf-am ps ps-am tags \
++	tags-recursive uninstall uninstall-am uninstall-binSCRIPTS \
++	uninstall-man uninstall-man1
+ 
+ 
+ ChangeLog:
+diff -Naur build_itstool_old/aclocal.m4 build_itstool/aclocal.m4
+--- build_itstool_old/aclocal.m4	2012-06-24 07:29:01.000000000 -0700
++++ build_itstool/aclocal.m4	2013-08-07 15:57:46.232120890 -0700
+@@ -1,7 +1,8 @@
+-# generated automatically by aclocal 1.11.1 -*- Autoconf -*-
++# generated automatically by aclocal 1.11.6 -*- Autoconf -*-
+ 
+ # Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
+-# 2005, 2006, 2007, 2008, 2009  Free Software Foundation, Inc.
++# 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation,
++# Inc.
+ # This file is free software; the Free Software Foundation
+ # gives unlimited permission to copy and/or distribute it,
+ # with or without modifications, as long as this notice is preserved.
+@@ -13,18 +14,21 @@
+ 
+ m4_ifndef([AC_AUTOCONF_VERSION],
+   [m4_copy([m4_PACKAGE_VERSION], [AC_AUTOCONF_VERSION])])dnl
+-m4_if(m4_defn([AC_AUTOCONF_VERSION]), [2.66],,
+-[m4_warning([this file was generated for autoconf 2.66.
++m4_if(m4_defn([AC_AUTOCONF_VERSION]), [2.69],,
++[m4_warning([this file was generated for autoconf 2.69.
+ You have another version of autoconf.  It may work, but is not guaranteed to.
+ If you have problems, you may need to regenerate the build system entirely.
+ To do so, use the procedure documented by the package, typically `autoreconf'.])])
+ 
+-# Copyright (C) 2002, 2003, 2005, 2006, 2007, 2008  Free Software Foundation, Inc.
++# Copyright (C) 2002, 2003, 2005, 2006, 2007, 2008, 2011 Free Software
++# Foundation, Inc.
+ #
+ # This file is free software; the Free Software Foundation
+ # gives unlimited permission to copy and/or distribute it,
+ # with or without modifications, as long as this notice is preserved.
+ 
++# serial 1
++
+ # AM_AUTOMAKE_VERSION(VERSION)
+ # ----------------------------
+ # Automake X.Y traces this macro to ensure aclocal.m4 has been
+@@ -34,7 +38,7 @@
+ [am__api_version='1.11'
+ dnl Some users find AM_AUTOMAKE_VERSION and mistake it for a way to
+ dnl require some minimum version.  Point them to the right macro.
+-m4_if([$1], [1.11.1], [],
++m4_if([$1], [1.11.6], [],
+       [AC_FATAL([Do not call $0, use AM_INIT_AUTOMAKE([$1]).])])dnl
+ ])
+ 
+@@ -50,19 +54,21 @@
+ # Call AM_AUTOMAKE_VERSION and AM_AUTOMAKE_VERSION so they can be traced.
+ # This function is AC_REQUIREd by AM_INIT_AUTOMAKE.
+ AC_DEFUN([AM_SET_CURRENT_AUTOMAKE_VERSION],
+-[AM_AUTOMAKE_VERSION([1.11.1])dnl
++[AM_AUTOMAKE_VERSION([1.11.6])dnl
+ m4_ifndef([AC_AUTOCONF_VERSION],
+   [m4_copy([m4_PACKAGE_VERSION], [AC_AUTOCONF_VERSION])])dnl
+ _AM_AUTOCONF_VERSION(m4_defn([AC_AUTOCONF_VERSION]))])
+ 
+ # AM_AUX_DIR_EXPAND                                         -*- Autoconf -*-
+ 
+-# Copyright (C) 2001, 2003, 2005  Free Software Foundation, Inc.
++# Copyright (C) 2001, 2003, 2005, 2011 Free Software Foundation, Inc.
+ #
+ # This file is free software; the Free Software Foundation
+ # gives unlimited permission to copy and/or distribute it,
+ # with or without modifications, as long as this notice is preserved.
+ 
++# serial 1
++
+ # For projects using AC_CONFIG_AUX_DIR([foo]), Autoconf sets
+ # $ac_aux_dir to `$srcdir/foo'.  In other projects, it is set to
+ # `$srcdir', `$srcdir/..', or `$srcdir/../..'.
+@@ -247,12 +253,15 @@
+ done
+ echo "timestamp for $_am_arg" >`AS_DIRNAME(["$_am_arg"])`/stamp-h[]$_am_stamp_count])
+ 
+-# Copyright (C) 2001, 2003, 2005, 2008  Free Software Foundation, Inc.
++# Copyright (C) 2001, 2003, 2005, 2008, 2011 Free Software Foundation,
++# Inc.
+ #
+ # This file is free software; the Free Software Foundation
+ # gives unlimited permission to copy and/or distribute it,
+ # with or without modifications, as long as this notice is preserved.
+ 
++# serial 1
++
+ # AM_PROG_INSTALL_SH
+ # ------------------
+ # Define $install_sh.
+@@ -332,12 +341,15 @@
+ fi
+ ])
+ 
+-# Copyright (C) 2003, 2004, 2005, 2006  Free Software Foundation, Inc.
++# Copyright (C) 2003, 2004, 2005, 2006, 2011 Free Software Foundation,
++# Inc.
+ #
+ # This file is free software; the Free Software Foundation
+ # gives unlimited permission to copy and/or distribute it,
+ # with or without modifications, as long as this notice is preserved.
+ 
++# serial 1
++
+ # AM_PROG_MKDIR_P
+ # ---------------
+ # Check for `mkdir -p'.
+@@ -360,13 +372,14 @@
+ 
+ # Helper functions for option handling.                     -*- Autoconf -*-
+ 
+-# Copyright (C) 2001, 2002, 2003, 2005, 2008  Free Software Foundation, Inc.
++# Copyright (C) 2001, 2002, 2003, 2005, 2008, 2010 Free Software
++# Foundation, Inc.
+ #
+ # This file is free software; the Free Software Foundation
+ # gives unlimited permission to copy and/or distribute it,
+ # with or without modifications, as long as this notice is preserved.
+ 
+-# serial 4
++# serial 5
+ 
+ # _AM_MANGLE_OPTION(NAME)
+ # -----------------------
+@@ -374,13 +387,13 @@
+ [[_AM_OPTION_]m4_bpatsubst($1, [[^a-zA-Z0-9_]], [_])])
+ 
+ # _AM_SET_OPTION(NAME)
+-# ------------------------------
++# --------------------
+ # Set option NAME.  Presently that only means defining a flag for this option.
+ AC_DEFUN([_AM_SET_OPTION],
+ [m4_define(_AM_MANGLE_OPTION([$1]), 1)])
+ 
+ # _AM_SET_OPTIONS(OPTIONS)
+-# ----------------------------------
++# ------------------------
+ # OPTIONS is a space-separated list of Automake options.
+ AC_DEFUN([_AM_SET_OPTIONS],
+ [m4_foreach_w([_AM_Option], [$1], [_AM_SET_OPTION(_AM_Option)])])
+@@ -456,12 +469,14 @@
+ fi
+ AC_MSG_RESULT(yes)])
+ 
+-# Copyright (C) 2001, 2003, 2005  Free Software Foundation, Inc.
++# Copyright (C) 2001, 2003, 2005, 2011 Free Software Foundation, Inc.
+ #
+ # This file is free software; the Free Software Foundation
+ # gives unlimited permission to copy and/or distribute it,
+ # with or without modifications, as long as this notice is preserved.
+ 
++# serial 1
++
+ # AM_PROG_INSTALL_STRIP
+ # ---------------------
+ # One issue with vendor `install' (even GNU) is that you can't
+@@ -484,13 +499,13 @@
+ INSTALL_STRIP_PROGRAM="\$(install_sh) -c -s"
+ AC_SUBST([INSTALL_STRIP_PROGRAM])])
+ 
+-# Copyright (C) 2006, 2008  Free Software Foundation, Inc.
++# Copyright (C) 2006, 2008, 2010 Free Software Foundation, Inc.
+ #
+ # This file is free software; the Free Software Foundation
+ # gives unlimited permission to copy and/or distribute it,
+ # with or without modifications, as long as this notice is preserved.
+ 
+-# serial 2
++# serial 3
+ 
+ # _AM_SUBST_NOTMAKE(VARIABLE)
+ # ---------------------------
+@@ -499,13 +514,13 @@
+ AC_DEFUN([_AM_SUBST_NOTMAKE])
+ 
+ # AM_SUBST_NOTMAKE(VARIABLE)
+-# ---------------------------
++# --------------------------
+ # Public sister of _AM_SUBST_NOTMAKE.
+ AC_DEFUN([AM_SUBST_NOTMAKE], [_AM_SUBST_NOTMAKE($@)])
+ 
+ # Check how to create a tarball.                            -*- Autoconf -*-
+ 
+-# Copyright (C) 2004, 2005  Free Software Foundation, Inc.
++# Copyright (C) 2004, 2005, 2012 Free Software Foundation, Inc.
+ #
+ # This file is free software; the Free Software Foundation
+ # gives unlimited permission to copy and/or distribute it,
+@@ -527,10 +542,11 @@
+ # a tarball read from stdin.
+ #     $(am__untar) < result.tar
+ AC_DEFUN([_AM_PROG_TAR],
+-[# Always define AMTAR for backward compatibility.
+-AM_MISSING_PROG([AMTAR], [tar])
++[# Always define AMTAR for backward compatibility.  Yes, it's still used
++# in the wild :-(  We should find a proper way to deprecate it ...
++AC_SUBST([AMTAR], ['$${TAR-tar}'])
+ m4_if([$1], [v7],
+-     [am__tar='${AMTAR} chof - "$$tardir"'; am__untar='${AMTAR} xf -'],
++     [am__tar='$${TAR-tar} chof - "$$tardir"' am__untar='$${TAR-tar} xf -'],
+      [m4_case([$1], [ustar],, [pax],,
+               [m4_fatal([Unknown tar format])])
+ AC_MSG_CHECKING([how to create a $1 tar archive])
+diff -Naur build_itstool_old/configure build_itstool/configure
+--- build_itstool_old/configure	2012-06-24 07:29:01.000000000 -0700
++++ build_itstool/configure	2013-08-07 15:57:46.672112529 -0700
+@@ -1,11 +1,9 @@
+ #! /bin/sh
+ # Guess values for system-dependent variables and create Makefiles.
+-# Generated by GNU Autoconf 2.66 for itstool 1.2.0.
++# Generated by GNU Autoconf 2.69 for itstool 1.2.0.
+ #
+ #
+-# Copyright (C) 1992, 1993, 1994, 1995, 1996, 1998, 1999, 2000, 2001,
+-# 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 Free Software
+-# Foundation, Inc.
++# Copyright (C) 1992-1996, 1998-2012 Free Software Foundation, Inc.
+ #
+ #
+ # This configure script is free software; the Free Software Foundation
+@@ -89,6 +87,7 @@
+ IFS=" ""	$as_nl"
+ 
+ # Find who we are.  Look in the path if we contain no directory separator.
++as_myself=
+ case $0 in #((
+   *[\\/]* ) as_myself=$0 ;;
+   *) as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
+@@ -133,6 +132,31 @@
+ # CDPATH.
+ (unset CDPATH) >/dev/null 2>&1 && unset CDPATH
+ 
++# Use a proper internal environment variable to ensure we don't fall
++  # into an infinite loop, continuously re-executing ourselves.
++  if test x"${_as_can_reexec}" != xno && test "x$CONFIG_SHELL" != x; then
++    _as_can_reexec=no; export _as_can_reexec;
++    # We cannot yet assume a decent shell, so we have to provide a
++# neutralization value for shells without unset; and this also
++# works around shells that cannot unset nonexistent variables.
++# Preserve -v and -x to the replacement shell.
++BASH_ENV=/dev/null
++ENV=/dev/null
++(unset BASH_ENV) >/dev/null 2>&1 && unset BASH_ENV ENV
++case $- in # ((((
++  *v*x* | *x*v* ) as_opts=-vx ;;
++  *v* ) as_opts=-v ;;
++  *x* ) as_opts=-x ;;
++  * ) as_opts= ;;
++esac
++exec $CONFIG_SHELL $as_opts "$as_myself" ${1+"$@"}
++# Admittedly, this is quite paranoid, since all the known shells bail
++# out after a failed `exec'.
++$as_echo "$0: could not re-execute with $CONFIG_SHELL" >&2
++as_fn_exit 255
++  fi
++  # We don't want this to propagate to other subprocesses.
++          { _as_can_reexec=; unset _as_can_reexec;}
+ if test "x$CONFIG_SHELL" = x; then
+   as_bourne_compatible="if test -n \"\${ZSH_VERSION+set}\" && (emulate sh) >/dev/null 2>&1; then :
+   emulate sh
+@@ -166,7 +190,8 @@
+ else
+   exitcode=1; echo positional parameters were not saved.
+ fi
+-test x\$exitcode = x0 || exit 1"
++test x\$exitcode = x0 || exit 1
++test -x / || exit 1"
+   as_suggested="  as_lineno_1=";as_suggested=$as_suggested$LINENO;as_suggested=$as_suggested" as_lineno_1a=\$LINENO
+   as_lineno_2=";as_suggested=$as_suggested$LINENO;as_suggested=$as_suggested" as_lineno_2a=\$LINENO
+   eval 'test \"x\$as_lineno_1'\$as_run'\" != \"x\$as_lineno_2'\$as_run'\" &&
+@@ -210,14 +235,25 @@
+ 
+ 
+       if test "x$CONFIG_SHELL" != x; then :
+-  # We cannot yet assume a decent shell, so we have to provide a
+-	# neutralization value for shells without unset; and this also
+-	# works around shells that cannot unset nonexistent variables.
+-	BASH_ENV=/dev/null
+-	ENV=/dev/null
+-	(unset BASH_ENV) >/dev/null 2>&1 && unset BASH_ENV ENV
+-	export CONFIG_SHELL
+-	exec "$CONFIG_SHELL" "$as_myself" ${1+"$@"}
++  export CONFIG_SHELL
++             # We cannot yet assume a decent shell, so we have to provide a
++# neutralization value for shells without unset; and this also
++# works around shells that cannot unset nonexistent variables.
++# Preserve -v and -x to the replacement shell.
++BASH_ENV=/dev/null
++ENV=/dev/null
++(unset BASH_ENV) >/dev/null 2>&1 && unset BASH_ENV ENV
++case $- in # ((((
++  *v*x* | *x*v* ) as_opts=-vx ;;
++  *v* ) as_opts=-v ;;
++  *x* ) as_opts=-x ;;
++  * ) as_opts= ;;
++esac
++exec $CONFIG_SHELL $as_opts "$as_myself" ${1+"$@"}
++# Admittedly, this is quite paranoid, since all the known shells bail
++# out after a failed `exec'.
++$as_echo "$0: could not re-execute with $CONFIG_SHELL" >&2
++exit 255
+ fi
+ 
+     if test x$as_have_required = xno; then :
+@@ -319,6 +355,14 @@
+ 
+ 
+ } # as_fn_mkdir_p
++
++# as_fn_executable_p FILE
++# -----------------------
++# Test if FILE is an executable regular file.
++as_fn_executable_p ()
++{
++  test -f "$1" && test -x "$1"
++} # as_fn_executable_p
+ # as_fn_append VAR VALUE
+ # ----------------------
+ # Append the text in VALUE to the end of the definition contained in VAR. Take
+@@ -440,6 +484,10 @@
+   chmod +x "$as_me.lineno" ||
+     { $as_echo "$as_me: error: cannot create $as_me.lineno; rerun with a POSIX shell" >&2; as_fn_exit 1; }
+ 
++  # If we had to re-execute with $CONFIG_SHELL, we're ensured to have
++  # already done that, so ensure we don't try to do so again and fall
++  # in an infinite loop.  This has already happened in practice.
++  _as_can_reexec=no; export _as_can_reexec
+   # Don't try to exec as it changes $[0], causing all sort of problems
+   # (the dirname of $[0] is not the place where we might find the
+   # original and so on.  Autoconf is especially sensitive to this).
+@@ -474,16 +522,16 @@
+     # ... but there are two gotchas:
+     # 1) On MSYS, both `ln -s file dir' and `ln file dir' fail.
+     # 2) DJGPP < 2.04 has no symlinks; `ln -s' creates a wrapper executable.
+-    # In both cases, we have to default to `cp -p'.
++    # In both cases, we have to default to `cp -pR'.
+     ln -s conf$$.file conf$$.dir 2>/dev/null && test ! -f conf$$.exe ||
+-      as_ln_s='cp -p'
++      as_ln_s='cp -pR'
+   elif ln conf$$.file conf$$ 2>/dev/null; then
+     as_ln_s=ln
+   else
+-    as_ln_s='cp -p'
++    as_ln_s='cp -pR'
+   fi
+ else
+-  as_ln_s='cp -p'
++  as_ln_s='cp -pR'
+ fi
+ rm -f conf$$ conf$$.exe conf$$.dir/conf$$.file conf$$.file
+ rmdir conf$$.dir 2>/dev/null
+@@ -495,28 +543,8 @@
+   as_mkdir_p=false
+ fi
+ 
+-if test -x / >/dev/null 2>&1; then
+-  as_test_x='test -x'
+-else
+-  if ls -dL / >/dev/null 2>&1; then
+-    as_ls_L_option=L
+-  else
+-    as_ls_L_option=
+-  fi
+-  as_test_x='
+-    eval sh -c '\''
+-      if test -d "$1"; then
+-	test -d "$1/.";
+-      else
+-	case $1 in #(
+-	-*)set "./$1";;
+-	esac;
+-	case `ls -ld'$as_ls_L_option' "$1" 2>/dev/null` in #((
+-	???[sx]*):;;*)false;;esac;fi
+-    '\'' sh
+-  '
+-fi
+-as_executable_p=$as_test_x
++as_test_x='test -x'
++as_executable_p=as_fn_executable_p
+ 
+ # Sed expression to map a string onto a valid CPP name.
+ as_tr_cpp="eval sed 'y%*$as_cr_letters%P$as_cr_LETTERS%;s%[^_$as_cr_alnum]%_%g'"
+@@ -556,6 +584,7 @@
+ ac_subst_vars='LTLIBOBJS
+ LIBOBJS
+ DATADIR
++PYTHON
+ am__untar
+ am__tar
+ AMTAR
+@@ -623,7 +652,8 @@
+ '
+       ac_precious_vars='build_alias
+ host_alias
+-target_alias'
++target_alias
++PYTHON'
+ 
+ 
+ # Initialize some variables set by options.
+@@ -686,8 +716,9 @@
+   fi
+ 
+   case $ac_option in
+-  *=*)	ac_optarg=`expr "X$ac_option" : '[^=]*=\(.*\)'` ;;
+-  *)	ac_optarg=yes ;;
++  *=?*) ac_optarg=`expr "X$ac_option" : '[^=]*=\(.*\)'` ;;
++  *=)   ac_optarg= ;;
++  *)    ac_optarg=yes ;;
+   esac
+ 
+   # Accept the important Cygnus configure options, so we can diagnose typos.
+@@ -1027,7 +1058,7 @@
+     $as_echo "$as_me: WARNING: you should use --build, --host, --target" >&2
+     expr "x$ac_option" : ".*[^-._$as_cr_alnum]" >/dev/null &&
+       $as_echo "$as_me: WARNING: invalid host type: $ac_option" >&2
+-    : ${build_alias=$ac_option} ${host_alias=$ac_option} ${target_alias=$ac_option}
++    : "${build_alias=$ac_option} ${host_alias=$ac_option} ${target_alias=$ac_option}"
+     ;;
+ 
+   esac
+@@ -1078,8 +1109,6 @@
+ if test "x$host_alias" != x; then
+   if test "x$build_alias" = x; then
+     cross_compiling=maybe
+-    $as_echo "$as_me: WARNING: if you wanted to set the --build type, don't use --host.
+-    If a cross compiler is detected then cross compile mode will be used" >&2
+   elif test "x$build_alias" != "x$host_alias"; then
+     cross_compiling=yes
+   fi
+@@ -1235,6 +1264,12 @@
+    esac
+   cat <<\_ACEOF
+ 
++Some influential environment variables:
++  PYTHON      Path to the `python` command
++
++Use these variables to override the choices made by `configure' or to help
++it to find libraries and programs with nonstandard names/locations.
++
+ Report bugs to the package provider.
+ _ACEOF
+ ac_status=$?
+@@ -1299,9 +1334,9 @@
+ if $ac_init_version; then
+   cat <<\_ACEOF
+ itstool configure 1.2.0
+-generated by GNU Autoconf 2.66
++generated by GNU Autoconf 2.69
+ 
+-Copyright (C) 2010 Free Software Foundation, Inc.
++Copyright (C) 2012 Free Software Foundation, Inc.
+ This configure script is free software; the Free Software Foundation
+ gives unlimited permission to copy, distribute and modify it.
+ _ACEOF
+@@ -1316,7 +1351,7 @@
+ running configure, to aid debugging if configure makes a mistake.
+ 
+ It was created by itstool $as_me 1.2.0, which was
+-generated by GNU Autoconf 2.66.  Invocation command line was
++generated by GNU Autoconf 2.69.  Invocation command line was
+ 
+   $ $0 $@
+ 
+@@ -1711,7 +1746,7 @@
+ { $as_echo "$as_me:${as_lineno-$LINENO}: checking for a BSD-compatible install" >&5
+ $as_echo_n "checking for a BSD-compatible install... " >&6; }
+ if test -z "$INSTALL"; then
+-if test "${ac_cv_path_install+set}" = set; then :
++if ${ac_cv_path_install+:} false; then :
+   $as_echo_n "(cached) " >&6
+ else
+   as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
+@@ -1731,7 +1766,7 @@
+     # by default.
+     for ac_prog in ginstall scoinst install; do
+       for ac_exec_ext in '' $ac_executable_extensions; do
+-	if { test -f "$as_dir/$ac_prog$ac_exec_ext" && $as_test_x "$as_dir/$ac_prog$ac_exec_ext"; }; then
++	if as_fn_executable_p "$as_dir/$ac_prog$ac_exec_ext"; then
+ 	  if test $ac_prog = install &&
+ 	    grep dspmsg "$as_dir/$ac_prog$ac_exec_ext" >/dev/null 2>&1; then
+ 	    # AIX install.  It has an incompatible calling convention.
+@@ -1888,7 +1923,7 @@
+ set dummy ${ac_tool_prefix}strip; ac_word=$2
+ { $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+ $as_echo_n "checking for $ac_word... " >&6; }
+-if test "${ac_cv_prog_STRIP+set}" = set; then :
++if ${ac_cv_prog_STRIP+:} false; then :
+   $as_echo_n "(cached) " >&6
+ else
+   if test -n "$STRIP"; then
+@@ -1900,7 +1935,7 @@
+   IFS=$as_save_IFS
+   test -z "$as_dir" && as_dir=.
+     for ac_exec_ext in '' $ac_executable_extensions; do
+-  if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
++  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+     ac_cv_prog_STRIP="${ac_tool_prefix}strip"
+     $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+     break 2
+@@ -1928,7 +1963,7 @@
+ set dummy strip; ac_word=$2
+ { $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+ $as_echo_n "checking for $ac_word... " >&6; }
+-if test "${ac_cv_prog_ac_ct_STRIP+set}" = set; then :
++if ${ac_cv_prog_ac_ct_STRIP+:} false; then :
+   $as_echo_n "(cached) " >&6
+ else
+   if test -n "$ac_ct_STRIP"; then
+@@ -1940,7 +1975,7 @@
+   IFS=$as_save_IFS
+   test -z "$as_dir" && as_dir=.
+     for ac_exec_ext in '' $ac_executable_extensions; do
+-  if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
++  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+     ac_cv_prog_ac_ct_STRIP="strip"
+     $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+     break 2
+@@ -1981,7 +2016,7 @@
+ { $as_echo "$as_me:${as_lineno-$LINENO}: checking for a thread-safe mkdir -p" >&5
+ $as_echo_n "checking for a thread-safe mkdir -p... " >&6; }
+ if test -z "$MKDIR_P"; then
+-  if test "${ac_cv_path_mkdir+set}" = set; then :
++  if ${ac_cv_path_mkdir+:} false; then :
+   $as_echo_n "(cached) " >&6
+ else
+   as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
+@@ -1991,7 +2026,7 @@
+   test -z "$as_dir" && as_dir=.
+     for ac_prog in mkdir gmkdir; do
+ 	 for ac_exec_ext in '' $ac_executable_extensions; do
+-	   { test -f "$as_dir/$ac_prog$ac_exec_ext" && $as_test_x "$as_dir/$ac_prog$ac_exec_ext"; } || continue
++	   as_fn_executable_p "$as_dir/$ac_prog$ac_exec_ext" || continue
+ 	   case `"$as_dir/$ac_prog$ac_exec_ext" --version 2>&1` in #(
+ 	     'mkdir (GNU coreutils) '* | \
+ 	     'mkdir (coreutils) '* | \
+@@ -2032,7 +2067,7 @@
+ set dummy $ac_prog; ac_word=$2
+ { $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+ $as_echo_n "checking for $ac_word... " >&6; }
+-if test "${ac_cv_prog_AWK+set}" = set; then :
++if ${ac_cv_prog_AWK+:} false; then :
+   $as_echo_n "(cached) " >&6
+ else
+   if test -n "$AWK"; then
+@@ -2044,7 +2079,7 @@
+   IFS=$as_save_IFS
+   test -z "$as_dir" && as_dir=.
+     for ac_exec_ext in '' $ac_executable_extensions; do
+-  if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
++  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+     ac_cv_prog_AWK="$ac_prog"
+     $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+     break 2
+@@ -2072,7 +2107,7 @@
+ $as_echo_n "checking whether ${MAKE-make} sets \$(MAKE)... " >&6; }
+ set x ${MAKE-make}
+ ac_make=`$as_echo "$2" | sed 's/+/p/g; s/[^a-zA-Z0-9_]/_/g'`
+-if eval "test \"\${ac_cv_prog_make_${ac_make}_set+set}\"" = set; then :
++if eval \${ac_cv_prog_make_${ac_make}_set+:} false; then :
+   $as_echo_n "(cached) " >&6
+ else
+   cat >conftest.make <<\_ACEOF
+@@ -2160,17 +2195,62 @@
+ 
+ # We need awk for the "check" target.  The system "awk" is bad on
+ # some platforms.
+-# Always define AMTAR for backward compatibility.
++# Always define AMTAR for backward compatibility.  Yes, it's still used
++# in the wild :-(  We should find a proper way to deprecate it ...
++AMTAR='$${TAR-tar}'
+ 
+-AMTAR=${AMTAR-"${am_missing_run}tar"}
++am__tar='$${TAR-tar} chof - "$$tardir"' am__untar='$${TAR-tar} xf -'
+ 
+-am__tar='${AMTAR} chof - "$$tardir"'; am__untar='${AMTAR} xf -'
+ 
+ 
+ 
+ 
+ 
+ 
++# Extract the first word of "python", so it can be a program name with args.
++set dummy python; ac_word=$2
++{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
++$as_echo_n "checking for $ac_word... " >&6; }
++if ${ac_cv_path_PYTHON+:} false; then :
++  $as_echo_n "(cached) " >&6
++else
++  case $PYTHON in
++  [\\/]* | ?:[\\/]*)
++  ac_cv_path_PYTHON="$PYTHON" # Let the user override the test with a path.
++  ;;
++  *)
++  as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
++for as_dir in $PATH
++do
++  IFS=$as_save_IFS
++  test -z "$as_dir" && as_dir=.
++    for ac_exec_ext in '' $ac_executable_extensions; do
++  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
++    ac_cv_path_PYTHON="$as_dir/$ac_word$ac_exec_ext"
++    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
++    break 2
++  fi
++done
++  done
++IFS=$as_save_IFS
++
++  ;;
++esac
++fi
++PYTHON=$ac_cv_path_PYTHON
++if test -n "$PYTHON"; then
++  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $PYTHON" >&5
++$as_echo "$PYTHON" >&6; }
++else
++  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
++$as_echo "no" >&6; }
++fi
++
++
++if test x"$PYTHON" = x; then
++  as_fn_error $? "python is required to build the translation XML files" "$LINENO" 5
++fi
++
+ DATADIR=`(
+ 	case $prefix in
+ 		NONE) prefix=$ac_default_prefix ;;
+@@ -2247,10 +2327,21 @@
+      :end' >>confcache
+ if diff "$cache_file" confcache >/dev/null 2>&1; then :; else
+   if test -w "$cache_file"; then
+-    test "x$cache_file" != "x/dev/null" &&
++    if test "x$cache_file" != "x/dev/null"; then
+       { $as_echo "$as_me:${as_lineno-$LINENO}: updating cache $cache_file" >&5
+ $as_echo "$as_me: updating cache $cache_file" >&6;}
+-    cat confcache >$cache_file
++      if test ! -f "$cache_file" || test -h "$cache_file"; then
++	cat confcache >"$cache_file"
++      else
++        case $cache_file in #(
++        */* | ?:*)
++	  mv -f confcache "$cache_file"$$ &&
++	  mv -f "$cache_file"$$ "$cache_file" ;; #(
++        *)
++	  mv -f confcache "$cache_file" ;;
++	esac
++      fi
++    fi
+   else
+     { $as_echo "$as_me:${as_lineno-$LINENO}: not updating unwritable cache $cache_file" >&5
+ $as_echo "$as_me: not updating unwritable cache $cache_file" >&6;}
+@@ -2319,7 +2410,7 @@
+ 
+ 
+ 
+-: ${CONFIG_STATUS=./config.status}
++: "${CONFIG_STATUS=./config.status}"
+ ac_write_fail=0
+ ac_clean_files_save=$ac_clean_files
+ ac_clean_files="$ac_clean_files $CONFIG_STATUS"
+@@ -2420,6 +2511,7 @@
+ IFS=" ""	$as_nl"
+ 
+ # Find who we are.  Look in the path if we contain no directory separator.
++as_myself=
+ case $0 in #((
+   *[\\/]* ) as_myself=$0 ;;
+   *) as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
+@@ -2615,16 +2707,16 @@
+     # ... but there are two gotchas:
+     # 1) On MSYS, both `ln -s file dir' and `ln file dir' fail.
+     # 2) DJGPP < 2.04 has no symlinks; `ln -s' creates a wrapper executable.
+-    # In both cases, we have to default to `cp -p'.
++    # In both cases, we have to default to `cp -pR'.
+     ln -s conf$$.file conf$$.dir 2>/dev/null && test ! -f conf$$.exe ||
+-      as_ln_s='cp -p'
++      as_ln_s='cp -pR'
+   elif ln conf$$.file conf$$ 2>/dev/null; then
+     as_ln_s=ln
+   else
+-    as_ln_s='cp -p'
++    as_ln_s='cp -pR'
+   fi
+ else
+-  as_ln_s='cp -p'
++  as_ln_s='cp -pR'
+ fi
+ rm -f conf$$ conf$$.exe conf$$.dir/conf$$.file conf$$.file
+ rmdir conf$$.dir 2>/dev/null
+@@ -2684,28 +2776,16 @@
+   as_mkdir_p=false
+ fi
+ 
+-if test -x / >/dev/null 2>&1; then
+-  as_test_x='test -x'
+-else
+-  if ls -dL / >/dev/null 2>&1; then
+-    as_ls_L_option=L
+-  else
+-    as_ls_L_option=
+-  fi
+-  as_test_x='
+-    eval sh -c '\''
+-      if test -d "$1"; then
+-	test -d "$1/.";
+-      else
+-	case $1 in #(
+-	-*)set "./$1";;
+-	esac;
+-	case `ls -ld'$as_ls_L_option' "$1" 2>/dev/null` in #((
+-	???[sx]*):;;*)false;;esac;fi
+-    '\'' sh
+-  '
+-fi
+-as_executable_p=$as_test_x
++
++# as_fn_executable_p FILE
++# -----------------------
++# Test if FILE is an executable regular file.
++as_fn_executable_p ()
++{
++  test -f "$1" && test -x "$1"
++} # as_fn_executable_p
++as_test_x='test -x'
++as_executable_p=as_fn_executable_p
+ 
+ # Sed expression to map a string onto a valid CPP name.
+ as_tr_cpp="eval sed 'y%*$as_cr_letters%P$as_cr_LETTERS%;s%[^_$as_cr_alnum]%_%g'"
+@@ -2727,7 +2807,7 @@
+ # values after options handling.
+ ac_log="
+ This file was extended by itstool $as_me 1.2.0, which was
+-generated by GNU Autoconf 2.66.  Invocation command line was
++generated by GNU Autoconf 2.69.  Invocation command line was
+ 
+   CONFIG_FILES    = $CONFIG_FILES
+   CONFIG_HEADERS  = $CONFIG_HEADERS
+@@ -2780,10 +2860,10 @@
+ ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`"
+ ac_cs_version="\\
+ itstool config.status 1.2.0
+-configured by $0, generated by GNU Autoconf 2.66,
++configured by $0, generated by GNU Autoconf 2.69,
+   with options \\"\$ac_cs_config\\"
+ 
+-Copyright (C) 2010 Free Software Foundation, Inc.
++Copyright (C) 2012 Free Software Foundation, Inc.
+ This config.status script is free software; the Free Software Foundation
+ gives unlimited permission to copy, distribute and modify it."
+ 
+@@ -2801,11 +2881,16 @@
+ while test $# != 0
+ do
+   case $1 in
+-  --*=*)
++  --*=?*)
+     ac_option=`expr "X$1" : 'X\([^=]*\)='`
+     ac_optarg=`expr "X$1" : 'X[^=]*=\(.*\)'`
+     ac_shift=:
+     ;;
++  --*=)
++    ac_option=`expr "X$1" : 'X\([^=]*\)='`
++    ac_optarg=
++    ac_shift=:
++    ;;
+   *)
+     ac_option=$1
+     ac_optarg=$2
+@@ -2827,6 +2912,7 @@
+     $ac_shift
+     case $ac_optarg in
+     *\'*) ac_optarg=`$as_echo "$ac_optarg" | sed "s/'/'\\\\\\\\''/g"` ;;
++    '') as_fn_error $? "missing file argument" ;;
+     esac
+     as_fn_append CONFIG_FILES " '$ac_optarg'"
+     ac_need_defaults=false;;
+@@ -2857,7 +2943,7 @@
+ _ACEOF
+ cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1
+ if \$ac_cs_recheck; then
+-  set X '$SHELL' '$0' $ac_configure_args \$ac_configure_extra_args --no-create --no-recursion
++  set X $SHELL '$0' $ac_configure_args \$ac_configure_extra_args --no-create --no-recursion
+   shift
+   \$as_echo "running CONFIG_SHELL=$SHELL \$*" >&6
+   CONFIG_SHELL='$SHELL'
+@@ -2912,9 +2998,10 @@
+ # after its creation but before its name has been assigned to `$tmp'.
+ $debug ||
+ {
+-  tmp=
++  tmp= ac_tmp=
+   trap 'exit_status=$?
+-  { test -z "$tmp" || test ! -d "$tmp" || rm -fr "$tmp"; } && exit $exit_status
++  : "${ac_tmp:=$tmp}"
++  { test ! -d "$ac_tmp" || rm -fr "$ac_tmp"; } && exit $exit_status
+ ' 0
+   trap 'as_fn_exit 1' 1 2 13 15
+ }
+@@ -2922,12 +3009,13 @@
+ 
+ {
+   tmp=`(umask 077 && mktemp -d "./confXXXXXX") 2>/dev/null` &&
+-  test -n "$tmp" && test -d "$tmp"
++  test -d "$tmp"
+ }  ||
+ {
+   tmp=./conf$$-$RANDOM
+   (umask 077 && mkdir "$tmp")
+ } || as_fn_error $? "cannot create a temporary directory in ." "$LINENO" 5
++ac_tmp=$tmp
+ 
+ # Set up the scripts for CONFIG_FILES section.
+ # No need to generate them if there are no CONFIG_FILES.
+@@ -2949,7 +3037,7 @@
+   ac_cs_awk_cr=$ac_cr
+ fi
+ 
+-echo 'BEGIN {' >"$tmp/subs1.awk" &&
++echo 'BEGIN {' >"$ac_tmp/subs1.awk" &&
+ _ACEOF
+ 
+ 
+@@ -2977,7 +3065,7 @@
+ rm -f conf$$subs.sh
+ 
+ cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1
+-cat >>"\$tmp/subs1.awk" <<\\_ACAWK &&
++cat >>"\$ac_tmp/subs1.awk" <<\\_ACAWK &&
+ _ACEOF
+ sed -n '
+ h
+@@ -3025,7 +3113,7 @@
+ rm -f conf$$subs.awk
+ cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1
+ _ACAWK
+-cat >>"\$tmp/subs1.awk" <<_ACAWK &&
++cat >>"\$ac_tmp/subs1.awk" <<_ACAWK &&
+   for (key in S) S_is_set[key] = 1
+   FS = ""
+ 
+@@ -3057,7 +3145,7 @@
+   sed "s/$ac_cr\$//; s/$ac_cr/$ac_cs_awk_cr/g"
+ else
+   cat
+-fi < "$tmp/subs1.awk" > "$tmp/subs.awk" \
++fi < "$ac_tmp/subs1.awk" > "$ac_tmp/subs.awk" \
+   || as_fn_error $? "could not setup config files machinery" "$LINENO" 5
+ _ACEOF
+ 
+@@ -3116,7 +3204,7 @@
+     for ac_f
+     do
+       case $ac_f in
+-      -) ac_f="$tmp/stdin";;
++      -) ac_f="$ac_tmp/stdin";;
+       *) # Look for the file first in the build tree, then in the source tree
+ 	 # (if the path is not absolute).  The absolute path cannot be DOS-style,
+ 	 # because $ac_f cannot contain `:'.
+@@ -3151,7 +3239,7 @@
+     esac
+ 
+     case $ac_tag in
+-    *:-:* | *:-) cat >"$tmp/stdin" \
++    *:-:* | *:-) cat >"$ac_tmp/stdin" \
+       || as_fn_error $? "could not create $ac_file" "$LINENO" 5 ;;
+     esac
+     ;;
+@@ -3288,21 +3376,22 @@
+ s&@MKDIR_P@&$ac_MKDIR_P&;t t
+ $ac_datarootdir_hack
+ "
+-eval sed \"\$ac_sed_extra\" "$ac_file_inputs" | $AWK -f "$tmp/subs.awk" >$tmp/out \
+-  || as_fn_error $? "could not create $ac_file" "$LINENO" 5
++eval sed \"\$ac_sed_extra\" "$ac_file_inputs" | $AWK -f "$ac_tmp/subs.awk" \
++  >$ac_tmp/out || as_fn_error $? "could not create $ac_file" "$LINENO" 5
+ 
+ test -z "$ac_datarootdir_hack$ac_datarootdir_seen" &&
+-  { ac_out=`sed -n '/\${datarootdir}/p' "$tmp/out"`; test -n "$ac_out"; } &&
+-  { ac_out=`sed -n '/^[	 ]*datarootdir[	 ]*:*=/p' "$tmp/out"`; test -z "$ac_out"; } &&
++  { ac_out=`sed -n '/\${datarootdir}/p' "$ac_tmp/out"`; test -n "$ac_out"; } &&
++  { ac_out=`sed -n '/^[	 ]*datarootdir[	 ]*:*=/p' \
++      "$ac_tmp/out"`; test -z "$ac_out"; } &&
+   { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: $ac_file contains a reference to the variable \`datarootdir'
+ which seems to be undefined.  Please make sure it is defined" >&5
+ $as_echo "$as_me: WARNING: $ac_file contains a reference to the variable \`datarootdir'
+ which seems to be undefined.  Please make sure it is defined" >&2;}
+ 
+-  rm -f "$tmp/stdin"
++  rm -f "$ac_tmp/stdin"
+   case $ac_file in
+-  -) cat "$tmp/out" && rm -f "$tmp/out";;
+-  *) rm -f "$ac_file" && mv "$tmp/out" "$ac_file";;
++  -) cat "$ac_tmp/out" && rm -f "$ac_tmp/out";;
++  *) rm -f "$ac_file" && mv "$ac_tmp/out" "$ac_file";;
+   esac \
+   || as_fn_error $? "could not create $ac_file" "$LINENO" 5
+  ;;
+diff -Naur build_itstool_old/configure.ac build_itstool/configure.ac
+--- build_itstool_old/configure.ac	2012-06-24 07:28:51.000000000 -0700
++++ build_itstool/configure.ac	2013-08-07 15:57:15.520704494 -0700
+@@ -1,6 +1,12 @@
+ AC_INIT([itstool], [1.2.0], [])
+ AM_INIT_AUTOMAKE([1.9 no-dist-gzip dist-bzip2])
+ 
++AC_ARG_VAR([PYTHON], [Path to the `python` command])
++AC_PATH_PROG([PYTHON], [python])
++if test x"$PYTHON" = x; then
++  AC_MSG_ERROR([python is required to build the translation XML files])
++fi
++
+ DATADIR=`(
+ 	case $prefix in
+ 		NONE) prefix=$ac_default_prefix ;;
+diff -Naur build_itstool_old/its/Makefile.in build_itstool/its/Makefile.in
+--- build_itstool_old/its/Makefile.in	2012-06-24 07:29:02.000000000 -0700
++++ build_itstool/its/Makefile.in	2013-08-07 15:57:47.092104549 -0700
+@@ -1,9 +1,9 @@
+-# Makefile.in generated by automake 1.11.1 from Makefile.am.
++# Makefile.in generated by automake 1.11.6 from Makefile.am.
+ # @configure_input@
+ 
+ # Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002,
+-# 2003, 2004, 2005, 2006, 2007, 2008, 2009  Free Software Foundation,
+-# Inc.
++# 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software
++# Foundation, Inc.
+ # This Makefile.in is free software; the Free Software Foundation
+ # gives unlimited permission to copy and/or distribute it,
+ # with or without modifications, as long as this notice is preserved.
+@@ -16,6 +16,23 @@
+ @SET_MAKE@
+ 
+ VPATH = @srcdir@
++am__make_dryrun = \
++  { \
++    am__dry=no; \
++    case $$MAKEFLAGS in \
++      *\\[\ \	]*) \
++        echo 'am--echo: ; @echo "AM"  OK' | $(MAKE) -f - 2>/dev/null \
++          | grep '^AM OK$$' >/dev/null || am__dry=yes;; \
++      *) \
++        for am__flg in $$MAKEFLAGS; do \
++          case $$am__flg in \
++            *=*|--*) ;; \
++            *n*) am__dry=yes; break;; \
++          esac; \
++        done;; \
++    esac; \
++    test $$am__dry = yes; \
++  }
+ pkgdatadir = $(datadir)/@PACKAGE@
+ pkgincludedir = $(includedir)/@PACKAGE@
+ pkglibdir = $(libdir)/@PACKAGE@
+@@ -43,6 +60,11 @@
+ CONFIG_CLEAN_VPATH_FILES =
+ SOURCES =
+ DIST_SOURCES =
++am__can_run_installinfo = \
++  case $$AM_UPDATE_INFO_DIR in \
++    n|no|NO) false;; \
++    *) (install-info --version) >/dev/null 2>&1;; \
++  esac
+ am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`;
+ am__vpath_adj = case $$p in \
+     $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \
+@@ -64,6 +86,12 @@
+ am__base_list = \
+   sed '$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;s/\n/ /g' | \
+   sed '$$!N;$$!N;$$!N;$$!N;s/\n/ /g'
++am__uninstall_files_from_dir = { \
++  test -z "$$files" \
++    || { test ! -d "$$dir" && test ! -f "$$dir" && test ! -r "$$dir"; } \
++    || { echo " ( cd '$$dir' && rm -f" $$files ")"; \
++         $(am__cd) "$$dir" && rm -f $$files; }; \
++  }
+ am__installdirs = "$(DESTDIR)$(itsdir)"
+ DATA = $(its_DATA)
+ DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
+@@ -97,6 +125,7 @@
+ PACKAGE_URL = @PACKAGE_URL@
+ PACKAGE_VERSION = @PACKAGE_VERSION@
+ PATH_SEPARATOR = @PATH_SEPARATOR@
++PYTHON = @PYTHON@
+ SET_MAKE = @SET_MAKE@
+ SHELL = @SHELL@
+ STRIP = @STRIP@
+@@ -178,8 +207,11 @@
+ $(am__aclocal_m4_deps):
+ install-itsDATA: $(its_DATA)
+ 	@$(NORMAL_INSTALL)
+-	test -z "$(itsdir)" || $(MKDIR_P) "$(DESTDIR)$(itsdir)"
+ 	@list='$(its_DATA)'; test -n "$(itsdir)" || list=; \
++	if test -n "$$list"; then \
++	  echo " $(MKDIR_P) '$(DESTDIR)$(itsdir)'"; \
++	  $(MKDIR_P) "$(DESTDIR)$(itsdir)" || exit 1; \
++	fi; \
+ 	for p in $$list; do \
+ 	  if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
+ 	  echo "$$d$$p"; \
+@@ -193,9 +225,7 @@
+ 	@$(NORMAL_UNINSTALL)
+ 	@list='$(its_DATA)'; test -n "$(itsdir)" || list=; \
+ 	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
+-	test -n "$$files" || exit 0; \
+-	echo " ( cd '$(DESTDIR)$(itsdir)' && rm -f" $$files ")"; \
+-	cd "$(DESTDIR)$(itsdir)" && rm -f $$files
++	dir='$(DESTDIR)$(itsdir)'; $(am__uninstall_files_from_dir)
+ tags: TAGS
+ TAGS:
+ 
+@@ -250,10 +280,15 @@
+ 
+ installcheck: installcheck-am
+ install-strip:
+-	$(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
+-	  install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
+-	  `test -z '$(STRIP)' || \
+-	    echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install
++	if test -z '$(STRIP)'; then \
++	  $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
++	    install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
++	      install; \
++	else \
++	  $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
++	    install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
++	    "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'" install; \
++	fi
+ mostlyclean-generic:
+ 
+ clean-generic:
+diff -Naur build_itstool_old/itstool.in build_itstool/itstool.in
+--- build_itstool_old/itstool.in	2012-05-16 08:19:34.000000000 -0700
++++ build_itstool/itstool.in	2013-08-07 15:44:04.311745291 -0700
+@@ -1,4 +1,4 @@
+-#!/usr/bin/python -s
++#!@PYTHON@ -s
+ #
+ # Copyright (c) 2010-2011 Shaun McCance <sh...@gn...>
+ #

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Plplot-cvs] SF.net SVN: plplot:[12549] trunk/README.release

[<ai...@us...>]

Revision: 12549
          http://sourceforge.net/p/plplot/code/12549
Author:   airwin
Date:     2013-09-29 20:41:52 +0000 (Sun, 29 Sep 2013)
Log Message:
-----------
Report (good) test results for this release.

Modified Paths:
--------------
    trunk/README.release

Modified: trunk/README.release
===================================================================
--- trunk/README.release	2013-09-29 20:41:21 UTC (rev 12548)
+++ trunk/README.release	2013-09-29 20:41:52 UTC (rev 12549)
@@ -483,6 +483,34 @@
 
 0. Tests made for release 5.9.10
 
+Comprehensive testing that showed no non-zero return codes or other
+obvious run-time issues such as segfaults was done for the Debian
+Wheezy platform.  These tests were done with the
+scripts/comprehensive_test.sh which does 21 major tests.  Those tests
+consist of seven tests (ctest, and "make test_noninteractive" and make
+"test_interactive" results for the build tree, and "make
+test_noninteractive" and make "test_interactive" results for both the
+traditional and CMake-based build systems for the installed examples
+tree) for each of our three major configurations (shared
+libraries/dynamic devices, shared libraries/non-dynamic devices,
+static libraries/non-dynamic devices).
+
+More limited testing that showed no non-zero return codes or other
+obvious run-time issues such as segfaults was done on a large number
+of different platforms including the following:
+
+Fedora with "Unix Makefiles" generator
+Ubuntu with "Unix Makefiles" generator
+Debian unstable with "Unix Makefiles" generator
+Debian wheezy with "Ninja" generator
+Wine version of Windows with "MSYS Makefiles" generator
+Wine version of Windows with "MinGW Makefiles" generator
+Wine version of Windows with "NMake Makefiles JOM" generator
+Microsoft version of Windows with Cygwin and with "Unix Makefiles" generator
+Microsoft version of Windows with "MinGW Makefiles" generator
+Microsoft version of Windows with "MSYS Makefiles" generator
+Microsoft version of Windows with "NMake Makefiles" generator
+
 1. Changes relative to PLplot 5.9.9 (the previous development release)
 
 N.B. This release includes many code cleanups and fixes relative to

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Plplot-cvs] SF.net SVN: plplot:[12548] trunk/examples/CMakeLists.txt

[<ai...@us...>]

Revision: 12548
          http://sourceforge.net/p/plplot/code/12548
Author:   airwin
Date:     2013-09-29 20:41:21 +0000 (Sun, 29 Sep 2013)
Log Message:
-----------
Fix rpath issue (couldn't find shapelib) with qt_example for
traditional build system of installed examples.

Tested by: Alan W. Irwin <ai...@us...> using
scripts/comprehensive_test.sh for case where shapelib had
a non-standard location.

Modified Paths:
--------------
    trunk/examples/CMakeLists.txt

Modified: trunk/examples/CMakeLists.txt
===================================================================
--- trunk/examples/CMakeLists.txt	2013-09-29 10:21:53 UTC (rev 12547)
+++ trunk/examples/CMakeLists.txt	2013-09-29 20:41:21 UTC (rev 12548)
@@ -221,7 +221,7 @@
       if(ENABLE_DYNDRIVERS)
 	get_target_property(_qt_INSTALL_RPATH qt INSTALL_RPATH)
 	string(REGEX REPLACE ";" ":" qt_INSTALL_RPATH "${_qt_INSTALL_RPATH}")
-	set(qt_RPATHCMD "-Wl,-rpath -Wl,${qt_INSTALL_RPATH}:${DRV_DIR}")
+	set(qt_RPATHCMD "-Wl,-rpath -Wl,${LIB_INSTALL_RPATH}:${qt_INSTALL_RPATH}:${DRV_DIR}")
       else(ENABLE_DYNDRIVERS)
 	set(qt_RPATHCMD ${RPATHCMD})
       endif(ENABLE_DYNDRIVERS)

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Plplot-cvs] SF.net SVN: plplot:[12547] trunk/scripts/comprehensive_test.sh

[<ai...@us...>]

Revision: 12547
          http://sourceforge.net/p/plplot/code/12547
Author:   airwin
Date:     2013-09-29 10:21:53 +0000 (Sun, 29 Sep 2013)
Log Message:
-----------
Adjust script so that it can handle version numbers where the major
number is one numerical digit, the minor number one or more numerical
digits, and the patch number is one or more numerical digits.

Modified Paths:
--------------
    trunk/scripts/comprehensive_test.sh

Modified: trunk/scripts/comprehensive_test.sh
===================================================================
--- trunk/scripts/comprehensive_test.sh	2013-09-29 08:17:29 UTC (rev 12546)
+++ trunk/scripts/comprehensive_test.sh	2013-09-29 10:21:53 UTC (rev 12547)
@@ -138,7 +138,7 @@
 	    # Use this logic to be as version-independent as possible.
 	    current_dir=$(pwd)
 	    # Wild cards must not be inside quotes.
-	    cd "$INSTALL_TREE"/lib/plplot?.?.?*/drivers*
+	    cd "$INSTALL_TREE"/lib/plplot[0-9].[0-9]*.[0-9]*/drivers*
 	    PATH="$(pwd):$PATH"
 	    cd $current_dir
 	fi
@@ -156,7 +156,7 @@
                 # that excludes MSYS.
 		PATH=$path_excluding_msys
 	    fi
-	    cmake -G "$generator_string" "$INSTALL_TREE"/share/plplot?.?.?/examples >& "$output"
+	    cmake -G "$generator_string" "$INSTALL_TREE"/share/plplot[0-9].[0-9]*.[0-9]*/examples >& "$output"
 	    PATH=$PATH_AFTER_CMAKE
 	    if [ "$do_test_noninteractive" = "yes" ] ; then
 		output="$OUTPUT_TREE"/installed_make_noninteractive.out
@@ -173,7 +173,7 @@
 	fi
 
 	if [ "$do_test_traditional_install_tree" = "yes" -a "$do_test_noninteractive" = "yes" ] ; then
-	    cd "$INSTALL_TREE"/share/plplot?.?.?/examples
+	    cd "$INSTALL_TREE"/share/plplot[0-9].[0-9]*.[0-9]*/examples
 	    output="$OUTPUT_TREE"/traditional_make_noninteractive.out
 	    rm -f "$output"
 	    echo "Traditional $build_command test_noninteractive in the installed examples tree"
@@ -217,7 +217,7 @@
 	    fi
 	fi
 	if [ "$do_test_traditional_install_tree" = "yes" ] ; then
-	    cd "$INSTALL_TREE"/share/plplot?.?.?/examples
+	    cd "$INSTALL_TREE"/share/plplot[0-9].[0-9]*.[0-9]*/examples
 	    output="$OUTPUT_TREE"/traditional_make_interactive.out
 	    rm -f "$output"
 	    echo "Traditional $build_command test_interactive in the installed examples tree"

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Plplot-cvs] SF.net SVN: plplot:[12546] trunk/cmake/modules/plplot_version.cmake

[<ai...@us...>]

Revision: 12546
          http://sourceforge.net/p/plplot/code/12546
Author:   airwin
Date:     2013-09-29 08:17:29 +0000 (Sun, 29 Sep 2013)
Log Message:
-----------
Update release date to 2013-09-29 and version to 5.9.10 in preparation
for the planned release later today.

Soversion bump for most PLplot libraries in preparation for the
release because of substantial backwards incompatible API changes
concerning integer to floating point line width parameters.

Modified Paths:
--------------
    trunk/cmake/modules/plplot_version.cmake

Modified: trunk/cmake/modules/plplot_version.cmake
===================================================================
--- trunk/cmake/modules/plplot_version.cmake	2013-09-29 07:42:37 UTC (rev 12545)
+++ trunk/cmake/modules/plplot_version.cmake	2013-09-29 08:17:29 UTC (rev 12546)
@@ -1,15 +1,15 @@
 # For now, must set this by hand before each release.  This value affects
 # at least the documentation build and perhaps other parts of the release.
-set(RELEASE_DATE "2011-10-12")
+set(RELEASE_DATE "2013-09-29")
 
 # Version data that need review and possible modification for each release.
 
-set(VERSION 5.9.9)
+set(VERSION 5.9.10)
 
 # CPack version numbers for release tarball name.
 set(CPACK_PACKAGE_VERSION_MAJOR 5)
 set(CPACK_PACKAGE_VERSION_MINOR 9)
-set(CPACK_PACKAGE_VERSION_PATCH 9)
+set(CPACK_PACKAGE_VERSION_PATCH 10)
 
 # PLplot library version information.
 
@@ -27,8 +27,8 @@
 # (4) If there are no library source code changes at all, then leave all
 #     library version numbers the same for the release.
 
-set(plplotqt_SOVERSION 0)
-set(plplotqt_VERSION ${plplotqt_SOVERSION}.0.1)
+set(plplotqt_SOVERSION 1)
+set(plplotqt_VERSION ${plplotqt_SOVERSION}.0.0)
 
 set(nistcd_SOVERSION 0)
 set(nistcd_VERSION ${nistcd_SOVERSION}.0.1)
@@ -42,20 +42,20 @@
 set(qsastime_SOVERSION 0)
 set(qsastime_VERSION ${qsastime_SOVERSION}.0.1)
 
-set(plplot_SOVERSION 11)
+set(plplot_SOVERSION 12)
 set(plplot_VERSION ${plplot_SOVERSION}.0.0)
 
-set(plplotcxx_SOVERSION 10)
+set(plplotcxx_SOVERSION 11)
 set(plplotcxx_VERSION ${plplotcxx_SOVERSION}.0.0)
 
-set(plplotdmd_SOVERSION 0)
+set(plplotdmd_SOVERSION 1)
 set(plplotdmd_VERSION ${plplotdmd_SOVERSION}.0.0)
 
 set(plplotf77_SOVERSION 9)
 set(plplotf77_VERSION ${plplotf77_SOVERSION}.1.1)
 
-set(plplotf95_SOVERSION 9)
-set(plplotf95_VERSION ${plplotf95_SOVERSION}.1.1)
+set(plplotf95_SOVERSION 10)
+set(plplotf95_VERSION ${plplotf95_SOVERSION}.0.0)
 
 set(plplotgnome2_SOVERSION 0)
 set(plplotgnome2_VERSION ${plplotgnome2_SOVERSION}.0.0)
@@ -63,13 +63,13 @@
 set(tclmatrix_SOVERSION 9)
 set(tclmatrix_VERSION ${tclmatrix_SOVERSION}.2.0)
 
-set(plplottcltk_SOVERSION 9)
-set(plplottcltk_VERSION ${plplottcltk_SOVERSION}.2.0)
+set(plplottcltk_SOVERSION 10)
+set(plplottcltk_VERSION ${plplottcltk_SOVERSION}.0.0)
 
 set(plplotwxwidgets_SOVERSION 0)
 set(plplotwxwidgets_VERSION ${plplotwxwidgets_SOVERSION}.0.0)
 
-set(plplotada_SOVERSION 0)
+set(plplotada_SOVERSION 1)
 set(plplotada_VERSION ${plplotada_SOVERSION}.0.0)
 
 # According to man package, PLPLOT_TCL_VERSION (used in the various
@@ -79,4 +79,3 @@
 # use the major number from the package version for now.
 
 set(PLPLOT_TCL_VERSION 5)
-

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Plplot-cvs] SF.net SVN: plplot:[12545] trunk/README.release

[<ai...@us...>]

Revision: 12545
          http://sourceforge.net/p/plplot/code/12545
Author:   airwin
Date:     2013-09-29 07:42:37 +0000 (Sun, 29 Sep 2013)
Log Message:
-----------
Substantial update to reflect all important changes (as revealed by
the commit messages) since the last release.

Spell check using

aspell check README.release

Modified Paths:
--------------
    trunk/README.release

Modified: trunk/README.release
===================================================================
--- trunk/README.release	2013-09-28 17:52:22 UTC (rev 12544)
+++ trunk/README.release	2013-09-29 07:42:37 UTC (rev 12545)
@@ -6,9 +6,9 @@
 stable release will be 5.10.0.
 
      If you encounter a problem that is not already documented in the
-PROBLEMS file or on our bugtracker, then please send bug reports to PLplot
+PROBLEMS file or on our bug tracker, then please send bug reports to PLplot
 developers via the mailing lists at
-http://sourceforge.net/mail/?group_id=2915 (preferred) or on our bugtracker
+http://sourceforge.net/mail/?group_id=2915 (preferred) or on our bug tracker
 at http://sourceforge.net/tracker/?group_id=2915&atid=102915.
 
      Please see the license under which this software is distributed
@@ -31,10 +31,21 @@
 
 1.1 The format for map data used by plmap has changed
 1.2 Python support for Numeric has been dropped
-1.3 Non-integer line widths allowed
+1.3 Backwards-incompatible API change to non-integer line widths
 1.4 Improvements to the build system for the Cygwin case
 1.5 The plcolorbar API has been finalized
 1.6 Documentation of the new legend and color bar capabilities of PLplot
+1.7 The D bindings and examples have been converted from the
+old version of D (D1) to the new version of D (D2)
+1.8 The DocBook documentation for PLplot is now generated using modern
+XML/XSL backend tools for DocBook
+1.9 Implement experimental build_projects sub-project
+1.10 Implement extremely simple "00" example
+1.11 Convert to using the Allura form of SourceForge software
+1.12 Use NON_TRANSITIVE linking by default for the shared libraries case for
+all non-windows systems
+1.13 Update f95 examples to take larger advantage of Fortran 95 capabilities
+1.14 Substantial additions to the doxygen documentation
 
 2. Changes relative to PLplot 5.8.0 (the previous stable release)
 
@@ -78,7 +89,7 @@
 2.36 Make PLplot aware of LC_NUMERIC locale
 2.37 Linear gradients have been implemented
 2.38 Cairo Windows driver implemented
-2.39 Custom axis labeling implemented
+2.39 Custom axis labelling implemented
 2.40 Universal coordinate transform implemented
 2.41 Support for arbitrary storage of 2D user data
 2.42 Font improvements
@@ -95,15 +106,34 @@
 2.52 The plarc function has been added
 2.53 The format for map data used by plmap has changed
 2.54 Python support for Numeric has been dropped
-2.55 Non-integer line widths allowed
+2.55 Backwards-incompatible API change to non-integer line widths
 2.56 Improvements to the build system for the Cygwin case
 2.57 The plcolorbar API has been finalized
 2.58 Documentation of the new legend and color bar capabilities of PLplot
+2.59 The D bindings and examples have been converted from the
+old version of D (D1) to the new version of D (D2)
+2.60 The DocBook documentation for PLplot is now generated using modern
+XML/XSL backend tools for DocBook
+2.61 Implement experimental build_projects sub-project
+2.62 Implement extremely simple "00" example
+2.63 Convert to using the Allura form of SourceForge software
+2.64 Use NON_TRANSITIVE linking by default for the shared libraries case for
+all non-windows systems
+2.65 Update f95 examples to take larger advantage of Fortran 95 capabilities
+2.66 Substantial additions to the doxygen documentation
 
+
 OFFICIAL NOTICES FOR USERS
 
+(5.9.10) The minimum version of CMake has been bumped to 2.8.9.  This
+change allows our build system to take advantage of CMake features
+introduced in later versions of CMake.  Even more importantly it also
+updates user's builds to the CMake policy conventions (important
+backwards-incompatible changes in CMake behaviour introduced in later
+versions of CMake) to the default CMake policy used for 2.8.9.
+
 (5.9.10) The long deprecated support for the python Numeric package has been
-dropped. This is no longer supported and is superceded by numpy. Support for
+dropped. This is no longer supported and is superseded by numpy. Support for
 numpy has been the default in PLplot for a number of years so most users
 should notice no difference.
 
@@ -129,7 +159,7 @@
 zg = plgriddata(x, y, z, xg, yg, alg, opt[alg-1])
 
 (5.9.10) Significant efforts have been made to ensure the PLplot code
-is standards compliant and free from warnings. Compilance has been
+is standards compliant and free from warnings. Compliance has been
 tested using the gcc compiler suite -std, -pedantic and -W  flags. The
 language standards adopted are
 C: ISO C99 with POSIX.1-2001 base specification (required for a number
@@ -151,7 +181,7 @@
 Note that the code is not yet quite standards compliant or warning free,
 but this is our aim. We know that a number of common compilers do not
 support these standards "out of the box", so we will continue to develop
-and support work arounds to ensure that PLplot remains easily built on
+and support workarounds to ensure that PLplot remains easily built on
 a variety of platforms and compilers. Standards compliance should make
 it easier to port to new systems in the future. Using aggressive
 warnings flags will help to detect and eliminate errors or problems in
@@ -451,30 +481,13 @@
 
 CHANGES
 
--1. Important changes we should have mentioned in previous release announcements.
-
--1.1 Add full bindings and examples for the D language.
-
-As of release 5.9.5 we added full bindings and examples for the D
-language.  The results for the D examples are generally consistent
-with the corresponding C examples which helps to verify the D
-bindings.
-
-Since the release of 5.9.5 it has come to our attention that the
-version of gdc supplied with several recent versions of Ubuntu has a
-very serious bug on 64-bit systems (see
-https://bugs.launchpad.net/ubuntu/+source/gdc-4.2/+bug/235955) which
-causes several of the plplot D examples to crash. If this affects you,
-you are recommended to disable the d bindings or switch to an
-alternative d compiler (the Digital Mars compiler is reported to be
-good).
-
-
 0. Tests made for release 5.9.10
 
-
 1. Changes relative to PLplot 5.9.9 (the previous development release)
 
+N.B. This release includes many code cleanups and fixes relative to
+5.9.9 that are not mentioned in the list below.
+
 1.1 The format for map data used by plmap has changed
 
 The format for map data used by plmap is now the shapefile format.
@@ -482,7 +495,7 @@
 in this format. This replaces the custom binary format that PLplot used
 to use. The support for reading shapefiles is provided by the shapelib
 library, which is a new dependency for PLplot. If users do not have this
-installed then, by default, they will not get any map capabilites with
+installed then, by default, they will not get any map capabilities with
 PLplot. Support for the old format can still be enabled by setting the
 PL_DEPRECATED cmake variable, but this support will be removed in a
 subsequent PLplot release.
@@ -490,11 +503,11 @@
 1.2 Python support for Numeric has been dropped
 
 Support for the python Numeric package has been dropped. This has been
-deprecated since 5.9.6. Numeric is no longer supported and is superceded
+deprecated since 5.9.6. Numeric is no longer supported and is superseded
 by numpy. Support for numpy has been the default in plplot for a number
 of years so most users should notice no difference.
 
-1.3 Non-integer line widths allowed
+1.3 Backwards-incompatible API change to non-integer line widths
 
 All functions which take line width arguments (plwidth, plshade*,
 pllegend) now use PLFLT values for the line width. This allows device
@@ -504,7 +517,7 @@
 replacement of plwid by plwidth, and the change in argument lists for
 plshade* and pllegend constitute a backwards incompatible API change
 from previous releases and the soname of libraries has been bumped
-accordingly (which forces a recompile).
+accordingly (which forces users to recompile PLplot).
 
 1.4 Improvements to the build system for the Cygwin case
 
@@ -540,7 +553,7 @@
 plcolorbar calls to be compatible with the argument list of the latest
 version.
 
-1.6. Documentation of the new legend and color bar capabilities of PLplot
+1.6 Documentation of the new legend and color bar capabilities of PLplot
 
 The pllegend and plcolorbar API has been documented in both doxygen
 and DocBook forms.  In addition, the "advanced use" chapter of the
@@ -555,8 +568,81 @@
 additional experience with these powerful capabilities.  In general,
 we would welcome such feature requests.
 
+1.7 The D bindings and examples have been converted from the
+old version of D (D1) to the new version of D (D2)
+
+This change should make PLplot much more relevant for D users
+going forward.
+
+See http://en.wikipedia.org/wiki/D_(programming_language)#History for
+a discussion of the differences between these two variants of D.
+
+1.8 The DocBook documentation for PLplot is now generated using modern
+XML/XSL backend tools for DocBook
+
+These modern backend tools (such as xmlto) replace the
+deprecated/unmaintained SGML/DSSL tools we have used before.  For
+developers this means generation of our DocBook generation is much
+easier. much faster, and much less error-prone.  End users will notice
+some improvements in the results (e.g., the table of Greek letters) as
+well as some minor style changes.
+
+1.9 Implement experimental build_projects sub-project
+
+The idea here (see cmake/build_projects) is to automate the build of
+all PLplot dependencies and the build and test of PLplot itself for
+platforms (such as Linux enterprise distributions and all forms of
+Windows platforms other than Cygwin) that do not come with modern
+versions of PLplot soft dependencies such as Pango/Cairo and Qt.
+This project is beginning to work properly for the Linux case, but
+still needs lots of work for the Windows case.
+
+1.10 Implement extremely simple "00" example
+
+The point of this standard example is to give the users an extremely
+simple tutorial example to help them to get started with 2D plotting
+with PLplot.
+
+1.11 Convert to using the Allura form of SourceForge software
+
+We use sourceforge.net as our software hosting facility.  Early in
+2013 Sourceforge updated essentially all their support software as
+part of the so-called Allura project.  This made it necessary to make
+some minor internal PLplot changes such as script changes and different URL's
+in the website referring to SourceForge facilities.  The most important
+change from the user perspective is the URL for the Allura form
+of the svn repository that we use now:
+
+http://svn.code.sf.net/p/plplot/code/trunk/
+
+1.12 Use NON_TRANSITIVE linking by default for the shared libraries case for
+all non-windows systems
+
+The point of this change is to reduce overlinking and therefore
+the problems caused by overlinking that are mentioned
+at http://en.altlinux.org/UnderOverLinkProblems.
+
+Non-transitive linking means link only to libraries that directly
+resolve undefined symbols, i.e., do not link to a library just because
+it is a dependency of a dependency.
+
+1.13 Update f95 examples to take larger advantage of Fortran 95 capabilities
+
+Previously our f95 examples tended to use legacy Fortran capabilities, but
+that situation has substantially changed for this release.
+
+1.14 Substantial additions to the doxygen documentation
+
+One of the on-going documentation projects is to create doxygen
+documentation of every single argument of the public API for PLplot.
+A substantial increase in such documentation has been implemented
+in this release cycle.
+
 2. Changes relative to PLplot 5.8.0 (the previous stable release)
 
+N.B. This release includes many code cleanups and fixes relative to
+5.8.0 that are not mentioned in the list below.
+
 2.1 All autotools-related files have now been removed
 
 CMake is now the only supported build system. It has been tested on
@@ -681,7 +767,7 @@
 
 Complete reorganization of the driver code. A new backend was added, based
 on the wxGraphicsContext class, which is available for wxWidgets 2.8.4
-and later. This backend produces antialized output similar to the
+and later. This backend produces antialiased output similar to the
 AGG backend but has no dependency on the AGG library. The basic wxDC
 backend and the wxGraphicsContext backend process the text output
 on their own, which results in much nicer plots than with the standard
@@ -810,7 +896,7 @@
 set and get functions) and PostScript output for different languages as a
 check.  Thanks to the addition of example 31, the inclusion of examples 14
 and 17 in the test suite and other recent extensions of the other
-examples we now have rigourous testing in place for almost the entirety
+examples we now have rigorous testing in place for almost the entirety
 of our common API.  This extensive testing framework has already helped
 us track down a number of bugs, and it should make it much easier for us
 to maintain high quality for our ongoing PLplot releases.
@@ -1121,12 +1207,12 @@
 interactive cairo driver for Windows similar to xcairo on Linux.
 Work to improve its functionality is ongoing.
 
-2.39 Custom axis labeling implemented
+2.39 Custom axis labelling implemented
 
 Axis text labels can now be customized using the new plslabelfunc function.
 This allows a user to specify what text should be draw at a given position
 along a plot axis.  Example 19 has been updated to illustrate this function's
-use through labeling geographic coordinates in degrees North, South, East and
+use through labelling geographic coordinates in degrees North, South, East and
 West.
 
 2.40 Universal coordinate transform implemented
@@ -1385,7 +1471,7 @@
 in this format. This replaces the custom binary format that PLplot used
 to use. The support for reading shapefiles is provided by the shapelib
 library, which is a new dependency for PLplot. If users do not have this
-installed then, by default, they will not get any map capabilites with
+installed then, by default, they will not get any map capabilities with
 PLplot. Support for the old format can still be enabled by setting the
 PL_DEPRECATED cmake variable, but this support will be removed in a
 subsequent PLplot release.
@@ -1393,11 +1479,11 @@
 2.54 Python support for Numeric has been dropped
 
 Support for the python Numeric package has been dropped. This has been
-deprecated since 5.9.6. Numeric is no longer supported and is superceded
+deprecated since 5.9.6. Numeric is no longer supported and is superseded
 by numpy. Support for numpy has been the default in plplot for a number
 of years so most users should notice no difference.
 
-2.55 Non-integer line widths allowed
+2.55 Backwards-incompatible API change to non-integer line widths
 
 All functions which take line width arguments (plwidth, plshade*,
 pllegend) now use PLFLT values for the line width. This allows device
@@ -1407,7 +1493,7 @@
 replacement of plwid by plwidth, and the change in argument lists for
 plshade* and pllegend constitute a backwards incompatible API change
 from previous releases and the soname of libraries has been bumped
-accordingly (which forces a recompile).
+accordingly (which forces users to recompile PLplot).
 
 2.56 Improvements to the build system for the Cygwin case
 
@@ -1458,3 +1544,74 @@
 additional experience with these powerful capabilities.  In general,
 we would welcome such feature requests.
 
+2.59 The D bindings and examples have been converted from the
+old version of D (D1) to the new version of D (D2)
+
+This change should make PLplot much more relevant for D users
+going forward.
+
+See http://en.wikipedia.org/wiki/D_(programming_language)#History for
+a discussion of the differences between these two variants of D.
+
+2.60 The DocBook documentation for PLplot is now generated using modern
+XML/XSL backend tools for DocBook
+
+These modern backend tools (such as xmlto) replace the
+deprecated/unmaintained SGML/DSSL tools we have used before.  For
+developers this means generation of our DocBook generation is much
+easier. much faster, and much less error-prone.  End users will notice
+some improvements in the results (e.g., the table of Greek letters) as
+well as some minor style changes.
+
+2.61 Implement experimental build_projects sub-project
+
+The idea here (see cmake/build_projects) is to automate the build of
+all PLplot dependencies and the build and test of PLplot itself for
+platforms (such as Linux enterprise distributions and all forms of
+Windows platforms other than Cygwin) that do not come with modern
+versions of PLplot soft dependencies such as Pango/Cairo and Qt.
+This project is beginning to work properly for the Linux case, but
+still needs lots of work for the Windows case.
+
+2.62 Implement extremely simple "00" example
+
+The point of this standard example is to give the users an extremely
+simple tutorial example to help them to get started with 2D plotting
+with PLplot.
+
+2.63 Convert to using the Allura form of SourceForge software
+
+We use sourceforge.net as our software hosting facility.  Early in
+2013 Sourceforge updated essentially all their support software as
+part of the so-called Allura project.  This made it necessary to make
+some minor internal PLplot changes such as script changes and different URL's
+in the website referring to SourceForge facilities.  The most important
+change from the user perspective is the URL for the Allura form
+of the svn repository that we use now:
+
+http://svn.code.sf.net/p/plplot/code/trunk/
+
+2.64 Use NON_TRANSITIVE linking by default for the shared libraries case for
+all non-windows systems
+
+The point of this change is to reduce overlinking and therefore
+the problems caused by overlinking that are mentioned
+at http://en.altlinux.org/UnderOverLinkProblems.
+
+Non-transitive linking means link only to libraries that directly
+resolve undefined symbols, i.e., do not link to a library just because
+it is a dependency of a dependency.
+
+2.65 Update f95 examples to take larger advantage of Fortran 95 capabilities
+
+Previously our f95 examples tended to use legacy Fortran capabilities, but
+that situation has substantially changed for this release.
+
+2.66 Substantial additions to the doxygen documentation
+
+One of the on-going documentation projects is to create doxygen
+documentation of every single argument of the public API for PLplot.
+A substantial increase in such documentation has been implemented
+in this release cycle.
+
+

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Plplot-cvs] SF.net SVN: plplot:[12544] trunk/bindings/octave/CMakeLists.txt

[<ai...@us...>]

Revision: 12544
          http://sourceforge.net/p/plplot/code/12544
Author:   airwin
Date:     2013-09-28 17:52:22 +0000 (Sat, 28 Sep 2013)
Log Message:
-----------
Only define the check_plplot_octave_def custom target when using the
matwrapped bindings (which should probably be removed in any case during the
next release cycle).

Modified Paths:
--------------
    trunk/bindings/octave/CMakeLists.txt

Modified: trunk/bindings/octave/CMakeLists.txt
===================================================================
--- trunk/bindings/octave/CMakeLists.txt	2013-09-28 17:50:13 UTC (rev 12543)
+++ trunk/bindings/octave/CMakeLists.txt	2013-09-28 17:52:22 UTC (rev 12544)
@@ -120,26 +120,27 @@
     @ONLY
     )
 
-  # Add (Unix) custom target to check that plplot_oct_def is up to date.
-  # This check only relevant for legacy matwrapped octave bindings since
-  # swig-based bindings don't use plplot_oct_def.
-  add_custom_target(
-    check_plplot_octave_def
-    COMMAND ${CMAKE_COMMAND} -E remove -f 
-    ${CMAKE_CURRENT_BINARY_DIR}/plplot_octave_compare
-    COMMAND
-    sed -f ${CMAKE_CURRENT_SOURCE_DIR}/global_defines.sed < 
-    ${CMAKE_SOURCE_DIR}/bindings/swig-support/plplotcapi.i > 
-    ${CMAKE_CURRENT_BINARY_DIR}/plplot_octave_compare
-    COMMAND
-    ${CMAKE_COMMAND} -E echo Check that plplot_octave_def is up to date.
-    COMMAND
-    cmp ${CMAKE_CURRENT_SOURCE_DIR}/plplot_octave_def
-    ${CMAKE_CURRENT_BINARY_DIR}/plplot_octave_compare
-    )
-
   # Build octave interface.
   if(ENABLE_matwrapped_octave)
+
+    # Add (Unix) custom target to check that plplot_oct_def (used only
+    # when ENABLE_matwrapped_octave is ON) is consistent
+    # with swig-support/plplotcapi.i.
+    add_custom_target(
+      check_plplot_octave_def
+      COMMAND ${CMAKE_COMMAND} -E remove -f 
+      ${CMAKE_CURRENT_BINARY_DIR}/plplot_octave_compare
+      COMMAND
+      sed -f ${CMAKE_CURRENT_SOURCE_DIR}/global_defines.sed < 
+      ${CMAKE_SOURCE_DIR}/bindings/swig-support/plplotcapi.i > 
+      ${CMAKE_CURRENT_BINARY_DIR}/plplot_octave_compare
+      COMMAND
+      ${CMAKE_COMMAND} -E echo "Check that plplot_octave_def is consistent with bindings/swig-support/plplotcapi.i"
+      COMMAND
+      cmp ${CMAKE_CURRENT_SOURCE_DIR}/plplot_octave_def
+      ${CMAKE_CURRENT_BINARY_DIR}/plplot_octave_compare
+      )
+
     set(octave_interface_INCLUDE_PATHS
       ${CMAKE_SOURCE_DIR}/include
       ${CMAKE_BINARY_DIR}

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Plplot-cvs] SF.net SVN: plplot:[12543] trunk/bindings/octave/plplot_octave_def

[<ai...@us...>]

Revision: 12543
          http://sourceforge.net/p/plplot/code/12543
Author:   airwin
Date:     2013-09-28 17:50:13 +0000 (Sat, 28 Sep 2013)
Log Message:
-----------
Regenerate this file (only used for the legacy matwrapped bindings) 
to make it consistent with the updated #defines in
bindings/swig-support/plplotcapi.i.  This regeneration is accomplished
by running the check_plplot_octave_def target and copying the
comparison file generated in the build tree on top of this source-tree
file.

Modified Paths:
--------------
    trunk/bindings/octave/plplot_octave_def

Modified: trunk/bindings/octave/plplot_octave_def
===================================================================
--- trunk/bindings/octave/plplot_octave_def	2013-09-28 17:30:43 UTC (rev 12542)
+++ trunk/bindings/octave/plplot_octave_def	2013-09-28 17:50:13 UTC (rev 12543)
@@ -113,25 +113,39 @@
 global PL_LEGEND_ROW_MAJOR
 PL_LEGEND_ROW_MAJOR = 128; 
 global PL_COLORBAR_LABEL_LEFT
-PL_COLORBAR_LABEL_LEFT = 1; 
+PL_COLORBAR_LABEL_LEFT = 0x1; 
 global PL_COLORBAR_LABEL_RIGHT
-PL_COLORBAR_LABEL_RIGHT = 2; 
+PL_COLORBAR_LABEL_RIGHT = 0x2; 
 global PL_COLORBAR_LABEL_TOP
-PL_COLORBAR_LABEL_TOP = 4; 
+PL_COLORBAR_LABEL_TOP = 0x4; 
 global PL_COLORBAR_LABEL_BOTTOM
-PL_COLORBAR_LABEL_BOTTOM = 8; 
+PL_COLORBAR_LABEL_BOTTOM = 0x8; 
 global PL_COLORBAR_IMAGE
-PL_COLORBAR_IMAGE = 16; 
+PL_COLORBAR_IMAGE = 0x10; 
 global PL_COLORBAR_SHADE
-PL_COLORBAR_SHADE = 32; 
+PL_COLORBAR_SHADE = 0x20; 
 global PL_COLORBAR_GRADIENT
-PL_COLORBAR_GRADIENT = 64; 
+PL_COLORBAR_GRADIENT = 0x40; 
+global PL_COLORBAR_CAP_NONE
+PL_COLORBAR_CAP_NONE = 0x80; 
 global PL_COLORBAR_CAP_LOW
-PL_COLORBAR_CAP_LOW = 128; 
+PL_COLORBAR_CAP_LOW = 0x100; 
 global PL_COLORBAR_CAP_HIGH
-PL_COLORBAR_CAP_HIGH = 256; 
+PL_COLORBAR_CAP_HIGH = 0x200; 
 global PL_COLORBAR_SHADE_LABEL
-PL_COLORBAR_SHADE_LABEL = 512; 
+PL_COLORBAR_SHADE_LABEL = 0x400; 
+global PL_COLORBAR_ORIENT_RIGHT
+PL_COLORBAR_ORIENT_RIGHT = 0x800; 
+global PL_COLORBAR_ORIENT_TOP
+PL_COLORBAR_ORIENT_TOP = 0x1000; 
+global PL_COLORBAR_ORIENT_LEFT
+PL_COLORBAR_ORIENT_LEFT = 0x2000; 
+global PL_COLORBAR_ORIENT_BOTTOM
+PL_COLORBAR_ORIENT_BOTTOM = 0x4000; 
+global PL_COLORBAR_BACKGROUND
+PL_COLORBAR_BACKGROUND = 0x8000; 
+global PL_COLORBAR_BOUNDING_BOX
+PL_COLORBAR_BOUNDING_BOX = 0x10000; 
 global PLSWIN_DEVICE
 PLSWIN_DEVICE = 1; # device coordinates
 global PLSWIN_WORLD

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Plplot-cvs] SF.net SVN: plplot:[12542] trunk/bindings/swig-support/CMakeLists.txt

[<ai...@us...>]

Revision: 12542
          http://sourceforge.net/p/plplot/code/12542
Author:   airwin
Date:     2013-09-28 17:30:43 +0000 (Sat, 28 Sep 2013)
Log Message:
-----------
Implement run-time explanatory message for the check_swig_documentation target.

Modified Paths:
--------------
    trunk/bindings/swig-support/CMakeLists.txt

Modified: trunk/bindings/swig-support/CMakeLists.txt
===================================================================
--- trunk/bindings/swig-support/CMakeLists.txt	2013-09-28 17:25:21 UTC (rev 12541)
+++ trunk/bindings/swig-support/CMakeLists.txt	2013-09-28 17:30:43 UTC (rev 12542)
@@ -31,6 +31,7 @@
     ${CMAKE_SOURCE_DIR}/doc/docbook/src/plplotdoc.xml.in
     ${CMAKE_SOURCE_DIR}/doc/docbook/src/api.xml
     ${CMAKE_CURRENT_BINARY_DIR}/swig_documentation.i_compare
+    COMMAND ${CMAKE_COMMAND} -E echo "Check that swig_documentation.i is consistent with doc/docbook/src/api.xml"
     COMMAND cmp 
     ${CMAKE_CURRENT_SOURCE_DIR}/swig_documentation.i
     ${CMAKE_CURRENT_BINARY_DIR}/swig_documentation.i_compare

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Plplot-cvs] SF.net SVN: plplot:[12541] trunk/bindings/f95/plplot_parameters.h

[<ai...@us...>]

Revision: 12541
          http://sourceforge.net/p/plplot/code/12541
Author:   airwin
Date:     2013-09-28 17:25:21 +0000 (Sat, 28 Sep 2013)
Log Message:
-----------
Regenerate this file to make it consistent with the updated #defines
in bindings/swig-support/plplotcapi.i.  This regeneration is
accomplished by running the check_f95_parameters target and copying
the comparison file generated in the build tree on top of this
source-tree file.

Modified Paths:
--------------
    trunk/bindings/f95/plplot_parameters.h

Modified: trunk/bindings/f95/plplot_parameters.h
===================================================================
--- trunk/bindings/f95/plplot_parameters.h	2013-09-28 17:18:21 UTC (rev 12540)
+++ trunk/bindings/f95/plplot_parameters.h	2013-09-28 17:25:21 UTC (rev 12541)
@@ -74,23 +74,40 @@
       integer, parameter :: PL_LEGEND_BACKGROUND = 32 
       integer, parameter :: PL_LEGEND_BOUNDING_BOX = 64 
       integer, parameter :: PL_LEGEND_ROW_MAJOR = 128 
-      integer, parameter :: PL_COLORBAR_LABEL_LEFT = 1 
-      integer, parameter :: PL_COLORBAR_LABEL_RIGHT = 2 
-      integer, parameter :: PL_COLORBAR_LABEL_TOP = 4 
-      integer, parameter :: PL_COLORBAR_LABEL_BOTTOM = 8 
-      integer, parameter :: PL_COLORBAR_IMAGE = 16 
-      integer, parameter :: PL_COLORBAR_SHADE = 32 
-      integer, parameter :: PL_COLORBAR_GRADIENT = 64 
-      integer, parameter :: PL_COLORBAR_CAP_NONE = 128 
-      integer, parameter :: PL_COLORBAR_CAP_LOW = 256
-      integer, parameter :: PL_COLORBAR_CAP_HIGH = 512 
-      integer, parameter :: PL_COLORBAR_SHADE_LABEL = 1024
-      integer, parameter :: PL_COLORBAR_ORIENT_RIGHT = 2048
-      integer, parameter :: PL_COLORBAR_ORIENT_TOP = 4096
-      integer, parameter :: PL_COLORBAR_ORIENT_LEFT = 8192
-      integer, parameter :: PL_COLORBAR_ORIENT_BOTTOM = 16384
-      integer, parameter :: PL_COLORBAR_BACKGROUND = 32768
-      integer, parameter :: PL_COLORBAR_BOUNDING_BOX = 65536
+      integer :: PL_COLORBAR_LABEL_LEFT 
+      data PL_COLORBAR_LABEL_LEFT / z'1' /
+      integer :: PL_COLORBAR_LABEL_RIGHT 
+      data PL_COLORBAR_LABEL_RIGHT / z'2' /
+      integer :: PL_COLORBAR_LABEL_TOP 
+      data PL_COLORBAR_LABEL_TOP / z'4' /
+      integer :: PL_COLORBAR_LABEL_BOTTOM 
+      data PL_COLORBAR_LABEL_BOTTOM / z'8' /
+      integer :: PL_COLORBAR_IMAGE 
+      data PL_COLORBAR_IMAGE / z'10' /
+      integer :: PL_COLORBAR_SHADE 
+      data PL_COLORBAR_SHADE / z'20' /
+      integer :: PL_COLORBAR_GRADIENT 
+      data PL_COLORBAR_GRADIENT / z'40' /
+      integer :: PL_COLORBAR_CAP_NONE 
+      data PL_COLORBAR_CAP_NONE / z'80' /
+      integer :: PL_COLORBAR_CAP_LOW 
+      data PL_COLORBAR_CAP_LOW / z'100' /
+      integer :: PL_COLORBAR_CAP_HIGH 
+      data PL_COLORBAR_CAP_HIGH / z'200' /
+      integer :: PL_COLORBAR_SHADE_LABEL 
+      data PL_COLORBAR_SHADE_LABEL / z'400' /
+      integer :: PL_COLORBAR_ORIENT_RIGHT 
+      data PL_COLORBAR_ORIENT_RIGHT / z'800' /
+      integer :: PL_COLORBAR_ORIENT_TOP 
+      data PL_COLORBAR_ORIENT_TOP / z'1000' /
+      integer :: PL_COLORBAR_ORIENT_LEFT 
+      data PL_COLORBAR_ORIENT_LEFT / z'2000' /
+      integer :: PL_COLORBAR_ORIENT_BOTTOM 
+      data PL_COLORBAR_ORIENT_BOTTOM / z'4000' /
+      integer :: PL_COLORBAR_BACKGROUND 
+      data PL_COLORBAR_BACKGROUND / z'8000' /
+      integer :: PL_COLORBAR_BOUNDING_BOX 
+      data PL_COLORBAR_BOUNDING_BOX / z'10000' /
       integer, parameter :: PLSWIN_DEVICE = 1 ! device coordinates
       integer, parameter :: PLSWIN_WORLD = 2 ! world coordinates
       integer, parameter :: PL_X_AXIS = 1 ! The x-axis

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Plplot-cvs] SF.net SVN: plplot:[12540] trunk/bindings/swig-support/swig_documentation.i

[<ai...@us...>]

Revision: 12540
          http://sourceforge.net/p/plplot/code/12540
Author:   airwin
Date:     2013-09-28 17:18:21 +0000 (Sat, 28 Sep 2013)
Log Message:
-----------
Regenerate this file to make it consistent with the updated
doc/docbook/src/api.xml.  This regeneration is accomplished by running
the check_swig_documentation target and copying the comparison file
generated in the build tree on top of this source-tree file.

Modified Paths:
--------------
    trunk/bindings/swig-support/swig_documentation.i

Modified: trunk/bindings/swig-support/swig_documentation.i
===================================================================
--- trunk/bindings/swig-support/swig_documentation.i	2013-09-28 16:52:20 UTC (rev 12539)
+++ trunk/bindings/swig-support/swig_documentation.i	2013-09-28 17:18:21 UTC (rev 12540)
@@ -192,12 +192,17 @@
         unconventional location (above box for X, right of box for Y). 
         n: Writes numeric labels at major tick intervals in the
         conventional location (below box for X, left of box for Y). 
-        o: Use custom labeling function to generate axis label text. 
-        The custom labeling function can be defined with the
-        plslabelfuncplslabelfunc; command. 
+        o: Use custom labelling function to generate axis label text. 
+        The custom labelling function can be defined with the
+        plslabelfunc command. 
         s: Enables subticks between major ticks, only valid if t is
         also specified. 
         t: Draws major ticks. 
+        u: Exactly like \"b\" except don't draw edge line. 
+        w: Exactly like \"c\" except don't draw edge line. 
+        x: Exactly like \"t\" (including the side effect of the
+        numerical labels for the major ticks) except exclude drawing
+        the major and minor tick marks. 
 
 
     xtick (PLFLT, input) :    World coordinate interval between major
@@ -352,14 +357,17 @@
         unconventional location (above box for X, right of box for Y). 
         n: Writes numeric labels at major tick intervals in the
         conventional location (below box for X, left of box for Y). 
-        o: Use custom labeling function to generate axis label text. 
-        The custom labeling function can be defined with the
-        plslabelfuncplslabelfunc; command. 
+        o: Use custom labelling function to generate axis label text. 
+        The custom labelling function can be defined with the
+        plslabelfunc command. 
         s: Enables subticks between major ticks, only valid if t is
         also specified. 
         t: Draws major ticks. 
         u: Exactly like \"b\" except don't draw edge line. 
         w: Exactly like \"c\" except don't draw edge line. 
+        x: Exactly like \"t\" (including the side effect of the
+        numerical labels for the major ticks) except exclude drawing
+        the major and minor tick marks. 
 
 
     xtick (PLFLT, input) :    World coordinate interval between major
@@ -425,9 +433,9 @@
         of data points before passing them to any of the drawing
         routines. 
         n: Writes numeric labels at major tick intervals. 
-        o: Use custom labeling function to generate axis label text. 
-        The custom labeling function can be defined with the
-        plslabelfuncplslabelfunc; command. 
+        o: Use custom labelling function to generate axis label text. 
+        The custom labelling function can be defined with the
+        plslabelfunc command. 
         s: Enables subticks between major ticks, only valid if t is
         also specified. 
         t: Draws major ticks. 
@@ -481,9 +489,9 @@
         right-hand vertical axis. 
         n: Writes numeric labels at major tick intervals on the
         left-hand vertical axis. 
-        o: Use custom labeling function to generate axis label text. 
-        The custom labeling function can be defined with the
-        plslabelfuncplslabelfunc; command. 
+        o: Use custom labelling function to generate axis label text. 
+        The custom labelling function can be defined with the
+        plslabelfunc command. 
         s: Enables subticks between major ticks, only valid if t is
         also specified. 
         t: Draws major ticks. 
@@ -554,10 +562,10 @@
     with potentially overlapping viewports and possibly more than one
     window (set of world coordinates) per viewport, window and the
     corresponding output world coordinates corresponds to the last
-    window created that fulfils the criterion that the relative device
-    coordinates are inside it.  Finally, in all cases where the input
-    relative device coordinates are not inside any viewport/window,
-    then window is set to -1. 
+    window created that fulfills the criterion that the relative
+    device coordinates are inside it.  Finally, in all cases where the
+    input relative device coordinates are not inside any
+    viewport/window, then window is set to -1. 
 ")
 plcalc_world;
 
@@ -654,6 +662,186 @@
 ")
 plcol1;
 
+%feature( "docstring", "Plot color bar for image, shade or gradient plots 
+
+DESCRIPTION:
+
+    Routine for creating a continuous color bar for image, shade, or
+    gradient plots. (See pllegend for similar functionality for creating
+    legends with discrete elements). The arguments of plcolorbar provide
+    control over the location and size of the color bar as well as the
+    location and characteristics of the elements (most of which are
+    optional) within that color bar.  The resulting color bar is clipped
+    at the boundaries of the current subpage. (N.B. the adopted coordinate
+    system used for some of the parameters is defined in the documentation
+    of the position parameter.) 
+
+    Redacted form: plcolorbar(p_colorbar_width, p_colorbar_height,  opt,
+    position, x, y, x_length, y_length, bg_color, bb_color, bb_style,
+    low_cap_color, high_cap_color, cont_color, cont_width, label_opts,
+    labels, axis_opts, ticks, sub_ticks, values)
+
+    This function is used in examples 16 and 33. 
+
+
+
+SYNOPSIS:
+
+plcolorbar(p_colorbar_width, p_colorbar_height, opt, position, x, y, x_length, y_length, bg_color, bb_color, bb_style, low_cap_color, high_cap_color, cont_color, cont_width, n_labels, label_opts, labels, naxes, axis_opts, ticks, sub_ticks, n_values, values)
+
+ARGUMENTS:
+
+    p_colorbar_width (PLFLT *, output) :    Pointer to a location which
+    contains (after the call) the labelled and decorated color bar
+    width in adopted coordinates. 
+
+    p_colorbar_height (PLFLT *, output) :    Pointer to a location which
+    contains (after the call) the labelled and decorated color bar
+    height in adopted coordinates. 
+
+    opt (PLINT, input) :    opt contains bits controlling the overall
+    color bar.  The orientation (direction of the maximum value) of
+    the color bar is specified with PL_ORIENT_RIGHT, PL_ORIENT_TOP,
+    PL_ORIENT_LEFT, or PL_ORIENT_BOTTOM.  If none of those bits are
+    specified, the default orientation is toward the top, i.e., a
+    vertical color bar. If the PL_COLORBAR_BACKGROUND bit is set, plot
+    a (semi-transparent) background for the color bar. If the
+    PL_COLORBAR_BOUNDING_BOX bit is set, plot a bounding box for the
+    color bar. The type of color bar must be specified with one of
+    PL_COLORBAR_IMAGE, PL_COLORBAR_SHADE, or PL_COLORBAR_GRADIENT. If
+    more than one of those bits is set only the first one in the above
+    list is honored. The position of the (optional) label/title can be
+    specified with PL_LABEL_RIGHT, PL_LABEL_TOP, PL_LABEL_LEFT, or
+    PL_LABEL_BOTTOM.  If no label position bit is set then no label
+    will be drawn. If more than one of this list of bits is specified,
+    only the first one on the list is honored. End-caps for the color
+    bar can added with PL_COLORBAR_CAP_LOW and PL_COLORBAR_CAP_HIGH.
+    If a particular color bar cap option is not specified then no cap
+    will be drawn for that end. As a special case for
+    PL_COLORBAR_SHADE, the option PL_COLORBAR_SHADE_LABEL can be
+    specified. If this option is provided then any tick marks and tick
+    labels will be placed at the breaks between shaded segments. TODO:
+    This should be expanded to support custom placement of tick marks
+    and tick labels at custom value locations for any color bar type. 
+
+    position (PLINT, input) :     position contains bits which control the
+    overall position of the color bar and the definition of the
+    adopted coordinates used for positions just like what is done for
+    the position argument for pllegend. However, note that the
+    defaults for the position bits (see below) are different than the
+    pllegend case. The combination of the PL_POSITION_LEFT,
+    PL_POSITION_RIGHT, PL_POSITION_TOP, PL_POSITION_BOTTOM,
+    PL_POSITION_INSIDE, and PL_POSITION_OUTSIDE bits specifies one of
+    the 16 possible standard positions (the 4 corners and centers of
+    the 4 sides for both the inside and outside cases) of the color
+    bar relative to the adopted coordinate system. The corner
+    positions are specified by the appropriate combination of two of
+    the PL_POSITION_LEFT, PL_POSITION_RIGHT, PL_POSITION_TOP, and
+    PL_POSITION_BOTTOM bits while the sides are specified by a single
+    value of one of those bits.  The adopted coordinates are
+    normalized viewport coordinates if the PL_POSITION_VIEWPORT bit is
+    set or normalized subpage coordinates if the PL_POSITION_SUBPAGE
+    bit is set. Default position bits: If none of PL_POSITION_LEFT,
+    PL_POSITION_RIGHT, PL_POSITION_TOP, or PL_POSITION_BOTTOM are set,
+    then use PL_POSITION_RIGHT. If neither of PL_POSITION_INSIDE or
+    PL_POSITION_OUTSIDE is set, use PL_POSITION_OUTSIDE. If neither of
+    PL_POSITION_VIEWPORT or PL_POSITION_SUBPAGE is set, use
+    PL_POSITION_VIEWPORT. 
+
+    x (PLFLT, input) :      X offset of the color bar position in adopted
+    coordinates from the specified standard position of the color bar.
+    For positive x, the direction of motion away from the standard
+    position is inward/outward from the standard corner positions or
+    standard left or right positions if the
+    PL_POSITION_INSIDE/PL_POSITION_OUTSIDE bit is set in position. 
+    For the standard top or bottom positions, the direction of motion
+    is toward positive X. 
+
+    y (PLFLT, input) :      Y offset of the color bar position in adopted
+    coordinates from the specified standard position of the color bar.
+    For positive y, the direction of motion away from the standard
+    position is inward/outward from the standard corner positions or
+    standard top or bottom positions if the
+    PL_POSITION_INSIDE/PL_POSITION_OUTSIDE bit is set in position. 
+    For the standard left or right positions, the direction of motion
+    is toward positive Y. 
+
+    x_length (PLFLT, input) :     Length of the body of the color bar in
+    the X direction in adopted coordinates. 
+
+    y_length (PLFLT, input) :     Length of the body of the color bar in
+    the Y direction in adopted coordinates. 
+
+    bg_color (PLINT, input) :     The cmap0 color of the background for the
+    color bar (PL_COLORBAR_BACKGROUND). 
+
+    bb_color (PLINT, input) :     The cmap0 color of the bounding-box line
+    for the color bar (PL_COLORBAR_BOUNDING_BOX). 
+
+    bb_style (PLINT, input) :     The pllsty style number for the
+    bounding-box line for the color bar (PL_COLORBAR_BACKGROUND). 
+
+    low_cap_color (PLFLT, input) :    The cmap1 color of the low-end color
+    bar cap, if it is drawn (PL_COLORBAR_CAP_LOW). 
+
+    high_cap_color (PLFLT, input) :    The cmap1 color of the high-end
+    color bar cap, if it is drawn  (PL_COLORBAR_CAP_HIGH). 
+
+    cont_color (PLINT, input) :    The cmap0 contour color for
+    PL_COLORBAR_SHADE plots. This is passed directly to plshades, so
+    it will be interpreted according to the design of plshades. 
+
+    cont_width (PLFLT, input) :    Contour width for PL_COLORBAR_SHADE
+    plots. This is passed directly to plshades, so it will be
+    interpreted according to the design of plshades. 
+
+    n_labels (PLINT, input) :     Number of labels to place around the
+    color bar. 
+
+    label_opts (const PLINT *, input) :    Options for each of 
+    n_labels labels. 
+
+    labels (const char *const *, input) :    n_labels text labels for the
+    color bar. No label is drawn if no label position is specified
+    with one of the PL_COLORBAR_LABEL_RIGHT, PL_COLORBAR_LABEL_TOP,
+    PL_COLORBAR_LABEL_LEFT, or PL_COLORBAR_LABEL_BOTTOM bits in the
+    corresponding label_opts field. 
+
+    n_axes (PLINT, input) :    Number of axis definitions provided. This
+    value must be greater than 0. It is typically 1 (numerical axis
+    labels are provided for one of the long edges of the color bar),
+    but it can be larger if multiple numerical axis labels for the
+    long edges of the color bar are desired. 
+
+    axis_opts (const char *const *, input) :    An array of n_axes axis
+    options (interpreted as for plbox) for the color bar's axis
+    definitions. 
+
+    ticks (PLFLT *, input) :    An array of n_axes values of the spacing
+    of the major tick marks (interpreted as for plbox) for the color
+    bar's axis definitions. 
+
+    sub_ticks (PLINT *, input) :    An array of n_axes values of the
+    number of subticks (interpreted as for plbox) for the color bar's
+    axis definitions. 
+
+    n_values (PLINT, input) :     An array containing the number of
+    elements in each of the n_axes rows of the two-dimensional values
+    array. 
+
+    values (PLFLT *const *, input) :    A two-dimensional array containing
+    the numeric values for the data range represented by the color
+    bar. For a row index of i_axis (where 0 < i_axis < n_axes), the
+    number of elements in the row is specified by n_values[i_axis].
+    For PL_COLORBAR_IMAGE and PL_COLORBAR_GRADIENT the number of
+    elements is 2, and the corresponding row elements of the values
+    array are the minimum and maximum value represented by the
+    colorbar.  For PL_COLORBAR_SHADE, the number and values of the
+    elements of a row of the values array is interpreted the same as
+    the nlevel and clevel arguments of plshades. 
+")
+plcolorbar;
+
 %feature( "docstring", "Contour plot 
 
 DESCRIPTION:
@@ -2267,7 +2455,7 @@
 
     nx, ny (PLINT, input) :    Dimensions of idata 
 
-    xmin, xmax, ymin, ymax (PLFLT, input) :    Plot coordinates to strecth
+    xmin, xmax, ymin, ymax (PLFLT, input) :    Plot coordinates to stretch
     the image data to.  idata[0][0] corresponds to (xmin, ymin) and
     idata[nx - 1][ny - 1] corresponds to (xmax, ymax). 
 
@@ -2371,13 +2559,14 @@
 DESCRIPTION:
 
     Routine for creating a discrete plot legend with a plotted filled box,
-    line, and/or line of symbols for each annotated legend entry.  The
-    arguments of pllegend provide control over the location and size of
-    the legend as well as the location and characteristics of the elements
-    (most of which are optional) within that legend.  The resulting legend
-    is clipped at the boundaries of the current subpage. (N.B. the adopted
-    coordinate system used for some of the parameters is defined in the
-    documentation of the position parameter.) 
+    line, and/or line of symbols for each annotated legend entry.  (See
+    plcolorbar for similar functionality for creating continuous color
+    bars.)  The arguments of pllegend provide control over the location
+    and size of the legend as well as the location and characteristics of
+    the elements (most of which are optional) within that legend.  The
+    resulting legend is clipped at the boundaries of the current subpage. 
+    (N.B. the adopted coordinate system used for some of the parameters is
+    defined in the documentation of the position parameter.) 
 
     Redacted form: pllegend(p_legend_width, p_legend_height,  opt,
     position, x, y, plot_width, bg_color, bb_color, bb_style, nrow,
@@ -2386,7 +2575,7 @@
     box_scales, box_line_widths, line_colors, line_styles, line_widths,
     symbol_colors, symbol_scales,  symbol_numbers, symbols)
 
-    This function is used in examples 4 and 26. 
+    This function is used in examples 4, 26, and 33. 
 
 
 
@@ -2421,22 +2610,28 @@
     plot the resulting array of legend entries in row-major order.
     Otherwise, plot the legend entries in column-major order. 
 
-    position (PLINT, input) :     position contains bits controlling the
+    position (PLINT, input) :     position contains bits which control the
     overall position of the legend and the definition of the adopted
-    coordinates used for positions. The combination of the
-    PL_POSITION_LEFT, PL_POSITION_RIGHT, PL_POSITION_TOP,
-    PL_POSITION_BOTTOM, PL_POSITION_INSIDE, and PL_POSITION_OUTSIDE
-    bits specifies one of the 16 possible standard positions (the 4
-    corners and 4 side centers for both the inside and outside cases)
-    of the legend relative to the adopted coordinate system. The
-    adopted coordinates are normalized viewport coordinates if the
-    PL_POSITION_VIEWPORT bit is set or normalized subpage coordinates
-    if the PL_POSITION_SUBPAGE bit is set. Default position bits: If
-    none of PL_POSITION_LEFT, PL_POSITION_RIGHT, PL_POSITION_TOP, or
-    PL_POSITION_BOTTOM are set, then use the combination of
-    PL_POSITION_RIGHT and PL_POSITION_TOP. If neither of
-    PL_POSITION_INSIDE or PL_POSITION_OUTSIDE is set, use
-    PL_POSITION_INSIDE. If neither of PL_POSITION_VIEWPORT or
+    coordinates used for positions just like what is done for the
+    position argument for plcolorbar. However, note that the defaults
+    for the position bits (see below) are different than the
+    plcolorbar case.  The combination of the PL_POSITION_LEFT,
+    PL_POSITION_RIGHT, PL_POSITION_TOP, PL_POSITION_BOTTOM,
+    PL_POSITION_INSIDE, and PL_POSITION_OUTSIDE bits specifies one of
+    the 16 possible standard positions (the 4 corners and centers of
+    the 4 sides for both the inside and outside cases) of the legend
+    relative to the adopted coordinate system. The corner positions
+    are specified by the appropriate combination of two of the
+    PL_POSITION_LEFT, PL_POSITION_RIGHT, PL_POSITION_TOP, and
+    PL_POSITION_BOTTOM bits while the sides are specified by a single
+    value of one of those bits.  The adopted coordinates are
+    normalized viewport coordinates if the PL_POSITION_VIEWPORT bit is
+    set or normalized subpage coordinates if the PL_POSITION_SUBPAGE
+    bit is set. Default position bits: If none of PL_POSITION_LEFT,
+    PL_POSITION_RIGHT, PL_POSITION_TOP, or PL_POSITION_BOTTOM are set,
+    then use the combination of PL_POSITION_RIGHT and PL_POSITION_TOP.
+    If neither of PL_POSITION_INSIDE or PL_POSITION_OUTSIDE is set,
+    use PL_POSITION_INSIDE. If neither of PL_POSITION_VIEWPORT or
     PL_POSITION_SUBPAGE is set, use PL_POSITION_VIEWPORT. 
 
     x (PLFLT, input) :      X offset of the legend position in adopted
@@ -2461,14 +2656,14 @@
     of the plot area (where the colored boxes, lines, and/or lines of
     symbols are drawn) of the legend. 
 
-    bg_color (PLINT, input) :     The cmap0 index of the background color
-    for the legend (PL_LEGEND_BACKGROUND). 
+    bg_color (PLINT, input) :     The cmap0 color of the background for the
+    legend (PL_LEGEND_BACKGROUND). 
 
-    bb_color (PLINT, input) :     The cmap0 index of the color of the
-    bounding-box line for the legend (PL_LEGEND_BOUNDING_BOX). 
+    bb_color (PLINT, input) :     The cmap0 color of the bounding-box line
+    for the legend (PL_LEGEND_BOUNDING_BOX). 
 
-    bb_style (PLINT, input) :     The cmap0 index of the background color
-    for the legend (PL_LEGEND_BACKGROUND). 
+    bb_style (PLINT, input) :     The pllsty style number for the
+    bounding-box line for the legend (PL_LEGEND_BACKGROUND). 
 
     nrow (PLINT, input) :    The cmap0 index of the background color for
     the legend (PL_LEGEND_BACKGROUND). 
@@ -2521,14 +2716,14 @@
     is left justified, centred, or right justified within the text
     area, but other values are allowed as well. 
 
-    text_colors (const PLINT *, input) :    Array of nlegend text colors
-    (cmap0 indices). 
+    text_colors (const PLINT *, input) :    Array of nlegend cmap0 text
+    colors. 
 
-    text (const char **, input) :    Array of nlegend text string
+    text (const char *const *, input) :    Array of nlegend text string
     annotations. 
 
-    box_colors (const PLINT *, input) :    Array of nlegend colors (cmap0
-    indices) for the discrete colored boxes (
+    box_colors (const PLINT *, input) :    Array of nlegend cmap0 colors
+    for the discrete colored boxes (
     PL_LEGEND_COLOR_BOX). 
 
     box_patterns (const PLINT *, input) :    Array of nlegend patterns
@@ -2544,8 +2739,8 @@
     widths for the patterns specified by box_patterns (
     PL_LEGEND_COLOR_BOX). 
 
-    line_colors (const PLINT *, input) :    Array of nlegend line colors
-    (cmap0 indices) (
+    line_colors (const PLINT *, input) :    Array of nlegend cmap0 line
+    colors (
     PL_LEGEND_LINE). 
 
     line_styles (const PLINT *, input) :    Array of nlegend line styles
@@ -2555,8 +2750,8 @@
     line_widths (const PLFLT *, input) :    Array of nlegend line widths (
     PL_LEGEND_LINE). 
 
-    symbol_colors (const PLINT *, input) :    Array of nlegend symbol
-    colors (cmap0 indices)    (
+    symbol_colors (const PLINT *, input) :    Array of nlegend cmap0
+    symbol colors  (
     PL_LEGEND_SYMBOL). 
 
     symbol_scales (const PLFLT *, input) :    Array of nlegend scale
@@ -2567,8 +2762,8 @@
     symbols to be drawn across the width of the plotted area (
     PL_LEGEND_SYMBOL). 
 
-    symbols (const char **, input) :    Array of nlegend symbols (plpoin
-    indices)  (
+    symbols (const char *const *, input) :    Array of nlegend symbols
+    (plpoin indices)  (
     PL_LEGEND_SYMBOL). 
 ")
 pllegend;
@@ -2898,7 +3093,7 @@
         at which function is defined. 
         opt=MAG_COLOR: Each line in the mesh is colored according to
         the z value being plotted. The color is used from the current
-        colormap 1. 
+        color map 1. 
         opt=BASE_CONT: A contour plot is drawn at the base XY plane
         using parameters 
     nlevel and 
@@ -4971,12 +5166,12 @@
 
     label_func (void (*) (PLINT, PLFLT, char *, PLINT, void *), input) :  
      This is the custom label function.  In order to reset to the
-    default labeling, set this to NULL. The labeling function
+    default labelling, set this to NULL. The labelling function
     parameters are, in order: axis:    This indicates which axis a
     label is being requested for. The value will be one of PL_X_AXIS,
     PL_Y_AXIS or PL_Z_AXIS. 
 
-    value:    This is the value along the axis which is being labeled. 
+    value:    This is the value along the axis which is being labelled. 
 
     label_text:    The string representation of the label value. 
 
@@ -5369,7 +5564,7 @@
     device name keyword for the desired output device must be supplied as
     an argument.  The device keywords are the same as those printed out by
     plstar.  If the requested device is not available, or if the input
-    string is empty or begins with ``?'', the prompted startup of plstar
+    string is empty or begins with ``?'', the prompted start up of plstar
     is used.  This routine also divides the output device into nx by ny
     subpages, each of which may be used independently.	The subroutine
     pladv is used to advance from one subpage to the next. 
@@ -5390,7 +5585,7 @@
 
     device (const char *, input) :    Device name (keyword) of the
     required output device.  If NULL or if the first character is a
-    ``?'', the normal (prompted) startup is used. 
+    ``?'', the normal (prompted) start up is used. 
 
     nx (PLINT, input) :    Number of subpages to divide output page in the
     horizontal direction. 
@@ -5425,7 +5620,7 @@
 
     transform_fun (void (*) (PLFLT, PLFLT, PLFLT*, PLFLT*, PLPointer) ,
     input) :    Pointer to a function that defines a transformation
-    from the input (x, y) coordinate to a new plot world coordiante. 
+    from the input (x, y) coordinate to a new plot world coordinate. 
 
     data (PLPointer, input) :     Optional extra data for 
     transform_fun. 
@@ -5514,13 +5709,14 @@
 ")
 plstring3;
 
-%feature( "docstring", "Add a point to a stripchart 
+%feature( "docstring", "Add a point to a strip chart 
 
 DESCRIPTION:
 
-    Add a point to a given pen of a given stripchart. There is no need for
-    all pens to have the same number of points or to be equally sampled in
-    the x coordinate. Allocates memory and rescales as necessary. 
+    Add a point to a given pen of a given strip chart. There is no need
+    for all pens to have the same number of points or to be equally
+    sampled in the x coordinate. Allocates memory and rescales as
+    necessary. 
 
     Redacted form: plstripa(id, p, x, y)
 
@@ -5535,7 +5731,7 @@
 ARGUMENTS:
 
     id (PLINT, input) :    Identification number (set up in plstripc) of
-    the stripchart. 
+    the strip chart. 
 
     p (PLINT, input) :      Pen number (ranges from 0 to 3). 
 
@@ -5545,11 +5741,11 @@
 ")
 plstripa;
 
-%feature( "docstring", "Create a 4-pen stripchart 
+%feature( "docstring", "Create a 4-pen strip chart 
 
 DESCRIPTION:
 
-    Create a 4-pen stripchart, to be used afterwards by plstripa
+    Create a 4-pen strip chart, to be used afterwards by plstripa
 
     Redacted form:  General: plstripc(id, xspec, yspec, xmin, xmax, xjump,
     ymin, ymax, xlpos, ylpos, y_ascl, acc, colbox, collab, colline,
@@ -5569,7 +5765,7 @@
 
 ARGUMENTS:
 
-    id (PLINT *, output) :    Identification number of stripchart to use
+    id (PLINT *, output) :    Identification number of strip chart to use
     on plstripa and plstripd. 
 
     xspec (char *, input) :    X-axis specification as in plbox. 
@@ -5623,11 +5819,11 @@
 ")
 plstripc;
 
-%feature( "docstring", "Deletes and releases memory used by a stripchart 
+%feature( "docstring", "Deletes and releases memory used by a strip chart 
 
 DESCRIPTION:
 
-    Deletes and releases memory used by a stripchart. 
+    Deletes and releases memory used by a strip chart. 
 
     Redacted form: plstripd(id)
 
@@ -5641,7 +5837,7 @@
 
 ARGUMENTS:
 
-    id (PLINT, input) :    Identification number of stripchart to delete. 
+    id (PLINT, input) :    Identification number of strip chart to delete. 
 ")
 plstripd;
 

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.