Re: The manual erroneously says that fpos_t is off_t in the GNU system

[Andreas Jaeger <aj at suse dot de>]

Roland McGrath <roland@frob.com> writes:

> That seems reasonable.  I would use wording like "an opaque data structure"
> rather than "a struct", both to emphasize that it is opaque to the user,
> and because "struct" is not a proper English word.

Like this?

Andreas

============================================================
Index: manual/stdio.texi
--- manual/stdio.texi	2001/05/27 17:15:59	1.125
+++ manual/stdio.texi	2001/06/05 20:03:29
@@ -4353,12 +4353,13 @@
 file position of a stream, for use by the functions @code{fgetpos} and
 @code{fsetpos}.
 
-In the GNU system, @code{fpos_t} is equivalent to @code{off_t} or
-@code{long int}.  In other systems, it might have a different internal
+In the GNU system, @code{fpos_t} is an opaque data structure that
+contains internal data to represent file offset and conversion state
+information.  In other systems, it might have a different internal
 representation.
 
 When compiling with @code{_FILE_OFFSET_BITS == 64} on a 32 bit machine
-this type is in fact equivalent to @code{off64_t} since the LFS
+this type is in fact equivalent to @code{fpos64_t} since the LFS
 interface transparently replaced the old interface.
 @end deftp
 
@@ -4369,8 +4370,9 @@
 file position of a stream, for use by the functions @code{fgetpos64} and
 @code{fsetpos64}.
 
-In the GNU system, @code{fpos64_t} is equivalent to @code{off64_t} or
-@code{long long int}.  In other systems, it might have a different internal
+In the GNU system, @code{fpos64_t} is an opaque data structure that
+contains internal data to represent file offset and conversion state
+information.  In other systems, it might have a different internal
 representation.
 @end deftp
 

-- 
 Andreas Jaeger
  SuSE Labs aj@suse.de
   private aj@arthur.inka.de
    http://www.suse.de/~aj