Readme.md

.tab to gettext

This is intended to replace all usages of .tab to gettext (.po) counterparts.

Usage

php index.php tab2gettext \
    --src-dir $HOME/tuleap \
    --primary-key plugin_tracker \
    --domain tuleap-tracker \
    --en-cache /tmp/cache.lang.en_US.php \
    --fr-cache /tmp/cache.lang.fr_FR.php \
    --target-dir $HOME/tuleap/plugins/tracker/site-content \
    --src-tab tracker.tab

where:

• $HOME/tuleap is the path to the sources (⚠️ all php files in it will be parsed!)
• plugin_tracker is the primary key
• tuleap-tracker is the target domain
• /tmp/cache.lang.en_US.php is the cached file of the en_US strings (can be copied from /var/tmp/tuleap_cache)
• /tmp/cache.lang.fr_FR.php is the cached file of the fr_FR strings (can be copied from /var/tmp/tuleap_cache)
• $HOME/tuleap/plugins/tracker/site-content is the target site-content directory (where .po file will be updated)
• tracker.tab is the .tab files name that we need to treat

Then you should run make generate-po to sort po entries. Look for warnings as you may end up with duplicated entries (poedit may fix some issues for you).

⚠️ Legacy usage of getText may prevent conversion of .tab. For example there may be variables or concatenation in primary/secondary keys. There is a command to help you detect such usage:

php index.php broken-gettext-usage \
    --src-dir $HOME/tuleap/plugins/tracker/include \
    --primary-key plugin_tracker

where:

• $HOME/tuleap/plugins/tracker/include is the path to the sources (⚠️ all php files in it will be parsed!)
• plugin_tracker is the primary key. It is optional, if omitted all detected broken usage will be returned.