Documented commandDef.readOnly and improved command and commandDef docs.

Author: Reinmar

core/command.js

@@ -13,6 +13,7 @@
  *		} );
  *
  * @class
+ * @extends CKEDITOR.commandDefinition
  * @mixins CKEDITOR.event
  * @constructor Creates a command class instance.
  * @param {CKEDITOR.editor} editor The editor instance this command will be
@@ -35,6 +36,9 @@ CKEDITOR.command = function( editor, commandDefinition ) {
 	 *
 	 *		command.exec(); // The command gets executed.
 	 *
+	 * **Note:** You should use the {@link CKEDITOR.editor#execCommand} method instead of calling
+	 * `command.exec()` directly.
+	 *
 	 * @param {Object} [data] Any data to pass to the command. Depends on the
 	 * command implementation and requirements.
 	 * @returns {Boolean} A boolean indicating that the command has been successfully executed.

core/commanddefinition.js

@@ -75,8 +75,9 @@
  *			editorFocus: false // The command doesn't require focusing the editing document.
  *		} );
  *
+ * See also {@link CKEDITOR.command#editorFocus}.
+ *
  * @property {Boolean} [editorFocus=true]
- * @see CKEDITOR.command#editorFocus
  */
 
 
@@ -134,6 +135,14 @@
  *			modes: { wysiwyg:1 } // Command is available in wysiwyg mode only.
  *		} );
  *
+ * See also {@link CKEDITOR.command#modes}.
+ *
  * @property {Object} [modes={ wysiwyg:1 }]
- * @see CKEDITOR.command#modes
+ */
+
+/**
+ * Whether the command should be enabled in the {@link CKEDITOR.editor#setReadOnly read-only mode}.
+ *
+ * @since 4.0
+ * @property {Boolean} [readOnly=false]
  */