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 c863571e515dc31f794de9c4473abef3809b1605..9ca0dbc401183af9edf9f27f6150b0ed6c8d5a6a 100644 (file)
--- 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 90eba799786a89fc057bdbb7ec288ac15527bd3d..2e12696e7ded0464344e4a3b6878daf687c58779 100644 (file)
--- 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