Changelog and API docs corrected for 4.7.3.

CHANGES.md

@@ -5,25 +5,25 @@
 
 New Features:
 
-* [#568](https://github.com/ckeditor/ckeditor-dev/issues/568): Added possibility to adjust nested editables' filters using [`CKEDITOR.filter.disallowedContent`](https://docs.ckeditor.com/#!/api/CKEDITOR.filter-property-disallowedContent) property.
+* [#568](https://github.com/ckeditor/ckeditor-dev/issues/568): Added possibility to adjust nested editables' filters using the [`CKEDITOR.filter.disallowedContent`](https://docs.ckeditor.com/#!/api/CKEDITOR.filter-property-disallowedContent) property.
 
 Fixed Issues:
 
 * [#554](https://github.com/ckeditor/ckeditor-dev/issues/554): Fixed: [`change`](https://docs.ckeditor.com/#!/api/CKEDITOR.editor-event-change) event not fired when typing the first character after pasting into the editor. Thanks to [Daniel Miller](https://github.com/millerdev)!
-* [#566](https://github.com/ckeditor/ckeditor-dev/issues/566): Fixed: The CSS border shorthand property with zero width (`border: 0px solid #000;`) no longer causes table to have border attribute set to 1.
-* [#779](https://github.com/ckeditor/ckeditor-dev/issues/779): Fixed: [Remove Format](https://ckeditor.com/addon/removeformat) plugin removes elements with language definition inserted by [Language](https://ckeditor.com/addon/language) plugin.
-* [#423](https://github.com/ckeditor/ckeditor-dev/issues/423): Fixed: [Paste from Word](https://ckeditor.com/addon/pastefromword) plugin pastes paragraphs into the editor even if [`CKEDITOR.config.enterMode`](https://docs.ckeditor.com/#!/api/CKEDITOR.config-cfg-enterMode) is set to `CKEDITOR.ENTER_BR`.
-* [#719](https://github.com/ckeditor/ckeditor-dev/issues/719): Fixed: Image inserted using [Enhanced Image](https://ckeditor.com/addon/image2) plugin could be resized when editor is in read-only mode.
-* [#577](https://github.com/ckeditor/ckeditor-dev/issues/577): Fixed: "Delete Columns" command provided by [Table Tools](https://ckeditor.com/addon/tabletools) plugin throws an error while trying to delete columns.
-* [#867](https://github.com/ckeditor/ckeditor-dev/issues/867): Fixed: Typing into selected table throws an error.
-* [#817](https://github.com/ckeditor/ckeditor-dev/issues/817): Fixed: [Save](https://ckeditor.com/addon/save) plugin does not work in [Source Mode](https://ckeditor.com/addon/sourcearea).
+* [#566](https://github.com/ckeditor/ckeditor-dev/issues/566): Fixed: The CSS `border` shorthand property with zero width (`border: 0px solid #000;`) causes the table to have the border attribute set to 1.
+* [#779](https://github.com/ckeditor/ckeditor-dev/issues/779): Fixed: The [Remove Format](https://ckeditor.com/addon/removeformat) plugin removes elements with language definition inserted by the [Language](https://ckeditor.com/addon/language) plugin.
+* [#423](https://github.com/ckeditor/ckeditor-dev/issues/423): Fixed: The [Paste from Word](https://ckeditor.com/addon/pastefromword) plugin pastes paragraphs into the editor even if [`CKEDITOR.config.enterMode`](https://docs.ckeditor.com/#!/api/CKEDITOR.config-cfg-enterMode) is set to `CKEDITOR.ENTER_BR`.
+* [#719](https://github.com/ckeditor/ckeditor-dev/issues/719): Fixed: Image inserted using the [Enhanced Image](https://ckeditor.com/addon/image2) plugin can be resized when the editor is in [read-only mode](https://docs.ckeditor.com/#!/guide/dev_readonly).
+* [#577](https://github.com/ckeditor/ckeditor-dev/issues/577): Fixed: The "Delete Columns" command provided by the [Table Tools](https://ckeditor.com/addon/tabletools) plugin throws an error when trying to delete columns.
+* [#867](https://github.com/ckeditor/ckeditor-dev/issues/867): Fixed: Typing into a selected table throws an error.
+* [#817](https://github.com/ckeditor/ckeditor-dev/issues/817): Fixed: The [Save](https://ckeditor.com/addon/save) plugin does not work in [Source Mode](https://ckeditor.com/addon/sourcearea).
 
 Other Changes:
 
 * Updated the [WebSpellChecker](http://ckeditor.com/addon/wsc) plugin:
-	* [#40](https://github.com/WebSpellChecker/ckeditor-plugin-wsc/issues/40): Fixed: IE 10 throws an error when spell checking is started.
+	* [#40](https://github.com/WebSpellChecker/ckeditor-plugin-wsc/issues/40): Fixed: IE10 throws an error when spell checking is started.
 * [#800](https://github.com/ckeditor/ckeditor-dev/issues/800): Added the [`CKEDITOR.dom.selection.isCollapsed`](https://docs.ckeditor.com/#!/api/CKEDITOR.dom.selection-method-isCollapsed) method which is a simpler way to check if the selection is collapsed.
-* [#830](https://github.com/ckeditor/ckeditor-dev/issues/830): Added option to define which dialog tab should be shown by default when creating [`CKEDITOR.dialogCommand`](https://docs.ckeditor.com/#!/api/CKEDITOR.dialogCommand).
+* [#830](https://github.com/ckeditor/ckeditor-dev/issues/830): Added an option to define which dialog tab should be shown by default when creating [`CKEDITOR.dialogCommand`](https://docs.ckeditor.com/#!/api/CKEDITOR.dialogCommand).
 
 ## CKEditor 4.7.2
 

core/selection.js

@@ -2282,10 +2282,10 @@
 		},
 
 		/**
-		 * Checks if the selection contains only one range, which is collapsed.
+		 * Checks if the selection contains only one range which is collapsed.
 		 *
 		 *		if ( editor.getSelection().isCollapsed() ) {
-		 *			// Do something when selection is collapsed.
+		 *			// Do something when the selection is collapsed.
 		 *		}
 		 *
 		 * @since 4.7.3

core/tools.js

@@ -1463,12 +1463,12 @@
 		},
 
 		/**
-		 * Detects, which mouse button generated given DOM event
+		 * Detects which mouse button generated a given DOM event.
 		 *
 		 * @since 4.7.3
 		 * @param {CKEDITOR.dom.event} evt DOM event.
-		 * @returns {Number|Boolean} Returns number indicating mouse button or `false`
-		 * if mouse button can't be determined.
+		 * @returns {Number|Boolean} Returns a number indicating the mouse button or `false`
+		 * if the mouse button cannot be determined.
 		 */
 		getMouseButton: function( evt ) {
 			var evtData = evt.data,
@@ -1760,16 +1760,16 @@
 
 				/**
 				 * Parses the `border` CSS property shorthand format.
-				 * This CSS property doesn't support inherit (https://www.w3.org/TR/css3-background/#the-border-shorthands).
+				 * This CSS property does not support inheritance (https://www.w3.org/TR/css3-background/#the-border-shorthands).
 				 *
 				 *		console.log( CKEDITOR.tools.style.parse.border( '3px solid #ffeedd' ) );
 				 *		// Logs: { width: "3px", style: "solid", color: "#ffeedd" }
 				 *
 				 * @param {String} value The `border` property value.
 				 * @returns {Object}
-				 * @returns {String} return.width border-width attribute.
-				 * @returns {String} return.style border-style attribute.
-				 * @returns {String} return.color border-color attribute.
+				 * @returns {String} return.width The border-width attribute.
+				 * @returns {String} return.style The border-style attribute.
+				 * @returns {String} return.color The border-color attribute.
 				 * @member CKEDITOR.tools.style.parse
 				 */
 				border: function( value ) {

plugins/dialog/plugin.js

@@ -2986,7 +2986,7 @@ CKEDITOR.DIALOG_STATE_BUSY = 2;
 	/**
 	 * Generic dialog command. It opens a specific dialog when executed.
 	 *
-	 *		// Register the "link" command, which opens the "link" dialog.
+	 *		// Register the "link" command which opens the "link" dialog.
 	 *		editor.addCommand( 'link', new CKEDITOR.dialogCommand( 'link' ) );
 	 *
 	 * @class
@@ -2995,9 +2995,9 @@ CKEDITOR.DIALOG_STATE_BUSY = 2;
 	 * @param {String} dialogName The name of the dialog to open when executing
 	 * this command.
 	 * @param {Object} [ext] Additional command definition's properties.
-	 * @param {String} [ext.tabId] You can provide additional property (`tabId`) if you wish to open dialog on specific tabId.
+	 * @param {String} [ext.tabId] You can provide additional property (`tabId`) if you wish to open the dialog on a specific tabId.
 	 *
-	 *		// Open dialog on 'keystroke' tabId.
+	 *		// Open the dialog on the 'keystroke' tabId.
 	 *		editor.addCommand( 'keystroke', new CKEDITOR.dialogCommand( 'a11yHelp', { tabId: 'keystroke' } ) );
 	 */
 	CKEDITOR.dialogCommand = function( dialogName, ext ) {

plugins/undo/plugin.js

@@ -1050,7 +1050,7 @@
 		},
 
 		/**
-		 * Stop ignoring `input` events.
+		 * Stops ignoring `input` events.
 		 * @since 4.7.3
 		 */
 		activateInputEventListener: function() {

plugins/widget/plugin.js

@@ -4123,25 +4123,25 @@
  * This option is similar to {@link CKEDITOR.config#allowedContent} and one can
  * use it to limit the editor features available in the nested editable.
  *
- * If no `allowedContent` is specified, editable will use editor default
+ * If no `allowedContent` is specified, the editable will use the editor default
  * {@link CKEDITOR.editor#filter}.
  *
  * @property {CKEDITOR.filter.allowedContentRules} allowedContent
  */
 
 /**
  * The [Advanced Content Filter](#!/guide/dev_advanced_content_filter) rules
- * which will be used to blacklist elements withing this nested editable.
+ * which will be used to blacklist elements within this nested editable.
  * This option is similar to {@link CKEDITOR.config#disallowedContent}.
  *
- * Note that disallowedContent work on top of definition's {@link #allowedContent}.
+ * Note that `disallowedContent` work on top of the definition's {@link #allowedContent}.
  *
  * @since 4.7.3
  * @property {CKEDITOR.filter.disallowedContentRules} disallowedContent
  */
 
 /**
- * Nested editable name displayed in elements path.
+ * Nested editable name displayed in the elements path.
  *
  * @property {String} pathName
  */