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
__________________________