Generate IDNA Data

generate-idna-data generates the compact IDNA2008 runtime table from the configured Unicode source snapshot in tool/data/ucd. Use it to check that the generated source is current or to regenerate it after a generator change. Follow repository setup if the maintenance tool is not installed yet.

Check or Regenerate the Table

Run these commands from the repository root. The first checks without writing; the second updates the generated source when its contents differ.

./erbsland-core-tool generate-idna-data --check
./erbsland-core-tool generate-idna-data

--check (short form -c ) returns failure if the output is missing or differs. It preserves existing output. Normal generation leaves equivalent files untouched; line terminators and first-line copyright years are ignored. On Windows, use tool\bin\erbsland-core-tool.exe in place of the root shortcut.

Configuration and Overrides

Output settings are in tool/conf/tools/generate_idna_data.elcl. The default destination is src/erbsland/text/punycode/impl/IdnaData.cpp. For a one-off comparison, choose an output in an existing project directory:

./erbsland-core-tool generate-idna-data --output-file tool/data/IdnaData.cpp

Shared Unicode inputs are selected in tool/conf/source/unicode.elcl. Keep the configured version pin and the source snapshot together; changing the version string alone does not update data. There are no command-line input overrides. See IDNA Generator Reference for all settings and input validation, and Customize Generated Notices for generated notices.

Update the Unicode Dataset

Follow Update Unicode Sources to acquire a consistent release and update its integrity metadata and version pin. For derivation, table representation, and conformance tests, see IDNA Generator Reference.