groff-commit
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[groff] 06/19: groff_mm(7): Fix content and style nits.


From: G. Branden Robinson
Subject: [groff] 06/19: groff_mm(7): Fix content and style nits.
Date: Thu, 16 Sep 2021 08:59:01 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 54b7a7a1496705f230234e8bf1ab7a311afba5a9
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Sep 14 09:20:31 2021 +1000

    groff_mm(7): Fix content and style nits.
    
    Content:
    * Only non-English (translated) strings are kept in localization files.
    * No need to note that the string determining the localization file to
      load is "internal".
    * Clarify syntax of `nr` request.
    * (See also) Add cross reference to refer(1) preprocessor.
    
    Style:
    * Add non-print break point escape sequences to file names and URLs.
    * Tighten wording so we don't repeat "macro file" ad nauseam.
---
 contrib/mm/groff_mm.7.man | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index d8935d3..22cfec6 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -95,7 +95,8 @@ Cut marks are not supported.
 .I groff mm
 is designed to be easily localized.
 .
-Strings that can appear in output are collected in the file
+For languages other than English,
+strings that can appear in output are collected in the file
 .IR @MACRODIR@/ xx .tmac ,
 where
 .I xx
@@ -112,21 +113,19 @@ not
 .P
 This package can also be localized by site or territory;
 for example,
-.I @MACRODIR@/@TMAC_M_PREFIX@mse.tmac
+.I \%@MACRODIR@/\:@TMAC_M_PREFIX@mse\:.tmac
 illustrates how to adapt the output to a national standard using its ISO
 3166 territory code.
 .
-Such a package can define an internal string that causes a macro file
-called
-.RI territory _locale
+Such a package can define a string that causes a macro file
+.IR \%@MACRODIR@/\:mm/\: territory _locale
 to be loaded at package initialization.
 .
 If this mechanism is not used,
-a macro file called
-.I locale
+.I \%@MACRODIR@/\:mm/\:locale
 is loaded instead.
 .
-No diagnostic is produced if these macro files do not exist.
+No diagnostic is produced if these files do not exist.
 .
 .
 .\" ====================================================================
@@ -159,8 +158,9 @@ the value to be assigned.
 .
 .IR n \~can
 be prefixed with a plus or minus sign if incrementation or
-decrementation (respectively) of the register's existing value is
-desired.
+decrementation (respectively) of the register's existing value
+.RI by\~ n
+is desired.
 .
 If assignment of a (possibly) negative
 .IR n \~is
@@ -4343,7 +4343,7 @@ of Lund, Sweden.
 .SH "See also"
 .\" ====================================================================
 .
-.UR https://tkurtbond.github.io/troff/mm-all.pdf
+.UR https://tkurtbond\:.github\:.io/\:troff/\:mm-all\:.pdf
 .I MM \- A Macro Package for Generating Documents
 .UE ,
 the DWB\~3.3
@@ -4369,8 +4369,8 @@ You can browse it interactively with \[lq]info groff\[rq].
 .IR \%@g@troff (@MAN1EXT@),
 .IR \%@g@tbl (@MAN1EXT@),
 .IR \%@g@pic (@MAN1EXT@),
-.IR \%@g@eqn (@MAN1EXT@)
-.br
+.IR \%@g@eqn (@MAN1EXT@),
+.IR \%@g@refer (@MAN1EXT@),
 .IR groff_mmse (@MAN7EXT@)
 .
 .



reply via email to

[Prev in Thread] Current Thread [Next in Thread]