Message-ID: <4B42C889.6030200@cygwin.com>
Date: Tue, 05 Jan 2010 00:05:13 -0500
From: "Larry Hall (Cygwin)" <reply-to-list-only-lh AT cygwin DOT com>
Reply-To: cygwin AT cygwin DOT com
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.8.1.21) Gecko/20090320 Remi/2.0.0.21-1.fc8.remi Lightning/0.9 Thunderbird/2.0.0.21 Mnenhy/0.7.5.0
MIME-Version: 1.0
To: cygwin AT cygwin DOT com
Subject: Re: Generating and rendering Cygwin docs. Was" Re: [PATCH] avoid  404  link for propietary cygwin license in userguide
References: <20100104161226 DOT GA3611 AT sajinet DOT com DOT pe> <4B425221 DOT 2000009 AT cygwin DOT com> <4B42B88B DOT 6070206 AT veritech DOT com>
In-Reply-To: <4B42B88B.6070206@veritech.com>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
Sender: cygwin-owner AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com

On 01/04/2010 10:56 PM, Lee Rothstein wrote:
> Larry, et al,
>
> * 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.

-- 
Larry Hall                              http://www.rfk.com
RFK Partners, Inc.                      (508) 893-9779 - RFK Office
216 Dalton Rd.                          (508) 893-9889 - FAX
Holliston, MA 01746

_____________________________________________________________________

A: Yes.
 > Q: Are you sure?
 >> A: Because it reverses the logical flow of conversation.
 >>> Q: Why is top posting annoying in email?

--
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