diff -r c7c34916027a -r 177826044cd9 wp/wp-includes/js/autosave.js --- a/wp/wp-includes/js/autosave.js Mon Oct 14 18:06:33 2019 +0200 +++ b/wp/wp-includes/js/autosave.js Mon Oct 14 18:28:13 2019 +0200 @@ -1,3 +1,7 @@ +/** + * @output wp-includes/js/autosave.js + */ + /* global tinymce, wpCookies, autosaveL10n, switchEditors */ // Back-compat window.autosave = function() { @@ -5,7 +9,7 @@ }; /** - * @summary Adds autosave to the window object on dom ready. + * Adds autosave to the window object on dom ready. * * @since 3.9.0 * @@ -15,7 +19,7 @@ */ ( function( $, window ) { /** - * @summary Auto saves the post. + * Auto saves the post. * * @since 3.9.0 * @@ -36,7 +40,7 @@ $document = $(document); /** - * @summary Returns the data saved in both local and remote autosave. + * Returns the data saved in both local and remote autosave. * * @since 3.9.0 * @@ -99,9 +103,8 @@ } /** - * @summary Concatenates the title, content and excerpt. - * - * This is used to track changes when auto-saving. + * Concatenates the title, content and excerpt. This is used to track changes + * when auto-saving. * * @since 3.9.0 * @@ -118,7 +121,7 @@ } /** - * @summary Disables save buttons. + * Disables save buttons. * * @since 3.9.0 * @@ -132,7 +135,7 @@ } /** - * @summary Enables save buttons. + * Enables save buttons. * * @since 3.9.0 * @@ -143,7 +146,7 @@ } /** - * @summary Gets the content editor. + * Gets the content editor. * * @since 4.6.0 * @@ -155,7 +158,7 @@ } /** - * @summary Autosave in localStorage. + * Autosave in localStorage. * * @since 3.9.0 * @@ -176,7 +179,7 @@ isSuspended = false; /** - * @summary Checks if the browser supports sessionStorage and it's not disabled. + * Checks if the browser supports sessionStorage and it's not disabled. * * @since 3.9.0 * @@ -197,7 +200,7 @@ } /** - * @summary Initializes the local storage. + * Initializes the local storage. * * @since 3.9.0 * @@ -221,9 +224,8 @@ } /** - * @summary Sets the storage for this blog. - * - * Confirms that the data was saved successfully. + * Sets the storage for this blog. Confirms that the data was saved + * successfully. * * @since 3.9.0 * @@ -242,7 +244,7 @@ } /** - * @summary Gets the saved post data for the current post. + * Gets the saved post data for the current post. * * @since 3.9.0 * @@ -259,7 +261,7 @@ } /** - * @summary Sets (save or delete) post data in the storage. + * Sets (save or delete) post data in the storage. * * If stored_data evaluates to 'false' the storage key for the current post will be removed. * @@ -288,7 +290,7 @@ } /** - * @summary Sets isSuspended to true. + * Sets isSuspended to true. * * @since 3.9.0 * @@ -299,7 +301,7 @@ } /** - * @summary Sets isSuspended to false. + * Sets isSuspended to false. * * @since 3.9.0 * @@ -310,7 +312,7 @@ } /** - * @summary Saves post data for the current post. + * Saves post data for the current post. * * Runs on a 15 sec. interval, saves when there are differences in the post title or content. * When the optional data is provided, updates the last saved post data. @@ -359,7 +361,7 @@ } /** - * @summary Initializes the auto save function. + * Initializes the auto save function. * * Checks whether the editor is active or not to use the editor events * to autosave, or uses the values from the elements to autosave. @@ -419,9 +421,7 @@ } /** - * @summary Compares 2 strings. - * - * Removes whitespaces in the strings before comparing them. + * Compares 2 strings. Removes whitespaces in the strings before comparing them. * * @since 3.9.0 * @@ -438,8 +438,8 @@ } /** - * @summary Checks if the saved data for the current post (if any) is different - * than the loaded post data on the screen. + * Checks if the saved data for the current post (if any) is different than the + * loaded post data on the screen. * * Shows a standard message letting the user restore the post data if different. * @@ -507,7 +507,7 @@ } /** - * @summary Restores the current title, content and excerpt from postData. + * Restores the current title, content and excerpt from postData. * * @since 3.9.0 * @@ -575,7 +575,7 @@ } /** - * @summary Auto saves the post on the server. + * Auto saves the post on the server. * * @since 3.9.0 * @@ -596,7 +596,7 @@ /** - * @summary Blocks saving for the next 10 seconds. + * Blocks saving for the next 10 seconds. * * @since 3.9.0 * @@ -612,7 +612,7 @@ } /** - * @summary Sets isSuspended to true. + * Sets isSuspended to true. * * @since 3.9.0 * @@ -623,7 +623,7 @@ } /** - * @summary Sets isSuspended to false. + * Sets isSuspended to false. * * @since 3.9.0 * @@ -634,7 +634,7 @@ } /** - * @summary Triggers the autosave with the post data. + * Triggers the autosave with the post data. * * @since 3.9.0 * @@ -658,7 +658,7 @@ } /** - * @summary Saves immediately. + * Saves immediately. * * Resets the timing and tells heartbeat to connect now. * @@ -672,7 +672,7 @@ } /** - * @summary Checks if the post content in the textarea has changed since page load. + * Checks if the post content in the textarea has changed since page load. * * This also happens when TinyMCE is active and editor.save() is triggered by * wp.autosave.getPostData(). @@ -686,7 +686,7 @@ } /** - * @summary Checks if the post can be saved or not. + * Checks if the post can be saved or not. * * If the post hasn't changed or it cannot be updated, * because the autosave is blocked or suspended, the function returns false. @@ -733,7 +733,7 @@ } /** - * @summary Sets the next run, based on the autosave interval. + * Sets the next run, based on the autosave interval. * * @private * @@ -746,7 +746,7 @@ } /** - * @summary Sets the autosaveData on the autosave heartbeat. + * Sets the autosaveData on the autosave heartbeat. * * @since 3.9.0 * @@ -760,8 +760,8 @@ } /** - * @summary Triggers the autosave of the post with the autosave data - * on the autosave heartbeat. + * Triggers the autosave of the post with the autosave data on the autosave + * heartbeat. * * @since 3.9.0 * @@ -772,7 +772,7 @@ response( data.wp_autosave ); } /** - * @summary Disables buttons and throws a notice when the connection is lost. + * Disables buttons and throws a notice when the connection is lost. * * @since 3.9.0 * @@ -793,7 +793,7 @@ } /** - * @summary Enables buttons when the connection is restored. + * Enables buttons when the connection is restored. * * @since 3.9.0 * @@ -816,7 +816,7 @@ } /** - * @summary Sets the autosave time out. + * Sets the autosave time out. * * Wait for TinyMCE to initialize plus 1 second. for any external css to finish loading, * then save to the textarea before setting initialCompareString.