X-Recipient: archive-cygwin AT delorie DOT com
X-SWARE-Spam-Status: No, hits=-2.2 required=5.0 	tests=AWL,BAYES_00,SPF_HELO_PASS
X-Spam-Check-By: sourceware.org
Message-ID: <4B42E174.9010009@veritech.com>
Date: Tue, 05 Jan 2010 01:51:32 -0500
From: Lee Rothstein <lee AT veritech DOT com>
Reply-To: lee AT veritech DOT com
User-Agent: Thunderbird 2.0.0.23 (Windows/20090812)
MIME-Version: 1.0
To: cygwin AT cygwin DOT com
Subject: Re: Generating and rendering Cygwin docs. (new thread)
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-IsSubscribed: yes
Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
List-Id: <cygwin.cygwin.com>
List-Subscribe: <mailto:cygwin-subscribe AT cygwin DOT com>
List-Archive: <http://sourceware.org/ml/cygwin/>
List-Post: <mailto:cygwin AT cygwin DOT com>
List-Help: <mailto:cygwin-help AT cygwin DOT com>, <http://sourceware.org/ml/#faqs>
Sender: cygwin-owner AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com
Delivered-To: mailing list cygwin AT cygwin DOT com

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