Generating and rendering Cygwin docs. Was" Re: [PATCH] avoid 404 link for propietary cygwin license in userguide

[Lee Rothstein]

Larry Hall (Cygwin) wrote:

 > On 01/04/2010 11:12 AM, Carlo Marcelo Arenas Belon wrote:

 >> The following patch replaces a broken link in :

 >>    http://cygwin.com/cygwin-ug-net/are-free.html

 >> with the closest URL I could find in Red Hat's website in reference 
to the
 >> proprietary cygwin licensing terms.  feel free to replace it with a 
better
 >> suited link and/or correct it in Red Hat's website through a 
compatibility
 >> redirect if appropriate.

 > Thanks for the patch.  Looks like it's been applied.

 >> PS. also found some small typo while reading the guide but unsure if 
this
 >>      would be the best/more efficient way to report in those cases

 > Patches are never a bad way to resolve problems you find. :-)

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.

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

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

Thanks,

Lee

P.S. Google searches, 'apropos', and my handy 'rwhich' ('which'
     with regexes) command have not been very helpful.

     E.g.,
     $ rwhich sgml
     /bin/onsgmls.exe
     /bin/osgmlnorm.exe



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