X-Spam-Check-By: sourceware.org
Message-ID: <cb51e2e0608101108g41c88386wd7219aaead8ca396@mail.gmail.com>
Date: Thu, 10 Aug 2006 11:08:23 -0700
From: "Joshua Daniel Franklin" <joshuadfranklin AT gmail DOT com>
To: cygwin AT cygwin DOT com
Subject: Re: Um... what format are Cygwin manpages?
In-Reply-To: <ebfiu4$4pn$1@sea.gmane.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
References: <ebd0om$gjh$1 AT sea DOT gmane DOT org> 	 <cb51e2e0608092159t14175e52jeb656ffd2cc123a1 AT mail DOT gmail DOT com> 	 <ebfiu4$4pn$1 AT sea DOT gmane DOT org>
X-IsSubscribed: yes
Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
Precedence: bulk
List-Unsubscribe: <mailto:cygwin-unsubscribe-archive-cygwin=delorie DOT com AT cygwin DOT com>
List-Subscribe: <mailto:cygwin-subscribe AT cygwin DOT com>
List-Archive: <http://sourceware.org/ml/cygwin/>
List-Post: <mailto:cygwin AT cygwin DOT com>
List-Help: <mailto:cygwin-help AT cygwin DOT com>, <http://sourceware.org/ml/#faqs>
Sender: cygwin-owner AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com
Delivered-To: mailing list cygwin AT cygwin DOT com

On 8/10/06, mwoehlke wrote:
> Joshua Daniel Franklin wrote:
> > Yes, it's sort-of my fault. I just have a Perl script that chunks the
> > newlib libc.info files into faux man pages.
>
> Ah, ok, makes sense. Too bad newlib doesn't have proper manpages, in
> that case. Although am I understanding that newlib itself doesn't have
> *any* manpages, meaning a: I need to be fixing their INFO, and b: any
> manpages should be sent this way after all?

Well, I'd be for fixing the newlib files rather than replacing them. The issue
with replacing them with our own custom versions or with Linux ones is that
the documentation no longer comes from the actual upstream libc (or worse--
in the case of Linux it comes from a possibly incompatible *different*
upstream libc).

If you'd like to add better *roff formatting to the perl script, it's
in the cygwin-doc
src package. A warning, though, it's a mess.

--
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple
Problem reports:       http://cygwin.com/problems.html
Documentation:         http://cygwin.com/docs.html
FAQ:                   http://cygwin.com/faq/