[groff] 18/20: PROBLEMS: Document macOS/Homebrew/uchardet issue.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 9b426f27bc9aafd05726059f5eec488da4c6a31e
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Oct 19 12:25:54 2024 -0500

    PROBLEMS: Document macOS/Homebrew/uchardet issue.
    
    Add item and document workaround under "groff 1.22.4" because it likely
    affected that release as well; Bertrand added uchardet as an optional
    dependency in 2017, and the next groff release was in December 2018.
    
    Fixes <https://savannah.gnu.org/bugs/?66143>.  Thanks to Sven Schober
    for the report and for determining the workaround.
---
 ChangeLog | 11 +++++++++++
 PROBLEMS  | 15 +++++++++++++++
 2 files changed, 26 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index 10178650b..2a362bc89 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,14 @@
+2024-10-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       * PROBLEMS: Document macOS/Homebrew/uchardet issue.  Add item
+       and document workaround under "groff 1.22.4" because it likely
+       affected that release as well; Bertrand added uchardet as an
+       optional dependency in 2017, and the next groff release was in
+       December 2018.
+
+       Fixes <https://savannah.gnu.org/bugs/?66143>.  Thanks to Sven
+       Schober for the report and for determining the workaround.
+
 2024-10-19  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        * src/roff/troff/node.cpp (troff_output_file::trailer): Clarify
diff --git a/PROBLEMS b/PROBLEMS
index 0507ab124..41df65b10 100644
--- a/PROBLEMS
+++ b/PROBLEMS
@@ -971,6 +971,21 @@ future release of gnulib to do so.
 
 [groff 1.22.4]
 
+* I'm building groff for Homebrew on macOS, and the build does not find
+  the `uchardet` library even though I know it's installed.
+
+  groff and Homebrew have different ideas about where to find the
+  "uchardet.h" header file (because its API is undocumented), and this
+  causes groff's "configure" script to not find the library.  To work
+  around the problem, tell groff's "configure" script that uchardet
+  support is desired, and where to find the header file.
+
+  $  ../configure --with-uchardet CPPFLAGS=-I/opt/homebrew/include
+
+  Thanks to Sven Schober for researching this issue.
+
+----------------------------------------------------------------------
+
 * When compiling on NetBSD, make issues warnings like
 
   Warning: line 28: Unable to locate font(s)