NAME¶
pospell - Run a program on the translation strings of a .po-file
SYNOPSIS¶
pospell [-l language ] [-fsv] -n pofile
-p program [-- [ arguments... ]]
DESCRIPTION¶
pospell copies the translations from the
pofile to a temporary
file (called the
spellfile) and then calls
program with its
arguments.
program is supposed to somehow change the
spellfile. It is typically a spell checker. Afterwards the possibly
changed translations in
spellfile is copied back into the
pofile.
If
pofile is specified as
- then
pospell will act as a
filter, i.e. standard input and standard output will be used.
%f in the
arguments will be expanded to the name of the
spellfile, or
- if the -f option is used. Use
%% for a
real % character.
All comment lines in the
pofile are replaced with lines with
"#" as the only character in the
spellfile. The msgid strings
with original text in the
pofile are replaced with lines with
">" and "]" as the only characters in the
spellfile. The msgstr strings with file headers (i.e. strings without
corresponding msgid strings) are replaced with lines with ")" and
"]" as the only characters in the
spellfile. Don't change or
remove these lines from the
spellfile - they are used when the
spellfile and the
pofile are merged together after running the
program.
The normal msgstr strings are copied to the
spellfile with some changes:
1) The word msgstr and everything else before the string is replaced by a
"+" character. 2) Strings with C escape sequences followed by a
letter like "one\ttwo" are split to parts like "one\t"
"two". 3) Leading whitespace in continuation lines is removed. The
changes of kind 1) and 2) are undone when the
spellfile is copied back
into the
pofile, but removed whitespace will not be restored.
OPTIONS¶
- -f
- The called program is a filter so don't make a temporary
file, but pipe the spellfile to its standard input and read it back
from its standard output.
- -l language
- Only translations with the indicated language code are
copied to the spellfile.
- -s
- Quit with an error message if unrecognized items are found
in the pofile or spellfile.
- -v
- Print the version and exit.
FILES¶
pospell uses one or two temporary files with names given by the
mkstemp(3) or the
tmpnam(3) function.
BUGS¶
If some system call gives an unexpected error
pospell will stop
immediately with an error message leaving its temporary files.
AUTHOR¶
Byrial Jensen <byrial@image.dk>
SEE ALSO¶
The GNU gettext utilities.
newsbody(1).