about summary refs log tree commit diff
diff options
context:
space:
mode:
authorRical Jasan <ricaljasan@pacific.net>2017-06-20 03:46:24 -0700
committerRical Jasan <ricaljasan@pacific.net>2017-08-10 19:58:30 -0700
commit4fcdfbfcf9d5c5a313da43f78309aa2745b2dc32 (patch)
tree42fbacf6a2f7cb7c4263790a75b5d3e47966cb3e
parent4d98ace9de3183309cb394cd0110eda5ad2d2531 (diff)
downloadglibc-4fcdfbfcf9d5c5a313da43f78309aa2745b2dc32.tar.gz
glibc-4fcdfbfcf9d5c5a313da43f78309aa2745b2dc32.tar.xz
glibc-4fcdfbfcf9d5c5a313da43f78309aa2745b2dc32.zip
manual: Update @standards for [__]va_copy.
The ISO version in which va_copy was introduced is made explicit, and
__va_copy is given @standards.  The description is updated to be more
clear about the origins of each macro, and the reader is informed
these macros are now provided by the compiler (information previously
embedded in a Texinfo @comment).

	* lang.texi (va_copy): Change standard from ISO to C99.
	(__va_copy): Add standard and header annotation.
	Update description for clarity of origins and current use.
-rw-r--r--ChangeLog6
-rw-r--r--manual/lang.texi15
2 files changed, 15 insertions, 6 deletions
diff --git a/ChangeLog b/ChangeLog
index 50db77f49a..421e82afa0 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2017-08-10  Rical Jasan  <ricaljasan@pacific.net>
+
+	* lang.texi (va_copy): Change standard from ISO to C99.
+	(__va_copy): Add standard and header annotation.
+	Update description for clarity of origins and current use.
+
 2017-08-10  Gabriel F. T. Gomes  <gftg@linux.vnet.ibm.com>
 
 	[BZ #21941]
diff --git a/manual/lang.texi b/manual/lang.texi
index 75af677dc9..d8c4bd7f69 100644
--- a/manual/lang.texi
+++ b/manual/lang.texi
@@ -471,18 +471,21 @@ of the same type.
 
 @deftypefn {Macro} void va_copy (va_list @var{dest}, va_list @var{src})
 @deftypefnx {Macro} void __va_copy (va_list @var{dest}, va_list @var{src})
-@standardsx{va_copy, ISO, stdarg.h}
+@standardsx{va_copy, C99, stdarg.h}
+@standardsx{__va_copy, GNU, stdarg.h}
 @safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
-@c This is no longer provided by glibc, but rather by the compiler.
 The @code{va_copy} macro allows copying of objects of type
 @code{va_list} even if this is not an integral type.  The argument pointer
 in @var{dest} is initialized to point to the same argument as the
 pointer in @var{src}.
 
-This macro was added in ISO C99.  When building for strict conformance
-to ISO C90 (@samp{gcc -ansi}), it is not available.  The macro
-@code{__va_copy} is available as a GNU extension in any standards
-mode; before GCC 3.0, it was the only macro for this functionality.
+@code{va_copy} was added in ISO C99.  When building for strict
+conformance to ISO C90 (@samp{gcc -std=c90}), it is not available.
+GCC provides @code{__va_copy}, as an extension, in any standards mode;
+before GCC 3.0, it was the only macro for this functionality.
+
+These macros are no longer provided by @theglibc{}, but rather by the
+compiler.
 @end deftypefn
 
 If you want to use @code{va_copy} and be portable to pre-C99 systems,