From 07e12bb391ae84eb74817d42feda42cff7f687e5 Mon Sep 17 00:00:00 2001 From: Joseph Myers Date: Fri, 2 Mar 2012 15:23:30 +0000 Subject: [PATCH] Document properties of standard typedefs, not exact types. --- ChangeLog | 10 ++++++++++ manual/filesys.texi | 29 ++++++++++++++--------------- manual/llio.texi | 4 ++-- 3 files changed, 26 insertions(+), 17 deletions(-) diff --git a/ChangeLog b/ChangeLog index a10bb8bc916..cb3e30b5343 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,15 @@ 2012-03-02 Joseph Myers + * manual/filesys.texi (mode_t): Describe constraints on size and + signedness, not exact equivalence to a particular type. + (ino_t): Likewise. + (ino64_t): Likewise. + (dev_t): Likewise. + (nlink_t): Likewise. + (blkcnt_t): Likewise. + (blkcnt64_t): Likewise. + * manual/llio.texi (off_t): Likewise. + [BZ #3976] * sysdeps/ieee754/dbl-64/e_exp.c: Include . (__ieee754_exp): Save and restore rounding mode and use diff --git a/manual/filesys.texi b/manual/filesys.texi index bf3abb44474..872e3710a0d 100644 --- a/manual/filesys.texi +++ b/manual/filesys.texi @@ -1770,17 +1770,18 @@ Here is a list of them. @comment sys/types.h @comment POSIX.1 @deftp {Data Type} mode_t -This is an integer data type used to represent file modes. In the -GNU system, this is equivalent to @code{unsigned int}. +This is an integer data type used to represent file modes. In +@theglibc{}, this is an unsigned type no narrower than @code{unsigned +int}. @end deftp @cindex inode number @comment sys/types.h @comment POSIX.1 @deftp {Data Type} ino_t -This is an arithmetic data type used to represent file serial numbers. +This is an unsigned integer type used to represent file serial numbers. (In Unix jargon, these are sometimes called @dfn{inode numbers}.) -In the GNU system, this type is equivalent to @code{unsigned long int}. +In @theglibc{}, this type is no narrower than @code{unsigned int}. If the source is compiled with @code{_FILE_OFFSET_BITS == 64} this type is transparently replaced by @code{ino64_t}. @@ -1789,9 +1790,9 @@ is transparently replaced by @code{ino64_t}. @comment sys/types.h @comment Unix98 @deftp {Data Type} ino64_t -This is an arithmetic data type used to represent file serial numbers -for the use in LFS. In the GNU system, this type is equivalent to -@code{unsigned long long int}. +This is an unsigned integer type used to represent file serial numbers +for the use in LFS. In @theglibc{}, this type is no narrower than +@code{unsigned int}. When compiling with @code{_FILE_OFFSET_BITS == 64} this type is available under the name @code{ino_t}. @@ -1801,21 +1802,20 @@ available under the name @code{ino_t}. @comment POSIX.1 @deftp {Data Type} dev_t This is an arithmetic data type used to represent file device numbers. -In the GNU system, this is equivalent to @code{int}. +In @theglibc{}, this is an integer type no narrower than @code{int}. @end deftp @comment sys/types.h @comment POSIX.1 @deftp {Data Type} nlink_t -This is an arithmetic data type used to represent file link counts. -In the GNU system, this is equivalent to @code{unsigned short int}. +This is an integer type used to represent file link counts. @end deftp @comment sys/types.h @comment Unix98 @deftp {Data Type} blkcnt_t -This is an arithmetic data type used to represent block counts. -In the GNU system, this is equivalent to @code{unsigned long int}. +This is a signed integer type used to represent block counts. +In @theglibc{}, this type is no narrower than @code{int}. If the source is compiled with @code{_FILE_OFFSET_BITS == 64} this type is transparently replaced by @code{blkcnt64_t}. @@ -1824,9 +1824,8 @@ is transparently replaced by @code{blkcnt64_t}. @comment sys/types.h @comment Unix98 @deftp {Data Type} blkcnt64_t -This is an arithmetic data type used to represent block counts for the -use in LFS. In the GNU system, this is equivalent to @code{unsigned -long long int}. +This is a signed integer type used to represent block counts for the +use in LFS. In @theglibc{}, this type is no narrower than @code{int}. When compiling with @code{_FILE_OFFSET_BITS == 64} this type is available under the name @code{blkcnt_t}. diff --git a/manual/llio.texi b/manual/llio.texi index 9fa0908f2de..f3ed5427247 100644 --- a/manual/llio.texi +++ b/manual/llio.texi @@ -776,8 +776,8 @@ character. @comment sys/types.h @comment POSIX.1 @deftp {Data Type} off_t -This is an arithmetic data type used to represent file sizes. -In the GNU system, this is equivalent to @code{fpos_t} or @code{long int}. +This is a signed integer type used to represent file sizes. In +@theglibc{}, this type is no narrower than @code{int}. If the source is compiled with @code{_FILE_OFFSET_BITS == 64} this type is transparently replaced by @code{off64_t}. -- 2.39.2