* [PATCH 0/4] Document ptrdiff_t (and a few minor patches)
@ 2020-09-18 12:04 Alejandro Colomar
2020-09-18 12:04 ` [PATCH 1/4] system_data_types.7: srcfix: Remove TODO comment Alejandro Colomar
` (3 more replies)
0 siblings, 4 replies; 9+ messages in thread
From: Alejandro Colomar @ 2020-09-18 12:04 UTC (permalink / raw)
To: mtk.manpages; +Cc: linux-man, libc-alpha, Alejandro Colomar
Hi Michael,
Documentation for ptrdiff_t + a few minor patches.
(apply after size_t patches)
Cheers,
Alex.
Alejandro Colomar (4):
system_data_types.7: srcfix: Remove TODO comment
system_data_types.7: wfix: sort referenced types
system_data_types.7: Document ptrdiff_t
ptrdiff_t.3: New link to new documented type in system_data_types(7)
man3/ptrdiff_t.3 | 1 +
man7/system_data_types.7 | 32 ++++++++++++++++++++++++++------
2 files changed, 27 insertions(+), 6 deletions(-)
create mode 100644 man3/ptrdiff_t.3
--
2.28.0
^ permalink raw reply [flat|nested] 9+ messages in thread
* [PATCH 1/4] system_data_types.7: srcfix: Remove TODO comment
2020-09-18 12:04 [PATCH 0/4] Document ptrdiff_t (and a few minor patches) Alejandro Colomar
@ 2020-09-18 12:04 ` Alejandro Colomar
2020-09-18 20:16 ` Michael Kerrisk (man-pages)
2020-09-18 12:04 ` [PATCH 2/4] system_data_types.7: wfix: sort referenced types Alejandro Colomar
` (2 subsequent siblings)
3 siblings, 1 reply; 9+ messages in thread
From: Alejandro Colomar @ 2020-09-18 12:04 UTC (permalink / raw)
To: mtk.manpages; +Cc: linux-man, libc-alpha, Alejandro Colomar
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
---
man7/system_data_types.7 | 3 ---
1 file changed, 3 deletions(-)
diff --git a/man7/system_data_types.7 b/man7/system_data_types.7
index 041e7e243..72afe9e81 100644
--- a/man7/system_data_types.7
+++ b/man7/system_data_types.7
@@ -27,9 +27,6 @@
.SH NAME
system_data_types \- overview of system data types
.SH DESCRIPTION
-.\" TODO:
-.\" * Add types
-.\" * Curate "See also"
.\" Layout:
.\" A list of type names (the struct/union keyword will be omitted).
.\" Each entry will have the following parts:
--
2.28.0
^ permalink raw reply [flat|nested] 9+ messages in thread
* [PATCH 2/4] system_data_types.7: wfix: sort referenced types
2020-09-18 12:04 [PATCH 0/4] Document ptrdiff_t (and a few minor patches) Alejandro Colomar
2020-09-18 12:04 ` [PATCH 1/4] system_data_types.7: srcfix: Remove TODO comment Alejandro Colomar
@ 2020-09-18 12:04 ` Alejandro Colomar
2020-09-18 20:16 ` Michael Kerrisk (man-pages)
2020-09-18 12:04 ` [PATCH 3/4] system_data_types.7: Document ptrdiff_t Alejandro Colomar
2020-09-18 12:04 ` [PATCH 4/4] ptrdiff_t.3: New link to new documented type in system_data_types(7) Alejandro Colomar
3 siblings, 1 reply; 9+ messages in thread
From: Alejandro Colomar @ 2020-09-18 12:04 UTC (permalink / raw)
To: mtk.manpages; +Cc: linux-man, libc-alpha, Alejandro Colomar
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
---
man7/system_data_types.7 | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/man7/system_data_types.7 b/man7/system_data_types.7
index 72afe9e81..5ef470386 100644
--- a/man7/system_data_types.7
+++ b/man7/system_data_types.7
@@ -179,9 +179,9 @@ See also:
.BR offsetof (3)
.IP
See also the
-.I ssize_t
-and
.I ptrdiff_t
+and
+.I ssize_t
types in this page.
.TP
.I ssize_t
--
2.28.0
^ permalink raw reply [flat|nested] 9+ messages in thread
* [PATCH 3/4] system_data_types.7: Document ptrdiff_t
2020-09-18 12:04 [PATCH 0/4] Document ptrdiff_t (and a few minor patches) Alejandro Colomar
2020-09-18 12:04 ` [PATCH 1/4] system_data_types.7: srcfix: Remove TODO comment Alejandro Colomar
2020-09-18 12:04 ` [PATCH 2/4] system_data_types.7: wfix: sort referenced types Alejandro Colomar
@ 2020-09-18 12:04 ` Alejandro Colomar
2020-09-18 20:19 ` Michael Kerrisk (man-pages)
2020-09-18 12:04 ` [PATCH 4/4] ptrdiff_t.3: New link to new documented type in system_data_types(7) Alejandro Colomar
3 siblings, 1 reply; 9+ messages in thread
From: Alejandro Colomar @ 2020-09-18 12:04 UTC (permalink / raw)
To: mtk.manpages; +Cc: linux-man, libc-alpha, Alejandro Colomar
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
---
man7/system_data_types.7 | 25 ++++++++++++++++++++++++-
1 file changed, 24 insertions(+), 1 deletion(-)
diff --git a/man7/system_data_types.7 b/man7/system_data_types.7
index 5ef470386..8969ee966 100644
--- a/man7/system_data_types.7
+++ b/man7/system_data_types.7
@@ -62,6 +62,27 @@ system_data_types \- overview of system data types
.\"
.\" * See also
.TP
+.I ptrdiff_t
+.IP
+Include:
+.I <stddef.h>.
+.IP
+Used for a count of elements, and array indices.
+It is the result of subtracting two pointers.
+According to the C language standard, it shall be a signed integer type
+capable of storing values in the range
+.BR "" [ PTRDIFF_MIN ,
+.BR PTRDIFF_MAX ].
+.IP
+Conforming to: C99 and later; POSIX.1-2001 and later.
+.IP
+See also the
+.\".I regoff_t , FIXME: uncomment when regoff_t is documented.
+.I size_t
+and
+.I ssize_t
+types in this page.
+.TP
.I sigval
.IP
Include:
@@ -221,8 +242,10 @@ See also:
.BR write (2)
.IP
See also the
+.I ptrdiff_t
+and
.I size_t
-type in this page.
+types in this page.
.TP
.I suseconds_t
.IP
--
2.28.0
^ permalink raw reply [flat|nested] 9+ messages in thread
* [PATCH 4/4] ptrdiff_t.3: New link to new documented type in system_data_types(7)
2020-09-18 12:04 [PATCH 0/4] Document ptrdiff_t (and a few minor patches) Alejandro Colomar
` (2 preceding siblings ...)
2020-09-18 12:04 ` [PATCH 3/4] system_data_types.7: Document ptrdiff_t Alejandro Colomar
@ 2020-09-18 12:04 ` Alejandro Colomar
2020-09-18 20:20 ` Michael Kerrisk (man-pages)
3 siblings, 1 reply; 9+ messages in thread
From: Alejandro Colomar @ 2020-09-18 12:04 UTC (permalink / raw)
To: mtk.manpages; +Cc: linux-man, libc-alpha, Alejandro Colomar
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
---
man3/ptrdiff_t.3 | 1 +
1 file changed, 1 insertion(+)
create mode 100644 man3/ptrdiff_t.3
diff --git a/man3/ptrdiff_t.3 b/man3/ptrdiff_t.3
new file mode 100644
index 000000000..db50c0f09
--- /dev/null
+++ b/man3/ptrdiff_t.3
@@ -0,0 +1 @@
+.so man7/system_data_types.7
--
2.28.0
^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: [PATCH 1/4] system_data_types.7: srcfix: Remove TODO comment
2020-09-18 12:04 ` [PATCH 1/4] system_data_types.7: srcfix: Remove TODO comment Alejandro Colomar
@ 2020-09-18 20:16 ` Michael Kerrisk (man-pages)
0 siblings, 0 replies; 9+ messages in thread
From: Michael Kerrisk (man-pages) @ 2020-09-18 20:16 UTC (permalink / raw)
To: Alejandro Colomar; +Cc: mtk.manpages, linux-man, libc-alpha
On 9/18/20 2:04 PM, Alejandro Colomar wrote:
> Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Patch applied.
Thanks,
Michael
> ---
> man7/system_data_types.7 | 3 ---
> 1 file changed, 3 deletions(-)
>
> diff --git a/man7/system_data_types.7 b/man7/system_data_types.7
> index 041e7e243..72afe9e81 100644
> --- a/man7/system_data_types.7
> +++ b/man7/system_data_types.7
> @@ -27,9 +27,6 @@
> .SH NAME
> system_data_types \- overview of system data types
> .SH DESCRIPTION
> -.\" TODO:
> -.\" * Add types
> -.\" * Curate "See also"
> .\" Layout:
> .\" A list of type names (the struct/union keyword will be omitted).
> .\" Each entry will have the following parts:
>
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: [PATCH 2/4] system_data_types.7: wfix: sort referenced types
2020-09-18 12:04 ` [PATCH 2/4] system_data_types.7: wfix: sort referenced types Alejandro Colomar
@ 2020-09-18 20:16 ` Michael Kerrisk (man-pages)
0 siblings, 0 replies; 9+ messages in thread
From: Michael Kerrisk (man-pages) @ 2020-09-18 20:16 UTC (permalink / raw)
To: Alejandro Colomar; +Cc: mtk.manpages, linux-man, libc-alpha
On 9/18/20 2:04 PM, Alejandro Colomar wrote:
> Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Patch applied.
Thanks,
Michael
> ---
> man7/system_data_types.7 | 4 ++--
> 1 file changed, 2 insertions(+), 2 deletions(-)
>
> diff --git a/man7/system_data_types.7 b/man7/system_data_types.7
> index 72afe9e81..5ef470386 100644
> --- a/man7/system_data_types.7
> +++ b/man7/system_data_types.7
> @@ -179,9 +179,9 @@ See also:
> .BR offsetof (3)
> .IP
> See also the
> -.I ssize_t
> -and
> .I ptrdiff_t
> +and
> +.I ssize_t
> types in this page.
> .TP
> .I ssize_t
>
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: [PATCH 3/4] system_data_types.7: Document ptrdiff_t
2020-09-18 12:04 ` [PATCH 3/4] system_data_types.7: Document ptrdiff_t Alejandro Colomar
@ 2020-09-18 20:19 ` Michael Kerrisk (man-pages)
0 siblings, 0 replies; 9+ messages in thread
From: Michael Kerrisk (man-pages) @ 2020-09-18 20:19 UTC (permalink / raw)
To: Alejandro Colomar; +Cc: mtk.manpages, linux-man, libc-alpha
Hello Alex,
On 9/18/20 2:04 PM, Alejandro Colomar wrote:
> Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Patch applied.
Thanks,
Michael
> ---
> man7/system_data_types.7 | 25 ++++++++++++++++++++++++-
> 1 file changed, 24 insertions(+), 1 deletion(-)
>
> diff --git a/man7/system_data_types.7 b/man7/system_data_types.7
> index 5ef470386..8969ee966 100644
> --- a/man7/system_data_types.7
> +++ b/man7/system_data_types.7
> @@ -62,6 +62,27 @@ system_data_types \- overview of system data types
> .\"
> .\" * See also
> .TP
> +.I ptrdiff_t
> +.IP
> +Include:
> +.I <stddef.h>.
> +.IP
> +Used for a count of elements, and array indices.
> +It is the result of subtracting two pointers.
> +According to the C language standard, it shall be a signed integer type
> +capable of storing values in the range
> +.BR "" [ PTRDIFF_MIN ,
> +.BR PTRDIFF_MAX ].
> +.IP
> +Conforming to: C99 and later; POSIX.1-2001 and later.
> +.IP
> +See also the
> +.\".I regoff_t , FIXME: uncomment when regoff_t is documented.
> +.I size_t
> +and
> +.I ssize_t
> +types in this page.
> +.TP
> .I sigval
> .IP
> Include:
> @@ -221,8 +242,10 @@ See also:
> .BR write (2)
> .IP
> See also the
> +.I ptrdiff_t
> +and
> .I size_t
> -type in this page.
> +types in this page.
> .TP
> .I suseconds_t
> .IP
>
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: [PATCH 4/4] ptrdiff_t.3: New link to new documented type in system_data_types(7)
2020-09-18 12:04 ` [PATCH 4/4] ptrdiff_t.3: New link to new documented type in system_data_types(7) Alejandro Colomar
@ 2020-09-18 20:20 ` Michael Kerrisk (man-pages)
0 siblings, 0 replies; 9+ messages in thread
From: Michael Kerrisk (man-pages) @ 2020-09-18 20:20 UTC (permalink / raw)
To: Alejandro Colomar; +Cc: mtk.manpages, linux-man, libc-alpha
On 9/18/20 2:04 PM, Alejandro Colomar wrote:
> Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Patch applied.
Thanks,
Michael
> ---
> man3/ptrdiff_t.3 | 1 +
> 1 file changed, 1 insertion(+)
> create mode 100644 man3/ptrdiff_t.3
>
> diff --git a/man3/ptrdiff_t.3 b/man3/ptrdiff_t.3
> new file mode 100644
> index 000000000..db50c0f09
> --- /dev/null
> +++ b/man3/ptrdiff_t.3
> @@ -0,0 +1 @@
> +.so man7/system_data_types.7
>
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
^ permalink raw reply [flat|nested] 9+ messages in thread
end of thread, other threads:[~2020-09-18 20:20 UTC | newest]
Thread overview: 9+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-09-18 12:04 [PATCH 0/4] Document ptrdiff_t (and a few minor patches) Alejandro Colomar
2020-09-18 12:04 ` [PATCH 1/4] system_data_types.7: srcfix: Remove TODO comment Alejandro Colomar
2020-09-18 20:16 ` Michael Kerrisk (man-pages)
2020-09-18 12:04 ` [PATCH 2/4] system_data_types.7: wfix: sort referenced types Alejandro Colomar
2020-09-18 20:16 ` Michael Kerrisk (man-pages)
2020-09-18 12:04 ` [PATCH 3/4] system_data_types.7: Document ptrdiff_t Alejandro Colomar
2020-09-18 20:19 ` Michael Kerrisk (man-pages)
2020-09-18 12:04 ` [PATCH 4/4] ptrdiff_t.3: New link to new documented type in system_data_types(7) Alejandro Colomar
2020-09-18 20:20 ` Michael Kerrisk (man-pages)
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).