winsup/doc

Corinna Vinschen vinschen@redhat.com
Mon Feb 16 16:11:00 GMT 2004


On Feb 16 11:01, Nicholas Wourms wrote:
> 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 

I have a /usr/share/sgml/docbook/dsssl-stylesheets-1.77 directory with
a bunch of files in it.  I have a package docbook-dsssl-stylesheets-1.77
installed.  What's new is the requirement fo "jw".  I didn't have that
installed until now and it wasn't a requirement before introducing the
stylesheet stuff.

> 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?

No.  It's not a RHL box.  Nor is it a Cygwin box.

> 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...

Is it possible to add a couple of build rules which don't require the
stylesheets, perhaps?

Corinna

-- 
Corinna Vinschen                  Please, send mails regarding Cygwin to
Cygwin Developer                                mailto:cygwin@cygwin.com
Red Hat, Inc.



More information about the Cygwin-developers mailing list