From b78c61af84f391c2af1d10678a24f091b74a0ad4 Mon Sep 17 00:00:00 2001
From: Lauri Nurmi <lanurmi@iki.fi>
Date: Thu, 21 Jan 2021 13:41:07 +0200
Subject: [PATCH] Translation docs update: don't recommend 20-year-old gettext;
 use msginit

Warning about gettext versions earlier than 0.10.35 is pointless,
as even 0.10.35 is from 2001, and so old it isn't even available
on GNU mirrors anymore. We shall not recommend a specific version in
the first place.

The proper way to start a new translation is to use msginit to initialize
a .po file -- just copying the .pot leaves many fields to their default
values, which the translator would need to fill in manually (the
Plural-Forms: field in particular).
---
 docs/contributing/translators-guide.md | 5 ++---
 docs/doxygen/mainpages/translations.h  | 6 ++++--
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/docs/contributing/translators-guide.md b/docs/contributing/translators-guide.md
index dfd67544f8..013db04f81 100644
--- a/docs/contributing/translators-guide.md
+++ b/docs/contributing/translators-guide.md
@@ -5,10 +5,9 @@ This note is addressed to wxWidgets translators.
 
 First of all, here is what you will need:
 
-1. GNU gettext package version 0.10.35 or later (NB: earlier versions were
-   known to have serious bugs)
+1. GNU gettext package
 
-   a) for Unix systems you can download gettext-0.10.tar.gz from any GNU
+   a) for Unix systems you can download gettext-0.xx.yy.tar.gz from any GNU
       mirror (RPMs and DEBs are also available from the usual places)
 
    b) for Windows you can download the precompiled binaries from
diff --git a/docs/doxygen/mainpages/translations.h b/docs/doxygen/mainpages/translations.h
index 37f235e495..5cf8e66664 100644
--- a/docs/doxygen/mainpages/translations.h
+++ b/docs/doxygen/mainpages/translations.h
@@ -452,9 +452,11 @@ Here are the steps you should follow:
    you should already have it. Otherwise you can always retrieve it directly
    from the git repository:
    <a href="https://raw.githubusercontent.com/wxWidgets/wxWidgets/master/locale/wxstd.pot">locale/wxstd.pot</a>.
--# Rename it to <tt>XY.po</tt> where <tt>"XY"</tt> is the 2 letter
+-# Initialize an <tt>XY.po</tt> file for your language by using the command
+   <tt>msginit -l XY</tt> in the same folder where you placed <tt>wxstd.pot</tt>.
+   The <tt>"XY"</tt> is the 2 letter
    <a href="http://www.loc.gov/standards/iso639-2/php/English_list.php">ISO 639-2 language code</a>
-   for your language.
+   for your language. Initialization can be also done using e.g. Poedit (see next item).
 -# Translate the strings in this file using either your favourite text
    editor or a specialized tool such as Vaclav Slavik's excellent
    <a href="http://www.poedit.net/">poEdit</a> utility.