From owner-cvs-all@FreeBSD.ORG Tue Mar 8 14:31:29 2005 Return-Path: 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 D483D16A4CE; Tue, 8 Mar 2005 14:31:29 +0000 (GMT) Received: from postfix3-2.free.fr (postfix3-2.free.fr [213.228.0.169]) by mx1.FreeBSD.org (Postfix) with ESMTP id 596DC43D53; Tue, 8 Mar 2005 14:31:29 +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-2.free.fr (Postfix) with ESMTP id 901EBC18B; Tue, 8 Mar 2005 15:31:28 +0100 (CET) Received: by tatooine.tataz.chchile.org (Postfix, from userid 1000) id 37D6C407C; Tue, 8 Mar 2005 15:31:27 +0100 (CET) Date: Tue, 8 Mar 2005 15:31:26 +0100 From: Jeremie Le Hen To: Maxime Henrion Message-ID: <20050308143126.GN94451@obiwan.tataz.chchile.org> References: <200503020915.28512.jhb@FreeBSD.org> <4226446B.7020406@freebsd.org> <61ac46c154aa515a692308440dd1141d@FreeBSD.org> <422710DD.1070203@freebsd.org> <422719E0.10703@samsco.org> <20050307195156.GA18850@dragon.nuxi.com> <422CBDEE.7020307@samsco.org> <20050307211942.GA37106@ns1.xcllnt.net> <20050308131613.GA812@galgenberg.net> <20050308132228.GD31320@elvis.mu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20050308132228.GD31320@elvis.mu.org> User-Agent: Mutt/1.5.8i cc: cvs-src@FreeBSD.org cc: Ulrich Sp?rlein cc: cvs-all@FreeBSD.org Subject: Re: gcc(1) manpage (was: cvs commit: src/sys/kern kern_sig.c) X-BeenThere: cvs-all@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: CVS commit messages for the entire tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 08 Mar 2005 14:31:30 -0000 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 -- Jeremie Le Hen jeremie at le-hen dot org