* lib/mcel.h: Mention that errors may be given on
some systems even with the "C" locale, as mcel
has explicitly disabled the workaround for:
https://sourceware.org/PR29511
Also state that len is set to 1 on any error.
---
 ChangeLog  | 9 +++++++++
 lib/mcel.h | 2 ++
 2 files changed, 11 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index 74d54e24b4..ce2733d5bd 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2025-10-18  Pádraig Brady  <[email protected]>
+
+       doc: mcel: give more detail on error interface
+       * lib/mcel.h: Mention that errors may be given on
+       some systems even with the "C" locale, as mcel
+       has explicitly disabled the workaround for:
+       https://sourceware.org/PR29511
+       Also state that len is set to 1 on any error.
+
 2025-09-18  Pádraig Brady  <[email protected]>
 
        localcharset: fix macOS build
diff --git a/lib/mcel.h b/lib/mcel.h
index ebdd135f63..3e770c8c60 100644
--- a/lib/mcel.h
+++ b/lib/mcel.h
@@ -45,6 +45,8 @@
 
    You can select from G using G.ch, G.err, and G.len.
    G is an encoding error if G.err is nonzero, a character otherwise.
+   Note G.err may occur even in the "C" locale on some systems.
+   In any case G.len will be 1 if G.err is set.
 
    The mcel_scanz function is similar except it works with a
    string of unknown but positive length that is terminated with '\0'.
-- 
2.51.0


Reply via email to