Re: gcc(1) manpage (was: cvs commit: src/sys/kern kern_sig.c)

This message appeared on cvs-src_at_ and should be on -current_at_

----- Forwarded message from Jeremie Le Hen <jeremie_at_le-hen.org> -----

Subject: Re: gcc(1) manpage (was: cvs commit: src/sys/kern kern_sig.c)
From: Jeremie Le Hen <jeremie_at_le-hen.org>
Date: Tue, 8 Mar 2005 15:31:26 +0100
To: Maxime Henrion <mux_at_FreeBSD.org>
Cc: cvs-src_at_FreeBSD.org
Cc: cvs-all_at_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_at_freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-src
To unsubscribe, send any mail to "cvs-src-unsubscribe_at_freebsd.org"

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

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