This is the mail archive of the
cygwin
mailing list for the Cygwin project.
Re: Generating and rendering Cygwin docs. Was" Re: [PATCH] avoid 404 link for propietary cygwin license in userguide
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