X-Spam-Check-By: sourceware.org
To: cygwin AT cygwin DOT com
From: mwoehlke <mwoehlke AT tibco DOT com>
Subject:  Re: Um... what format are Cygwin manpages?
Date:  Thu, 10 Aug 2006 10:21:38 -0500
Lines: 46
Message-ID: <ebfiu4$4pn$1@sea.gmane.org>
References:  <ebd0om$gjh$1 AT sea DOT gmane DOT org> <cb51e2e0608092159t14175e52jeb656ffd2cc123a1 AT mail DOT gmail DOT com>
Mime-Version:  1.0
Content-Type:  text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding:  7bit
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.8.0.5) Gecko/20060719 Thunderbird/1.5.0.5 Mnenhy/0.7.4.0
In-Reply-To: <cb51e2e0608092159t14175e52jeb656ffd2cc123a1@mail.gmail.com>
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

Joshua Daniel Franklin wrote:
> On 8/9/06, mwoehlke wrote:
>> I thought I'd have a crack at fixing the manpage for printf(3) (see
>> http://cygwin.com/ml/cygwin/2006-08/msg00288.html), but when I opened
>> it, I was a bit shocked to discover that it is only *MARGINALLY* in
>> troff format. I do note that other manpages seem more "normal" (man1
>> pages, for instance)... So, is this just "how the C lib manpages are"?
> 
> 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? (Btw, symlinks for sprintf, 
fprintf, snprintf, etc, seem to be missing?)

Anyway, if you're maintaining info->man, I totally understand why that 
would have the format it does. I would be more confused if someone was 
actually maintaining not-nroff nroff. :-)

> Be careful with Linux  man pages, some are licensed from the Open Group.
> If so the package should come with a copyright file like this:
> 
> http://packages.debian.org/changelogs/pool/non-free/m/manpages-posix/manpages-posix_1.67-3/manpages-posix.copyright 
> 
> Unfortunately we are not allowed to redistribute those, unless you'd like
> to do the legwork to get permission to do so. :)

.\" Copyright (c) 1999 Andries Brouwer (aeb AT cwi DOT nl)
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.

I assume the above is OK? :-)

> Also I just posted for upload a new cygwin-doc package before I read
> this thread, so there would be more of a delay.

Bummer. Oh, well.

-- 
Matthew
vIMprove your life! Now on version 7!


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