[Top][All Lists]
[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"
- @uref & @cite don't output correctly to DocBook; missing words in @ref -> HTML,
S11001001 <=