Re: [Pkg-texlive-maint] Bug#364776: texlive-lang-greek: documentation not available via texdoc
Hi Norbert, hi everybody,
On Wed, Apr 26, 2006 at 08:00 +0200, Norbert Preining wrote:
> On Die, 25 Apr 2006, Ralf Stubner wrote:
> > Package: texlive-lang-greek
> > Version: 2005-2
> > Severity: minor
>
> Where did you get this version from? Do you use the files on the tug
> server?
Yes, I am using the tug server for this. Having 'experimental' in
sources.list on a Sarge system just doesn't feel right. ;-)
> > texlive-lang-greek installs its documentation into
> > /usr/share/doc/texlive-lang-greek/. I guess other texlive-* packages
> > behave similarly. Files installed there are not available to texdoc,
> > though. I am not sure if this is specific to using a texlive-* package
> > in conjunction with tetex-*.
>
> > ii tetex-base 3.0-16bpo1 Basic library files of teTeX
> > ii tex-common 0.20bpo1 Common infrastructure for using an
>
> Yup, this seems to be the problem. I guess because there is a link
> /usr/share/texmf-texlive/doc -> /usr/share/doc/texlive/
> missing.
Which package does provide this link normally? Maybe the best idea would
be to just document this in README.Debian:
Interoperability with teTeX and Documentation
---------------------------------------------
When using texlive-packages in conjunction with teTeX, the installed
documentation is not available to the command 'texdoc'. If you want to
change this, add a link
/usr/share/texmf-texlive/doc -> /usr/share/doc/texlive-doc/
and update the file-name database with the command 'mktexlsr'.
> I am not sure how to cope with this. Long time ago I decided that the
> documentation files are actually installed into /usr/share/doc/pkgname/
> and the rest is linked. The advantage of this: You get compression of
> all the stuff for free (dh_compress).
>
> tetex otoh has the documentatio in /usr/share/texmf-tetex/doc ...
> and links FROM /usr/share/doc/...
No, teTeX installs in /usr/share/doc/texmf. And there are links
/usr/share/texmf/doc -> /usr/share/doc/texmf
/usr/share/texmf-tetex/doc -> /usr/share/doc/texmf
The former is providedby tex-common, the latter by tetex-base. Actually,
the TeX policy states that documentation should be installed in
/usr/share/doc/texmf, but I am not sure, if this is can really be done.
> So now there is a mess.
Indeed. Somehow we forgot about documentation when we splitted the
TEXMF trees, which is why I am taking this over to the debian-(te)tex
list. With the splitted TEXMFDIST trees we have made it possible to
install tetex and texlive packages at the same time, even when they
contain the same files. However, this would no longer be possbile, if
the texlive packages would implement the current TeX policy. An overlap
of files installed in /usr/share/texmf/doc would be likely.
How about the following:
tex-common provides the link
/usr/share/texmf/doc -> /usr/share/doc/texmf
and 'normal' TeX related packages are supposed to install their
documentation in /usr/share/doc/texmf, just as it is now.
tetex-base (or tetex-doc) provides the link
/usr/share/texmf-tetex/doc -> /usr/share/doc/texmf-tetex
and tetex-doc actually installs its files in /usr/share/doc/texmf-tetex.
Similarly for texlive, one of the basic packages provides a link
/usr/share/texmf-texlive/doc -> /usr/share/doc/texmf-texlive
which could take the role /usr/share/doc/texlive-doc/ has now, ie, links
to the appropriate files in /usr/share/doc/<package>. The name change is
just for symmetry reasons.
> No idea. You could add the above link by hand and it should work for
> now.
Yes, that does help.
cheerio
ralf
Reply to: