[PATCH 11/25] Synchronize comments on *roff syntax.

[G. Branden Robinson]

Clarify what's "not usable", and make parallel between the man pages.
---
 doc/bash.1                  | 6 ++++--
 lib/readline/doc/history.3  | 9 ++++++++-
 lib/readline/doc/readline.3 | 9 ++++++++-
 3 files changed, 20 insertions(+), 4 deletions(-)

diff --git a/doc/bash.1 b/doc/bash.1
index 036ab2ae..342ad823 100644
--- a/doc/bash.1
+++ b/doc/bash.1
@@ -30,7 +30,7 @@
 .\}
 .el \{\
 .ds ' '
-.\" not usable in macro arguments on AT&T troff (DWB, Solaris 10)
+.\" \*" is not usable in macro arguments on AT&T troff (DWB, Solaris 10)
 .ds " ""\" two adjacent quotes and no space before this comment
 .ds ^ ^
 .ds ~ ~
@@ -38,7 +38,9 @@
 .
 .\" File Name macro.  This used to be `.PN', for Path Name,
 .\" but Sun doesn't seem to like that very much.
-.\" \% at the beginning of the string protects the filename from hyphenation.
+.\"
+.\" \% at the beginning of the string protects the filename from
+.\" hyphenation.
 .\"
 .de FN
 \%\fI\|\\$1\|\fP\\$2
diff --git a/lib/readline/doc/history.3 b/lib/readline/doc/history.3
index baa7f412..4a63861e 100644
--- a/lib/readline/doc/history.3
+++ b/lib/readline/doc/history.3
@@ -18,7 +18,7 @@
 .\}
 .el \{\
 .ds ' '
-.\" not usable in macro arguments on AT&T troff (DWB, Solaris 10)
+.\" \*" is not usable in macro arguments on AT&T troff (DWB, Solaris 10)
 .ds " ""\" two adjacent quotes and no space before this comment
 .ds ^ ^
 .ds ~ ~
@@ -39,9 +39,16 @@
 .\" File Name macro.  This used to be `.PN', for Path Name,
 .\" but Sun doesn't seem to like that very much.
 .\"
+.\" \% at the beginning of the string protects the filename from
+.\" hyphenation.
+.\"
 .de FN
 \%\fI\|\\$1\|\fP
 ..
+.\"
+.\" Quotation macro: generate consistent quoted strings that don't rely
+.\" on the presence of the `CW' constant-width font.
+.\"
 .de Q
 .ie \n(.g \(lq\\$1\(rq\\$2
 .el \{\
diff --git a/lib/readline/doc/readline.3 b/lib/readline/doc/readline.3
index 7b7dc9d2..e55df6ca 100644
--- a/lib/readline/doc/readline.3
+++ b/lib/readline/doc/readline.3
@@ -18,7 +18,7 @@
 .\}
 .el \{\
 .ds ' '
-.\" not usable in macro arguments on AT&T troff (DWB, Solaris 10)
+.\" \*" is not usable in macro arguments on AT&T troff (DWB, Solaris 10)
 .ds " ""\" two adjacent quotes and no space before this comment
 .ds ^ ^
 .ds ~ ~
@@ -27,9 +27,16 @@
 .\" File Name macro.  This used to be `.PN', for Path Name,
 .\" but Sun doesn't seem to like that very much.
 .\"
+.\" \% at the beginning of the string protects the filename from
+.\" hyphenation.
+.\"
 .de FN
 \%\fI\|\\$1\|\fP
 ..
+.\"
+.\" Quotation macro: generate consistent quoted strings that don't rely
+.\" on the presence of the `CW' constant-width font.
+.\"
 .de Q
 .ie \n(.g \(lq\\$1\(rq\\$2
 .el \{\
-- 
2.30.2

signature.asc
Description: PGP signature