Method signatures for the CKEDITOR.htmlDataProcessor class don't match the editor.dataProcessor API

[Enquier]

Type of report

Docs

Provide a description of requested docs changes

The method signatures of the htmlDataProcesser were updated in 4.3.0, but the documentation still shows the older "backwards compatible" method signatures

See:
https://ckeditor.com/docs/ckeditor4/latest/api/CKEDITOR_htmlDataProcessor.html#method-toHtml

which has the now "options" field instead populated by an array.

[jacekbogdanski]

Thanks @Enquier, indeed I see that these signatures don't match with the CKEDITOR.htmlDataProcessor class -

ckeditor4/core/htmldataprocessor.js

Lines 211 to 238 in b520aa2

	/**
	* Processes the (potentially malformed) input HTML to a purified form which
	* is suitable for using in the WYSIWYG editable.
	*
	* This method fires the {@link CKEDITOR.editor#toHtml} event which makes it possible
	* to hook into the process at various stages.
	*
	* **Note:** Since CKEditor 4.3.0 the signature of this method changed and all options
	* are now grouped in one `options` object. Previously `context`, `fixForBody` and `dontFilter`
	* were passed separately.
	*
	* @param {String} data The raw data.
	* @param {Object} [options] The options object.
	* @param {String} [options.context] The tag name of a context element within which
	* the input is to be processed, defaults to the editable element.
	* If `null` is passed, then data will be parsed without context (as children of {@link CKEDITOR.htmlParser.fragment}).
	* See {@link CKEDITOR.htmlParser.fragment#fromHtml} for more details.
	* @param {Boolean} [options.fixForBody=true] Whether to trigger the auto paragraph for non-block content.
	* @param {CKEDITOR.filter} [options.filter] When specified, instead of using the {@link CKEDITOR.editor#filter main filter},
	* the passed instance will be used to filter the content.
	* @param {Boolean} [options.dontFilter] Do not filter data with {@link CKEDITOR.filter} (note: transformations
	* will still be applied).
	* @param {Number} [options.enterMode] When specified, it will be used instead of the {@link CKEDITOR.editor#enterMode main enterMode}.
	* @param {Boolean} [options.protectedWhitespaces] Indicates that content was wrapped with `<span>` elements to preserve
	* leading and trailing whitespaces. Option used by the {@link CKEDITOR.editor#method-insertHtml} method.
	* @returns {String}
	*/
	toHtml: function( data, options, fixForBody, dontFilter ) {

I'm wondering if these couldn't be inherited using the @inheritdoc feature.