From: Michael Orlitzky <michael@orlitzky.com>
Date: Sun, 5 Jul 2026 20:55:30 +0000 (-0400)
Subject: README.rst: begin documenting quirks
X-Git-Url: https://gitweb.michael.orlitzky.com/?a=commitdiff_plain;h=474199f576ca50f2a4927468b0092008bbc23f19;p=iconv-quirks.git

README.rst: begin documenting quirks
---

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.
+