winsup/doc

[Nicholas Wourms]

vinschen@redhat.com wrote:
> Hi,
> 
> I have problems building the doc directory and I'd like to ask
> what I'm missing.  I get lots of errors:
> 
>   db2html -d /src/cygwin/src/winsup/doc/cygwin.dsl#html cygwin-ug-net.sgml
>   Cannot read "/src/cygwin/src/winsup/doc/cygwin.dsl#html". Exiting.
>   make: [cygwin-ug-net/cygwin-ug-net.html] Error 1 (ignored)
>   jw -d /src/cygwin/src/winsup/doc/cygwin.dsl#html -u cygwin-ug-net.sgml
>   Using catalogs: /usr/share/sgml/docbook/dsssl-stylesheets-1.77/catalog, /usr/share/sgml/docbook/dsssl-stylesheets-1.77/common/catalog, /usr/share/sgml/docbook/dsssl-stylesheets-1.77/dtds/html/catalog, /usr/share/sgml/docbook/dsssl-stylesheets-1.77/html/catalog, /usr/share/sgml/docbook/dsssl-stylesheets-1.77/print/catalog, /usr/share/sgml/openjade/catalog
>   Using stylesheet: /src/cygwin/src/winsup/doc/cygwin.dsl#html
>   Working on: /ext/build/cygwin/bin/i686-pc-cygwin/winsup/doc/cygwin-ug-net.sgml
>   jade:/ext/build/cygwin/bin/i686-pc-cygwin/winsup/doc/cygwin-ug-net.sgml:1:55:W: cannot generate system identifier for public text "-//OASIS//DTD DocBook V4.2//EN"
>   jade:/ext/build/cygwin/bin/i686-pc-cygwin/winsup/doc/cygwin-ug-net.sgml:14:1:E: reference to entity "BOOK" for which no system identifier could be generated
>   jade:/ext/build/cygwin/bin/i686-pc-cygwin/winsup/doc/cygwin-ug-net.sgml:1:0: entity was defined here
>   jade:/ext/build/cygwin/bin/i686-pc-cygwin/winsup/doc/cygwin-ug-net.sgml:14:1:E: DTD did not contain element declaration for document type name
>   jade:/ext/build/cygwin/bin/i686-pc-cygwin/winsup/doc/cygwin-ug-net.sgml:16:9:E: there is no attribute "ID"
>   [...]
> 
> I know that it worked for me in 2003, so, did the minmal requirements
> to create the docs change?  I'm running openjade 1.3.2 and docbook 4.2.

Strange, it works for me, but, then again, I'm using a homebrew 
sgml/docbook setup under Cygwin.  I'm not sure waht the first error 
means, but the second error usually means that jade couldn't locate the 
catalog entry for the 4.2 style sheets.  You'll have to grep for that 
identifier in /usr/share/sgml to see if it is in any catalogs there, 
then check for a corresponding entry to that catalog in one of the files 
that the master catalog file "/etc/sgml/catalog" lists.  Fomr my 
homebrew, I used the specfile from the RedHat docbook-dtds-1.0-xx SRPM, 
which provides an excellent refrence of what needs to be done in 
post-install.  Plus, it uses libxml2 utils to do the catalog stuff, so 
it should be easy to follow.

Wait a second, is this a RH linux box?  If so, then I know 1.77 is not 
the most recent RedHat rpm.  Check Fedora for the latest docbook* rpms, 
maybe that'll work?

It's amazing, given the PITA sgml/docbook is to setup, that it hasn't 
been brought under the umbrella of POSIX standards.  For something so 
essential, it seems like we're still stuck using a hodgepodge of scripts 
and software stuck in the eighties...

Cheers,
Nicholas