trivial locale cleanups

Clarify the purpose of the `N_()` macro. Remove inconsistent capitalization of
two strings in the parser module.

po/de.po

@@ -1056,8 +1056,8 @@ msgid "'for' block"
 msgstr "'for'-Block"
 
 #: parser.cpp:77 parse_constants.h:265
-msgid "Block created by breakpoint"
+msgid "block created by breakpoint"
-msgstr ""
+msgstr "block created by breakpoint"
 
 #: parser.cpp:82 parse_constants.h:272
 msgid "'if' conditional block"
@@ -1097,8 +1097,8 @@ msgid "'begin' unconditional block"
 msgstr "'begin' unbedingter Block"
 
 #: parser.cpp:127 parse_constants.h:325
-msgid "Block created by the . builtin"
+msgid "block created by the . builtin"
-msgstr ""
+msgstr "block created by the . builtin"
 
 #: parser.cpp:132 parse_constants.h:330
 #, fuzzy

po/en.po

@@ -1050,8 +1050,8 @@ msgid "'for' block"
 msgstr "“for” block"
 
 #: parser.cpp:77 parse_constants.h:265
-msgid "Block created by breakpoint"
+msgid "block created by breakpoint"
-msgstr "Block created by breakpoint"
+msgstr "block created by breakpoint"
 
 #: parser.cpp:82 parse_constants.h:272
 msgid "'if' conditional block"
@@ -1090,8 +1090,8 @@ msgid "'begin' unconditional block"
 msgstr "“begin” unconditional block"
 
 #: parser.cpp:127 parse_constants.h:325
-msgid "Block created by the . builtin"
+msgid "block created by the . builtin"
-msgstr "Block created by the . builtin"
+msgstr "block created by the . builtin"
 
 #: parser.cpp:132 parse_constants.h:330
 msgid "event handler block"

po/fr.po

@@ -1069,7 +1069,7 @@ msgstr "bloc 'for'"
 
 #: parser.cpp:77 parse_constants.h:265
 #, fuzzy
-msgid "Block created by breakpoint"
+msgid "block created by breakpoint"
 msgstr "bloc créé par la commande interne '.'"
 
 #: parser.cpp:82 parse_constants.h:272
@@ -1110,7 +1110,7 @@ msgid "'begin' unconditional block"
 msgstr "bloc inconditionnel 'begin'"
 
 #: parser.cpp:127 parse_constants.h:325
-msgid "Block created by the . builtin"
+msgid "block created by the . builtin"
 msgstr "bloc créé par la commande interne '.'"
 
 #: parser.cpp:132 parse_constants.h:330

po/pt_BR.po

@@ -1063,8 +1063,8 @@ msgid "'for' block"
 msgstr "bloco “for”"
 
 #: parser.cpp:77 parse_constants.h:265
-msgid "Block created by breakpoint"
+msgid "block created by breakpoint"
-msgstr "Bloco criado por breakpoint"
+msgstr "bloco criado por breakpoint"
 
 #: parser.cpp:82 parse_constants.h:272
 msgid "'if' conditional block"
@@ -1104,8 +1104,8 @@ msgid "'begin' unconditional block"
 msgstr "bloco não condicional “begin”"
 
 #: parser.cpp:127 parse_constants.h:325
-msgid "Block created by the . builtin"
+msgid "block created by the . builtin"
-msgstr "Bloco criado pelo builtin ."
+msgstr "bloco criado pelo builtin ."
 
 #: parser.cpp:132 parse_constants.h:330
 #, fuzzy

po/sv.po

@@ -1061,8 +1061,8 @@ msgid "'for' block"
 msgstr "'for' block"
 
 #: parser.cpp:77 parse_constants.h:265
-msgid "Block created by breakpoint"
+msgid "block created by breakpoint"
-msgstr "Block skapat av det inbuggde kommandot breakpoint"
+msgstr "block skapat av det inbuggde kommandot breakpoint"
 
 #: parser.cpp:82 parse_constants.h:272
 msgid "'if' conditional block"
@@ -1101,8 +1101,8 @@ msgid "'begin' unconditional block"
 msgstr "'begin' ovillkorligen exekverat block"
 
 #: parser.cpp:127 parse_constants.h:325
-msgid "Block created by the . builtin"
+msgid "block created by the . builtin"
-msgstr "Block skapat av det inbyggda kommandot '.'"
+msgstr "block skapat av det inbyggda kommandot '.'"
 
 #: parser.cpp:132 parse_constants.h:330
 msgid "event handler block"

po/zh_CN.po

@@ -1039,8 +1039,8 @@ msgid "'for' block"
 msgstr "“for” block"
 
 #: parser.cpp:77 parse_constants.h:265
-msgid "Block created by breakpoint"
+msgid "block created by breakpoint"
-msgstr "Block created by breakpoint"
+msgstr "block created by breakpoint"
 
 #: parser.cpp:82 parse_constants.h:272
 msgid "'if' conditional block"
@@ -1079,8 +1079,8 @@ msgid "'begin' unconditional block"
 msgstr "“begin” unconditional block"
 
 #: parser.cpp:127 parse_constants.h:325
-msgid "Block created by the . builtin"
+msgid "block created by the . builtin"
-msgstr "Block created by the . builtin"
+msgstr "block created by the . builtin"
 
 #: parser.cpp:132 parse_constants.h:330
 msgid "event handler block"

src/common.h

@@ -229,8 +229,10 @@ void write_ignore(int fd, const void *buff, size_t count);
 /// Shorthand for wgettext call in situations where a C-style string is needed (e.g., fwprintf()).
 #define _(wstr) wgettext(wstr).c_str()
 
-/// Noop, used to tell xgettext that a string should be translated, even though it is not directly
+/// Noop, used to tell xgettext that a string should be translated. Use this when a string cannot be
-/// sent to wgettext.
+/// passed through wgettext() at the point where it is used. For example, when initializing a
+/// static array or structure. You must pass the string through wgettext() when it is used.
+/// See https://developer.gnome.org/glib/stable/glib-I18N.html#N-:CAPS
 #define N_(wstr) wstr
 
 /// Check if the specified string element is a part of the specified string list.

src/parser.cpp

@@ -37,7 +37,7 @@ class io_chain_t;
 #define FOR_BLOCK N_(L"'for' block")
 
 /// Breakpoint block.
-#define BREAKPOINT_BLOCK N_(L"Block created by breakpoint")
+#define BREAKPOINT_BLOCK N_(L"block created by breakpoint")
 
 /// If block description.
 #define IF_BLOCK N_(L"'if' conditional block")
@@ -67,7 +67,7 @@ class io_chain_t;
 #define BEGIN_BLOCK N_(L"'begin' unconditional block")
 
 /// Source block description.
-#define SOURCE_BLOCK N_(L"Block created by the . builtin")
+#define SOURCE_BLOCK N_(L"block created by the . builtin")
 
 /// Source block description.
 #define EVENT_BLOCK N_(L"event handler block")