Date: Tue, 8 Mar 2005 18:00:38 +0200 From: Giorgos Keramidas <keramida@freebsd.org> To: Jeremie Le Hen <jeremie@le-hen.org> Cc: freebsd-current@freebsd.org Subject: Re: gcc(1) manpage (was: cvs commit: src/sys/kern kern_sig.c) Message-ID: <20050308160038.GA20539@orion.daedalusnetworks.priv> In-Reply-To: <20050308152658.GP94451@obiwan.tataz.chchile.org> References: <20050308152658.GP94451@obiwan.tataz.chchile.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On 2005-03-08 16:26, Jeremie Le Hen <jeremie@le-hen.org> wrote:
>> 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.
David O'Brien has posted a copy of the gcc.1 manpage to be, which has
been generated by Pod::Man. Converting this to groff_mdoc is a huge job
that I haven't managed to complete yet, even though a few months have
passed since I got the message from David.
The main problem with this conversion is that I have relatively "high"
standards of what the mdoc text should look like, in order to be a BSD
manpage.
Keeping the standards of the rest of the manpages, as I understand these
style/standard guidelines by osmosis (i.e. by looking at the work of
Ruslan Ermilov), and having as much of the Texinfo documentation for GCC
in one place is a "significant job" as it was said above. One that I am
not sure I can manage at my spare time between ${REAL_JOB} stuff.
Having said that, I think that a real manpage for GCC would be great!
- Giorgos
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20050308160038.GA20539>