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 <cgf-use-the-mailinglist-please AT cygwin DOT com>
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
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
List-Id:	<cygwin.cygwin.com>
List-Unsubscribe:	<mailto:cygwin-unsubscribe-archive-cygwin=delorie DOT com AT cygwin DOT 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

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

- Raw text -