[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

[Joao Palhoto Matos] Re: Bug#401903: Integrating texdoc.php into Debian's teTeX

Florent, 

this might be interesting for an upload targetted at etch
--- Begin Message --- 
On Wed, 27 Dec 2006, Frank Küster wrote:


Joao Palhoto Matos <jmatos@math.ist.utl.pt> wrote:


Not quite. They are available in /usr/share/doc/packagename


[...]

I was referring mainly to some flattening out and rearrangement inside
the doc trees. For instance

/usr/share/doc/latex-xcolor/examples/xcolor2.tex.gz
/usr/share/doc/texmf/latex-xcolor/xcolor.pdf.gz

could have been

/usr/share/doc/texmf/latex/xcolor/examples/xcolor2.tex.gz
/usr/share/doc/texmf/latex/xcolor/xcolor.pdf.gz


That's not nice, but is it a problem for texdoc.php?

$ kpsewhich --format="TeX system documentation" xcolor.pdf.gz
/usr/share/texmf/doc/latex-xcolor/xcolor.pdf.gz


and

/usr/share/doc/latex-beamer/beameruserguide.pdf.gz

could have been

/usr/share/doc/texmf/latex/beamer/beameruserguide.pdf.gz


#357032


These would be solved with a slight configuration change.

If /usr/share/texmf/doc had been used things would have worked without
changes but I guess that when the package was created the old tetex
documentation was still around and a conflict existed (at least I seem
to remember a bug report of one such situation).


According to the Debian Policy, documentation must be in
/usr/share/doc/<whatever>.  Therefore packages should install their
documentation either in /usr/share/doc/texmf/<subdir> (a symlinks
/usr/share/texmf/doc -> ../../doc/texmf will always exist) or in
/usr/share/doc/<packagename>, but then it needs to create symlinks
itself.
Thanks! I will make as minimal as possible changes based on this and furnish a Debian etch version for your consideration.
One last idea: instead of texdoc.php showing missing docs in red, I plan adding a line in the bottom frame if missing documents are detected pointing to the html source for details. Also I think mentioning Debian in the bottom frame should be appropriate (meaning, e.g., replacing "local additions" by "Debian and local changes"). What do you think? 

Best,

--
João Palhoto Matos                     http://www.math.ist.utl.pt/~jmatos
Departamento de Matemática
Instituto Superior Técnico
Lisboa                                      mailto:jmatos@math.ist.utl.pt

--- End Message ---

-- 
Dr. Frank Küster
Single Molecule Spectroscopy, Protein Folding @ Inst. f. Biochemie, Univ. Zürich
Debian Developer (teTeX/TeXLive)
Reply to: