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.
_______________________________________________
Bug-texinfo mailing list
[EMAIL PROTECTED]
http://mail.gnu.org/mailman/listinfo/bug-texinfo
