X-Git-Url: https://git.immae.eu/?p=perso%2FImmae%2FProjets%2Fpackagist%2Fconnexionswing-ckeditor-component.git;a=blobdiff_plain;f=sources%2Fplugins%2Fscayt%2Fplugin.js;h=8c361b8077aea77d979e25fbb6411ec32ba0271e;hp=ef31526360e310f0ad5dd7d5b1263e9ac6c52a97;hb=3b35bd273a79f6b01fda7a246aed64aca147ea7a;hpb=7adcb81e4f83f98c468889aaa5a85558ba88c770

diff --git a/sources/plugins/scayt/plugin.js b/sources/plugins/scayt/plugin.js
index ef315263..8c361b80 100644
--- a/sources/plugins/scayt/plugin.js
+++ b/sources/plugins/scayt/plugin.js
@@ -264,7 +264,7 @@ CKEDITOR.plugins.add('scayt', {
 			plugin.destroy(editor);
 		};
 
-		/**
+		/*
 		 * Dirty fix for placeholder drag&drop
 		 * Should be fixed with next release
 		 */
@@ -320,7 +320,7 @@ CKEDITOR.plugins.add('scayt', {
 			if(inline_mode) {
 
 				if (!editor.config.scayt_inlineModeImmediateMarkup) {
-					/**
+					/*
 					 * Give an opportunity to CKEditor to perform all needed updates
 					 * and only after that call 'scaytDestroy' method (#72725)
 					 */
@@ -343,7 +343,7 @@ CKEDITOR.plugins.add('scayt', {
 
 			addMarkupStateHandlers();
 
-			/**
+			/*
 			 * 'mousedown' handler handle widget selection (click on widget). To
 			 * fix the issue when widget#wrapper referenced to element which can
 			 * be broken after markup.
@@ -433,7 +433,7 @@ CKEDITOR.plugins.add('scayt', {
 					var scaytInstance = editor.scayt,
 						scaytLangList = scaytInstance && scaytInstance.getScaytLangList();
 
-					/**
+					/*
 					 * Checks SCAYT initialization of LangList. To prevent immediate
 					 * markup which is triggered by 'startSpellCheck' event.
 					 * E.g.: Drop into inline CKEDITOR with scayt_autoStartup = true;
@@ -481,14 +481,14 @@ CKEDITOR.plugins.add('scayt', {
 			}
 		}, this, null, 50);
 
-		/**
+		/*
 		 * Main entry point to react on changes in document
 		 */
 		editor.on('reloadMarkupScayt', function(ev) {
 			var removeOptions = ev.data && ev.data.removeOptions,
 				timeout = ev.data && ev.data.timeout;
 
-			/**
+			/*
 			 * Perform removeMarkupInSelectionNode and 'startSpellCheck' fire
 			 * asynchroniosly and keep CKEDITOR flow as expected
 			 */
@@ -496,14 +496,14 @@ CKEDITOR.plugins.add('scayt', {
 				var scaytInstance = editor.scayt,
 					scaytLangList = scaytInstance && scaytInstance.getScaytLangList();
 
-				/**
+				/*
 				 * Checks SCAYT initialization of LangList. To prevent immediate
 				 * markup which is triggered by 'startSpellCheck' event.
 				 * E.g.: Drop into inline CKEDITOR with scayt_autoStartup = true;
 				 */
 				if (!scaytLangList || !(scaytLangList.ltr && scaytLangList.rtl)) return;
 
-				/**
+				/*
 				 * CKEditor can keep \u200B character in document (with selection#selectRanges)
 				 * we need to take care about that. For this case we fire
 				 * 'keydown' [left arrow], what will trigger 'removeFillingChar' on Webkit
@@ -1443,7 +1443,10 @@ CKEDITOR.on('scaytReady', function() {
 });
 
 /**
- * The parameter turns on/off SCAYT on the autostartup. If 'true', turns on SCAYT automatically after loading the editor.
+ * Automatically enables SCAYT on editor startup. When set to `true`, this option turns on SCAYT automatically
+ * after loading the editor.
+ *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
  *
  *		config.scayt_autoStartup = true;
  *
@@ -1452,36 +1455,44 @@ CKEDITOR.on('scaytReady', function() {
  */
 
 /**
- * The parameter turns on/off Grammar As You Type (GRAYT) on the SCAYT startup. If 'true', turns on GRAYT automatically after SCAYT started.
+ * Enables Grammar As You Type (GRAYT) on SCAYT startup. When set to `true`, this option turns on GRAYT automatically
+ * after SCAYT started.
+ *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
  *
  *		config.grayt_autoStartup = true;
  *
+ * @since 4.5.6
  * @cfg {Boolean} [grayt_autoStartup=false]
  * @member CKEDITOR.config
  */
 
 /**
- * The parameter turns on/off SCAYT initiation when Inline CKEditor is not focused. SCAYT markup is taken place (SCAYT instance is not destroyed)
- * in both Inline CKEditor's states, focused and unfocused.
+ * Enables SCAYT initialization when inline CKEditor is not focused. When set to `true`, SCAYT markup is
+ * displayed in both inline editor states, focused and unfocused, so the SCAYT instance is not destroyed.
+ *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
  *
  *		 config.scayt_inlineModeImmediateMarkup = true;
  *
+ * @since 4.5.6
  * @cfg {Boolean} [scayt_inlineModeImmediateMarkup=false]
  * @member CKEDITOR.config
  */
 
-
 /**
- * The parameter defines the number of SCAYT suggestions to show in the main context menu.
+ * Defines the number of SCAYT suggestions to show in the main context menu.
  * Possible values are:
  *
  * * `0` (zero) – No suggestions are shown in the main context menu. All
  *     entries will be listed in the "More Suggestions" sub-menu.
  * * Positive number – The maximum number of suggestions to show in the context
  *     menu. Other entries will be shown in the "More Suggestions" sub-menu.
- * * Negative number – 5 suggestions are shown in the main context menu. All other
+ * * Negative number – Five suggestions are shown in the main context menu. All other
  *     entries will be listed in the "More Suggestions" sub-menu.
  *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
+ *
  * Examples:
  *
  *		// Display only three suggestions in the main context menu.
@@ -1495,12 +1506,14 @@ CKEDITOR.on('scaytReady', function() {
  */
 
 /**
- * The parameter defines minimum length of the words that will be collected from editor's text for spell checking.
+ * Defines the minimum length of words that will be collected from the editor content for spell checking.
  * Possible value is any positive number.
  *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
+ *
  * Examples:
  *
- *		// Set minimum length of the words that will be collected from text.
+ *		// Set the minimum length of words that will be collected from editor text.
  *		config.scayt_minWordLength = 5;
  *
  * @cfg {Number} [scayt_minWordLength=4]
@@ -1508,9 +1521,11 @@ CKEDITOR.on('scaytReady', function() {
  */
 
 /**
- * The parameter sets the customer ID for SCAYT. Used for hosted users only. Required for migration from free
+ * Sets the customer ID for SCAYT. Used for hosted users only. Required for migration from free
  * to trial or paid versions.
  *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
+ *
  *		// Load SCAYT using my customer ID.
  *		config.scayt_customerId  = 'your-encrypted-customer-id';
  *
@@ -1519,9 +1534,11 @@ CKEDITOR.on('scaytReady', function() {
  */
 
 /**
- * The parameter enables/disables the "More Suggestions" sub-menu in the context menu.
+ * Enables and disables the "More Suggestions" sub-menu in the context menu.
  * Possible values are `'on'` and `'off'`.
  *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
+ *
  *		// Disables the "More Suggestions" sub-menu.
  *		config.scayt_moreSuggestions = 'off';
  *
@@ -1530,23 +1547,26 @@ CKEDITOR.on('scaytReady', function() {
  */
 
 /**
- * The parameter customizes the display of SCAYT context menu commands ("Add Word", "Ignore",
+ * Customizes the display of SCAYT context menu commands ("Add Word", "Ignore",
  * "Ignore All", "Options", "Languages", "Dictionaries" and "About").
  * This must be a string with one or more of the following
  * words separated by a pipe character (`'|'`):
  *
- * * `off` – disables all options.
- * * `all` – enables all options.
- * * `ignore` – enables the "Ignore" option.
- * * `ignoreall` – enables the "Ignore All" option.
- * * `add` – enables the "Add Word" option.
- * * `option` – enables "Options" menu item.
- * * `language` – enables "Languages" menu item.
- * * `dictionary` – enables "Dictionaries" menu item.
- * * `about` – enables "About" menu item.
- *
- * Note, that availability of 'Options', 'Languages' and 'Dictionaries' items
- * depends on scayt_uiTabs option also.
+ * * `off` – Disables all options.
+ * * `all` – Enables all options.
+ * * `ignore` – Enables the "Ignore" option.
+ * * `ignoreall` – Enables the "Ignore All" option.
+ * * `add` – Enables the "Add Word" option.
+ * * `option` – Enables the "Options" menu item.
+ * * `language` – Enables the "Languages" menu item.
+ * * `dictionary` – Enables the "Dictionaries" menu item.
+ * * `about` – Enables the "About" menu item.
+ *
+ * Please note that availability of the "Options", "Languages" and "Dictionaries" items
+ * also depends on the {@link CKEDITOR.config#scayt_uiTabs} option.
+ *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
+ *
  * Example:
  *
  *		// Show only "Add Word" and "Ignore All" in the context menu.
@@ -1557,12 +1577,14 @@ CKEDITOR.on('scaytReady', function() {
  */
 
 /**
- * The parameter sets the default spell checking language for SCAYT. Possible values are:
+ * Sets the default spell checking language for SCAYT. Possible values are:
  * `'en_US'`, `'en_GB'`, `'pt_BR'`, `'da_DK'`,
  * `'nl_NL'`, `'en_CA'`, `'fi_FI'`, `'fr_FR'`,
  * `'fr_CA'`, `'de_DE'`, `'el_GR'`, `'it_IT'`,
  * `'nb_NO'`, `'pt_PT'`, `'es_ES'`, `'sv_SE'`.
  *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
+ *
  *		// Sets SCAYT to German.
  *		config.scayt_sLang = 'de_DE';
  *
@@ -1571,11 +1593,13 @@ CKEDITOR.on('scaytReady', function() {
  */
 
 /**
- * The parameter customizes the SCAYT dialog and SCAYT toolbar menu to show particular tabs/items.
+ * Customizes the SCAYT dialog and SCAYT toolbar menu to show particular tabs and items.
  * This setting must contain a `1` (enabled) or `0`
  * (disabled) value for each of the following entries, in this precise order,
  * separated by a comma (`','`): `'Options'`, `'Languages'`, and `'Dictionary'`.
  *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
+ *
  *		// Hides the "Languages" tab.
  *		config.scayt_uiTabs = '1,0,1';
  *
@@ -1584,9 +1608,11 @@ CKEDITOR.on('scaytReady', function() {
  */
 
 /**
- * The parameter allows to specify protocol for WSC service (ssrv.cgi) full path.
+ * Sets the protocol for the WebSpellChecker service (`ssrv.cgi`) full path.
  *
- *		// Defines protocol for WSC service (ssrv.cgi) full path.
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
+ *
+ *		// Defines the protocol for the WebSpellChecker service (ssrv.cgi) path.
  *		config.scayt_serviceProtocol = 'https';
  *
  * @cfg {String} [scayt_serviceProtocol='http']
@@ -1594,9 +1620,11 @@ CKEDITOR.on('scaytReady', function() {
  */
 
 /**
- * The parameter allows to specify host for WSC service (ssrv.cgi) full path.
+ * Sets the host for the WebSpellChecker service (`ssrv.cgi`) full path.
+ *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
  *
- *		// Defines host for WSC service (ssrv.cgi) full path.
+ *		// Defines the host for the WebSpellChecker service (ssrv.cgi) path.
  *		config.scayt_serviceHost = 'my-host';
  *
  * @cfg {String} [scayt_serviceHost='svc.webspellchecker.net']
@@ -1604,9 +1632,11 @@ CKEDITOR.on('scaytReady', function() {
  */
 
 /**
- * The parameter allows to specify port for WSC service (ssrv.cgi) full path.
+ * Sets the port for the WebSpellChecker service (`ssrv.cgi`) full path.
  *
- *		// Defines port for WSC service (ssrv.cgi) full path.
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
+ *
+ *		// Defines the port for the WebSpellChecker service (ssrv.cgi) path.
  *		config.scayt_servicePort = '2330';
  *
  * @cfg {String} [scayt_servicePort='80']
@@ -1614,9 +1644,11 @@ CKEDITOR.on('scaytReady', function() {
  */
 
 /**
- * The parameter allows to specify path for WSC service (ssrv.cgi) full path.
+ * Sets the path to the WebSpellChecker service (`ssrv.cgi`).
+ *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
  *
- *		// Defines host for WSC service (ssrv.cgi) full path.
+ *		// Defines the path to the WebSpellChecker service (ssrv.cgi).
  *		config.scayt_servicePath = 'my-path/ssrv.cgi';
  *
  * @cfg {String} [scayt_servicePath='spellcheck31/script/ssrv.cgi']
@@ -1624,9 +1656,12 @@ CKEDITOR.on('scaytReady', function() {
  */
 
 /**
- * The parameter sets the URL to SCAYT core. Required to switch to the licensed version of SCAYT application.
+ * Sets the URL to SCAYT core. Required to switch to the licensed version of SCAYT.
  *
- * Further details available at [http://wiki.webspellchecker.net/doku.php?id=migration:hosredfreetolicensedck](http://wiki.webspellchecker.net/doku.php?id=migration:hosredfreetolicensedck)
+ * Refer to [SCAYT documentation](http://wiki.webspellchecker.net/doku.php?id=migration:hosredfreetolicensedck)
+ * for more details.
+ *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
  *
  *		config.scayt_srcUrl = "http://my-host/spellcheck/lf/scayt/scayt.js";
  *
@@ -1635,10 +1670,13 @@ CKEDITOR.on('scaytReady', function() {
  */
 
 /**
- * The parameter links SCAYT to custom dictionaries. This is a string containing dictionary IDs
+ * Links SCAYT to custom dictionaries. This is a string containing the dictionary IDs
  * separated by commas (`','`). Available only for the licensed version.
  *
- * Further details at [http://wiki.webspellchecker.net/doku.php?id=installationandconfiguration:customdictionaries:licensed](http://wiki.webspellchecker.net/doku.php?id=installationandconfiguration:customdictionaries:licensed)
+ * Refer to [SCAYT documentation](http://wiki.webspellchecker.net/doku.php?id=installationandconfiguration:customdictionaries:licensed)
+ * for more details.
+ *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
  *
  *		config.scayt_customDictionaryIds = '3021,3456,3478';
  *
@@ -1647,9 +1685,14 @@ CKEDITOR.on('scaytReady', function() {
  */
 
 /**
- * The parameter activates a User Dictionary in SCAYT. The user
+ * Activates a User Dictionary in SCAYT. The user
  * dictionary name must be used. Available only for the licensed version.
  *
+ * Refer to [SCAYT documentation](http://wiki.webspellchecker.net/doku.php?id=installationandconfiguration:userdictionaries)
+ * for more details.
+ *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
+ *
  *		config.scayt_userDictionaryName = 'MyDictionary';
  *
  * @cfg {String} [scayt_userDictionaryName='']
@@ -1657,14 +1700,16 @@ CKEDITOR.on('scaytReady', function() {
  */
 
 /**
- * The parameter defines the order SCAYT context menu items by groups.
+ * Defines the order of SCAYT context menu items by groups.
  * This must be a string with one or more of the following
  * words separated by a pipe character (`'|'`):
  *
- * * `suggest` – main suggestion word list,
- * * `moresuggest` – more suggestions word list,
+ * * `suggest` – The main suggestion word list.
+ * * `moresuggest` – The "More suggestions" word list.
  * * `control` – SCAYT commands, such as "Ignore" and "Add Word".
  *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
+ *
  * Example:
  *
  *		config.scayt_contextMenuItemsOrder = 'moresuggest|control|suggest';
@@ -1674,9 +1719,11 @@ CKEDITOR.on('scaytReady', function() {
  */
 
 /**
- * If set to `true` – overrides checkDirty functionality of CK
- * to fix SCAYT issues with incorrect checkDirty behavior. If set to `false`,
- * provides better performance on big preloaded text.
+ * If set to `true`, it overrides the {@link CKEDITOR.editor#checkDirty checkDirty} functionality of CKEditor
+ * to fix SCAYT issues with incorrect `checkDirty` behavior. If set to `false`,
+ * it provides better performance on big preloaded text.
+ *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
  *
  *		config.scayt_handleCheckDirty = 'false';
  *
@@ -1685,9 +1732,12 @@ CKEDITOR.on('scaytReady', function() {
  */
 
 /**
- * If set to `true` – overrides undo\redo functionality of CK
- * to fix SCAYT issues with incorrect undo\redo behavior. If set to `false`,
- * provides better performance on undo\redo text.
+ * Configures undo/redo behavior of SCAYT in CKEditor.
+ * If set to `true`, it overrides the undo/redo functionality of CKEditor
+ * to fix SCAYT issues with incorrect undo/redo behavior. If set to `false`,
+ * it provides better performance on text undo/redo.
+ *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
  *
  *		config.scayt_handleUndoRedo = 'false';
  *
@@ -1696,62 +1746,81 @@ CKEDITOR.on('scaytReady', function() {
  */
 
 /**
- * The parameter that turns off\on 'ignore-all-caps-words' option by default
- * It may be needed to disableOptionStorage for this parameter, because optionStorage has higher priority.
+ * Enables the "Ignore All-Caps Words" option by default.
+ * You may need to {@link CKEDITOR.config#scayt_disableOptionsStorage disable option storing} for this setting to be
+ * effective because option storage has a higher priority.
  *
- *		config.scayt_ignoreAllCapsWords = false;
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
  *
+ *		config.scayt_ignoreAllCapsWords = true;
+ *
+ * @since 4.5.6
  * @cfg {Boolean} [scayt_ignoreAllCapsWords=false]
  * @member CKEDITOR.config
  */
 
 /**
- * The parameter that turns off\on 'ignore-domain-names' option by default
- * It may be needed to disableOptionStorage for this parameter, because optionStorage has higher priority.
+ * Enables the "Ignore Domain Names" option by default.
+ * You may need to {@link CKEDITOR.config#scayt_disableOptionsStorage disable option storing} for this setting to be
+ * effective because option storage has a higher priority.
+ *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
  *
- *		config.scayt_ignoreDomainNames = false;
+ *		config.scayt_ignoreDomainNames = true;
  *
+ * @since 4.5.6
  * @cfg {Boolean} [scayt_ignoreDomainNames=false]
  * @member CKEDITOR.config
  */
 
 /**
- * The parameter that turns off\on 'ignore-words-with-mixed-cases' option by default
- * It may be needed to disableOptionStorage for this parameter, because optionStorage has higher priority.
+ * Enables the "Ignore Words with Mixed Case" option by default.
+ * You may need to {@link CKEDITOR.config#scayt_disableOptionsStorage disable option storing} for this setting to be
+ * effective because option storage has a higher priority.
  *
- *		config.scayt_ignoreWordsWithMixedCases = false;
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
  *
+ *		config.scayt_ignoreWordsWithMixedCases = true;
+ *
+ * @since 4.5.6
  * @cfg {Boolean} [scayt_ignoreWordsWithMixedCases=false]
  * @member CKEDITOR.config
  */
 
 /**
- * The parameter that turns off\on 'ignore-words-with-numbers' option by default
- * It may be needed to disableOptionStorage for this parameter, because optionStorage has higher priority.
+ * Enables the "Ignore Words with Numbers" option by default.
+ * You may need to {@link CKEDITOR.config#scayt_disableOptionsStorage disable option storing} for this setting to be
+ * effective because option storage has a higher priority.
+ *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
  *
- *		config.scayt_ignoreWordsWithNumbers = false;
+ *		config.scayt_ignoreWordsWithNumbers = true;
  *
+ * @since 4.5.6
  * @cfg {Boolean} [scayt_ignoreWordsWithNumbers=false]
  * @member CKEDITOR.config
  */
 
 /**
- * Disabling of SCAYT Options storing during several sessions. Options storing will be turned off after page refresh.
+ * Disables storing of SCAYT options between sessions. Option storing will be turned off after a page refresh.
+ * The following settings can be used:
+ *
+ * * `'options'` – Disables storing of all SCAYT Ignore options.
+ * * `'ignore-all-caps-words'` – Disables storing of the "Ignore All-Caps Words" option.
+ * * `'ignore-domain-names'` – Disables storing of the "Ignore Domain Names" option.
+ * * `'ignore-words-with-mixed-cases'` – Disables storing of the "Ignore Words with Mixed Case" option.
+ * * `'ignore-words-with-numbers'` – Disables storing of the "Ignore Words with Numbers" option.
+ * * `'lang'` – Disables storing of the SCAYT spell check language.
+ * * `'all'` – Disables storing of all SCAYT options.
  *
- * * `'options'` - disables all SCAYT Ignore options
- * * `'ignore-all-caps-words'` - disables 'Ignore All-Caps Words' option
- * * `'ignore-domain-names'` - disables 'Ignore Domain Names' option
- * * `'ignore-words-with-mixed-cases'` - disables 'Ignore Words with Mixed Case' option
- * * `'ignore-words-with-numbers'` - disables 'Ignore Words with Numbers' option
- * * `'lang'` - disables SCAYT spell check language storing
- * * `'all'` - disables all SCAYT options storing
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
  *
  * Example:
  *
- *		// One options disabling.
+ *		// Disabling one option.
  *		config.scayt_disableOptionsStorage = 'all';
  *
- *		// Several options disabling.
+ *		// Disabling several options.
  *  	config.scayt_disableOptionsStorage = ['lang', 'ignore-domain-names', 'ignore-words-with-numbers'];
  *
  *
@@ -1759,9 +1828,11 @@ CKEDITOR.on('scaytReady', function() {
  * @member CKEDITOR.config
  */
 
- /**
+/**
  * Specifies the names of tags that will be skipped while spell checking. This is a string containing tag names
- * separated by commas (`','`). Please note that `'style'` tag would be added to specified tags list.
+ * separated by commas (`','`). Please note that the `'style'` tag would be added to specified tags list.
+ *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
  *
  *		config.scayt_elementsToIgnore = 'del,pre';
  *
@@ -1769,8 +1840,10 @@ CKEDITOR.on('scaytReady', function() {
  * @member CKEDITOR.config
  */
 
- /**
- * The parameter turns on/off multi language support in SCAYT. If 'true', turns on SCAYT multi language support after loading the editor.
+/**
+ * Enables multi-language support in SCAYT. If set to `true`, turns on SCAYT multi-language support after loading the editor.
+ *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
  *
  *		config.scayt_multiLanguageMode = true;
  *
@@ -1778,18 +1851,22 @@ CKEDITOR.on('scaytReady', function() {
  * @member CKEDITOR.config
  */
 
- /**
- * Defines additional styles for misspellings for specified languages. Styles will be applied only if 'scayt_multiLanguageMode' parameter is set to 'true'
- * and 'language' plugin included and loaded into editor.  All misspellings still will be underlined with red waveline by default.
+/**
+ * Defines additional styles for misspellings for specified languages. Styles will be applied only if
+ * the {@link CKEDITOR.config#scayt_multiLanguageMode} option is set to `true` and the [Language](http://ckeditor.com/addon/language)
+ * plugin is included and loaded in the editor. By default, all misspellings will still be underlined with the red waveline.
+ *
+ * Read more in the [documentation](#!/guide/dev_spellcheck) and see the [SDK sample](http://sdk.ckeditor.com/samples/spellchecker.html).
  *
  * Example:
  *
- *		// Display misspellings in French language with green color and underlined with red waveline
+ *		// Display misspellings in French language with green color and underlined with red waveline.
  *		config.scayt_multiLanguageStyles = {
  *			'fr': 'color: green'
  *		};
  *
- *		// Display misspellings in Italian language with green color and underlined with red waveline and German misspellings with red color only
+ *		// Display misspellings in Italian language with green color and underlined with red waveline
+ *		// and German misspellings with red color only.
  *		config.scayt_multiLanguageStyles = {
  *			'it': 'color: green',
  *			'de': 'background-image: none; color: red'