This is the mail archive of the cygwin mailing list for the Cygwin project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: Generating and rendering Cygwin docs. (new thread)


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


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]