Re: [Plplot-devel] Docbook on Cygwin

[Alan W. I. <ir...@be...>]

On 2014-11-15 10:03-0000 phil rosenberg wrote:

> Hi AlanNo problem with the platform check - I had been through that cycle before so had a good idea where to look. And thanks for the cleanup - I keep forgetting about the CMake if syntax. As it happens CMAKE_SYSTEM_NAME does appear to be CYGWIN when output to screen at the top of the Cmake output (and as a check by me immediately before the if statement), yet that check still fails. After trying to work out why for so long the first time round I gave up and removed the check.
> I just tried make validate, unfortunately the results didn't look good. Output below for the -DBUILD_DOC on and off cases although I think they are essentially the same

> /usr/bin/onsgmls:E: cannot open "/usr/share/xml/declaration/xml.dcl" (No such file or directory)

That is the first error message in both cases and therefore likely the
key issue.

The handy-dandy Cygwin package search engine shows that

OpenSP-1.5.2-2 contains both /usr/bin/onsgmls and
/usr/share/sgml/OpenSP/xml.dcl

and my assumption is you should use that latter file for the Cygwin
platform.

You will find we currently hard-code
"/usr/share/xml/declaration/xml.dcl" in cmake/modules/docbook.cmake.
That works fine in the Linux case, but that is apparently the wrong
location of that file for the Cygwin case. So stick some "if(CYGWIN)"
logic in that file to choose /usr/share/sgml/OpenSP/xml.dcl for the
Cygwin platform and /usr/share/xml/declaration/xml.dcl otherwise, and
I am pretty sure (based on the above assumption) that will give
you a good "make validate" result.

BTW, once "make validate" works for the present case where the DocBook
source is valid, try invalid Docbook src (e.g., by temporarily editing
our source to improperly spell a tag). You should find "make validate"
quickly finds such validation errors without having to build all the
documentation.

Alan
__________________________
Alan W. Irwin

Astronomical research affiliation with Department of Physics and Astronomy,
University of Victoria (astrowww.phys.uvic.ca).

Programming affiliations with the FreeEOS equation-of-state
implementation for stellar interiors (freeeos.sf.net); the Time
Ephemerides project (timeephem.sf.net); PLplot scientific plotting
software package (plplot.sf.net); the libLASi project
(unifont.org/lasi); the Loads of Linux Links project (loll.sf.net);
and the Linux Brochure Project (lbproject.sf.net).
__________________________

Linux-powered Science
__________________________