mirror of
https://github.com/rkd77/elinks.git
synced 2025-01-03 14:57:44 -05:00
Greatly expanded the BUGS section of Locale::PO.
This commit is contained in:
parent
da7d4cfa25
commit
2232e80db3
@ -588,17 +588,26 @@ General Public License version 2|perlgpl>:
|
||||
|
||||
=item Z<>2006-01-06 Kalle Olavi Niemitalo <kon@iki.fi>
|
||||
|
||||
Appended ".kon" to $VERSION.
|
||||
Added the copyright notice (from README) and this history.
|
||||
Appended ".kon" to C<$VERSION>.
|
||||
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.
|
||||
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.
|
||||
Use fields, and "my Locale::PO" where applicable.
|
||||
|
||||
=item Z<>2006-01-07 Kalle Olavi Niemitalo <kon@iki.fi>
|
||||
|
||||
POD changes:
|
||||
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
|
||||
|
||||
=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
|
||||
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
|
||||
|
||||
xgettext(1).
|
||||
|
Loading…
Reference in New Issue
Block a user