[groff] 01/01: preconv(1): Fix error regarding groff -k and -K.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit e3b774ad6f927006aacc2dfc83814f7d6f4fe41b
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Nov 11 23:05:13 2020 +1100

    preconv(1): Fix error regarding groff -k and -K.
    
    * src/preproc/preconv/preconv.1.man (Description): Fix error; groff's -K
      option, not -k, specifies a character econding (and overrides
      GROFF_ENCODING in the environment).  Also explain how valid encoding
      strings are determined.
    
    Thanks to Bjarni Ingi Gislason for the report.
    
    Fixes <https://savannah.gnu.org/bugs/?59445>.
---
 ChangeLog                         | 11 +++++++++++
 src/preproc/preconv/preconv.1.man | 23 ++++++++++++++++++-----
 2 files changed, 29 insertions(+), 5 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index bd1b17e..c6c76f5 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,16 @@
 2020-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
 
+       * src/preproc/preconv/preconv.1.man (Description): Fix error;
+       groff's -K option, not -k, specifies a character econding (and
+       overrides GROFF_ENCODING in the environment).  Also explain how
+       valid encoding strings are determined.
+
+       Thanks to Bjarni Ingi Gislason for the report.
+
+       Fixes <https://savannah.gnu.org/bugs/?59445>.
+
+2020-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
        * src/preproc/tbl/table.cpp (table::compute_separation_factor):
        Add word "table" to diagnostic message to better cue the user
        that it is produced by roff that has been injected into the
diff --git a/src/preproc/preconv/preconv.1.man 
b/src/preproc/preconv/preconv.1.man
index eadc428..80929c1 100644
--- a/src/preproc/preconv/preconv.1.man
+++ b/src/preproc/preconv/preconv.1.man
@@ -196,12 +196,21 @@ or
 options,
 or by configuring your locale appropriately.
 .
-Furthermore,
 .I groff
-supports a
+also supports a
 .I \%GROFF_ENCODING
-environment variable which is equivalent to its option
-.BR \-k .
+environment variable,
+which can be overridden by its
+.B \-K
+option.
+.
+Valid values for
+(or parameters to)
+all of these are enumerated in the lists of recognized coding tags in
+the next subsection,
+and is further influenced by
+.I iconv
+library support.
 .
 .
 .\" ====================================================================
@@ -372,8 +381,10 @@ are disregarded for the purpose of comparison with the 
above tags.
 .SS "iconv support"
 .\" ====================================================================
 .
+While
 .I preconv
-itself only supports three encodings:
+recognizes all of the coding tags listed above,
+it is capable on its own of interpreting only three encodings:
 Latin-1,
 code page 1047,
 and UTF-8.
@@ -385,6 +396,8 @@ all other encodings are passed to
 .I iconv
 library functions.
 .
+The library may recognize many additional encoding strings.
+.
 The command
 .RB \[lq] preconv\~\-v \[rq]
 discloses whether