[texdoc] Default documentation for `yathesis`

Denis Bitouzé denis.bitouze at univ-littoral.fr
Wed Mar 25 14:37:34 CET 2020 

Le 25/03/20 à 19h54, Takuto ASAKURA a écrit :

> Hi Denis,

Hi Takuto,

>> I'm using the latest updated TL 2019:
>
> Hmm... something is wrong.
>
> Could you please send me the whole debug message:
>
> 	$ texdoc -D yathesis

Well, I'm puzzled: after the numerous `texdoc debug-score` lines, this
command displays what is expected:

  ┌────
  │  1 /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/documentation/yathesis-fr.pdf
  │    = [fr] Package documentation
  │  2 /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/english/README-TRANSLATION.md
  │  3 /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/comue.pdf
  │  4 /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/labo.pdf
  │  5 /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/paris13.pdf
  │  6 /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/these.pdf
  │  7 /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/tiger.pdf
  │  8 /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/ulco.pdf
  │  9 /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/README.md
  │    = Readme
  │ 10 /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/documentation/latexmkrc
  │ 11 /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/latexmkrc
  └────

and `texdoc yathesis` now behaves as expected :$

> I will try my best to observe what is actually happening.

Many thanks but maybe it is now useless,... so, maybe sorry for the
noise. Anyway, the debug message is at the end of this mail.

>> OK, thanks. In fact, my request is more for users other than me (I'm
>> the `yathesis`'s author :)
>
> I see. Ok, in this case, I can add the global alias into our default
> configuration file for everyone anyway.

Could be nice, in order to be sure :) If possible, would be nice for:

  ┌────
  │ .../texmf-dist/doc/latex/yathesis/README.md
  └────

to come before:

  ┌────
  │ .../texmf-dist/doc/latex/yathesis/english/README-TRANSLATION.md
  └────

And I don't know if it is possible at the `texdoc` level, but would be
nice for:

  ┌────
  │ .../texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/comue.pdf
  │ .../texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/labo.pdf
  │ .../texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/paris13.pdf
  │ .../texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/these.pdf
  │ .../texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/tiger.pdf
  │ .../texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/ulco.pdf
  └────

to /not/ be displayed.

