[doc] Reword description of -Wno-absolute-value

2019-02-27  Martin Jambor  <mjambor@suse.cz>
	    Martin Sebor  <msebor@redhat.com>

	* doc/invoke.texi (Warning Options): Reword description of
	-Wno-absolute-value.

Co-Authored-By: Martin Sebor <msebor@redhat.com>
From-SVN: r269246

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 961131bcf03b286b4c7a438dbb37e13abbc62014..611730062ded9c44bc1d085f66eede231ecb67e7 100644 (file)
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,9 @@
+2019-02-27  Martin Jambor  <mjambor@suse.cz>
+           Martin Sebor  <msebor@redhat.com>
+
+       * doc/invoke.texi (Warning Options): Reword description of
+       -Wno-absolute-value.
+
 2019-02-27  Jakub Jelinek  <jakub@redhat.com>
 
        PR tree-optimization/89280

diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index dedf3c4d912888a0e7e4cf2a9c0ae478fe097531..a8efa1afd1151ca916b84fd13fceeddcbd0cd755 100644 (file)
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -6656,9 +6656,13 @@ example, warn if an unsigned variable is compared against zero with
 @item -Wabsolute-value @r{(C and Objective-C only)}
 @opindex Wabsolute-value
 @opindex Wno-absolute-value
-Warn when a wrong absolute value function seems to be used or when it
-does not have any effect because its argument is an unsigned type.
-This warning be suppressed with an explicit type cast and it is also
+Warn for calls to standard functions that compute the absolute value
+of an argument when a more appropriate standard function is available.
+For example, calling @code{abs(3.14)} triggers the warning because the
+appropriate function to call to compute the absolute value of a double
+argument is @code{fabs}.  The option also triggers warnings when the
+argument in a call to such a function has an unsigned type.  This
+warning can be suppressed with an explicit type cast and it is also
 enabled by @option{-Wextra}.
 
 @include cppwarnopts.texi