This is the mail archive of the gcc-patches@gcc.gnu.org mailing list for the GCC project.

Index Nav:	[Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav:	[Date Prev] [Date Next]	[Thread Prev] [Thread Next]
Other format:	[Raw text]

Re: [RS6000] Remove negative from option help strings

From: Alan Modra <amodra at gmail dot com>
To: Segher Boessenkool <segher at kernel dot crashing dot org>
Cc: gcc-patches at gcc dot gnu dot org
Date: Wed, 3 Aug 2016 14:30:59 +0930
Subject: Re: [RS6000] Remove negative from option help strings
Authentication-results: sourceware.org; auth=none
References: <20160802143009.GE20904@bubble.grove.modra.org> <20160802150915.GB9387@gate.crashing.org>

On Tue, Aug 02, 2016 at 10:09:15AM -0500, Segher Boessenkool wrote:
> On Wed, Aug 03, 2016 at 12:00:09AM +0930, Alan Modra wrote:
> > If -m<option>/-mno-<option> were printed when displaying help then it
> > would be appropriate to show "Use/do not use" and similar, but we
> > don't see any mention of -mno-<option>: The help info is printed
> > against -m<option> so IMO it should say what -m<option> does.
> 
> Many of these options are marked Undocumented, so how do you see
> --help displaying these docs?

What are now comments are sitting right where the doc string goes.
It's all too easy to make the option documented by removing the
comment marker and/or "Undocumented", so the comments really ought to
be ready for display with --target-help.

> Okay for trunk, nice cleanup,

And committed.

-- 
Alan Modra
Australia Development Lab, IBM

References:
- [RS6000] Remove negative from option help strings
  - From: Alan Modra
- Re: [RS6000] Remove negative from option help strings
  - From: Segher Boessenkool

Index Nav:	[Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav:	[Date Prev] [Date Next]	[Thread Prev] [Thread Next]