OpenE2K/gcc
2
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

* extend.texi: Update documentation for default format attributes.

Browse Source 
From-SVN: r37844
This commit is contained in:
Joseph Myers 2000-11-29 07:38:20 +00:00 committed by Joseph Myers
parent 01fa3508b6
commit b722c82c7d
2 changed files with 16 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
gcc/ChangeLog
View File

@ -1,3 +1,7 @@
2000-11-29 Joseph S. Myers <jsm28@cam.ac.uk>
* extend.texi: Update documentation for default format attributes.
Tue Nov 28 21:56:45 2000 Jeffrey A Law (law@cygnus.com) Tue Nov 28 21:56:45 2000 Jeffrey A Law (law@cygnus.com)
* pa/pa-64.h (ASM_OUTPUT_SECTION_NAME): Use a hash table, not * pa/pa-64.h (ASM_OUTPUT_SECTION_NAME): Use a hash table, not

17
gcc/extend.texi
View File

@ -1525,7 +1525,8 @@ string argument (starting from 1), while @var{first-to-check} is the
number of the first argument to check against the format string. For number of the first argument to check against the format string. For
functions where the arguments are not available to be checked (such as functions where the arguments are not available to be checked (such as
@code{vprintf}), specify the third parameter as zero. In this case the @code{vprintf}), specify the third parameter as zero. In this case the
compiler only checks the format string for consistency. compiler only checks the format string for consistency. For
@code{strftime} formats, the third parameter is required to be zero.
In the example above, the format string (@code{my_format}) is the second 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 argument of the function @code{my_print}, and the arguments to check
@ -1534,12 +1535,16 @@ attribute are 2 and 3.
The @code{format} attribute allows you to identify your own functions The @code{format} attribute allows you to identify your own functions
which take format strings as arguments, so that GNU CC can check the which take format strings as arguments, so that GNU CC can check the
calls to these functions for errors. The compiler always checks formats calls to these functions for errors. The compiler always (unless
for the ANSI library functions @code{printf}, @code{fprintf}, @samp{-ffreestanding} is used) checks formats
for the standard library functions @code{printf}, @code{fprintf},
@code{sprintf}, @code{scanf}, @code{fscanf}, @code{sscanf}, @code{strftime}, @code{sprintf}, @code{scanf}, @code{fscanf}, @code{sscanf}, @code{strftime},
@code{vprintf}, @code{vfprintf} and @code{vsprintf} whenever such @code{vprintf}, @code{vfprintf} and @code{vsprintf} whenever such
warnings are requested (using @samp{-Wformat}), so there is no need to warnings are requested (using @samp{-Wformat}), so there is no need to
modify the header file @file{stdio.h}. modify the header file @file{stdio.h}. In C99 mode, the functions
@code{snprintf}, @code{vsnprintf}, @code{vscanf}, @code{vfscanf} and
@code{vsscanf} are also checked.
@xref{C Dialect Options,,Options Controlling C Dialect}.
@item format_arg (@var{string-index}) @item format_arg (@var{string-index})
@cindex @code{format_arg} function attribute @cindex @code{format_arg} function attribute
@ -1568,7 +1573,9 @@ functions which modify format strings, so that GNU CC can check the
calls to @code{printf}, @code{scanf}, or @code{strftime} function whose calls to @code{printf}, @code{scanf}, or @code{strftime} function whose
operands are a call to one of your own function. The compiler always operands are a call to one of your own function. The compiler always
treats @code{gettext}, @code{dgettext}, and @code{dcgettext} in this treats @code{gettext}, @code{dgettext}, and @code{dcgettext} in this
manner. manner except when strict ISO C support is requested by @samp{-ansi} or
an appropriate @samp{-std} option, or @samp{-ffreestanding} is used.
@xref{C Dialect Options,,Options Controlling C Dialect}.
@item no_instrument_function @item no_instrument_function
@cindex @code{no_instrument_function} function attribute @cindex @code{no_instrument_function} function attribute