Adding upstream version 0.73.upstream/0.73upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 67 insertions, 0 deletions

diff --git a/NEWS b/NEWS
index 44209b0..3e86155 100644
--- a/NEWS
+++ b/NEWS
@@ -2,7 +2,74 @@ This file presents the major changes of each version, focusing on
 user-visible changes while the day to day changes are in the git logs.
 
 =======================================================================
+        ___  _____ _____
+__   __/ _ \|___  |___ /
+\ \ / / | | |  / /  |_ \          The Cassini release.
+ \ V /| |_| | / /  ___) |
+  \_/  \___(_)_/  |____/          June 17. 2024.
+  
+César-François Cassini de Thury was born 310 years ago, and then made
+a bunch of nice-looking topographic maps of France and around.
 
+General:
+ * Try to not fail when writing UTF po files with old Perl versions
+   (GitHub's #495) [Ineiev].
+ * Improve various error messages to help users debugging encoding issues.
+
+   The thing is that po4a v0.70 and later is much more picky about encodings.
+   Before, it was relying on the default Perl behavior to do "the right thing",
+   happily parsing latin-1 or UTF-8 files and converting to the Perl internal
+   string representation. The drawback was that this setup forced po4a to
+   convert back and forth internally after reading and before writing.
+
+   The v0.70 code uses PerlIO to handle all encoding issues automatically,
+   removing all manual conversions in the code of po4a. The price for this is
+   that users must specify the used encoding more precisely (I sometimes
+   suspect that previously, user settings were only used as an hint of the
+   actual conversion, not a ground truth). So the users are now more exposed
+   to the mess of Perl encodings, where utf8 and UTF-8 are actually different.
+   https://perldoc.perl.org/Encode#UTF-8-vs.-utf8-vs.-UTF8
+
+   This new behavior broke the build of several Debian packages. In some cases,
+   it was just the result of po4a being less forgiving about user configuration
+   (eg, Debian's #1072643). In Debian's #1073038, it was that po4a made a
+   difference between utf8 and UTF-8 in the encoding specification embedded in
+   a POD file. There is no such difference in this context, only in Perl
+   internals: utf8 is lax parsing while UTF-8 is picky parsing, but both lead
+   to the same result if the file is correctly encoded following the UTF-8
+   standard. po4a now takes UTF-8 (picky parsing) in both cases for POD files.
+
+Documentation:
+ * Fix the doc of TransTractor::read() now that the refname is mandatory
+   (GitHub's #504, also involved in Debian's #1072760)
+
+Translations:
+ * Updated: Italian, thanks Marco Ciampa.
+ * Updated: French, thanks brandelune.
+ * Updated: German, thanks Helge Kreutzmann.
+ * Updated: Japanese, thanks gemmaro.
+ * Updated: Serbian & Serbian (cyrillic), thanks Ivan Pesic.
+ * Updated: Spanish, thanks gallegonovato.
+
+Status of the binary translation:
+ * 4 languages = 100%: de, ja, sr, sr_Cyrl.
+ * 8 languages >= 95%: es (98%), fr (98%), it (98%), nb (95%), nl (98%), pt_BR (95%), ru (95%), uk (95%).
+ * 1 language  >= 90%: pt (90%).
+ * 5 languages >= 80%: eo (87%), hr (87%), hu (84%), zh_Hans (86%), zh_Hant (86%).
+ * 1 language  >= 70%: id (71%).
+ * 8 languages >= 50%: cs (53%), da (62%), et (62%), eu (52%), pl (57%), sl (51%), sv (66%), vi (62%).
+ * 1 language  >= 33%: ca (41%).
+ * 6 starting languages: ace (2%), af (7%), ar (12%), ka (15%), kn (7%), ko (17%).
+
+Status of the documentation translation:
+ * 2 languages = 100%: de, it.
+ * 8 languages >= 95%: es (99%), fr (99%), ja (99%), nl (99%), pt_BR (97%), sr (99%), sr_Cyrl (99%), uk (97%).
+ * 4 languages >= 80%: pt (87%), ru (83%), zh_Hans (87%), zh_Hant (87%).
+ * 1 language  >= 50%: pl (62%).
+ * 1 language  >= 33%: ca (40%).
+ * 4 starting languages: eo (3%), hr (0%), hu (0%), nb (4%).
+
+=======================================================================
         ___  _____ ____
 __   __/ _ \|___  |___ \
 \ \ / / | | |  / /  __) |         Happy centenary, mamie :(