Skip to contentSkip to conversation

man1/*: srcfix: remove superfluous quotes around space-free arguments

PATCH In review Bjarni Ingi Gislason 2 participants 3 messages Jul 5, 2020 – Jul 13, 2020 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 man1/*: srcfix: remove superfluous quotes around space-free arguments

Remove quotes around a space-free argument for the single-font macros.

---
 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(-)
man1/getent.1 +1 -1
index 8f89a933b..5b6b9265a 100644
@@ -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
man1/iconv.1 +3 -3
index 3649e6dbe..6b728ead1 100644
@@ -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
man1/intro.1 +1 -1
index 63fcf5dea..dbef34622 100644
@@ -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.
man1/localedef.1 +1 -1
index dcd4ff90d..552b126f7 100644
@@ -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
man1/time.1 +5 -5
index f274aa9d8..476359c6c 100644
@@ -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,
Signature · 1 line
2.27.0
#1 lore raw

Bjarni,

Quoted 2 lines · Bjarni Ingi Gislason

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

Quoted 127 lines
---
 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(-)
man1/getent.1 +1 -1
index 8f89a933b..5b6b9265a 100644
@@ -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
man1/iconv.1 +3 -3
index 3649e6dbe..6b728ead1 100644
@@ -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
man1/intro.1 +1 -1
index 63fcf5dea..dbef34622 100644
@@ -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.
man1/localedef.1 +1 -1
index dcd4ff90d..552b126f7 100644
@@ -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
man1/time.1 +5 -6
index f274aa9d8..476359c6c 100644
@@ -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

Signature · 3 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
#2 lore raw
Quoted 9 lines · Michael Kerrisk (man-pages)

Bjarni,

Quoted 2 lines · Bjarni Ingi Gislason

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.

Signature · 1 line
Bjarni I. Gislason