NAME¶
potool - program for manipulating gettext po files
SYNOPSIS¶
potool FILENAME1 [
FILENAME2 ] [-f
f|nf|t|nt|nth|o|no]
[-n
ctxt|id|str|cmt|ucmt|pcmt|scmt|dcmt|tr|linf]... [-s] [-c]
potool -h
DESCRIPTION¶
potool works in two (so far) modes. The first mode requires providing one
file name, and works as a filter. In the second mode, the program
replaces the translations in FILENAME1 with the translations from
FILENAME2. (So FILENAME1 is the base po file, while FILENAME2 is our working
copy.)
OPTIONS¶
- -f filter
- Determines which po file entries should be retained.
In the second mode, the filters are applied only to FILENAME2 (the working
copy). Existing filters are:
t - translated entries
nt - untranslated entries
nth - untranslated entries and the header
f - fuzzy entries
nf - entries that are not fuzzy
o - obsolete entries
no - non-obsolete entries
It is possible to stack filters, by specifying multiple -f options.
- -n filter
- Determines which po file entries parts should not be
retained. Any number of -n options is allowed. Valid parameters are:
ctxt - don't write 'ctxt' parts
id - don't write 'id' parts
str - don't write 'str' parts
tr - don't write translations
ucmt - don't write user's comments
pcmt - don't write the comments regarding position in source files
scmt - don't write special comments ('#, fuzzy, c-format, ...')
dcmt - don't write reserved comments (usually starting with a dot)
cmt - don't write any comments
linf - change source line numbers to '1'.
The last parameter is useful when you need to compare two po or pot files
using diff(1) as it usually returns lots of unimportant line number
changes otherwise.
- -s
- Don't display the entries themselves, only their
count.
- -c
- Overwrite all msgstrs with their msgids.
- -h
- Display short usage help.
EXAMPLES¶
- potool x.po -s -ft
- displays the number of translated entries. See also
postats(1).
- potool x.po -nstr
- Deletes all translations - so you can start from scratch!
:-)
- potool x.po -ft && potool x.po -fnt
- displays firstly the translated and then the non-translated
entries from file x.po (reverse order is not recommended because of the
first "header" entry). The output contains all information from
x.po, with the difference that untranslated entries are located together
in a single place.
- potool x.po -fnt > tmp.po && editor tmp.po
&& potool x.po tmp.po
- lets you easily add new translations, without looking at
the already translated entries
The last two examples are implemented as the
potooledit(1) program.
SEE ALSO¶
potooledit(1),
postats(1),
msgmerge(1),
msgfmt(1).
AUTHOR¶
Potool was written by Zbigniew Chyla and is now being maintained by Marcin
Owsiany <porridge@debian.org>.