Rockbox.org home
release
dev builds
extras
themes manual
wiki
device status forums
mailing lists
IRC bugs
patches
dev guide



Rockbox mail archive

Subject: Stop and think before you modify english.lang

Stop and think before you modify english.lang

From: Jonas Häggqvist <rasher_at_rasher.dk>
Date: Thu, 25 Jun 2009 17:45:20 +0200

Each time english.lang is modified, it means work for our translators.
This happens even though a lot of changes are simple monkey-work which can
and should be automated. To this end, I wrote a tool a while ago to do
these boring changes - tools/langtool.pl. I'll just post the output of
--help below, which should pretty much explain its capabilities.

Please think of our translators - use langtool.pl whenever possible!

--------------------------------------------------------------------------
Usage langtool [--inplace] --options langfile1 [langfile2 ...]

  For all actions, the modified langfile will be output on stdout. When doing
  stuff to english.lang, you should almost always apply the same change to all
  other languages to avoid bothering translators.

  --deprecate --id ID_1,ID_2 --id ID_3 langfile

    Deprecate a number of ids.
    Example: langtool --id LANG_LEFT,LANG_RIGHT --LANG_BOTTOM english.lang

  --changesource --id ID --target target --to string langfile

    Change the source text of a specific string specified by id and
target. Use
    this on all langfiles if you're changing a source in english.lang that
    doesn't need attention from translators (case changes etc.).
    Example:
      langtool --changesource --id LANG_OK --target e200 --to "OK"
english.lang

  --changeid --from LANG_LFET --to LANG_LEFT langfile

    Change the name of an ID. THIS WILL BREAK BACKWARDS COMPATIBILITY. Use
with
    extreme caution.
    Example: langtool --changeid --from LANG_OK --to LANG_YES english.lang

  --changedesc --to string --id LANG_LEFT langfile

    Change the desc for an ID.
    Example: langtool --changedesc --to "New desc" --id LANG_OK english.lang

  --changetarget --from target --to target --id ID1 langfile

    Change the target for the specified id from one value to another
    Example:
      langtool --changetarget --from e200 --to e200,c200 --id LANG_ON
dansk.lang

  --inplace

    Perform file operations in-place, instead of outputting the result to
    stdout. With this option set, you can specify multiple langfiles for
    all commands.
    Example: langtool --deprecate --id LANG_ASK --inplace *.lang
--------------------------------------------------------------------------

-- 
Jonas Häggqvist
rasher(at)rasher(dot)dk
Received on 2009-06-25

Page template was last modified "Tue Sep 7 00:00:02 2021" The Rockbox Crew -- Privacy Policy