This is the mail archive of the
glibc-cvs@sourceware.org
mailing list for the glibc project.
GNU C Library master sources branch master updated. glibc-2.25-808-gd3675d9
- From: rj at sourceware dot org
- To: glibc-cvs at sourceware dot org
- Date: 27 Jul 2017 11:48:21 -0000
- Subject: GNU C Library master sources branch master updated. glibc-2.25-808-gd3675d9
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU C Library master sources".
The branch, master has been updated
via d3675d957b9427d4d119250514a25aaba78d26de (commit)
from 88f9e739432dc950b1f28638158d6dbb1ebd0361 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
http://sourceware.org/git/gitweb.cgi?p=glibc.git;a=commitdiff;h=d3675d957b9427d4d119250514a25aaba78d26de
commit d3675d957b9427d4d119250514a25aaba78d26de
Author: Rical Jasan <ricaljasan@pacific.net>
Date: Tue Jun 20 06:39:27 2017 -0700
manual: Refactor documentation of CHAR_BIT.
This single-@item @table is better defined with @deftypevr, since the
CHAR_BIT macro has @standards (being declared in a header), and @items
in @tables are not considered annotatable. Using @deftypevr
automatically includes the macro in the Variable and Constant Macro
Index and ensures its inclusion the Summary of Library Facilities.
@deftypevr is used to record the type of the macro so that it also
appears in the Summary.
The description is updated to mention a later POSIX requirement that
this macro have the value 8.
* manual/lang.texi (CHAR_BIT): Convert from an @table to an
@deftypevr. Change standard from ISO to C90. Mention the
POSIX.1-2001 requirement of the value 8.
diff --git a/ChangeLog b/ChangeLog
index 5ca4770..8850e53 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,11 @@
2017-07-27 Rical Jasan <ricaljasan@pacific.net>
+ * manual/lang.texi (CHAR_BIT): Convert from an @table to an
+ @deftypevr. Change standard from ISO to C90. Mention the
+ POSIX.1-2001 requirement of the value 8.
+
+2017-07-27 Rical Jasan <ricaljasan@pacific.net>
+
* manual/creature.texi (_REENTRANT): Annotate as obsolete.
(_THREAD_SAFE): Likewise.
diff --git a/manual/lang.texi b/manual/lang.texi
index c4b641d..75af677 100644
--- a/manual/lang.texi
+++ b/manual/lang.texi
@@ -628,11 +628,10 @@ There is no operator in the C language that can give you the number of
bits in an integer data type. But you can compute it from the macro
@code{CHAR_BIT}, defined in the header file @file{limits.h}.
-@table @code
-@item CHAR_BIT
-@standards{ISO, limits.h}
-This is the number of bits in a @code{char}---eight, on most systems.
-The value has type @code{int}.
+@deftypevr Macro int CHAR_BIT
+@standards{C90, limits.h}
+This is the number of bits in a @code{char}. POSIX.1-2001 requires
+this to be 8.
You can compute the number of bits in any data type @var{type} like
this:
@@ -640,7 +639,7 @@ this:
@smallexample
sizeof (@var{type}) * CHAR_BIT
@end smallexample
-@end table
+@end deftypevr
That expression includes padding bits as well as value and sign bits.
On all systems supported by @theglibc{}, standard integer types other
-----------------------------------------------------------------------
Summary of changes:
ChangeLog | 6 ++++++
manual/lang.texi | 11 +++++------
2 files changed, 11 insertions(+), 6 deletions(-)
hooks/post-receive
--
GNU C Library master sources