On Tue, Jan 05, 2010 at 01:51:32AM -0500, Lee Rothstein wrote: >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.
Write *what* up? There is a makefile in winsup/doc. That's how documentation is generated. If you want a format that is not there then investigating the makefile would be the way to go. cgf -- 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
