On 2014-11-12 09:42-0000 Arjen Markus wrote: > Hi Alan, > > >> -----Original Message----- >> From: Alan W. Irwin [mailto:ir...@beluga.phys.uvic.ca] > > >>> The build process still is complaining about validity errors, but I >> assume that it is mere hair splitting :). >> >> These sound like warnings from the validator used by the xmlto command, and >> it is >> quite possible your version of that validator is more sensitive to errors >> than my rather >> old version. Anyhow, I am interested in exactly what those issues were so >> could you >> send the complete VERBOSE=1 results of the documentation build to the list >> as an >> attachment? >>
> See the attachment Hi Arjen: Thanks very much for that. I have had a look at those validator warnings, and it turns out they are bogus. For example, the only appearance of "ada_overview" in all our DocBook source is software@raven> grep ada_overview * ada.xml: <sect1 id="ada_overview"> The above grep command shows this id value is completely unique, and yet in your output the warning /cygdrive/d/plplot-svn/build-cygwin-docbook/doc/docbook/src/plplotdoc-print.xml:41: element sect1: validity error : ID ada_overview already defined appears 3 times and similarly for many other "garden-variety" section id values. I just checked, and there are no validity warnings at all on my TeX platform (from Debian stable) so I am virtually positive these validity errors (all of which are the form "ID .* already defined") you are encountering are due to a bug in the Cygwin version of the validator that is used with the dblatex command. So your instinct that these "already defined" validity issues should be ignored turned out to be correct, but it is always good to check (at least once like I have just done) to make sure. Note, this is just one more example of the validity checker for dblatex being somewhat problematic. For example, I have seen it crash with segfaults in the past whenever there was a real validity issue. However, it does complement the ongsmls validity checker because sometimes it does pick up real validity issues that the onsgmls validity checker misses. However, that latter validity checker is completely reliable in that it never produces a bogus validity error message or have any run-time problems. So be sure to install the OpenSP package on Cygwin that contains onsgmls, and always use the command "make validate" to validate our DocBook source code using onsgmls before actually building our documentation. > [...] the output is the result from the _second_ pass with make (the first fails as nm can not find "<build-directory>/src/libplplot.so") This build issue still continues to completely puzzle me. I don't confirm that issue on my platform, and I can see nothing wrong with the CMake code that enforces the constraint that the plplot library MUST be built before the nm command is executed. But obviously from your and Phil's experience there is still something problematic with the CMake dependency logic (or maybe even a Cygwin CMake bug?) which allows nm to be run before the library is built so you are forced to use that double build workaround to get around it. So the only advice I can give you is continue to use that workaround, but this is not very satisfying since I completely dislike "computer magic" like this. Because of these nagging build dependency issues and bogus validity issues please carefully check the resulting Cygwin-generated documentation (e.g., do a detailed read of some section in plplotdoc-print.pdf that you are familiar with) to make sure it looks good, and if you do spot any issues in the Cygwin-generated version, you can compare with http://plplot.sourceforge.net/docbook-manual/plplot-5.10.0.pdf to see whether that same issue occurred for the Linux-generated version. 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 __________________________ ------------------------------------------------------------------------------ Comprehensive Server Monitoring with Site24x7. Monitor 10 servers for $9/Month. Get alerted through email, SMS, voice calls or mobile push notifications. Take corrective actions from your mobile device. http://pubads.g.doubleclick.net/gampad/clk?id=154624111&iu=/4140/ostg.clktrk _______________________________________________ Plplot-devel mailing list Plplot-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/plplot-devel
