This is the mail archive of the cygwin-developers@cygwin.com 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]

Re: winsup/doc


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


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