ICUPKG(8)

💖 ICUPKG 💖

okay bestie, welcome to icupkg, part of the ICU 78.3 Manual situation — she's a manual page (section 8, server-girlie territory) and she's here to help you extract or modify an ICU .dat archive. no cap. let's get into it 🎀

---

✨ SYNOPSIS ✨

icupkg [ -h, -?, --help ] [ -tl, --type l | -tb, --type b | -te, --type
e ] [ -c, --copyright | -C, --comment comment ] [ -a, --add list ] [ -r,
--remove list ] [ -x, --extract list ] [ -l, --list ] [ -s, --sourcedir
source ] [ -d, --destdir destination ] [ -w, --writepkg ] [ -m,
--matchmode mode ] infilename [ outfilename ]

---

🦋 DESCRIPTION 🦋

So here's the tea, bestie: icupkg reads your input ICU .dat package file, does whatever you told it to do via the options, swaps it to the platform properties you want (that's charset & endianness, iykyk), and then — if you feel like it — writes the resulting ICU .dat package out to the output file. ✨

And the order of operations is literally fixed, okay? Items get removed, then added, then extracted and listed. That's the pipeline, that's the vibe, periodt.

An ICU .dat package gets written if:

• items are removed or added, or
• the input and output filenames differ, or
• you set the -w, --writepkg option 💅

Not me also telling you this: if the input filename is "new", then an empty package is created. Iconic. And if the output filename is missing, it gets automatically generated from the input filename. Also! If the input filename ends with an l, b, or e matching its platform properties, then the output filename will contain the letter from the -t, --type option. 🧚

Plot twist: this tool can also just swap a single ICU data file, replacing the former icuswap tool. For this mode, provide the infilename (and optional outfilename) for a non-package ICU data file. The options allowed in this mode are -t, -w, -s and -d. The filenames can be absolute, or relative to the source/dest dir paths. > Other options are not allowed in this mode. 🚫

---

🌸 OPTIONS 🌸

• -h, -?, --help — prints help about usage and then dips. bye bestie 👋
• -tl, --type l — output for the little-endian/ASCII charset family. the output type defaults to the input type.
• -tb, --type b — output for the big-endian/ASCII charset family. the output type defaults to the input type.
• -te, --type e — output for the big-endian/EBCDIC charset family. the output type defaults to the input type.
• -c, --copyright — includes the ICU copyright notice in the resulting data. 💅
• -C, --comment comment — includes the comment you specify in the resulting data, instead of the ICU copyright notice.
• -a, --add list — adds items from the list to the package. The list can be a single filename with a .txt file extension containing a list of item filenames, or an ICU .dat package filename. 🍓
• -r, --remove list — removes items from the list from the package. The list can be a single filename with a .txt file extension containing a list of item filenames, or an ICU .dat package filename.
• -x, --extract list — extracts items from the list from the package. The list can be a single filename with a .txt file extension containing a list of item filenames, or an ICU .dat package filename.
• -m, --matchmode mode — sets the matching mode for item names with wildcards. 🃏
• -s, --sourcedir source — sets the source directory to source. The default source directory is the current directory.
• -d, --destdir destination — sets the destination directory to destination. The default destination directory is the current directory.
• -l, --list — lists the package items to stdout (after modifying the package, bestie — the order matters!!).

---

🎀 LIST FILE SYNTAX 🎀

Items are listed on one or more lines and separated by whitespace (space+tab). Comments begin with # and are ignored. Empty lines are ignored too, we're not about that clutter life. ✨

Also ignored: lines where the first non-whitespace character is one of %&'()*+,-./:;<=>?_ — those are being reserved for future syntax, so hands off. 🙈

Items for removal or extraction may contain a single * wildcard character. The * matches zero or more characters. If -m, --matchmode noslash is set, then the * character does not match the / character. 🌈

Items must be listed relative to the package, and the --sourcedir or the --destdir path will be prepended. The paths are only prepended to item filenames while adding or extracting items — not to ICU .dat package or list filenames. 🫶

Paths may contain / instead of the platform's file separator character, and they get converted as appropriate. slay.

---

👑 AUTHORS 👑

• Markus Scherer
• George Rhoten

the literal icons who made this happen 💜

---

⭐ VERSION ⭐

1.0

---

💅 COPYRIGHT 💅

Copyright (C) 2006 IBM, Inc. and others.

---

🔥 SEE ALSO 🔥

• pkgdata(1)
• genrb(1)

go read those too, bestie, they're giving main character energy 😭

---

and that's the whole page, fr fr — brought to you by the ICU MANPAGE, dated 18 August 2006, page ICUPKG(8). go forth and swap those packages. mwah 💖