invoke.texi (-Wstringop-truncation): Mention attribute nonstring.

gcc/ChangeLog:

	* doc/invoke.texi (-Wstringop-truncation): Mention attribute
	nonstring.

From-SVN: r255447

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 5bcc6a9580b3bba0268bd5ea4ad7cbae3ea4a09f..1615acf8a3f9a843990ff9ab16398331474e72c6 100644 (file)
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,5 +1,8 @@
 2017-12-06  Martin Sebor  <msebor@redhat.com>
 
+       * doc/invoke.texi (-Wstringop-truncation): Mention attribute
+       nonstring.
+
        PR tree-optimization/83075
        * tree-ssa-strlen.c (handle_builtin_stxncpy): Avoid assuming
        strncat/strncpy don't change length of source string.

diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index b8c8083daa7209bd7ea27159a4c718f02c63b1fd..3487a62ab284209321cee4118b9d79656dbe3180 100644 (file)
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -5256,6 +5256,14 @@ void copy (const char *s)
 @}
 @end smallexample
 
+In situations where a character array is intended to store a sequence
+of bytes with no terminating @code{NUL} such an array may be annotated
+with attribute @code{nonstring} to avoid this warning.  Such arrays,
+however, are not suitable arguments to functions that expect
+@code{NUL}-terminated strings.  To help detect accidental misuses of
+such arrays GCC issues warnings unless it can prove that the use is
+safe.  @xref{Common Variable Attributes}.
+
 @item -Wsuggest-attribute=@r{[}pure@r{|}const@r{|}noreturn@r{|}format@r{|}cold@r{|}malloc@r{]}
 @opindex Wsuggest-attribute=
 @opindex Wno-suggest-attribute=