diff --git a/core/command.js b/core/command.js index 11c15c4b987..5b922f84eed 100644 --- a/core/command.js +++ b/core/command.js @@ -105,7 +105,7 @@ CKEDITOR.command = function( editor, commandDefinition ) { * that if command implements {@link CKEDITOR.feature} interface it will be tested * by the {@link CKEDITOR.filter#checkFeature} method. * - * @since 4.1 + * @since 4.1.0 * @param {Boolean} [noCache] Skip cache for example due to active filter change. Since CKEditor 4.2. * @returns {Boolean} Whether this command is allowed. */ @@ -269,7 +269,7 @@ CKEDITOR.event.implementOn( CKEDITOR.command.prototype ); * @event state */ - /** +/** * @event refresh * @todo */ diff --git a/core/commanddefinition.js b/core/commanddefinition.js index 7724d10ee09..4c978a6f5f7 100644 --- a/core/commanddefinition.js +++ b/core/commanddefinition.js @@ -147,7 +147,7 @@ /** * Whether the command should be enabled in the {@link CKEDITOR.editor#setReadOnly read-only mode}. * - * @since 4.0 + * @since 4.0.0 * @property {Boolean} [readOnly=false] */ diff --git a/core/config.js b/core/config.js index d4a2f005de8..ddceba9eb5c 100644 --- a/core/config.js +++ b/core/config.js @@ -225,7 +225,7 @@ CKEDITOR.config = { * * config.bodyId = 'contents_id'; * - * @since 3.1 + * @since 3.1.0 * @cfg */ bodyId: '', @@ -245,7 +245,7 @@ CKEDITOR.config = { * * **Note:** This setting only applies to {@glink guide/dev_framed classic editor} (the one that uses `iframe`). * - * @since 3.1 + * @since 3.1.0 * @cfg */ bodyClass: '', @@ -261,7 +261,7 @@ CKEDITOR.config = { * * config.fullPage = true; * - * @since 3.1 + * @since 3.1.0 * @cfg */ fullPage: false, @@ -428,7 +428,7 @@ CKEDITOR.config = { * * config.useComputedState = false; * - * @since 3.4 + * @since 3.4.0 * @cfg {Boolean} [useComputedState=true] */ diff --git a/core/dom/document.js b/core/dom/document.js index 79dc445d58f..990ed23dee7 100644 --- a/core/dom/document.js +++ b/core/dom/document.js @@ -258,7 +258,7 @@ CKEDITOR.tools.extend( CKEDITOR.dom.document.prototype, { * '' * ); * - * @since 3.5 + * @since 3.5.0 * @param {String} html The HTML defining the document content. */ write: function( html ) { @@ -283,7 +283,7 @@ CKEDITOR.tools.extend( CKEDITOR.dom.document.prototype, { * * **Note:** The returned list is not a live collection (like the result of native `querySelectorAll`). * - * @since 4.3 + * @since 4.3.0 * @param {String} selector A valid [CSS selector](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors). * @returns {CKEDITOR.dom.nodeList} */ @@ -295,7 +295,7 @@ CKEDITOR.tools.extend( CKEDITOR.dom.document.prototype, { * Wrapper for `querySelector`. Returns the first element within this document that matches * the specified `selector`. * - * @since 4.3 + * @since 4.3.0 * @param {String} selector A valid [CSS selector](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors). * @returns {CKEDITOR.dom.element} */ @@ -308,7 +308,7 @@ CKEDITOR.tools.extend( CKEDITOR.dom.document.prototype, { /** * Internet Explorer 8 only method. It returns a document fragment which has all HTML5 elements enabled. * - * @since 4.3 + * @since 4.3.0 * @private * @returns DocumentFragment */ diff --git a/core/dom/documentfragment.js b/core/dom/documentfragment.js index 7a5af155c8e..3d6448cca5a 100644 --- a/core/dom/documentfragment.js +++ b/core/dom/documentfragment.js @@ -45,7 +45,7 @@ CKEDITOR.tools.extend( CKEDITOR.dom.documentFragment.prototype, CKEDITOR.dom.ele /** * Gets the HTML of this document fragment's children. * - * @since 4.5 + * @since 4.5.0 * @returns {String} The HTML of this document fragment's children. */ getHtml: function() { diff --git a/core/dom/element.js b/core/dom/element.js index 5fc9b1a9e88..ea5d733918f 100644 --- a/core/dom/element.js +++ b/core/dom/element.js @@ -2028,7 +2028,7 @@ CKEDITOR.dom.element.clearMarkers = function( database, element, removeFromDatab * Method: div.find( 'body i' ) // -> [] * div.find( 'i' ) // -> [ foo ] * - * @since 4.3 + * @since 4.3.0 * @param {String} selector A valid [CSS selector](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors). * @returns {CKEDITOR.dom.nodeList} */ @@ -2056,7 +2056,7 @@ CKEDITOR.dom.element.clearMarkers = function( database, element, removeFromDatab * Method: div.findOne( 'body i' ) // -> null * div.findOne( 'i' ) // -> foo * - * @since 4.3 + * @since 4.3.0 * @param {String} selector A valid [CSS selector](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors). * @returns {CKEDITOR.dom.element} */ @@ -2085,7 +2085,7 @@ CKEDITOR.dom.element.clearMarkers = function( database, element, removeFromDatab * // 5. "bar" text node, * // 6. "bom" text node. * - * @since 4.3 + * @since 4.3.0 * @param {Function} callback Function to be executed on every node. * If `callback` returns `false` descendants of the node will be ignored. * @param {CKEDITOR.htmlParser.node} callback.node Node passed as argument. diff --git a/core/dom/iterator.js b/core/dom/iterator.js index 5721c6f9116..58704242639 100755 --- a/core/dom/iterator.js +++ b/core/dom/iterator.js @@ -70,7 +70,7 @@ /** * Default iterator's filter. It is set only for nested iterators. * - * @since 4.3 + * @since 4.3.0 * @readonly * @property {CKEDITOR.filter} filter */ @@ -79,7 +79,7 @@ * Iterator's active filter. It is set by the {@link #getNextParagraph} method * when it enters a nested editable. * - * @since 4.3 + * @since 4.3.0 * @readonly * @property {CKEDITOR.filter} activeFilter */ diff --git a/core/dom/node.js b/core/dom/node.js index b428c979668..4212107f729 100644 --- a/core/dom/node.js +++ b/core/dom/node.js @@ -864,7 +864,7 @@ CKEDITOR.tools.extend( CKEDITOR.dom.node.prototype, { * you can temporarily attach this tree to an element with the `data-cke-editable` attribute and use the * `checkOnlyAttributes` mode. * - * @since 3.5 + * @since 3.5.0 * @param {Boolean} [checkOnlyAttributes=false] If `true`, only attributes will be checked, native methods will not * be used. This parameter needs to be `true` to check hidden or detached elements. Introduced in 4.5. * @returns {Boolean} diff --git a/core/dom/range.js b/core/dom/range.js index dbaaf4f9a44..277d9bfd0e5 100644 --- a/core/dom/range.js +++ b/core/dom/range.js @@ -2574,7 +2574,7 @@ CKEDITOR.dom.range = function( root ) { * * See also: {@link #moveToElementEditablePosition}. * - * @since 4.3 + * @since 4.3.0 * @param {CKEDITOR.dom.element} [element] The starting element. If not specified, the current range * position will be used. * @param {Boolean} [isMoveForward] Whether move to the end of editable. Otherwise, look back. @@ -2710,7 +2710,7 @@ CKEDITOR.dom.range = function( root ) { * * Note: use this method on a collapsed range. * - * @since 4.3 + * @since 4.3.0 * @returns {CKEDITOR.dom.element/CKEDITOR.dom.text} */ getNextEditableNode: getNextEditableNode(), @@ -2718,7 +2718,7 @@ CKEDITOR.dom.range = function( root ) { /** * See {@link #getNextEditableNode}. * - * @since 4.3 + * @since 4.3.0 * @returns {CKEDITOR.dom.element/CKEDITOR.dom.text} */ getPreviousEditableNode: getNextEditableNode( 1 ), @@ -2729,7 +2729,7 @@ CKEDITOR.dom.range = function( root ) { * table, but it cannot be two different tables on the same DOM level). * * @private - * @since 4.7 + * @since 4.7.0 * @param {Object} [tableElements] Mapping of element names that should be considered. * @returns {CKEDITOR.dom.element/null} */ diff --git a/core/dom/walker.js b/core/dom/walker.js index 472246bfb4f..04228c16665 100644 --- a/core/dom/walker.js +++ b/core/dom/walker.js @@ -475,7 +475,7 @@ * Returns a function which checks whether the node is a temporary element * (element with the `data-cke-temp` attribute) or its child. * - * @since 4.3 + * @since 4.3.0 * @static * @param {Boolean} [isReject=false] Whether to return `false` for the * temporary element instead of `true` (default). @@ -511,7 +511,7 @@ * * bookmarks (see {@link CKEDITOR.dom.walker#bookmark}), * * temporary elements (see {@link CKEDITOR.dom.walker#temp}). * - * @since 4.3 + * @since 4.3.0 * @static * @param {Boolean} [isReject=false] Whether to return `false` for the * ignored element instead of `true` (default). @@ -530,7 +530,7 @@ /** * Returns a function which checks whether the node is empty. * - * @since 4.5 + * @since 4.5.0 * @static * @param {Boolean} [isReject=false] Whether to return `false` for the * ignored element instead of `true` (default). @@ -568,7 +568,7 @@ * A hash of element names which in browsers that {@link CKEDITOR.env#needsBrFiller do not need `
` fillers} * can be selection containers despite being empty. * - * @since 4.5 + * @since 4.5.0 * @static * @property {Object} validEmptyBlockContainers */ @@ -617,7 +617,7 @@ * * empty {@link #validEmptyBlockContainers blocks} which can contain text * ({@link CKEDITOR.env#needsBrFiller old IEs only}). * - * @since 4.3 + * @since 4.3.0 * @static * @param {Boolean} [isReject=false] Whether to return `false` for the * ignored element instead of `true` (default). diff --git a/core/editable.js b/core/editable.js index f6cc4089c6b..675d19e1cf6 100644 --- a/core/editable.js +++ b/core/editable.js @@ -268,7 +268,7 @@ /** * Transforms plain text to HTML based on current selection and {@link CKEDITOR.editor#activeEnterMode}. * - * @since 4.5 + * @since 4.5.0 * @param {String} text Text to transform. * @returns {String} HTML generated from the text. */ @@ -329,7 +329,7 @@ * * Fires the {@link CKEDITOR.editor#event-afterInsertHtml} event. * - * @since 4.5 + * @since 4.5.0 * @param {String} data HTML code to be inserted into the editor. * @param {CKEDITOR.dom.range} range The range as a place of insertion. * @param {String} [mode='html'] Mode in which HTML will be inserted. @@ -652,7 +652,7 @@ /** * The base of the {@link CKEDITOR.editor#getSelectedHtml} method. * - * @since 4.5 + * @since 4.5.0 * @method getHtmlFromRange * @param {CKEDITOR.dom.range} range * @returns {CKEDITOR.dom.documentFragment} @@ -687,7 +687,7 @@ * **Note:** The range is modified so it matches the desired selection after extraction * even though the selection is not made. * - * @since 4.5 + * @since 4.5.0 * @param {CKEDITOR.dom.range} range * @param {Boolean} [removeEmptyBlock=false] See {@link CKEDITOR.editor#extractSelectedHtml}'s parameter. * Note that the range will not be modified if this parameter is set to `true`. diff --git a/core/editor.js b/core/editor.js index 21de9947763..da888842647 100644 --- a/core/editor.js +++ b/core/editor.js @@ -112,7 +112,7 @@ * * **ready**: The editor is fully initialized and ready — see the {@link CKEDITOR.editor#instanceReady} event. * * **destroyed**: The editor was destroyed — see the {@link CKEDITOR.editor#method-destroy} method. * - * @since 4.1 + * @since 4.1.0 * @readonly * @property {String} */ @@ -338,7 +338,7 @@ * Indicates the read-only state of this editor. This is a read-only property. * See also {@link CKEDITOR.editor#setReadOnly}. * - * @since 3.6 + * @since 3.6.0 * @readonly * @property {Boolean} */ @@ -454,7 +454,7 @@ * **Note:** Please do not confuse this property with {@link CKEDITOR.editor#name editor.name} * which identifies the instance in the {@link CKEDITOR#instances} literal. * - * @since 4.2 + * @since 4.2.0 * @readonly * @property {String/Boolean} */ @@ -1154,7 +1154,7 @@ * * **Note:** The current editing area will be reloaded. * - * @since 3.6 + * @since 3.6.0 * @param {Boolean} [isReadOnly] Indicates that the editor must go * read-only (`true`, default) or be restored and made editable (`false`). */ @@ -1215,7 +1215,7 @@ * in the {@link #event-insertText} event's listener with a default priority (10) so you can add listeners with * lower or higher priorities in order to execute some code before or after the text is inserted. * - * @since 3.5 + * @since 3.5.0 * @param {String} text Text to be inserted into the editor. */ insertText: function( text ) { @@ -1257,7 +1257,7 @@ * * the {@link #extractSelectedHtml} method, * * the {@link CKEDITOR.editable#getHtmlFromRange} method. * - * @since 4.5 + * @since 4.5.0 * @param {Boolean} [toString] If `true`, then stringified HTML will be returned. * @returns {CKEDITOR.dom.documentFragment/String} */ @@ -1285,7 +1285,7 @@ * * the {@link #getSelectedHtml} method, * * the {@link CKEDITOR.editable#extractHtmlFromRange} method. * - * @since 4.5 + * @since 4.5.0 * @param {Boolean} [toString] If `true`, then stringified HTML will be returned. * @param {Boolean} [removeEmptyBlock=false] Default `false` means that the function will keep an empty block (if the * entire content was removed) or it will create it (if a block element was removed) and set the selection in that block. @@ -1396,7 +1396,7 @@ * * You can then set new keystrokes using this method during the runtime. * - * @since 4.0 + * @since 4.0.0 * @param {Number/Array} keystroke A keystroke or an array of keystroke definitions. * @param {String/Boolean} [behavior] A command to be executed on the keystroke. */ @@ -1464,7 +1464,7 @@ /** * Shorthand for {@link CKEDITOR.filter#addFeature}. * - * @since 4.1 + * @since 4.1.0 * @param {CKEDITOR.feature} feature See {@link CKEDITOR.filter#addFeature}. * @returns {Boolean} See {@link CKEDITOR.filter#addFeature}. */ @@ -1483,7 +1483,7 @@ * Setting a new filter will also change the {@link #setActiveEnterMode active Enter modes} to the first values * allowed by the new filter (see {@link CKEDITOR.filter#getAllowedEnterMode}). * - * @since 4.3 + * @since 4.3.0 * @param {CKEDITOR.filter} filter Filter instance or a falsy value (e.g. `null`) to reset to the default one. */ setActiveFilter: function( filter ) { @@ -1534,7 +1534,7 @@ * **Note:** Changing the {@link #activeFilter active filter} may cause the Enter mode to change if default Enter modes * are not allowed by the new filter. * - * @since 4.3 + * @since 4.3.0 * @param {Number} enterMode One of {@link CKEDITOR#ENTER_P}, {@link CKEDITOR#ENTER_DIV}, {@link CKEDITOR#ENTER_BR}. * Pass falsy value (e.g. `null`) to reset the Enter mode to the default value ({@link #enterMode} and/or {@link #shiftEnterMode}). * @param {Number} shiftEnterMode See the `enterMode` argument. @@ -1563,7 +1563,7 @@ * * See {@link CKEDITOR.plugins.notification}. * - * @since 4.5 + * @since 4.5.0 * @member CKEDITOR.editor * @param {String} message The message displayed in the notification. * @param {String} [type='info'] The type of the notification. Can be `'info'`, `'warning'`, `'success'` or `'progress'`. @@ -1660,7 +1660,7 @@ CKEDITOR.ELEMENT_MODE_INLINE = 3; * * config.htmlEncodeOutput = true; * - * @since 3.1 + * @since 3.1.0 * @cfg {Boolean} [htmlEncodeOutput=false] * @member CKEDITOR.config */ @@ -1674,7 +1674,7 @@ CKEDITOR.ELEMENT_MODE_INLINE = 3; * * config.readOnly = true; * - * @since 3.6 + * @since 3.6.0 * @cfg {Boolean} [readOnly=false] * @member CKEDITOR.config * @see CKEDITOR.editor#setReadOnly @@ -1727,7 +1727,7 @@ CKEDITOR.ELEMENT_MODE_INLINE = 3; * * CKEDITOR.editor#name * * CKEDITOR.editor#title * - * @since 4.2 + * @since 4.2.0 * @cfg {String/Boolean} [title=based on editor.name] * @member CKEDITOR.config */ @@ -1803,7 +1803,7 @@ CKEDITOR.ELEMENT_MODE_INLINE = 3; * It points to a {@link CKEDITOR.filter} instance set up based on * editor configuration. * - * @since 4.1 + * @since 4.1.0 * @readonly * @property {CKEDITOR.filter} filter */ @@ -1824,7 +1824,7 @@ CKEDITOR.ELEMENT_MODE_INLINE = 3; * * See also the {@link #setActiveEnterMode} method for an explanation of dynamic settings. * - * @since 4.3 + * @since 4.3.0 * @readonly * @property {CKEDITOR.filter} activeFilter */ @@ -1834,7 +1834,7 @@ CKEDITOR.ELEMENT_MODE_INLINE = 3; * Currently only one rule exists — {@link #blockless blockless editors} may have * Enter modes set only to {@link CKEDITOR#ENTER_BR}. * - * @since 4.3 + * @since 4.3.0 * @readonly * @property {Number} enterMode */ @@ -1842,7 +1842,7 @@ CKEDITOR.ELEMENT_MODE_INLINE = 3; /** * See the {@link #enterMode} property. * - * @since 4.3 + * @since 4.3.0 * @readonly * @property {Number} shiftEnterMode */ @@ -1853,7 +1853,7 @@ CKEDITOR.ELEMENT_MODE_INLINE = 3; * * See also the {@link #setActiveEnterMode} method for an explanation of dynamic settings. * - * @since 4.3 + * @since 4.3.0 * @readonly * @property {Number} activeEnterMode */ @@ -1861,7 +1861,7 @@ CKEDITOR.ELEMENT_MODE_INLINE = 3; /** * See the {@link #activeEnterMode} property. * - * @since 4.3 + * @since 4.3.0 * @readonly * @property {Number} activeShiftEnterMode */ @@ -1869,7 +1869,7 @@ CKEDITOR.ELEMENT_MODE_INLINE = 3; /** * Event fired by the {@link #setActiveFilter} method when the {@link #activeFilter} is changed. * - * @since 4.3 + * @since 4.3.0 * @event activeFilterChange */ @@ -1877,7 +1877,7 @@ CKEDITOR.ELEMENT_MODE_INLINE = 3; * Event fired by the {@link #setActiveEnterMode} method when any of the active Enter modes is changed. * See also the {@link #activeEnterMode} and {@link #activeShiftEnterMode} properties. * - * @since 4.3 + * @since 4.3.0 * @event activeEnterModeChange */ @@ -1939,7 +1939,7 @@ CKEDITOR.ELEMENT_MODE_INLINE = 3; * by the `stylesheetparser` plugin. Thus, to be notified when all * styles are ready, you can listen on this event. * - * @since 4.1 + * @since 4.1.0 * @event stylesSet * @param {CKEDITOR.editor} editor This editor instance. * @param {Array} styles An array of styles definitions. @@ -2115,7 +2115,7 @@ CKEDITOR.ELEMENT_MODE_INLINE = 3; * Event fired after data insertion using the {@link #method-insertHtml}, {@link CKEDITOR.editable#insertHtml}, * or {@link CKEDITOR.editable#insertHtmlIntoRange} methods. * - * @since 4.5 + * @since 4.5.0 * @event afterInsertHtml * @param data * @param {CKEDITOR.dom.range} [data.intoRange] If set, the HTML was not inserted into the current selection, but into @@ -2126,7 +2126,7 @@ CKEDITOR.ELEMENT_MODE_INLINE = 3; /** * Event fired after the {@link #property-readOnly} property changes. * - * @since 3.6 + * @since 3.6.0 * @event readOnly * @param {CKEDITOR.editor} editor This editor instance. */ @@ -2193,7 +2193,7 @@ CKEDITOR.ELEMENT_MODE_INLINE = 3; * This event is useful when it is important to keep track of references * to elements in the editable content from code. * - * @since 4.3 + * @since 4.3.0 * @event contentDomInvalidated * @param {CKEDITOR.editor} editor This editor instance. */ diff --git a/core/env.js b/core/env.js index 866e2c4f05a..01de39c0fb9 100644 --- a/core/env.js +++ b/core/env.js @@ -43,7 +43,7 @@ if ( !CKEDITOR.env ) { * * See also {@link #ie}. * - * @since 4.5 + * @since 4.5.0 * @property {Boolean} */ edge: !!edge, @@ -313,7 +313,7 @@ if ( !CKEDITOR.env ) { * Indicates that CKEditor is running in a browser which uses a bogus * `
` filler in order to correctly display caret in empty blocks. * - * @since 4.3 + * @since 4.3.0 * @property {Boolean} */ env.needsBrFiller = env.gecko || env.webkit || ( env.ie && version > 10 ); @@ -322,7 +322,7 @@ if ( !CKEDITOR.env ) { * Indicates that CKEditor is running in a browser which needs a * non-breaking space filler in order to correctly display caret in empty blocks. * - * @since 4.3 + * @since 4.3.0 * @property {Boolean} */ env.needsNbspFiller = env.ie && version < 11; diff --git a/core/filter.js b/core/filter.js index db9f7e4dcac..6056b86e2a2 100644 --- a/core/filter.js +++ b/core/filter.js @@ -22,7 +22,7 @@ * * See {@link CKEDITOR.filter#addElementCallback} for more details. * - * @since 4.4 + * @since 4.4.0 * @readonly * @property {Number} [=2] * @member CKEDITOR @@ -78,7 +78,7 @@ * var filter2 = new CKEDITOR.filter( editor, 'b' ); * ``` * - * @since 4.1 + * @since 4.1.0 * @class * @constructor Creates a filter class instance. * @param {CKEDITOR.editor/CKEDITOR.filter.allowedContentRules} editorOrRules @@ -117,7 +117,7 @@ * This property is useful for debugging issues with rules string parsing * or for checking which rules were automatically added by editor features. * - * @since 4.4 + * @since 4.4.0 * @readonly */ this.disallowedContent = []; @@ -152,7 +152,7 @@ * Filter's unique id. It can be used to find filter instance in * {@link CKEDITOR.filter#instances CKEDITOR.filter.instance} object. * - * @since 4.3 + * @since 4.3.0 * @readonly * @property {Number} id */ @@ -216,7 +216,7 @@ * var filter = new CKEDITOR.filter( 'p' ); * filter === CKEDITOR.filter.instances[ filter.id ]; * - * @since 4.3 + * @since 4.3.0 * @static * @property instances */ @@ -443,7 +443,7 @@ * // Disallow all span and div elements. * editor.filter.disallow( 'span div' ); * - * @since 4.4 + * @since 4.4.0 * @param {CKEDITOR.filter.disallowedContentRules} newRules Rule(s) to be added. */ disallow: function( newRules ) { @@ -531,7 +531,7 @@ * temporarily on later stages of the filtering process. Therefore you need to * use the pure {@link CKEDITOR.htmlParser.element} interface. * - * @since 4.4 + * @since 4.4.0 * @param {Function} callback The callback to be executed. */ addElementCallback: function( callback ) { @@ -804,7 +804,7 @@ * Returns first enter mode allowed by this filter rules. Modes are checked in `p`, `div`, `br` order. * If none of tags is allowed this method will return {@link CKEDITOR#ENTER_BR}. * - * @since 4.3 + * @since 4.3.0 * @param {Number} defaultMode The default mode which will be checked as the first one. * @param {Boolean} [reverse] Whether to check modes in reverse order (used for shift enter mode). * @returns {Number} Allowed enter mode. @@ -2365,7 +2365,7 @@ * Read more in the {@glink guide/dev_acf documentation} * and see the {@glink examples/acf example}. * - * @since 4.1 + * @since 4.1.0 * @cfg {CKEDITOR.filter.allowedContentRules/Boolean} [allowedContent=null] * @member CKEDITOR.config */ @@ -2397,7 +2397,7 @@ * and see the {@glink examples/acf example}. * See also {@link CKEDITOR.config#allowedContent} for more details. * - * @since 4.1 + * @since 4.1.0 * @cfg {Object/String} extraAllowedContent * @member CKEDITOR.config */ @@ -2410,7 +2410,7 @@ * and see the {@glink examples/acf example}. * See also {@link CKEDITOR.config#allowedContent} and {@link CKEDITOR.config#extraAllowedContent}. * - * @since 4.4 + * @since 4.4.0 * @cfg {CKEDITOR.filter.disallowedContentRules} disallowedContent * @member CKEDITOR.config */ @@ -2425,7 +2425,7 @@ * setting is sufficient and correct for a system that is migrating to CKEditor 4.1 * (where the {@glink guide/dev_advanced_content_filter Advanced Content Filter} was introduced). * - * @since 4.1 + * @since 4.1.0 * @event dataFiltered * @member CKEDITOR.editor * @param {CKEDITOR.editor} editor This editor instance. @@ -2441,7 +2441,7 @@ * * a {@link CKEDITOR.style} instance – used mainly for integrating plugins with Advanced Content Filter, * * an array of the above formats. * - * @since 4.1 + * @since 4.1.0 * @class CKEDITOR.filter.allowedContentRules * @abstract */ @@ -2456,7 +2456,7 @@ * * Read more in the {@glink guide/dev_disallowed_content Disallowed Content guide}. * - * @since 4.4 + * @since 4.4.0 * @class CKEDITOR.filter.disallowedContentRules * @abstract */ @@ -2475,7 +2475,7 @@ * 'ol, ul(!foo)' // Incorrect rule. Multiple elements and required * // properties are not supported. * - * @since 4.1 + * @since 4.1.0 * @class CKEDITOR.filter.contentRule * @abstract */ @@ -2513,7 +2513,7 @@ * are checked and registered with {@link CKEDITOR.editor#addFeature}, all styles available in the * 'Format' and 'Styles' drop-down lists are checked and registered too and so on. * - * @since 4.1 + * @since 4.1.0 * @class CKEDITOR.feature * @abstract */ diff --git a/core/htmldataprocessor.js b/core/htmldataprocessor.js index 3bf7b6d13d0..c713fdb9dc5 100644 --- a/core/htmldataprocessor.js +++ b/core/htmldataprocessor.js @@ -1001,7 +1001,8 @@ // Different protection pattern is used for those that // live in attributes to avoid from being HTML encoded. - // Why so serious? See https://dev.ckeditor.com/ticket/9205, https://dev.ckeditor.com/ticket/8216, https://dev.ckeditor.com/ticket/7805, https://dev.ckeditor.com/ticket/11754, https://dev.ckeditor.com/ticket/11846. + // Why so serious? See https://dev.ckeditor.com/ticket/9205, https://dev.ckeditor.com/ticket/8216, https://dev.ckeditor.com/ticket/7805, + // https://dev.ckeditor.com/ticket/11754, https://dev.ckeditor.com/ticket/11846. data = data.replace( /<\w+(?:\s+(?:(?:[^\s=>]+\s*=\s*(?:[^'"\s>]+|'[^']*'|"[^"]*"))|[^\s=\/>]+))+\s*\/?>/g, function( match ) { return match.replace( //g, function( match, data ) { store[ store.id ] = decodeURIComponent( data ); @@ -1043,7 +1044,7 @@ * return false; * }; * - * @since 3.5 + * @since 3.5.0 * @cfg {Boolean/Function} [fillEmptyBlocks=true] * @member CKEDITOR.config */ @@ -1073,7 +1074,7 @@ * evt.data.dataValue; // -> CKEDITOR.htmlParser.fragment instance * }, null, null, 7 ); * - * @since 4.1 + * @since 4.1.0 * @event toHtml * @member CKEDITOR.editor * @param {CKEDITOR.editor} editor This editor instance. @@ -1113,7 +1114,7 @@ * evt.data.dataValue; // -> CKEDITOR.htmlParser.fragment instance * }, null, null, 12 ); * - * @since 4.1 + * @since 4.1.0 * @event toDataFormat * @member CKEDITOR.editor * @param {CKEDITOR.editor} editor This editor instance. diff --git a/core/htmlparser/cdata.js b/core/htmlparser/cdata.js index c69b2f51c8e..7e412a70013 100644 --- a/core/htmlparser/cdata.js +++ b/core/htmlparser/cdata.js @@ -3,7 +3,7 @@ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license */ - 'use strict'; +'use strict'; ( function() { diff --git a/core/htmlparser/comment.js b/core/htmlparser/comment.js index e921c57ded8..52b02bc6f8b 100644 --- a/core/htmlparser/comment.js +++ b/core/htmlparser/comment.js @@ -3,7 +3,7 @@ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license */ - 'use strict'; +'use strict'; /** * A lightweight representation of an HTML comment. @@ -39,7 +39,7 @@ CKEDITOR.htmlParser.comment.prototype = CKEDITOR.tools.extend( new CKEDITOR.html /** * Filter this comment with given filter. * - * @since 4.1 + * @since 4.1.0 * @param {CKEDITOR.htmlParser.filter} filter * @returns {Boolean} Method returns `false` when this comment has * been removed or replaced with other node. This is an information for diff --git a/core/htmlparser/element.js b/core/htmlparser/element.js index a927cdf3a0b..6da1ab07957 100644 --- a/core/htmlparser/element.js +++ b/core/htmlparser/element.js @@ -150,7 +150,7 @@ CKEDITOR.htmlParser.cssStyle = function() { /** * Filters this element and its children with the given filter. * - * @since 4.1 + * @since 4.1.0 * @param {CKEDITOR.htmlParser.filter} filter * @returns {Boolean} The method returns `false` when this element has * been removed or replaced with another. This information means that @@ -315,7 +315,7 @@ CKEDITOR.htmlParser.cssStyle = function() { /** * Replaces this element with its children. * - * @since 4.1 + * @since 4.1.0 */ replaceWithChildren: function() { var children = this.children; @@ -342,7 +342,7 @@ CKEDITOR.htmlParser.cssStyle = function() { * // 5. "bar" text node, * // 6. "bom" text node. * - * @since 4.1 + * @since 4.1.0 * @param {Function} callback Function to be executed on every node. * **Since 4.3**: If `callback` returned `false`, the descendants of the current node will be ignored. * @param {CKEDITOR.htmlParser.node} callback.node Node passed as an argument. @@ -355,7 +355,7 @@ CKEDITOR.htmlParser.cssStyle = function() { * Gets this element's first child. If `condition` is given, this method returns * the first child which satisfies that condition. * - * @since 4.3 + * @since 4.3.0 * @param {String/Object/Function} condition Name of a child, a hash of names, or a validator function. * @returns {CKEDITOR.htmlParser.node} */ @@ -376,7 +376,7 @@ CKEDITOR.htmlParser.cssStyle = function() { /** * Gets this element's inner HTML. * - * @since 4.3 + * @since 4.3.0 * @returns {String} */ getHtml: function() { @@ -388,7 +388,7 @@ CKEDITOR.htmlParser.cssStyle = function() { /** * Sets this element's inner HTML. * - * @since 4.3 + * @since 4.3.0 * @param {String} html */ setHtml: function( html ) { @@ -401,7 +401,7 @@ CKEDITOR.htmlParser.cssStyle = function() { /** * Gets this element's outer HTML. * - * @since 4.3 + * @since 4.3.0 * @returns {String} */ getOuterHtml: function() { @@ -413,7 +413,7 @@ CKEDITOR.htmlParser.cssStyle = function() { /** * Splits this element at the given index. * - * @since 4.3 + * @since 4.3.0 * @param {Number} index Index at which the element will be split — `0` means the beginning, * `1` after the first child node, etc. * @returns {CKEDITOR.htmlParser.element} The new element following this one. @@ -505,7 +505,7 @@ CKEDITOR.htmlParser.cssStyle = function() { /** * Adds a class name to the list of classes. * - * @since 4.4 + * @since 4.4.0 * @param {String} className The class name to be added. */ addClass: function( className ) { @@ -520,7 +520,7 @@ CKEDITOR.htmlParser.cssStyle = function() { /** * Removes a class name from the list of classes. * - * @since 4.3 + * @since 4.3.0 * @param {String} className The class name to be removed. */ removeClass: function( className ) { @@ -542,7 +542,7 @@ CKEDITOR.htmlParser.cssStyle = function() { /** * Checkes whether this element has a class name. * - * @since 4.3 + * @since 4.3.0 * @param {String} className The class name to be checked. * @returns {Boolean} Whether this element has a `className`. */ diff --git a/core/htmlparser/fragment.js b/core/htmlparser/fragment.js index 691874dc54a..aaab2f421cc 100644 --- a/core/htmlparser/fragment.js +++ b/core/htmlparser/fragment.js @@ -507,7 +507,7 @@ CKEDITOR.htmlParser.fragment = function() { /** * Filter this fragment's content with given filter. * - * @since 4.1 + * @since 4.1.0 * @param {CKEDITOR.htmlParser.filter} filter */ filter: function( filter, context ) { @@ -525,7 +525,7 @@ CKEDITOR.htmlParser.fragment = function() { * Element's children may only be filtered once by one * instance of filter. * - * @since 4.1 + * @since 4.1.0 * @param {CKEDITOR.htmlParser.filter} filter * @param {Boolean} [filterRoot] Whether to apply the "root" filter rule specified in the `filter`. */ @@ -610,7 +610,7 @@ CKEDITOR.htmlParser.fragment = function() { * // 5. "bar" text node, * // 6. "bom" text node. * - * @since 4.1 + * @since 4.1.0 * @param {Function} callback Function to be executed on every node. * **Since 4.3** if `callback` returned `false` descendants of current node will be ignored. * @param {CKEDITOR.htmlParser.node} callback.node Node passed as argument. diff --git a/core/htmlparser/node.js b/core/htmlparser/node.js index d60f0347c15..c6229a4b01c 100644 --- a/core/htmlparser/node.js +++ b/core/htmlparser/node.js @@ -9,7 +9,7 @@ /** * A lightweight representation of HTML node. * - * @since 4.1 + * @since 4.1.0 * @class * @constructor Creates a node class instance. */ @@ -19,7 +19,7 @@ /** * Remove this node from a tree. * - * @since 4.1 + * @since 4.1.0 */ remove: function() { var children = this.parent.children, @@ -36,7 +36,7 @@ /** * Replace this node with given one. * - * @since 4.1 + * @since 4.1.0 * @param {CKEDITOR.htmlParser.node} node The node that will replace this one. */ replaceWith: function( node ) { @@ -57,7 +57,7 @@ /** * Insert this node after given one. * - * @since 4.1 + * @since 4.1.0 * @param {CKEDITOR.htmlParser.node} node The node that will precede this element. */ insertAfter: function( node ) { @@ -78,7 +78,7 @@ /** * Insert this node before given one. * - * @since 4.1 + * @since 4.1.0 * @param {CKEDITOR.htmlParser.node} node The node that will follow this element. */ insertBefore: function( node ) { @@ -98,7 +98,7 @@ /** * Gets the closest ancestor element of this element which satisfies given condition * - * @since 4.3 + * @since 4.3.0 * @param {String/Object/Function} condition Name of an ancestor, hash of names or validator function. * @returns {CKEDITOR.htmlParser.element} The closest ancestor which satisfies given condition or `null`. */ @@ -129,7 +129,7 @@ /** * Wraps this element with given `wrapper`. * - * @since 4.3 + * @since 4.3.0 * @param {CKEDITOR.htmlParser.element} wrapper The element which will be this element's new parent. * @returns {CKEDITOR.htmlParser.element} Wrapper. */ @@ -142,7 +142,7 @@ /** * Gets this node's index in its parent's children array. * - * @since 4.3 + * @since 4.3.0 * @returns {Number} */ getIndex: function() { diff --git a/core/htmlparser/text.js b/core/htmlparser/text.js index 31f544088da..bc6ba0bd549 100644 --- a/core/htmlparser/text.js +++ b/core/htmlparser/text.js @@ -3,7 +3,7 @@ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license */ - 'use strict'; +'use strict'; ( function() { /** @@ -40,7 +40,7 @@ /** * Filter this text node with given filter. * - * @since 4.1 + * @since 4.1.0 * @param {CKEDITOR.htmlParser.filter} filter * @returns {Boolean} Method returns `false` when this text node has * been removed. This is an information for {@link CKEDITOR.htmlParser.element#filterChildren} diff --git a/core/plugindefinition.js b/core/plugindefinition.js index 6fb559b0c73..ba031e906d3 100644 --- a/core/plugindefinition.js +++ b/core/plugindefinition.js @@ -172,7 +172,7 @@ * will automatically detect the HiDPI environment and attempt to load the * high-resolution resources. * - * @since 4.2 + * @since 4.2.0 * @property {Boolean} hidpi */ diff --git a/core/selection.js b/core/selection.js index 5007325caab..eb93cc1dfd6 100644 --- a/core/selection.js +++ b/core/selection.js @@ -2474,7 +2474,7 @@ * Selection's revision. This value is incremented every time new * selection is created or existing one is modified. * - * @since 4.3 + * @since 4.3.0 * @readonly * @property {Number} rev */ diff --git a/core/style.js b/core/style.js index 91e7da7c052..b4f71d1140d 100644 --- a/core/style.js +++ b/core/style.js @@ -522,7 +522,7 @@ CKEDITOR.STYLE_OBJECT = 3; /** * Returns the style definition. * - * @since 4.1 + * @since 4.1.0 * @returns {Object} */ getDefinition: function() { @@ -536,7 +536,7 @@ CKEDITOR.STYLE_OBJECT = 3; * * **Note:** This method is not defined in the {@link CKEDITOR.style} class. * - * @since 4.4 + * @since 4.4.0 * @method toAllowedContentRules * @param {CKEDITOR.editor} [editor] The editor instance. * @returns {CKEDITOR.filter.allowedContentRules} The rules that should represent this style in the {@link CKEDITOR.filter}. @@ -590,7 +590,7 @@ CKEDITOR.STYLE_OBJECT = 3; /** * Namespace containing custom style handlers added with {@link CKEDITOR.style#addCustomHandler}. * - * @since 4.4 + * @since 4.4.0 * @class * @singleton */ @@ -692,7 +692,7 @@ CKEDITOR.STYLE_OBJECT = 3; * * {@link CKEDITOR.style#toAllowedContentRules toAllowedContentRules} – Not required, but very useful in * case of a custom style that has to notify the {@link CKEDITOR.filter} which rules it allows when registered. * - * @since 4.4 + * @since 4.4.0 * @static * @member CKEDITOR.style * @param definition The style class definition. @@ -1911,7 +1911,7 @@ CKEDITOR.styleCommand.prototype.exec = function( editor ) { * } * ] ); * - * @since 3.2 + * @since 3.2.0 * @class * @singleton * @extends CKEDITOR.resourceManager @@ -2052,7 +2052,7 @@ CKEDITOR.tools.extend( CKEDITOR.editor.prototype, { * Indicates that fully selected read-only elements will be included when * applying the style (for inline styles only). * - * @since 3.5 + * @since 3.5.0 * @property {Boolean} [includeReadonly=false] * @member CKEDITOR.style */ @@ -2061,7 +2061,7 @@ CKEDITOR.tools.extend( CKEDITOR.editor.prototype, { * Indicates that any matches element of this style will be eventually removed * when calling {@link CKEDITOR.editor#removeStyle}. * - * @since 4.0 + * @since 4.0.0 * @property {Boolean} [alwaysRemoveElement=false] * @member CKEDITOR.style */ @@ -2069,7 +2069,7 @@ CKEDITOR.tools.extend( CKEDITOR.editor.prototype, { /** * Disables inline styling on read-only elements. * - * @since 3.5 + * @since 3.5.0 * @cfg {Boolean} [disableReadonlyStyling=false] * @member CKEDITOR.config */ @@ -2113,7 +2113,7 @@ CKEDITOR.tools.extend( CKEDITOR.editor.prototype, { * ... * ]; * - * @since 3.3 + * @since 3.3.0 * @cfg {String/Array/Boolean} [stylesSet='default'] * @member CKEDITOR.config */ diff --git a/core/tools.js b/core/tools.js index 3f4a61a6a4b..27a50ffe40b 100644 --- a/core/tools.js +++ b/core/tools.js @@ -90,7 +90,7 @@ * return el >= 3; * } ); // 2 * - * @since 4.5 + * @since 4.5.0 * @param {Array} array Array to search in. * @param {Function} compareFunction Compare function. * @returns {Number} The index of the first matching element or `-1` if none matches. @@ -248,7 +248,7 @@ * This method is faster than {@link #clone} which does * a deep copy of an object (including arrays). * - * @since 4.1 + * @since 4.1.0 * @param {Object} source The object to be copied. * @returns {Object} Copy of `source`. */ @@ -429,7 +429,7 @@ /** * Transforms text to valid HTML: creates paragraphs, replaces tabs with non-breaking spaces etc. * - * @since 4.5 + * @since 4.5.0 * @param {String} text Text to transform. * @param {Number} enterMode Editor {@link CKEDITOR.config#enterMode Enter mode}. * @returns {String} HTML generated from the text. @@ -1077,7 +1077,7 @@ * CKEDITOR.tools.writeCssText( styleObj ); // -> 'color:red; border:none' * CKEDITOR.tools.writeCssText( styleObj, true ); // -> 'border:none; color:red' * - * @since 4.1 + * @since 4.1.0 * @param {Object} styles The object contaning style properties. * @param {Boolean} [sort] Whether to sort CSS properties. * @returns {String} The serialized style text. @@ -1100,7 +1100,7 @@ * * **Note:** This method performs shallow, non-strict comparison. * - * @since 4.1 + * @since 4.1.0 * @param {Object} left * @param {Object} right * @param {Boolean} [onlyLeft] Check only the properties that are present in the `left` object. @@ -1132,7 +1132,7 @@ /** * @inheritdoc CKEDITOR.tools.object#keys - * @since 4.1 + * @since 4.1.0 * @deprecated 4.12.0 Use {@link CKEDITOR.tools.object#keys} instead. */ objectKeys: function( obj ) { @@ -1149,7 +1149,7 @@ * console.log( CKEDITOR.tools.convertArrayToObject( arr, 1 ) ); * // -> { foo: 1, bar: 1 } * - * @since 4.1 + * @since 4.1.0 * @param {Array} arr The array to be converted to an object. * @param [fillWith=true] Set each property of an object to `fillWith` value. */ @@ -1226,7 +1226,7 @@ * * **Note:** This method has to be used in the `` section of the document. * - * @since 4.3 + * @since 4.3.0 * @param {Object} doc Native `Document` or `DocumentFragment` in which the elements will be enabled. * @param {Boolean} [withAppend] Whether to append created elements to the `doc`. */ @@ -1248,7 +1248,7 @@ * @param {Array} arr The array whose items will be checked. * @param {RegExp} regexp The regular expression. * @returns {Boolean} Returns `true` for the first occurrence of the search pattern. - * @since 4.4 + * @since 4.4.0 */ checkIfAnyArrayItemMatches: function( arr, regexp ) { for ( var i = 0, l = arr.length; i < l; ++i ) { @@ -1264,7 +1264,7 @@ * @param obj The object whose properties will be checked. * @param {RegExp} regexp The regular expression. * @returns {Boolean} Returns `true` for the first occurrence of the search pattern. - * @since 4.4 + * @since 4.4.0 */ checkIfAnyObjectPropertyMatches: function( obj, regexp ) { for ( var i in obj ) { @@ -1367,7 +1367,7 @@ /** * The data URI of a transparent image. May be used e.g. in HTML as an image source or in CSS in `url()`. * - * @since 4.4 + * @since 4.4.0 * @readonly */ transparentImageData: 'data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==', diff --git a/core/ui.js b/core/ui.js index b12d19c18f6..a1cc88bf05f 100644 --- a/core/ui.js +++ b/core/ui.js @@ -179,7 +179,7 @@ CKEDITOR.event.implementOn( CKEDITOR.ui ); * var editor = CKEDITOR.instances.editor1; * console.log( editor.ui.contentsElement.getName() ); // 'div' * - * @since 4.5 + * @since 4.5.0 * @readonly * @property {CKEDITOR.dom.element} contentsElement */ diff --git a/plugins/ajax/plugin.js b/plugins/ajax/plugin.js index 0ee93ec386a..95abe2bf5ac 100644 --- a/plugins/ajax/plugin.js +++ b/plugins/ajax/plugin.js @@ -149,7 +149,7 @@ * console.log( data ); * } ); * - * @since 4.4 + * @since 4.4.0 * @param {String} url The URL of the request. * @param {String/Object/Array} data Data passed to `XMLHttpRequest#send`. * @param {String} [contentType='application/x-www-form-urlencoded; charset=UTF-8'] The value of the `Content-type` header. diff --git a/plugins/autoembed/plugin.js b/plugins/autoembed/plugin.js index 856d5b272e1..466f19993c9 100644 --- a/plugins/autoembed/plugin.js +++ b/plugins/autoembed/plugin.js @@ -80,7 +80,7 @@ instance.loadContent( href, { noNotifications: true, callback: function() { - // DOM might be invalidated in the meantime, so find the anchor again. + // DOM might be invalidated in the meantime, so find the anchor again. var anchor = editor.editable().findOne( 'a[data-cke-autoembed="' + id + '"]' ); // Anchor might be removed in the meantime. @@ -152,7 +152,7 @@ * * This method uses the value of the {@link CKEDITOR.config#autoEmbed_widget} option. * - * @since 4.5 + * @since 4.5.0 * @member CKEDITOR.plugins.autoEmbed * @param {CKEDITOR.editor} editor * @param {String} url The URL to be embedded. @@ -211,7 +211,7 @@ * Read more in the [documentation](#!/guide/dev_media_embed-section-automatic-embedding-on-paste) * and see the {@glink examples/mediaembed example}. * - * @since 4.5 + * @since 4.5.0 * @cfg {String/Function} [autoEmbed_widget='embed,embedSemantic'] * @member CKEDITOR.config */ diff --git a/plugins/autogrow/plugin.js b/plugins/autogrow/plugin.js index c211a4d6b78..9c5c762a653 100644 --- a/plugins/autogrow/plugin.js +++ b/plugins/autogrow/plugin.js @@ -170,7 +170,7 @@ * * config.autoGrow_minHeight = 300; * - * @since 3.4 + * @since 3.4.0 * @cfg {Number} [autoGrow_minHeight=200] * @member CKEDITOR.config */ @@ -185,7 +185,7 @@ * * config.autoGrow_maxHeight = 400; * - * @since 3.4 + * @since 3.4.0 * @cfg {Number} [autoGrow_maxHeight=0] * @member CKEDITOR.config */ diff --git a/plugins/balloonpanel/plugin.js b/plugins/balloonpanel/plugin.js index d08ee87972c..981fbd08e62 100644 --- a/plugins/balloonpanel/plugin.js +++ b/plugins/balloonpanel/plugin.js @@ -38,7 +38,7 @@ * panel.attach( domElement ); * * @class - * @since 4.6 + * @since 4.6.0 * @param {CKEDITOR.editor} editor The editor instance for which the panel is created. * @param {Object} definition An object containing the panel definition. */ diff --git a/plugins/balloontoolbar/plugin.js b/plugins/balloontoolbar/plugin.js index 32bcc35d89f..697851bd406 100644 --- a/plugins/balloontoolbar/plugin.js +++ b/plugins/balloontoolbar/plugin.js @@ -15,7 +15,7 @@ * @private * @extends CKEDITOR.ui.balloonPanel * @constructor Creates a balloon toolbar view instance. - * @since 4.8 + * @since 4.8.0 * @param {CKEDITOR.editor} editor The editor instance for which the toolbar is created. * @param {Object} definition An object containing the toolbar definition. See {@link CKEDITOR.ui.balloonPanel} * documentation for an example definition. @@ -68,7 +68,7 @@ * * @class * @constructor Creates a balloon toolbar instance. - * @since 4.8 + * @since 4.8.0 * @param {CKEDITOR.editor} editor The editor instance for which the toolbar is created. * @param {Object} definition An object containing the panel definition. See {@link CKEDITOR.ui.balloonPanel} * documentation for an example definition. @@ -215,7 +215,7 @@ * * @class CKEDITOR.plugins.balloontoolbar.context * @constructor Creates a balloon toolbar context instance. - * @since 4.8 + * @since 4.8.0 * @param {CKEDITOR.editor} editor The editor instance for which the toolbar is created. * @param {CKEDITOR.plugins.balloontoolbar.contextDefinition} options A set of options defining the context behavior. */ @@ -384,7 +384,7 @@ * * @class CKEDITOR.plugins.balloontoolbar.contextManager * @constructor - * @since 4.8 + * @since 4.8.0 * @param {CKEDITOR.editor} editor The editor instance which the toolbar is created for. */ function ContextManager( editor ) { @@ -639,7 +639,7 @@ * cssSelector: 'a[href], img' * } ); * - * @since 4.8 + * @since 4.8.0 * @readonly * @property {CKEDITOR.plugins.balloontoolbar.contextManager} balloonToolbars * @member CKEDITOR.editor diff --git a/plugins/button/plugin.js b/plugins/button/plugin.js index 8ec5d0b3072..873099854ac 100644 --- a/plugins/button/plugin.js +++ b/plugins/button/plugin.js @@ -374,7 +374,7 @@ * * This method implements the {@link CKEDITOR.feature#toFeature} interface method. * - * @since 4.1 + * @since 4.1.0 * @param {CKEDITOR.editor} Editor instance. * @returns {CKEDITOR.feature} The feature. */ diff --git a/plugins/clipboard/plugin.js b/plugins/clipboard/plugin.js index 3854c22f7d8..5f6afc48611 100644 --- a/plugins/clipboard/plugin.js +++ b/plugins/clipboard/plugin.js @@ -1631,7 +1631,7 @@ * shows the security dialog window when the script tries to set clipboard data and on iOS, because custom data is * not saved to clipboard there. * - * @since 4.5 + * @since 4.5.0 * @readonly * @property {Boolean} */ @@ -1640,7 +1640,7 @@ /** * True if the environment supports MIME types and custom data types in dataTransfer/cliboardData getData/setData methods. * - * @since 4.5 + * @since 4.5.0 * @readonly * @property {Boolean} */ @@ -1649,7 +1649,7 @@ /** * True if the environment supports File API. * - * @since 4.5 + * @since 4.5.0 * @readonly * @property {Boolean} */ @@ -1664,7 +1664,7 @@ * which will handle pasting from e.g. browsers' menu bars. * IE7/8 does not like the {@link CKEDITOR.editor#paste} event for which it is throwing random errors. * - * @since 4.5 + * @since 4.5.0 * @readonly * @property {String} */ @@ -1745,7 +1745,7 @@ /** * Returns the element that should be used as the target for the drop event. * - * @since 4.5 + * @since 4.5.0 * @param {CKEDITOR.editor} editor The editor instance. * @returns {CKEDITOR.dom.domObject} the element that should be used as the target for the drop event. */ @@ -1788,7 +1788,7 @@ * * **Note:** This function is in the public scope for tests usage only. * - * @since 4.5 + * @since 4.5.0 * @private * @param {CKEDITOR.dom.range} dragRange The drag range. * @param {CKEDITOR.dom.range} dropRange The drop range. @@ -1863,7 +1863,7 @@ * * **Note:** This function is in the public scope for tests usage only. * - * @since 4.5 + * @since 4.5.0 * @private * @param {CKEDITOR.dom.range} dragRange The first range to compare. * @param {CKEDITOR.dom.range} dropRange The second range to compare. @@ -1908,7 +1908,7 @@ * * **Note:** This function is in the public scope for tests usage only. * - * @since 4.5 + * @since 4.5.0 * @private * @param {CKEDITOR.dom.range} dragRange The first range to compare. * @param {CKEDITOR.dom.range} dropRange The second range to compare. @@ -1992,7 +1992,7 @@ /** * Gets the range from the `drop` event. * - * @since 4.5 + * @since 4.5.0 * @param {Object} domEvent A native DOM drop event object. * @param {CKEDITOR.editor} editor The source editor instance. * @returns {CKEDITOR.dom.range} range at drop position. @@ -2159,7 +2159,7 @@ * by its ID and a new instance is assigned to the `evt.data.dataTransfer` only if the ID changed or * the {@link #resetDragDataTransfer} method was called. * - * @since 4.5 + * @since 4.5.0 * @param {CKEDITOR.dom.event} [evt] A drop event object. * @param {CKEDITOR.editor} [sourceEditor] The source editor instance. */ @@ -2201,7 +2201,7 @@ * Removes the global {@link #dragData} so the next call to {@link #initDragDataTransfer} * always creates a new instance of {@link CKEDITOR.plugins.clipboard.dataTransfer}. * - * @since 4.5 + * @since 4.5.0 */ resetDragDataTransfer: function() { this.dragData = null; @@ -2214,7 +2214,7 @@ * Note: This object is global (meaning that it is not related to a single editor instance) * in order to handle drag and drop from one editor into another. * - * @since 4.5 + * @since 4.5.0 * @private * @property {CKEDITOR.plugins.clipboard.dataTransfer} dragData */ @@ -2222,7 +2222,7 @@ /** * Range object to save the drag range and remove its content after the drop. * - * @since 4.5 + * @since 4.5.0 * @private * @property {CKEDITOR.dom.range} dragRange */ @@ -2234,7 +2234,7 @@ * so the method always returns a new object. The same happens if there is no paste event * passed to the method. * - * @since 4.5 + * @since 4.5.0 * @param {CKEDITOR.dom.event} [evt] A paste event object. * @param {CKEDITOR.editor} [sourceEditor] The source editor instance. * @returns {CKEDITOR.plugins.clipboard.dataTransfer} The data transfer object. @@ -2268,7 +2268,7 @@ /** * Prevents dropping on the specified element. * - * @since 4.5 + * @since 4.5.0 * @param {CKEDITOR.dom.element} element The element on which dropping should be disabled. */ preventDefaultDropOnElement: function( element ) { @@ -2289,7 +2289,7 @@ * Facade for the native `dataTransfer`/`clipboadData` object to hide all differences * between browsers. * - * @since 4.5 + * @since 4.5.0 * @class CKEDITOR.plugins.clipboard.dataTransfer * @constructor Creates a class instance. * @param {Object} [nativeDataTransfer] A native data transfer object. @@ -2389,7 +2389,7 @@ * Data transfer operation (drag and drop or copy and paste) started and ended in the same * editor instance. * - * @since 4.5 + * @since 4.5.0 * @readonly * @property {Number} [=1] * @member CKEDITOR @@ -2400,7 +2400,7 @@ * Data transfer operation (drag and drop or copy and paste) started in one editor * instance and ended in another. * - * @since 4.5 + * @since 4.5.0 * @readonly * @property {Number} [=2] * @member CKEDITOR @@ -2411,7 +2411,7 @@ * Data transfer operation (drag and drop or copy and paste) started outside of the editor. * The source of the data may be a textarea, HTML, another application, etc. * - * @since 4.5 + * @since 4.5.0 * @readonly * @property {Number} [=3] * @member CKEDITOR @@ -3096,7 +3096,7 @@ * See also the {@link CKEDITOR.editor#paste} event and read more about the integration with clipboard * in the {@glink guide/dev_clipboard Clipboard Deep Dive guide}. * - * @since 4.0 + * @since 4.0.0 * @cfg {'html'/'text'} [clipboard_defaultContentType='html'] * @member CKEDITOR.config */ @@ -3113,7 +3113,7 @@ * * the {@link CKEDITOR.editor#drop} event, * * the {@link CKEDITOR.plugins.clipboard.dataTransfer} class. * - * @since 3.1 + * @since 3.1.0 * @event paste * @member CKEDITOR.editor * @param {CKEDITOR.editor} editor This editor instance. @@ -3178,7 +3178,7 @@ * * The {@link CKEDITOR.editor#dragstart} and {@link CKEDITOR.editor#dragend} events, * * The {@link CKEDITOR.plugins.clipboard.dataTransfer} class. * - * @since 4.5 + * @since 4.5.0 * @event drop * @member CKEDITOR.editor * @param {CKEDITOR.editor} editor This editor instance. @@ -3208,7 +3208,7 @@ * * The {@link CKEDITOR.editor#drop} and {@link CKEDITOR.editor#dragend} events, * * The {@link CKEDITOR.plugins.clipboard.dataTransfer} class. * - * @since 4.5 + * @since 4.5.0 * @event dragstart * @member CKEDITOR.editor * @param {CKEDITOR.editor} editor This editor instance. @@ -3229,7 +3229,7 @@ * * The {@link CKEDITOR.editor#drop} and {@link CKEDITOR.editor#dragend} events, * * The {@link CKEDITOR.plugins.clipboard.dataTransfer} class. * - * @since 4.5 + * @since 4.5.0 * @event dragend * @member CKEDITOR.editor * @param {CKEDITOR.editor} editor This editor instance. @@ -3285,7 +3285,7 @@ * This setting defaults to `'semantic-content'` in Chrome, Opera and Safari (all Blink and Webkit based browsers) * due to messy HTML which these browsers keep in the clipboard. In other browsers it defaults to `null`. * - * @since 4.5 + * @since 4.5.0 * @cfg {String} [pasteFilter='semantic-content' in Chrome and Safari and `null` in other browsers] * @member CKEDITOR.config */ @@ -3318,7 +3318,7 @@ * it will also be applied to pasted and dropped data. The paste filter job is to "normalize" * external data which often needs to be handled differently than content produced by the editor. * - * @since 4.5 + * @since 4.5.0 * @readonly * @property {CKEDITOR.filter} [pasteFilter] * @member CKEDITOR.editor diff --git a/plugins/codesnippet/plugin.js b/plugins/codesnippet/plugin.js index 78176fa8679..6c612bc0b09 100644 --- a/plugins/codesnippet/plugin.js +++ b/plugins/codesnippet/plugin.js @@ -3,7 +3,7 @@ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license */ - /** +/** * @fileOverview Rich code snippets for CKEditor. */ @@ -31,7 +31,7 @@ * the three callbacks). * * This method is accessible through the `editor.plugins.codesnippet` namespace only. * - * @since 4.4 + * @since 4.4.0 * @member CKEDITOR.plugins.codesnippet * @param {CKEDITOR.plugins.codesnippet.highlighter} highlighter */ @@ -181,7 +181,7 @@ * } * } ); * - * @since 4.4 + * @since 4.4.0 * @class CKEDITOR.plugins.codesnippet.highlighter * @extends CKEDITOR.plugins.codesnippet * @param {Object} def Highlighter definition. See {@link #highlighter}, {@link #init} and {@link #languages}. @@ -438,7 +438,7 @@ * Read more in the {@glink guide/dev_codesnippet documentation} * and see the {@glink examples/codesnippet example}. * - * @since 4.4 + * @since 4.4.0 * @cfg {String} [codeSnippet_codeClass='hljs'] * @member CKEDITOR.config */ @@ -460,7 +460,7 @@ CKEDITOR.config.codeSnippet_codeClass = 'hljs'; * php: 'PHP' * }; * - * @since 4.4 + * @since 4.4.0 * @cfg {Object} [codeSnippet_languages=null] * @member CKEDITOR.config */ @@ -477,7 +477,7 @@ CKEDITOR.config.codeSnippet_codeClass = 'hljs'; * // Changes the theme to "pojoaque". * config.codeSnippet_theme = 'pojoaque'; * - * @since 4.4 + * @since 4.4.0 * @cfg {String} [codeSnippet_theme='default'] * @member CKEDITOR.config */ diff --git a/plugins/codesnippetgeshi/plugin.js b/plugins/codesnippetgeshi/plugin.js index 03f2f5ecc4f..617eade65e5 100644 --- a/plugins/codesnippetgeshi/plugin.js +++ b/plugins/codesnippetgeshi/plugin.js @@ -3,7 +3,7 @@ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license */ - /** +/** * @fileOverview Rich code snippets for CKEditor using GeSHi syntax highlighter (http://qbnz.com/highlighter/). */ diff --git a/plugins/devtools/plugin.js b/plugins/devtools/plugin.js index 7a7a801d09f..7ef4d661a1f 100644 --- a/plugins/devtools/plugin.js +++ b/plugins/devtools/plugin.js @@ -138,7 +138,7 @@ CKEDITOR.plugins.add( 'devtools', { * return str + ''; * }; * - * @since 3.6 + * @since 3.6.0 * @cfg {Function} [devtools_textCallback=see example] * @member CKEDITOR.config * @param {CKEDITOR.editor} editor @@ -159,7 +159,7 @@ CKEDITOR.plugins.add( 'devtools', { * '#cke_tooltip h2 { font-size: 1.1em; border-bottom: 1px solid; margin: 0; padding: 1px; }' + * '#cke_tooltip ul { padding: 0pt; list-style-type: none; }'; * - * @since 3.6 + * @since 3.6.0 * @cfg {String} [devtools_styles=see example] * @member CKEDITOR.config */ diff --git a/plugins/dialog/dialogDefinition.js b/plugins/dialog/dialogDefinition.js index cdab6bd202b..c67b2e4ba76 100644 --- a/plugins/dialog/dialogDefinition.js +++ b/plugins/dialog/dialogDefinition.js @@ -1033,6 +1033,6 @@ * * This marker allows for restoring the same text direction upon the next dialog opening. * - * @since 4.5 + * @since 4.5.0 * @property {Boolean} bidi */ diff --git a/plugins/dialog/plugin.js b/plugins/dialog/plugin.js index 65207df823f..c2d034b5f49 100644 --- a/plugins/dialog/plugin.js +++ b/plugins/dialog/plugin.js @@ -950,7 +950,7 @@ CKEDITOR.DIALOG_STATE_BUSY = 2; /** * Rearrange the dialog to its previous position or the middle of the window. * - * @since 3.5 + * @since 3.5.0 */ layout: function() { var el = this.parts.dialog; @@ -1443,7 +1443,7 @@ CKEDITOR.DIALOG_STATE_BUSY = 2; /** * Sets the dialog {@link #property-state}. * - * @since 4.5 + * @since 4.5.0 * @param {Number} state Either {@link CKEDITOR#DIALOG_STATE_IDLE} or {@link CKEDITOR#DIALOG_STATE_BUSY}. */ setState: function( state ) { @@ -1589,7 +1589,7 @@ CKEDITOR.DIALOG_STATE_BUSY = 2; /** * Check whether tab wasn't removed by {@link CKEDITOR.config#removeDialogTabs}. * - * @since 4.1 + * @since 4.1.0 * @static * @param {CKEDITOR.editor} editor * @param {String} dialogName @@ -3410,7 +3410,7 @@ CKEDITOR.plugins.add( 'dialog', { * * config.dialog_buttonsOrder = 'rtl'; * - * @since 3.5 + * @since 3.5.0 * @cfg {String} [dialog_buttonsOrder='OS'] * @member CKEDITOR.config */ @@ -3427,7 +3427,7 @@ CKEDITOR.plugins.add( 'dialog', { * * config.removeDialogTabs = 'flash:advanced;image:Link'; * - * @since 3.5 + * @since 3.5.0 * @cfg {String} [removeDialogTabs=''] * @member CKEDITOR.config */ @@ -3438,7 +3438,7 @@ CKEDITOR.plugins.add( 'dialog', { * * config.dialog_noConfirmCancel = true; * - * @since 4.3 + * @since 4.3.0 * @cfg {Boolean} [dialog_noConfirmCancel=false] * @member CKEDITOR.config */ @@ -3540,7 +3540,7 @@ CKEDITOR.plugins.add( 'dialog', { * both the {@link CKEDITOR.dialog} object and the dialog instance * since 3.5.3, previously it was only available in the global object. * - * @since 3.5 + * @since 3.5.0 * @event resize * @member CKEDITOR.dialog * @param data @@ -3551,7 +3551,7 @@ CKEDITOR.plugins.add( 'dialog', { /** * Event fired when the dialog state changes, usually by {@link CKEDITOR.dialog#setState}. * - * @since 4.5 + * @since 4.5.0 * @event state * @member CKEDITOR.dialog * @param data diff --git a/plugins/dialogui/plugin.js b/plugins/dialogui/plugin.js index 551f03d6673..a8eb9edb487 100644 --- a/plugins/dialogui/plugin.js +++ b/plugins/dialogui/plugin.js @@ -1082,7 +1082,7 @@ CKEDITOR.plugins.add( 'dialogui', { /** * Sets the text direction marker and the `dir` attribute of the input element. * - * @since 4.5 + * @since 4.5.0 * @param {String} dir The text direction. Pass `null` to reset. */ setDirectionMarker: function( dir ) { @@ -1103,7 +1103,7 @@ CKEDITOR.plugins.add( 'dialogui', { /** * Gets the value of the text direction marker. * - * @since 4.5 + * @since 4.5.0 * @returns {String} `'ltr'`, `'rtl'` or `null` if the marker is not set. */ getDirectionMarker: function() { diff --git a/plugins/embed/plugin.js b/plugins/embed/plugin.js index 90a352b5919..87be5e794eb 100644 --- a/plugins/embed/plugin.js +++ b/plugins/embed/plugin.js @@ -99,7 +99,7 @@ * **Important note:** Prior to version 4.7 this configuration option defaulted to the * `//ckeditor.iframe.ly/api/oembed?url={url}&callback={callback}` string. * - * @since 4.5 + * @since 4.5.0 * @cfg {String} [embed_provider=''] * @member CKEDITOR.config */ diff --git a/plugins/filebrowser/plugin.js b/plugins/filebrowser/plugin.js index 32757635c5f..768b8e873a3 100644 --- a/plugins/filebrowser/plugin.js +++ b/plugins/filebrowser/plugin.js @@ -472,7 +472,7 @@ * * config.filebrowserBrowseUrl = '/browser/browse.php'; * - * @since 3.0 + * @since 3.0.0 * @cfg {String} [filebrowserBrowseUrl='' (empty string = disabled)] * @member CKEDITOR.config */ @@ -491,7 +491,7 @@ * To configure {@glink guide/dev_file_upload uploading dropped or pasted files} use the {@link CKEDITOR.config#uploadUrl} * configuration option. * - * @since 3.0 + * @since 3.0.0 * @cfg {String} [filebrowserUploadUrl='' (empty string = disabled)] * @member CKEDITOR.config */ @@ -507,7 +507,7 @@ * * config.filebrowserImageBrowseUrl = '/browser/browse.php?type=Images'; * - * @since 3.0 + * @since 3.0.0 * @cfg {String} [filebrowserImageBrowseUrl='' (empty string = disabled)] * @member CKEDITOR.config */ @@ -523,7 +523,7 @@ * * config.filebrowserFlashBrowseUrl = '/browser/browse.php?type=Flash'; * - * @since 3.0 + * @since 3.0.0 * @cfg {String} [filebrowserFlashBrowseUrl='' (empty string = disabled)] * @member CKEDITOR.config */ @@ -542,7 +542,7 @@ * To configure {@glink guide/dev_file_upload uploading dropped or pasted files} use the {@link CKEDITOR.config#uploadUrl} * or {@link CKEDITOR.config#imageUploadUrl} configuration option. * - * @since 3.0 + * @since 3.0.0 * @cfg {String} [filebrowserImageUploadUrl='' (empty string = disabled)] * @member CKEDITOR.config */ @@ -557,7 +557,7 @@ * * config.filebrowserFlashUploadUrl = '/uploader/upload.php?type=Flash'; * - * @since 3.0 + * @since 3.0.0 * @cfg {String} filebrowserFlashUploadUrl='' (empty string = disabled)] * @member CKEDITOR.config */ @@ -573,7 +573,7 @@ * * config.filebrowserImageBrowseLinkUrl = '/browser/browse.php'; * - * @since 3.2 + * @since 3.2.0 * @cfg {String} [filebrowserImageBrowseLinkUrl='' (empty string = disabled)] * @member CKEDITOR.config */ diff --git a/plugins/filetools/plugin.js b/plugins/filetools/plugin.js index da5f645dc65..83c1e6a4bbd 100644 --- a/plugins/filetools/plugin.js +++ b/plugins/filetools/plugin.js @@ -17,7 +17,7 @@ * var loader = editor.uploadRepository.create( file ); * loader.loadAndUpload( 'http://foo/bar' ); * - * @since 4.5 + * @since 4.5.0 * @readonly * @property {CKEDITOR.fileTools.uploadRepository} uploadRepository * @member CKEDITOR.editor @@ -29,7 +29,7 @@ * {@link CKEDITOR.eventInfo#stop stopped} or {@link CKEDITOR.eventInfo#cancel canceled}, the default request * will be sent. Refer to the {@glink guide/dev_file_upload Uploading Dropped or Pasted Files} article for more information. * - * @since 4.5 + * @since 4.5.0 * @event fileUploadRequest * @member CKEDITOR.editor * @param data @@ -81,7 +81,7 @@ * the default response handler will be used. Refer to the * {@glink guide/dev_file_upload Uploading Dropped or Pasted Files} article for more information. * - * @since 4.5 + * @since 4.5.0 * @event fileUploadResponse * @member CKEDITOR.editor * @param data All data will be passed to {@link CKEDITOR.fileTools.fileLoader#responseData}. @@ -133,7 +133,7 @@ * * To find more information about handling files see the {@link CKEDITOR.fileTools.fileLoader} class. * - * @since 4.5 + * @since 4.5.0 * @class CKEDITOR.fileTools.uploadRepository * @mixins CKEDITOR.event * @constructor Creates an instance of the repository. @@ -261,7 +261,7 @@ * * Note that `FileLoader` uses the native file API which is supported **since Internet Explorer 10**. * - * @since 4.5 + * @since 4.5.0 * @class CKEDITOR.fileTools.fileLoader * @mixins CKEDITOR.event * @constructor Creates an instance of the class and sets initial values for all properties. @@ -803,7 +803,7 @@ /** * Helpers to load and upload a file. * - * @since 4.5 + * @since 4.5.0 * @singleton * @class CKEDITOR.fileTools */ @@ -892,7 +892,7 @@ * * An empty string means that the option is disabled. * - * @since 4.5 + * @since 4.5.0 * @cfg {String} [uploadUrl=''] * @member CKEDITOR.config */ diff --git a/plugins/floatingspace/plugin.js b/plugins/floatingspace/plugin.js index 9c68fa0d2fc..52b79123bc5 100644 --- a/plugins/floatingspace/plugin.js +++ b/plugins/floatingspace/plugin.js @@ -388,7 +388,7 @@ * * config.floatSpacePreferRight = true; * - * @since 4.5 + * @since 4.5.0 * @cfg {Boolean} [floatSpacePreferRight=false] * @member CKEDITOR.config */ @@ -397,7 +397,7 @@ * Fired when the viewport or editor parameters change and the floating space needs to check and * eventually update its position and dimensions. * - * @since 4.5 + * @since 4.5.0 * @event floatingSpaceLayout * @member CKEDITOR.editor * @param {CKEDITOR.editor} editor The editor instance. diff --git a/plugins/image/plugin.js b/plugins/image/plugin.js index 8766e4d6def..3010ffd9558 100644 --- a/plugins/image/plugin.js +++ b/plugins/image/plugin.js @@ -159,7 +159,7 @@ * * config.image_prefillDimensions = false; * - * @since 4.5 + * @since 4.5.0 * @cfg {Boolean} [image_prefillDimensions=true] * @member CKEDITOR.config */ diff --git a/plugins/image2/plugin.js b/plugins/image2/plugin.js index eef74b06d4c..545a0ddc291 100644 --- a/plugins/image2/plugin.js +++ b/plugins/image2/plugin.js @@ -1668,7 +1668,7 @@ CKEDITOR.config.image2_captionedClass = 'image'; * * config.image2_prefillDimensions = false; * - * @since 4.5 + * @since 4.5.0 * @cfg {Boolean} [image2_prefillDimensions=true] * @member CKEDITOR.config */ @@ -1681,7 +1681,7 @@ CKEDITOR.config.image2_captionedClass = 'image'; * * config.image2_disableResizer = true; * - * @since 4.5 + * @since 4.5.0 * @cfg {Boolean} [image2_disableResizer=false] * @member CKEDITOR.config */ @@ -1739,7 +1739,7 @@ CKEDITOR.config.image2_captionedClass = 'image'; * Read more in the [documentation](#!/guide/dev_image2) and see the * {@glink examples/image2 example}. * - * @since 4.4 + * @since 4.4.0 * @cfg {String[]} [image2_alignClasses=null] * @member CKEDITOR.config */ diff --git a/plugins/lineutils/plugin.js b/plugins/lineutils/plugin.js index 39f5586c887..bbba038616c 100644 --- a/plugins/lineutils/plugin.js +++ b/plugins/lineutils/plugin.js @@ -3,7 +3,7 @@ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license */ - /** +/** * @fileOverview A set of utilities to find and create horizontal spaces in edited content. */ @@ -49,7 +49,7 @@ * @constructor Creates a Finder class instance. * @param {CKEDITOR.editor} editor Editor instance that the Finder belongs to. * @param {Object} def Finder's definition. - * @since 4.3 + * @since 4.3.0 */ function Finder( editor, def ) { CKEDITOR.tools.extend( this, { @@ -456,7 +456,7 @@ * @class CKEDITOR.plugins.lineutils.locator * @constructor Creates a Locator class instance. * @param {CKEDITOR.editor} editor Editor instance that Locator belongs to. - * @since 4.3 + * @since 4.3.0 */ function Locator( editor, def ) { CKEDITOR.tools.extend( this, def, { @@ -630,7 +630,7 @@ * @constructor Creates a Liner class instance. * @param {CKEDITOR.editor} editor Editor instance that Liner belongs to. * @param {Object} def Liner's definition. - * @since 4.3 + * @since 4.3.0 */ function Liner( editor, def ) { var editable = editor.editable(); @@ -1008,7 +1008,7 @@ * @private * @class * @singleton - * @since 4.3 + * @since 4.3.0 */ CKEDITOR.plugins.lineutils = { finder: Finder, diff --git a/plugins/link/dialogs/link.js b/plugins/link/dialogs/link.js index 44dd81e2de2..47350eb2589 100755 --- a/plugins/link/dialogs/link.js +++ b/plugins/link/dialogs/link.js @@ -1061,7 +1061,7 @@ * // href="javascript:mt('tester','ckeditor.com','subject','body')" * config.emailProtection = 'mt(NAME,DOMAIN,SUBJECT,BODY)'; * - * @since 3.1 + * @since 3.1.0 * @cfg {String} [emailProtection='' (empty string = disabled)] * @member CKEDITOR.config */ diff --git a/plugins/link/plugin.js b/plugins/link/plugin.js index 48b58ff11ba..684c4c22a64 100755 --- a/plugins/link/plugin.js +++ b/plugins/link/plugin.js @@ -449,7 +449,7 @@ * **Note:** Data model format produced by the parser must be compatible with the Link * plugin dialog because it is passed directly to {@link CKEDITOR.dialog#setupContent}. * - * @since 4.4 + * @since 4.4.0 * @param {CKEDITOR.editor} editor * @param {CKEDITOR.dom.element} element * @returns {Object} An object of link data. @@ -587,7 +587,7 @@ * of attributes to be set (with their values) and an array of attributes to be removed. * This method can be used to compose or to update any link element with the given data. * - * @since 4.4 + * @since 4.4.0 * @param {CKEDITOR.editor} editor * @param {Object} data Data in {@link #parseLinkAttributes} format. * @returns {Object} An object consisting of two keys, i.e.: diff --git a/plugins/mathjax/plugin.js b/plugins/mathjax/plugin.js index 4323e0fb1a7..2f4b1e474fd 100644 --- a/plugins/mathjax/plugin.js +++ b/plugins/mathjax/plugin.js @@ -448,7 +448,7 @@ * **Note:** Since CKEditor 4.5 this option does not have a default value, so it must * be set in order to enable the MathJax plugin. * - * @since 4.3 + * @since 4.3.0 * @cfg {String} mathJaxLib * @member CKEDITOR.config */ diff --git a/plugins/notification/plugin.js b/plugins/notification/plugin.js index e1402e6083c..3e8842f3847 100644 --- a/plugins/notification/plugin.js +++ b/plugins/notification/plugin.js @@ -106,7 +106,7 @@ * * Refer to the [Notifications](https://ckeditor.com/docs/ckeditor4/latest/guide/dev_notifications.html) article for more information about this feature. * - * @since 4.5 + * @since 4.5.0 * @class CKEDITOR.plugins.notification * @constructor Create a notification object. Call {@link #show} to show the created notification. * @param {CKEDITOR.editor} editor The editor instance. @@ -435,7 +435,7 @@ * When the first notification is added, the area is shown and all listeners are added. * When the last notification is removed, the area is hidden and all listeners are removed. * - * @since 4.5 + * @since 4.5.0 * @private * @class CKEDITOR.plugins.notification.area * @constructor @@ -876,7 +876,7 @@ * Refer to the [Notifications](https://ckeditor.com/docs/ckeditor4/latest/guide/dev_notifications.html) article * for more information about this feature. * - * @since 4.5 + * @since 4.5.0 * @cfg {Number} [notification_duration=5000] * @member CKEDITOR.config */ @@ -888,7 +888,7 @@ * Using this event allows you to fully customize how a notification will be shown. It may be used to integrate * the CKEditor notification system with your web page notifications. * - * @since 4.5 + * @since 4.5.0 * @event notificationShow * @member CKEDITOR.editor * @param data @@ -905,7 +905,7 @@ * Using this event allows you to fully customize how a notification will be updated. It may be used to integrate * the CKEditor notification system with your web page notifications. * - * @since 4.5 + * @since 4.5.0 * @event notificationUpdate * @member CKEDITOR.editor * @param data @@ -922,7 +922,7 @@ * Using this event allows you to fully customize how a notification will be hidden. It may be used to integrate * the CKEditor notification system with your web page notifications. * - * @since 4.5 + * @since 4.5.0 * @event notificationHide * @member CKEDITOR.editor * @param data diff --git a/plugins/notificationaggregator/plugin.js b/plugins/notificationaggregator/plugin.js index ec3051cdd78..e774ff922ca 100644 --- a/plugins/notificationaggregator/plugin.js +++ b/plugins/notificationaggregator/plugin.js @@ -64,7 +64,7 @@ * taskC.done(); * }, 3000 ); * - * @since 4.5 + * @since 4.5.0 * @class CKEDITOR.plugins.notificationAggregator * @mixins CKEDITOR.event * @constructor Creates a notification aggregator instance. @@ -392,7 +392,7 @@ * and then as the file upload progresses you just call the `update` method with the number of bytes actually * downloaded. * - * @since 4.5 + * @since 4.5.0 * @class CKEDITOR.plugins.notificationAggregator.task * @mixins CKEDITOR.event * @constructor Creates a task instance for notification aggregator. diff --git a/plugins/pastefromword/filter/default.js b/plugins/pastefromword/filter/default.js index 5024c153d3a..b81386caa2c 100644 --- a/plugins/pastefromword/filter/default.js +++ b/plugins/pastefromword/filter/default.js @@ -2586,7 +2586,7 @@ * * @deprecated 4.6.0 Either configure proper {@glink guide/dev_advanced_content_filter Advanced Content Filter} for the editor * or use the {@link CKEDITOR.editor#afterPasteFromWord} event. - * @since 3.1 + * @since 3.1.0 * @cfg {Boolean} [pasteFromWordRemoveFontStyles=false] * @member CKEDITOR.config */ @@ -2597,7 +2597,7 @@ * config.pasteFromWordNumberedHeadingToList = true; * * @removed 4.6.0 - * @since 3.1 + * @since 3.1.0 * @cfg {Boolean} [pasteFromWordNumberedHeadingToList=false] * @member CKEDITOR.config */ @@ -2610,7 +2610,7 @@ * config.pasteFromWordRemoveStyles = false; * * @removed 4.6.0 - * @since 3.1 + * @since 3.1.0 * @cfg {Boolean} [pasteFromWordRemoveStyles=true] * @member CKEDITOR.config */ diff --git a/plugins/pastefromword/plugin.js b/plugins/pastefromword/plugin.js index 4cbab3d7e4c..d3576d3ac96 100755 --- a/plugins/pastefromword/plugin.js +++ b/plugins/pastefromword/plugin.js @@ -194,7 +194,7 @@ * * config.pasteFromWordPromptCleanup = true; * - * @since 3.1 + * @since 3.1.0 * @cfg {Boolean} [pasteFromWordPromptCleanup=false] * @member CKEDITOR.config */ @@ -214,7 +214,7 @@ * // Load custom.js file from the 'customFilters' folder (located in server's root) using the full URL. * CKEDITOR.config.pasteFromWordCleanupFile = 'http://my.example.com/customFilters/custom.js'; * - * @since 3.1 + * @since 3.1.0 * @cfg {String} [pasteFromWordCleanupFile= + 'filter/default.js'] * @member CKEDITOR.config */ diff --git a/plugins/removeformat/plugin.js b/plugins/removeformat/plugin.js index 0ef71bff368..03ce7526309 100644 --- a/plugins/removeformat/plugin.js +++ b/plugins/removeformat/plugin.js @@ -164,7 +164,7 @@ CKEDITOR.plugins.removeformat = { * return !( element.is( 'span' ) && CKEDITOR.tools.isEmpty( element.getAttributes() ) ); * } ); * - * @since 3.3 + * @since 3.3.0 * @member CKEDITOR.editor * @param {Function} func The function to be called, which will be passed an {@link CKEDITOR.dom.element element} to test. */ diff --git a/plugins/resize/plugin.js b/plugins/resize/plugin.js index fcdcaa412f0..631f552b842 100644 --- a/plugins/resize/plugin.js +++ b/plugins/resize/plugin.js @@ -181,7 +181,7 @@ CKEDITOR.plugins.add( 'resize', { * * config.resize_dir = 'both'; * - * @since 3.3 + * @since 3.3.0 * @cfg {String} [resize_dir='vertical'] * @member CKEDITOR.config */ diff --git a/plugins/save/plugin.js b/plugins/save/plugin.js index d5e9a17aec5..a32b6cb08ce 100644 --- a/plugins/save/plugin.js +++ b/plugins/save/plugin.js @@ -61,7 +61,7 @@ * Fired when the user clicks the Save button on the editor toolbar. * This event allows to overwrite the default Save button behavior. * - * @since 4.2 + * @since 4.2.0 * @event save * @member CKEDITOR.editor * @param {CKEDITOR.editor} editor This editor instance. diff --git a/plugins/stylesheetparser/plugin.js b/plugins/stylesheetparser/plugin.js index 41c93e5e6d8..32f05d5fe6f 100644 --- a/plugins/stylesheetparser/plugin.js +++ b/plugins/stylesheetparser/plugin.js @@ -134,7 +134,7 @@ * // Ignore rules for body and caption elements, classes starting with "high", and any class defined for no specific element. * config.stylesheetParser_skipSelectors = /(^body\.|^caption\.|\.high|^\.)/i; * - * @since 3.6 + * @since 3.6.0 * @cfg {RegExp} [stylesheetParser_skipSelectors=/(^body\.|^\.)/i] * @member CKEDITOR.config * @see CKEDITOR.config#stylesheetParser_validSelectors @@ -151,7 +151,7 @@ * // Only add rules for p and span elements. * config.stylesheetParser_validSelectors = /\^(p|span)\.\w+/; * - * @since 3.6 + * @since 3.6.0 * @cfg {RegExp} [stylesheetParser_validSelectors=/\w+\.\w+/] * @member CKEDITOR.config * @see CKEDITOR.config#stylesheetParser_skipSelectors diff --git a/plugins/toolbar/plugin.js b/plugins/toolbar/plugin.js index b12ce592616..8ce63964c63 100644 --- a/plugins/toolbar/plugin.js +++ b/plugins/toolbar/plugin.js @@ -769,7 +769,7 @@ CKEDITOR.config.toolbarLocation = 'top'; * * config.toolbarGroupCycling = false; * - * @since 3.6 + * @since 3.6.0 * @cfg {Boolean} [toolbarGroupCycling=true] * @member CKEDITOR.config */ diff --git a/plugins/undo/plugin.js b/plugins/undo/plugin.js index 4e96c4ecfa9..5277e53c332 100644 --- a/plugins/undo/plugin.js +++ b/plugins/undo/plugin.js @@ -159,7 +159,7 @@ * **Note:** In order to unlock the undo manager, {@link #unlockSnapshot} has to be fired * the same number of times that `lockSnapshot` has been fired. * - * @since 4.0 + * @since 4.0.0 * @event lockSnapshot * @member CKEDITOR.editor * @param {CKEDITOR.editor} editor This editor instance. @@ -177,7 +177,7 @@ /** * Unlocks the undo manager and updates the latest snapshot. * - * @since 4.0 + * @since 4.0.0 * @event unlockSnapshot * @member CKEDITOR.editor * @param {CKEDITOR.editor} editor This editor instance. @@ -598,7 +598,7 @@ * * **Note:** For every `lock` call you must call {@link #unlock} once to unlock the undo manager. * - * @since 4.0 + * @since 4.0.0 * @param {Boolean} [dontUpdate] When set to `true`, the last snapshot will not be updated * with current content and selection. By default, if undo manager was up to date when the lock started, * the last snapshot will be updated to the current state when unlocking. This means that all changes @@ -649,7 +649,7 @@ * * See {@link #lock} for more details. * - * @since 4.0 + * @since 4.0.0 */ unlock: function() { if ( this.locked ) { @@ -1332,7 +1332,7 @@ * } * } ); * - * @since 4.2 + * @since 4.2.0 * @event change * @member CKEDITOR.editor * @param {CKEDITOR.editor} editor This editor instance. diff --git a/plugins/uploadimage/plugin.js b/plugins/uploadimage/plugin.js index 83afa130f39..16174079da3 100644 --- a/plugins/uploadimage/plugin.js +++ b/plugins/uploadimage/plugin.js @@ -143,7 +143,7 @@ /** * The URL where images should be uploaded. * - * @since 4.5 + * @since 4.5.0 * @cfg {String} [imageUploadUrl='' (empty string = disabled)] * @member CKEDITOR.config */ diff --git a/plugins/widget/plugin.js b/plugins/widget/plugin.js index 7e9f7742aa2..539c618e54b 100644 --- a/plugins/widget/plugin.js +++ b/plugins/widget/plugin.js @@ -104,7 +104,7 @@ * * editor.widgets.registered.someName; // -> Widget definition * - * @since 4.3 + * @since 4.3.0 * @readonly * @property {CKEDITOR.plugins.widget.repository} widgets * @member CKEDITOR.editor @@ -564,7 +564,7 @@ * // Event `action` occurs on `image` widget. * } ); * - * @since 4.5 + * @since 4.5.0 * @param {String} widgetName * @param {String} eventName * @param {Function} listenerFunction @@ -601,7 +601,7 @@ * This method is used by the {@link CKEDITOR.plugins.widget#getClasses} method and * may be used when overriding that method. * - * @since 4.4 + * @since 4.4.0 * @param {String} classes String (value of `class` attribute). * @returns {Object} Object containing classes or `null` if no classes found. */ @@ -817,7 +817,7 @@ * editor.insertElement( element ); * var widget = editor.widgets.initOn( element, 'simplebox' ); * - * @since 4.3 + * @since 4.3.0 * @class CKEDITOR.plugins.widget * @mixins CKEDITOR.event * @extends CKEDITOR.plugins.widget.definition @@ -1017,7 +1017,7 @@ * * See also: {@link #removeClass}, {@link #hasClass}, {@link #getClasses}. * - * @since 4.4 + * @since 4.4.0 * @param {String} className The class name to be added. */ addClass: function( className ) { @@ -1043,7 +1043,7 @@ * * See also: {@link #checkStyleActive}, {@link #removeStyle}. * - * @since 4.4 + * @since 4.4.0 * @param {CKEDITOR.style} style The custom widget style to be applied. */ applyStyle: function( style ) { @@ -1061,7 +1061,7 @@ * * See also: {@link #applyStyle}, {@link #removeStyle}. * - * @since 4.4 + * @since 4.4.0 * @param {CKEDITOR.style} style The custom widget style to be checked. * @returns {Boolean} Whether the style is applied to this widget. */ @@ -1234,7 +1234,7 @@ * * See also: {@link #removeClass}, {@link #addClass}, {@link #hasClass}. * - * @since 4.4 + * @since 4.4.0 * @returns {Object} */ getClasses: function() { @@ -1248,7 +1248,7 @@ * * See also: {@link #removeClass}, {@link #addClass}, {@link #getClasses}. * - * @since 4.4 + * @since 4.4.0 * @param {String} className The class to be checked. * @param {Boolean} Whether a widget has specified class. */ @@ -1312,7 +1312,7 @@ * Looks inside wrapper element to find a node that * matches given selector and is not nested in other widget. (https://dev.ckeditor.com/ticket/13334) * - * @since 4.5 + * @since 4.5.0 * @private * @param {String} selector Selector to match. * @returns {CKEDITOR.dom.element} Matched element or `null` if a node has not been found. @@ -1389,7 +1389,7 @@ * * See also: {@link #hasClass}, {@link #addClass}. * - * @since 4.4 + * @since 4.4.0 * @param {String} className The class to be removed. */ removeClass: function( className ) { @@ -1407,7 +1407,7 @@ * * See also {@link #checkStyleActive}, {@link #applyStyle}, {@link #getClasses}. * - * @since 4.4 + * @since 4.4.0 * @param {CKEDITOR.style} style The custom widget style to be removed. */ removeStyle: function( style ) { @@ -1551,7 +1551,7 @@ * (returned as a {@link CKEDITOR.dom.element}, not as a {@link CKEDITOR.plugins.widget.nestedEditable}) * closest to the `node` or the `node` if it is a nested editable itself. * - * @since 4.5 + * @since 4.5.0 * @static * @param {CKEDITOR.dom.element} guard Stop ancestor search on this node (usually editor's editable). * @param {CKEDITOR.dom.node} node Start the search from this node. @@ -1570,7 +1570,7 @@ /** * Checks whether the `node` is a widget's drag handle element. * - * @since 4.5 + * @since 4.5.0 * @static * @param {CKEDITOR.dom.node} node * @returns {Boolean} @@ -1582,7 +1582,7 @@ /** * Checks whether the `node` is a container of the widget's drag handle element. * - * @since 4.5 + * @since 4.5.0 * @static * @param {CKEDITOR.dom.node} node * @returns {Boolean} @@ -1596,7 +1596,7 @@ * Note that this function only checks whether it is the right element, not whether * the passed `node` is an instance of {@link CKEDITOR.plugins.widget.nestedEditable}. * - * @since 4.5 + * @since 4.5.0 * @static * @param {CKEDITOR.dom.node} node * @returns {Boolean} @@ -1608,7 +1608,7 @@ /** * Checks whether the `node` is a {@link CKEDITOR.plugins.widget#element widget element}. * - * @since 4.5 + * @since 4.5.0 * @static * @param {CKEDITOR.dom.node} node * @returns {Boolean} @@ -1620,7 +1620,7 @@ /** * Checks whether the `node` is a {@link CKEDITOR.plugins.widget#wrapper widget wrapper}. * - * @since 4.5 + * @since 4.5.0 * @static * @param {CKEDITOR.dom.element} node * @returns {Boolean} @@ -1644,7 +1644,7 @@ /** * Checks whether the `node` is a {@link CKEDITOR.plugins.widget#element widget element}. * - * @since 4.5 + * @since 4.5.0 * @static * @param {CKEDITOR.htmlParser.node} node * @returns {Boolean} @@ -1656,7 +1656,7 @@ /** * Checks whether the `node` is a {@link CKEDITOR.plugins.widget#wrapper widget wrapper}. * - * @since 4.5 + * @since 4.5.0 * @static * @param {CKEDITOR.htmlParser.element} node * @returns {Boolean} @@ -3656,7 +3656,7 @@ * **Note:** This custom style handler does not support all methods of the {@link CKEDITOR.style} class. * Not supported methods: {@link #applyToRange}, {@link #removeFromRange}, {@link #applyToObject}. * - * @since 4.4 + * @since 4.4.0 * @class CKEDITOR.style.customHandlers.widget * @extends CKEDITOR.style */ @@ -4056,7 +4056,7 @@ * The {@link #upcast} method(s) priority. The upcast with a lower priority number will be called before * the one with a higher number. The default priority is `10`. * - * @since 4.5 + * @since 4.5.0 * @property {Number} [upcastPriority=10] */ @@ -4270,7 +4270,7 @@ * If you need to have more freedom when transforming widget style to allowed content rules, * you can use the {@link #styleToAllowedContentRules} callback. * - * @since 4.4 + * @since 4.4.0 * @property {String} styleableElements */ @@ -4308,7 +4308,7 @@ * } * } ); * - * @since 4.4 + * @since 4.4.0 * @property {Function} styleToAllowedContentRules * @param {CKEDITOR.style.customHandlers.widget} style The style to be transformed. * @returns {CKEDITOR.filter.allowedContentRules} diff --git a/plugins/wysiwygarea/plugin.js b/plugins/wysiwygarea/plugin.js index 689792ef15d..7f50101ffc6 100644 --- a/plugins/wysiwygarea/plugin.js +++ b/plugins/wysiwygarea/plugin.js @@ -104,7 +104,7 @@ * * editor.addContentsCss( 'assets/contents.css' ); * - * @since 4.4 + * @since 4.4.0 * @param {String} cssPath The path to the stylesheet file which should be added. * @member CKEDITOR.editor */ @@ -700,7 +700,7 @@ CKEDITOR.config.disableNativeSpellChecker = true; * config.autoParagraph = false; * * @deprecated - * @since 3.6 + * @since 3.6.0 * @cfg {Boolean} [autoParagraph=true] * @member CKEDITOR.config */ diff --git a/tests/_assets/custom_styles.js b/tests/_assets/custom_styles.js index 0524d714656..5a5b431f129 100644 --- a/tests/_assets/custom_styles.js +++ b/tests/_assets/custom_styles.js @@ -6,4 +6,4 @@ CKEDITOR.stylesSet.add( 'external', [ { name: 'Italic Title', element: 'h2', styles: { 'font-style': 'italic' } }, { name: 'Big', element: 'big' } -] ); \ No newline at end of file +] ); diff --git a/tests/core/dom/range/native.js b/tests/core/dom/range/native.js index ee33175bc9a..186e2b9be0f 100644 --- a/tests/core/dom/range/native.js +++ b/tests/core/dom/range/native.js @@ -131,4 +131,4 @@ assert.areSame( 2, range.startOffset, 'startOffset' ); } } ); -} )(); \ No newline at end of file +} )(); diff --git a/tests/core/editable/keystrokes/keystrokes.js b/tests/core/editable/keystrokes/keystrokes.js index f8e98608413..87174fa1d97 100644 --- a/tests/core/editable/keystrokes/keystrokes.js +++ b/tests/core/editable/keystrokes/keystrokes.js @@ -170,12 +170,12 @@ bender.test( { }, // https://dev.ckeditor.com/ticket/13096 - 'test deleting text without selection with DEL key': function() { + 'test deleting text without selection with DEL key': function() { var editor = this.editor, bot = this.editorBot; editor.focus(); - bot.setHtmlWithSelection('

^Foo

'); + bot.setHtmlWithSelection( '

^Foo

' ); editor.getSelection().removeAllRanges(); editor.fire( 'key', { domEvent: { @@ -192,7 +192,7 @@ bender.test( { bot = this.editorBot; editor.focus(); - bot.setHtmlWithSelection('

^Foo

'); + bot.setHtmlWithSelection( '

^Foo

' ); editor.getSelection().removeAllRanges(); editor.fire( 'key', { domEvent: { diff --git a/tests/core/filter/_helpers/tools.js b/tests/core/filter/_helpers/tools.js index 681ed9ae165..5634d83a26c 100644 --- a/tests/core/filter/_helpers/tools.js +++ b/tests/core/filter/_helpers/tools.js @@ -83,4 +83,4 @@ var acfTestTools = ( function() { replaceAtWithBogus: replaceAtWithBogus, createFilterTester: createFilterTester }; -} )(); \ No newline at end of file +} )();