Now the debug message:

  ┌────
  │ texdoc debug-version: /usr/local/texlive/2019/texmf-dist/scripts/texdoc/texdoclib.tlu v3.2.1
  │ texdoc debug-config: Setting "debug_list=all" from command line option "-D".
  │ texdoc debug-config: Setting "viewer_html=firefox" from environment variable "BROWSER".
  │ texdoc debug-config: Setting "viewer_txt=less" from environment variable "PAGER".
  │ texdoc debug-config: Setting "viewer_pdf=(evince %s) &" in file "/home/bitouze/texmf/texdoc/texdoc.cnf" on line 35.
  │ texdoc debug-config: Setting "mode=showall" in file "/home/bitouze/texmf/texdoc/texdoc.cnf" on line 79.
  │ texdoc debug-config: Setting "suffix_list=doc, -doc, _doc, .doc, /doc, manual, /manual, -manual, userguide, /user_guide, -guide, -user, -man, notes, -info, ref" in file "/home/bitouze/texmf/texdoc/texdoc.cnf" on line 91.
  │ texdoc debug-config: Setting "lastfile_switch=true" in file "/home/bitouze/texmf/texdoc/texdoc.cnf" on line 505.
  │ texdoc debug-config: Setting "fuzzy_level=5" from built-in defaults.
  │ texdoc debug-config: Setting "max_lines=20" from built-in defaults.
  │ texdoc debug-config: Setting "interact_switch=true" from built-in defaults.
  │ texdoc debug-config: Setting "badext_list=txt, " from built-in defaults.
  │ texdoc debug-config: Setting "machine_switch=false" from built-in defaults.
  │ texdoc debug-config: Setting "verbosity_level=2" from built-in defaults.
  │ texdoc debug-config: Setting "ext_list=pdf, htm, html, txt, md, ps, dvi, " from built-in defaults.
  │ texdoc debug-config: Setting "badbasename_list=readme, 00readme" from built-in defaults.
  │ texdoc debug-config: Setting "basename_list=readme, 00readme" from built-in defaults.
  │ texdoc debug-config: Setting "rm_file=rm -f" from built-in defaults.
  │ texdoc debug-config: Setting "zipext_list=" from built-in defaults.
  │ texdoc debug-config: Setting "rm_dir=rmdir" from built-in defaults.
  │ texdoc debug-files: Configuration file(s):
  │ texdoc debug-files: not found   /home/bitouze/.texlive2019/texmf-var/texdoc/texdoc-x86_64-linux.cnf
  │ texdoc debug-files: not found   /home/bitouze/.texlive2019/texmf-var/texdoc/texdoc.cnf
  │ texdoc debug-files: not found   /home/bitouze/.texlive2019/texmf-var/texdoc/texdoc-dist.cnf
  │ texdoc debug-files: not found   /home/bitouze/texmf/texdoc/texdoc-x86_64-linux.cnf
  │ texdoc debug-files: active      /home/bitouze/texmf/texdoc/texdoc.cnf
  │ texdoc debug-files: not found   /home/bitouze/texmf/texdoc/texdoc-dist.cnf
  │ texdoc debug-files: not found   /usr/local/texlive/2019/texmf-dist/texdoc/texdoc-x86_64-linux.cnf
  │ texdoc debug-files: disabled    /usr/local/texlive/2019/texmf-dist/texdoc/texdoc.cnf
  │ texdoc debug-files: not found   /usr/local/texlive/2019/texmf-dist/texdoc/texdoc-dist.cnf
  │ texdoc debug-texdocs: texdocs[7] = /home/bitouze/.texlive2019/texmf-config/doc (index_mandatory=false, recursion_allowed=true)
  │ texdoc debug-texdocs: texdocs[6] = /home/bitouze/.texlive2019/texmf-var/doc (index_mandatory=false, recursion_allowed=true)
  │ texdoc debug-texdocs: texdocs[5] = /home/bitouze/texmf/doc (index_mandatory=false, recursion_allowed=true)
  │ texdoc debug-texdocs: texdocs[5] using index: /home/bitouze/texmf (shift=doc/)
  │ texdoc debug-texdocs: texdocs[4] = /usr/local/texlive/texmf-local/doc (index_mandatory=true, recursion_allowed=true)
  │ texdoc debug-texdocs: texdocs[4] using index: /usr/local/texlive/texmf-local (shift=doc/)
  │ texdoc debug-texdocs: texdocs[3] = /usr/local/texlive/2019/texmf-config/doc (index_mandatory=true, recursion_allowed=true)
  │ texdoc debug-texdocs: texdocs[2] = /usr/local/texlive/2019/texmf-var/doc (index_mandatory=true, recursion_allowed=true)
  │ texdoc debug-texdocs: texdocs[1] = /usr/local/texlive/2019/texmf-dist/doc (index_mandatory=true, recursion_allowed=true)
  │ texdoc debug-texdocs: texdocs[1] using index: /usr/local/texlive/2019/texmf-dist (shift=doc/)
  │ texdoc debug-tlpdb: Using cached data from /home/bitouze/.texlive2019/texmf-var/texdoc/cache-tlpdb.lua
  │ texdoc debug-search: Searching documents for pattern "yathesis"
  │ texdoc debug-search: File /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/README.md found.
  │ texdoc debug-search: File /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/english/README-TRANSLATION.md found.
  │ texdoc debug-search: File /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/documentation/latexmkrc found.
  │ texdoc debug-search: File /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/documentation/yathesis-fr.pdf found.
  │ texdoc debug-search: File /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/comue.pdf found.
  │ texdoc debug-search: File /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/labo.pdf found.
  │ texdoc debug-search: File /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/latexmkrc found.
  │ texdoc debug-search: File /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/paris13.pdf found.
  │ texdoc debug-search: File /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/these.pdf found.
  │ texdoc debug-search: File /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/tiger.pdf found.
  │ texdoc debug-search: File /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/ulco.pdf found.
  │ texdoc debug-score: (d3e9296) Start scoring /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/README.md
  │ texdoc debug-score: (d3e9296) Name used: latex/yathesis/readme.md
  │ texdoc debug-score: (d3e9296) Start heuristic scoring with pattern: yathesis
  │ texdoc debug-score: (d3e9296) New heuristic score: 1.0. Reason: subword match
  │ texdoc debug-score: (d3e9296) New heuristic score: 0.1. Reason: bad basename
  │ texdoc debug-score: (d3e9296) New heuristic score: 1.6. Reason: directory bonus
  │ texdoc debug-score: (d3e9296) Final heuristic score: 1.6
  │ texdoc debug-score: (d3e9296) Max pattern score: 1.6
  │ texdoc debug-score: (d3e9296) Catalogue "readme" bonus: +0.1
  │ texdoc debug-score: (d3e9296) Adjust by 0.1 from global pattern "readme"
  │ texdoc debug-score: (d3e9296) Final score: 1.8
  │ texdoc debug-score: (5a24ea7) Start scoring /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/english/README-TRANSLATION.md
  │ texdoc debug-score: (5a24ea7) Name used: latex/yathesis/english/readme-translation.md
  │ texdoc debug-score: (5a24ea7) Start heuristic scoring with pattern: yathesis
  │ texdoc debug-score: (5a24ea7) New heuristic score: 1.0. Reason: subword match
  │ texdoc debug-score: (5a24ea7) New heuristic score: 2.5. Reason: directory bonus
  │ texdoc debug-score: (5a24ea7) Final heuristic score: 2.5
  │ texdoc debug-score: (5a24ea7) Max pattern score: 2.5
  │ texdoc debug-score: (5a24ea7) Adjust by 0.1 from global pattern "readme"
  │ texdoc debug-score: (5a24ea7) Final score: 2.6
  │ texdoc debug-score: (d9a29ba) Start scoring /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/documentation/latexmkrc
  │ texdoc debug-score: (d9a29ba) Name used: latex/yathesis/french/documentation/latexmkrc
  │ texdoc debug-score: (d9a29ba) Start heuristic scoring with pattern: yathesis
  │ texdoc debug-score: (d9a29ba) New heuristic score: 1.0. Reason: subword match
  │ texdoc debug-score: (d9a29ba) New heuristic score: 0.1. Reason: bad extension
  │ texdoc debug-score: (d9a29ba) New heuristic score: 1.6. Reason: directory bonus
  │ texdoc debug-score: (d9a29ba) Final heuristic score: 1.6
  │ texdoc debug-score: (d9a29ba) Max pattern score: 1.6
  │ texdoc debug-score: (d9a29ba) Final score: 1.6
  │ texdoc debug-score: (ed69358) Start scoring /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/documentation/yathesis-fr.pdf
  │ texdoc debug-score: (ed69358) Name used: latex/yathesis/french/documentation/yathesis-fr.pdf
  │ texdoc debug-score: (ed69358) Start heuristic scoring with pattern: yathesis
  │ texdoc debug-score: (ed69358) New heuristic score: 1.0. Reason: subword match
  │ texdoc debug-score: (ed69358) New heuristic score: 2.5. Reason: directory bonus
  │ texdoc debug-score: (ed69358) Final heuristic score: 2.5
  │ texdoc debug-score: (ed69358) Max pattern score: 2.5
  │ texdoc debug-score: (ed69358) Catalogue details bonus: +1.5
  │ texdoc debug-score: (ed69358) Final score: 4.0
  │ texdoc debug-score: (80b7247) Start scoring /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/comue.pdf
  │ texdoc debug-score: (80b7247) Name used: latex/yathesis/french/exemples/specimen/a-plat/comue.pdf
  │ texdoc debug-score: (80b7247) Start heuristic scoring with pattern: yathesis
  │ texdoc debug-score: (80b7247) New heuristic score: 1.0. Reason: subword match
  │ texdoc debug-score: (80b7247) New heuristic score: 2.5. Reason: directory bonus
  │ texdoc debug-score: (80b7247) Final heuristic score: 2.5
  │ texdoc debug-score: (80b7247) Max pattern score: 2.5
  │ texdoc debug-score: (80b7247) Final score: 2.5
  │ texdoc debug-score: (68fe709) Start scoring /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/labo.pdf
  │ texdoc debug-score: (68fe709) Name used: latex/yathesis/french/exemples/specimen/a-plat/labo.pdf
  │ texdoc debug-score: (68fe709) Start heuristic scoring with pattern: yathesis
  │ texdoc debug-score: (68fe709) New heuristic score: 1.0. Reason: subword match
  │ texdoc debug-score: (68fe709) New heuristic score: 2.5. Reason: directory bonus
  │ texdoc debug-score: (68fe709) Final heuristic score: 2.5
  │ texdoc debug-score: (68fe709) Max pattern score: 2.5
  │ texdoc debug-score: (68fe709) Final score: 2.5
  │ texdoc debug-score: (143f310) Start scoring /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/latexmkrc
  │ texdoc debug-score: (143f310) Name used: latex/yathesis/french/exemples/specimen/a-plat/latexmkrc
  │ texdoc debug-score: (143f310) Start heuristic scoring with pattern: yathesis
  │ texdoc debug-score: (143f310) New heuristic score: 1.0. Reason: subword match
  │ texdoc debug-score: (143f310) New heuristic score: 0.1. Reason: bad extension
  │ texdoc debug-score: (143f310) New heuristic score: 1.6. Reason: directory bonus
  │ texdoc debug-score: (143f310) Final heuristic score: 1.6
  │ texdoc debug-score: (143f310) Max pattern score: 1.6
  │ texdoc debug-score: (143f310) Final score: 1.6
  │ texdoc debug-score: (3e460b0) Start scoring /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/paris13.pdf
  │ texdoc debug-score: (3e460b0) Name used: latex/yathesis/french/exemples/specimen/a-plat/paris13.pdf
  │ texdoc debug-score: (3e460b0) Start heuristic scoring with pattern: yathesis
  │ texdoc debug-score: (3e460b0) New heuristic score: 1.0. Reason: subword match
  │ texdoc debug-score: (3e460b0) New heuristic score: 2.5. Reason: directory bonus
  │ texdoc debug-score: (3e460b0) Final heuristic score: 2.5
  │ texdoc debug-score: (3e460b0) Max pattern score: 2.5
  │ texdoc debug-score: (3e460b0) Final score: 2.5
  │ texdoc debug-score: (233f2ed) Start scoring /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/these.pdf
  │ texdoc debug-score: (233f2ed) Name used: latex/yathesis/french/exemples/specimen/a-plat/these.pdf
  │ texdoc debug-score: (233f2ed) Start heuristic scoring with pattern: yathesis
  │ texdoc debug-score: (233f2ed) New heuristic score: 1.0. Reason: subword match
  │ texdoc debug-score: (233f2ed) New heuristic score: 2.5. Reason: directory bonus
  │ texdoc debug-score: (233f2ed) Final heuristic score: 2.5
  │ texdoc debug-score: (233f2ed) Max pattern score: 2.5
  │ texdoc debug-score: (233f2ed) Final score: 2.5
  │ texdoc debug-score: (eccdbb4) Start scoring /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/tiger.pdf
  │ texdoc debug-score: (eccdbb4) Name used: latex/yathesis/french/exemples/specimen/a-plat/tiger.pdf
  │ texdoc debug-score: (eccdbb4) Start heuristic scoring with pattern: yathesis
  │ texdoc debug-score: (eccdbb4) New heuristic score: 1.0. Reason: subword match
  │ texdoc debug-score: (eccdbb4) New heuristic score: 2.5. Reason: directory bonus
  │ texdoc debug-score: (eccdbb4) Final heuristic score: 2.5
  │ texdoc debug-score: (eccdbb4) Max pattern score: 2.5
  │ texdoc debug-score: (eccdbb4) Final score: 2.5
  │ texdoc debug-score: (78427b9) Start scoring /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/ulco.pdf
  │ texdoc debug-score: (78427b9) Name used: latex/yathesis/french/exemples/specimen/a-plat/ulco.pdf
  │ texdoc debug-score: (78427b9) Start heuristic scoring with pattern: yathesis
  │ texdoc debug-score: (78427b9) New heuristic score: 1.0. Reason: subword match
  │ texdoc debug-score: (78427b9) New heuristic score: 2.5. Reason: directory bonus
  │ texdoc debug-score: (78427b9) Final heuristic score: 2.5
  │ texdoc debug-score: (78427b9) Max pattern score: 2.5
  │ texdoc debug-score: (78427b9) Final score: 2.5
  │  1 /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/documentation/yathesis-fr.pdf
  │    = [fr] Package documentation
  │  2 /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/english/README-TRANSLATION.md
  │  3 /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/comue.pdf
  │  4 /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/labo.pdf
  │  5 /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/paris13.pdf
  │  6 /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/these.pdf
  │  7 /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/tiger.pdf
  │  8 /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/ulco.pdf
  │  9 /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/README.md
  │    = Readme
  │ 10 /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/documentation/latexmkrc
  │ 11 /usr/local/texlive/2019/texmf-dist/doc/latex/yathesis/french/exemples/specimen/a-plat/latexmkrc
  └────

Many thanks again.

All the best.
-- 
Denis

More information about the texdoc mailing list.