[tex-k] List of file type NAMEs in the TL doc

[Bruno Voisin]

Hi Karl (or whoever monitors this address),

Regarding the list of names for --show-path, §7.2.2 of the texlive doc in TEXMFDIST/doc/texlive, that is

https://www.tug.org/texlive/doc/texlive-en/texlive-en.html#x1-660007.2.2

refers to --format which refers in turn to "kpsewhich --help", yielding

-format=NAME use file type NAME (see list below).
-show-path=NAME output search path for file type NAME (list below).

There is no list below, unfortunately, just

Email bug reports to tex-***@tug.org.
Kpathsea home page: http://tug.org/kpathsea/

Actually the list may be found in §§5.5.1 and 6.1 of the kpathsea doc in TEXMFDIST/doc/kpathsea, that is

http://tug.org/texinfohtml/kpathsea.html#Invoking-kpsewhich
http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats

but it seems it's been overlooked at some point when updating the texlive and kpathsea docs.

Or am I missing something?

Bruno Voisin

[Bruno Voisin]

Post by Bruno Voisin
Or am I missing something?

Answering my own message: I should have read more closely, the answer is in the kpathsea doc, namely the name list has been moved from -help to -help-formats.

So its seems the texlive and kpsewhich docs have just to be updated in two places:

- For texlive, to refer to --help-formats instead of --help.

- For "kpsewhich --help", to replace "see list below" by some mention of -help-formats.

Or was the point of having a list in --help to provide a more readable list, similar to that in the kpathsea manual, rather than the very technical output of --help-formats?

Bruno

[Karl Berry]

Hi Bruno,

So its seems the texlive and kpsewhich docs have just to be updated in
two places:

Yes. Thanks.

Or was the point of having a list in --help to provide a more
readable list, similar to that in the kpathsea manual, rather than
the very technical output of --help-formats?

No. The output from --help-formats is essentially what was shown in the
--help output in the past. I received a suggestion to move it to a
different option, so as not to obscure the --help information. I
agreed, so I did it.

Best,
Karl