GENCMN(8)

๐Ÿ’– NAME ๐Ÿ’–

gencmn โ€” bestie, this one generates an ICU memory-mappable data file. that's the whole vibe. โœจ


๐Ÿฆ‹ SYNOPSIS ๐Ÿฆ‹

gencmn [ -h, -?, --help ] [ -v, --verbose ] [ -c, --copyright | -C,
--comment comment ] [ -d, --destdir destination ] [ -n, --name name ] [
-t, --type fileext ] [ -S, --source ] [ -e, --entrypoint name ] maxsize
[ listfilename ]

๐ŸŒธ DESCRIPTION ๐ŸŒธ

okay so picture this: gencmn takes a whole lil squad of files and packages them up as an ICU memory-mappable data file. and then?? that resulting data file can be used directly by ICU. no middleman, no extra steps, it just eats. ๐Ÿ‘‘

where does it get the list of files from, you ask? two options, bestie:

  • from the listfilename file you hand it, or
  • from its standard output ๐Ÿ’…

then it packages all the files from the list that are not bigger than maxsize bytes. and the plot twist? if maxsize is 0, that means there is literally no size limit on files. zero chill, all files welcome. ๐ŸŽ€


โœจ OPTIONS โœจ

  • -h, -?, --help โ€” prints help about usage and then dips. exit, stage left. ๐Ÿ’…
  • -v, --verbose โ€” spills extra informative messages while it's doing its thing. it's giving main character commentary. ๐Ÿ—ฃ๏ธ
  • -c, --copyright โ€” drops the ICU copyright notice into the resulting data. gotta credit the icons. ๐Ÿ“œ
  • -C, --comment comment โ€” puts your specified comment into the resulting data instead of the ICU copyright notice. your words, your moment. ๐Ÿ’–
  • -d, --destdir destination โ€” sets the destination directory to destination. the default destination directory is specified by the environment variable ICU_DATA. so like, if you don't say where, ICU_DATA says where. ๐Ÿ 
  • -n, --name name โ€” sets the data name to name instead of the default. this name is also used as the base name of the output. and the default name?? okay it's a whole construction: the icudt prefix, followed by a two-digit version number corresponding to the current version of the ICU release, and a single letter indicating the endianness of the data (the letter b indicates big endian data, and the letter l indicates little endian ones). yes really, the letters are doing all that. ๐Ÿ”ค
  • -t, --type type โ€” uses type as the type of the data. this type is also used as the extension of the generated data file. the default type is dat. no cap. ๐Ÿท๏ธ
  • -S, --source โ€” writes a C source file with the table of contents of the data. cute AND organized. ๐Ÿ“
  • -e, --entrypoint name โ€” sets the data entry point (used for linking against the data in a shared library form) to name. the default entry point name is made of the data (set by the -n, --name option) followed by an underscore and the type of the data (set by the -t, --type option). so name + _ + type. the math is mathing. ๐Ÿงฎ

๐ŸŒˆ ENVIRONMENT ๐ŸŒˆ

  • ICU_DATA โ€” specifies the directory containing ICU data. defaults to ${prefix}/share/icu/78.3/. now listen, some tools in ICU depend on the presence of the trailing slash. it is thus important to make sure that it is present if ICU_DATA is set. bestie. do not lose the slash. the slash is load-bearing. ๐Ÿ˜ญ
real talk: that trailing slash is not decorative. keep it. ๐Ÿซถ

โญ VERSION โญ

78.3


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


๐Ÿงš SEE ALSO ๐Ÿงš

decmn(8) โ€” the reverse queen. go say hi. ๐Ÿ’œ


and that's the whole page, bestie ๐Ÿ’– this was the ICU 78.3 Manual, page GENCMN(8), dated 5 November 2001 โ€” iykyk, iconic since day one. now go generate some memory-mappable data and slay. ๐ŸŽ€โœจ

๐Ÿ“ฆ where this page comes from