From owner-cvs-all@FreeBSD.ORG  Thu Nov 11 16:35:18 2004
Return-Path: <owner-cvs-all@FreeBSD.ORG>
Delivered-To: cvs-all@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id BBCA416A4CE; Thu, 11 Nov 2004 16:35:18 +0000 (GMT)
Received: from dragon.nuxi.com (trang.nuxi.com [66.93.134.19])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 6DE3A43D2F; Thu, 11 Nov 2004 16:35:18 +0000 (GMT)
	(envelope-from obrien@NUXI.com)
Received: from dragon.nuxi.com (obrien@localhost [127.0.0.1])
	by dragon.nuxi.com (8.13.1/8.13.1) with ESMTP id iABGZHKF056564;
	Thu, 11 Nov 2004 08:35:17 -0800 (PST)
	(envelope-from obrien@dragon.nuxi.com)
Received: (from obrien@localhost)
	by dragon.nuxi.com (8.13.1/8.13.1/Submit) id iABGZH73056563;
	Thu, 11 Nov 2004 08:35:17 -0800 (PST)
	(envelope-from obrien)
Date: Thu, 11 Nov 2004 08:35:17 -0800
From: "David O'Brien" <obrien@freebsd.org>
To: Giorgos Keramidas <keramida@freebsd.org>
Message-ID: <20041111163517.GA56382@dragon.nuxi.com>
References: <200411110745.iAB7j1tj085796@repoman.freebsd.org>
	<20041111144834.GA735@orion.daedalusnetworks.priv>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20041111144834.GA735@orion.daedalusnetworks.priv>
User-Agent: Mutt/1.4.1i
X-Operating-System: FreeBSD 6.0-CURRENT
Organization: The NUXI BSD Group
X-Pgp-Rsa-Fingerprint: B7 4D 3E E9 11 39 5F A3  90 76 5D 69 58 D9 98 7A
X-Pgp-Rsa-Keyid: 1024/34F9F9D5
cc: cvs-src@freebsd.org
cc: src-committers@freebsd.org
cc: cvs-all@freebsd.org
Subject: Re: cvs commit: src/contrib/gcc gcc.1
X-BeenThere: cvs-all@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
Reply-To: obrien@freebsd.org
List-Id: CVS commit messages for the entire tree <cvs-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/cvs-all>
List-Post: <mailto:cvs-all@freebsd.org>
List-Help: <mailto:cvs-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 11 Nov 2004 16:35:18 -0000

On Thu, Nov 11, 2004 at 04:48:35PM +0200, Giorgos Keramidas wrote:
> On 2004-11-11 07:45, "David E. O'Brien" <obrien@freebsd.org> wrote:
> >
> > Don't attempt to claim what version of GCC we're documenting.  The manpage
> > is still mostly the GCC 2.95 one, with faint attempts by me over the years
> > to document a few new switches.  Thus, it is dubious to claim documentation
> > of specific modern GCC versions.
> >
> > Noted by:       delphij
> >
> > Revision  Changes    Path
> > 1.20      +1 -1      src/contrib/gcc/gcc.1
> 
> Does it make sense to attempt writing an mdoc manpage for a more modern
> version of gcc, using the info manuals as the source?

That is one approach.  We should maybe periodically (say when GCC is
upgraded across major revisions) build the port of the same version, and
just commit built man page.[*]  It will be in ancient nroff, but at least
it will be current.  Maybe we could even write a script to wack it more
into mandoc format.  I can mail you the 3.4 port manpage to play with.

-- 
-- David  (obrien@FreeBSD.org)

[*] the manpage is built from texinfo sources, using perl and Pod::Man.