[PATCH 10/13] lib/readline/doc/history.3: Make `EX` and `EE` man(7) macros usable on DWB troff.

[G. Branden Robinson]

This prevents lines in the displayed struct definition from oversetting
on DWB troff.

Diff of rendering (DWB only):

@@ -10150,11 +10150,11 @@
            The state of the History library is encapsulated into a sin-
            gle structure:

-                /*
-                 * structure for passing around the state of history
-                 */
-                typedef struct _hist_state {
-                  HIST_ENTRY **entries; /* pointer to entry records */
+           /*
+            * structure for passing around the state of history
+            */
+           typedef struct _hist_state {
+             HIST_ENTRY **entries; /* pointer to entry records */

@@ -10169,11 +10169,11 @@

-                  int offset;           /* current record */
-                  int length;           /* number of records in list */
-                  int size;             /* capacity of list in records */
-                  int flags;
-                } HISTORY_STATE;
+             int offset;           /* current record */
+             int length;           /* number of records in list */
+             int size;             /* capacity of list in records */
+             int flags;
+           } HISTORY_STATE;

            If the flags member includes HS_STIFLED, the history has
@@ -10774,9 +10774,9 @@
            When using the form keyname:function-name or macro, keyname
            is the name of a key spelled out in English.  For example:

-                     Control-u: universal-argument
-                     Meta-Rubout: backward-kill-word
-                     Control-o: "> output"
+                Control-u: universal-argument
+                Meta-Rubout: backward-kill-word
+                Control-o: "> output"

            In the above example, C-u is bound to the function
@@ -10792,9 +10792,9 @@
            be used, as in the following example, but the symbolic char-
            acter names are not recognized.

-                     "\C-u": universal-argument
-                     "\C-x\C-r": re-read-init-file
-                     "\e[11~": "Function Key 1"
+                "\C-u": universal-argument
+                "\C-x\C-r": re-read-init-file
+                "\e[11~": "Function Key 1"

            In this example, C-u is again bound to the function
@@ -11327,10 +11327,10 @@
                      key sequence that quotes the current or previous
                      word in bash:

-                          $if Bash
-                          # Quote the current or previous word
-                          "\C-xq": "\eb\"\ef\""
-                          $endif
+                     $if Bash
+                     # Quote the current or previous word
+                     "\C-xq": "\eb\"\ef\""
+                     $endif

                 variable
---
 lib/readline/doc/history.3 | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/lib/readline/doc/history.3 b/lib/readline/doc/history.3
index d36c454d..111cdbf6 100644
--- a/lib/readline/doc/history.3
+++ b/lib/readline/doc/history.3
@@ -23,6 +23,18 @@
 .ds ~ ~
 .\}
 .
+.\" Fix broken EX/EE macros on DWB troff.
+.\" Detect it: only DWB sets up a `)Y` register.
+.if \n()Y \{\
+.\" Revert the undesired changes to indentation.
+.am EX
+.in -5n
+..
+.am EE
+.in +5n
+..
+.\}
+.
 .\" File Name macro.  This used to be `.PN', for Path Name,
 .\" but Sun doesn't seem to like that very much.
 .\"
-- 
2.30.2

signature.asc
Description: PGP signature