X-Recipient: archive-cygwin AT delorie DOT com X-Spam-Check-By: sourceware.org Date: Tue, 5 Jan 2010 02:49:40 -0500 From: Christopher Faylor To: cygwin AT cygwin DOT com Subject: Re: Generating and rendering Cygwin docs. (new thread) Message-ID: <20100105074940.GB12923@ednor.casa.cgf.cx> Reply-To: cygwin AT cygwin DOT com Mail-Followup-To: cygwin AT cygwin DOT com References: <4B42E174 DOT 9010009 AT veritech DOT com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <4B42E174.9010009@veritech.com> User-Agent: Mutt/1.5.20 (2009-06-14) Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: cygwin-owner AT cygwin DOT com Mail-Followup-To: cygwin AT cygwin DOT com Delivered-To: mailing list cygwin AT cygwin DOT com 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