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