* [PATCH] man-pages.7: wfix
@ 2017-03-21 0:09 Alexander Miller
[not found] ` <20170321010906.2d7185bc.alex.miller-Mmb7MZpHnFY@public.gmane.org>
0 siblings, 1 reply; 4+ messages in thread
From: Alexander Miller @ 2017-03-21 0:09 UTC (permalink / raw)
To: mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w; +Cc: linux-man-u79uwXL29TY76Z2rM5mHXA
Signed-off-by: Alexander Miller <alex.miller-Mmb7MZpHnFY@public.gmane.org>
---
man7/man-pages.7 | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/man7/man-pages.7 b/man7/man-pages.7
index 1fbc375..5d43ed7 100644
--- a/man7/man-pages.7
+++ b/man7/man-pages.7
@@ -484,9 +484,9 @@ pages.
Use of "they" ("them", "themself", "their") as a gender-neutral singular
pronoun is acceptable.
.\"
-.SS Formatting conventions for manual pages describing functions
+.SS Formatting conventions for manual pages describing commands
.PP
-For manual pages that describe command (typically in Sections 1 and 8),
+For manual pages that describe a command (typically in Sections 1 and 8),
the arguments are always specified using italics,
.IR "even in the SYNOPSIS section" .
--
2.10.2
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
^ permalink raw reply related [flat|nested] 4+ messages in thread
* [PATCH] man-pages.7: wfix
@ 2020-06-18 21:26 Jakub Wilk
2020-06-19 10:48 ` Michael Kerrisk (man-pages)
0 siblings, 1 reply; 4+ messages in thread
From: Jakub Wilk @ 2020-06-18 21:26 UTC (permalink / raw)
To: Michael Kerrisk; +Cc: linux-man
Reorder full wordings to match the order of abbreviations.
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
---
man7/man-pages.7 | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/man7/man-pages.7 b/man7/man-pages.7
index 6216e254d..eecba8996 100644
--- a/man7/man-pages.7
+++ b/man7/man-pages.7
@@ -837,7 +837,7 @@ when rendering a page with, say:
In general, the use of abbreviations such as "e.g.", "i.e.", "etc.",
"cf.", and "a.k.a." should be avoided,
in favor of suitable full wordings
-("for example", "that is", "compare to", "and so on", "also known as").
+("for example", "that is", "and so on", "compare to", "also known as").
.PP
The only place where such abbreviations may be acceptable is in
.I short
--
2.27.0
^ permalink raw reply related [flat|nested] 4+ messages in thread
* Re: [PATCH] man-pages.7: wfix
2020-06-18 21:26 Jakub Wilk
@ 2020-06-19 10:48 ` Michael Kerrisk (man-pages)
0 siblings, 0 replies; 4+ messages in thread
From: Michael Kerrisk (man-pages) @ 2020-06-19 10:48 UTC (permalink / raw)
To: Jakub Wilk; +Cc: mtk.manpages, linux-man
Hello Jakub,
On 6/18/20 11:26 PM, Jakub Wilk wrote:
> Reorder full wordings to match the order of abbreviations.
>
> Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
> ---
> man7/man-pages.7 | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/man7/man-pages.7 b/man7/man-pages.7
> index 6216e254d..eecba8996 100644
> --- a/man7/man-pages.7
> +++ b/man7/man-pages.7
> @@ -837,7 +837,7 @@ when rendering a page with, say:
> In general, the use of abbreviations such as "e.g.", "i.e.", "etc.",
> "cf.", and "a.k.a." should be avoided,
> in favor of suitable full wordings
> -("for example", "that is", "compare to", "and so on", "also known as").
> +("for example", "that is", "and so on", "compare to", "also known as").
> .PP
> The only place where such abbreviations may be acceptable is in
> .I short
Thanks. Patch applied.
Cheers,
Michael
--
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] 4+ messages in thread
end of thread, other threads:[~2020-06-19 10:48 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2017-03-21 0:09 [PATCH] man-pages.7: wfix Alexander Miller
[not found] ` <20170321010906.2d7185bc.alex.miller-Mmb7MZpHnFY@public.gmane.org>
2017-03-24 14:40 ` Michael Kerrisk (man-pages)
2020-06-18 21:26 Jakub Wilk
2020-06-19 10:48 ` 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 NNTP newsgroup(s).