> On Mon, 13 Jun 2011 10:41:52 -0400
> Chris Marshall <[email protected]> wrote:
>
> I noticed that Gnuplot.pm got installed in a different
> directory tree from PDL.pm which resulted in the
> scantree.pl rebuild I tried not picking up the new
> information.
>
> Ideally, the PDL online docs database
> would be rebuilt with the additional module
> docs on install. See PDL::Doc for information
> on the standard format for PDL documentation.
> It looks like the plot routine description needs
> to be modified to a more PDL-online-docs
> compatible form.
>
> scantree.pl routine is in PDL/Docs/scantree.pl
> in the PDL distribution tree. Maybe the scantree.pl
> routine needs to be smarter about building the
> database.
Hi Chris.
I made some general error handling improvements. Existence of a
runnable gnuplot is now verified in both Makefile.PL and at
module-loading time. Supported gnuplot cmdline options are detected and
only those that exist are used. No errors are read from the process
itself. That is coming, once I figure out how to do that efficiently.
I'll update the docs to conform with PDL::Doc guidelines.
It looks like scantree.pl finds the directory that PDL.pm lives in, and
scans it for documentation. This is insufficient at least with Debian's
install policy; possibly with others also. Debian places binary
system-dependent libraries in /usr/lib/perl, and pure-perl system
independent ones in /usr/share/perl. PDL.pm ends up in /usr/lib and
PDL::Graphics::Gnuplot in /usr/share, so scantree.pl doesn't find it on
my machine. How are you installing the module? Are you seeing a similar
issue?
I think scantree.pl should do something like
foreach my $inc(@INC)
{
my $candidateDir = "$inc/PDL";
scantree($candidateDir) if -d $candidateDir;
}
Sounds reasonable? Want a patch?
_______________________________________________
Perldl mailing list
[email protected]
http://mailman.jach.hawaii.edu/mailman/listinfo/perldl
