Re: remove some bits of -Wreorder documentation

[Sylvain Pion <pion at cs dot nyu dot edu>]

On Fri, Aug 16, 2002 at 10:32:50PM +0100, Joseph S. Myers wrote:
> > Maybe we can simply remind this fact in the -Wall documentation, with
> > something like this :
> > 
> > diff -u -r1.173 invoke.texi
> > @@ -2212,7 +2205,9 @@
> >  All of the above @samp{-W} options combined.  This enables all the
> >  warnings about constructions that some users consider questionable, and
> >  that are easy to avoid (or modify to prevent the warning), even in
> > -conjunction with macros.
> > +conjunction with macros.  This also enables some language-specific
> > +warnings described in @ref{C++ Dialect Options} and
> > +@ref{Objective-C Dialect Options}.
> >  @end table
> 
> That approach seems reasonable, as long as the language-specific sections
> do document which language-specific options are in -Wall.

Obj-C seems to have only 2 specific warnings (which are not generic).
-Wall is not mentionned there at all, and I have no clue if these warnings are
enabled by it or not.  An Obj-C maintainer should probably clarify this.

For C++ it seems OK.

So here is my new proposal :
(I don't have write access, so please commit yourself if it's OK)


2002-08-16  Sylvain Pion <pion@cs.nyu.edu>

	* doc/invoke.texi (-Wreorder): Remove remaining pieces from the generic
	section.
	(-Wall): Mention that there can be language-specific warnings as well.


diff -u -r1.174 invoke.texi
--- gcc/doc/invoke.texi 16 Aug 2002 21:18:14 -0000      1.174
+++ gcc/doc/invoke.texi 16 Aug 2002 21:49:12 -0000
@@ -2190,13 +2190,6 @@
 you use that never return as @code{noreturn}.  @xref{Function
 Attributes}.
 
-@item -Wreorder @r{(C++ only)}
-@opindex Wreorder
-@cindex reordering, warning
-@cindex warning for reordering of member initializers
-Warn when the order of member initializers given in the code does not
-match the order in which they must be executed.  For instance:
-
 @item -Wunknown-pragmas
 @opindex Wunknown-pragmas
 @cindex warning for unknown pragmas
@@ -2212,7 +2205,9 @@
 All of the above @samp{-W} options combined.  This enables all the
 warnings about constructions that some users consider questionable, and
 that are easy to avoid (or modify to prevent the warning), even in
-conjunction with macros.
+conjunction with macros.  This also enables some language-specific
+warnings described in @ref{C++ Dialect Options} and
+@ref{Objective-C Dialect Options}.
 @end table
 
 The following @option{-W@dots{}} options are not implied by @option{-Wall}.


-- 
Sylvain