gensprep(8)

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

✨ gensprep(8) ✨

okay bestie, gather round 💖 this is the gensprep page from the ICU 78.3 manual, and she's a little compiler goblin who turns filtered StringPrep data into actual binary. no cap.

🌸 NAME 🌸

gensprep — compiles StringPrep data from files that were already filtered by filterRFC3454.pl ✨

🦋 SYNOPSIS 🦋

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

💅 DESCRIPTION 💅

So here's the tea 🍓: gensprep reads files that have already been filtered through RFC 3454, and it compiles all that info into binary form. Iconic behavior honestly.

The file it spits out is called <name>.icu, and that baby can be read directly by ICU, OR you can hand it off to pkgdata(8) so it gets incorporated into a bigger archive or library. main character energy for a binary blob, fr fr.

All the files that gensprep actually reads? Those are living down in the FILES section, go look 👀

✨ OPTIONS ✨

  • -h, -?, --help — prints help about usage and then dips out. classic.
  • -v, --verbose — spills extra informative messages while it's running, iykyk 🗣️
  • -c, --copyright — sneaks a copyright notice into the binary data 📝
  • -s, --sourcedir source — sets the source directory to source. the default comes from the environment variable ICU_DATA.
  • -d, --destdir destination — sets the destination directory to destination. the default also comes from the environment variable ICU_DATA.

🌈 ENVIRONMENT 🌈

  • ICU_DATA — specifies the directory containing ICU data. defaults to ${prefix}/share/icu/78.3/.
⚠️ okay real talk bestie, some tools in ICU depend on the presence of the trailing slash. so if you set ICU_DATA, you MUST make sure that slash is there. it's giving picky, but it's giving picky for a reason. 💀

🎀 FILES 🎀

These are the files gensprep reads, and it goes looking for them in source /misc for the rfc3454_*.txt files, and in source /unidata for NormalizationCorrections.txt. 🧚

  • rfc3453_A_1.txt — contains the list of unassigned codepoints in Unicode version 3.2.0....
  • rfc3454_B_1.txt — contains the list of code points that are commonly mapped to nothing....
  • rfc3454_B_2.txt — contains the list of mappings for casefolding of code points when Normalization form NFKC is specified....
  • rfc3454_C_X.txt — contains the list of code points that are prohibited for IDNA.
  • NormalizationCorrections.txt — contains the list of code points whose normalization has changed since Unicode Version 3.2.0.

⭐ VERSION ⭐

78.3 👑

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

🫶 SEE ALSO 🫶

pkgdata(8) — go say hi, she's the one who packages your stuff up 💖

and that's the whole page, bestie. this one's an ICU MANPAGE from way back on 18 March 2003, filed under gensprep(8). slay, periodt. 💅✨🎀🦋

📦 where this page comes from