Mailing-List: contact cygwin-apps-help AT cygwin DOT com; run by ezmlm
Sender: cygwin-apps-owner AT cygwin DOT com
List-Subscribe: <mailto:cygwin-apps-subscribe AT cygwin DOT com>
List-Archive: <http://sources.redhat.com/ml/cygwin-apps/>
List-Post: <mailto:cygwin-apps AT cygwin DOT com>
List-Help: <mailto:cygwin-apps-help AT cygwin DOT com>, <http://sources.redhat.com/lists.html#faqs>
Mail-Followup-To: cygwin-apps AT cygwin DOT com
Delivered-To: mailing list cygwin-apps AT cygwin DOT com
Message-ID: <20020416030008.58433.qmail@web20002.mail.yahoo.com>
Date: Mon, 15 Apr 2002 20:00:08 -0700 (PDT)
From: Joshua Daniel Franklin <joshuadfranklin AT yahoo DOT com>
Subject: Re: cygwin-doc ready for upload
To: cygwin-apps AT cygwin DOT com
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii

> I just checked the discussion about this, and you asked if someone was
> already maintaining newlib-man.  I don't think I ever answered but the
> answer is "no".  It looks like the man pages aren't even generated by
> newlib anymore.  Instead there is a big info file generated by 'make info'.
> 
> Any chance that this could be incorpoated into your distribution?  The
> sources are already part of the cygwin package so there isn't any need
> to include them.

OK, it sounds like I should:
1) incorporate newlib-man-20001118 into cygwin-doc, maybe after a little
   sed that would put a "This doc is no longer being maintained; try info"    
2) work on something to break the current newlib texinfo into man pages

Either way, I'd rather go ahead with the cygwin-doc as-is and put it on my
documentation todo list. So far I've got:
--Add the HTML for cygwin User's Guide, API Reference, etc. (after the
openjade,
  etc. packages are added)
--Finish patching the utils so that they output useful --help (and --version)  
  
  and then update utils.sgml to reflect those changes, then update the man
pages
  (which are generated from utils.sgml)
--Add useful descriptions to the cygwin_foo() functions that currently have
none
--Figure out how to make info files from the cygwin sgml 
--Actually update the documentation to reflect the current state of affairs

__________________________________________________
Do You Yahoo!?
Yahoo! Tax Center - online filing with TurboTax
http://taxes.yahoo.com/