diff options
author | Alejandro Colomar <alx.manpages@gmail.com> | 2022-07-30 00:19:27 +0200 |
---|---|---|
committer | Alejandro Colomar <alx.manpages@gmail.com> | 2022-07-30 00:19:30 +0200 |
commit | 728c2f35a3729d7d46cc0675110b1134bc1b87b9 (patch) | |
tree | 9b0f36e1c4ce6d88313fa884c6404c7beaa69361 | |
parent | 801a509d5f9f64969b5d7a720a5b8cbb308e55ed (diff) |
sockaddr.3type, timer_t.3type, void.3type: wfix
Replace "shall" wordings by simpler text, to not resemble a
standards document.
When saying something like "According to POSIX/ISO C, ...", if
the mentioned standard is the same one described in STANDARDS,
remove that text (it is redundant). However, if ISO C is the
main standard that describes a type, but POSIX applies further
restrictions, keep that text.
Remove pedantic notes that may only be interesting to compiler
writers.
Reported-by: Ingo Schwarze <schwarze@openbsd.org>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
-rw-r--r-- | man3type/sockaddr.3type | 12 | ||||
-rw-r--r-- | man3type/timer_t.3type | 2 | ||||
-rw-r--r-- | man3type/void.3type | 3 |
3 files changed, 6 insertions, 11 deletions
diff --git a/man3type/sockaddr.3type b/man3type/sockaddr.3type index 42b8ac14f..495e0d5f7 100644 --- a/man3type/sockaddr.3type +++ b/man3type/sockaddr.3type @@ -72,8 +72,7 @@ Standard C library Describes a socket address. .TP .I sockaddr_storage -According to POSIX, -a structure large enough to accomodate all supported +A structure at least as large as any other .IR sockaddr_ * address structures. It's aligned so that a pointer to it can be cast @@ -83,21 +82,20 @@ structures and used to access its fields. .TP .I socklen_t Describes the length of a socket address. -According to POSIX, -this is an integer type of at least 32 bits. +This is an integer type of at least 32 bits. .SS Internet domain sockets .TP .I sockaddr_in Describes an IPv4 Internet domain socket address. -According to POSIX, the +The .I sin_port and .I sin_addr -members shall be in network byte order. +members are stored in network byte order. .TP .I sockaddr_in6 Describes an IPv6 Internet domain socket address. -According to POSIX, the +The .I sin6_addr.s6_addr array is used to contain a 128-bit IPv6 address, stored in network byte order. diff --git a/man3type/timer_t.3type b/man3type/timer_t.3type index 216a6f4e7..a0aefbdc8 100644 --- a/man3type/timer_t.3type +++ b/man3type/timer_t.3type @@ -19,8 +19,6 @@ Standard C library .SH DESCRIPTION Used for timer ID returned by .BR timer_create (2). -According to POSIX, -there are no defined comparison or assignment operators for this type. .SH STANDARDS POSIX.1-2001 and later. .SH NOTES diff --git a/man3type/void.3type b/man3type/void.3type index 780cc26ac..106fd9933 100644 --- a/man3type/void.3type +++ b/man3type/void.3type @@ -12,8 +12,7 @@ void \- abstract type .B void * .fi .SH DESCRIPTION -According to ISO C, -a pointer to any object type may be converted to a pointer to +A pointer to any object type may be converted to a pointer to .I void and back. POSIX further requires that any pointer, |