From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <cygwin-talk-return-2682-listarch-cygwin-talk=sources.redhat.com@cygwin.com>
Received: (qmail 8057 invoked by alias); 11 Aug 2006 08:34:07 -0000
Received: (qmail 8050 invoked by uid 22791); 11 Aug 2006 08:34:06 -0000
X-Spam-Check-By: sourceware.org
Received: from aquarius.hirmke.de (HELO calimero.vinschen.de) (217.91.18.234)     by sourceware.org (qpsmtpd/0.31.1) with ESMTP; Fri, 11 Aug 2006 08:33:57 +0000
Received: by calimero.vinschen.de (Postfix, from userid 500) 	id B942A544001; Fri, 11 Aug 2006 10:33:54 +0200 (CEST)
Date: Fri, 11 Aug 2006 08:34:00 -0000
From: Corinna Vinschen <corinna-cygwin@cygwin.com>
To: cygwin-talk@cygwin.com
Subject: Re: What's wrong with *roff, anyway? (Was: Um... what format are Cygwin  manpages?)
Message-ID: <20060811083354.GA4521@calimero.vinschen.de>
Reply-To: cygwin-talk@cygwin.com
Mail-Followup-To: cygwin-talk@cygwin.com
References: <cb51e2e0608092159t14175e52jeb656ffd2cc123a1@mail.gmail.com> <ebfiu4$4pn$1@sea.gmane.org> <cb51e2e0608101108g41c88386wd7219aaead8ca396@mail.gmail.com> <ebg4e5$39g$1@sea.gmane.org> <20060810202721.GC935@trixie.casa.cgf.cx> <ebg5l8$5f2$2@sea.gmane.org> <20060810205421.GG935@trixie.casa.cgf.cx> <ebg809$erd$1@sea.gmane.org> <20060810213052.GB11554@trixie.casa.cgf.cx> <ebgbpd$ptp$1@sea.gmane.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <ebgbpd$ptp$1@sea.gmane.org>
User-Agent: Mutt/1.4.2i
Mailing-List: contact cygwin-talk-help@cygwin.com; run by ezmlm
Precedence: bulk
List-Subscribe: <mailto:cygwin-talk-subscribe@cygwin.com>
List-Post: <mailto:cygwin-talk@cygwin.com>
List-Help: <mailto:cygwin-talk-help@cygwin.com>, <http://cygwin.com/lists.html#faqs>
Sender: cygwin-talk-owner@cygwin.com
Reply-To: The Cygwin-Talk Maiming List <cygwin-talk@cygwin.com>
X-SW-Source: 2006-q3/txt/msg00148.txt.bz2

On Aug 10 17:25, mwoehlke wrote:
> Christopher Faylor wrote:
> >Actually, on some further digging it is, most likely, in sprintf.c
> >So, no texinfo editing required.
> 
> Hey! Now I found that /all//by//myself/, thank you! ;-)
> (See, I told you I'd keep looking.)
> 
> And... now I understand why the ->nroff converter works so poorly. Eek. 
> Do you really do the indentation and line length *by hand*, or am I 
> missing something?

Hey, you could just sit down and generate a patch which pulls all
documentation out of the source files, changes it to texinfo format and
integrates them in a structured way into the newlib/doc subdirectory.
Then you just have to add the Makefiles changes so that generation and
installation as man pages, info pages, html pages, tex documentation,
pdf files...  is possible.  I'm *sure* Jeff would like the idea and
happily take the patch.


Corinna