Mailing-List: contact cygwin-apps-help AT cygwin DOT com; run by ezmlm
Sender: cygwin-apps-owner AT cygwin DOT com
List-Subscribe: <mailto:cygwin-apps-subscribe AT cygwin DOT com>
List-Archive: <http://sources.redhat.com/ml/cygwin-apps/>
List-Post: <mailto:cygwin-apps AT cygwin DOT com>
List-Help: <mailto:cygwin-apps-help AT cygwin DOT com>, <http://sources.redhat.com/lists.html#faqs>
Mail-Followup-To: cygwin-apps AT cygwin DOT com
Delivered-To: mailing list cygwin-apps AT cygwin DOT com
Message-ID: <20020413233726.24802.qmail@web20002.mail.yahoo.com>
Date: Sat, 13 Apr 2002 16:37:26 -0700 (PDT)
From: Joshua Daniel Franklin <joshuadfranklin AT yahoo DOT com>
Subject: Re: SGML/XML packages available for testing 
To: cygwin-apps AT cygwin DOT com
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii

Hi. This is a sort-of HOWTO on building the winsup/docs from CVS.

After installing the test SGML/XML packages packages from 

http://www.toomanysecrets.net/~foster/cygwin/

as detailed in 

http://www.cygwin.com/ml/cygwin-apps/2002-04/msg00072.html

and unpacking the stylesheets from

ftp://sources.redhat.com/pub/docbook-tools/docware/SOURCES/stylesheets.tgz

to 

/usr/lib/sgml/stylesheets/

and editing (on my system)

/oss/bld/i686-pc-cygwin/winsup/doc/Makefile

to change the "db2foo" references to "/usr/lib/sgml/stylesheets/db2foo.sh"
the whole documentation suite builds for me. It gives me errors about the
"using-utils" section being there twice, that's probably my fault for having
mulitiple utils.sgml files in my /oss/src/ tree. Also some like:

jade:/usr/lib/sgml/stylesheets/nwalsh-modular/html/dbl1ja.dsl:20:26:E: unknown
c
haracter name "U-524D\U-306E\U-30DA\U-30FC\U-30B8"
jade:/usr/lib/sgml/stylesheets/nwalsh-modular/html/dbl1ja.dsl:29:26:E: unknown
c
haracter name "U-6B21\U-306E\U-30DA\U-30FC\U-30B8"

That I don't know what they mean. Quick web search said something about 
semicolons. (Maybe differences between docware jade and openjade?) 
Nevertheless the HTML and plaintext look good to me.

Now, what I'm wondering is if I should put the man-only cygwin-doc package
on hold so I could package up the txt files to go in /usr/doc/cygwin-doc/ 
and the html in... /usr/doc/cygwin-doc/html/ (?) as well. The build does
depend on the (so far 3rd party) SGML/XML packages. 
Any opinions?

__________________________________________________
Do You Yahoo!?
Yahoo! Tax Center - online filing with TurboTax
http://taxes.yahoo.com/