[groff] 02/02: groff_man*(7): Advise on man.local customiation.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit d75377a926b5ec336e592c9ab5ec9cc9e53b6bac
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Aug 13 22:27:36 2020 +1000

    groff_man*(7): Advise on man.local customiation.
    
    * tmac/groff_man.7.man.in (Description/Number registers): Inform reader
      that registers can be set in man.local file and cross-reference it.
      (Files/*/man.local): [style] Supply example of man.local
      customizations, prompted by recent discussions on groff, linux-man,
      and man-db mailing lists.
    
      https://lore.kernel.org/linux-man/20200729145630.GH21941@arm.com/
      https://lists.gnu.org/archive/html/groff/2020-08/msg00061.html
      https://savannah.nongnu.org/bugs/?58752
---
 ChangeLog               |  8 ++++++++
 tmac/groff_man.7.man.in | 20 ++++++++++++++++++++
 2 files changed, 28 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index c0b1b6b..eb95bbd 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2020-08-13  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       * tmac/groff_man.7.man.in (Description/Number registers): Inform
+       reader that registers can be set in man.local file and
+       cross-reference it.  (Files/*/man.local): [style] Supply example
+       of man.local customizations, prompted by recent discussions on
+       groff, linux-man, and man-db mailing lists.
+
 2020-08-12  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        * tmac/tmac.am: Use a stamp file for m4 keyword check.
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 8b47795..d430b7b 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -1904,6 +1904,11 @@ also cause a break but no insertion of vertical space.
 .
 Number registers are described in section \(lqOptions\(rq below.
 .
+They can be set not only on the command line but in the site
+.I man.local
+file as well;
+see section \(lqFiles\(rq below.
+.
 .
 .\" ====================================================================
 .SS Strings
@@ -3138,6 +3143,21 @@ Put local changes and customizations into this file.
 _ifstyle()dnl
 .
 .
+.RS
+.RS
+.PP
+.EX
+\&.\e" Use narrower indentation on terminals and similar.
+\&.if n .nr IN 4n
+\&.\e" Put only one space after the end of a sentence.
+\&.ss 12 0 \e" See groff(@MAN7EXT@).
+\&.\e" Keep pages narrow even on wide terminals.
+\&.if n .if \(rsn[LL]>78 .nr LL 78n
+.EE
+.RE
+.RE
+.
+.
 .\" ====================================================================
 .SH Notes
 .\" ====================================================================