Clarify docs about generic language codes

Fixes valentjn/ltex-ls#136.

package.nls.de.json

@@ -21,8 +21,8 @@
   "ltex.i18n.walkthrough.getInvolved.markdownPath": "walkthrough/de/getInvolved.md",
   "ltex.i18n.configuration.ltex.enabled.markdownDescription": "Steuert, ob die Erweiterung aktiviert ist. Erlaubt die Deaktivierung von LanguageTool für bestimmte Arbeitsbereiche oder für bestimmte Code-Sprachmodi (d. h. Dateitypen). [Weitere Informationen ...](https://valentjn.github.io/ltex/settings-de.html#ltexenabled)",
   "ltex.i18n.configuration.ltex.enabled.fullMarkdownDescription": "Steuert, ob die Erweiterung aktiviert ist. Erlaubt die Deaktivierung von LanguageTool für bestimmte Arbeitsbereiche oder für bestimmte Code-Sprachmodi (d. h. Dateitypen).\n\nSie können entweder einen Boolean-Wert angeben, der bestimmt, ob LTeX für alle unterstützten Auszeichnungssprachen aktiviert oder für alle deaktiviert wird, oder eine Liste von [Code-Sprachbezeichnern](https://code.visualstudio.com/docs/languages/identifiers), für die LTeX aktiviert werden soll (beachten Sie, dass Erweiterungen zusätzliche Code-Sprachbezeichner definieren können).\n\nAlle unterstützten Auszeichnungssprachen sind in der Voreinstellung dieser Einstellung aufgelistet. Zusätzlich kann LTeX Kommentare in vielen populären Programmiersprachen wie C++ oder Java überprüfen, wenn Sie die entsprechenden Code-Sprachbezeichner zu dieser Einstellung hinzufügen. Wenn Sie einen nicht-unterstützten Code-Sprachmodus hinzufügen, dann wird LTeX entsprechende Dateien als reinen Text ohne Parsen überprüfen.\n\n<!-- ltex-client-specific-de-begin -->\n\nDie Aktivierungsereignisse werden von dieser Einstellung nicht berührt. Das heißt, dass die Erweiterung aktiviert wird, sobald eine Datei mit einem unterstützten Code-Sprachmodus geöffnet wird. Falls Sie Dateien mit nicht-unterstützten Codi-Sprachmodi überprüfen wollen, müssen Sie eventuell die Erweiterung explizit mithilfe des Befehls [`LTeX: Aktiviere Erweiterung`](https://valentjn.github.io/ltex/vscode-ltex/commands-de.html#ltex-aktiviere-erweiterung) aktivieren.\n\nNach Änderungen muss LTeX neugestartet werden.\n\n<!-- ltex-client-specific-end -->",
-  "ltex.i18n.configuration.ltex.language.markdownDescription": "Die Sprache (z. B. `\"en-US\"`), mit der LanguageTool auf Fehler suchen soll. Benutzen Sie eine bestimmte Variante wie `\"en-US\"` oder `\"de-DE\"` anstelle des generischen Sprachcodes wie `\"en\"` oder `\"de\"`, um Rechtschreibfehler zu finden (zusätzlich zu Grammatikfehlern). [Weitere Informationen ...](https://valentjn.github.io/ltex/settings-de.html#ltexlanguage)",
-  "ltex.i18n.configuration.ltex.language.fullMarkdownDescription": "Die Sprache (z. B. `\"en-US\"`), mit der LanguageTool auf Fehler suchen soll. Benutzen Sie eine bestimmte Variante wie `\"en-US\"` oder `\"de-DE\"` anstelle des generischen Sprachcodes wie `\"en\"` oder `\"de\"`, um Rechtschreibfehler zu finden (zusätzlich zu Grammatikfehlern).\n\nWenn Sie den Sprachcode `\"auto\"` benutzen, dann wird LTeX versuchen, die Sprache des Dokuments zu erkennen. Dies wird nicht empfohlen, da nur generische Sprachen wie `\"en\"` oder `\"de\"` erkannt werden und daher keine Rechtschreibfehler gemeldet werden.",
+  "ltex.i18n.configuration.ltex.language.markdownDescription": "Die Sprache (z. B. `\"en-US\"`), mit der LanguageTool auf Fehler suchen soll. Falls möglich, benutzen Sie eine bestimmte Variante wie `\"en-US\"` oder `\"de-DE\"` anstelle des generischen Sprachcodes wie `\"en\"` oder `\"de\"`, um Rechtschreibfehler zu finden (zusätzlich zu Grammatikfehlern). [Weitere Informationen ...](https://valentjn.github.io/ltex/settings-de.html#ltexlanguage)",
+  "ltex.i18n.configuration.ltex.language.fullMarkdownDescription": "Die Sprache (z. B. `\"en-US\"`), mit der LanguageTool auf Fehler suchen soll. Falls möglich, benutzen Sie eine bestimmte Variante wie `\"en-US\"` oder `\"de-DE\"` anstelle des generischen Sprachcodes wie `\"en\"` oder `\"de\"`, um Rechtschreibfehler zu finden (zusätzlich zu Grammatikfehlern).\n\nWenn Sie den Sprachcode `\"auto\"` benutzen, dann wird LTeX versuchen, die Sprache des Dokuments zu erkennen. Dies wird nicht empfohlen, da nur generische Sprachen wie `\"en\"` oder `\"de\"` erkannt werden und eventuell keine Rechtschreibfehler gemeldet werden. Bei manchen generischen Sprachcodes wie `\"es\"` (Spanisch) werden Rechtschreibfehler gemeldet, obwohl die Sprachcodes generisch sind.",
   "ltex.i18n.configuration.ltex.language.auto.markdownEnumDescription": "Automatische Spracherkennung (nicht empfohlen)",
   "ltex.i18n.configuration.ltex.language.auto.enumDescription": "Automatische Spracherkennung (nicht empfohlen)",
   "ltex.i18n.configuration.ltex.language.ar.markdownEnumDescription": "Arabic",

