bug-texinfo
[Top][All Lists]
Advanced

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

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


From: S11001001
Subject: @uref & @cite don't output correctly to DocBook; missing words in @ref -> HTML
Date: Tue, 11 Jun 2002 22:02:00 -0500
User-agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.1a) Gecko/20020608

Running on i586-mandrake-linux-gnu
bugs in makeinfo from Texinfo 4.2

The original Texinfo:
@uref{http://www.gnu.org/philosophy/free-software-for-freedom.html, @cite{Why ``Free Software'' is better than ``Open Source''}}

my command:
makeinfo --docbook see.texi

The DocBook output:
http://www.gnu.org/philosophy/free-software-for-freedom.html<citation>Why "Free Software" is better than "Open Source"</citation>

what it should have given:
<ulink url="http://www.gnu.org/philosophy/free-software-for-freedom.html";><citetitle>Why "Free Software" is better than "Open Source"</citetitle></ulink>

the problems:
1. the @uref command seems to be ignored in some fashion.
2. the citation tag in DocBook is for bibliographical references; citetitle is for titles, and the texinfo manual says that @cite is for titles.

ALSO!

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.

ALSO!

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.

Happy hacking, Texinfo gurus!

--
Stephen Compall
DotGNU `Contributor' -- http://www.dotgnu.org

My views about copyright take an hour to expound, but one general
principle applies: it cannot justify denying the public important
freedoms. As Abraham Lincoln put it, "Whenever there is a conflict
between human rights and property rights, human rights must prevail."
Property rights are meant to advance human well-being, not as an
excuse to disregard it.
        -- RMS, "The GNU GPL and the American Way"




reply via email to

[Prev in Thread] Current Thread [Next in Thread]