Take the 2-minute tour ×
TeX - LaTeX Stack Exchange is a question and answer site for users of TeX, LaTeX, ConTeXt, and related typesetting systems. It's 100% free, no registration required.

On my TeX Live installation there are about 200 Makefiles installed in the texmf-dist/doc subtree. They, of course, hardly count as documentation. Even strangier their placement seems in light of that every TeX Live package also has a source archive, where (and only where) the Makefiles would normally go.

However, this doesn't seem to be an unnoticed mistake, as even texdoc knows enough about them to have an exception rule:

> texdoc -d impatient
. . .
texdoc debug-score: Start scoring /data/texlive/texmf-dist/doc/plain/impatient/Makefile
texdoc debug-score: Name used: impatient/makefile
texdoc debug-score: Start heuristic scoring with pattern: impatient
texdoc debug-score: New heuristic score: 1. Reason: subword match
texdoc debug-score: New heuristic score: 0.1. Reason: bad extension
texdoc debug-score: New heuristic score: 1.6. Reason: directory bonus
texdoc debug-score: Final heuristic score: 1.6
texdoc debug-score: Max pattern score: 1.6
texdoc debug-score: Adjust by -1000 from global pattern '/makefile'  <===
texdoc debug-score: Final score: -998.4
. . .

Why are the Makefiles placed in the documentation subtree?

share|improve this question
    
Some of them are legitimately there, for instance .../koma-script/doc/english/Makefile. Other are there possibly by mistake or not very clear instructions of the package authors. –  egreg Mar 5 '12 at 21:22
    
@egreg: That's in texmf-dist/source/, not texmf-dist/doc. But I agree: files like texmf-dist/doc/context/manuals/reference/en/Makefile belong into doc, not source. –  Martin Schröder Mar 5 '12 at 23:43
    
@MartinSchröder: Hmm. In this Makefile I see only instructions to make contextref.pdf. Why does it belong to doc? It's not documentation and has no use for the user. –  Andrey Vihrov Mar 6 '12 at 7:42
    
@AndreyVihrov: It's the makefile for the documentation. :-) –  Martin Schröder Mar 6 '12 at 8:55
    
@MartinSchröder: Now I actually did an ls in the directory you point out and saw a huge list of source files instead of ready-to-use documentation. It seems that my definition of "documentation" differs much from the TeX Live's one. –  Andrey Vihrov Mar 6 '12 at 10:22

1 Answer 1

up vote 3 down vote accepted

since the question deals with "impatient" as included in tex live, i asked the tex live coordinators.

the answer is simply that a) many packages (including impatient) are only doc and it would be a cause of confusion to move a file or two to the source/ subtree, because also b) there is no practical difference between source/ and doc/ . the tex live maintainers don't worry about this, and nobody else should either.

share|improve this answer

Your Answer

 
discard

By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.