po/README.tools

   1 The po/ directory includes two perlscripts, which is done to help
   2 making the translations fully uptodate.
   3
   4 The first script is called update.pl and is supposed to be run like this:
   5
   6         ./update.pl [OPTIONS] ...LANGCODE
   7
   8 This will updates the pot file (the po template, generated from the source code)
   9 and merge them with the translations po files.
  10
  11 For instance to do this for Danish, type the following
  12
  13         ./update.pl da
  14
  15
  16 The update.pl script also supports other options, they are:
  17
  18   -V, --version                shows the version
  19   -H, --help                   shows this help page
  20   -P, --pot                    only generates the potfile
  21   -M, --maintain               search for missing files in POTFILES.in
  22
  23 Especially the --maintain option is very handy for package maintainer, to check
  24 if you included all the files that have marked strings in the POTFILES.in, so
  25 they will be in the generated po template, the socalled pot file.
  26
  27 There is though one thing to take notice of with this option, please check the
  28 configure.in file to make sure that the files you add to POTFILES.in are being
  29 build, otherwise this can leed to "make dist" throuble.
  30
  31
  32 The other utility is the desk.pl script, which will check the cvs module for
  33 missing translation in files like *.desktop, *.directory, *.soundlist and so on.
  34
  35 Run the script like this:
  36
  37         ./desk.pl [OPTIONS] ...LANGCODE ENTRY
  38
  39 An example use could be.
  40
  41         ./desk.pl da
  42
  43 which will check all the files for missing Name[da] entries, or
  44
  45         ./desk.pl no Comment
  46
  47 which will check all the files for missing Comment[no] entries. "Comment" can
  48 here be replaced with whatever you like
  49
  50 All scripts support the --help option for further help, though it's not very
  51 extensive for the moment.
  52
  53 Kenneth Christiansen
  54
  55 kenneth@gnu.org
  56 kenneth@gnome.org
  57
  58 Both scripts are copyright 2000 The Free Software Foundation and me.