X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=src%2Fsupport%2Fgettext.h;h=317feec82ec6ba5a78bb84a2ac172341baf3de37;hb=bf56e2c8e1afa857cd5e313c19948040e41b8227;hp=746b68281390982de2abb2c15dadc7c59a174611;hpb=f1cba8ff64b369792fd49f5ddf90e8126ab476ac;p=lyx.git

diff --git a/src/support/gettext.h b/src/support/gettext.h
index 746b682813..317feec82e 100644
--- a/src/support/gettext.h
+++ b/src/support/gettext.h
@@ -37,6 +37,10 @@ namespace lyx {
  * Remember to mention each of these files in "po/POFILES.in"
  *
  * The main() needs a locale_init() and a gettext_init() in the beginning.
+ *
+ * The various *_() methods accept only ASCII input, so they must not be used
+ * if the input may come from user supplied  files.
+ * translateIfPossible() should be used in that case.
  */
 
 /*
@@ -62,15 +66,17 @@ docstring const _(std::string const &);
 #  define N_(str) (str)              // for detecting static strings
 
 /**
- * Translate \p name if it is possible.
+ * Translate \p name to the GUI language if it is possible.
  * This should be used to translate strings that come from configuration
  * files like .ui files. These strings could already be in the native
  * language if they come from a file in the personal directory. */
 docstring const translateIfPossible(docstring const & name);
-
-///
-void locale_init();
-
+/**
+ * Translate \p name to \p language if it is possible.
+ * This should be used to translate strings that come from configuration
+ * files like .ui files. These strings could already be in the native
+ * language if they come from a file in the personal directory. */
+docstring const translateIfPossible(docstring const & name, std::string const & language);
 
 } // namespace lyx