Re: @uref & @cite don't output correctly to DocBook; missing words in @ref -> HTML

[Eli Zaretskii]

On Tue, 11 Jun 2002, S11001001 wrote:

> original texinfo:
> Since we use the @command{autoconf} package, @ref{Invoking configure, ,
> Running `configure' Scripts, autoconf, Autoconf}, for information on the
> basic options available to all packages that use autoconf.
> 
> command:
> makeinfo --no-split --html see.texi
> 
> output HTML:
> Since we use the <code>autoconf</code> package, <a 
> href="autoconf.html#Invoking%20configure">Running `configure' 
> Scripts</a>, for information on the basic options available to all 
> packages that use autoconf.
> 
> what it should be:
> Since we use the <code>autoconf</code> package, see section <a 
> href="autoconf.html#Invoking%20configure">Running `configure' 
> Scripts</a> in <cite>Autoconf</cite>, for information on the basic 
> options available to all packages that use autoconf.
> 
> explanation:
> since the HTML links don't use the *Note, as info does, they should have 
> the words "see section" prepended just like the TeX output, along with a 
> note of the manual's name.

No, the problem is that you use @ref incorrectly.  @ref is documented to 
_not_ produce the leading "see", so if you want it, you should include it 
in the Texinfo source explicitly, like this:

  Since we use the @command{autoconf} package, see the section @ref{Invoking 
  configure, , [...]

The reason that @ref doesn't produce "see" is so you could say something 
different, like in the following example:

  This feature is further explained in @ref{Foobar}.

> using the same example for @ref above, even though docbook doesn't 
> provide references in the same style *at all*, @ref/@xref/@pxref should 
> use the same fallback used by TeX, i.e. see section ``Running 
> `configure' scripts'' in @cite{Autoconf}. Right now it just leaves blank 
> space, so it looks like:
> 
> Since we use the <command>autoconf</command> package, , for information 
> on the basic options available to all packages that use autoconf.

Again, this is expected and documented behavior of @ref.

Thank you for your report, anyway.