Re: [PATCH 2/3] i18n: Only extract comments marked by special tag
From: Junio C Hamano <hidden>
Date: 2016-06-15 23:00:44
Subsystem:
documentation, the rest · Maintainers:
Jonathan Corbet, Linus Torvalds
Possibly related (same subject, not in this thread)
- 2016-06-15 · Re: [PATCH 2/3] i18n: Only extract comments marked by special tag · Jiang Xin <hidden>
- 2016-06-15 · Re: [PATCH 2/3] i18n: Only extract comments marked by special tag · Junio C Hamano <hidden>
- 2016-06-15 · [PATCH 2/3] i18n: Only extract comments marked by special tag · Jiang Xin <hidden>
- 2016-06-15 · Re: [PATCH 2/3] i18n: Only extract comments marked by special tag · Junio C Hamano <hidden>
Junio C Hamano [off-list ref] writes:
Documentation/CodingGuidelines may want to have a sentence of two to explain this, though.
After re-reading what I sent out, I realized that the way I singled out multi-line comments was misleading. Here is an updated version. -- >8 -- Subject: [PATCH] i18n: mention "TRANSLATORS:" marker in Documentation/CodingGuidelines These comments have to have "TRANSLATORS: " at the very beginning and have to deviate from the usual multi-line comment formatting convention. Signed-off-by: Junio C Hamano <redacted> --- Documentation/CodingGuidelines | 10 ++++++++++ 1 file changed, 10 insertions(+)
diff --git a/Documentation/CodingGuidelines b/Documentation/CodingGuidelines
index dab5c61..f9b8bff 100644
--- a/Documentation/CodingGuidelines
+++ b/Documentation/CodingGuidelines@@ -164,6 +164,16 @@ For C programs: * multi-line comment. */ + Note however that a comment that explains a translatable string to + translators uses a convention of starting with a magic token + "TRANSLATORS: " immediately after the opening delimiter, even when + it spans multiple lines. We do not add an asterisk at the beginning + of each line, either. E.g. + + /* TRANSLATORS: here is a comment that explains the string + to be translated, that follows immediately after it */ + _("Here is a translatable string explained by the above."); + - Double negation is often harder to understand than no negation at all.
--
1.9.2-651-g78816bc