From: "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com>
To: Alejandro Colomar <colomar.6.4.3@gmail.com>
Cc: mtk.manpages@gmail.com, linux-man@vger.kernel.org,
libc-alpha@sourceware.org, gcc@gcc.gnu.org
Subject: Re: [PATCH 02/16] system_data_types.7: srcfix
Date: Thu, 1 Oct 2020 13:33:00 +0200 [thread overview]
Message-ID: <56f05482-abd4-785a-aa63-44e4a271a1b6@gmail.com> (raw)
In-Reply-To: <20201001101559.77163-3-colomar.6.4.3@gmail.com>
Hi Alex,
On 10/1/20 12:15 PM, Alejandro Colomar wrote:
> Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
I don't mind applying this patch (and I have done so),
but I think patches like this need a brief commit message
to explain why you are making the change.
Thanks,
Michael
> ---
> man7/system_data_types.7 | 105 ++++++++++++++++++++++++++-------------
> 1 file changed, 70 insertions(+), 35 deletions(-)
>
> diff --git a/man7/system_data_types.7 b/man7/system_data_types.7
> index 9cf67ee6f..a653a7b11 100644
> --- a/man7/system_data_types.7
> +++ b/man7/system_data_types.7
> @@ -71,7 +71,8 @@ struct aiocb {
> For further information about this structure, see
> .BR aio (7).
> .PP
> -Conforming to: POSIX.1-2001 and later.
> +Conforming to:
> +POSIX.1-2001 and later.
> .PP
> See also:
> .BR aio_cancel (3),
> @@ -102,7 +103,8 @@ It is the type of the value returned by the
> .BR div (3)
> function.
> .PP
> -Conforming to: C99 and later; POSIX.1-2001 and later.
> +Conforming to:
> +C99 and later; POSIX.1-2001 and later.
> .PP
> See also:
> .BR div (3)
> @@ -143,7 +145,8 @@ the type of
> .I double_t
> is implementation-defined.
> .PP
> -Conforming to: C99 and later; POSIX.1-2001 and later.
> +Conforming to:
> +C99 and later; POSIX.1-2001 and later.
> .PP
> See also the
> .I float_t
> @@ -161,7 +164,8 @@ This type represents the entire floating-point environment,
> including control modes and status flags; for further details, see
> .BR fenv (3).
> .PP
> -Conforming to: C99 and later; POSIX.1-2001 and later.
> +Conforming to:
> +C99 and later; POSIX.1-2001 and later.
> .PP
> See also:
> .BR fenv (3)
> @@ -178,7 +182,8 @@ This type represents the floating-point status flags collectively;
> for further details see
> .BR fenv (3).
> .PP
> -Conforming to: C99 and later; POSIX.1-2001 and later.
> +Conforming to:
> +C99 and later; POSIX.1-2001 and later.
> .PP
> See also:
> .BR fenv (3)
> @@ -195,7 +200,8 @@ Alternatively,
> .PP
> An object type used for streams.
> .PP
> -Conforming to: C99 and later; POSIX.1-2001 and later.
> +Conforming to:
> +C99 and later; POSIX.1-2001 and later.
> .PP
> See also:
> .BR fclose (3),
> @@ -243,7 +249,8 @@ the type of
> .I float_t
> is implementation-defined.
> .PP
> -Conforming to: C99 and later; POSIX.1-2001 and later.
> +Conforming to:
> +C99 and later; POSIX.1-2001 and later.
> .PP
> See also the
> .I double_t
> @@ -270,7 +277,8 @@ A type used to hold group IDs.
> According to POSIX,
> this shall be an integer type.
> .PP
> -Conforming to: POSIX.1-2001 and later.
> +Conforming to:
> +POSIX.1-2001 and later.
> .PP
> See also:
> .BR chown (2),
> @@ -299,7 +307,8 @@ this shall be an integer type that can be used to contain a
> or
> .IR gid_t .
> .PP
> -Conforming to: POSIX.1-2001 and later.
> +Conforming to:
> +POSIX.1-2001 and later.
> .PP
> See also:
> .BR getpriority (2),
> @@ -324,7 +333,8 @@ It is the type of the value returned by the
> .BR imaxdiv (3)
> function.
> .PP
> -Conforming to: C99 and later; POSIX.1-2001 and later.
> +Conforming to:
> +C99 and later; POSIX.1-2001 and later.
> .PP
> See also:
> .BR imaxdiv (3)
> @@ -379,7 +389,8 @@ is defined and
> .I long long
> is less than 128 bits wide.
> .PP
> -Conforming to: C99 and later; POSIX.1-2001 and later.
> +Conforming to:
> +C99 and later; POSIX.1-2001 and later.
> .PP
> See also the
> .I uintmax_t
> @@ -453,7 +464,8 @@ for scanning
> .I int8_t
> values.
> .PP
> -Conforming to: C99 and later; POSIX.1-2001 and later.
> +Conforming to:
> +C99 and later; POSIX.1-2001 and later.
> .PP
> See also the
> .IR __int128 ,
> @@ -505,7 +517,8 @@ Contains members related to the formatting of numeric values.
> In the "C" locale, its members have the values
> shown in the comments above.
> .PP
> -Conforming to: C11 and later; POSIX.1-2001 and later.
> +Conforming to:
> +C11 and later; POSIX.1-2001 and later.
> .PP
> See also:
> .BR setlocale (3),
> @@ -532,7 +545,8 @@ It is the type of the value returned by the
> .BR ldiv (3)
> function.
> .PP
> -Conforming to: C99 and later; POSIX.1-2001 and later.
> +Conforming to:
> +C99 and later; POSIX.1-2001 and later.
> .PP
> See also:
> .BR ldiv (3)
> @@ -556,7 +570,8 @@ It is the type of the value returned by the
> .BR lldiv (3)
> function.
> .PP
> -Conforming to: C99 and later; POSIX.1-2001 and later.
> +Conforming to:
> +C99 and later; POSIX.1-2001 and later.
> .PP
> See also:
> .BR lldiv (3)
> @@ -591,7 +606,8 @@ where the width of
> is no greater than the width of the type
> .IR long .
> .PP
> -Conforming to: POSIX.1-2001 and later.
> +Conforming to:
> +POSIX.1-2001 and later.
> .PP
> See also:
> .BR fork (2),
> @@ -638,7 +654,8 @@ for printing
> .I ptrdiff_t
> values.
> .PP
> -Conforming to: C99 and later; POSIX.1-2001 and later.
> +Conforming to:
> +C99 and later; POSIX.1-2001 and later.
> .PP
> See also the
> .I size_t
> @@ -666,7 +683,8 @@ typedef struct {
> .PP
> This is a structure type used in regular expression matching.
> .PP
> -Conforming to: POSIX.1-2001 and later.
> +Conforming to:
> +POSIX.1-2001 and later.
> .PP
> See also:
> .BR regexec (3)
> @@ -686,9 +704,11 @@ type or a
> .I ssize_t
> type.
> .PP
> -Conforming to: POSIX.1-2001 and later.
> +Conforming to:
> +POSIX.1-2001 and later.
> .PP
> -Notes: Prior to POSIX.1-2008, the type was capable of storing
> +Notes:
> +Prior to POSIX.1-2008, the type was capable of storing
> the largest value that can be stored in either an
> .I off_t
> type or a
> @@ -731,7 +751,8 @@ struct sigevent {
> For further details about this type, see
> .BR sigevent (7).
> .PP
> -Conforming to: POSIX.1-2001 and later.
> +Conforming to:
> +POSIX.1-2001 and later.
> .PP
> Notes:
> .I <aio.h>
> @@ -778,7 +799,8 @@ For further details on this structure
> (including additional, Linux-specific fields), see
> .BR sigaction (2).
> .PP
> -Conforming to: POSIX.1-2001 and later.
> +Conforming to:
> +POSIX.1-2001 and later.
> .PP
> See also:
> .BR pidfd_send_signal (2),
> @@ -802,7 +824,8 @@ or
> This is a type that represents a set of signals.
> According to POSIX, this shall be an integer or structure type.
> .PP
> -Conforming to: POSIX.1-2001 and later.
> +Conforming to:
> +POSIX.1-2001 and later.
> .PP
> See also:
> .BR epoll_pwait (2),
> @@ -833,7 +856,8 @@ union sigval {
> .PP
> Data passed with a signal.
> .PP
> -Conforming to: POSIX.1-2001 and later.
> +Conforming to:
> +POSIX.1-2001 and later.
> .PP
> See also:
> .BR pthread_sigqueue (3),
> @@ -915,7 +939,8 @@ for printing
> .I size_t
> values.
> .PP
> -Conforming to: C99 and later; POSIX.1-2001 and later.
> +Conforming to:
> +C99 and later; POSIX.1-2001 and later.
> .PP
> Notes:
> .IR <aio.h> ,
> @@ -1002,7 +1027,8 @@ by converting the value to
> and using its length modifier
> .RB ( j ).
> .PP
> -Conforming to: POSIX.1-2001 and later.
> +Conforming to:
> +POSIX.1-2001 and later.
> .PP
> See also:
> .BR read (2),
> @@ -1039,7 +1065,8 @@ where the width of
> is no greater than the width of the type
> .IR long .
> .PP
> -Conforming to: POSIX.1-2001 and later.
> +Conforming to:
> +POSIX.1-2001 and later.
> .PP
> See also the
> .I timeval
> @@ -1068,7 +1095,8 @@ or
> Used for time in seconds.
> According to POSIX, it shall be an integer type.
> .PP
> -Conforming to: C99 and later; POSIX.1-2001 and later.
> +Conforming to:
> +C99 and later; POSIX.1-2001 and later.
> .PP
> Notes:
> .I <sched.h>
> @@ -1097,7 +1125,8 @@ Used for timer ID returned by
> According to POSIX,
> there are no defined comparison or assignment operators for this type.
> .PP
> -Conforming to: POSIX.1-2001 and later.
> +Conforming to:
> +POSIX.1-2001 and later.
> .PP
> See also:
> .BR timer_create (2),
> @@ -1130,7 +1159,8 @@ struct timespec {
> .PP
> Describes times in seconds and nanoseconds.
> .PP
> -Conforming to: C11 and later; POSIX.1-2001 and later.
> +Conforming to:
> +C11 and later; POSIX.1-2001 and later.
> .PP
> See also:
> .BR clock_gettime (2),
> @@ -1161,7 +1191,8 @@ struct timeval {
> .PP
> Describes times in seconds and microseconds.
> .PP
> -Conforming to: POSIX.1-2001 and later.
> +Conforming to:
> +POSIX.1-2001 and later.
> .PP
> See also:
> .BR gettimeofday (2),
> @@ -1191,7 +1222,8 @@ A type used to hold user IDs.
> According to POSIX,
> this shall be an integer type.
> .PP
> -Conforming to: POSIX.1-2001 and later.
> +Conforming to:
> +POSIX.1-2001 and later.
> .PP
> See also:
> .BR chown (2),
> @@ -1250,7 +1282,8 @@ is defined and
> .I unsigned long long
> is less than 128 bits wide.
> .PP
> -Conforming to: C99 and later; POSIX.1-2001 and later.
> +Conforming to:
> +C99 and later; POSIX.1-2001 and later.
> .PP
> See also the
> .I intmax_t
> @@ -1327,7 +1360,8 @@ for scanning
> .I uint16_t
> values.
> .PP
> -Conforming to: C99 and later; POSIX.1-2001 and later.
> +Conforming to:
> +C99 and later; POSIX.1-2001 and later.
> .PP
> See also the
> .IR __int128 ,
> @@ -1361,7 +1395,8 @@ and
> .BR va_end (3)
> to traverse the list of arguments.
> .PP
> -Conforming to: C99 and later; POSIX.1-2001 and later.
> +Conforming to:
> +C99 and later; POSIX.1-2001 and later.
> .PP
> See also:
> .BR va_start (3),
>
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
next prev parent reply other threads:[~2020-10-01 11:33 UTC|newest]
Thread overview: 34+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-10-01 10:15 [PATCH 00/16] Fixes; Document remaining stdint.h types Alejandro Colomar
2020-10-01 10:15 ` [PATCH 01/16] malloc_get_state.3: ffix Alejandro Colomar
2020-10-01 11:32 ` Michael Kerrisk (man-pages)
2020-10-01 10:15 ` [PATCH 02/16] system_data_types.7: srcfix Alejandro Colomar
2020-10-01 11:33 ` Michael Kerrisk (man-pages) [this message]
2020-10-01 10:15 ` [PATCH 03/16] " Alejandro Colomar
2020-10-01 11:33 ` Michael Kerrisk (man-pages)
2020-10-01 10:15 ` [PATCH 04/16] " Alejandro Colomar
2020-10-01 11:34 ` Michael Kerrisk (man-pages)
2020-10-01 10:15 ` [PATCH 05/16] system_data_types.7: Add int_fastN_t family of types Alejandro Colomar
2020-10-01 11:07 ` Jonathan Wakely
2020-10-01 11:15 ` Alejandro Colomar
2020-10-01 11:27 ` Jonathan Wakely
2020-10-01 14:16 ` Alejandro Colomar
2020-10-01 15:13 ` Alejandro Colomar
2020-10-01 10:15 ` [PATCH 06/16] int_fast8_t.3, int_fast16_t.3, int_fast32_t.3, int_fast64_t.3, int_fastN_t.3: New links to system_data_types(7) Alejandro Colomar
2020-10-01 10:15 ` [PATCH 07/16] system_data_types.7: Add uint_fastN_t family of types Alejandro Colomar
2020-10-01 10:15 ` [PATCH 08/16] uint_fast8_t.3, uint_fast16_t.3, uint_fast32_t.3, uint_fast64_t.3, uint_fastN_t.3: New links to system_data_types(7) Alejandro Colomar
2020-10-01 10:15 ` [PATCH 09/16] system_data_types.7: Add int_leastN_t family of types Alejandro Colomar
2020-10-01 10:15 ` [PATCH 10/16] int_least8_t.3, int_least16_t.3, int_least32_t.3, int_least64_t.3, int_leastN_t.3: New links to system_data_types(7) Alejandro Colomar
2020-10-01 10:15 ` [PATCH 11/16] system_data_types.7: Add uint_leastN_t family of types Alejandro Colomar
2020-10-01 10:15 ` [PATCH 12/16] uint_least8_t.3, uint_least16_t.3, uint_least32_t.3, uint_least64_t.3, uint_leastN_t.3: New links to system_data_types(7) Alejandro Colomar
2020-10-01 10:15 ` [PATCH 13/16] system_data_types.7: Add 'intptr_t' Alejandro Colomar
2020-10-01 11:35 ` Michael Kerrisk (man-pages)
2020-10-01 10:15 ` [PATCH 14/16] intptr_t.3: New link to system_data_types(7) Alejandro Colomar
2020-10-01 11:35 ` Michael Kerrisk (man-pages)
2020-10-01 10:15 ` [PATCH 15/16] system_data_types.7: Add 'uintptr_t' Alejandro Colomar
2020-10-01 11:35 ` Michael Kerrisk (man-pages)
2020-10-01 10:16 ` [PATCH 16/16] uintptr_t.3: New link to system_data_types(7) Alejandro Colomar
2020-10-01 11:35 ` Michael Kerrisk (man-pages)
2020-10-01 11:32 ` [PATCH 00/16] Fixes; Document remaining stdint.h types Michael Kerrisk (man-pages)
2020-10-01 11:41 ` Alejandro Colomar
2020-10-01 11:50 ` Michael Kerrisk (man-pages)
2020-10-01 11:51 ` Alejandro Colomar
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=56f05482-abd4-785a-aa63-44e4a271a1b6@gmail.com \
--to=mtk.manpages@gmail.com \
--cc=colomar.6.4.3@gmail.com \
--cc=gcc@gcc.gnu.org \
--cc=libc-alpha@sourceware.org \
--cc=linux-man@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).