[texdoc] texdoc bidi

Takuto ASAKURA tkt.asakura at gmail.com
Fri Jan 3 16:17:46 CET 2020


Hi All,

sorry for my late response.

The contents of the catalog descriptions such as "Package (source|user|)
documentation" does nothing to do with the scoring of Texdoc. It only
considers whether or not the catalog description exists.

At this point, bidi.pdf wins over bidi-doc.pdf simply because the
heuristic scoring prefers <package>.pdf than <package>-doc.pdf in general.

As a simple workaround, I will adjust the score for bidi-doc in the
default configuration file. Please be patient by the next release
of Texdoc, which will be in a month (hopefully).

Best,
Takuto

> On 2020/01/03, at 19:34, Manfred Lotz <manfred at dante.de> wrote:
> 
> Hi Reinhard,
> 
> On Thu, 2 Jan 2020 22:22:34 +0100
> Reinhard Kotucha <reinhard.kotucha at web.de> wrote:
> 
>> On 2020-01-02 at 19:27:32 +0000, David Carlisle wrote:
>> 
>>> could the default texdoc configuration for bidi prefer
>>> bidi-doc.pdf to bidi.pdf, the latter is the source listing,
>>> bidi-doc is the user manual.
>>> 
>>> 
>>> texdoc -l bidi
>>> 1 /usr/local/texlive/2019/texmf-dist/doc/xelatex/bidi/bidi.pdf
>>>   = Package source documentation
>>> 2 /usr/local/texlive/2019/texmf-dist/doc/xelatex/bidi/bidi-doc.pdf
>>>   = Package user documentation  
>> 
>> Hi David,
>> I had a similar problem with VnTeX in the past.  It turned out that in
>> the TeX Catalogue the wrong file got the attribute "package
>> documentation".
>> 
>> It seems that "package documentation" was replaced by "Package source
>> documentation" and "Package user documentation".  Maybe texdoc has to
>> be adapted accordingly.
>> 
>> Manfred, is my assuption correct?
>> 
> 
> It could be that at some time in the past "package documentation" was
> replaced for bidi. But even in February 2018 there were "Package source
> documentation" and "Package user documentation" in the catalog entry of
> bidi.
> 
> I am not familiar how texdoc operates. But I assume that the .tlpobj
> files are the sources used by texdoc to determine what to display.
> Perhaps indirectly, if those .tlpobj files are inserted into a database.
> 
> So, looking into the .tlpobj files in the current texlive installation
> on my system I find occurrences like follows:
> 
> - "Package documentation": 85449 occurrences
> - "Package source documentation": 66 occurrences
> - "Package user documentation": 66 occurrences
> - 200 occurrences of different varieties like 
>   - "Package short documentation"
>   - "Package and font documentation" 
>   and more...
> 
> 
> 
> -- 
> Best, Manfred



More information about the texdoc mailing list