Generating and rendering Cygwin docs. (new thread)

Tue Jan 5 07:49:00 GMT 2010

Corinna, Christopher, et al.:
Can you help out here:
Larry Hall (Cygwin) wrote:
 > On 01/04/2010 10:56 PM, Lee Rothstein wrote:
 >> * I'm about to do a review of the Cygwin docs. I'd really like to
 >> do that from a single PDF file per doc (FAQs, User Guide, API
 >> Guide). How do I get from the SGML (or, XML, or Docbook) source
 >> files to a single PDF?
 >> > Or, if that's documented somewhere, point me at it.
 > I'm going to have to leave this for the maintainers of Cygwin
 > documentation to answer since I don't know DocBook stuff.
 >> * Does the answer to the above question, answer the more general
 >> question of how to get from Docbook to a format of my choice,
 >> including?:
 >> > PS/PDF?
 >> > man nroff/troff/groff source?
 >> > XHTML/CSS?
 >> > Or, if that's documented somewhere, point me at it, please.
 > My basic understanding is that if you use DocBook, you can get from
 > one to the other. But I expect that's an incomplete/oversimplified
 > statement.
 >> * If it's not documented, and you can give me even some vague
 >> pointers, I'd be happy to write it up, if you think anybody
 >> would be interested.
 > Wouldn't hurt in my opinion. IIRC, the biggest issue in the past has
 > been to get DocBook working under Cygwin, so Linux has been a
 > requirement to get the documentation generated, as a result. But
 > things may have changed here.
If worse comes to worse, I have access to a Linux system, so I
can use that, but I'd prefer to do this on Cygwin, and write it
up.
Thanks,
Lee
--
Problem reports: http://cygwin.com/problems.html
FAQ: http://cygwin.com/faq/
Documentation: http://cygwin.com/docs.html
Unsubscribe info: http://cygwin.com/ml/#unsubscribe-simple