From 474199f576ca50f2a4927468b0092008bbc23f19 Mon Sep 17 00:00:00 2001
From: Michael Orlitzky <michael@orlitzky.com>
Date: Sun, 5 Jul 2026 16:55:30 -0400
Subject: [PATCH] README.rst: begin documenting quirks

---
 README.rst | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/README.rst b/README.rst
index aa134db..cfd1df8 100644
--- a/README.rst
+++ b/README.rst
@@ -11,3 +11,21 @@ Implementations:
 * `musl libc <https://musl.libc.org/>`_
 * `GNU libc <https://www.gnu.org/software/libc/>`_
 * `GNU libiconv <https://www.gnu.org/software/libiconv/>`_
+
+Quirks by implementation
+========================
+
+Not technically illegal, but perhaps unexpected.
+
+musl
+----
+
+* iconv_open() supports neither ``//IGNORE`` nor ``//TRANSLIT`` as an
+  indicator suffices.
+
+glibc
+-----
+
+* iconv_open() accepts any indicator suffix, such as ``//INVALID``.
+* iconv() returns EILSEQ when it ignores invalid input.
+
-- 
2.53.0