[groff] 04/05: {g,n}roff.1.man: Give assistance to pager users.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 4e5439d9827232a1910bda5cac6ccea8d00243f6
Author: G. Branden Robinson <address@hidden>
Date:   Wed Jun 26 20:32:31 2019 +1000

    {g,n}roff.1.man: Give assistance to pager users.
    
    Many users (I was one of them) did not know why pagers degraded nroff
    output.  Give people a hint where to look for help.
    
    The application of screen-paging utilities to cp1047-based output
    devices is conjectural on my part; I have no experience with EBCDIC
    systems.
---
 src/roff/groff/groff.1.man | 22 ++++++++++++++++++++++
 src/roff/nroff/nroff.1.man | 13 +++++++++++++
 2 files changed, 35 insertions(+)

diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index 165507e..c943c90 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -1611,6 +1611,28 @@ groffer foo.me
 .
 .
 .\" ====================================================================
+.SH NOTES
+.\" ====================================================================
+.
+.P
+When paging output for the
+\[lq]ascii\[rq],
+\[lq]cp1047\[rq],
+\[lq]latin1\[rq],
+and
+\[lq]utf8\[rq]
+devices,
+programs like
+.IR more (1)
+and
+.IR less (1)
+may require command-line options to correctly handle some output
+sequences;
+see
+.IR \%grotty (@MAN1EXT@).
+.
+.
+.\" ====================================================================
 .SH BUGS
 .\" ====================================================================
 .
diff --git a/src/roff/nroff/nroff.1.man b/src/roff/nroff/nroff.1.man
index 4969f28..4e4e086 100644
--- a/src/roff/nroff/nroff.1.man
+++ b/src/roff/nroff/nroff.1.man
@@ -81,6 +81,7 @@ formats documents written in the
 .IR roff (@MAN7EXT@)
 language for typewriter-like devices such as terminal emulators.
 .
+.
 .P
 GNU
 .I @g@nroff
@@ -235,6 +236,18 @@ is unset.
 .SH NOTES
 .\" ====================================================================
 .
+.P
+Pager programs like
+.IR more (1)
+and
+.IR less (1)
+may require command-line options to correctly handle some output
+sequences;
+see
+.IR \%grotty (@MAN1EXT@).
+.
+.
+.P
 Character definitions in the file
 .I @MACRODIR@/\:tty\-char.tmac
 are loaded to replace unrepresentable glyphs.