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).