Release announcements for PLplot in DocBook-XML format ------------------------------------------------------ This directory contains the source files in DocBook-XML format for the PLplot release announcements starting at version > 5.2.1. It contains also the stylesheets and the Makefile for building the output files. XHTML, PDF, and text versions can be obtained from XML source. The CMake-based build system provides MakeFile rules to build the *.xhtml and *.txt forms of our release announcements from the *.xml files which are the DocBook-XML source. The generated Makefile rules were developed on Debian and have not been tested for portability although they should work on other Linux distros if you have the right packages installed. The programs and respective (Debian) packages needed are: xmlto xmlto lynx lynx-cur onsgmls opensp -- Rafael Laboissiere , Fri Oct 24 10:05:00 CEST 2003 The idea of generating our release announcements from DocBook was abandoned after 5.3.1 when Rafael stepped down as release manager, but I feel it is worthwhile to reinstate this good idea again. Therefore, I have reimplemented all validation and build rules using our CMake-based build system rather than the old special Makefile that Rafael used. The current list of announcement versions is 5.3.0 and 5.3.1. To add another one (say for 5.9.1), * cd to www/announce, and add 5.9.1 to the list of versions in CMakeLists.txt. * copy the last announcement to the current one: cp announce-plplot-5.3.1.xml announce-plplot-5.9.1.xml * edit that current version appropriately: * validate all source files (including the present one): make validate_announcements * and generate all announcements (including the present one): make generate_announcements Once satisfied with the current announcement, add the current announcement source (in this case announce-plplot-5.9.1.xml) to our git repository. Actually installing the complete list of static and generated announcements on our website is handled by www/CMakeLists.txt. -- Alan W. Irwin 2008-10-24