HELP with Cygwin docs needed
Corinna Vinschen
corinna-cygwin@cygwin.com
Tue Apr 23 15:26:00 GMT 2013
On Apr 23 17:20, Corinna Vinschen wrote:
> 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
... to utils.sgml are broken now.
> 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
--
Corinna Vinschen Please, send mails regarding Cygwin to
Cygwin Maintainer cygwin AT cygwin DOT com
Red Hat
More information about the Cygwin-apps
mailing list