This is the mail archive of the
gcc@gcc.gnu.org
mailing list for the GCC project.
Re: organization of optimization options in manual
- From: Sandra Loosemore <sandra at codesourcery dot com>
- To: Jeff Law <law at redhat dot com>
- Cc: GCC Development <gcc at gcc dot gnu dot org>, Gerald Pfeifer <gerald at pfeifer dot com>, "Joseph S. Myers" <joseph at codesourcery dot com>
- Date: Wed, 14 Jan 2015 23:12:49 -0700
- Subject: Re: organization of optimization options in manual
- Authentication-results: sourceware.org; auth=none
- References: <54B70059 dot 3030808 at codesourcery dot com> <54B736E8 dot 70406 at redhat dot com>
On 01/14/2015 08:41 PM, Jeff Law wrote:
With the section being ~60 pages, my first thought is we have way too
many options!
Heh, at least we have documentation for all those options. :-)
But that's not likely to change. Though perhaps the
process will encourage some culling of options that really don't make
sense anymore.
Would we want to remove useless options outright, or deprecate them for
a while with removal to happen at some future time, or just deprecate
them and/or document that they are not useful?
I think it's really just grown organically and putting more structure
into it would probably be worth the effort. The question I have is once
we've identified the high level buckets, how much stuff are we likely
going to have in the miscellaneous bucket. If the misc bucket is still
big then folks are still going to struggle with finding the information
they want/need (or think they want/need).
I guess it can't be any worse than it is now, though, where the whole 60
pages is essentially a "misc bucket". I'll see if I can put together a
plan for splitting things up.... if there are too many leftovers maybe
others can help by suggesting different/additional categories.
-Sandra