----- Forwarded message from James Troup <[EMAIL PROTECTED]> -----

Subject: Bug#155100: glibc-doc: misleading definition of struct timeval from 
<sys/time.h>
Reply-To: James Troup <[EMAIL PROTECTED]>, [EMAIL PROTECTED]
Resent-From: James Troup <[EMAIL PROTECTED]>
Original-Sender: James Troup <[EMAIL PROTECTED]>
Resent-To: [EMAIL PROTECTED]
Resent-CC: Ben Collins <[EMAIL PROTECTED]>, [EMAIL PROTECTED]
Resent-Date: Thu, 01 Aug 2002 12:33:06 GMT
Resent-Message-ID: <[EMAIL PROTECTED]>
X-Debian-PR-Message: report 155100
X-Debian-PR-Package: glibc-doc
X-Debian-PR-Keywords: 
To: [EMAIL PROTECTED]
Mail-Copies-To: never
From: James Troup <[EMAIL PROTECTED]>
Resent-Sender: Debian BTS <[EMAIL PROTECTED]>
X-Spam-Status: No, hits=-4.5 required=5.0 tests=SENT_BY_BTS,FORGED_RCVD_FOUND 
version=2.20
X-Spam-Level: 

Package: glibc-doc
Version: 2.2.5-6

glibc's docs say:

|  - Data Type: struct timeval
|      The `struct timeval' structure represents an elapsed time.  It is
|      declared in `sys/time.h' and has the following members:
| 
|     `long int tv_sec'
|           This represents the number of whole seconds of elapsed time.
| 
|     `long int tv_usec'
|           This is the rest of the elapsed time (a fraction of a second),
|           represented as the number of microseconds.  It is always less
|           than one million.

but... SuS says:

| The <sys/time.h> header shall define the timeval structure that
| includes at least the following members:
| 
| time_t         tv_sec     Seconds. 
| suseconds_t    tv_usec    Microseconds. 

and:

| The type suseconds_t shall be a signed integer type capable of storing
| values at least in the range [-1, 1000000]. [Option End]

and indeed sparc uses 'int' not 'long' for tv_usec.  Assuming Sparc's
include files aren't buggy, the documention should probably be fixed?
I'm not just reporting this to be pedantic, at least two -Werror using
packages have failed to build from source on sparc because they try to
format tv_usec with %ld.

-- 
James


----- End forwarded message -----

-- 
Debian     - http://www.debian.org/
Linux 1394 - http://linux1394.sourceforge.net/
Subversion - http://subversion.tigris.org/
Deqo       - http://www.deqo.com/


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]

Reply via email to