Document properties of standard typedefs, not exact types.

diff --git a/ChangeLog b/ChangeLog
index a10bb8bc916fb631c396fe13ff97a5bb7b07e1ab..cb3e30b5343a2a1310f25370a0effd9927217b50 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,15 @@
 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]
        * sysdeps/ieee754/dbl-64/e_exp.c: Include <fenv.h>.
        (__ieee754_exp): Save and restore rounding mode and use

diff --git a/manual/filesys.texi b/manual/filesys.texi
index bf3abb4447404782a06d21cfbc908d90d942c0e2..872e3710a0d94bd956bdba7a3d85a6f3c2cda99e 100644 (file)
--- 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 9fa0908f2de56a79cee6ee931556cf333b7ad45f..f3ed5427247c1a3a43421a62d5532040cd0be81f 100644 (file)
--- 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}.