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

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

Revision: 12974
          http://sourceforge.net/p/plplot/code/12974
Author:   airwin
Date:     2014-02-02 19:32:14 +0000 (Sun, 02 Feb 2014)
Log Message:
-----------
Update what has been accomplished for this forthcoming release.

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

Modified: trunk/README.release
===================================================================
--- trunk/README.release	2014-01-29 17:33:31 UTC (rev 12973)
+++ trunk/README.release	2014-02-02 19:32:14 UTC (rev 12974)
@@ -43,8 +43,41 @@
 
 2. Changes relative to the previous release
 
-None at this time.
+2.1 Update the parts of the build system that find Tcl-related software.
 
+The build system now checks extensively for the consistency of the
+Tcl/Tk/Itcl/Itk/Iwidgets components that are found.
+
+2.2 Update the Tcl-related epa_build configurations.
+
+The epa_build subproject of PLplot design goal is to make it easy to
+build PLplot dependencies on all platforms.
+
+Previously version 8.6 of Tcl/Tk and version 3 of Itcl/Itk, version 4
+of Itcl/Itk, and versions 4.0 and 4.1 of Iwidgets could be epa_built
+on Linux, but now the epa_build configuration files have been updated
+so these builds also succeed on MinGW/MSYS.
+
+2.3 Update the PLplot build system so that the Tcl/Tk/Itcl/Itk/Iwidgets
+bindings and examples work on MinGW/MSYS.
+
+2.4 Update api.xml to be consistent with our public API defined by plplot.h.
+
+This substantial improvement to our DocBook documentation for our
+public API has been made possible by the "check" application written
+by Hǎiliàng Wáng (see
+https://github.com/hailiang/go-plplot/tree/master/c/check) which uses
+gccxml to convert the API information in plplot.h into XML and
+compares those results (names of functions in our public API, and for
+each of those functions, number of arguments, names of arguments, and
+types of arguments) with the corresponding information in api.xml.
+The original report from the check_api_xml_consistency target (which
+runs the check programme) showed ~150 inconsistencies between api.xml
+and our public API including several functions in our public API that
+were not documented at all in api.xml.  That number of inconsistencies
+has now been reduced to zero which constitutes a substantial upgrade
+in the quality of our API documentation.
+
 3. Tests made for the current release.
 
 None at this time.  

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