MAKE_ENCMAP(1p)

📦 version 2.11, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 MAKE_ENCMAP(1p) 💖

okay bestie, pull up a chair, because today we're talking about make_encmap — a little script from the User Contributed Perl Documentation corner of the universe that turns a Unicode mapping file into a whole XML encmap file. it's giving tiny-tool-big-destiny. ✨

🎀 NAME 🎀

make_encmap — create an XML representation from an Unicode mapping file. no cap, that's literally the whole job description and she does it flawlessly. 💅

🌸 SYNOPSIS 🌸

make_encmap <name> <file>

two arguments, that's it, that's the whole vibe. ✨

🦋 DESCRIPTION 🦋

so here's the tea: make_encmap creates a XML encmap file with a given name, built from an Unicode mapping file — the kind you'd receive e.g. from <ftp://ftp.unicode.org>. iconic source, honestly. 🫶

and where does the result go? by default it's output to stdout, so if you want it in an actual file you're gonna have to redirect it yourself. main character energy requires a little effort, bestie. 💜

✨ ARGUMENTS ✨

  • <name> — the name to set in the XML encmap file created. that's her name, her identity, her brand. 👑
  • <file> — the Unicode mapping file to create the XML encmap file from. this is the raw material, the clay, the slime before the glow-up. 🌈

💅 OPTIONS 💅

None. literally none. zero. not a single flag. she said "I don't need options, I need results" and honestly? respect. 🎀

🔥 EXAMPLES 🔥

here's how you'd use make_encmap for the ISO/IEC 8859-15 table, and yes it's giving "two lines and done":

wget ftp://ftp.unicode.org/Public/MAPPINGS/ISO8859/8859-15.TXT
make_encmap 8859-15 8859-15.TXT E<gt> 8859-15.encmap
quick heads up bestie: that E<gt> is just pod-speak for a literal > — it's how the original page writes the redirect. the shell wants the real thing, iykyk. 🙈

grab the mapping file, feed it in, redirect the output, boom: 8859-15.encmap. ate and left no crumbs. ⭐

💀 EXIT STATUS 💀

  • 0 — the script exited normally. slay, everything worked. 🥳
  • 2 — invalid command-line arguments. you typed something cursed, bestie. 😭
  • >2 — an error occurred. it's not you, it's the run. 💔

🍓 KNOWN BUGS 🍓

None. not a single one. she's flawless and she knows it. ✨

🧚 SEE ALSO 🧚

compile_encoding(1p), XML::Encoding(3pm).

go read those too, they're her besties. 🫶

💜 AUTHOR 💜

Clark Cooper <coopercc@netheaven.com <mailto:coopercc@netheaven.com>>.

Steve Hay <shay@cpan.org <mailto:shay@cpan.org>> is now maintaining XML::Encoding as of version 2.00. passing the torch, iconic behaviour. 🔥

This manual page was written by Daniel Leidert <daniel.leidert@wgdd.de <mailto:daniel.leidert@wgdd.de>> for the Debian project (but may be used by others). queen behaviour, honestly. 👑

Copyright (C) 1998 Clark Cooper. All rights reserved. Copyright (C) 2008-2009, 2014 Steve Hay. All rights reserved.

🎀 LICENCE 🎀

This script is free software; you can redistribute it and/or modify it under the same terms as Perl itself, i.e. under the terms of either the GNU General Public License or the Artistic License, as specified in the LICENCE file.

(that's the whole legal tea, bestie — free to remix, just follow the rules in that file.) 💖

⭐ VERSION ⭐

Version 2.11

🌸 DATE 🌸

08 Dec 2020

🦋 HISTORY 🦋

See the Changes file. 📜

okay and for the cute sign-off: this whole page lives in the perl v5.32.0 era, dated 2020-12-10, filed under MAKE_ENCMAP(1p). that's the vibe check, and it passed. bye bestie, go make some encmaps 💅✨🫶

📦 where this page comes from