Document properties of standard typedefs, not exact types.

This commit is contained in:
Joseph Myers 2012-03-02 15:23:30 +00:00
parent 28afd92dbd
commit 07e12bb391
3 changed files with 26 additions and 17 deletions

View File

@ -1,5 +1,15 @@
2012-03-02 Joseph Myers <joseph@codesourcery.com> 2012-03-02 Joseph Myers <joseph@codesourcery.com>
* 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] [BZ #3976]
* sysdeps/ieee754/dbl-64/e_exp.c: Include <fenv.h>. * sysdeps/ieee754/dbl-64/e_exp.c: Include <fenv.h>.
(__ieee754_exp): Save and restore rounding mode and use (__ieee754_exp): Save and restore rounding mode and use

View File

@ -1770,17 +1770,18 @@ Here is a list of them.
@comment sys/types.h @comment sys/types.h
@comment POSIX.1 @comment POSIX.1
@deftp {Data Type} mode_t @deftp {Data Type} mode_t
This is an integer data type used to represent file modes. In the This is an integer data type used to represent file modes. In
GNU system, this is equivalent to @code{unsigned int}. @theglibc{}, this is an unsigned type no narrower than @code{unsigned
int}.
@end deftp @end deftp
@cindex inode number @cindex inode number
@comment sys/types.h @comment sys/types.h
@comment POSIX.1 @comment POSIX.1
@deftp {Data Type} ino_t @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 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 If the source is compiled with @code{_FILE_OFFSET_BITS == 64} this type
is transparently replaced by @code{ino64_t}. is transparently replaced by @code{ino64_t}.
@ -1789,9 +1790,9 @@ is transparently replaced by @code{ino64_t}.
@comment sys/types.h @comment sys/types.h
@comment Unix98 @comment Unix98
@deftp {Data Type} ino64_t @deftp {Data Type} ino64_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
for the use in LFS. In the GNU system, this type is equivalent to for the use in LFS. In @theglibc{}, this type is no narrower than
@code{unsigned long long int}. @code{unsigned int}.
When compiling with @code{_FILE_OFFSET_BITS == 64} this type is When compiling with @code{_FILE_OFFSET_BITS == 64} this type is
available under the name @code{ino_t}. available under the name @code{ino_t}.
@ -1801,21 +1802,20 @@ available under the name @code{ino_t}.
@comment POSIX.1 @comment POSIX.1
@deftp {Data Type} dev_t @deftp {Data Type} dev_t
This is an arithmetic data type used to represent file device numbers. 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 @end deftp
@comment sys/types.h @comment sys/types.h
@comment POSIX.1 @comment POSIX.1
@deftp {Data Type} nlink_t @deftp {Data Type} nlink_t
This is an arithmetic data type used to represent file link counts. This is an integer type used to represent file link counts.
In the GNU system, this is equivalent to @code{unsigned short int}.
@end deftp @end deftp
@comment sys/types.h @comment sys/types.h
@comment Unix98 @comment Unix98
@deftp {Data Type} blkcnt_t @deftp {Data Type} blkcnt_t
This is an arithmetic data type used to represent block counts. This is a signed integer type used to represent block counts.
In the GNU system, this is equivalent to @code{unsigned long int}. In @theglibc{}, this type is no narrower than @code{int}.
If the source is compiled with @code{_FILE_OFFSET_BITS == 64} this type If the source is compiled with @code{_FILE_OFFSET_BITS == 64} this type
is transparently replaced by @code{blkcnt64_t}. is transparently replaced by @code{blkcnt64_t}.
@ -1824,9 +1824,8 @@ is transparently replaced by @code{blkcnt64_t}.
@comment sys/types.h @comment sys/types.h
@comment Unix98 @comment Unix98
@deftp {Data Type} blkcnt64_t @deftp {Data Type} blkcnt64_t
This is an arithmetic data type used to represent block counts for the This is a signed integer type used to represent block counts for the
use in LFS. In the GNU system, this is equivalent to @code{unsigned use in LFS. In @theglibc{}, this type is no narrower than @code{int}.
long long int}.
When compiling with @code{_FILE_OFFSET_BITS == 64} this type is When compiling with @code{_FILE_OFFSET_BITS == 64} this type is
available under the name @code{blkcnt_t}. available under the name @code{blkcnt_t}.

View File

@ -776,8 +776,8 @@ character.
@comment sys/types.h @comment sys/types.h
@comment POSIX.1 @comment POSIX.1
@deftp {Data Type} off_t @deftp {Data Type} off_t
This is an arithmetic data type used to represent file sizes. This is a signed integer type used to represent file sizes. In
In the GNU system, this is equivalent to @code{fpos_t} or @code{long int}. @theglibc{}, this type is no narrower than @code{int}.
If the source is compiled with @code{_FILE_OFFSET_BITS == 64} this type If the source is compiled with @code{_FILE_OFFSET_BITS == 64} this type
is transparently replaced by @code{off64_t}. is transparently replaced by @code{off64_t}.