0
0
mirror of https://github.com/rkd77/elinks.git synced 2025-06-30 22:19:29 -04:00

Greatly expanded the BUGS section of Locale::PO.

This commit is contained in:
Kalle Olavi Niemitalo 2006-01-08 14:25:04 +02:00 committed by Kalle Olavi Niemitalo
parent da7d4cfa25
commit 2232e80db3

View File

@ -588,17 +588,26 @@ General Public License version 2|perlgpl>:
=item Z<>2006-01-06 Kalle Olavi Niemitalo <kon@iki.fi> =item Z<>2006-01-06 Kalle Olavi Niemitalo <kon@iki.fi>
Appended ".kon" to $VERSION. Appended ".kon" to C<$VERSION>.
Added the copyright notice (from README) and this history. Use C<fields>, and C<my Locale::PO> where applicable.
POD changes:
Added the copyright notice (from F<README>) and this history.
Corrected a typo in the documentation. Corrected a typo in the documentation.
Documented quoting in the C<msgid>, C<msgid_plural>, C<msgstr>, and C<msgstr_n> methods. Documented quoting in the C<msgid>, C<msgid_plural>, C<msgstr>, and C<msgstr_n> methods.
Documented newlines in the C<comment>, C<automatic>, and C<reference> methods. Documented newlines in the C<comment>, C<automatic>, and C<reference> methods.
Use fields, and "my Locale::PO" where applicable.
=item Z<>2006-01-07 Kalle Olavi Niemitalo <kon@iki.fi> =item Z<>2006-01-07 Kalle Olavi Niemitalo <kon@iki.fi>
POD changes:
Documented the C<php_format> method. Documented the C<php_format> method.
=item Z<>2006-01-08 Kalle Olavi Niemitalo <kon@iki.fi>
POD changes:
Greatly expanded the L</BUGS> section.
Reformatted this list of changes.
=back =back
=head1 COPYRIGHT AND LICENSE =head1 COPYRIGHT AND LICENSE
@ -612,6 +621,41 @@ redistribute it and/or modify it under the same terms as Perl itself.
If you load_file then save_file, the output file may have slight If you load_file then save_file, the output file may have slight
cosmetic differences from the input file (an extra blank line here or there). cosmetic differences from the input file (an extra blank line here or there).
Locale::PO does not understand obsolete entries that msgmerge comments
out with "#~", and it warns about every such line. The warnings can
be silenced via C<$SIG{__WARN__}>, but that isn't very clean.
Document the situations in which C<msgstr> et al can return C<undef>.
The C<c_format> and C<php_format> methods are documented: "1 implies
c-format, 0 implies no-c-format, and blank or undefined implies
neither." However, the implementation seems to treat empty strings
the same as 0.
Locale::PO either discards or corrupts the "#," flags it does not
recognize: "objc-format" becomes "c-format", and "no-php-format"
becomes "php-format". Unrecognized flags should be preserved;
perhaps the order of flags should also be preserved.
Names of flags are case-insensitive in Locale::PO but case-sensitive
in GNU Gettext.
Locale::PO requires blank lines between entries, but Uniforum style PO
files don't have any.
=head2 Almost Bugs
Locale::PO does not save the line numbers at which entries begin or
end in the PO file. These would be useful in error messages.
The C<msgid> and C<msgstr> methods return quoted strings, but they
expect unquoted strings as input. It would be better to have both
quoted or both unquoted; or perhaps C<< $po->msgid(-quoted => 1) >>.
Locale::PO discards all types of comments it does not recognize.
The B<msgmerge> program of GNU gettext-tools 0.14.3 does the same,
so perhaps it's not a problem.
=head1 SEE ALSO =head1 SEE ALSO
xgettext(1). xgettext(1).