plplot-devel

[Plplot-devel] Error when extracting Octave docs from api.xml

[<jc...@fe...>]

Hi,

I got the following error with a clean cvs.

...
mkdir -p plplot_octave_txt
cp etc/plplot.doc plplot_octave_txt/plplot.doc
cd plplot_octave_txt; \
../../../doc/docbook/bin/api2text.pl \
../../../doc/docbook/src/plplotdoc.xml.in \
../../../doc/docbook/src/api.xml

undefined entity at line 2858, column 62, byte 84237 at 
/usr/lib/perl5/site_perl
/5.8.0/i586-linux-thread-multi/XML/Parser.pm line 185
make[4]: *** [plplot_octave_txt/plplot.doc] Error 255


I never was able to build the docbook documentation, but there was no 
problem in running the scripts that generated the online Octave docs.

Joao

Re: [Plplot-devel] Error when extracting Octave docs from api.xml

[Rafael L. <lab...@ps...>]

* João Cardoso <jc...@fe...> [2003-03-07 15:26]:

> 
> Hi,
> 
> I got the following error with a clean cvs.
> 
> ...
> mkdir -p plplot_octave_txt
> cp etc/plplot.doc plplot_octave_txt/plplot.doc
> cd plplot_octave_txt; \
> ../../../doc/docbook/bin/api2text.pl \
> ../../../doc/docbook/src/plplotdoc.xml.in \
> ../../../doc/docbook/src/api.xml
> 
> undefined entity at line 2858, column 62, byte 84237 at 
> /usr/lib/perl5/site_perl
> /5.8.0/i586-linux-thread-multi/XML/Parser.pm line 185
> make[4]: *** [plplot_octave_txt/plplot.doc] Error 255
> 
> 
> I never was able to build the docbook documentation, but there was no 
> problem in running the scripts that generated the online Octave docs.

It works fine here.  To prove it, I am attaching below the resulting file
plgriddata.txt, which never existed before.  I need more information in
order to understand where your bug comes from.

-- 
Rafael

Re: [Plplot-devel] Error when extracting Octave docs from api.xml

[<jc...@fe...>]

On Friday 07 March 2003 15:59, Rafael Laboissiere wrote:
| * Jo=E3o Cardoso <jc...@fe...> [2003-03-07 15:26]:
| > Hi,
| >
| > I got the following error with a clean cvs.
| >
| > ...
| > mkdir -p plplot_octave_txt
| > cp etc/plplot.doc plplot_octave_txt/plplot.doc
| > cd plplot_octave_txt; \
| > ../../../doc/docbook/bin/api2text.pl \
| > ../../../doc/docbook/src/plplotdoc.xml.in \
| > ../../../doc/docbook/src/api.xml
| >
| > undefined entity at line 2858, column 62, byte 84237 at
| > /usr/lib/perl5/site_perl
| > /5.8.0/i586-linux-thread-multi/XML/Parser.pm line 185
| > make[4]: *** [plplot_octave_txt/plplot.doc] Error 255
| >
| >
| > I never was able to build the docbook documentation, but there was
| > no problem in running the scripts that generated the online Octave
| > docs.
|
| It works fine here.

Yes, of course, as you can generate the documentation you can parse=20
api.xml. As I can't generate the documentation (I'm a regular user in=20
this context), I can't parse api.xml.

I may be wrong when I say "parse the api.xml", but when I say that I'm a=20
regular user in this context I'm right :(

| I need more information in order to understand where your bug comes=20
from.

I don't know what info to give you other then the error message and the=20
perls that I have installled.

But notice that I have installed almost all from perl with something=20
like xml/sgml in its name, and in this respect I'm not a regular user,=20
as I believe that most systems don't have this all.

