From owner-freebsd-current@FreeBSD.ORG  Tue Mar  8 15:27:01 2005
Return-Path: <owner-freebsd-current@FreeBSD.ORG>
Delivered-To: freebsd-current@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id BA1A016A4CE
	for <current@FreeBSD.org>; Tue,  8 Mar 2005 15:27:01 +0000 (GMT)
Received: from postfix3-1.free.fr (postfix3-1.free.fr [213.228.0.44])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 40EDD43D41
	for <current@FreeBSD.org>; Tue,  8 Mar 2005 15:27:01 +0000 (GMT)
	(envelope-from tataz@tataz.chchile.org)
Received: from tatooine.tataz.chchile.org
	(vol75-8-82-233-239-98.fbx.proxad.net [82.233.239.98])
	by postfix3-1.free.fr (Postfix) with ESMTP id D906A1734B5
	for <current@FreeBSD.org>; Tue,  8 Mar 2005 16:26:59 +0100 (CET)
Received: by tatooine.tataz.chchile.org (Postfix, from userid 1000)
	id 5D713407C; Tue,  8 Mar 2005 16:26:58 +0100 (CET)
Date: Tue, 8 Mar 2005 16:26:58 +0100
From: Jeremie Le Hen <jeremie@le-hen.org>
To: current@FreeBSD.org
Message-ID: <20050308152658.GP94451@obiwan.tataz.chchile.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.5.8i
Subject: Re: gcc(1) manpage (was: cvs commit: src/sys/kern kern_sig.c)
X-BeenThere: freebsd-current@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Discussions about the use of FreeBSD-current
	<freebsd-current.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-current>,
	<mailto:freebsd-current-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-current>
List-Post: <mailto:freebsd-current@freebsd.org>
List-Help: <mailto:freebsd-current-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-current>,
	<mailto:freebsd-current-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 08 Mar 2005 15:27:01 -0000

This message appeared on cvs-src@ and should be on -current@

----- Forwarded message from Jeremie Le Hen <jeremie@le-hen.org> -----

Subject: Re: gcc(1) manpage (was: cvs commit: src/sys/kern kern_sig.c)
From: Jeremie Le Hen <jeremie@le-hen.org>
Date: Tue, 8 Mar 2005 15:31:26 +0100
To: Maxime Henrion <mux@FreeBSD.org>
Cc: cvs-src@FreeBSD.org
Cc: cvs-all@FreeBSD.org

Hi,

> This version number in the gcc(1) manpage is really the least of the
> problems...  The GCC guys don't maintain the manpage anymore, as they
> prefer the info page to document things now.  The gcc(1) manpage hasn't
> been updated since _long_.  In short, it's not only a matter of getting
> the latest manpage from the GCC project, it's a matter of synchronizing
> this manpage with the (huge) GCC info page and it's a significant job.

I would take advantage of this thread to ask what people think about
converting gcc(1) info page to a manual page.  Of course, this manual
page wouldn't be very academic but IMHO, it would keep the Unix
tradition of having a single manual page containing all informations
about the software.

It appears there is a tool called info2man [1] : this is a Perl script
that first use info2pod and then pod2man.  I agree this is ugly, but
modulo some tweaks, the result seems to be quite readable [2] as a
manual page.

Juste my 2 cents :-).

Regards,

[1] ports/textproc/info2man
[2] http://jeremie.le-hen.org/~tataz/gcc_info2man/gcc.1
    http://jeremie.le-hen.org/~tataz/gcc_info2man/gcc.txt
-- 
Jeremie Le Hen
jeremie at le-hen dot org
_______________________________________________
cvs-src@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-src
To unsubscribe, send any mail to "cvs-src-unsubscribe@freebsd.org"

----- End forwarded message -----

-- 
Jeremie Le Hen
jeremie at le-hen dot org