This is the mail archive of the cygwin-apps mailing list for the Cygwin project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

HELP with Cygwin docs needed


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


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]