diff -r 1779dc278077 -r 391d6b7b1eff eric6/Documentation/Source/eric6.Plugins.UiExtensionPlugins.Translator.TranslatorEngines.MicrosoftEngine.html
--- a/eric6/Documentation/Source/eric6.Plugins.UiExtensionPlugins.Translator.TranslatorEngines.MicrosoftEngine.html Wed Sep 25 19:40:31 2019 +0200
+++ b/eric6/Documentation/Source/eric6.Plugins.UiExtensionPlugins.Translator.TranslatorEngines.MicrosoftEngine.html Wed Sep 25 19:42:44 2019 +0200
@@ -18,29 +18,37 @@
</style>
</head>
-<body><a NAME="top" ID="top"></a>
+<body>
+<a NAME="top" ID="top"></a>
<h1>eric6.Plugins.UiExtensionPlugins.Translator.TranslatorEngines.MicrosoftEngine</h1>
+
<p>
Module implementing the Microsoft translation engine.
</p>
<h3>Global Attributes</h3>
+
<table>
<tr><td>None</td></tr>
</table>
<h3>Classes</h3>
+
<table>
+
<tr>
<td><a href="#MicrosoftEngine">MicrosoftEngine</a></td>
<td>Class implementing the translation engine for the Microsoft translation service.</td>
</tr>
</table>
<h3>Functions</h3>
+
<table>
<tr><td>None</td></tr>
</table>
-<hr /><hr />
+<hr />
+<hr />
<a NAME="MicrosoftEngine" ID="MicrosoftEngine"></a>
<h2>MicrosoftEngine</h2>
+
<p>
Class implementing the translation engine for the Microsoft
translation service.
@@ -48,185 +56,242 @@
<h3>Derived from</h3>
TranslationEngine
<h3>Class Attributes</h3>
+
<table>
<tr><td>AccessTokenUrl</td></tr><tr><td>TextToSpeechUrl</td></tr><tr><td>TranslatorUrl</td></tr>
</table>
<h3>Class Methods</h3>
+
<table>
<tr><td>None</td></tr>
</table>
<h3>Methods</h3>
+
<table>
+
<tr>
<td><a href="#MicrosoftEngine.__init__">MicrosoftEngine</a></td>
<td>Constructor</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#MicrosoftEngine.__getAccessToken">__getAccessToken</a></td>
<td>Private slot to get an access token.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#MicrosoftEngine.__getClientDataAzure">__getClientDataAzure</a></td>
<td>Private method to retrieve the client data.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#MicrosoftEngine.__mapLanguageCode">__mapLanguageCode</a></td>
<td>Private method to map a language code to the Microsoft code.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#MicrosoftEngine.engineName">engineName</a></td>
<td>Public method to return the name of the engine.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#MicrosoftEngine.getTextToSpeechData">getTextToSpeechData</a></td>
<td>Public method to pronounce the given text.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#MicrosoftEngine.getTranslation">getTranslation</a></td>
<td>Public method to translate the given text.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#MicrosoftEngine.hasTTS">hasTTS</a></td>
<td>Public method indicating the Text-to-Speech capability.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#MicrosoftEngine.supportedLanguages">supportedLanguages</a></td>
<td>Public method to get the supported languages.</td>
</tr>
</table>
<h3>Static Methods</h3>
+
<table>
<tr><td>None</td></tr>
</table>
+
<a NAME="MicrosoftEngine.__init__" ID="MicrosoftEngine.__init__"></a>
<h4>MicrosoftEngine (Constructor)</h4>
<b>MicrosoftEngine</b>(<i>plugin, parent=None</i>)
+
<p>
Constructor
-</p><dl>
+</p>
+<dl>
+
<dt><i>plugin</i></dt>
<dd>
reference to the plugin object (TranslatorPlugin)
-</dd><dt><i>parent</i></dt>
+</dd>
+<dt><i>parent</i></dt>
<dd>
reference to the parent object (QObject)
</dd>
-</dl><a NAME="MicrosoftEngine.__getAccessToken" ID="MicrosoftEngine.__getAccessToken"></a>
+</dl>
+<a NAME="MicrosoftEngine.__getAccessToken" ID="MicrosoftEngine.__getAccessToken"></a>
<h4>MicrosoftEngine.__getAccessToken</h4>
<b>__getAccessToken</b>(<i>requestObject</i>)
+
<p>
Private slot to get an access token.
-</p><p>
+</p>
+<p>
If the stored token is no longer valid, get a new one and store it.
-</p><dl>
+</p>
+<dl>
+
<dt><i>requestObject</i></dt>
<dd>
reference to the request object
(TranslatorRequest)
</dd>
-</dl><dl>
+</dl>
+<dl>
<dt>Returns:</dt>
<dd>
access token (string)
</dd>
-</dl><a NAME="MicrosoftEngine.__getClientDataAzure" ID="MicrosoftEngine.__getClientDataAzure"></a>
+</dl>
+<a NAME="MicrosoftEngine.__getClientDataAzure" ID="MicrosoftEngine.__getClientDataAzure"></a>
<h4>MicrosoftEngine.__getClientDataAzure</h4>
<b>__getClientDataAzure</b>(<i></i>)
+
<p>
Private method to retrieve the client data.
-</p><dl>
+</p>
+<dl>
<dt>Returns:</dt>
<dd>
tuple giving the API subscription key and a flag indicating
validity
</dd>
-</dl><dl>
+</dl>
+<dl>
<dt>Return Type:</dt>
<dd>
tuple of (str, bool)
</dd>
-</dl><a NAME="MicrosoftEngine.__mapLanguageCode" ID="MicrosoftEngine.__mapLanguageCode"></a>
+</dl>
+<a NAME="MicrosoftEngine.__mapLanguageCode" ID="MicrosoftEngine.__mapLanguageCode"></a>
<h4>MicrosoftEngine.__mapLanguageCode</h4>
<b>__mapLanguageCode</b>(<i>code</i>)
+
<p>
Private method to map a language code to the Microsoft code.
-</p><dl>
+</p>
+<dl>
+
<dt><i>code</i></dt>
<dd>
language code (string)
</dd>
-</dl><dl>
+</dl>
+<dl>
<dt>Returns:</dt>
<dd>
mapped language code (string)
</dd>
-</dl><a NAME="MicrosoftEngine.engineName" ID="MicrosoftEngine.engineName"></a>
+</dl>
+<a NAME="MicrosoftEngine.engineName" ID="MicrosoftEngine.engineName"></a>
<h4>MicrosoftEngine.engineName</h4>
<b>engineName</b>(<i></i>)
+
<p>
Public method to return the name of the engine.
-</p><dl>
+</p>
+<dl>
<dt>Returns:</dt>
<dd>
engine name (string)
</dd>
-</dl><a NAME="MicrosoftEngine.getTextToSpeechData" ID="MicrosoftEngine.getTextToSpeechData"></a>
+</dl>
+<a NAME="MicrosoftEngine.getTextToSpeechData" ID="MicrosoftEngine.getTextToSpeechData"></a>
<h4>MicrosoftEngine.getTextToSpeechData</h4>
<b>getTextToSpeechData</b>(<i>requestObject, text, language</i>)
+
<p>
Public method to pronounce the given text.
-</p><dl>
+</p>
+<dl>
+
<dt><i>requestObject</i></dt>
<dd>
reference to the request object
(TranslatorRequest)
-</dd><dt><i>text</i></dt>
+</dd>
+<dt><i>text</i></dt>
<dd>
text to be pronounced (string)
-</dd><dt><i>language</i></dt>
+</dd>
+<dt><i>language</i></dt>
<dd>
language code of the text (string)
</dd>
-</dl><dl>
+</dl>
+<dl>
<dt>Returns:</dt>
<dd>
tuple with pronounce data (QByteArray) or error string (string)
and success flag (boolean)
</dd>
-</dl><a NAME="MicrosoftEngine.getTranslation" ID="MicrosoftEngine.getTranslation"></a>
+</dl>
+<a NAME="MicrosoftEngine.getTranslation" ID="MicrosoftEngine.getTranslation"></a>
<h4>MicrosoftEngine.getTranslation</h4>
<b>getTranslation</b>(<i>requestObject, text, originalLanguage, translationLanguage</i>)
+
<p>
Public method to translate the given text.
-</p><dl>
+</p>
+<dl>
+
<dt><i>requestObject</i></dt>
<dd>
reference to the request object
(TranslatorRequest)
-</dd><dt><i>text</i></dt>
+</dd>
+<dt><i>text</i></dt>
<dd>
text to be translated (string)
-</dd><dt><i>originalLanguage</i></dt>
+</dd>
+<dt><i>originalLanguage</i></dt>
<dd>
language code of the original (string)
-</dd><dt><i>translationLanguage</i></dt>
+</dd>
+<dt><i>translationLanguage</i></dt>
<dd>
language code of the translation (string)
</dd>
-</dl><dl>
+</dl>
+<dl>
<dt>Returns:</dt>
<dd>
tuple of translated text (string) and flag indicating
success (boolean)
</dd>
-</dl><a NAME="MicrosoftEngine.hasTTS" ID="MicrosoftEngine.hasTTS"></a>
+</dl>
+<a NAME="MicrosoftEngine.hasTTS" ID="MicrosoftEngine.hasTTS"></a>
<h4>MicrosoftEngine.hasTTS</h4>
<b>hasTTS</b>(<i></i>)
+
<p>
Public method indicating the Text-to-Speech capability.
-</p><dl>
+</p>
+<dl>
<dt>Returns:</dt>
<dd>
flag indicating the Text-to-Speech capability (boolean)
</dd>
-</dl><a NAME="MicrosoftEngine.supportedLanguages" ID="MicrosoftEngine.supportedLanguages"></a>
+</dl>
+<a NAME="MicrosoftEngine.supportedLanguages" ID="MicrosoftEngine.supportedLanguages"></a>
<h4>MicrosoftEngine.supportedLanguages</h4>
<b>supportedLanguages</b>(<i></i>)
+
<p>
Public method to get the supported languages.
-</p><dl>
+</p>
+<dl>
<dt>Returns:</dt>
<dd>
list of supported language codes (list of string)
