re PR c++/1607 ([3.3 only] Format attributes on methods undocumented)

	PR c++/1607
	* doc/extend.texi (Function Attributes): Document the effect of
	the C++ "this" parameter on the counting of arguments for the
	"format" and "format_arg" attributes.

From-SVN: r63030

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index e34ead5a8d89ce8705f2edde21b479ce428b6429..5500f28125af864f704a7f1e85be264479c01be1 100644 (file)
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,10 @@
+2003-02-18  Ben Elliston  <bje@redhat.com>
+
+       PR c++/1607
+       * doc/extend.texi (Function Attributes): Document the effect of
+       the C++ "this" parameter on the counting of arguments for the
+       "format" and "format_arg" attributes.
+
 2003-02-17  Aldy Hernandez  <aldyh@redhat.com>
 
         * config/rs6000/spe.h (__ev_stdd): Cast 2nd arg.

diff --git a/gcc/doc/extend.texi b/gcc/doc/extend.texi
index 2ca034bde86523c7f465ef2929953a437627ff5f..86e0491125c817a63cc55872fa8087d8fa6105a4 100644 (file)
--- a/gcc/doc/extend.texi
+++ b/gcc/doc/extend.texi
@@ -2101,6 +2101,9 @@ functions where the arguments are not available to be checked (such as
 @code{vprintf}), specify the third parameter as zero.  In this case the
 compiler only checks the format string for consistency.  For
 @code{strftime} formats, the third parameter is required to be zero.
+Since non-static C++ methods have an implicit @code{this} argument, the
+arguments of such methods should be counted from two, not one, when
+giving values for @var{string-index} and @var{first-to-check}.
 
 In the example above, the format string (@code{my_format}) is the second
 argument of the function @code{my_print}, and the arguments to check
@@ -2153,7 +2156,9 @@ string argument is not constant; this would generate a warning when
 without the attribute.
 
 The parameter @var{string-index} specifies which argument is the format
-string argument (starting from 1).
+string argument (starting from one).  Since non-static C++ methods have
+an implicit @code{this} argument, the arguments of such methods should
+be counted from two.
 
 The @code{format-arg} attribute allows you to identify your own
 functions which modify format strings, so that GCC can check the