[jcard@feup] rpm -qa | fgrep perl
perl-gettext-1.01-310
perl-XML-Generator-0.91-42
perl-CDDB_get-2.10-38
perl-SNMP-4.2.0-312
perl-HTML-Tagset-3.03-285
perl-Parse-RecDescent-1.80-18
perl-Tie-IxHash-1.21-317
perl-PDA-Pilot-0.8.0-311
perl-GnuPG-0.07-299
perl-URI-1.20-30
perl-HTML-Parser-3.26-29
perl-XML-DOM-1.39-24
mod_perl-1.27-31
perl-libwww-perl-5.65-29
perl-5.8.0-45
perl-Tk-800.024-40
perl-XML-Parser-2.31-30
perl-IO-Socket-SSL-0.81-22
perl-DateManip-5.40-232
perl-Parse-Yapp-1.05-134
perl-SGMLS-1.03ii-128
perl-Unicode-String-2.06-212
perl-XML-RegExp-0.03-216
perl-XML-Simple-1.08-33
perl-XML-Writer-0.4-234
perl-libxml-perl-0.07-219
perl-XML-Stream-1.15-20
perl-XML-XSLT-0.40-15
perl-XML-XQL-0.67-33
perl-Net_SSLeay-1.18-44

Joao

Re: [Plplot-devel] Error when extracting Octave docs from api.xml

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

From Joao's recent post, his perl system cannot parse api.xml version 1.47
while my Debian woody perl system (and presumably Rafael's Debian testing
system once he is back on line) can.  The perl script
doc/docbook/bin/api2text.pl has the following statements:

use XML::Parser;
use XML::DOM;

so I am wondering if one of those perl modules is the source of
Joao's problem parsing api.xml.  From his previous post he has

> perl-XML-DOM-1.39-24
> perl-XML-Parser-2.31-30

It is hard to correlate Debian packages (also RedHat packages) with perl
module versions since the modules tend to be bundled in much bigger packages
for both Debian and RedHat. For example, on RedHat perl-XML-DOM is part of
the perl-libxml-enno-1.02-15 package.  However, I did check CPAN, and the
latest versions of these two modules are perl-XML-DOM-1.42 and
perl-XML-Parser-2.31.  So Joao, your perl-XML-Parser package seems up to
date, but you probably need to upgrade to a later perl-XML-DOM and try
again. One way to do that with CPAN is given below.

I know virtually no perl, but I am beginning to experiment with the CPAN
module to get the latest modules from CPAN.  (RedHat rpm perl module support
is incomplete.  Although it is good enough to build the octave documention,
it will be necessary to use CPAN to get the required modules for the
complete documentation build.)

