GENCNVAL(1)

📦
version 78.3 · 10 versions
, in arch rolling, ubuntu stonking

💖 GENCNVAL(1) 💖

okay bestie, listen up — this is the gencnval page from the ICU 78.3 Manual, and it's lowkey one of those little tools that does one job and does it flawlessly. no notes. let's get into it 🫶

✨ NAME ✨

gencnval — compile the converters aliases file

🌸 SYNOPSIS 🌸

gencnval [ -h, -?, --help ] [ -v, --verbose ] [ -c, --copyright ] [ -s,
--sourcedir source ] [ -d, --destdir destination ] [ converterfile ]

🦋 DESCRIPTION 🦋

so what does this girl actually do? gencnval takes the ICU aliases file — that's your converterfile — and converts it into a binary file called cnvalias.icu. that's it. that's the whole vibe. 💅

and then?? that binary file can be read directly by ICU, or it can be handed off to pkgdata(1) so it gets incorporated into a bigger archive or library. it's giving team player. it's giving "I make the build system work". iconic behavior fr fr.

and if you don't pass a converterfile? no stress, she just uses the default ICU convrtrs.txt file. main character energy, honestly. ✨

💅 OPTIONS 💅

  • -h, -?, --help — prints help about usage and then exits. the classic "help me I'm lost" move, and honestly? valid.
  • -v, --verbose — display verbose output. this info can include stuff about conflicting aliases and the converters that the aliases resolve to. so if you're nosy (and you are, bestie, I see you), this is your flag. 👀
  • -c, --copyright — include a copyright notice in the binary data. gotta give credit where credit is due 💖
  • -s, --sourcedir source — set the source directory to source. the default source directory is specified by the environment variable ICU_DATA.
  • -d, --destdir destination — set the destination directory to destination. the default destination directory is specified by the environment variable ICU_DATA.

🌈 ENVIRONMENT 🌈

  • ICU_DATA — specifies the directory containing ICU data. defaults to ${prefix}/share/icu/78.3/. 🚨 important though: some tools in ICU depend on the presence of the trailing slash. so if you set ICU_DATA yourself, you gotta make sure that slash is there. do not skip the slash. the slash is not optional. the slash is the moment. 😭

🎀 FILES 🎀

  • icu/source/data/mappings/convrtrs.txt — description of ICU's converters and their aliases. heads up: this data file is not normally installed, and it's available as a part of ICU source code. so like, you gotta go get it from the source tree, bestie 🧚

⭐ VERSION ⭐

78.3

Copyright (C) 2000-2004 IBM, Inc. and others.

🔥 SEE ALSO 🔥

and that's the whole page, bestie!! 🍓 this gem is from the ICU MANPAGE, dated 11 March 2004 — yeah she's been serving since 2004 and she still eats 💀💖 periodt. go forth and compile those converter aliases. I'm obsessed. 🦋✨

📦 where this page comes from