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

[Andreas Jaeger <aj at suse dot de>]

stefan.asserhall@telia.com writes:

>>Submitter-Id:	net
>>Originator:	Stefan Asserhäll
>>Organization:
>  
>>Confidential:	no
>>Synopsis:	Manual erroneously says that fpos_t is off_t in the GNU system
>>Severity:	non-critical
>>Priority:	low
>>Category:	libc
>>Class:		doc-bug
>>Release:	libc-2.1.92
[...]
>>Description:
> 	The manual erroneously says that fpos_t is off_t in the GNU system
> 	under "Portable File-Position Functions". This is no longer true,
> 	see _G_Config.h where _G_fpos_t is defined as a struct.
> 	
> 	Some software seems to rely on fpos_t being equal to off_t, for
> 	example PGP 6.5.8, which does not build on RedHat 7.0.

Thanks for the report.

I propose the following patch to fix this.  What do others think?

Andreas

2001-06-05  Andreas Jaeger  <aj@suse.de>

	* manual/stdio.texi (Portable Positioning): Fix description of
	fpos_t and fpos64_t.

============================================================
Index: manual/stdio.texi
--- manual/stdio.texi	2001/05/27 17:15:59	1.125
+++ manual/stdio.texi	2001/06/05 13:26:15
@@ -4353,12 +4353,12 @@
 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
-representation.
+In the GNU system, @code{fpos_t} is a struct that contains internal data
+to reprsent 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,9 +4369,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
-representation.
+In the GNU system, @code{fpos64_t} is a struct that contains internal
+data to represent file offset and conversion state information.  In
+other systems, it might have a different internal representation.
 @end deftp
 
 @comment stdio.h

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