package.nls.json

@@ -21,8 +21,8 @@
   "ltex.i18n.walkthrough.getInvolved.markdownPath": "walkthrough/en/getInvolved.md",
   "ltex.i18n.configuration.ltex.enabled.markdownDescription": "Controls whether the extension is enabled. Allows disabling LanguageTool on specific workspaces or for specific code language modes (i.e., file types). [More info...](https://valentjn.github.io/ltex/settings.html#ltexenabled)",
   "ltex.i18n.configuration.ltex.enabled.fullMarkdownDescription": "Controls whether the extension is enabled. Allows disabling LanguageTool on specific workspaces or for specific code language modes (i.e., file types).\n\nEither supply a Boolean value stating whether LTeX is enabled for all supported markup languages or disabled for all of them, or supply a list of [code language identifiers](https://code.visualstudio.com/docs/languages/identifiers) for which LTeX should be enabled (note that extensions can define additional code language identifiers).\n\nAll supported markup languages are listed in the default value of this setting. In addition, LTeX can check comments in many popular programming languages like C++ or Java, if you add the corresponding code language identifiers to this setting. If you add an unsupported code language mode, LTeX will check corresponding files as plain text without any parsing.\n\n<!-- ltex-client-specific-begin -->\n\nThe activation events are unaffected by this setting. This means that the extension will be activated whenever a file with a supported code language mode is opened. For unsupported code language modes, you may need to activate the extension explicitly by executing the [`LTeX: Activate Extension`](https://valentjn.github.io/ltex/vscode-ltex/commands.html#ltex-activate-extension) command.\n\nChanges require restarting LTeX to take effect.\n\n<!-- ltex-client-specific-end -->",
-  "ltex.i18n.configuration.ltex.language.markdownDescription": "The language (e.g., `\"en-US\"`) LanguageTool should check against. Use a specific variant like `\"en-US\"` or `\"de-DE\"` instead of the generic language code like `\"en\"` or `\"de\"` to obtain spelling corrections (in addition to grammar corrections). [More info...](https://valentjn.github.io/ltex/settings.html#ltexlanguage)",
-  "ltex.i18n.configuration.ltex.language.fullMarkdownDescription": "The language (e.g., `\"en-US\"`) LanguageTool should check against. Use a specific variant like `\"en-US\"` or `\"de-DE\"` instead of the generic language code like `\"en\"` or `\"de\"` to obtain spelling corrections (in addition to grammar corrections).\n\nWhen using the language code `\"auto\"`, LTeX will try to detect the language of the document. This is not recommended, as only generic languages like `\"en\"` or `\"de\"` will be detected and thus no spelling errors will be reported.",
+  "ltex.i18n.configuration.ltex.language.markdownDescription": "The language (e.g., `\"en-US\"`) LanguageTool should check against. If possible, use a specific variant like `\"en-US\"` or `\"de-DE\"` instead of the generic language code like `\"en\"` or `\"de\"` to obtain spelling corrections (in addition to grammar corrections). [More info...](https://valentjn.github.io/ltex/settings.html#ltexlanguage)",
+  "ltex.i18n.configuration.ltex.language.fullMarkdownDescription": "The language (e.g., `\"en-US\"`) LanguageTool should check against. If possible, use a specific variant like `\"en-US\"` or `\"de-DE\"` instead of the generic language code like `\"en\"` or `\"de\"` to obtain spelling corrections (in addition to grammar corrections).\n\nWhen using the language code `\"auto\"`, LTeX will try to detect the language of the document. This is not recommended, as only generic languages like `\"en\"` or `\"de\"` will be detected and thus no spelling errors might be reported. For some generic language codes like `\"es\"` (Spanish), spelling errors are reported even though the language codes are generic.",
   "ltex.i18n.configuration.ltex.language.auto.markdownEnumDescription": "Automatic language detection (not recommended)",
   "ltex.i18n.configuration.ltex.language.auto.enumDescription": "Automatic language detection (not recommended)",
   "ltex.i18n.configuration.ltex.language.ar.markdownEnumDescription": "Arabic",