On Tue, Jun 24, 2014 at 10:41:00PM +0300, Niko Tyni wrote:
> > Did you, by any means, check the documentation system after the perl update?
> > I suspect that (on the command line), 'pdldoc -a slice' would give you an
> > empty list...
>
> It seems to be worse than that:
>
> # pdldoc -a slice
> Unable to find PDL/pdldoc.db in
> /etc/perl:/usr/local/lib/x86_64-linux-gnu/perl/5.20.0:/usr/local/share/perl/5.20.0:/usr/lib/x86_64-linux-gnu/perl5/5.20:/usr/share/perl5:/usr/lib/x86_64-linux-gnu/perl/5.20:/usr/share/perl/5.20:/usr/local/lib/site_perl:.
> can't open database 1, scan docs first at
> /usr/lib/x86_64-linux-gnu/perl5/5.20/PDL/Doc.pm line 465.
> PDL::Doc::ensuredb(PDL::Doc=HASH(0x2836698)) called at
> /usr/lib/x86_64-linux-gnu/perl5/5.20/PDL/Doc.pm line 583
> PDL::Doc::search(PDL::Doc=HASH(0x2836698), "m/slice/", ARRAY(0x2009968),
> 1) called at /usr/lib/x86_64-linux-gnu/perl5/5.20/PDL/Doc/Perldl.pm line 188
> PDL::Doc::Perldl::search_docs("m/slice/", ARRAY(0x2009968), 1) called at
> /usr/lib/x86_64-linux-gnu/perl5/5.20/PDL/Doc/Perldl.pm line 165
> PDL::Doc::Perldl::aproposover("slice") called at
> /usr/lib/x86_64-linux-gnu/perl5/5.20/PDL/Doc/Perldl.pm line 173
> PDL::Doc::Perldl::apropos("slice") called at /usr/bin/pdldoc line 57
essentially, it is not far worse than expected. It just implies that the
whole PDL documentation is lost to the user.
oh well...
have to fix that one.
> > my PDL package has a trigger installed for doc/doc-index rebuild if
> > any package installs sth into its namespace, so no explicite action on the
> > side of a dependee pkg should be necessary.
> > I suspect that, besides PDL being possibly broken by the transition, the
> > dependee libpdl-stats-perl is doing something explicitely that it
> > shouldn't...
>
> The PDL-Stats upstream Makefile.PL has this postamble:
>
> install ::
> @echo "Updating PDL documentation database ..."
> @$(PERL) add_doc.pl
>
> and add_doc.pl uses PDL::Doc methods to update the doc database
> it finds on @INC.
>
> So should the libpdl-stats-perl Debian package be disabling that and
> relying on the trigger instead?
I definitely think so: why should any package at build time do something that
is related to the system that it may be installed into...
Background: pdl, as perl's equivalent to numpy/scipy/matlab, comes with an
integrated documentation system, allowing to search for documentation of all
the installed packages related to it.
the documentation index, searched by tools like pdldoc or the interactive
shells, should always be consistent with what is actually installed on a
system.
--
c u
henning
--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
