Index: /CKEditor/trunk/_source/plugins/autogrow/plugin.js =================================================================== --- /CKEditor/trunk/_source/plugins/autogrow/plugin.js (revision 7155) +++ /CKEditor/trunk/_source/plugins/autogrow/plugin.js (revision 7156) @@ -60,8 +60,8 @@ })(); /** - * The minimum height to which the editor can reach using AutoGrow. + * The minimum height that the editor can reach using the AutoGrow feature. * @name CKEDITOR.config.autoGrow_minHeight * @type Number - * @default 200 + * @default 200 * @since 3.4 * @example @@ -70,8 +70,8 @@ /** - * The maximum height to which the editor can reach using AutoGrow. Zero means unlimited. + * The maximum height that the editor can reach using the AutoGrow feature. Zero means unlimited. * @name CKEDITOR.config.autoGrow_maxHeight * @type Number - * @default 0 + * @default 0 * @since 3.4 * @example @@ -83,6 +83,6 @@ * @name CKEDITOR.editor#autogrow * @event - * @param {Number} data.currentHeight The current height of the editor (before the resizing). - * @param {Number} data.newHeight The new height of the editor (after the resizing). It can be changed - * to determine another height to be used instead. + * @param {Number} data.currentHeight The current height of the editor (before resizing). + * @param {Number} data.newHeight The new height of the editor (after resizing). It can be changed + * to determine a different height value to be used instead. */ Index: /CKEditor/trunk/_source/plugins/basicstyles/plugin.js =================================================================== --- /CKEditor/trunk/_source/plugins/basicstyles/plugin.js (revision 7155) +++ /CKEditor/trunk/_source/plugins/basicstyles/plugin.js (revision 7156) @@ -45,57 +45,85 @@ /** - * The style definition to be used to apply the bold style in the text. + * The style definition that applies the bold style to the text. * @type Object + * @default { element : 'strong', overrides : 'b' } * @example * config.coreStyles_bold = { element : 'b', overrides : 'strong' }; * @example - * config.coreStyles_bold = { element : 'span', attributes : {'class': 'Bold'} }; + * config.coreStyles_bold = + * { + * element : 'span', + * attributes : { 'class' : 'Bold' } + * }; */ CKEDITOR.config.coreStyles_bold = { element : 'strong', overrides : 'b' }; /** - * The style definition to be used to apply the italic style in the text. + * The style definition that applies the italics style to the text. * @type Object - * @default { element : 'em', overrides : 'i' } + * @default { element : 'em', overrides : 'i' } * @example * config.coreStyles_italic = { element : 'i', overrides : 'em' }; * @example - * CKEDITOR.config.coreStyles_italic = { element : 'span', attributes : {'class': 'Italic'} }; + * CKEDITOR.config.coreStyles_italic = + * { + * element : 'span', + * attributes : { 'class' : 'Italic' } + * }; */ CKEDITOR.config.coreStyles_italic = { element : 'em', overrides : 'i' }; /** - * The style definition to be used to apply the underline style in the text. + * The style definition that applies the underline style to the text. * @type Object - * @default { element : 'u' } + * @default { element : 'u' } * @example - * CKEDITOR.config.coreStyles_underline = { element : 'span', attributes : {'class': 'Underline'}}; + * CKEDITOR.config.coreStyles_underline = + * { + * element : 'span', + * attributes : { 'class' : 'Underline' } + * }; */ CKEDITOR.config.coreStyles_underline = { element : 'u' }; /** - * The style definition to be used to apply the strike style in the text. + * The style definition that applies the strike-through style to the text. * @type Object - * @default { element : 'strike' } + * @default { element : 'strike' } * @example - * CKEDITOR.config.coreStyles_strike = { element : 'span', attributes : {'class': 'StrikeThrough'}, overrides : 'strike' }; + * CKEDITOR.config.coreStyles_strike = + * { + * element : 'span', + * attributes : { 'class' : 'StrikeThrough' }, + * overrides : 'strike' + * }; */ CKEDITOR.config.coreStyles_strike = { element : 'strike' }; /** - * The style definition to be used to apply the subscript style in the text. + * The style definition that applies the subscript style to the text. * @type Object - * @default { element : 'sub' } + * @default { element : 'sub' } * @example - * CKEDITOR.config.coreStyles_subscript = { element : 'span', attributes : {'class': 'Subscript'}, overrides : 'sub' }; + * CKEDITOR.config.coreStyles_subscript = + * { + * element : 'span', + * attributes : { 'class' : 'Subscript' }, + * overrides : 'sub' + * }; */ CKEDITOR.config.coreStyles_subscript = { element : 'sub' }; /** - * The style definition to be used to apply the superscript style in the text. + * The style definition that applies the superscript style to the text. * @type Object - * @default { element : 'sup' } + * @default { element : 'sup' } * @example - * CKEDITOR.config.coreStyles_superscript = { element : 'span', attributes : {'class': 'Superscript'}, overrides : 'sup' }; + * CKEDITOR.config.coreStyles_superscript = + * { + * element : 'span', + * attributes : { 'class' : 'Superscript' }, + * overrides : 'sup' + * }; */ CKEDITOR.config.coreStyles_superscript = { element : 'sup' }; Index: /CKEditor/trunk/_source/plugins/contextmenu/plugin.js =================================================================== --- /CKEditor/trunk/_source/plugins/contextmenu/plugin.js (revision 7155) +++ /CKEditor/trunk/_source/plugins/contextmenu/plugin.js (revision 7156) @@ -167,10 +167,11 @@ /** - * Whether to show the browser native context menu when the CTRL or the - * META (Mac) key is pressed while opening the context menu. + * Whether to show the browser native context menu when the Ctrl or + * Meta (Mac) key is pressed on opening the context menu with the + * right mouse button click or the Menu key. * @name CKEDITOR.config.browserContextMenuOnCtrl * @since 3.0.2 * @type Boolean - * @default true + * @default true * @example * config.browserContextMenuOnCtrl = false; Index: /CKEditor/trunk/_source/plugins/entities/plugin.js =================================================================== --- /CKEditor/trunk/_source/plugins/entities/plugin.js (revision 7155) +++ /CKEditor/trunk/_source/plugins/entities/plugin.js (revision 7156) @@ -47,6 +47,6 @@ /** - * Create a mapping table between one character and it's entity form from a list of entity names. - * @param reverse {Boolean} Whether create a reverse map from the entity string form to actual character. + * Create a mapping table between one character and its entity form from a list of entity names. + * @param reverse {Boolean} Whether to create a reverse map from the entity string form to an actual character. */ function buildTable( entities, reverse ) @@ -175,14 +175,14 @@ /** - * Whether to escape HTML preserved entities in text, including: + * Whether to escape basic HTML entities in the document, including: * - * Note: It should not be subjected to change unless you're outputting non-HTML data format like BBCode. - * @type Boolean - * @default true + * Note: It should not be subject to change unless when outputting a non-HTML data format like BBCode. + * @type Boolean + * @default true * @example * config.basicEntities = false; @@ -194,5 +194,5 @@ * @name CKEDITOR.config.entities * @type Boolean - * @default true + * @default true * @example * config.entities = false; @@ -202,9 +202,9 @@ /** * Whether to convert some Latin characters (Latin alphabet No. 1, ISO 8859-1) - * to HTML entities. The list of entities can be found at the + * to HTML entities. The list of entities can be found in the * W3C HTML 4.01 Specification, section 24.2.1. * @name CKEDITOR.config.entities_latin * @type Boolean - * @default true + * @default true * @example * config.entities_latin = false; @@ -215,9 +215,9 @@ * Whether to convert some symbols, mathematical symbols, and Greek letters to * HTML entities. This may be more relevant for users typing text written in Greek. - * The list of entities can be found at the + * The list of entities can be found in the * W3C HTML 4.01 Specification, section 24.3.1. * @name CKEDITOR.config.entities_greek * @type Boolean - * @default true + * @default true * @example * config.entities_greek = false; @@ -226,25 +226,25 @@ /** - * Whether to convert all remaining characters, not comprised in the ASCII - * character table, to their relative decimal numeric representation of HTML entity. - * When specified as the value 'force', it will simply convert all entities into the above form. - * For example, the phrase "This is Chinese: 汉语." is outputted + * Whether to convert all remaining characters not included in the ASCII + * character table to their relative decimal numeric representation of HTML entity. + * When set to force, it will convert all entities into this format. + * For example the phrase "This is Chinese: 汉语." is output * as "This is Chinese: 汉语." * @name CKEDITOR.config.entities_processNumerical * @type Boolean|String - * @default false + * @default false * @example * config.entities_processNumerical = true; - * config.entities_processNumerical = 'force'; //Convert from " " into " "; - */ - -/** - * An additional list of entities to be used. It's a string containing each - * entry separated by a comma. Entities names or number must be used, exclusing - * the "&" preffix and the ";" termination. + * config.entities_processNumerical = 'force'; //Converts from " " into " "; + */ + +/** + * A comma separated list of additional entities to be used. Entity names + * or numbers must be used in a form that excludes the "&" prefix and the ";" ending. * @name CKEDITOR.config.entities_additional - * @default '#39' // The single quote (') character. + * @default '#39' (The single quote (') character.) * @type String * @example + * config.entities_additional = '#1049'; // Adds Cyrillic capital letter Short I (Й). */ CKEDITOR.config.entities_additional = '#39';