This is the mail archive of the
cygwin-apps
mailing list for the Cygwin project.
HELP with Cygwin docs needed
- From: Corinna Vinschen <corinna-cygwin at cygwin dot com>
- To: cygwin-apps at cygwin dot com
- Date: Tue, 23 Apr 2013 17:20:14 +0200
- Subject: HELP with Cygwin docs needed
- Reply-to: cygwin-apps at cygwin dot com
Hi guys,
does anybody know sgml and xmlto? I just realized that our 1.7.18
documentation is broken. I have *no* idea why this suddenly happens.
This worked fine only a short time ago, the 1.7.17 docs on cygwin.com
were fine. All the xref links
Consider this xref in winsup/doc/setup2.sgml (about line 177):
(see <xref linkend="regtool"></xref>)
In winsup/utils/utils.sgml is the link target (about line 1520):
sect2 id="regtool"><title>regtool</title>
This usually resulted in a text like this in place of the xref in the
generated html file:
(see <a class="xref" href="using-utils.html#regtool" title="regtool">the section called âregtoolâ</a>)
Now, when I try the same on the same Linux system as always, I'm getting
an error instead:
./doctool -m -d ${srcdir}/winsup/doc -d -d \
-s ${srcdir}/winsup/doc \
-o cygwin-ug-net.sgml \
${srcdir}/winsup/doc/cygwin-ug-net.in.sgml
xmlto --skip-validation --with-dblatex html \
-o cygwin-ug-net/ \
-m ${srcdir}/winsup/doc/cygwin.dsl cygwin-ug-net.sgml
[...]
ERROR: xref linking to regtool has no generated link text.
[...]
and the generated HTML looks like this:
(see <a class="xref" href="">???</a>)
Does anybody know how to fix this?
Help? Please?
Corinna
--
Corinna Vinschen Please, send mails regarding Cygwin to
Cygwin Maintainer cygwin AT cygwin DOT com
Red Hat