[tex-live] texdoc for libertine

[Robin Fairbairns]

Norbert Preining <preining at logic.at> wrote:

> On Fr, 23 Nov 2012, Bob Tennent wrote:
> > No; the problem is that a user might not realize that they are seeing
> > the documentation for another package, in fact the package we're trying
> > to make obsolete! Let me ask: why is it apparently so difficult to fix
> > this?
> 
> Maybe that in recent month libertine was changing names and packages and
> formats and whatever on a sometimes daily rythm. Nobody wants to fix these
> things every day anew.

indeed.  perhaps it would have been better to think for several months
before releasing anything.  however, the previous support for libertine
seemed to have been abandoned, and bugs were not being corrected.

> In this case it is quite simple:
> - libertineotf ships a file "libertine.pdf"

great, isn't it.  libertineotf is shortly to be made obsolescent (as
abandonware for which there's a replacement).

> - libertine ships a file README
> I guess the inner workings of texdoc prefer the pdf documentation, 
> especially as it has the *very*same*name*.
> 
> So please, don't complain about these things, it is a problem of the
> libertine maintainers that there are no proper namings of files in 
> the packages.

the libertine maintainer (singular) is bob.  he can't change the
unfortunate name of those docs.

> > In fact, there's a structural problem here: it's the package maintainer
> > who should be deciding which is the primary documentation, not the
> > texdoc maintainer. What's needed for this to happen?
> 
> THere is already a way to do that: When uploading to CTAN one can specify
> the name of the documentation and more data.

that has never been possible.  if you see stuff in the catalogue about
documentation, it's because i have examined the package and made my own
decision about what to put in the catalogue (since most people upload to
rainer's machine, i do all the new catalogue entries).

i don't believe there's much more _i_ can do to flag important features
of the documentation -- if there are things i can place in the catalogue
that would get passed to texdoc, i would be happy to oblige ... but i
need to be told what to do.

robin

(who now knows not to report things that are wrong.)