You can figure out virtually everything you need to know by using man CPAN
(especially the FAQ number 5 at the end: "I am not root, how can I install a
module in a personal directory?"  However, that FAQ is wrong in one key
aspect.  It recommends using (after you have invoked perl -MCPAN -e shell)

o conf makepl_arg \
"LIB=~/myperl/lib \
INSTALLMAN1DIR=~/myperl/man/man1 \
INSTALLMAN3DIR=~/myperl/man/man3"

You need to define the PREFIX as well (I found that out from a google search).

Thus use instead:

o conf makepl_arg \
"PREFIX=~/myperl \
LIB=~/myperl/lib \
INSTALLMAN1DIR=~/myperl/man/man1 \
INSTALLMAN3DIR=~/myperl/man/man3"

After creating all these directories and setting PERL5LIB and MANPATH
appropriately I found

install MD5
install Bundle::CPAN
install XML::DOM
install XML::Parser

all worked fine to install personal versions of these modules.  (The last
two are versions 1.42 and 2.31).

The first two installs are to make sure MD5 sums are checked on download and
to bootstrap to the latest version of the CPAN module.  My initial
impressions are the CPAN module is great for downloading and installing
modules from CPAN, and I think it is probably the way to go if your Linux
distribution has incomplete (RedHat) or out-of-date (SuSe?) perl modules.

Alan
__________________________
Alan W. Irwin
email: ir...@be...
phone: 250-727-2902

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

Programming affiliations with the Canadian Centre for Climate Modelling and
Analysis (www.cccma.bc.ec.gc.ca) and the PLplot scientific plotting software
package (plplot.org).

__________________________

Linux-powered Science
__________________________

Re: [Plplot-devel] Error when extracting Octave docs from api.xml

[Joao C. <jc...@fe...>]

On Sunday 09 March 2003 02:44, Alan W. Irwin wrote:

Thanks Alan for trying to help.

But I don't think that is the reason. I have an old plplot build tree and in 
that build tree I was able to generated the Octave online docs, while now I 
can't do it anymore.

Then I remembered that I had done a software "online update" recently (the 
equivalent to apt-get), two days ago, on both my office and home computer, 
and I tried to undo it, but I was not yet successfull.

So, it looks like after all that the fault is in my system. I apologize for 
all.
But I still thing that docbook is like killing flies with a riffle.

Meanwhile, I would also like to be able to build the docs, even without 
understanding what I'm doing!

As I have already spent two afternoons and one night reading 
doc/docbook/README.developers and searching for the correct files in my 
system (what I think I have done, but configure says no!) please send to me 
the actual files specified in --with-xml-declaration=<one file> and 
--with-sgml-catalogs=<four_files> so I can search my system based on file 
content!

Thanks,
Joao

> From Joao's recent post, his perl system cannot parse api.xml version 1.47
> while my Debian woody perl system (and presumably Rafael's Debian testing
> system once he is back on line) can.  The perl script
> doc/docbook/bin/api2text.pl has the following statements:
>
> use XML::Parser;
> use XML::DOM;
>
> so I am wondering if one of those perl modules is the source of
> Joao's problem parsing api.xml.  From his previous post he has
>
> > perl-XML-DOM-1.39-24
> > perl-XML-Parser-2.31-30
>
> It is hard to correlate Debian packages (also RedHat packages) with perl
> module versions since the modules tend to be bundled in much bigger
> packages for both Debian and RedHat. For example, on RedHat perl-XML-DOM is
> part of the perl-libxml-enno-1.02-15 package.  However, I did check CPAN,
> and the latest versions of these two modules are perl-XML-DOM-1.42 and
> perl-XML-Parser-2.31.  So Joao, your perl-XML-Parser package seems up to
> date, but you probably need to upgrade to a later perl-XML-DOM and try
> again. One way to do that with CPAN is given below.
>
> I know virtually no perl, but I am beginning to experiment with the CPAN
> module to get the latest modules from CPAN.  (RedHat rpm perl module
> support is incomplete.  Although it is good enough to build the octave
> documention, it will be necessary to use CPAN to get the required modules
> for the complete documentation build.)
>
> You can figure out virtually everything you need to know by using man CPAN
> (especially the FAQ number 5 at the end: "I am not root, how can I install
> a module in a personal directory?"  However, that FAQ is wrong in one key
> aspect.  It recommends using (after you have invoked perl -MCPAN -e shell)
>
> o conf makepl_arg \
> "LIB=~/myperl/lib \
> INSTALLMAN1DIR=~/myperl/man/man1 \
> INSTALLMAN3DIR=~/myperl/man/man3"
>
> You need to define the PREFIX as well (I found that out from a google
> search).
>
> Thus use instead:
>
> o conf makepl_arg \
> "PREFIX=~/myperl \
> LIB=~/myperl/lib \
> INSTALLMAN1DIR=~/myperl/man/man1 \
> INSTALLMAN3DIR=~/myperl/man/man3"
>
> After creating all these directories and setting PERL5LIB and MANPATH
> appropriately I found
>
> install MD5
> install Bundle::CPAN
> install XML::DOM
> install XML::Parser
>
> all worked fine to install personal versions of these modules.  (The last
> two are versions 1.42 and 2.31).
>
> The first two installs are to make sure MD5 sums are checked on download
> and to bootstrap to the latest version of the CPAN module.  My initial
> impressions are the CPAN module is great for downloading and installing
> modules from CPAN, and I think it is probably the way to go if your Linux
> distribution has incomplete (RedHat) or out-of-date (SuSe?) perl modules.
>
> Alan
> __________________________
> Alan W. Irwin
> email: ir...@be...
> phone: 250-727-2902
>
> Astronomical research affiliation with Department of Physics and Astronomy,
> University of Victoria (astrowww.phys.uvic.ca).
>
> Programming affiliations with the Canadian Centre for Climate Modelling and
> Analysis (www.cccma.bc.ec.gc.ca) and the PLplot scientific plotting
> software package (plplot.org).
>
> __________________________
>
> Linux-powered Science
> __________________________
>
>
>
>
> -------------------------------------------------------
> This SF.net email is sponsored by: Etnus, makers of TotalView, The debugger
> for complex code. Debugging C/C++ programs can leave you feeling lost and
> disoriented. TotalView can help you find your way. Available on major UNIX
> and Linux platforms. Try it free. www.etnus.com
> _______________________________________________
> Plplot-devel mailing list
> Plp...@li...
> https://lists.sourceforge.net/lists/listinfo/plplot-devel

Re: [Plplot-devel] Error when extracting Octave docs from api.xml

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

On Sun, 9 Mar 2003, Joao Cardoso wrote:

> Meanwhile, I would also like to be able to build the docs, even without
> understanding what I'm doing!

I will try to help you as much as possible since I also would like more
developers than just Rafael and me to be able to build the documentation. I
am sorry README.developers is so out of date and only relevant to Debian,
but I hope to fix that soon. I am trying to build the documentation on a
RedHat system this weekend.  I am keeping good notes (the first part of
which is the personal perl module install which you quote from my prior post
below). Once I am successful with the whole documentation build on RH 7.3
and 8.0 (which I think should be much easier than what I used to have to do
for RH 6.2), I should be able to give a nice cookbook for RedHat.  That
should be fairly close to what you have to do on SuSe, but I am willing to
help you with further adjustments for that distribution if those are needed.

> > You can figure out virtually everything you need to know by using man CPAN
> > (especially the FAQ number 5 at the end: "I am not root, how can I install
> > a module in a personal directory?"  However, that FAQ is wrong in one key
> > aspect.  It recommends using (after you have invoked perl -MCPAN -e shell)
> >
> > o conf makepl_arg \
> > "LIB=~/myperl/lib \
> > INSTALLMAN1DIR=~/myperl/man/man1 \
> > INSTALLMAN3DIR=~/myperl/man/man3"
> >
> > You need to define the PREFIX as well (I found that out from a google
> > search).
> >
> > Thus use instead:
> >
> > o conf makepl_arg \
> > "PREFIX=~/myperl \
> > LIB=~/myperl/lib \
> > INSTALLMAN1DIR=~/myperl/man/man1 \
> > INSTALLMAN3DIR=~/myperl/man/man3"
> >
> > After creating all these directories and setting PERL5LIB and MANPATH
> > appropriately I found
> >
> > install MD5
> > install Bundle::CPAN
> > install XML::DOM
> > install XML::Parser
> >
> > all worked fine to install personal versions of these modules.  (The last
> > two are versions 1.42 and 2.31).
> >
> > The first two installs are to make sure MD5 sums are checked on download
> > and to bootstrap to the latest version of the CPAN module.  My initial
> > impressions are the CPAN module is great for downloading and installing
> > modules from CPAN, and I think it is probably the way to go if your Linux
> > distribution has incomplete (RedHat) or out-of-date (SuSe?) perl modules.
> >

Note, I have just installed XML::Writer (which was completely unavailable as
an rpm for RedHat) in the above way so I am hoping that will take care of
the last of the perl module problems for the full documentation build on RH.
When I look further into this tomorrow I am sure there will also be other
issues such as using the correct XML catalog (which RH always seems to mess
up) and making sure there is a big enough pdflatex version around, but I am
confident I can sort out all those issues.

Alan
__________________________
Alan W. Irwin
email: ir...@be...
phone: 250-727-2902

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

Programming affiliations with the Canadian Centre for Climate Modelling and
Analysis (www.cccma.bc.ec.gc.ca) and the PLplot scientific plotting software
package (plplot.org).

__________________________

Linux-powered Science
__________________________

Re: [Plplot-devel] Error when extracting Octave docs from api.xml

[<jc...@fe...>]

On Sunday 09 March 2003 03:48, Joao Cardoso wrote:
| On Sunday 09 March 2003 02:44, Alan W. Irwin wrote:
|
| Thanks Alan for trying to help.
|
| But I don't think that is the reason. I have an old plplot build tree
| and in that build tree I was able to generated the Octave online
| docs, while now I can't do it anymore.
|
| Then I remembered that I had done a software "online update" recently
| (the equivalent to apt-get), two days ago, on both my office and home
| computer, and I tried to undo it, but I was not yet successfull.
|
| So, it looks like after all that the fault is in my system. 

After some effort I was not able to undo what "online update" did, and 
so I will not be able to build the Octave online docs. This means that 
I will do "make -i" and errors will be more difficult to diagnose, so 
be suspicious of my next bug reports -- I will be carefull, however.

When I worked with a unix system without rpms, and I needed to compile 
everything from source, even X11 or Motif, this has never happened. The 
"No Free Lunch" theorem strikes again :)

Joao