[groff] 35/35: PROBLEMS: Explain build warnings from afmtodit.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 1f4817f375354f062d3b4fdfbc0c52e2676e267b
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Jul 15 21:56:21 2022 -0500

    PROBLEMS: Explain build warnings from afmtodit.
    
    I'm wondering about hacking afmtodit to just silently ignore duplicate
    mappings when the AGL target is 'uniXXXX', but I'm not sure yet.
---
 PROBLEMS | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/PROBLEMS b/PROBLEMS
index 6c66703c..5676153a 100644
--- a/PROBLEMS
+++ b/PROBLEMS
@@ -738,6 +738,28 @@ Compilation Problems
 
 
 
+* I get warnings from afmtodit about names already being mapped.
+
+afmtodit: AGL name 'Delta' already mapped to groff name '*D'; ignoring AGL 
name 'uni0394'
+
+You can ignore these if they're in the form shown above, where the
+ignored AGL name is 'uniXXXX' and 'XXXX' is four hexadecimal digits.
+The Adobe Glyph List (AGL) has its own names for glyphs; they are often
+different from groff's special character names.  The afmtodit program is
+constructing a mapping from groff special character names to AGL names;
+this can be a one-to-one or many-to-one mapping, but one-to-many will
+not work, so afmtodit discards the excessing mappings.  The example you
+see above is telling you that the groff font description that afmtodit
+is writing cannot map the groff special character '*D' to both 'Delta'
+and 'uni0394'.
+
+Which, if any, such warnings you see depends on the version of the URW
+fonts you are builing groff against.  See the '--with-urw-fonts-dir'
+option to the "configure" script, and the afmtodit(1) and groff_char(7)
+man pages for more background.
+
+----------------------------------------------------------------------
+
 * I get warnings about special characters in the groff_char(7) man page.
 
 troff:man/groff_char.7:1000: warning: can't find special character '.j'