doc: Add a clarification.

Reported by Christian Ohm <chr.ohm@gmx.net>
in <https://savannah.gnu.org/bugs/?36084>.

* gettext-tools/doc/gettext.texi (c-format Flag): Clarify that an xgettext:...
comment applies only to the next string.

diff --git a/gettext-tools/doc/gettext.texi b/gettext-tools/doc/gettext.texi
index d50b9696951ad755ede94c51cb6adfc792f855d5..610b3960eed1537541e4e01b39bc43bf8dfc521d 100644 (file)
--- a/gettext-tools/doc/gettext.texi
+++ b/gettext-tools/doc/gettext.texi
@@ -2648,7 +2648,9 @@ the @code{c-format} flag.  This kind of comment should be used when
 @code{xgettext} does not recognize the string as a format string but
 it really is one and it should be tested.  Please note that when the
 comment is in the same line as the @code{gettext} keyword, it must be
-before the string to be translated.
+before the string to be translated.  Also note that a comment such as
+@code{xgettext:c-format} applies only to the first string in the same
+or the next line, not to multiple strings.
 
 This situation happens quite often.  The @code{printf} function is often
 called with strings which do not contain a format specifier.  Of course