From: Bruno Haible <bruno@clisp.org>
Date: Sun, 4 Apr 2021 17:26:14 +0000 (+0200)
Subject: doc: Document how file names with spaces are protected in PO files.
X-Git-Tag: v0.22~262
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=0d606b37f90316b51a59ec5fefea7383bf3a0882;p=thirdparty%2Fgettext.git

doc: Document how file names with spaces are protected in PO files.

* gettext-tools/doc/gettext.texi (PO Files): Document how file names with spaces
are protected in PO files.
* NEWS: Mention the change.
---

diff --git a/NEWS b/NEWS
index c863571e5..9ca0dbc40 100644
--- a/NEWS
+++ b/NEWS
@@ -1,5 +1,10 @@
 Version 0.21.1 - April 2021
 
+* PO file format:
+  - When a #: line contains references to file names that contain spaces,
+    these file names are surrounded by Unicode characters U+2068 and U+2069.
+    This makes it possible to parse such references correctly.
+
 * Programming languages support:
   - C, C++: xgettext now supports gettext-like functions that take wide strings
     (of type 'const wchar_t *', 'const char16_t *', or 'const char32_t *') as
diff --git a/gettext-tools/doc/gettext.texi b/gettext-tools/doc/gettext.texi
index 90eba7997..2e12696e7 100644
--- a/gettext-tools/doc/gettext.texi
+++ b/gettext-tools/doc/gettext.texi
@@ -1504,6 +1504,11 @@ a translation.
 
 All comments, of either kind, are optional.
 
+References to the program's source code, in lines that start with @code{#:},
+are of the form @code{@var{file_name}:@var{line_number}} or just
+@var{file_name}.  If the @var{file_name} contains spaces. it is enclosed
+within Unicode characters U+2068 and U+2069.
+
 @kwindex msgid
 @kwindex msgstr
 After white space and comments, entries show two strings, namely