Add translator comments to all strings introduced with input methods support.

diff --git a/source/NVDAHelper.py b/source/NVDAHelper.py
index 36de83f..5057172 100755 (executable)
--- a/source/NVDAHelper.py
+++ b/source/NVDAHelper.py
@@ -204,20 +204,39 @@ def nvdaControllerInternal_inputCandidateListUpdate(candidatesString,selectionIn
        return 0\r
 \r
 inputConversionModeMessages={\r
-       1:(_("Native input"),_("Alpha numeric input")),\r
-       8:(_("Full shaped mode"),_("Half shaped mode")),\r
+       1:(\r
+               # Translators: A mode  that allows typing in the actual 'native' characters for an east-Asian input method language currently selected, rather than alpha numeric (Roman/English) characters. \r
+               _("Native input"),\r
+               # Translators: a mode that lets you type in alpha numeric (roman/english) characters, rather than 'native' characters for the east-Asian input method  language currently selected.\r
+               _("Alpha numeric input")\r
+       ),\r
+       8:(\r
+               # Translators: for East-Asian input methods, a mode that allows typing in full-shaped (full double-byte) characters, rather than the smaller half-shaped ones.\r
+               _("Full shaped mode"),\r
+               # Translators: for East-Asian input methods, a mode that allows typing in half-shaped (single-byte) characters, rather than the larger full-shaped (double-byte) ones.\r
+               _("Half shaped mode")\r
+       ),\r
 }\r
 \r
 JapaneseInputConversionModeMessages= {\r
-        0: _("half alphanumeric"),\r
-        3: _("half katakana"),\r
-        8: _("alphanumeric"),\r
-        9: _("hiragana"),\r
+       # Translators: For Japanese character input: half-shaped (single-byte) alpha numeric (roman/english) mode.\r
+       0: _("half alphanumeric"),\r
+       # Translators: For Japanese character input: half-shaped (single-byte) Katacana input mode.\r
+       3: _("half katakana"),\r
+       # Translators: For Japanese character input: alpha numeric (roman/english) mode.\r
+       8: _("alphanumeric"),\r
+       # Translators: For Japanese character input: Hiragana input mode.\r
+       9: _("hiragana"),\r
+       # Translators: For Japanese character input: Katacana input mode.\r
        11: _("katakana"),\r
+       # Translators: For Japanese character input: half-shaped (single-byte) alpha numeric (roman/english) mode.\r
        16: _("half alphanumeric"),\r
        19: _("half katakana roman"),\r
+       # Translators: For Japanese character input: alpha numeric (roman/english) mode.\r
        24: _("alphanumeric"),\r
+       # Translators: For Japanese character input: Hiragana Roman input mode.\r
        25: _("hiragana roman"),\r
+       # Translators: For Japanese character input: Katacana Roman input mode.\r
        27: _("katakana roman"),\r
 } \r
 \r
@@ -258,6 +277,7 @@ def nvdaControllerInternal_inputLangChangeNotify(threadID,hkl,layoutString):
        languageID=hkl&0xffff\r
        buf=create_unicode_buffer(1024)\r
        res=windll.kernel32.GetLocaleInfoW(languageID,2,buf,1024)\r
+       # Translators: the label for an unknown language when switching input methods.\r
        inputLanguageName=buf.value if res else _("unknown language")\r
        layoutStringCodes=[]\r
        inputMethodName=None\r
@@ -282,6 +302,7 @@ def nvdaControllerInternal_inputLangChangeNotify(threadID,hkl,layoutString):
                        if inputMethodName: break\r
        if not inputMethodName:\r
                log.debugWarning("Could not find layout name for keyboard layout, reporting as unknown") \r
+               # Translators: The label for an unknown input method when switching input methods. \r
                inputMethodName=_("unknown input method")\r
        if ' - ' in inputMethodName:\r
                inputMethodName="".join(inputMethodName.split(' - ')[1:])\r

diff --git a/source/NVDAObjects/IAccessible/mscandui.py b/source/NVDAObjects/IAccessible/mscandui.py
index 44e13cd..074dbba 100755 (executable)
--- a/source/NVDAObjects/IAccessible/mscandui.py
+++ b/source/NVDAObjects/IAccessible/mscandui.py
@@ -35,7 +35,7 @@ class BaseCandidateItem(CandidateItemBehavior,IAccessible):
 \r
        def _get_parent(self):\r
                parent=super(BaseCandidateItem,self).parent\r
-               # Translators: The title of the input composition candidate list\r
+               # Translators: A label for a 'candidate' list which contains symbols the user can choose from  when typing east-asian characters into a document. \r
                parent.name=_("Candidate")\r
                parent.description=None\r
                return parent\r
@@ -158,7 +158,7 @@ class MSCandUIWindow_candidateListItem(MSCandUI_candidateListItem):
 \r
 class MSCandUIWindow(IAccessible):\r
 \r
-       # Translators: the title of the input composition candidate list\r
+       # Translators: A label for a 'candidate' list which contains symbols the user can choose from  when typing east-asian characters into a document.\r
        name=_("Candidate")\r
        role=controlTypes.ROLE_LIST\r
 \r

diff --git a/source/NVDAObjects/behaviors.py b/source/NVDAObjects/behaviors.py
index e0784f1..f9c5c4e 100755 (executable)
--- a/source/NVDAObjects/behaviors.py
+++ b/source/NVDAObjects/behaviors.py
@@ -355,7 +355,7 @@ class CandidateItem(NVDAObject):
                                if desc and desc[0]=='(' and desc[-1]==')':\r
                                        desc=desc[1:-1]\r
                                elif numSymbolDescriptions==1:\r
-                                       # Translators: a human friendly message used as the description for an input composition candidate symbol using both the symbol and its character description. \r
+                                       # Translators: a human friendly message used as the description for an input composition candidate symbol when typing east-Asian characters,  using both the symbol and its character description.\r
                                        desc=_("{symbol} as in {description}").format(symbol=symbol,description=desc)\r
                                descriptions.append(desc)\r
                if descriptions:\r

diff --git a/source/NVDAObjects/inputComposition.py b/source/NVDAObjects/inputComposition.py
index 24117c4..fea22a4 100644 (file)
--- a/source/NVDAObjects/inputComposition.py
+++ b/source/NVDAObjects/inputComposition.py
@@ -47,6 +47,7 @@ class InputCompositionTextInfo(OffsetsTextInfo):
 class InputComposition(EditableTextWithAutoSelectDetection,Window):\r
 \r
        TextInfo=InputCompositionTextInfo\r
+       # Translators: The label for a 'composition' Window that appears when the user is typing one or more east-Asian characters into a document. \r
        name=_("Composition")\r
        role=controlTypes.ROLE_EDITABLETEXT\r
        next=None\r
@@ -102,6 +103,7 @@ class InputComposition(EditableTextWithAutoSelectDetection,Window):
 \r
 class CandidateList(Window):\r
 \r
+       # Translators: The label for a 'candidate' list that shows a choice of symbols a user can choose from when typing east-Asian characters into a document.\r
        name=_("Candidate")\r
        role=controlTypes.ROLE_LIST\r
        next=None\r