Re: strange behavior of dh_dhelp
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).
Reply to: