Ticket #42680: edit-image.diff

src/wp-includes/js/media/controllers/edit-image.js

@@ -32 +32 @@
         },
 
         /**
+         * Activates a frame for editing a featured image.
+         *
          * @since 3.9.0
+         *
+         * @returns {void}
          */
         activate: function() {
                 this.frame.on( 'toolbar:render:edit-image', _.bind( this.toolbar, this ) );
         },
 
         /**
+         * Deactivates a frame for editing a featured image.
+         *
          * @since 3.9.0
+         *
+         * @returns {void}
          */
         deactivate: function() {
                 this.frame.off( 'toolbar:render:edit-image' );
         },
 
         /**
+         * @summary Adds a toolbar with a back button.
+         *
+         * When the back button is pressed it checks whether there is a previous state.
+         * In case there is a previous state it sets that previous state otherwise it
+         * closes the frame.
+         *
          * @since 3.9.0
+         *
+         * @returns {void}
          */
         toolbar: function() {
                 var frame = this.frame,