EOCONV(1)

💖 EOCONV 💖

okay so bestie, this is the manual page for eoconv(1) from the User Contributed Perl Documentation section, and honestly? it's giving "quiet little utility that does one thing and does it iconically." it converts text files between various Esperanto encodings. yes, that's the whole job. no cap. 🦋

---

✨ NAME ✨

eoconv — Convert text files between various Esperanto encodings

🌸 USAGE 🌸

eoconv [-q] --from=encoding --to=encoding [file ...]

 Options:
   --from       specify input encoding (see below)
   --to         specify output encoding (see below)
   -q, --quiet  suppress warnings

   --help       detailed help message
   --man        full documentation
   --version    display version information

 Valid encodings:
   post-h post-H post-x post-X post-caret pre-caret latex
   html-hex html-dec iso-8859-3 utf-7 utf-8 utf-16 utf-32

🎀 DESCRIPTION 🎀

so here's the vibe: eoconv reads the input files you hand it (or stdin if you hand it literally nothing, which, valid), assumes that text is in whatever encoding you said with --from, and then spits it back out in whatever encoding you said with --to. that's it. that's the whole main character arc. ✨

💅 OPTIONS 💅

• --from=encoding — specify the character encoding of the input. tell it what it's looking at, bestie.
• --to=encoding — specify the character encoding of the output. tell it where it's going.
• -q, --quiet — suppress non-essential warning messages. the "not now, i'm busy" flag 🫶
• -?, --help — print a brief help message and exit. little snack, quick read.
• --man — print the manual page and exit. that's me! hi! 👋
• --version — print version information and exit.

---

🔥 CHARACTER ENCODINGS 🔥

• post-h — ASCII postfix h notation
• post-H — ASCII postfix H notation
• post-x — ASCII postfix x notation
• post-X — ASCII postfix X notation
• post-caret — ASCII postfix caret (^) notation
• pre-caret — ASCII prefix caret (^) notation
• latex, LaTeX — ASCII LaTeX sequences
• html-hex, HTML-hex — ASCII HTML hexadecimal entities
• html-dec, HTML-dec — ASCII HTML decimal entities
• iso-8859-3, ISO-8859-3, latin3, latin-3, Latin3, Latin-3 — ISO-8859-3
• utf-7, UTF-7, utf7, UTF7 — Unicode UTF-7
• utf-8, UTF-8, utf8, UTF8 — Unicode UTF-8
• utf-16, UTF-16, utf16, UTF16 — Unicode UTF-16
• utf-32, UTF-32, utf32, UTF32 — Unicode UTF-32

🌈 ESPERANTO ORTHOGRAPHY 🌈

okay so, lore time. Esperanto is written in an alphabet of 28 letters. but only 22 of those letters can be found in the standard ASCII character set 😭. the remaining six — c, g, h, j, and s with circumflex, and u with breve — are not available in ASCII, and they're not among the characters available in the common 8-bit ISO-8859-1 character encoding either. so like… while those six special Esperanto characters pose no problem for handwritten texts, they were impossible to represent on standard typewriters, and they're somewhat problematic even on modern-day computers. so many encoding systems got invented to represent Esperanto text in printed and typed text. iconic problem-solving behavior, honestly. 👑

⭐ POSTFIX-h NOTATION ⭐

this was the solution proposed by the creator of Esperanto himself, L. L. Zamenhof. he recommended using u for u-breve and appending an h to a letter to indicate that it should have a circumflex. BUT — and this is the part where we hold hands and brace ourselves — the letters u and h are already part of the Esperanto alphabet, so using them for another purpose invites ambiguity and mispronunciation. it also makes conversion of Esperanto text to postfix-h notation lossy or one-way; it is generally not possible to convert from postfix-h notation via automated means. and there's an additional drawback: the text cannot be sorted with standard rules for ASCII text. 💀

⭐ POSTFIX-H NOTATION ⭐

same as postfix-h notation, except that H is used instead of h following a capital letter. capital energy only. 💅

⭐ POSTFIX-x NOTATION ⭐

this is the most common ASCII notation encountered today. you append an x to a letter to indicate that it should have an accent (be it circumflex or breve). since x is not a letter in the Esperanto alphabet, no ambiguity results. slay. however — and there's always a however — ASCII sorting algorithms still fail with postfix-x text. 🙈

⭐ POSTFIX-X NOTATION ⭐

same as postfix-x notation, except that X is used instead of x following a capital letter.

⭐ PREFIX- AND POSTFIX-CARET NOTATION ⭐

two slightly less popular ASCII encodings, where you prepend or append a caret (^) to a letter to indicate that it should have an accent. the niche girlies of Esperanto encodings. 🎀

⭐ ISO-8859-3 (LATIN-3) ⭐

ISO 8859-3, also known as Latin-3 or South European, is an 8-bit character encoding for Esperanto. high-bit characters are used to encode the accented Esperanto letters. ISO-8859-3 can also be used for encoding English, Finnish, German, Italian, Latin, Maltese, Turkish, and Portuguese, making it useful for texts which mix Esperanto with one or more of these languages. multilingual queen behavior. 🌍

⭐ UNICODE (ISO/IEC 10646) ⭐

Unicode is a standard for matching every character of every human language to a specific code. the mapping methods are known as Unicode Transformation Formats (UTF). among them are UTF-32, UTF-16, UTF-8 and UTF-7, where the numbers indicate the number of bits in one unit. math but make it global. ✨

⭐ LaTeX SEQUENCES ⭐

the popular LaTeX typesetting package is capable of representing virtually any accented character. note that conversion from LaTeX sequences assumes that characters to be accented are enclosed in braces — for example, \^{C} will be recognized as C with circumflex, but \^C will not be. braces or it didn't happen, bestie. 🫶

⭐ HTML ENTITIES ⭐

Unicode codes for Esperanto characters can be escaped in HTML documents by using HTML entities. the codes can be represented in either decimal (base-10) or hexadecimal (base-16) notation; the two are functionally equivalent. pick your fighter, they're the same fighter. 💜

😭 BUGS AND LIMITATIONS 😭

because the postfix-h and postfix-H notations are inherently ambiguous, conversion from postfix-h or -H text is unlikely to result in coherent text.

use at your own risk, and carefully proofread the results. seriously. proofread. i am begging. 🙏

report bugs to <psychonaut@nothingisreal.com>.

👑 AUTHOR 👑

Tristan Miller <psychonaut@nothingisreal.com>

🌸 SEE ALSO 🌸

charsets(7), ascii(7), iso_8859-3(7), unicode(7), utf-8(7), latex(1)

🎀 LICENSE AND COPYRIGHT 🎀

Copyright (C) 2004-2016 Tristan Miller.

Permission is granted to make and distribute verbatim or modified copies of this manual provided the copyright notice and this permission notice are preserved on all copies.

---

and that's the whole page, bestie — this one came from perl v5.30.0 and it was dated 2020-05-09, so if you're reading it later than that, go touch grass and also check for a newer version. mwah 💖