This is the mail archive of the
cygwin-apps
mailing list for the Cygwin project.
Re: 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:33:08 +0200
- Subject: Re: HELP with Cygwin docs needed
- References: <20130423152014 dot GG26397 at calimero dot vinschen dot de> <20130423152641 dot GH26397 at calimero dot vinschen dot de>
- Reply-to: cygwin-apps at cygwin dot com
On Apr 23 17:26, Corinna Vinschen wrote:
> 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?
Ok, never mind. I think I see what the problem is. The doc Makefile
depends on the variables utils_source and cygwin_source which were
originally set in winsup/Makefile.common. The latest round of changes
to the build systems removed these variables, but the doc Makefile.in
wasn't changed accordingly. I'll see that I fix that and then create
new docs for our documentation web site.
Sorry for the unneeded panic :)
Corinna
--
Corinna Vinschen Please, send mails regarding Cygwin to
Cygwin Maintainer cygwin AT cygwin DOT com
Red Hat