From: Bruno Haible <bruno@clisp.org>
Date: Sun, 3 Jul 2022 09:15:39 +0000 (+0200)
Subject: doc: Clarify constraints for PO files.
X-Git-Tag: v0.22~196
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=805b7597fe5d59c38584fe670d6daa1484ddbfee;p=thirdparty%2Fgettext.git

doc: Clarify constraints for PO files.

Reported by Gábor Hojtsy <gabor.hojtsy@gmail.com> in
<https://savannah.gnu.org/bugs/?62677>.

* gettext-tools/doc/gettext.texi (PO Files): State uniqueness requirement.
---

diff --git a/gettext-tools/doc/gettext.texi b/gettext-tools/doc/gettext.texi
index 531c73b53..2d17df602 100644
--- a/gettext-tools/doc/gettext.texi
+++ b/gettext-tools/doc/gettext.texi
@@ -1874,6 +1874,11 @@ this comment is most likely generated and managed by specialized GNU
 tools, and might disappear or be replaced unexpectedly when the PO
 file is given to @code{msgmerge}.
 
+For a PO file to be valid, no two entries without @code{msgctxt} may have
+the same @var{untranslated-string} or @var{untranslated-string-singular}.
+Similarly, no two entries may have the same @code{msgctxt} and the same
+@var{untranslated-string} or @var{untranslated-string-singular}.
+
 @node Sources
 @chapter Preparing Program Sources
 @cindex preparing programs for translation