* [PATCH] man1/*: srcfix: remove superfluous quotes around space-free arguments
@ 2020-07-05 13:25 Bjarni Ingi Gislason
2020-07-06 9:53 ` Michael Kerrisk (man-pages)
0 siblings, 1 reply; 3+ messages in thread
From: Bjarni Ingi Gislason @ 2020-07-05 13:25 UTC (permalink / raw)
To: mtk.manpages; +Cc: linux-man
Remove quotes around a space-free argument for the single-font macros.
Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---
man1/getent.1 | 2 +-
man1/iconv.1 | 6 +++---
man1/intro.1 | 2 +-
man1/localedef.1 | 2 +-
man1/time.1 | 10 +++++-----
5 files changed, 11 insertions(+), 11 deletions(-)
diff --git a/man1/getent.1 b/man1/getent.1
index 8f89a933b..5b6b9265a 100644
--- a/man1/getent.1
+++ b/man1/getent.1
@@ -366,7 +366,7 @@ Disables IDN encoding in lookups for
.BR \-? ", " \-\-help
Print a usage summary and exit.
.TP
-.B "\-\-usage"
+.B \-\-usage
Print a short usage summary and exit.
.TP
.BR \-V ", " \-\-version
diff --git a/man1/iconv.1 b/man1/iconv.1
index 3649e6dbe..6b728ead1 100644
--- a/man1/iconv.1
+++ b/man1/iconv.1
@@ -86,7 +86,7 @@ transliterated are replaced with a question mark (?) in the output.
.BR \-l ", " \-\-list
List all known character set encodings.
.TP
-.B "\-c"
+.B \-c
Silently discard characters that cannot be converted instead of
terminating when encountering such characters.
.TP
@@ -98,14 +98,14 @@ for output.
.BR \-s ", " \-\-silent
This option is ignored; it is provided only for compatibility.
.TP
-.B "\-\-verbose"
+.B \-\-verbose
Print progress information on standard error when processing
multiple files.
.TP
.BR \-? ", " \-\-help
Print a usage summary and exit.
.TP
-.B "\-\-usage"
+.B \-\-usage
Print a short usage summary and exit.
.TP
.BR \-V ", " \-\-version
diff --git a/man1/intro.1 b/man1/intro.1
index 63fcf5dea..dbef34622 100644
--- a/man1/intro.1
+++ b/man1/intro.1
@@ -189,7 +189,7 @@ Here it finds Maja's telephone number.
.SS Pathnames and the current directory
Files live in a large tree, the file hierarchy.
Each has a
-.I "pathname"
+.I pathname
describing the path from the root of the tree (which is called
.IR / )
to the file.
diff --git a/man1/localedef.1 b/man1/localedef.1
index dcd4ff90d..552b126f7 100644
--- a/man1/localedef.1
+++ b/man1/localedef.1
@@ -280,7 +280,7 @@ Print a usage summary and exit.
Also prints the default paths used by
.BR localedef .
.TP
-.B "\-\-usage"
+.B \-\-usage
Print a short usage summary and exit.
.TP
.BR \-V ", " \-\-version
diff --git a/man1/time.1 b/man1/time.1
index f274aa9d8..476359c6c 100644
--- a/man1/time.1
+++ b/man1/time.1
@@ -137,7 +137,7 @@ All of those used by
.BR tcsh (1)
are supported.
.PP
-.B "Time"
+.B Time
.TP
.B %E
Elapsed real time (in [hours:]minutes:seconds).
@@ -156,7 +156,7 @@ Total number of CPU-seconds that the process spent in user mode.
.B %P
Percentage of the CPU that this job got, computed as (%U + %S) / %E.
.PP
-.B "Memory"
+.B Memory
.TP
.B %M
Maximum resident set size of the process during its lifetime, in Kbytes.
@@ -209,7 +209,7 @@ Number of times the process was context-switched involuntarily
Number of waits: times that the program was context-switched voluntarily,
for instance while waiting for an I/O operation to complete.
.PP
-.B "I/O"
+.B I/O
.TP
.B %I
Number of filesystem inputs by the process.
@@ -262,13 +262,13 @@ is terminated by a signal) or nonzero exit status.
.\"
.SS GNU standard options
.TP
-.B "\-\-help"
+.B \-\-help
Print a usage message on standard output and exit successfully.
.TP
.B "\-V, \-\-version"
Print version information on standard output, then exit successfully.
.TP
-.B "\-\-"
+.B \-\-
Terminate option list.
.SH BUGS
Not all resources are measured by all versions of UNIX,
--
2.27.0
^ permalink raw reply related [flat|nested] 3+ messages in thread
* Re: [PATCH] man1/*: srcfix: remove superfluous quotes around space-free arguments
2020-07-05 13:25 [PATCH] man1/*: srcfix: remove superfluous quotes around space-free arguments Bjarni Ingi Gislason
@ 2020-07-06 9:53 ` Michael Kerrisk (man-pages)
2020-07-13 21:51 ` Bjarni Ingi Gislason
0 siblings, 1 reply; 3+ messages in thread
From: Michael Kerrisk (man-pages) @ 2020-07-06 9:53 UTC (permalink / raw)
To: Bjarni Ingi Gislason; +Cc: linux-man
Bjarni,
On Sun, 5 Jul 2020 at 15:25, Bjarni Ingi Gislason <bjarniig@rhi.hi.is> wrote:
>
> Remove quotes around a space-free argument for the single-font macros.
Your commit message doesn't explain why this patch/this series is
useful. Please explain.
Thanks,
Michael
> Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
> ---
> man1/getent.1 | 2 +-
> man1/iconv.1 | 6 +++---
> man1/intro.1 | 2 +-
> man1/localedef.1 | 2 +-
> man1/time.1 | 10 +++++-----
> 5 files changed, 11 insertions(+), 11 deletions(-)
>
> diff --git a/man1/getent.1 b/man1/getent.1
> index 8f89a933b..5b6b9265a 100644
> --- a/man1/getent.1
> +++ b/man1/getent.1
> @@ -366,7 +366,7 @@ Disables IDN encoding in lookups for
> .BR \-? ", " \-\-help
> Print a usage summary and exit.
> .TP
> -.B "\-\-usage"
> +.B \-\-usage
> Print a short usage summary and exit.
> .TP
> .BR \-V ", " \-\-version
> diff --git a/man1/iconv.1 b/man1/iconv.1
> index 3649e6dbe..6b728ead1 100644
> --- a/man1/iconv.1
> +++ b/man1/iconv.1
> @@ -86,7 +86,7 @@ transliterated are replaced with a question mark (?) in the output.
> .BR \-l ", " \-\-list
> List all known character set encodings.
> .TP
> -.B "\-c"
> +.B \-c
> Silently discard characters that cannot be converted instead of
> terminating when encountering such characters.
> .TP
> @@ -98,14 +98,14 @@ for output.
> .BR \-s ", " \-\-silent
> This option is ignored; it is provided only for compatibility.
> .TP
> -.B "\-\-verbose"
> +.B \-\-verbose
> Print progress information on standard error when processing
> multiple files.
> .TP
> .BR \-? ", " \-\-help
> Print a usage summary and exit.
> .TP
> -.B "\-\-usage"
> +.B \-\-usage
> Print a short usage summary and exit.
> .TP
> .BR \-V ", " \-\-version
> diff --git a/man1/intro.1 b/man1/intro.1
> index 63fcf5dea..dbef34622 100644
> --- a/man1/intro.1
> +++ b/man1/intro.1
> @@ -189,7 +189,7 @@ Here it finds Maja's telephone number.
> .SS Pathnames and the current directory
> Files live in a large tree, the file hierarchy.
> Each has a
> -.I "pathname"
> +.I pathname
> describing the path from the root of the tree (which is called
> .IR / )
> to the file.
> diff --git a/man1/localedef.1 b/man1/localedef.1
> index dcd4ff90d..552b126f7 100644
> --- a/man1/localedef.1
> +++ b/man1/localedef.1
> @@ -280,7 +280,7 @@ Print a usage summary and exit.
> Also prints the default paths used by
> .BR localedef .
> .TP
> -.B "\-\-usage"
> +.B \-\-usage
> Print a short usage summary and exit.
> .TP
> .BR \-V ", " \-\-version
> diff --git a/man1/time.1 b/man1/time.1
> index f274aa9d8..476359c6c 100644
> --- a/man1/time.1
> +++ b/man1/time.1
> @@ -137,7 +137,7 @@ All of those used by
> .BR tcsh (1)
> are supported.
> .PP
> -.B "Time"
> +.B Time
> .TP
> .B %E
> Elapsed real time (in [hours:]minutes:seconds).
> @@ -156,7 +156,7 @@ Total number of CPU-seconds that the process spent in user mode.
> .B %P
> Percentage of the CPU that this job got, computed as (%U + %S) / %E.
> .PP
> -.B "Memory"
> +.B Memory
> .TP
> .B %M
> Maximum resident set size of the process during its lifetime, in Kbytes.
> @@ -209,7 +209,7 @@ Number of times the process was context-switched involuntarily
> Number of waits: times that the program was context-switched voluntarily,
> for instance while waiting for an I/O operation to complete.
> .PP
> -.B "I/O"
> +.B I/O
> .TP
> .B %I
> Number of filesystem inputs by the process.
> @@ -262,13 +262,13 @@ is terminated by a signal) or nonzero exit status.
> .\"
> .SS GNU standard options
> .TP
> -.B "\-\-help"
> +.B \-\-help
> Print a usage message on standard output and exit successfully.
> .TP
> .B "\-V, \-\-version"
> Print version information on standard output, then exit successfully.
> .TP
> -.B "\-\-"
> +.B \-\-
> Terminate option list.
> .SH BUGS
> Not all resources are measured by all versions of UNIX,
> --
> 2.27.0
--
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] 3+ messages in thread
* Re: [PATCH] man1/*: srcfix: remove superfluous quotes around space-free arguments
2020-07-06 9:53 ` Michael Kerrisk (man-pages)
@ 2020-07-13 21:51 ` Bjarni Ingi Gislason
0 siblings, 0 replies; 3+ messages in thread
From: Bjarni Ingi Gislason @ 2020-07-13 21:51 UTC (permalink / raw)
To: Michael Kerrisk (man-pages); +Cc: linux-man
On Mon, Jul 06, 2020 at 11:53:50AM +0200, Michael Kerrisk (man-pages) wrote:
> Bjarni,
>
> On Sun, 5 Jul 2020 at 15:25, Bjarni Ingi Gislason <bjarniig@rhi.hi.is> wrote:
> >
> > Remove quotes around a space-free argument for the single-font macros.
>
> Your commit message doesn't explain why this patch/this series is
> useful. Please explain.
>
Remove the misuse of quotation marks.
####
Know yourself, and the kinds of errors you make. Once you have
found and fixed a bug, make sure that you eliminate other bugs
that might be similar. Think about what happened so you can
avoid making that kid of mistake again.
Brian W. Kernighan, Rob Pike "The Practice of
Programming". Addison-Wesley. 1999. Page 137.
--
Bjarni I. Gislason
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2020-07-13 21:51 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-07-05 13:25 [PATCH] man1/*: srcfix: remove superfluous quotes around space-free arguments Bjarni Ingi Gislason
2020-07-06 9:53 ` Michael Kerrisk (man-pages)
2020-07-13 21:51 ` Bjarni Ingi Gislason
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).