diff options
author | Bruno Haible <bruno@clisp.org> | 2023-05-03 18:32:57 +0200 |
---|---|---|
committer | Bruno Haible <bruno@clisp.org> | 2023-05-03 18:34:05 +0200 |
commit | 2e7dd104e7bd9318c7f652da7356af9c2b6f6fdb (patch) | |
tree | 0cea687f311a58b415b0058f38ba96a8793e46ba | |
parent | c5cdf41d436261b279c172753ac727335d44b9fd (diff) | |
download | gettext-2e7dd104e7bd9318c7f652da7356af9c2b6f6fdb.tar.gz |
Fixes the fix from <https://savannah.gnu.org/bugs/index.php?42376>.
Prompted by <https://savannah.gnu.org/bugs/index.php?64136>.
* gettext-tools/doc/xgettext.texi: Clarify that it's not blank lines, but lines
with tokens, that prevent the extraction of a preceding comment block.
-rw-r--r-- | gettext-tools/doc/xgettext.texi | 18 |
1 files changed, 13 insertions, 5 deletions
diff --git a/gettext-tools/doc/xgettext.texi b/gettext-tools/doc/xgettext.texi index 7cd9ec8ff..367aad153 100644 --- a/gettext-tools/doc/xgettext.texi +++ b/gettext-tools/doc/xgettext.texi @@ -1,5 +1,5 @@ @c This file is part of the GNU gettext manual. -@c Copyright (C) 1995-2022 Free Software Foundation, Inc. +@c Copyright (C) 1995-2023 Free Software Foundation, Inc. @c See the file gettext.texi for copying conditions. @pindex xgettext @@ -129,8 +129,9 @@ Place comment blocks starting with @var{tag} and preceding keyword lines in the output file. Without a @var{tag}, the option means to put @emph{all} comment blocks preceding keyword lines in the output file. -Note that comment blocks supposed to be extracted must be adjacent to -keyword lines. For example, in the following C source code: +Note that comment blocks are only extracted if there is no program code +between the comment and the string that gets extracted. +For example, in the following C source code: @example /* This is the first comment. */ @@ -143,10 +144,17 @@ gettext ( gettext ( /* This is the third comment. */ "baz"); + +/* This is the fourth comment. */ + +gettext ("I love blank lines in my programs"); @end example -The second comment line will not be extracted, because there is one -blank line between the comment line and the keyword. +@noindent +the second comment line will not be extracted, because there is a line +with some tokens between the comment line and the line that contains +the string. But the fourth comment is extracted, because between it and +the line with the string there is merely a blank line. @item --check[=@var{CHECK}] @opindex --check@r{, @code{xgettext} option} |