delorie.com/archives/browse.cgi   search  
Mail Archives: cygwin/2006/08/09/14:24:36

X-Spam-Check-By: sourceware.org
Date: Wed, 9 Aug 2006 14:24:17 -0400
From: Christopher Faylor <cgf-no-personal-reply-please AT cygwin DOT com>
To: cygwin AT cygwin DOT com
Subject: Re: Um... what format are Cygwin manpages?
Message-ID: <20060809182417.GB29752@trixie.casa.cgf.cx>
Reply-To: cygwin AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com
References: <ebd0om$gjh$1 AT sea DOT gmane DOT org> <ebd3so$s68$1 AT sea DOT gmane DOT org> <ebd8e4$cok$1 AT sea DOT gmane DOT org>
Mime-Version: 1.0
In-Reply-To: <ebd8e4$cok$1@sea.gmane.org>
User-Agent: Mutt/1.5.11
Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
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 Wed, Aug 09, 2006 at 01:10:11PM -0500, mwoehlke wrote:
>mwoehlke wrote:
>>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"?
>>>
>>>I am not going to submit a "patch" on this mess. If I do anything with 
>>>it, I am going to submit a proper troff document. Given how much work 
>>>I would have to do to fix the existing page, I am much more inclined 
>>>to take my printf.3 from my Linux box and adjust it into consistency 
>>>with Cygwin's printf() instead. I'm willing to clean up the existing 
>>>manpage, but I think the style of the Linux manpage would be an 
>>>improvement (what we have looks like it came from HP-UX or something).
>>>
>>>Any opinions?
>>
>>Ok, no doubt this manpage needs to be overhauled. I am going from the 
>>Linux page and finding several omissions in the one currently in Cygwin 
>>("%F", as well as "%ll?").
>>
>>WCTS, does anyone know to what extent locale stuff is supported? The 
>>"%'" modifier? "%*d", etc? "%$1d", etc? "%*1$d", etc?
>
>Ok, experimenting shows that all of the above EXCEPT "%'" are supported 
>(no great surprise). However, I also noticed that "%a", which is 
>required by C99, is not supported?
>
>I have a modified Linux manpage almost ready to go; I assume that goes 
>to cygwin.patches?

No, that would be appropriate only if the man page was found in the
winsup hierarchy.  The first line of printf(3) says "NEWLIB" when
I type "man 3 printf" so that's where a man page patch should go.

cgf

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

- Raw text -


  webmaster     delorie software   privacy  
  Copyright © 2019   by DJ Delorie     Updated Jul 2019