This is the mail archive of the
gcc@gcc.gnu.org
mailing list for the GCC project.
Re: Documentation generation patch [Take 2]
- To: "Joseph S. Myers" <jsm28 at cam dot ac dot uk>
- Subject: Re: Documentation generation patch [Take 2]
- From: Geoff Keating <geoffk at geoffk dot org>
- Date: 10 May 2001 13:35:23 -0700
- CC: gcc at gcc dot gnu dot org
- References: <Pine.LNX.4.33.0105102110580.2005-100000@kern.srcf.societies.cam.ac.uk>
"Joseph S. Myers" <jsm28@cam.ac.uk> writes:
> * Almost all users of GCC do not need to know about porting it; if they
> buy a printed manual, or print one out, the porting information is not
> useful to them. Only the information on asm constraints probably needs to
> be in both using and porting manuals. "Using and Porting" reflects a
> different era of GCC users. If someone is porting, since interfaces do
> change incompatibly at present they want the current mainline manual, not
> anything in a bought volume that relates to a previous release.
I believe there is a switch that you can pass (to texinfo?) that will
cut out all the 'porting' stuff and produce a manual titled 'Using GCC'.
I think it's better to have one manual for writing front-ends and back-ends,
but with a clear separation (for instance, separate chapters).
--
- Geoffrey Keating <geoffk@geoffk.org>