Your example implies that doc-base's install-docs is at fault for creating files under either /usr/doc/HTML or /usr/share/doc/HTML instead of files in a single place, with a /usr/doc/HTML -> /usr/share/doc/HTML symlink. Am I correct? Or did I miss something?
In that case, shouldn't the bug go against doc-base? (I'm so confused by now, I can't think straight) Peter Roland Rosenfeld wrote: > > RR> > Why is dhelp broken? > > > RR> Because it doesn't support /usr/doc symlinks in the /usr/doc > > RR> tree when the .dhelp file (created by a doc-base file) mentions > > RR> the real (/usr/share/doc) path. > > > Example, please. > > Take xfig-doc. This package comes with documentation in > /usr/share/doc/xfig-doc/html/ and a symlink /usr/doc/xfig-doc pointing > to /usr/share/xfig-doc. > /usr/share/doc-base/xfig-doc says: > > Document: xfig-doc > Title: XFIG Users Manual > Author: T.Sato and Brian V. Smith > Abstract: This manual explains the interactive drawing tool xfig, > which runs under the X Window System. It explains how to start and > use xfig, helps you with some examples and informs you about the > technical issues of this program. > Section: Graphics > > Format: html > Index: /usr/share/doc/xfig-doc/html/index.html > Files: /usr/share/doc/xfig-doc/html/*.html > > This creates the following /usr/share/doc/xfig-doc/html/.dhelp: > > <item> > <directory>graphics > <linkname>XFIG Users Manual > <filename>index.html > <description> > This manual explains the interactive drawing tool xfig, > which runs under the X Window System. It explains how to start and > use xfig, helps you with some examples and informs you about the > technical issues of this program. > </description> > </item> > > And adds this document to /usr/share/doc/HTML/graphics/index.html: > > <DT><IMG SRC="../../dhelp/text.gif"> <A > HREF="../../xfig-doc/html/index.html"><FONT FACE="Helvetica, > Arial"><B>XFIG Users Manual</B></FONT></A><P></DT> > <DD>This manual explains the interactive drawing tool xfig, > which runs under the X Window System. It explains how to start and > use xfig, helps you with some examples and informs you about the > technical issues of this program. > </DD> > > But it doesn't add the document to /usr/doc/HTML/graphics/index.html > which is the primary documentation path for potato (according to ctte).