WordPress.org
Get WordPress

Make WordPress Core

Changeset 46800


Ignore:
Timestamp:
11/29/2019 05:59:47 PM (7 years ago)
Author:
SergeyBiryukov
Message:

Docs: Replace @returns tags in JS docs with @return.

Per the documentation standards, @returns is an unsupported synonym, @return should be used instead:
​https://make.wordpress.org/core/handbook/best-practices/inline-documentation-standards/javascript/

See #48303.

Location:
trunk/src/js
Files:
86 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/js/_enqueues/admin/comment.js

    r43347 r46800  
    2828         *
    2929         * @param {Event} event The event object.
    30          * @returns {void}
     30         * @return {void}
    3131         */
    3232        $edittimestamp.click( function( event ) {
    … …  
    4747         *
    4848         * @param {Event} event The event object.
    49          * @returns {void}
     49         * @return {void}
    5050         */
    5151
    … …  
    6969         *
    7070         * @param {Event} event The event object.
    71          * @returns {void}
     71         * @return {void}
    7272         */
    7373        $timestampdiv.find('.save-timestamp').click( function( event ) { // crazyhorse - multiple ok cancels

  • trunk/src/js/_enqueues/admin/common.js

    r46250 r46800  
    4343         * @since 2.7.0
    4444         *
    45          * @returns {void}
     45         * @return {void}
    4646         */
    4747        init : function() {
    … …  
    6565         * @since 3.0.0
    6666         *
    67          * @returns {void}
     67         * @return {void}
    6868         */
    6969        saveManageColumnsState : function() {
    … …  
    8383         * @param {string} column The column name.
    8484         *
    85          * @returns {void}
     85         * @return {void}
    8686         */
    8787        checked : function(column) {
    … …  
    9696         * @param {string} column The column name.
    9797         *
    98          * @returns {void}
     98         * @return {void}
    9999         */
    100100        unchecked : function(column) {
    … …  
    108108         * @since 3.0.0
    109109         *
    110          * @returns {string} The hidden column names separated by a comma.
     110         * @return {string} The hidden column names separated by a comma.
    111111         */
    112112        hidden : function() {
    … …  
    121121         * @since 3.0.0
    122122         *
    123          * @returns {string} String containing the checked column names.
     123         * @return {string} String containing the checked column names.
    124124         */
    125125        useCheckboxesForHidden : function() {
    … …  
    157157 * @param {jQuery} form The form to validate.
    158158 *
    159  * @returns {boolean} Returns true if all required fields are not an empty string.
     159 * @return {boolean} Returns true if all required fields are not an empty string.
    160160 */
    161161window.validateForm = function( form ) {
    … …  
    177177 * @type {{warn: showNotice.warn, note: showNotice.note}}
    178178 *
    179  * @returns {void}
     179 * @return {void}
    180180 */
    181181window.showNotice = {
    … …  
    186186         * @since 2.7.0
    187187         *
    188          * @returns {boolean} Returns true if the message is confirmed.
     188         * @return {boolean} Returns true if the message is confirmed.
    189189         */
    190190        warn : function() {
    … …  
    218218 *         close: screenMeta.close}}
    219219 *
    220  * @returns {void}
     220 * @return {void}
    221221 */
    222222window.screenMeta = {
    … …  
    230230         * @since 3.2.0
    231231         *
    232          * @returns {void}
     232         * @return {void}
    233233         */
    234234        init: function() {
    … …  
    245245         * @since 3.2.0
    246246         *
    247          * @returns {void}
     247         * @return {void}
    248248         */
    249249        toggleEvent: function() {
    … …  
    267267         * @param {jQuery} button The toggle button.
    268268         *
    269          * @returns {void}
     269         * @return {void}
    270270         */
    271271        open: function( panel, button ) {
    … …  
    280280                 * @since 3.2.0
    281281                 *
    282                  * @returns {void}
     282                 * @return {void}
    283283                 */
    284284                panel.slideDown( 'fast', function() {
    … …  
    298298         * @param {jQuery} button The toggle button.
    299299         *
    300          * @returns {void}
     300         * @return {void}
    301301         */
    302302        close: function( panel, button ) {
    … …  
    306306                 * @since 3.2.0
    307307                 *
    308                  * @returns {void}
     308                 * @return {void}
    309309                 */
    310310                panel.slideUp( 'fast', function() {
    … …  
    323323 * @param {Event} e The event object.
    324324 *
    325  * @returns {void}
     325 * @return {void}
    326326 */
    327327$('.contextual-help-tabs').delegate('a', 'click', function(e) {
    … …  
    504504         * @param {Event} e The event object.
    505505         *
    506          * @returns {void}
     506         * @return {void}
    507507         */
    508508        $adminmenu.on('click.wp-submenu-head', '.wp-submenu-head', function(e){
    … …  
    513513         * Collapses the admin menu.
    514514         *
    515          * @returns {void}
     515         * @return {void}
    516516         */
    517517        $( '#collapse-button' ).on( 'click.collapse-menu', function() {
    … …  
    552552         * @since 4.4.0
    553553         *
    554          * @returns {void}
     554         * @return {void}
    555555         */
    556556        function currentMenuItemHasPopup() {
    … …  
    575575         * @param {jQuery} $menuItem The parent menu item containing the submenu.
    576576         *
    577          * @returns {void}
     577         * @return {void}
    578578         */
    579579        function adjustSubmenu( $menuItem ) {
    … …  
    614614                 * @param {Event} e The event object.
    615615                 *
    616                  * @returns {void}
     616                 * @return {void}
    617617                 */
    618618                $body.on( mobileEvent+'.wp-mobile-hover', function(e) {
    … …  
    631631                 * @param {Event} event The event object.
    632632                 *
    633                  * @returns {void}
     633                 * @return {void}
    634634                 */
    635635                $adminmenu.find( 'a.wp-has-submenu' ).on( mobileEvent + '.wp-mobile-hover', function( event ) {
    … …  
    658658                         * Opens the submenu when hovered over the menu item for desktops.
    659659                         *
    660                          * @returns {void}
     660                         * @return {void}
    661661                         */
    662662                        over: function() {
    … …  
    682682                         * Closes the submenu when no longer hovering the menu item.
    683683                         *
    684                          * @returns {void}
     684                         * @return {void}
    685685                         */
    686686                        out: function(){
    … …  
    702702                 * @param {Event} event The event object.
    703703                 *
    704                  * @returns {void}
     704                 * @return {void}
    705705                 */
    706706                $adminmenu.on( 'focus.adminmenu', '.wp-submenu a', function( event ) {
    … …  
    717717                         * @param {Event} event The event object.
    718718                         *
    719                          * @returns {void}
     719                         * @return {void}
    720720                         */
    721721                }).on( 'blur.adminmenu', '.wp-submenu a', function( event ) {
    … …  
    729729                         * Adjusts the size for the submenu.
    730730                         *
    731                          * @returns {void}
     731                         * @return {void}
    732732                         */
    733733                }).find( 'li.wp-has-submenu.wp-not-current-submenu' ).on( 'focusin.adminmenu', function() {
    … …  
    752752         * @since 4.4.0
    753753         *
    754          * @returns {void}
     754         * @return {void}
    755755         */
    756756        function makeNoticesDismissible() {
    … …  
    785785         * This event needs to be delegated. Ticket #37973.
    786786         *
    787          * @returns {boolean} Returns whether a checkbox is checked or not.
     787         * @return {boolean} Returns whether a checkbox is checked or not.
    788788         */
    789789        $body.on( 'click', 'tbody > tr > .check-column :checkbox', function( event ) {
    … …  
    814814                 * Determines if all checkboxes are checked.
    815815                 *
    816                  * @returns {boolean} Returns true if there are no unchecked checkboxes.
     816                 * @return {boolean} Returns true if there are no unchecked checkboxes.
    817817                 */
    818818                $(this).closest('table').children('thead, tfoot').find(':checkbox').prop('checked', function() {
    … …  
    833833         * @param {Event} event The event object.
    834834         *
    835          * @returns {boolean}
     835         * @return {boolean}
    836836         */
    837837        $body.on( 'click.wp-toggle-checkboxes', 'thead .check-column :checkbox, tfoot .check-column :checkbox', function( event ) {
    … …  
    846846                         * Updates the checked state on the checkbox in the table.
    847847                         *
    848                          * @returns {boolean} True checks the checkbox, False unchecks the checkbox.
     848                         * @return {boolean} True checks the checkbox, False unchecks the checkbox.
    849849                         */
    850850                        .prop('checked', function() {
    … …  
    868868                         * Syncs the bulk checkboxes on the top and bottom of the table.
    869869                         *
    870                          * @returns {boolean} True checks the checkbox, False unchecks the checkbox.
     870                         * @return {boolean} True checks the checkbox, False unchecks the checkbox.
    871871                         */
    872872                        .prop('checked', function() {
    … …  
    884884         * Shows row actions on focus of its parent container element or any other elements contained within.
    885885         *
    886          * @returns {void}
     886         * @return {void}
    887887         */
    888888        $( '#wpbody-content' ).on({
    … …  
    919919         * @param {Event} e The event object.
    920920         *
    921          * @returns {void}
     921         * @return {void}
    922922         */
    923923        $('#newcontent').bind('keydown.wpevent_InsertTab', function(e) {
    … …  
    978978                 * The form closest to the pageInput is the post-filter form.
    979979                 *
    980                  * @returns {void}
     980                 * @return {void}
    981981                 */
    982982                pageInput.closest('form').submit( function() {
    … …  
    993993         * Resets the bulk actions when the search button is clicked.
    994994         *
    995          * @returns {void}
     995         * @return {void}
    996996         */
    997997        $('.search-box input[type="search"], .search-box input[type="submit"]').mousedown(function () {
    … …  
    10041004         * @param {Event} e The event object.
    10051005         *
    1006          * @returns {void}
     1006         * @return {void}
    10071007         */
    10081008        $('#contextual-help-link, #show-settings-link').on( 'focus.scroll-into-view', function(e){
    … …  
    10141014         * Disables the submit upload buttons when no data is entered.
    10151015         *
    1016          * @returns {void}
     1016         * @return {void}
    10171017         */
    10181018        (function(){
    … …  
    10311031                 * @since 3.5.0
    10321032                 *
    1033                  * @returns {void}
     1033                 * @return {void}
    10341034                 */
    10351035                function toggleUploadButton() {
    … …  
    10531053         * @since 4.1.0
    10541054         *
    1055          * @returns {void}
     1055         * @return {void}
    10561056         */
    10571057        function pinMenu( event ) {
    … …  
    11961196         * @since 4.1.0
    11971197         *
    1198          * @returns {void}
     1198         * @return {void}
    11991199         */
    12001200        function resetHeights() {
    … …  
    12121212         * @since 4.1.0
    12131213         *
    1214          * @returns {void}
     1214         * @return {void}
    12151215         */
    12161216        function unpinMenu() {
    … …  
    12321232         * @since 4.1.0
    12331233         *
    1234          * @returns {void}
     1234         * @return {void}
    12351235         */
    12361236        function setPinMenu() {
    … …  
    12611261         * @since 3.8.0
    12621262         *
    1263          *@returns {void}
     1263         * @return {void}
    12641264         */
    12651265        window.wpResponsive = {
    … …  
    12701270                 * @since 3.8.0
    12711271                 *
    1272                  * @returns {void}
     1272                 * @return {void}
    12731273                 */
    12741274                init: function() {
    … …  
    13281328                 * @since 5.3.0
    13291329                 *
    1330                  * @returns {void}
     1330                 * @return {void}
    13311331                 */
    13321332                maybeDisableSortables: function() {
    … …  
    13511351                 * @since 3.8.0
    13521352                 *
    1353                  * @returns {void}
     1353                 * @return {void}
    13541354                 */
    13551355                activate: function() {
    … …  
    13721372                 * @since 3.8.0
    13731373                 *
    1374                  * @returns {void}
     1374                 * @return {void}
    13751375                 */
    13761376                deactivate: function() {
    … …  
    13861386                 * @since 3.8.0
    13871387                 *
    1388                  * @returns {void}
     1388                 * @return {void}
    13891389                 */
    13901390                trigger: function() {
    … …  
    14221422                 * @since 3.8.0
    14231423                 *
    1424                  * @returns {void}
     1424                 * @return {void}
    14251425                 */
    14261426                enableOverlay: function() {
    … …  
    14451445                 * @since 3.8.0
    14461446                 *
    1447                  * @returns {void}
     1447                 * @return {void}
    14481448                 */
    14491449                disableOverlay: function() {
    … …  
    14571457                 * @since 3.8.0
    14581458                 *
    1459                  * @returns {void}
     1459                 * @return {void}
    14601460                 */
    14611461                disableSortables: function() {
    … …  
    14731473                 * @since 3.8.0
    14741474                 *
    1475                  * @returns {void}
     1475                 * @return {void}
    14761476                 */
    14771477                enableSortables: function() {
    … …  
    14901490         * @since 4.5.0
    14911491         *
    1492          * @returns {void}
     1492         * @return {void}
    14931493         */
    14941494        function aria_button_if_js() {
    … …  
    15051505         * @since 4.7.0
    15061506         *
    1507          * @returns {number|boolean} The current viewport width or false if the
    1508          *                           browser doesn't support innerWidth (IE < 9).
     1507         * @return {number|boolean} The current viewport width or false if the
     1508         *                          browser doesn't support innerWidth (IE < 9).
    15091509         */
    15101510        function getViewportWidth() {
    … …  
    15271527         * @since 4.7.0
    15281528         *
    1529          * @returns {void}
     1529         * @return {void}
    15301530         */
    15311531        function setMenuState() {
    … …  
    15551555         * @since 4.7.0
    15561556         *
    1557          * @returns {void}
     1557         * @return {void}
    15581558         */
    15591559        $document.on( 'wp-menu-state-set wp-collapse-menu', function( event, eventData ) {
    … …  
    16141614         * @since 3.8.0
    16151615         *
    1616          * @returns {void}
     1616         * @return {void}
    16171617         */
    16181618        function triggerEvent() {
    … …  
    16251625         * @since 3.8.0
    16261626         *
    1627          * @returns {void}
     1627         * @return {void}
    16281628         */
    16291629        function fireOnce() {

  • trunk/src/js/_enqueues/admin/custom-background.js

    r43347 r46800  
    2222                 * @since 3.5.0
    2323                 *
    24                  * @returns {void}
     24                 * @return {void}
    2525                 */
    2626                $('#background-color').wpColorPicker({
    … …  
    3838                 * @since 4.7.0
    3939                 *
    40                  * @returns {void}
     40                 * @return {void}
    4141                 */
    4242                $( 'select[name="background-size"]' ).change( function() {
    … …  
    4949                 * @since 4.7.0
    5050                 *
    51                  * @returns {void}
     51                 * @return {void}
    5252                 */
    5353                $( 'input[name="background-position"]' ).change( function() {
    … …  
    6060                 * @since 3.0.0
    6161                 *
    62                  * @returns {void}
     62                 * @return {void}
    6363                 */
    6464                $( 'input[name="background-repeat"]' ).change( function() {
    … …  
    7171                 * @since 4.7.0
    7272                 *
    73                  * @returns {void}
     73                 * @return {void}
    7474                 */
    7575                $( 'input[name="background-attachment"]' ).change( function() {
    … …  
    8282                 * @since 3.5.0
    8383                 *
    84                  * @returns {void}
     84                 * @return {void}
    8585                 */
    8686                $('#choose-from-library-link').click( function( event ) {
    … …  
    122122                         * @since 3.5.0
    123123                         *
    124                          * @returns {void}
     124                         * @return {void}
    125125                         */
    126126                        frame.on( 'select', function() {

  • trunk/src/js/_enqueues/admin/custom-header.js

    r43347 r46800  
    3434                 * @deprecated 4.1.0
    3535                 *
    36                  * @returns {void}
     36                 * @return {void}
    3737                 */
    3838                $('#choose-from-library-link').click( function( event ) {
    … …  
    7272                         * @deprecated 4.1.0
    7373                         *
    74                          * @returns {void}
     74                         * @return {void}
    7575                         */
    7676                        frame.on( 'select', function() {

  • trunk/src/js/_enqueues/admin/inline-edit-post.js

    r45417 r46800  
    3737         * @since 2.7.0
    3838         *
    39          * @returns {void}
     39         * @return {void}
    4040         */
    4141        init : function(){
    … …  
    4949                 * Binds the escape key to revert the changes and close the quick editor.
    5050                 *
    51                  * @returns {boolean} The result of revert.
     51                 * @return {boolean} The result of revert.
    5252                 */
    5353                qeRow.keyup(function(e){
    … …  
    6161                 * Binds the escape key to revert the changes and close the bulk editor.
    6262                 *
    63                  * @returns {boolean} The result of revert.
     63                 * @return {boolean} The result of revert.
    6464                 */
    6565                bulkRow.keyup(function(e){
    … …  
    7373                 * Reverts changes and close the quick editor if the cancel button is clicked.
    7474                 *
    75                  * @returns {boolean} The result of revert.
     75                 * @return {boolean} The result of revert.
    7676                 */
    7777                $( '.cancel', qeRow ).click( function() {
    … …  
    8282                 * Saves changes in the quick editor if the save(named: update) button is clicked.
    8383                 *
    84                  * @returns {boolean} The result of save.
     84                 * @return {boolean} The result of save.
    8585                 */
    8686                $( '.save', qeRow ).click( function() {
    … …  
    9191                 * If enter is pressed, and the target is not the cancel button, save the post.
    9292                 *
    93                  * @returns {boolean} The result of save.
     93                 * @return {boolean} The result of save.
    9494                 */
    9595                $('td', qeRow).keydown(function(e){
    … …  
    102102                 * Reverts changes and close the bulk editor if the cancel button is clicked.
    103103                 *
    104                  * @returns {boolean} The result of revert.
     104                 * @return {boolean} The result of revert.
    105105                 */
    106106                $( '.cancel', bulkRow ).click( function() {
    … …  
    248248         * @param {number|Object} id The id of the clicked post or an element within a post
    249249         *                           table row.
    250          * @returns {boolean} Always returns false at the end of execution.
     250         * @return {boolean} Always returns false at the end of execution.
    251251         */
    252252        edit : function(id) {
    … …  
    286286                         * Replaces the image for a Twemoji(Twitter emoji) with it's alternate text.
    287287                         *
    288                          * @returns Alternate text from the image.
     288                         * @return {string} Alternate text from the image.
    289289                         */
    290290                        val.find( 'img' ).replaceWith( function() { return this.alt; } );
    … …  
    386386         * @since 2.7.0
    387387         *
    388          * @param   {int}     id The id for the post that has been changed.
    389          * @returns {boolean}    false, so the form does not submit when pressing
    390          *                       Enter on a focused field.
     388         * @param  {int}     id The id for the post that has been changed.
     389         * @return {boolean}    False, so the form does not submit when pressing
     390         *                      Enter on a focused field.
    391391         */
    392392        save : function(id) {
    … …  
    454454         * @since 2.7.0
    455455         *
    456          * @returns {boolean} Always returns false.
     456         * @return {boolean} Always returns false.
    457457         */
    458458        revert : function(){
    … …  
    498498         * @since 2.7.0
    499499         *
    500          * @param   {Object} o DOM row object to get the id for.
    501          * @returns {string}   The post id extracted from the table row in the object.
     500         * @param  {Object} o DOM row object to get the id for.
     501         * @return {string}   The post id extracted from the table row in the object.
    502502         */
    503503        getId : function(o) {

  • trunk/src/js/_enqueues/admin/inline-edit-tax.js

    r43577 r46800  
    3030         * @this inlineEditTax
    3131         * @memberof inlineEditTax
    32          * @returns {void}
     32         * @return {void}
    3333         */
    3434        init : function() {
    … …  
    9797         * @param {HTMLElement} el An element within the table row or the table row
    9898         *                         itself that we want to quick edit.
    99          * @returns {void}
     99         * @return {void}
    100100         */
    101101        toggle : function(el) {
    … …  
    116116         *                                element within the table row or the
    117117         * table row itself.
    118          * @returns {boolean} Always returns false.
     118         * @return {boolean} Always returns false.
    119119         */
    120120        edit : function(id) {
    … …  
    163163         *                                element within the table row or the
    164164         * table row itself.
    165          * @returns {boolean} Always returns false.
     165         * @return {boolean} Always returns false.
    166166         */
    167167        save : function(id) {
    … …  
    256256         * @this inlineEditTax
    257257         * @memberof inlineEditTax
    258          * @returns {void}
     258         * @return {void}
    259259         */
    260260        revert : function() {
    … …  
    281281         *
    282282         * @param {HTMLElement} o An element within the table row or the table row itself.
    283          * @returns {string} The ID of the term based on the element.
     283         * @return {string} The ID of the term based on the element.
    284284         */
    285285        getId : function(o) {

  • trunk/src/js/_enqueues/admin/link.js

    r43352 r46800  
    123123         *
    124124         * @param {Event} event The event object.
    125          * @returns {boolean} Always returns false to prevent regular link
    126          *                    functionality.
     125         * @return {boolean} Always returns false to prevent regular link
     126         *                   functionality.
    127127         */
    128128        $('#category-add-toggle').click( function() {

  • trunk/src/js/_enqueues/admin/media-upload.js

    r43577 r46800  
    2323 *
    2424 * @param {string} html The HTML to be sent to the editor.
    25  * @returns {void|boolean} Returns false when both TinyMCE and QTags instances
    26  *                         are unavailable. This means that the HTML was not
    27  *                         sent to the editor.
     25 * @return {void|boolean} Returns false when both TinyMCE and QTags instances
     26 *                        are unavailable. This means that the HTML was not
     27 *                        sent to the editor.
    2828 */
    2929window.send_to_editor = function( html ) {
    … …  
    7272         * @global
    7373         *
    74          * @returns {Object[]} Array containing jQuery objects for all the found
    75          *                     ThickBox anchors.
     74         * @return {Object[]} Array containing jQuery objects for all the found
     75         *                    ThickBox anchors.
    7676         */
    7777        window.tb_position = function() {

  • trunk/src/js/_enqueues/admin/media.js

    r43577 r46800  
    2727                 * @param {string} af_val The value of the affected post element.
    2828                 *
    29                  * @returns {boolean} Always returns false.
     29                 * @return {boolean} Always returns false.
    3030                 */
    3131                open: function( af_name, af_val ) {
    … …  
    6666                 * @memberOf findPosts
    6767                 *
    68                  * @returns {void}
     68                 * @return {void}
    6969                 */
    7070                close: function() {
    … …  
    8282                 * @memberOf findPosts
    8383                 *
    84                  * @returns {void}
     84                 * @return {void}
    8585                 */
    8686                overlay: function() {
    … …  
    101101                 * @memberOf findPosts
    102102                 *
    103                  * @returns {void}
     103                 * @return {void}
    104104                 */
    105105                send: function() {
    … …  
    139139         * various form elements.
    140140         *
    141          * @returns {void}
     141         * @return {void}
    142142         */
    143143        $( document ).ready( function() {
    … …  
    199199                 * Enables clicking on the entire table row.
    200200                 *
    201                  * @returns {void}
     201                 * @return {void}
    202202                 */
    203203                $( '.find-box-inside' ).on( 'click', 'tr', function() {

  • trunk/src/js/_enqueues/admin/post.js

    r45979 r46800  
    3636                 * @param {int} total Total number of comments for this post.
    3737                 * @param {int} num   Optional. Number of comments to fetch, defaults to 20.
    38                  * @returns {boolean} Always returns false.
     38                 * @return {boolean} Always returns false.
    3939                 */
    4040                get : function(total, num) {
    … …  
    600600                 * @param {Object} s Taxonomy object which will be added.
    601601                 *
    602                  * @returns {Object}
     602                 * @return {Object}
    603603                 */
    604604                catAddBefore = function( s ) {
    … …  
    621621                 * @param {Object} s Taxonomy data.
    622622                 *
    623                  * @returns void
     623                 * @return {void}
    624624                 */
    625625                catAddAfter = function( r, s ) {
    … …  
    667667                         * @param {Object} s Request object.
    668668                         *
    669                          * @returns {Object} Data modified with post_ID attached.
     669                         * @return {Object} Data modified with post_ID attached.
    670670                         */
    671671                        addBefore: function( s ) {
    … …  
    696696                 * @ignore
    697697                 *
    698                  * @returns void
     698                 * @return {void}
    699699                 */
    700700                updateVisibility = function() {
    … …  
    720720                 * @ignore
    721721                 *
    722                  * @returns {boolean} False when an invalid timestamp has been selected, otherwise True.
     722                 * @return {boolean} False when an invalid timestamp has been selected, otherwise True.
    723723                 */
    724724                updateText = function() {
    … …  
    942942         * @global
    943943         *
    944          * @returns void
     944         * @return {void}
    945945         */
    946946        function editPermalink() {
    … …  
    10521052         * @global
    10531053         *
    1054          * @returns void
     1054         * @return {void}
    10551055         */
    10561056        window.wptitlehint = function( id ) {

  • trunk/src/js/_enqueues/admin/postbox.js

    r43577 r46800  
    3636                 * @fires postboxes#postbox-toggled
    3737                 *
    38                  * @returns {void}
     38                 * @return {void}
    3939                 */
    4040                handle_click : function () {
    … …  
    9797                 * @param {Function} args.pbshow A callback that is called when a postbox opens.
    9898                 * @param {Function} args.pbhide A callback that is called when a postbox closes.
    99                  * @returns {void}
     99                 * @return {void}
    100100                 */
    101101                add_postbox_toggles : function (page, args) {
    … …  
    122122                         * @since 3.2.0
    123123                         *
    124                          * @returns {void}
     124                         * @return {void}
    125125                         */
    126126                        $( '.postbox a.dismiss' ).on( 'click.postboxes', function( e ) {
    … …  
    141141                         * @fires postboxes#postbox-toggled
    142142                         *
    143                          * @returns {void}
     143                         * @return {void}
    144144                         */
    145145                        $('.hide-postbox-tog').bind('click.postboxes', function() {
    … …  
    175175                         * @since 2.8.0
    176176                         *
    177                          * @returns {void}
     177                         * @return {void}
    178178                         */
    179179                        $('.columns-prefs input[type="radio"]').bind('click.postboxes', function(){
    … …  
    199199                 *                               closes.
    200200                 *
    201                  * @returns {void}
     201                 * @return {void}
    202202                 */
    203203                init : function(page, args) {
    … …  
    276276                 *
    277277                 * @param {string} page The page we are currently on.
    278                  * @returns {void}
     278                 * @return {void}
    279279                 */
    280280                save_state : function(page) {
    … …  
    307307                 *
    308308                 * @param {string} page The page we are currently on.
    309                  * @returns {void}
     309                 * @return {void}
    310310                 */
    311311                save_order : function(page) {
    … …  
    337337                 * @access private
    338338                 *
    339                  * @returns {void}
     339                 * @return {void}
    340340                 */
    341341                _mark_area : function() {
    … …  
    371371                 *
    372372                 * @param {number} n The amount of columns to divide the post edit page in.
    373                  * @returns {void}
     373                 * @return {void}
    374374                 */
    375375                _pb_edit : function(n) {
    … …  
    399399                 * @access private
    400400                 *
    401                  * @returns {void}
     401                 * @return {void}
    402402                 */
    403403                _pb_change : function() {

  • trunk/src/js/_enqueues/admin/tags-suggest.js

    r45227 r46800  
    3232         *
    3333         * @param {object} options Options that are passed to UI Autocomplete. Can be used to override the default settings.
    34          * @returns {object} jQuery instance.
     34         * @return {object} jQuery instance.
    3535         */
    3636        $.fn.wpTagsSuggest = function( options ) {

  • trunk/src/js/_enqueues/admin/tags.js

    r45683 r46800  
    2121         * @since 2.8.0
    2222         *
    23          * @returns boolean Always returns false to cancel the default event handling.
     23         * @return {boolean} Always returns false to cancel the default event handling.
    2424         */
    2525        $( '#the-list' ).on( 'click', '.delete-tag', function() {
    … …  
    3838                         * @param {string} r The response from the server.
    3939                         *
    40                          * @returns {void}
     40                         * @return {void}
    4141                         */
    4242                        $.post(ajaxurl, data, function(r){
    … …  
    7676         * @since 4.8.0
    7777         *
    78          * @returns {void}
     78         * @return {void}
    7979         */
    8080        $( '#edittag' ).on( 'click', '.delete', function( e ) {
    … …  
    9797         * @since 2.8.0
    9898         *
    99          * @returns boolean Always returns false to cancel the default event handling.
     99         * @return {boolean} Always returns false to cancel the default event handling.
    100100         */
    101101        $('#submit').click(function(){
    … …  
    118118                 * @param {string} r The response from the server.
    119119                 *
    120                  * @returns {void}
     120                 * @return {void}
    121121                 */
    122122                $.post(ajaxurl, $('#addtag').serialize(), function(r){

  • trunk/src/js/_enqueues/lib/color-picker.js

    r46799 r46800  
    4040                 * @access private
    4141                 *
    42                  * @returns {void}
     42                 * @return {void}
    4343                 */
    4444                _createHueOnly: function() {
    … …  
    6666                                 * @param {HTMLElement} ui The HTMLElement containing the color picker.
    6767                                 *
    68                                  * @returns {void}
     68                                 * @return {void}
    6969                                 */
    7070                                change: function( event, ui ) {
    … …  
    8484                 * @access private
    8585                 *
    86                  * @returns {void}
     86                 * @return {void}
    8787                 */
    8888                _create: function() {
    … …  
    187187                                 * @param {HTMLElement} ui The HTMLElement containing the color picker.
    188188                                 *
    189                                  * @returns {void}
     189                                 * @return {void}
    190190                                 */
    191191                                change: function( event, ui ) {
    … …  
    213213                 * @access private
    214214                 *
    215                  * @returns {void}
     215                 * @return {void}
    216216                 */
    217217                _addListeners: function() {
    … …  
    225225                         * @param {Event} event The event that's being called.
    226226                         *
    227                          * @returs {void}
     227                         * @return {void}
    228228                         */
    229229                        self.wrap.on( 'click.wpcolorpicker', function( event ) {
    … …  
    234234                         * Open or close the color picker depending on the class.
    235235                         *
    236                          * @since 3.5
     236                         * @since 3.5.0
    237237                         */
    238238                        self.toggler.click( function(){
    … …  
    252252                         * @param {Event} event The event that's being called.
    253253                         *
    254                          * @returns {void}
     254                         * @return {void}
    255255                         */
    256256                        self.element.change( function( event ) {
    … …  
    274274                         * @param {Event} event The event that's being called.
    275275                         *
    276                          * @returns {void}
     276                         * @return {void}
    277277                         */
    278278                        self.button.click( function( event ) {
    … …  
    294294                 * @since 3.5.0
    295295                 *
    296                  * @returns {void}
     296                 * @return {void}
    297297                 */
    298298                open: function() {
    … …  
    310310                 * @since 3.5.0
    311311                 *
    312                  * @returns {void}
     312                 * @return {void}
    313313                 */
    314314                close: function() {
    … …  
    328328                 * @since 3.5.0
    329329                 *
    330                  * @returns {string} The element's color.
     330                 * @return {string} The element's color.
    331331                 */
    332332                color: function( newColor ) {
    … …  
    344344                 * @since 3.5.0
    345345                 *
    346                  * @returns {boolean|string} The element's color.
     346                 * @return {boolean|string} The element's color.
    347347                 */
    348348                defaultColor: function( newDefaultColor ) {

  • trunk/src/js/_enqueues/lib/image-edit.js

    r46355 r46800  
    7777         *                            instead of true or false.
    7878         *
    79          * @returns {void}
     79         * @return {void}
    8080         */
    8181        setDisabled : function( el, s ) {
    … …  
    101101         * @param {number} postid The post id.
    102102         *
    103          * @returns {void}
     103         * @return {void}
    104104         */
    105105        init : function(postid) {
    … …  
    145145         * @param {number} toggle Is 0 or 1, fades the icon in then 1 and out when 0.
    146146         *
    147          * @returns {void}
     147         * @return {void}
    148148         */
    149149        toggleEditor : function(postid, toggle) {
    … …  
    165165         * @param {HTMLElement} el The element to create the help window in.
    166166         *
    167          * @returns {boolean} Always returns false.
     167         * @return {boolean} Always returns false.
    168168         */
    169169        toggleHelp : function(el) {
    … …  
    187187         * @param {number} postid The post id.
    188188         *
    189          * @returns {string} The value from the imagedit-save-target input field when available,
    190          *                   or 'full' when not available.
     189         * @return {string} The value from the imagedit-save-target input field when available,
     190         *                  or 'full' when not available.
    191191         */
    192192        getTarget : function(postid) {
    … …  
    207207         * @param {jQuery}         el     Element.
    208208         *
    209          * @returns {void}
     209         * @return {void}
    210210         */
    211211        scaleChanged : function( postid, x, el ) {
    … …  
    240240         * @param {number} postid The post id.
    241241         *
    242          * @returns {string} The aspect ratio.
     242         * @return {string} The aspect ratio.
    243243         */
    244244        getSelRatio : function(postid) {
    … …  
    268268         * @param {number} setSize 0 or 1, when 1 the image resets to its original size.
    269269         *
    270          * @returns {string} JSON string containing the history or an empty string if no history exists.
     270         * @return {string} JSON string containing the history or an empty string if no history exists.
    271271         */
    272272        filterHistory : function(postid, setSize) {
    … …  
    334334         * @param {function} callback Function to execute when the image is loaded.
    335335         *
    336          * @returns {void}
     336         * @return {void}
    337337         */
    338338        refreshEditor : function(postid, nonce, callback) {
    … …  
    408408         *                          The possible actions are: "scale" and "restore".
    409409         *
    410          * @returns {boolean|void} Executes a post request that refreshes the page
    411          *                         when the action is performed.
    412          *                         Returns false if a invalid action is given,
    413          *                         or when the action cannot be performed.
     410         * @return {boolean|void} Executes a post request that refreshes the page
     411         *                        when the action is performed.
     412         *                        Returns false if a invalid action is given,
     413         *                        or when the action cannot be performed.
    414414         */
    415415        action : function(postid, nonce, action) {
    … …  
    473473         * @param {string}  nonce    The nonce to verify the request.
    474474         *
    475          * @returns {boolean|void}  If the actions are successfully saved a response message is shown.
    476          *                          Returns false if there is no image editing history,
    477          *                          thus there are not edit-actions performed on the image.
     475         * @return {boolean|void}  If the actions are successfully saved a response message is shown.
     476         *                         Returns false if there is no image editing history,
     477         *                         thus there are not edit-actions performed on the image.
    478478         */
    479479        save : function(postid, nonce) {
    … …  
    539539         * @param {object} view     The image editor view to be used for the editing.
    540540         *
    541          * @returns {void|promise} Either returns void if the button was already activated
    542          *                         or returns an instance of the image editor, wrapped in a promise.
     541         * @return {void|promise} Either returns void if the button was already activated
     542         *                        or returns an instance of the image editor, wrapped in a promise.
    543543         */
    544544        open : function( postid, nonce, view ) {
    … …  
    594594         * @param {number} postid The post id.
    595595         *
    596          * @returns {void}
     596         * @return {void}
    597597         */
    598598        imgLoaded : function(postid) {
    … …  
    622622         * @param {HTMLElement} parent The preview image container.
    623623         *
    624          * @returns {void}
     624         * @return {void}
    625625         */
    626626        initCrop : function(postid, image, parent) {
    … …  
    654654                                 * Binds mouse down event to the cropping container.
    655655                                 *
    656                                  * @returns {void}
     656                                 * @return {void}
    657657                                 */
    658658                                parent.children().on( 'mousedown, touchstart', function(e){
    … …  
    676676                         * @ignore
    677677                         *
    678                          * @returns {void}
     678                         * @return {void}
    679679                         */
    680680                        onSelectStart: function() {
    … …  
    689689                         * @param {object} c   The selection.
    690690                         *
    691                          * @returns {object}
     691                         * @return {object}
    692692                         */
    693693                        onSelectEnd: function(img, c) {
    … …  
    703703                         * @param {object} c   The selection.
    704704                         *
    705                          * @returns {void}
     705                         * @return {void}
    706706                         */
    707707                        onSelectChange: function(img, c) {
    … …  
    722722         * @param {object} c      The selection.
    723723         *
    724          * @returns {boolean}
     724         * @return {boolean}
    725725         */
    726726        setCropSelection : function(postid, c) {
    … …  
    753753         * @param {bool}    warn   Warning message.
    754754         *
    755          * @returns {void|bool} Returns false if there is a warning.
     755         * @return {void|bool} Returns false if there is a warning.
    756756         */
    757757        close : function(postid, warn) {
    … …  
    793793         * @param {number} postid The post id.
    794794         *
    795          * @returns {boolean} Returns true if the history is not saved.
     795         * @return {boolean} Returns true if the history is not saved.
    796796         */
    797797        notsaved : function(postid) {
    … …  
    819819         * @param {string} nonce  The nonce.
    820820         *
    821          * @returns {void}
     821         * @return {void}
    822822         */
    823823        addStep : function(op, postid, nonce) {
    … …  
    853853         * @param {object} t      The target element.
    854854         *
    855          * @returns {boolean}
     855         * @return {boolean}
    856856         */
    857857        rotate : function(angle, postid, nonce, t) {
    … …  
    874874         * @param {object} t      The target element.
    875875         *
    876          * @returns {boolean}
     876         * @return {boolean}
    877877         */
    878878        flip : function (axis, postid, nonce, t) {
    … …  
    894894         * @param {object} t      The target object.
    895895         *
    896          * @returns {void|boolean} Returns false if the crop button is disabled.
     896         * @return {void|boolean} Returns false if the crop button is disabled.
    897897         */
    898898        crop : function (postid, nonce, t) {
    … …  
    922922         * @param {string} nonce    The nonce.
    923923         *
    924          * @returns {void|false} Returns false if the undo button is disabled.
     924         * @return {void|false} Returns false if the undo button is disabled.
    925925         */
    926926        undo : function (postid, nonce) {
    … …  
    955955         * @param {string} nonce  The nonce.
    956956         *
    957          * @returns {void}
     957         * @return {void}
    958958         */
    959959        redo : function(postid, nonce) {
    … …  
    985985         * @param {jQuery} el     The element containing the values.
    986986         *
    987          * @returns {void|boolean} Returns false when the x or y value is lower than 1,
    988          *                         void when the value is not numeric or when the operation
    989          *                         is successful.
     987         * @return {void|boolean} Returns false when the x or y value is lower than 1,
     988         *                        void when the value is not numeric or when the operation
     989         *                        is successful.
    990990         */
    991991        setNumSelection : function( postid, el ) {
    … …  
    10411041         * @param {number} num The number.
    10421042         *
    1043          * @returns {number} The number rounded to a whole number.
     1043         * @return {number} The number rounded to a whole number.
    10441044         */
    10451045        round : function(num) {
    … …  
    10721072         * @param {jQuery} el         The element containing the values.
    10731073         *
    1074          * @returns {void}
     1074         * @return {void}
    10751075         */
    10761076        setRatioSelection : function(postid, n, el) {
    … …  
    11141114         * @param {jQuery} el The html element.
    11151115         *
    1116          * @returns {void|boolean} Returns false if the value is not numeric,
    1117          *                         void when it is.
     1116         * @return {void|boolean} Returns false if the value is not numeric,
     1117         *                        void when it is.
    11181118         */
    11191119        validateNumeric: function( el ) {

  • trunk/src/js/_enqueues/lib/lists.js

    r43347 r46800  
    114114                 * @param {string}      action          The type of action to perform: 'add', 'delete', or 'dim'.
    115115                 * @param {string}      backgroundColor Background color of the list's DOM element.
    116                  * @returns {boolean} Whether to proceed with the action or not.
     116                 * @return {boolean} Whether to proceed with the action or not.
    117117                 */
    118118                confirm: null,
    … …  
    125125                 * @callback wpList~addBefore
    126126                 * @param {object} settings Settings for the Ajax request.
    127                  * @returns {object|boolean} Settings for the Ajax request or false to abort.
     127                 * @return {object|boolean} Settings for the Ajax request or false to abort.
    128128                 */
    129129                addBefore: null,
    … …  
    150150                 * @param {object}      settings Settings for the Ajax request.
    151151                 * @param {HTMLElement} list     The list DOM element.
    152                  * @returns {object|boolean} Settings for the Ajax request or false to abort.
     152                 * @return {object|boolean} Settings for the Ajax request or false to abort.
    153153                 */
    154154                delBefore: null,
    … …  
    174174                 * @callback wpList~dimBefore
    175175                 * @param {object} settings Settings for the Ajax request.
    176                  * @returns {object|boolean} Settings for the Ajax request or false to abort.
     176                 * @return {object|boolean} Settings for the Ajax request or false to abort.
    177177                 */
    178178                dimBefore: null,
    … …  
    204204         * @param {jQuery} element  Element that triggered the request.
    205205         * @param {object} settings Settings for the Ajax request.
    206          * @returns {string|number} Nonce
     206         * @return {string|number} Nonce
    207207         */
    208208        nonce: function( element, settings ) {
    … …  
    238238         * @param  {HTMLElement} element The DOM element.
    239239         * @param  {string}      type    The type of data to look for: 'list', 'add', 'delete', or 'dim'.
    240          * @returns {Array} Extracted list item data.
     240         * @return {Array} Extracted list item data.
    241241         */
    242242        parseData: function( element, type ) {
    … …  
    261261         * @param {object}      settings Settings for this list.
    262262         * @param {string}      action   The type of action to perform: 'add', 'delete', or 'dim'.
    263          * @returns {object|boolean} Settings if confirmed, false if not.
     263         * @return {object|boolean} Settings if confirmed, false if not.
    264264         */
    265265        pre: function( list, settings, action ) {
    … …  
    299299         * @param {HTMLElement} element  The DOM element.
    300300         * @param {object}      settings Settings for this list.
    301          * @returns {boolean} Whether the item was added.
     301         * @return {boolean} Whether the item was added.
    302302         */
    303303        ajaxAdd: function( element, settings ) {
    … …  
    401401         * @param {HTMLElement} element  A DOM element containing item data.
    402402         * @param {object}      settings Settings for this list.
    403          * @returns {boolean} Whether the item was deleted.
     403         * @return {boolean} Whether the item was deleted.
    404404         */
    405405        ajaxDel: function( element, settings ) {
    … …  
    488488         * @param {HTMLElement} element  A DOM element containing item data.
    489489         * @param {object}      settings Settings for this list.
    490          * @returns {boolean} Whether the item was dim'ed.
     490         * @return {boolean} Whether the item was dim'ed.
    491491         */
    492492        ajaxDim: function( element, settings ) {
    … …  
    612612         *
    613613         * @param {jQuery|string} element Element to check.
    614          * @returns {string} Background color value in HEX. Default: '#ffffff'.
     614         * @return {string} Background color value in HEX. Default: '#ffffff'.
    615615         */
    616616        getColor: function( element ) {
    … …  
    623623         * @param {HTMLElement} element  A DOM element containing item data.
    624624         * @param {object}      settings Settings for this list.
    625          * @returns {boolean} Whether the item was added.
     625         * @return {boolean} Whether the item was added.
    626626         */
    627627        add: function( element, settings ) {
    … …  
    836836 * @param {wpList~dimBefore} settings.dimBefore   Callback that's run before an item gets dim'd. Default: null.
    837837 * @param {wpList~dimAfter}  settings.dimAfter    Callback that's run after an item got dim'd. Default: null.
    838  * @returns {$.fn} wpList API function.
     838 * @return {$.fn} wpList API function.
    839839 */
    840840$.fn.wpList = function( settings ) {

  • trunk/src/js/_enqueues/vendor/mediaelement/wp-mediaelement.js

    r43309 r46800  
    1717                 * @since 4.4.0
    1818                 *
    19                  * @returns {void}
     19                 * @return {void}
    2020                 */
    2121                function initialize() {
    … …  
    5555                         * @param {object} media The wrapper that mimics all the native events/properties/methods for all renderers.
    5656                         * @param {object} node  The original HTML video, audio, or iframe tag where the media was loaded.
    57                          * @returns {string}
     57                         * @return {string}
    5858                         */
    5959                        settings.customError = function ( media, node ) {

  • trunk/src/js/_enqueues/vendor/mediaelement/wp-playlist.js

    r43309 r46800  
    178178         *
    179179         * @since 4.9.3
    180          * @returns {void}
     180         * @return {void}
    181181         */
    182182        function initialize() {

  • trunk/src/js/_enqueues/wp/a11y.js

    r45979 r46800  
    2222         * @param {String} [ariaLive] The politeness level for aria-live. Possible values:
    2323         *                            polite or assertive. Default polite.
    24          * @returns {void}
     24         * @return {void}
    2525         */
    2626        function speak( message, ariaLive ) {

  • trunk/src/js/_enqueues/wp/api.js

    r46586 r46800  
    836836                         * @param {Backbone.Model} model.
    837837                         * @param {{beforeSend}, *} options.
    838                          * @returns {*}.
     838                         * @return {*}.
    839839                         */
    840840                        sync: function( method, model, options ) {
    … …  
    989989                         * @param {Backbone.Model} model.
    990990                         * @param {{success}, *} options.
    991                          * @returns {*}.
     991                         * @return {*}.
    992992                         */
    993993                        sync: function( method, model, options ) {
    … …  
    10641064                         *
    10651065                         * @param {data: {page}} options.
    1066                          * @returns {*}.
     1066                         * @return {*}.
    10671067                         */
    10681068                        more: function( options ) {
    … …  
    10901090                         * Returns true if there are more pages of objects available.
    10911091                         *
    1092                          * @returns null|boolean.
     1092                         * @return {null|boolean}
    10931093                         */
    10941094                        hasMore: function() {

  • trunk/src/js/_enqueues/wp/autosave.js

    r43347 r46800  
    2424         * @since 3.9.0
    2525         *
    26          * @returns {Object}
     26         * @return {Object}
    2727         *      {{
    2828         *              getPostData: getPostData,
    … …  
    4747                 * @param {string} type The type of autosave either local or remote.
    4848                 *
    49                  * @returns {Object} Object containing the post data.
     49                 * @return {Object} Object containing the post data.
    5050                 */
    5151                function getPostData( type ) {
    … …  
    111111                 * @param {Object} postData The object containing the post data.
    112112                 *
    113                  * @returns {string} A concatenated string with title, content and excerpt.
     113                 * @return {string} A concatenated string with title, content and excerpt.
    114114                 */
    115115                function getCompareString( postData ) {
    … …  
    126126                 * @since 3.9.0
    127127                 *
    128                  * @returns {void}
     128                 * @return {void}
    129129                 */
    130130                function disableButtons() {
    … …  
    140140                 * @since 3.9.0
    141141                 *
    142                  * @returns {void}
     142                 * @return {void}
    143143                 */
    144144                function enableButtons() {
    … …  
    151151                 * @since 4.6.0
    152152                 *
    153                  * @returns {boolean|*} Returns either false if the editor is undefined,
    154                  *                                              or the instance of the content editor.
     153                 * @return {boolean|*} Returns either false if the editor is undefined,
     154                 *                     or the instance of the content editor.
    155155                 */
    156156                function getEditor() {
    … …  
    163163                 * @since 3.9.0
    164164                 *
    165                  * @returns {
     165                 * @return {
    166166                 * {
    167167                 *      hasStorage: *,
    … …  
    184184                         * @since 3.9.0
    185185                         *
    186                          * @returns {boolean} True if the sessionStorage is supported and enabled.
     186                         * @return {boolean} True if the sessionStorage is supported and enabled.
    187187                         */
    188188                        function checkStorage() {
    … …  
    205205                         * @since 3.9.0
    206206                         *
    207                          * @returns {boolean|Object} False if no sessionStorage in the browser or an Object
    208                          *                           containing all postData for this blog.
     207                         * @return {boolean|Object} False if no sessionStorage in the browser or an Object
     208                         *                          containing all postData for this blog.
    209209                         */
    210210                        function getStorage() {
    … …  
    230230                         * @since 3.9.0
    231231                         *
    232                          * @returns {boolean} True if the data was saved successfully, false if it wasn't saved.
     232                         * @return {boolean} True if the data was saved successfully, false if it wasn't saved.
    233233                         */
    234234                        function setStorage( stored_obj ) {
    … …  
    249249                         * @since 3.9.0
    250250                         *
    251                          * @returns {boolean|Object} False if no storage or no data or the postData as an Object.
     251                         * @return {boolean|Object} False if no storage or no data or the postData as an Object.
    252252                         */
    253253                        function getSavedPostData() {
    … …  
    270270                         * @param {Object|boolean|null} stored_data The post data to store or null/false/empty to delete the key.
    271271                         *
    272                          * @returns {boolean} True if data is stored, false if data was removed.
     272                         * @return {boolean} True if data is stored, false if data was removed.
    273273                         */
    274274                        function setData( stored_data ) {
    … …  
    295295                         * @since 3.9.0
    296296                         *
    297                          * @returns {void}
     297                         * @return {void}
    298298                         */
    299299                        function suspend() {
    … …  
    306306                         * @since 3.9.0
    307307                         *
    308                          * @returns {void}
     308                         * @return {void}
    309309                         */
    310310                        function resume() {
    … …  
    322322                         * @param {Object} data The post data for saving, minimum 'post_title' and 'content'.
    323323                         *
    324                          * @returns {boolean} Returns true when data has been saved, otherwise it returns false.
     324                         * @return {boolean} Returns true when data has been saved, otherwise it returns false.
    325325                         */
    326326                        function save( data ) {
    … …  
    371371                         * @since 3.9.0
    372372                         *
    373                          * @returns {void}
     373                         * @return {void}
    374374                         */
    375375                        function run() {
    … …  
    428428                         * @param {string} str1 The first string.
    429429                         * @param {string} str2 The second string.
    430                          * @returns {boolean} True if the strings are the same.
     430                         * @return {boolean} True if the strings are the same.
    431431                         */
    432432                        function compare( str1, str2 ) {
    … …  
    446446                         * @since 3.9.0
    447447                         *
    448                          * @returns {void}
     448                         * @return {void}
    449449                         */
    450450                        function checkPost() {
    … …  
    514514                         * @param {Object} postData The object containing all post data.
    515515                         *
    516                          * @returns {boolean} True if the post is restored.
     516                         * @return {boolean} True if the post is restored.
    517517                         */
    518518                        function restorePost( postData ) {
    … …  
    580580                 * @since 3.9.0
    581581                 *
    582                  * @returns {Object} {
     582                 * @return {Object} {
    583583                 *      {
    584584                 *              tempBlockSave: tempBlockSave,
    … …  
    601601                         * @since 3.9.0
    602602                         *
    603                          * @returns {void}
     603                         * @return {void}
    604604                         */
    605605                        function tempBlockSave() {
    … …  
    617617                         * @since 3.9.0
    618618                         *
    619                          * @returns {void}
     619                         * @return {void}
    620620                         */
    621621                        function suspend() {
    … …  
    628628                         * @since 3.9.0
    629629                         *
    630                          * @returns {void}
     630                         * @return {void}
    631631                         */
    632632                        function resume() {
    … …  
    641641                         * @param {Object} data The post data.
    642642                         *
    643                          * @returns {void}
     643                         * @return {void}
    644644                         */
    645645                        function response( data ) {
    … …  
    665665                         * @since 3.9.0
    666666                         *
    667                          * @returns {void}
     667                         * @return {void}
    668668                         */
    669669                        function triggerSave() {
    … …  
    694694                         * @since 3.9.0
    695695                         *
    696                          * @returns {Object} Returns the post data.
     696                         * @return {Object} Returns the post data.
    697697                         */
    698698                        function save() {
    … …  
    740740                         * @since 3.9.0
    741741                         *
    742                          * @returns {void}
     742                         * @return {void}
    743743                         */
    744744                        function _schedule() {
    … …  
    751751                         * @since 3.9.0
    752752                         *
    753                          * @returns {void}
     753                         * @return {void}
    754754                         */
    755755                        $document.on( 'heartbeat-send.autosave', function( event, data ) {
    … …  
    766766                                 * @since 3.9.0
    767767                                 *
    768                                  * @returns {void}
     768                                 * @return {void}
    769769                                 */
    770770                        }).on( 'heartbeat-tick.autosave', function( event, data ) {
    … …  
    777777                                 * @since 3.9.0
    778778                                 *
    779                                  * @returns {void}
     779                                 * @return {void}
    780780                                 */
    781781                        }).on( 'heartbeat-connection-lost.autosave', function( event, error, status ) {
    … …  
    798798                                 * @since 3.9.0
    799799                                 *
    800                                  * @returns {void}
     800                                 * @return {void}
    801801                                 */
    802802                        }).on( 'heartbeat-connection-restored.autosave', function() {
    … …  
    826826                 * @since 3.9.0
    827827                 *
    828                  * @returns {void}
     828                 * @return {void}
    829829                 */
    830830                $document.on( 'tinymce-editor-init.autosave', function( event, editor ) {

  • trunk/src/js/_enqueues/wp/code-editor.js

    r46586 r46800  
    4545         * @param {Function}   settings.onUpdateErrorNotice - Callback to update error notice.
    4646         *
    47          * @returns {void}
     47         * @return {void}
    4848         */
    4949        function configureLinting( editor, settings ) { // eslint-disable-line complexity
    … …  
    5353                 * Call the onUpdateErrorNotice if there are new errors to show.
    5454                 *
    55                  * @returns {void}
     55                 * @return {void}
    5656                 */
    5757                function updateErrorNotice() {
    … …  
    6565                 * Get lint options.
    6666                 *
    67                  * @returns {object} Lint options.
     67                 * @return {object} Lint options.
    6868                 */
    6969                function getLintOptions() { // eslint-disable-line complexity
    … …  
    215215         * @param {Function}   settings.onTabPrevious - Callback to handle tabbing to the previous tabbable element.
    216216         *
    217          * @returns {void}
     217         * @return {void}
    218218         */
    219219        function configureTabbing( codemirror, settings ) {
    … …  
    274274         * @param {object}                [settings.jshint] - Rules for JSHint.
    275275         *
    276          * @returns {CodeEditorInstance} Instance.
     276         * @return {CodeEditorInstance} Instance.
    277277         */
    278278        wp.codeEditor.initialize = function initialize( textarea, settings ) {

  • trunk/src/js/_enqueues/wp/customize/base.js

    r43347 r46800  
    483483                 *     when( id1, id2, id3, function( value1, value2, value3 ) {} );
    484484                 *
    485                  * @returns $.Deferred.promise();
     485                 * @return $.Deferred.promise();
    486486                 */
    487487                when: function() {
    … …  
    877877                 * @since 4.9.0
    878878                 *
    879                  * @returns {jQuery} Notification container element.
     879                 * @return {jQuery} Notification container element.
    880880                 */
    881881                render: function() {
    … …  
    943943         *
    944944         * @param {string} queryString Query string.
    945          * @returns {object} Parsed query string.
     945         * @return {object} Parsed query string.
    946946         */
    947947        api.utils.parseQueryString = function parseQueryString( queryString ) {

  • trunk/src/js/_enqueues/wp/customize/controls.js

    r46799 r46800  
    5656                 *
    5757                 * @param {jQuery.Event} event - Event.
    58                  * @returns {void}
     58                 * @return {void}
    5959                 */
    6060                handleEscape: function( event ) {
    … …  
    9999                 * @param {boolean} [options.alt] - Whether alternative style should be used when rendering notifications.
    100100                 *
    101                  * @returns {void}
     101                 * @return {void}
    102102                 */
    103103                initialize: function( options ) {
    … …  
    138138                 * @param {string|wp.customize.Notification} notification - Notification object to add. Alternatively code may be supplied, and in that case the second notificationObject argument must be supplied.
    139139                 * @param {wp.customize.Notification} [notificationObject] - Notification to add when first argument is the code string.
    140                  * @returns {wp.customize.Notification} Added notification (or existing instance if it was already added).
     140                 * @return {wp.customize.Notification} Added notification (or existing instance if it was already added).
    141141                 */
    142142                add: function( notification, notificationObject ) {
    … …  
    212212                 *
    213213                 * @since 4.9.0
    214                  * @returns {void}
     214                 * @return {void}
    215215                 */
    216216                render: function() {
    … …  
    305305                 *
    306306                 * @param {jQuery.Event} event - Event.
    307                  * @returns {void}
     307                 * @return {void}
    308308                 */
    309309                constrainFocus: function constrainFocus( event ) {
    … …  
    399399                 * @access public
    400400                 *
    401                  * @returns {void}
     401                 * @return {void}
    402402                 */
    403403                preview: function() {
    … …  
    420420                 *
    421421                 * @since 4.6.0
    422                  * @returns {wp.customize.Control[]} Controls associated with setting.
     422                 * @return {wp.customize.Control[]} Controls associated with setting.
    423423                 */
    424424                findControls: function() {
    … …  
    498498         * @param {object} [options] Options.
    499499         * @param {boolean} [options.unsaved=false] Whether only values not saved yet into a changeset will be returned (differential changes).
    500          * @returns {object} Dirty setting values.
     500         * @return {object} Dirty setting values.
    501501         */
    502502        api.dirtyValues = function dirtyValues( options ) {
    … …  
    536536         * @param {string}  [args.title] - Title to update in the changeset. Optional.
    537537         * @param {string}  [args.date] - Date to update in the changeset. Optional.
    538          * @returns {jQuery.Promise} Promise resolving with the response data.
     538         * @return {jQuery.Promise} Promise resolving with the response data.
    539539         */
    540540        api.requestChangesetUpdate = function requestChangesetUpdate( changes, args ) {
    … …  
    736736         * @param {(wp.customize.Panel|wp.customize.Section|wp.customize.Control)} a
    737737         * @param {(wp.customize.Panel|wp.customize.Section|wp.customize.Control)} b
    738          * @returns {Number}
     738         * @return {Number}
    739739         */
    740740        api.utils.prioritySort = function ( a, b ) {
    … …  
    754754         *
    755755         * @param {jQuery.Event} event
    756          * @returns {boolean}
     756         * @return {boolean}
    757757         */
    758758        api.utils.isKeydownButNotEnterEvent = function ( event ) {
    … …  
    769769         * @param {Array|jQuery} listA
    770770         * @param {Array|jQuery} listB
    771          * @returns {boolean}
     771         * @return {boolean}
    772772         */
    773773        api.utils.areElementListsEqual = function ( listA, listB ) {
    … …  
    803803         *                                         containing auxiliary UI, such as the Publish button augmented with a
    804804         *                                         Settings button.
    805          * @returns {Function} An idempotent function that cancels the reminder.
     805         * @return {Function} An idempotent function that cancels the reminder.
    806806         */
    807807        api.utils.highlightButton = function highlightButton( button, options ) {
    … …  
    850850         * @since 4.9.0
    851851         *
    852          * @returns {int} Current timestamp.
     852         * @return {int} Current timestamp.
    853853         */
    854854        api.utils.getCurrentTimestamp = function getCurrentTimestamp() {
    … …  
    894894         * @ignore
    895895         *
    896          * @returns {string|null} Normalized `transitionend` event name or null if CSS transitions are not supported.
     896         * @return {string|null} Normalized `transitionend` event name or null if CSS transitions are not supported.
    897897         */
    898898        normalizedTransitionendEventName = (function () {
    … …  
    10151015                 *
    10161016                 * @since 4.9.0
    1017                  * @returns {jQuery} Notification container element.
     1017                 * @return {jQuery} Notification container element.
    10181018                 */
    10191019                getNotificationsContainerElement: function() {
    … …  
    10261026                 *
    10271027                 * @since 4.9.0
    1028                  * @returns {void}
     1028                 * @return {void}
    10291029                 */
    10301030                setupNotifications: function() {
    … …  
    10571057                 * @param {String} parentType
    10581058                 * @param {String} childType
    1059                  * @returns {Array}
     1059                 * @return {Array}
    10601060                 */
    10611061                _children: function ( parentType, childType ) {
    … …  
    11551155                 * @param {Boolean} active
    11561156                 * @param {Object}  [params]
    1157                  * @returns {Boolean} False if state already applied.
     1157                 * @return {Boolean} False if state already applied.
    11581158                 */
    11591159                _toggleActive: function ( active, params ) {
    … …  
    11741174                /**
    11751175                 * @param {Object} [params]
    1176                  * @returns {Boolean} False if already active.
     1176                 * @return {Boolean} False if already active.
    11771177                 */
    11781178                activate: function ( params ) {
    … …  
    11821182                /**
    11831183                 * @param {Object} [params]
    1184                  * @returns {Boolean} False if already inactive.
     1184                 * @return {Boolean} False if already inactive.
    11851185                 */
    11861186                deactivate: function ( params ) {
    … …  
    12021202                 * @param {Object}   [params] - Object containing options for expand/collapse.
    12031203                 * @param {Function} [params.completeCallback] - Function to call when expansion/collapse is complete.
    1204                  * @returns {Boolean} False if state already applied or active state is false.
     1204                 * @return {Boolean} False if state already applied or active state is false.
    12051205                 */
    12061206                _toggleExpanded: function( expanded, params ) {
    … …  
    12391239                /**
    12401240                 * @param {Object} [params]
    1241                  * @returns {Boolean} False if already expanded or if inactive.
     1241                 * @return {Boolean} False if already expanded or if inactive.
    12421242                 */
    12431243                expand: function ( params ) {
    … …  
    12471247                /**
    12481248                 * @param {Object} [params]
    1249                  * @returns {Boolean} False if already collapsed.
     1249                 * @return {Boolean} False if already collapsed.
    12501250                 */
    12511251                collapse: function ( params ) {
    … …  
    12601260                 *
    12611261                 * @param {function} completeCallback Function to be called after transition is completed.
    1262                  * @returns {void}
     1262                 * @return {void}
    12631263                 */
    12641264                _animateChangeExpanded: function( completeCallback ) {
    … …  
    13631363                 * @access public
    13641364                 *
    1365                  * @returns {jQuery} Detached content element.
     1365                 * @return {jQuery} Detached content element.
    13661366                 */
    13671367                getContent: function() {
    … …  
    15441544                 * @since 4.1.0
    15451545                 *
    1546                  * @returns {Boolean}
     1546                 * @return {Boolean}
    15471547                 */
    15481548                isContextuallyActive: function () {
    … …  
    15631563                 * @since 4.1.0
    15641564                 *
    1565                  * @returns {Array}
     1565                 * @return {Array}
    15661566                 */
    15671567                controls: function () {
    … …  
    16971697                 * @param {string} id - ID.
    16981698                 * @param {object} options - Options.
    1699                  * @returns {void}
     1699                 * @return {void}
    17001700                 */
    17011701                initialize: function( id, options ) {
    … …  
    17461746                 * @since 4.2.0
    17471747                 *
    1748                  * @returns {void}
     1748                 * @return {void}
    17491749                 */
    17501750                ready: function() {
    … …  
    17981798                 * @since 4.2.0
    17991799                 *
    1800                  * @returns {Boolean}
     1800                 * @return {Boolean}
    18011801                 */
    18021802                isContextuallyActive: function () {
    … …  
    18091809                 * @since 4.2.0
    18101810                 *
    1811                  * @returns {void}
     1811                 * @return {void}
    18121812                 */
    18131813                attachEvents: function () {
    … …  
    19541954                 * @param {Boolean}  args.unchanged
    19551955                 * @param {Function} args.completeCallback
    1956                  * @returns {void}
     1956                 * @return {void}
    19571957                 */
    19581958                onChangeExpanded: function ( expanded, args ) {
    … …  
    20442044                 * @since 4.9.0
    20452045                 *
    2046                  * @returns {jQuery}
     2046                 * @return {jQuery}
    20472047                 */
    20482048                getContent: function() {
    … …  
    20552055                 * @since 4.9.0
    20562056                 *
    2057                  * @returns {void}
     2057                 * @return {void}
    20582058                 */
    20592059                loadThemes: function() {
    … …  
    21662166                 * @param {Array} themes - Array of theme data to create controls with.
    21672167                 * @param {integer} page - Page of results being loaded.
    2168                  * @returns {void}
     2168                 * @return {void}
    21692169                 */
    21702170                loadControls: function( themes, page ) {
    … …  
    21952195                 *
    21962196                 * @since 4.9.0
    2197                  * @returns {void}
     2197                 * @return {void}
    21982198                 */
    21992199                loadMore: function() {
    … …  
    22172217                 *
    22182218                 * @param {string} term - The raw search input value.
    2219                  * @returns {void}
     2219                 * @return {void}
    22202220                 */
    22212221                filterSearch: function( term ) {
    … …  
    22612261                 *
    22622262                 * @param {wp.customize.ThemesSection} section - The current theme section, passed through the debouncer.
    2263                  * @returns {void}
     2263                 * @return {void}
    22642264                 */
    22652265                checkTerm: function( section ) {
    … …  
    22782278                 * @since 4.9.0
    22792279                 *
    2280                  * @returns {void}
     2280                 * @return {void}
    22812281                 */
    22822282                filtersChecked: function() {
    … …  
    23212321                 * @param {string} newTerm - New term.
    23222322                 * @param {Array} newTags - New tags.
    2323                  * @returns {void}
     2323                 * @return {void}
    23242324                 */
    23252325                initializeNewQuery: function( newTerm, newTags ) {
    … …  
    23542354                 * @since 4.2.0
    23552355                 *
    2356                  * @returns {void}
     2356                 * @return {void}
    23572357                 */
    23582358                renderScreenshots: function() {
    … …  
    24082408                 * @since 4.9.0
    24092409                 *
    2410                  * @returns {int} Visible count.
     2410                 * @return {int} Visible count.
    24112411                 */
    24122412                getVisibleCount: function() {
    … …  
    24192419                 * @since 4.9.0
    24202420                 *
    2421                  * @returns {void}
     2421                 * @return {void}
    24222422                 */
    24232423                updateCount: function( count ) {
    … …  
    24492449                 * @since 4.2.0
    24502450                 *
    2451                  * @returns {void}
     2451                 * @return {void}
    24522452                 */
    24532453                nextTheme: function () {
    … …  
    24652465                 * @since 4.2.0
    24662466                 *
    2467                  * @returns {wp.customize.ThemeControl|boolean} Next theme.
     2467                 * @return {wp.customize.ThemeControl|boolean} Next theme.
    24682468                 */
    24692469                getNextTheme: function () {
    … …  
    24872487                 *
    24882488                 * @since 4.2.0
    2489                  * @returns {void}
     2489                 * @return {void}
    24902490                 */
    24912491                previousTheme: function () {
    … …  
    25022502                 *
    25032503                 * @since 4.2.0
    2504                  * @returns {wp.customize.ThemeControl|boolean} Previous theme.
     2504                 * @return {wp.customize.ThemeControl|boolean} Previous theme.
    25052505                 */
    25062506                getPreviousTheme: function () {
    … …  
    25252525                 * @since 4.2.0
    25262526                 *
    2527                  * @returns {void}
     2527                 * @return {void}
    25282528                 */
    25292529                updateLimits: function () {
    … …  
    25442544                 * @deprecated
    25452545                 * @param {string} themeId Theme ID.
    2546                  * @returns {jQuery.promise} Promise.
     2546                 * @return {jQuery.promise} Promise.
    25472547                 */
    25482548                loadThemePreview: function( themeId ) {
    … …  
    25572557                 * @param {object} theme - Theme.
    25582558                 * @param {Function} [callback] - Callback once the details have been shown.
    2559                  * @returns {void}
     2559                 * @return {void}
    25602560                 */
    25612561                showDetails: function ( theme, callback ) {
    … …  
    25922592                 * @since 4.2.0
    25932593                 *
    2594                  * @returns {void}
     2594                 * @return {void}
    25952595                 */
    25962596                closeDetails: function () {
    … …  
    26072607                 *
    26082608                 * @param {jQuery} el - Element to contain focus.
    2609                  * @returns {void}
     2609                 * @return {void}
    26102610                 */
    26112611                containFocus: function( el ) {
    … …  
    26482648                 * @since 4.9.0
    26492649                 *
    2650                  * @returns {void}
     2650                 * @return {void}
    26512651                 */
    26522652                initialize: function() {
    … …  
    28712871                 * @since 4.1.0
    28722872                 *
    2873                  * @returns {Array}
     2873                 * @return {Array}
    28742874                 */
    28752875                sections: function () {
    … …  
    28822882                 * @since 4.1.0
    28832883                 *
    2884                  * @returns {boolean} Whether contextually active.
     2884                 * @return {boolean} Whether contextually active.
    28852885                 */
    28862886                isContextuallyActive: function () {
    … …  
    29052905                 * @param {Boolean}  args.unchanged
    29062906                 * @param {Function} args.completeCallback
    2907                  * @returns {void}
     2907                 * @return {void}
    29082908                 */
    29092909                onChangeExpanded: function ( expanded, args ) {
    … …  
    30333033                 * @param {string} id - The ID for the panel.
    30343034                 * @param {object} options - Options.
    3035                  * @returns {void}
     3035                 * @return {void}
    30363036                 */
    30373037                initialize: function( id, options ) {
    … …  
    30473047                 *
    30483048                 * @param {string} [slug] - Theme slug.
    3049                  * @returns {boolean} Whether the theme can be switched to.
     3049                 * @return {boolean} Whether the theme can be switched to.
    30503050                 */
    30513051                canSwitchTheme: function canSwitchTheme( slug ) {
    … …  
    30603060                 *
    30613061                 * @since 4.9.0
    3062                  * @returns {void}
     3062                 * @return {void}
    30633063                 */
    30643064                attachEvents: function() {
    … …  
    31333133                 * @param {Boolean}  args.unchanged - Whether or not the state changed.
    31343134                 * @param {Function} args.completeCallback - Callback to execute when the animation completes.
    3135                  * @returns {void}
     3135                 * @return {void}
    31363136                 */
    31373137                onChangeExpanded: function( expanded, args ) {
    … …  
    31853185                 *
    31863186                 * @param {jQuery.Event} event - Event.
    3187                  * @returns {jQuery.promise} Promise.
     3187                 * @return {jQuery.promise} Promise.
    31883188                 */
    31893189                installTheme: function( event ) {
    … …  
    32903290                 *
    32913291                 * @param {string} themeId Theme ID.
    3292                  * @returns {jQuery.promise} Promise.
     3292                 * @return {jQuery.promise} Promise.
    32933293                 */
    32943294                loadThemePreview: function( themeId ) {
    … …  
    33663366                 *
    33673367                 * @param {jQuery.Event} event - Event.
    3368                  * @returns {void}
     3368                 * @return {void}
    33693369                 */
    33703370                updateTheme: function( event ) {
    … …  
    33963396                 *
    33973397                 * @param {jQuery.Event} event - Event.
    3398                  * @returns {void}
     3398                 * @return {void}
    33993399                 */
    34003400                deleteTheme: function( event ) {
    … …  
    34933493                 * @param {number} [options.instanceNumber] - Order in which this instance was created in relation to other instances.
    34943494                 * @param {object} [options.params]         - Deprecated wrapper for the above properties.
    3495                  * @returns {void}
     3495                 * @return {void}
    34963496                 */
    34973497                initialize: function( id, options ) {
    … …  
    36343634                 * @access public
    36353635                 *
    3636                  * @returns {void}
     3636                 * @return {void}
    36373637                 */
    36383638                linkElements: function () {
    … …  
    37093709                 * Triggered when the control's markup has been injected into the DOM.
    37103710                 *
    3711                  * @returns {void}
     3711                 * @return {void}
    37123712                 */
    37133713                ready: function() {
    … …  
    37403740                 *
    37413741                 * @since 4.6.0
    3742                  * @returns {jQuery} Setting validation message element.
     3742                 * @return {jQuery} Setting validation message element.
    37433743                 */
    37443744                getNotificationsContainerElement: function() {
    … …  
    37713771                 *
    37723772                 * @since 4.9.0
    3773                  * @returns {void}
     3773                 * @return {void}
    37743774                 */
    37753775                setupNotifications: function() {
    … …  
    40484048                 * @since 4.7.0
    40494049                 * @access private
    4050                  * @returns {void}
     4050                 * @return {void}
    40514051                 */
    40524052                addNewPage: function () {
    … …  
    45714571                 * @param {wp.media.model.Attachment} attachment
    45724572                 * @param {wp.media.controller.Cropper} controller
    4573                  * @returns {Object} Options
     4573                 * @return {Object} Options
    45744574                 */
    45754575                calculateImageSelectOptions: function( attachment, controller ) {
    … …  
    48544854                 * @since 4.2.0
    48554855                 *
    4856                  * @returns {Object} Options
     4856                 * @return {Object} Options
    48574857                 */
    48584858                getInitialHeaderImage: function() {
    … …  
    48874887                 * @param {wp.media.model.Attachment} attachment
    48884888                 * @param {wp.media.controller.Cropper} controller
    4889                  * @returns {Object} Options
     4889                 * @return {Object} Options
    48904890                 */
    48914891                calculateImageSelectOptions: function(attachment, controller) {
    … …  
    51565156                 * @since 4.2.0
    51575157                 * @param {Array} terms - An array of terms to search for.
    5158                  * @returns {boolean} Whether a theme control was activated or not.
     5158                 * @return {boolean} Whether a theme control was activated or not.
    51595159                 */
    51605160                filter: function( terms ) {
    … …  
    52085208                 * @since 4.9.0
    52095209                 *
    5210                  * @returns {void}
     5210                 * @return {void}
    52115211                 */
    52125212                rerenderAsInstalled: function( installed ) {
    … …  
    52395239                 * @param {string} id      - Unique identifier for the control instance.
    52405240                 * @param {object} options - Options hash for the control instance.
    5241                  * @returns {void}
     5241                 * @return {void}
    52425242                 */
    52435243                initialize: function( id, options ) {
    … …  
    52745274                 *
    52755275                 * @since 4.9.0
    5276                  * @returns {void}
     5276                 * @return {void}
    52775277                 */
    52785278                ready: function() {
    … …  
    53065306                 *
    53075307                 * @since 4.9.0
    5308                  * @returns {void}
     5308                 * @return {void}
    53095309                 */
    53105310                initEditor: function() {
    … …  
    53575357                 * @param {Object}   [params] - Focus params.
    53585358                 * @param {Function} [params.completeCallback] - Function to call when expansion is complete.
    5359                  * @returns {void}
     5359                 * @return {void}
    53605360                 */
    53615361                focus: function( params ) {
    … …  
    53785378                 * @since 4.9.0
    53795379                 * @param {object} codeEditorSettings - Code editor settings.
    5380                  * @returns {void}
     5380                 * @return {void}
    53815381                 */
    53825382                initSyntaxHighlightingEditor: function( codeEditorSettings ) {
    … …  
    54375437                 *
    54385438                 * @since 4.9.0
    5439                  * @returns {void}
     5439                 * @return {void}
    54405440                 */
    54415441                onTabNext: function onTabNext() {
    … …  
    54555455                 *
    54565456                 * @since 4.9.0
    5457                  * @returns {void}
     5457                 * @return {void}
    54585458                 */
    54595459                onTabPrevious: function onTabPrevious() {
    … …  
    54745474                 * @since 4.9.0
    54755475                 * @param {Array} errorAnnotations - Error annotations.
    5476                  * @returns {void}
     5476                 * @return {void}
    54775477                 */
    54785478                onUpdateErrorNotice: function onUpdateErrorNotice( errorAnnotations ) {
    … …  
    54975497                 *
    54985498                 * @since 4.9.0
    5499                  * @returns {void}
     5499                 * @return {void}
    55005500                 */
    55015501                initPlainTextareaEditor: function() {
    … …  
    55575557                 *
    55585558                 * @since 4.9.0
    5559                  * @returns {void}
     5559                 * @return {void}
    55605560                 */
    55615561                ready: function ready() {
    … …  
    56195619                 *
    56205620                 * @param {string} datetime - Date/Time string. Accepts Y-m-d[ H:i[:s]] format.
    5621                  * @returns {object|null} Returns object containing date components or null if parse error.
     5621                 * @return {object|null} Returns object containing date components or null if parse error.
    56225622                 */
    56235623                parseDateTime: function parseDateTime( datetime ) {
    … …  
    57345734                 *
    57355735                 * @since 4.9.0
    5736                  * @returns {boolean} If setting updated.
     5736                 * @return {boolean} If setting updated.
    57375737                 */
    57385738                populateSetting: function populateSetting() {
    … …  
    57955795                 *
    57965796                 * @since 4.9.0
    5797                  * @returns {boolean} True if future date.
     5797                 * @return {boolean} True if future date.
    57985798                 */
    57995799                isFutureDate: function isFutureDate() {
    … …  
    58085808                 * @param {string} hourInTwelveHourFormat - Hour in twelve hour format.
    58095809                 * @param {string} meridian - Either 'am' or 'pm'.
    5810                  * @returns {string} Hour in twenty four hour format.
     5810                 * @return {string} Hour in twenty four hour format.
    58115811                 */
    58125812                convertHourToTwentyFourHourFormat: function convertHour( hourInTwelveHourFormat, meridian ) {
    … …  
    58335833                 *
    58345834                 * @since 4.9.0
    5835                  * @returns {boolean} Whether the inputs were populated.
     5835                 * @return {boolean} Whether the inputs were populated.
    58365836                 */
    58375837                populateDateInputs: function populateDateInputs() {
    … …  
    59155915                 *
    59165916                 * @since 4.9.0
    5917                  * @returns {void}
     5917                 * @return {void}
    59185918                 */
    59195919                ready: function ready() {
    … …  
    60436043         * @param {...string} ids - One or more ids for controls to obtain.
    60446044         * @param {deferredControlsCallback} [callback] - Function called when all supplied controls exist.
    6045          * @returns {wp.customize.Control|undefined|jQuery.promise} Control instance or undefined (if function called with one id param), or promise resolving to requested controls.
     6045         * @return {wp.customize.Control|undefined|jQuery.promise} Control instance or undefined (if function called with one id param),
     6046         *                                                         or promise resolving to requested controls.
    60466047         *
    60476048         * @example <caption>Loop over all registered controls.</caption>
    … …  
    61046105         * @param {...string} ids - One or more ids for sections to obtain.
    61056106         * @param {deferredSectionsCallback} [callback] - Function called when all supplied sections exist.
    6106          * @returns {wp.customize.Section|undefined|jQuery.promise} Section instance or undefined (if function called with one id param), or promise resolving to requested sections.
     6107         * @return {wp.customize.Section|undefined|jQuery.promise} Section instance or undefined (if function called with one id param),
     6108         *                                                         or promise resolving to requested sections.
    61076109         *
    61086110         * @example <caption>Loop over all registered sections.</caption>
    … …  
    61386140         * @param {...string} ids - One or more ids for panels to obtain.
    61396141         * @param {deferredPanelsCallback} [callback] - Function called when all supplied panels exist.
    6140          * @returns {wp.customize.Panel|undefined|jQuery.promise} Panel instance or undefined (if function called with one id param), or promise resolving to requested panels.
     6142         * @return {wp.customize.Panel|undefined|jQuery.promise} Panel instance or undefined (if function called with one id param),
     6143         *                                                       or promise resolving to requested panels.
    61416144         *
    61426145         * @example <caption>Loop over all registered panels.</caption>
    … …  
    61726175         * @param {...string} codes - One or more codes for notifications to obtain.
    61736176         * @param {deferredNotificationsCallback} [callback] - Function called when all supplied notifications exist.
    6174          * @returns {wp.customize.Notification|undefined|jQuery.promise} notification instance or undefined (if function called with one code param), or promise resolving to requested notifications.
     6177         * @return {wp.customize.Notification|undefined|jQuery.promise} Notification instance or undefined (if function called with one code param),
     6178         *                                                              or promise resolving to requested notifications.
    61756179         *
    61766180         * @example <caption>Check if existing notification</caption>
    … …  
    66016605                 * @param {object} data.activeSections Active sections.
    66026606                 * @param {object} data.activeControls Active controls.
    6603                  * @returns {void}
     6607                 * @return {void}
    66046608                 */
    66056609                ready: function( data ) {
    … …  
    66716675                 * @access public
    66726676                 *
    6673                  * @returns {void}
     6677                 * @return {void}
    66746678                 */
    66756679                keepPreviewAlive: function keepPreviewAlive() {
    … …  
    67326736                 * @since 3.4.0
    67336737                 * @access public
    6734                  * @returns {void}
     6738                 * @return {void}
    67356739                 */
    67366740                refresh: function() {
    … …  
    69066910         * @param {object}  args.settingValidities
    69076911         * @param {boolean} [args.focusInvalidControl=false]
    6908          * @returns {void}
     6912         * @return {void}
    69096913         */
    69106914        api._handleSettingValidities = function handleSettingValidities( args ) {
    … …  
    69796983         * @since 4.6.0
    69806984         * @param {string[]} settingIds Setting IDs.
    6981          * @returns {object<string, wp.customize.Control>} Mapping setting ids to arrays of controls.
     6985         * @return {object<string, wp.customize.Control>} Mapping setting ids to arrays of controls.
    69826986         */
    69836987        api.findControlsForSettings = function findControlsForSettings( settingIds ) {
    … …  
    74277431                         * @param {string} [args.date] Date, in local time in MySQL format.
    74287432                         * @param {string} [args.title] Title
    7429                          * @returns {jQuery.promise} Promise.
     7433                         * @return {jQuery.promise} Promise.
    74307434                         */
    74317435                        save: function( args ) {
    … …  
    77007704                         * @since 4.9.0
    77017705                         *
    7702                          * @returns {jQuery.promise} Promise.
     7706                         * @return {jQuery.promise} Promise.
    77037707                         */
    77047708                        trash: function trash() {
    … …  
    80348038                         *
    80358039                         * @param {boolean} isIncluded Is UUID included.
    8036                          * @returns {void}
     8040                         * @return {void}
    80378041                         */
    80388042                        populateChangesetUuidParam = function( isIncluded ) {
    … …  
    81938197                         * @param {object} [args.lockUser] - Lock user data.
    81948198                         * @param {boolean} [args.allowOverride=false] - Whether override is allowed.
    8195                          * @returns {void}
     8199                         * @return {void}
    81968200                         */
    81978201                        function startLock( args ) {
    … …  
    82528256                         * Obtain the URL to restore the autosave.
    82538257                         *
    8254                          * @returns {string} Customizer URL.
     8258                         * @return {string} Customizer URL.
    82558259                         */
    82568260                        function getAutosaveRestorationUrl() {
    … …  
    82738277                         *
    82748278                         * @param {Array} params - Parameter names to remove.
    8275                          * @returns {void}
     8279                         * @return {void}
    82768280                         */
    82778281                        function stripParamsFromLocation( params ) {
    … …  
    82968300                         * Dismiss autosave.
    82978301                         *
    8298                          * @returns {void}
     8302                         * @return {void}
    82998303                         */
    83008304                        function dismissAutosave() {
    … …  
    83158319                         * Add notification regarding the availability of an autosave to restore.
    83168320                         *
    8317                          * @returns {void}
     8321                         * @return {void}
    83188322                         */
    83198323                        function addAutosaveRestoreNotification() {
    … …  
    84938497                         *
    84948498                         * @param {wp.customize.Panel|wp.customize.Section} container Construct.
    8495                          * @returns {void}
     8499                         * @return {void}
    84968500                         */
    84978501                        changeContainer = function( container ) {
    … …  
    86058609                         * @access private
    86068610                         *
    8607                          * @returns {void}
     8611                         * @return {void}
    86088612                         */
    86098613                        updateHeaderHeight = function() {
    … …  
    86208624                         * @param {number} scrollTop - Scroll top.
    86218625                         * @param {number} scrollDirection - Scroll direction, negative number being up and positive being down.
    8622                          * @returns {void}
     8626                         * @return {void}
    86238627                         */
    86248628                        positionStickyHeader = function( header, scrollTop, scrollDirection ) {

  • trunk/src/js/_enqueues/wp/customize/nav-menus.js

    r46799 r46800  
    388388                 * @param {Array.<object>} itemTypes List of objects containing type and key.
    389389                 * @param {string} deprecated Formerly the object parameter.
    390                  * @returns {void}
     390                 * @return {void}
    391391                 */
    392392                loadItems: function( itemTypes, deprecated ) {
    … …  
    596596                 *
    597597                 * @param {jQuery.Event} event Event.
    598                  * @returns {void}
     598                 * @return {void}
    599599                 */
    600600                _submitNew: function( event ) {
    … …  
    622622                 *
    623623                 * @param {jQuery} container
    624                  * @returns {void}
     624                 * @return {void}
    625625                 */
    626626                submitNew: function( container ) {
    … …  
    844844                 * @private
    845845                 *
    846                  * @returns {void}
     846                 * @return {void}
    847847                 */
    848848                saveManageColumnsState: _.debounce( function() {
    … …  
    878878                 * @private
    879879                 *
    880                  * @returns {Array} Fields (columns) that are hidden.
     880                 * @return {Array} Fields (columns) that are hidden.
    881881                 */
    882882                hidden: function() {
    … …  
    974974                         *
    975975                         * @this {jQuery}
    976                          * @returns {void}
     976                         * @return {void}
    977977                         */
    978978                        handleFieldActiveToggle = function() {
    … …  
    11671167                 * @since 4.9.0
    11681168                 *
    1169                  * @returns {void}
     1169                 * @return {void}
    11701170                 */
    11711171                highlightNewItemButton: function() {
    … …  
    11801180         *
    11811181         * @param {string} [name=''] Nav menu name.
    1182          * @returns {wp.customize.Menus.MenuSection} Added nav menu.
     1182         * @return {wp.customize.Menus.MenuSection} Added nav menu.
    11831183         */
    11841184        api.Menus.createNavMenu = function createNavMenu( name ) {
    … …  
    12641264                         *
    12651265                         * @since 4.9.0
    1266                          * @returns {number} Count.
     1266                         * @return {number} Count.
    12671267                         */
    12681268                        function getNavMenuCount() {
    … …  
    12801280                         *
    12811281                         * @since 4.9.0
    1282                          * @returns {void}
     1282                         * @return {void}
    12831283                         */
    12841284                        function updateNoticeVisibility() {
    … …  
    12911291                         * @since 4.9.0
    12921292                         * @param {wp.customize.Setting} setting - Added setting.
    1293                          * @returns {void}
     1293                         * @return {void}
    12941294                         */
    12951295                        function addChangeEventListener( setting ) {
    … …  
    13051305                         * @since 4.9.0
    13061306                         * @param {wp.customize.Setting} setting - Removed setting.
    1307                          * @returns {void}
     1307                         * @return {void}
    13081308                         */
    13091309                        function removeChangeEventListener( setting ) {
    … …  
    14401440                 *
    14411441                 * @param {string|null} locationId - The ID of the location to select. `null` clears all selections.
    1442                  * @returns {void}
     1442                 * @return {void}
    14431443                 */
    14441444                selectDefaultLocation: function( locationId ) {
    … …  
    18711871                /**
    18721872                 *
    1873                  * @returns {number}
     1873                 * @return {number}
    18741874                 */
    18751875                getDepth: function() {
    … …  
    19631963                 * @param {Boolean} expanded
    19641964                 * @param {Object} [params]
    1965                  * @returns {Boolean} False if state already applied.
     1965                 * @return {Boolean} False if state already applied.
    19661966                 */
    19671967                _toggleExpanded: api.Section.prototype._toggleExpanded,
    … …  
    19711971                 *
    19721972                 * @param {Object} [params]
    1973                  * @returns {Boolean} False if already expanded.
     1973                 * @return {Boolean} False if already expanded.
    19741974                 */
    19751975                expand: api.Section.prototype.expand,
    … …  
    19911991                 *
    19921992                 * @param {Object} [params]
    1993                  * @returns {Boolean} False if already collapsed.
     1993                 * @return {Boolean} False if already collapsed.
    19941994                 */
    19951995                collapse: api.Section.prototype.collapse,
    … …  
    24292429                 *
    24302430                 * @param {Object.<string,boolean>} selections - A map of location selections.
    2431                  * @returns {void}
     2431                 * @return {void}
    24322432                 */
    24332433                setSelections: function( selections ) {
    … …  
    29552955                 *
    29562956                 * @param {object} item - Value for the nav_menu_item setting to be created.
    2957                  * @returns {wp.customize.Menus.controlConstructor.nav_menu_item} The newly-created nav_menu_item control instance.
     2957                 * @return {wp.customize.Menus.controlConstructor.nav_menu_item} The newly-created nav_menu_item control instance.
    29582958                 */
    29592959                addItemToMenu: function( item ) {
    … …  
    33743374         *
    33753375         * @param {string} name
    3376          * @returns {string}
     3376         * @return {string}
    33773377         */
    33783378        function displayNavMenuName( name ) {

  • trunk/src/js/_enqueues/wp/customize/preview-nav-menus.js

    r43347 r46800  
    135135                         * @param {number|object|false|null}  newValue - New value, or null if the setting was just removed.
    136136                         * @param {number|object|false|null}  oldValue - Old value, or null if the setting was just added.
    137                          * @returns {boolean}
     137                         * @return {boolean}
    138138                         */
    139139                        isRelatedSetting: function( setting, newValue, oldValue ) {
    … …  
    211211                         * @since 4.5.0
    212212                         *
    213                          * @returns {Promise}
     213                         * @return {Promise}
    214214                         */
    215215                        refresh: function() {

  • trunk/src/js/_enqueues/wp/customize/preview-widgets.js

    r43347 r46800  
    1717 * @param {Object} api Information from the API.
    1818 *
    19  * @returns {Object} Widget-related variables.
     19 * @return {Object} Widget-related variables.
    2020 */
    2121wp.customize.widgetsPreview = wp.customize.WidgetCustomizerPreview = (function( $, _, wp, api ) {
    … …  
    4343         * @memberOf wp.customize.widgetsPreview
    4444         *
    45          * @returns {void}
     45         * @return {void}
    4646         */
    4747        self.init = function() {
    … …  
    125125                 * @since 4.5.0
    126126                 *
    127                  * @returns {Promise|void} Either a promise postponing the refresh, or void.
     127                 * @return {Promise|void} Either a promise postponing the refresh, or void.
    128128                 */
    129129                refresh: function() {
    … …  
    147147                 *                                                            function.
    148148                 *
    149                  * @returns {void}
     149                 * @return {void}
    150150                 */
    151151                renderContent: function( placement ) {
    … …  
    206206                 * @since 4.5.0
    207207                 *
    208                  * @returns {void}
     208                 * @return {void}
    209209                 */
    210210                ready: function() {
    … …  
    252252                 * @since 4.5.0
    253253                 *
    254                  * @returns {Array.<{before: Comment, after: Comment, instanceNumber: number}>}
    255                  *          An array with an object for each sidebar instance, containing the
    256                  *          node before and after the sidebar instance and its instance number.
     254                 * @return {Array.<{before: Comment, after: Comment, instanceNumber: number}>}
     255                 *         An array with an object for each sidebar instance, containing the
     256                 *         node before and after the sidebar instance and its instance number.
    257257                 */
    258258                findDynamicSidebarBoundaryNodes: function() {
    … …  
    294294                 * @since 4.5.0
    295295                 *
    296                  * @returns {Array} An array containing placement objects for each of the
    297                  *                  dynamic sidebar boundary nodes.
     296                 * @return {Array} An array containing placement objects for each of the
     297                 *                 dynamic sidebar boundary nodes.
    298298                 */
    299299                placements: function() {
    … …  
    321321                 * @throws {Error} If the API doesn't pass an array of widget ids.
    322322                 *
    323                  * @returns {Array} A shallow copy of the array containing widget IDs.
     323                 * @return {Array} A shallow copy of the array containing widget IDs.
    324324                 */
    325325                getWidgetIds: function() {
    … …  
    345345                 * @since 4.5.0
    346346                 *
    347                  * @returns {Array.<wp.customize.selectiveRefresh.Placement>} List of placements
    348                  *                                                            that were reflowed.
     347                 * @return {Array.<wp.customize.selectiveRefresh.Placement>} List of placements
     348                 *                                                           that were reflowed.
    349349                 */
    350350                reflowWidgets: function() {
    … …  
    413413                 * @param {string} widgetId The widget ID.
    414414                 *
    415                  * @returns {wp.customize.selectiveRefresh.Partial} The widget instance partial.
     415                 * @return {wp.customize.selectiveRefresh.Partial} The widget instance partial.
    416416                 */
    417417                ensureWidgetPlacementContainers: function( widgetId ) {
    … …  
    481481                 * @param {Array} oldWidgetIds Old widget IDs.
    482482                 *
    483                  * @returns {void}
     483                 * @return {void}
    484484                 */
    485485                handleSettingChange: function( newWidgetIds, oldWidgetIds ) {
    … …  
    536536                 * @since 4.5.0
    537537                 *
    538                  * @returns {Promise} A promise postponing the refresh.
     538                 * @return {Promise} A promise postponing the refresh.
    539539                 */
    540540                refresh: function() {
    … …  
    566566         * @since 4.5.0
    567567         *
    568          * @returns {void}
     568         * @return {void}
    569569         */
    570570        self.addPartials = function() {
    … …  
    591591         * @since 3.9.0
    592592         *
    593          * @returns {void}
     593         * @return {void}
    594594         */
    595595        self.buildWidgetSelectors = function() {
    … …  
    634634         * @param  {string} widgetId ID of the widget.
    635635         *
    636          * @returns {void}
     636         * @return {void}
    637637         */
    638638        self.highlightWidget = function( widgetId ) {
    … …  
    656656         * @since 3.9.0
    657657         *
    658          * @returns {void}
     658         * @return {void}
    659659         */
    660660        self.highlightControls = function() {
    … …  
    693693         * @param {string} widgetId The widget ID.
    694694         *
    695          * @returns {{idBase: string, number: number|null}} An object containing the
    696          *          idBase and number of the parsed widget ID.
     695         * @return {{idBase: string, number: number|null}} An object containing the idBase
     696         *                                                and number of the parsed widget ID.
    697697         */
    698698        self.parseWidgetId = function( widgetId ) {
    … …  
    722722         * @param {string} settingId Widget setting ID.
    723723         *
    724          * @returns {{idBase: string, number: number|null}|null} Either an object
    725          *          containing the idBase and number of the parsed widget setting ID, or
    726          *          null.
     724         * @return {{idBase: string, number: number|null}|null} Either an object containing the idBase
     725         *                                                      and number of the parsed widget setting ID,
     726         *                                                      or null.
    727727         */
    728728        self.parseWidgetSettingId = function( settingId ) {
    … …  
    752752         * @param {string} widgetId The widget ID.
    753753         *
    754          * @returns {string} The setting ID.
     754         * @return {string} The setting ID.
    755755         */
    756756        self.getWidgetSettingId = function( widgetId ) {

  • trunk/src/js/_enqueues/wp/customize/preview.js

    r44684 r46800  
    2929                 *
    3030                 * @param {string} url URL.
    31                  * @returns {string} URL with customized state.
     31                 * @return {string} URL with customized state.
    3232                 */
    3333                injectUrlWithState = function( url ) {
    … …  
    235235         *
    236236         * @access private
    237          * @returns {void}
     237         * @return {void}
    238238         */
    239239        api.addLinkPreviewing = function addLinkPreviewing() {
    … …  
    279279         * @param {object} [options]
    280280         * @param {object} [options.allowAdminAjax=false] Allow admin-ajax.php requests.
    281          * @returns {boolean} Is appropriate for changeset link.
     281         * @return {boolean} Is appropriate for changeset link.
    282282         */
    283283        api.isLinkPreviewable = function isLinkPreviewable( element, options ) {
    … …  
    333333         * @param {string} element.host Host.
    334334         * @param {string} element.protocol Protocol.
    335          * @returns {void}
     335         * @return {void}
    336336         */
    337337        api.prepareLinkPreview = function prepareLinkPreview( element ) {
    … …  
    405405                 * @param {object} originalOptions Original options.
    406406                 * @param {XMLHttpRequest} xhr XHR.
    407                  * @returns {void}
     407                 * @return {void}
    408408                 */
    409409                var prefilterAjax = function( options, originalOptions, xhr ) {
    … …  
    471471         * @access protected
    472472         *
    473          * @returns {void}
     473         * @return {void}
    474474         */
    475475        api.addFormPreviewing = function addFormPreviewing() {
    … …  
    503503         *
    504504         * @param {HTMLFormElement} form Form.
    505          * @returns {void}
     505         * @return {void}
    506506         */
    507507        api.prepareFormPreview = function prepareFormPreview( form ) {
    … …  
    627627                 *
    628628                 * @param {number} attachmentId Attachment ID for custom logo.
    629                  * @returns {void}
     629                 * @return {void}
    630630                 */
    631631                custom_logo: function( attachmentId ) {
    … …  
    637637                 *
    638638                 * @param {string} value Custom CSS..
    639                  * @returns {void}
     639                 * @return {void}
    640640                 */
    641641                custom_css: function( value ) {
    … …  
    646646                 * Preview changes to any of the background settings.
    647647                 *
    648                  * @returns {void}
     648                 * @return {void}
    649649                 */
    650650                background: function() {
    … …  
    776776                 *
    777777                 * @param {string} uuid - UUID.
    778                  * @returns {void}
     778                 * @return {void}
    779779                 */
    780780                handleUpdatedChangesetUuid = function( uuid ) {

  • trunk/src/js/_enqueues/wp/customize/selective-refresh.js

    r46586 r46800  
    121121                 *
    122122                 * @param {Placement} placement The placement container element.
    123                  * @returns {void}
     123                 * @return {void}
    124124                 */
    125125                createEditShortcutForPlacement: function( placement ) {
    … …  
    151151                 * @param {Placement} placement The placement for the partial.
    152152                 * @param {jQuery} $editShortcut The shortcut element as a jQuery object.
    153                  * @returns {void}
     153                 * @return {void}
    154154                 */
    155155                addEditShortcutToPlacement: function( placement, $editShortcut ) {
    … …  
    409409                 * @param {string|object|boolean} placement.addedContent - Rendered HTML content, a data object for JS templates to render, or false if no render.
    410410                 * @param {object}                [placement.context]    - Optional context information about the container.
    411                  * @returns {boolean} Whether the rendering was successful and the fallback was not invoked.
     411                 * @return {boolean} Whether the rendering was successful and the fallback was not invoked.
    412412                 */
    413413                renderContent: function( placement ) {

  • trunk/src/js/_enqueues/wp/customize/widgets.js

    r46799 r46800  
    10401040                 *
    10411041                 * @param {jQuery} container element in which to look for inputs
    1042                  * @returns {jQuery} inputs
     1042                 * @return {jQuery} inputs
    10431043                 * @private
    10441044                 */
    … …  
    10521052                 *
    10531053                 * @param {jQuery} inputs
    1054                  * @returns {string}
     1054                 * @return {string}
    10551055                 * @private
    10561056                 */
    … …  
    10751075                 *
    10761076                 * @param {jQuery|Element} input
    1077                  * @returns {string|boolean|array|*}
     1077                 * @return {string|boolean|array|*}
    10781078                 * @private
    10791079                 */
    … …  
    13411341                 * @param {Boolean} expanded
    13421342                 * @param {Object} [params]
    1343                  * @returns {Boolean} False if state already applied.
     1343                 * @return {Boolean} False if state already applied.
    13441344                 */
    13451345                _toggleExpanded: api.Section.prototype._toggleExpanded,
    … …  
    13491349                 *
    13501350                 * @param {Object} [params]
    1351                  * @returns {Boolean} False if already expanded.
     1351                 * @return {Boolean} False if already expanded.
    13521352                 */
    13531353                expand: api.Section.prototype.expand,
    … …  
    13661366                 *
    13671367                 * @param {Object} [params]
    1368                  * @returns {Boolean} False if already collapsed.
     1368                 * @return {Boolean} False if already collapsed.
    13691369                 */
    13701370                collapse: api.Section.prototype.collapse,
    … …  
    14961496                 * Get the position (index) of the widget in the containing sidebar
    14971497                 *
    1498                  * @returns {Number}
     1498                 * @return {Number}
    14991499                 */
    15001500                getWidgetSidebarPosition: function() {
    … …  
    16531653                                 * Update the notice.
    16541654                                 *
    1655                                  * @returns {void}
     1655                                 * @return {void}
    16561656                                 */
    16571657                                updateNotice = function() {
    … …  
    17091709                 * @since 4.4.0
    17101710                 *
    1711                  * @returns {boolean}
     1711                 * @return {boolean}
    17121712                 */
    17131713                isContextuallyActive: function() {
    … …  
    20622062                /**
    20632063                 * @param {string} widgetId or an id_base for adding a previously non-existing widget.
    2064                  * @returns {object|false} widget_form control instance, or false on error.
     2064                 * @return {object|false} widget_form control instance, or false on error.
    20652065                 */
    20662066                addWidget: function( widgetId ) {
    … …  
    23312331        /**
    23322332         * @param {String} widgetId
    2333          * @returns {Object}
     2333         * @return {Object}
    23342334         */
    23352335        function parseWidgetId( widgetId ) {
    … …  
    23532353        /**
    23542354         * @param {String} widgetId
    2355          * @returns {String} settingId
     2355         * @return {String} settingId
    23562356         */
    23572357        function widgetIdToSettingId( widgetId ) {

  • trunk/src/js/_enqueues/wp/dashboard.js

    r44896 r46800  
    2424         * @param {boolean} visible Should it be visible or not.
    2525         *
    26          * @returns {void}
     26         * @return {void}
    2727         */
    2828        updateWelcomePanel = function( visible ) {
    … …  
    7373         * @param {string} el Optional. Widget to fetch or none to update all.
    7474         *
    75          * @returns {void}
     75         * @return {void}
    7676         */
    7777        window.ajaxPopulateWidgets = function(el) {
    … …  
    8282                 * @param {string} id ID of the element which is going to be checked for changes.
    8383                 *
    84                  * @returns {void}
     84                 * @return {void}
    8585                 */
    8686                function show(i, id) {
    … …  
    128128         * @global
    129129         *
    130          * @returns {void}
     130         * @return {void}
    131131         */
    132132        window.quickPressLoad = function() {
    … …  
    160160                         * Highlights the latest post for one second.
    161161                         *
    162                          * @returns {void}
     162                         * @return {void}
    163163                         */
    164164                        function highlightLatestPost () {
    … …  
    190190         * @since 3.6.0
    191191         *
    192          * @returns {void}
     192         * @return {void}
    193193         */
    194194        function autoResizeTextarea() {
    … …  
    286286                 * @since 4.8.0
    287287                 *
    288                  * @returns {void}
     288                 * @return {void}
    289289                 */
    290290                init: function() {
    … …  
    320320                         * Filters events based on entered location.
    321321                         *
    322                          * @returns {void}
     322                         * @return {void}
    323323                         */
    324324                        $container.on( 'submit', '.community-events-form', function( event ) {
    … …  
    357357                 *                              or an event object to flip between states.
    358358                 *
    359                  * @returns {void}
     359                 * @return {void}
    360360                 */
    361361                toggleLocationForm: function( action ) {
    … …  
    402402                 * @param {Object} requestParams REST API Request parameters object.
    403403                 *
    404                  * @returns {void}
     404                 * @return {void}
    405405                 */
    406406                getEvents: function( requestParams ) {
    … …  
    456456                 *                                'app' to indicate it was triggered automatically by the app itself.
    457457                 *
    458                  * @returns {void}
     458                 * @return {void}
    459459                 */
    460460                renderEventsTemplate: function( templateParams, initiatedBy ) {

  • trunk/src/js/_enqueues/wp/editor/base.js

    r46799 r46800  
    2727                                 * @since 4.3.0
    2828                                 *
    29                                  * @returns {void}
     29                                 * @return {void}
    3030                                 */
    3131                                $$( document ).on( 'click', function( event ) {
    … …  
    4848                 *
    4949                 * @param {Object} editor The TinyMCE editor.
    50                  * @returns {number} If the height is between 10 and 200 return the height,
     50                 * @return {number} If the height is between 10 and 200 return the height,
    5151                 * else return 30.
    5252                 */
    … …  
    7171                 * @param {string} id The id of the editor you want to change the editor mode for. Default: `content`.
    7272                 * @param {string} mode The mode you want to switch to. Default: `toggle`.
    73                  * @returns {void}
     73                 * @return {void}
    7474                 */
    7575                function switchEditor( id, mode ) {
    … …  
    203203                 * @param {number} cursorPosition The cursor position inside the content.
    204204                 *
    205                  * @returns {(null|Object)} Null if cursor is not in a tag, Object if the cursor is inside a tag.
     205                 * @return {(null|Object)} Null if cursor is not in a tag, Object if the cursor is inside a tag.
    206206                 */
    207207                function getContainingTagInfo( content, cursorPosition ) {
    … …  
    660660                 *
    661661                 * @param {Object} editor The editor where we must find the selection.
    662                  * @returns {(null|Object)} The selection range position in the editor.
     662                 * @return {(null|Object)} The selection range position in the editor.
    663663                 */
    664664                function findBookmarkedPosition( editor ) {
    … …  
    10051005                 *
    10061006                 * @param {string} text The text input.
    1007                  * @returns {string} The formatted text.
     1007                 * @return {string} The formatted text.
    10081008                 */
    10091009                function autop( text ) {
    … …  
    11321132                 *
    11331133                 * @param {String} html The content from the visual editor.
    1134                  * @returns {String} the filtered content.
     1134                 * @return {String} the filtered content.
    11351135                 */
    11361136                function pre_wpautop( html ) {
    … …  
    11581158                 *
    11591159                 * @param {String} text The content from the text editor.
    1160                  * @returns {String} filtered content.
     1160                 * @return {String} filtered content.
    11611161                 */
    11621162                function wpautop( text ) {

  • trunk/src/js/_enqueues/wp/editor/dfw.js

    r45172 r46800  
    1616         * @since 4.0.0
    1717         *
    18          * @returns {void}
     18         * @return {void}
    1919         */
    2020        $( function() {
    … …  
    7171                 * @since 4.6.1
    7272                 *
    73                  * @returns {void}
     73                 * @return {void}
    7474                 */
    7575                var shrinkTextarea = window._.throttle( function() {
    … …  
    103103                 * @since 4.6.1
    104104                 *
    105                  * @returns {void}
     105                 * @return {void}
    106106                 */
    107107                function textEditorResize() {
    … …  
    136136                 * @since 4.0.0
    137137                 *
    138                  * @returns {void}
     138                 * @return {void}
    139139                 */
    140140                function getHeights() {
    … …  
    170170                 * @param {object} editor The editor to bind the vents on.
    171171                 *
    172                  * @returns {void}
     172                 * @return {void}
    173173                 */
    174174                $document.on( 'tinymce-editor-init.editor-expand', function( event, editor ) {
    … …  
    178178                                 * Hides any float panel with a hover state. Additionally hides tooltips.
    179179                                 *
    180                                  * @returns {void}
     180                                 * @return {void}
    181181                                 */
    182182                                hideFloatPanels = _.debounce( function() {
    … …  
    205205                         * Gets the offset of the editor.
    206206                         *
    207                          * @returns {Number|Boolean} Returns the offset of the editor
     207                         * @return {Number|Boolean} Returns the offset of the editor
    208208                         * or false if there is no offset height.
    209209                         */
    … …  
    242242                         * @param {event} event The event to get the key code from.
    243243                         *
    244                          * @returns {void}
     244                         * @return {void}
    245245                         */
    246246                        function mceKeyup( event ) {
    … …  
    271271                         * @param {string} key The key code of the pressed key.
    272272                         *
    273                          * @returns {void}
     273                         * @return {void}
    274274                         */
    275275                        function mceScroll( key ) {
    … …  
    332332                         * @param {event} event The FullscreenStateChanged event.
    333333                         *
    334                          * @returns {void}
     334                         * @return {void}
    335335                         */
    336336                        function mceFullscreenToggled( event ) {
    … …  
    349349                         * @since 4.0.0
    350350                         *
    351                          * @returns {void}
     351                         * @return {void}
    352352                         */
    353353                        function mceShow() {
    … …  
    368368                         * @since 4.0.0
    369369                         *
    370                          * @returns {void}
     370                         * @return {void}
    371371                         */
    372372                        function mceHide() {
    … …  
    392392                         * @since 4.1.0
    393393                         *
    394                          * @returns {void}
     394                         * @return {void}
    395395                         */
    396396                        function toggleAdvanced() {
    … …  
    403403                         * @since 4.0.0
    404404                         *
    405                          * @returns {void}
     405                         * @return {void}
    406406                         */
    407407                        mceBind = function() {
    … …  
    428428                         * @since 4.0.0
    429429                         *
    430                          * @returns {void}
     430                         * @return {void}
    431431                         */
    432432                        mceUnbind = function() {
    … …  
    461461                 * @param {event} event The event that calls this function.
    462462                 *
    463                  * @returns {void}
     463                 * @return {void}
    464464                 */
    465465                function adjust( event ) {
    … …  
    773773                 * @since 4.0.0
    774774                 *
    775                  * @returns {void}
     775                 * @return {void}
    776776                 */
    777777                function fullscreenHide() {
    … …  
    787787                 * @param {function} callback The function to run in the timeout.
    788788                 *
    789                  * @returns {void}
     789                 * @return {void}
    790790                 */
    791791                function initialResize( callback ) {
    … …  
    800800                 * @since 4.0.0
    801801                 *
    802                  * @returns {void}
     802                 * @return {void}
    803803                 */
    804804                function afterScroll() {
    … …  
    812812                 * @since 4.0.0
    813813                 *
    814                  * @returns {void}
     814                 * @return {void}
    815815                 */
    816816                function on() {
    … …  
    882882                 * @since 4.0.0
    883883                 *
    884                  * @returns {void}
     884                 * @return {void}
    885885                 */
    886886                function off() {
    … …  
    976976         * @since 4.1.0
    977977         *
    978          * @returns {void}
     978         * @return {void}
    979979         */
    980980        $( function() {
    … …  
    10261026                 * @since 4.1.0
    10271027                 *
    1028                  * @returns {void}
     1028                 * @return {void}
    10291029                 */
    10301030                function recalcEditorRect() {
    … …  
    10391039                 * @since 4.1.0
    10401040                 *
    1041                  * @returns {void}
     1041                 * @return {void}
    10421042                 */
    10431043                function activate() {
    … …  
    10551055                 * @since 4.1.0
    10561056                 *
    1057                  * @returns {void}
     1057                 * @return {void}
    10581058                 */
    10591059                function deactivate() {
    … …  
    10731073                 * @since 4.1.0
    10741074                 *
    1075                  * @returns {boolean} Returns true is _isActive is true.
     1075                 * @return {boolean} Returns true is _isActive is true.
    10761076                 */
    10771077                function isActive() {
    … …  
    10841084                 * @since 4.1.0
    10851085                 *
    1086                  * @returns {void}
     1086                 * @return {void}
    10871087                 */
    10881088                function on() {
    … …  
    11071107                 * @since 4.1.0
    11081108                 *
    1109                  * @returns {void}
     1109                 * @return {void}
    11101110                 */
    11111111                function off() {
    … …  
    11301130                 * @since 4.1.0
    11311131                 *
    1132                  * @returns {void}
     1132                 * @return {void}
    11331133                 */
    11341134                function toggle() {
    … …  
    11451145                 * @since 4.1.0
    11461146                 *
    1147                  * @returns {boolean} Returns true if _isOn is true.
     1147                 * @return {boolean} Returns true if _isOn is true.
    11481148                 */
    11491149                function isOn() {
    … …  
    11621162                 * @param event The event that triggers this function.
    11631163                 *
    1164                  * @returns {void}
     1164                 * @return {void}
    11651165                 */
    11661166                function fadeOut( event ) {
    … …  
    13011301                 * @param event The event that triggers this function.
    13021302                 *
    1303                  * @returns {void}
     1303                 * @return {void}
    13041304                 */
    13051305                function fadeIn( event ) {
    … …  
    13471347                 * @since 4.1.0
    13481348                 *
    1349                  * @returns {void}
     1349                 * @return {void}
    13501350                 */
    13511351                function maybeFadeIn() {
    … …  
    13691369                 * @since 4.1.0
    13701370                 *
    1371                  * @returns {void}
     1371                 * @return {void}
    13721372                 */
    13731373                function fadeOutAdminBar() {
    … …  
    13901390                 * @since 4.1.0
    13911391                 *
    1392                  * @returns {void}
     1392                 * @return {void}
    13931393                 */
    13941394                function fadeInAdminBar() {
    … …  
    14051405                 * @since 4.1.0
    14061406                 *
    1407                  * @returns {void}
     1407                 * @return {void}
    14081408                 */
    14091409                function fadeOutSlug() {
    … …  
    14221422                 * @since 4.1.0
    14231423                 *
    1424                  * @returns {void}
     1424                 * @return {void}
    14251425                 */
    14261426                function fadeInSlug() {
    … …  
    14431443                 * @param {event} event The event to trigger the toggle.
    14441444                 *
    1445                  * @returns {void}
     1445                 * @return {void}
    14461446                 */
    14471447                function toggleViaKeyboard( event ) {
    … …  
    14631463                 * @param {object} editor The editor to add the button to.
    14641464                 *
    1465                  * @returns {void}
     1465                 * @return {void}
    14661466                 */
    14671467                $document.on( 'tinymce-editor-setup.focus', function( event, editor ) {
    … …  
    15121512                 * @param {object} editor The editor to bind events on.
    15131513                 *
    1514                  * @returns {void}
     1514                 * @return {void}
    15151515                 */
    15161516                $document.on( 'tinymce-editor-init.focus', function( event, editor ) {
    … …  
    15691569                 * @param {object} editor The editor to bind events on.
    15701570                 *
    1571                  * @returns {void}
     1571                 * @return {void}
    15721572                 */
    15731573                $document.on( 'quicktags-init', function( event, editor ) {

  • trunk/src/js/_enqueues/wp/heartbeat.js

    r44275 r46800  
    3535         * @since 3.6.0
    3636         *
    37          * @returns {Object} An instance of the Heartbeat class.
     37         * @return {Object} An instance of the Heartbeat class.
    3838         * @constructor
    3939         */
    … …  
    111111                 * @since 3.8.0
    112112                 *
    113                  * @returns {void}
     113                 * @return {void}
    114114                 */
    115115                function initialize() {
    … …  
    250250                 * @since 3.6.0
    251251                 *
    252                  * @returns {number} Returns the current time.
     252                 * @return {number} Returns the current time.
    253253                 */
    254254                function time() {
    … …  
    263263                 * @since 3.6.0
    264264                 *
    265                  * @returns {boolean} Returns whether or not the iframe is from the same origin.
     265                 * @return {boolean} Returns whether or not the iframe is from the same origin.
    266266                 */
    267267                function isLocalFrame( frame ) {
    … …  
    296296                 * @since 4.1.0
    297297                 *
    298                  * @returns {void}
     298                 * @return {void}
    299299                 */
    300300                function checkFocus() {
    … …  
    317317                 *                        (200, 404, 500, etc.).
    318318                 *
    319                  * @returns {void}
     319                 * @return {void}
    320320                 */
    321321                function setErrorState( error, status ) {
    … …  
    364364                 * @since 3.8.0
    365365                 *
    366                  * @returns {void}
     366                 * @return {void}
    367367                 */
    368368                function clearErrorState() {
    … …  
    385385                 * @since 3.6.0
    386386                 *
    387                  * @returns {void}
     387                 * @return {void}
    388388                 */
    389389                function connect() {
    … …  
    485485                 * @since 3.8.0
    486486                 *
    487                  * @returns {void}
     487                 * @return {void}
    488488                 */
    489489                function scheduleNextTick() {
    … …  
    531531                 * @since 3.6.0
    532532                 *
    533                  * @returns {void}
     533                 * @return {void}
    534534                 */
    535535                function blurred() {
    … …  
    544544                 * @since 3.6.0
    545545                 *
    546                  * @returns {void}
     546                 * @return {void}
    547547                 */
    548548                function focused() {
    … …  
    565565                 * @since 3.6.0
    566566                 *
    567                  * @returns {void}
     567                 * @return {void}
    568568                 */
    569569                function userIsActive() {
    … …  
    591591                 * @since 3.8.0
    592592                 *
    593                  * @returns {void}
     593                 * @return {void}
    594594                 */
    595595                function checkUserActivity() {
    … …  
    633633                 * @memberOf wp.heartbeat.prototype
    634634                 *
    635                  * @returns {boolean} True if the window or the user is active.
     635                 * @return {boolean} True if the window or the user is active.
    636636                 */
    637637                function hasFocus() {
    … …  
    646646                 * @memberOf wp.heartbeat.prototype
    647647                 *
    648                  * @returns {boolean} True if a connection error was found.
     648                 * @return {boolean} True if a connection error was found.
    649649                 */
    650650                function hasConnectionError() {
    … …  
    662662                 * @memberOf wp.heartbeat.prototype
    663663                 *
    664                  * @returns {void}
     664                 * @return {void}
    665665                 */
    666666                function connectNow() {
    … …  
    681681                 * @memberOf wp.heartbeat.prototype
    682682                 *
    683                  * @returns {void}
     683                 * @return {void}
    684684                 */
    685685                function disableSuspend() {
    … …  
    704704                 *                              back. Used with speed = 'fast' or 5.
    705705                 *
    706                  * @returns {number} Current interval in seconds.
     706                 * @return {number} Current interval in seconds.
    707707                 */
    708708                function interval( speed, ticks ) {
    … …  
    785785                 * @param {boolean} noOverwrite Whether to overwrite existing data in the queue.
    786786                 *
    787                  * @returns {boolean} True if the data was queued.
     787                 * @return {boolean} True if the data was queued.
    788788                 */
    789789                function enqueue( handle, data, noOverwrite ) {
    … …  
    806806                 * @param {string} handle The handle for the data.
    807807                 *
    808                  * @returns {boolean} True if the data is queued with this handle.
     808                 * @return {boolean} True if the data is queued with this handle.
    809809                 */
    810810                function isQueued( handle ) {
    … …  
    823823                 * @param {string} handle The handle for the data.
    824824                 *
    825                  * @returns {void}
     825                 * @return {void}
    826826                 */
    827827                function dequeue( handle ) {
    … …  
    840840                 * @param {string} handle The handle for the data.
    841841                 *
    842                  * @returns {*} The data or undefined.
     842                 * @return {*} The data or undefined.
    843843                 */
    844844                function getQueuedItem( handle ) {

  • trunk/src/js/_enqueues/wp/media/audiovideo.js

    r43347 r46800  
    150150         *
    151151         * @param {string} data The text to apply the shortcode on.
    152          * @returns {wp.media} The media object.
     152         * @return {wp.media} The media object.
    153153         */
    154154        edit : function( data ) {
    … …  
    170170         *
    171171         * @param {Array} model Array with attributes for the shortcode.
    172          * @returns {wp.shortcode} The audio shortcode object.
     172         * @return {wp.shortcode} The audio shortcode object.
    173173         */
    174174        shortcode : function( model ) {
    … …  
    225225         *
    226226         * @param {string} data The text to apply the shortcode on.
    227          * @returns {wp.media} The media object.
     227         * @return {wp.media} The media object.
    228228         */
    229229        edit : function( data ) {
    … …  
    250250         *
    251251         * @param {Array} model Array with attributes for the shortcode.
    252          * @returns {wp.shortcode} The video shortcode object.
     252         * @return {wp.shortcode} The video shortcode object.
    253253         */
    254254        shortcode : function( model ) {

  • trunk/src/js/_enqueues/wp/media/editor.js

    r46799 r46800  
    2222         * @param {object} attrs Map of props from a shortcode or settings.
    2323         * @param {string} key The key within the passed map to check for a value.
    24          * @returns {mixed|undefined} The original or coerced value of key within attrs.
     24         * @return {mixed|undefined} The original or coerced value of key within attrs.
    2525         */
    2626        wp.media.coerce = function ( attrs, key ) {
    … …  
    4444                 * @param {Object} [props={}] Attachment details (align, link, size, etc).
    4545                 * @param {Object} attachment The attachment object, media version of Post.
    46                  * @returns {Object} Joined props
     46                 * @return {Object} Joined props
    4747                 */
    4848                props: function( props, attachment ) {
    … …  
    110110                 * @param {Object} props Attachment details (align, link, size, etc).
    111111                 * @param {Object} attachment The attachment object, media version of Post.
    112                  * @returns {string} The link markup
     112                 * @return {string} The link markup
    113113                 */
    114114                link: function( props, attachment ) {
    … …  
    136136                 * @param {Object} props Attachment details (align, link, size, etc).
    137137                 * @param {Object} attachment The attachment object, media version of Post.
    138                  * @returns {string} The audio shortcode
     138                 * @return {string} The audio shortcode
    139139                 */
    140140                audio: function( props, attachment ) {
    … …  
    146146                 * @param {Object} props Attachment details (align, link, size, etc).
    147147                 * @param {Object} attachment The attachment object, media version of Post.
    148                  * @returns {string} The video shortcode
     148                 * @return {string} The video shortcode
    149149                 */
    150150                video: function( props, attachment ) {
    … …  
    159159                 * @param {Object} props Attachment details (align, link, size, etc).
    160160                 * @param {Object} attachment The attachment object, media version of Post.
    161                  * @returns {string} The media shortcode
     161                 * @return {string} The media shortcode
    162162                 */
    163163                _audioVideo: function( type, props, attachment ) {
    … …  
    206206                 * @param {Object} props Attachment details (align, link, size, etc).
    207207                 * @param {Object} attachment The attachment object, media version of Post.
    208                  * @returns {string}
     208                 * @return {string}
    209209                 */
    210210                image: function( props, attachment ) {
    … …  
    346346                         *
    347347                         * @param {wp.shortcode} shortcode An instance of wp.shortcode().
    348                          * @returns {wp.media.model.Attachments} A Backbone.Collection containing
    349                          *      the media items belonging to a collection.
    350                          *      The query[ this.tag ] property is a Backbone.Model
    351                          *          containing the 'props' for the collection.
     348                         * @return {wp.media.model.Attachments} A Backbone.Collection containing
     349                         *                                      the media items belonging to a collection.
     350                         *                                      The query[ this.tag ] property is a Backbone.Model
     351                         *                                      containing the 'props' for the collection.
    352352                         */
    353353                        attachments: function( shortcode ) {
    … …  
    415415                         *      The query[ this.tag ] property is a Backbone.Model
    416416                         *          containing the 'props' for the collection.
    417                          * @returns {wp.shortcode}
     417                         * @return {wp.shortcode}
    418418                         */
    419419                        shortcode: function( attachments ) {
    … …  
    484484                         * @this wp.media.{prop}
    485485                         *
    486                          * @returns {wp.media.view.MediaFrame.Select} A media workflow.
     486                         * @return {wp.media.view.MediaFrame.Select} A media workflow.
    487487                         */
    488488                        edit: function( content ) {
    … …  
    604604                 * Get the featured image post ID
    605605                 *
    606                  * @returns {wp.media.view.settings.post.featuredImageId|number}
     606                 * @return {wp.media.view.settings.post.featuredImageId|number}
    607607                 */
    608608                get: function() {
    … …  
    643643                 * @this wp.media.featuredImage
    644644                 *
    645                  * @returns {wp.media.view.MediaFrame.Select} A media workflow.
     645                 * @return {wp.media.view.MediaFrame.Select} A media workflow.
    646646                 */
    647647                frame: function() {
    … …  
    776776                 * @this wp.media.editor
    777777                 *
    778                  * @returns {wp.media.view.MediaFrame.Select} A media workflow.
     778                 * @return {wp.media.view.MediaFrame.Select} A media workflow.
    779779                 */
    780780                add: function( id, options ) {
    … …  
    880880                 * @param {string} [id=''] A slug used to identify the workflow.
    881881                 *
    882                  * @returns {wpActiveEditor|string|tinymce.activeEditor.id}
     882                 * @return {wpActiveEditor|string|tinymce.activeEditor.id}
    883883                 */
    884884                id: function( id ) {
    … …  
    906906                 * @this wp.media.editor
    907907                 *
    908                  * @returns {wp.media.view.MediaFrame} A media workflow.
     908                 * @return {wp.media.view.MediaFrame} A media workflow.
    909909                 */
    910910                get: function( id ) {
    … …  
    931931                         * @param {Object} props Attachment details (align, link, size, etc).
    932932                         * @param {Object} attachment The attachment object, media version of Post.
    933                          * @returns {Promise}
     933                         * @return {Promise}
    934934                         */
    935935                        attachment: function( props, attachment ) {
    … …  
    985985                         *
    986986                         * @param {Object} embed
    987                          * @returns {Promise}
     987                         * @return {Promise}
    988988                         */
    989989                        link: function( embed ) {
    … …  
    10051005                 * @this wp.media.editor
    10061006                 *
    1007                  * @returns {wp.media.view.MediaFrame}
     1007                 * @return {wp.media.view.MediaFrame}
    10081008                 */
    10091009                open: function( id, options ) {

  • trunk/src/js/_enqueues/wp/media/models.js

    r43347 r46800  
    139139         *
    140140         * @param {Object} dimensions
    141          * @returns {Object}
     141         * @return {Object}
    142142         */
    143143        fit: function( dimensions ) {
    … …  
    185185         * @param {Number} [length=30]
    186186         * @param {String} [replacement=&hellip;]
    187          * @returns {String} The string, unless length is greater than string.length.
     187         * @return {String} The string, unless length is greater than string.length.
    188188         */
    189189        truncate: function( string, length, replacement ) {
    … …  
    209209 * @static
    210210 * @param {String} id A string used to identify a model.
    211  * @returns {wp.media.model.Attachment}
     211 * @return {wp.media.model.Attachment}
    212212 */
    213213media.attachment = function( id ) {
    … …  
    229229 *
    230230 * @param {object} [props]
    231  * @returns {wp.media.model.Attachments}
     231 * @return {wp.media.model.Attachments}
    232232 */
    233233media.query = function( props ) {

  • trunk/src/js/_enqueues/wp/media/views.js

    r44969 r46800  
    5050 * @param {string} selector
    5151 * @param {Number} sensitivity
    52  * @returns {Promise}
     52 * @return {Promise}
    5353 */
    5454media.transition = function( selector, sensitivity ) {

  • trunk/src/js/_enqueues/wp/password-strength-meter.js

    r43577 r46800  
    2828                 * @param {string} password2 The password confirmation.
    2929                 *
    30                  * @returns {number} The password strength score.
     30                 * @return {number} The password strength score.
    3131                 */
    3232                meter : function( password1, blacklist, password2 ) {
    … …  
    5555                 * @since 3.7.0
    5656                 *
    57                  * @returns {string[]} The array of words to be blacklisted.
     57                 * @return {string[]} The array of words to be blacklisted.
    5858                 */
    5959                userInputBlacklist : function() {

  • trunk/src/js/_enqueues/wp/theme-plugin-editor.js

    r46586 r46800  
    3737         * @param {object}         settings - Settings.
    3838         * @param {object|boolean} settings.codeEditor - Code editor settings (or `false` if syntax highlighting is disabled).
    39          * @returns {void}
     39         * @return {void}
    4040         */
    4141        component.init = function init( form, settings ) {
    … …  
    9595         *
    9696         * @since 4.9.0
    97          * @returns {void}
     97         * @return {void}
    9898         */
    9999        component.showWarning = function() {
    … …  
    126126         * @since 4.9.0
    127127         * @param {object} event jQuery event object.
    128          * @returns {void}
     128         * @return {void}
    129129         */
    130130        component.constrainTabbing = function( event ) {
    … …  
    151151         *
    152152         * @since 4.9.0
    153          * @returns {void}
     153         * @return {void}
    154154         */
    155155        component.dismissWarning = function() {
    … …  
    169169         *
    170170         * @since 4.9.0
    171          * @returns {void}
     171         * @return {void}
    172172         */
    173173        component.onChange = function() {
    … …  
    181181         * @since 4.9.0
    182182         * @param {jQuery.Event} event - Event.
    183          * @returns {void}
     183         * @return {void}
    184184         */
    185185        component.submit = function( event ) {
    … …  
    268268         * @param {boolean}  [notice.dismissible=false] - Dismissible.
    269269         * @param {Function} [notice.onDismiss] - Callback for when a user dismisses the notice.
    270          * @returns {jQuery} Notice element.
     270         * @return {jQuery} Notice element.
    271271         */
    272272        component.addNotice = function( notice ) {
    … …  
    304304         *
    305305         * @param {string} code - Notice code.
    306          * @returns {boolean} Whether a notice was removed.
     306         * @return {boolean} Whether a notice was removed.
    307307         */
    308308        component.removeNotice = function( code ) {
    … …  
    321321         *
    322322         * @since 4.9.0
    323          * @returns {void}
     323         * @return {void}
    324324         */
    325325        component.initCodeEditor = function initCodeEditor() {
    … …  
    333333                 * @since 4.9.0
    334334                 *
    335                  * @returns {void}
     335                 * @return {void}
    336336                 */
    337337                codeEditorSettings.onTabPrevious = function() {
    … …  
    344344                 * @since 4.9.0
    345345                 *
    346                  * @returns {void}
     346                 * @return {void}
    347347                 */
    348348                codeEditorSettings.onTabNext = function() {
    … …  
    356356                 *
    357357                 * @param {Array} errors - List of linting errors.
    358                  * @returns {void}
     358                 * @return {void}
    359359                 */
    360360                codeEditorSettings.onChangeLintingErrors = function( errors ) {
    … …  
    373373                 *
    374374                 * @param {Array} errorAnnotations - Error annotations.
    375                  * @returns {void}
     375                 * @return {void}
    376376                 */
    377377                codeEditorSettings.onUpdateErrorNotice = function onUpdateErrorNotice( errorAnnotations ) {
    … …  
    425425         *
    426426         * @since 4.9.0
    427          * @returns {void}
     427         * @return {void}
    428428         */
    429429        component.initFileBrowser = function initFileBrowser() {

  • trunk/src/js/_enqueues/wp/theme.js

    r45557 r46800  
    14001400 * @param {string} url - URL to navigate to.
    14011401 * @param {object} state - State.
    1402  * @returns {void}
     1402 * @return {void}
    14031403 */
    14041404function navigateRouter( url, state ) {

  • trunk/src/js/_enqueues/wp/updates.js

    r46348 r46800  
    15991599         * @param {string} response.errorMessage The error that occurred.
    16001600         * @param {string} action                The type of request to perform.
    1601          * @returns {boolean} Whether there is an error that needs to be handled or not.
     1601         * @return {boolean} Whether there is an error that needs to be handled or not.
    16021602         */
    16031603        wp.updates.maybeHandleCredentialError = function( response, action ) {

  • trunk/src/js/_enqueues/wp/utils/word-count.js

    r43347 r46800  
    4242         *                                                            from the text.
    4343         *
    44          * @return void
     44         * @return {void}
    4545         */
    4646        function WordCounter( settings ) {

  • trunk/src/js/_enqueues/wp/widgets/custom-html.js

    r46586 r46800  
    4545                 * @param {jQuery} options.syncContainer - Container element where fields are synced for the server.
    4646                 *
    47                  * @returns {void}
     47                 * @return {void}
    4848                 */
    4949                initialize: function initialize( options ) {
    … …  
    9898                 * overwriting content that the user is entering.
    9999                 *
    100                  * @returns {void}
     100                 * @return {void}
    101101                 */
    102102                updateFields: function updateFields() {
    … …  
    124124                 *
    125125                 * @param {Array} errorAnnotations - Error annotations.
    126                  * @returns {void}
     126                 * @return {void}
    127127                 */
    128128                updateErrorNotice: function( errorAnnotations ) {
    … …  
    165165                 * Initialize editor.
    166166                 *
    167                  * @returns {void}
     167                 * @return {void}
    168168                 */
    169169                initializeEditor: function initializeEditor() {
    … …  
    181181                                 * @ignore
    182182                                 *
    183                                  * @returns {void}
     183                                 * @return {void}
    184184                                 */
    185185                                onTabPrevious: function onTabPrevious() {
    … …  
    192192                                 * @ignore
    193193                                 *
    194                                  * @returns {void}
     194                                 * @return {void}
    195195                                 */
    196196                                onTabNext: function onTabNext() {
    … …  
    205205                                 *
    206206                                 * @param {Array} errorAnnotations - Error notifications.
    207                                  * @returns {void}
     207                                 * @return {void}
    208208                                 */
    209209                                onChangeLintingErrors: function onChangeLintingErrors( errorAnnotations ) {
    … …  
    217217                                 *
    218218                                 * @param {Array} errorAnnotations - Error annotations.
    219                                  * @returns {void}
     219                                 * @return {void}
    220220                                 */
    221221                                onUpdateErrorNotice: function onUpdateErrorNotice( errorAnnotations ) {
    … …  
    289289         * @param {jQuery}       widgetContainer - Widget container element.
    290290         *
    291          * @returns {void}
     291         * @return {void}
    292292         */
    293293        component.handleWidgetAdded = function handleWidgetAdded( event, widgetContainer ) {
    … …  
    348348         * @alias wp.customHtmlWidgets.setupAccessibleMode
    349349         *
    350          * @returns {void}
     350         * @return {void}
    351351         */
    352352        component.setupAccessibleMode = function setupAccessibleMode() {
    … …  
    385385         * @param {jQuery.Event} event - Event.
    386386         * @param {jQuery}       widgetContainer - Widget container element.
    387          * @returns {void}
     387         * @return {void}
    388388         */
    389389        component.handleWidgetUpdated = function handleWidgetUpdated( event, widgetContainer ) {
    … …  
    416416         * @param {object} settings - Options for code editor, exported from PHP.
    417417         *
    418          * @returns {void}
     418         * @return {void}
    419419         */
    420420        component.init = function init( settings ) {

  • trunk/src/js/_enqueues/wp/widgets/media-audio.js

    r46586 r46800  
    2020                 * Create the default states.
    2121                 *
    22                  * @returns {void}
     22                 * @return {void}
    2323                 */
    2424                createStates: function createStates() {
    … …  
    7171                 *
    7272                 * @param {Object} modelProps - Model props.
    73                  * @returns {Object} Media frame props.
     73                 * @return {Object} Media frame props.
    7474                 */
    7575                mapModelToMediaFrameProps: function mapModelToMediaFrameProps( modelProps ) {
    … …  
    8383                 * Render preview.
    8484                 *
    85                  * @returns {void}
     85                 * @return {void}
    8686                 */
    8787                renderPreview: function renderPreview() {
    … …  
    110110                 * Open the media audio-edit frame to modify the selected item.
    111111                 *
    112                  * @returns {void}
     112                 * @return {void}
    113113                 */
    114114                editMedia: function editMedia() {

  • trunk/src/js/_enqueues/wp/widgets/media-gallery.js

    r46586 r46800  
    2222                 *
    2323                 * @since 4.9.0
    24                  * @returns {void}
     24                 * @return {void}
    2525                 */
    2626                createStates: function createStates() {
    … …  
    8989                 * @param {jQuery}         options.el - Control field container element.
    9090                 * @param {jQuery}         options.syncContainer - Container element where fields are synced for the server.
    91                  * @returns {void}
     91                 * @return {void}
    9292                 */
    9393                initialize: function initialize( options ) {
    … …  
    123123                 *
    124124                 * @since 4.9.0
    125                  * @returns {void}
     125                 * @return {void}
    126126                 */
    127127                updateSelectedAttachments: function updateSelectedAttachments() {
    … …  
    156156                 *
    157157                 * @since 4.9.0
    158                  * @returns {void}
     158                 * @return {void}
    159159                 */
    160160                renderPreview: function renderPreview() {
    … …  
    177177                 *
    178178                 * @since 4.9.0
    179                  * @returns {boolean} Selected.
     179                 * @return {boolean} Selected.
    180180                 */
    181181                isSelected: function isSelected() {
    … …  
    193193                 *
    194194                 * @since 4.9.0
    195                  * @returns {void}
     195                 * @return {void}
    196196                 */
    197197                editMedia: function editMedia() {
    … …  
    256256                 *
    257257                 * @since 4.9.0
    258                  * @returns {void}
     258                 * @return {void}
    259259                 */
    260260                selectMedia: function selectMedia() {
    … …  
    322322                 * @since 4.9.0
    323323                 * @param {wp.media.models.Attachment} attachment - Attachment.
    324                  * @returns {void}
     324                 * @return {void}
    325325                 */
    326326                handleAttachmentDestroy: function handleAttachmentDestroy( attachment ) {

  • trunk/src/js/_enqueues/wp/widgets/media-image.js

    r46586 r46800  
    4141                 * Render preview.
    4242                 *
    43                  * @returns {void}
     43                 * @return {void}
    4444                 */
    4545                renderPreview: function renderPreview() {
    … …  
    6565                 * Open the media image-edit frame to modify the selected item.
    6666                 *
    67                  * @returns {void}
     67                 * @return {void}
    6868                 */
    6969                editMedia: function editMedia() {
    … …  
    120120                 * Get props which are merged on top of the model when an embed is chosen (as opposed to an attachment).
    121121                 *
    122                  * @returns {Object} Reset/override props.
     122                 * @return {Object} Reset/override props.
    123123                 */
    124124                getEmbedResetProps: function getEmbedResetProps() {
    … …  
    139139                 *
    140140                 * @param {wp.media.view.MediaFrame.Select} mediaFrame - Select frame.
    141                  * @returns {Object} Props.
     141                 * @return {Object} Props.
    142142                 */
    143143                getModelPropsFromMediaFrame: function getModelPropsFromMediaFrame( mediaFrame ) {
    … …  
    152152                 * Map model props to preview template props.
    153153                 *
    154                  * @returns {Object} Preview template props.
     154                 * @return {Object} Preview template props.
    155155                 */
    156156                mapModelToPreviewTemplateProps: function mapModelToPreviewTemplateProps() {

  • trunk/src/js/_enqueues/wp/widgets/media-video.js

    r46586 r46800  
    2222                 * Create the default states.
    2323                 *
    24                  * @returns {void}
     24                 * @return {void}
    2525                 */
    2626                createStates: function createStates() {
    … …  
    8989                 *
    9090                 * @param {Object} modelProps - Model props.
    91                  * @returns {Object} Media frame props.
     91                 * @return {Object} Media frame props.
    9292                 */
    9393                mapModelToMediaFrameProps: function mapModelToMediaFrameProps( modelProps ) {
    … …  
    101101                 * Fetches embed data for external videos.
    102102                 *
    103                  * @returns {void}
     103                 * @return {void}
    104104                 */
    105105                fetchEmbed: function fetchEmbed() {
    … …  
    145145                 * @deprecated since 4.9.
    146146                 *
    147                  * @returns {boolean} Whether url is a supported video host.
     147                 * @return {boolean} Whether url is a supported video host.
    148148                 */
    149149                isHostedVideo: function isHostedVideo() {
    … …  
    154154                 * Render preview.
    155155                 *
    156                  * @returns {void}
     156                 * @return {void}
    157157                 */
    158158                renderPreview: function renderPreview() {
    … …  
    212212                 * Open the media image-edit frame to modify the selected item.
    213213                 *
    214                  * @returns {void}
     214                 * @return {void}
    215215                 */
    216216                editMedia: function editMedia() {

  • trunk/src/js/_enqueues/wp/widgets/media.js

    r46745 r46800  
    4646                 * @param {Object} options - Options.
    4747                 *
    48                  * @returns {void}
     48                 * @return {void}
    4949                 */
    5050                initialize: function initialize( options ) {
    … …  
    5757                 *
    5858                 * @param {Backbone.Model} displaySettings - Modified display settings.
    59                  * @returns {void}
     59                 * @return {void}
    6060                 */
    6161                handleDisplaySettingChange: function handleDisplaySettingChange( displaySettings ) {
    … …  
    7272                 *
    7373                 * @param {Backbone.Model} model - Display settings model.
    74                  * @returns {Backbone.Model} Display settings model.
     74                 * @return {Backbone.Model} Display settings model.
    7575                 */
    7676                display: function getDisplaySettingsModel( model ) {
    … …  
    102102                 *
    103103                 * @param {object} options - Options.
    104                  * @returns {void}
     104                 * @return {void}
    105105                 */
    106106                initialize: function( options ) {
    … …  
    118118                 * Forked override of {wp.media.view.Embed#refresh()} to suppress irrelevant "link text" field.
    119119                 *
    120                  * @returns {void}
     120                 * @return {void}
    121121                 */
    122122                refresh: function refresh() {
    … …  
    137137                                         *
    138138                                         * @param {boolean} disabled - Disabled.
    139                                          * @returns {void}
     139                                         * @return {void}
    140140                                         */
    141141                                        setAddToWidgetButtonDisabled: function setAddToWidgetButtonDisabled( disabled ) {
    … …  
    147147                                         *
    148148                                         * @param {string} notice - Notice.
    149                                          * @returns {void}
     149                                         * @return {void}
    150150                                         */
    151151                                        setErrorNotice: function setErrorNotice( notice ) {
    … …  
    176176                                         * @since 4.9.0
    177177                                         *
    178                                          * @returns {void}
     178                                         * @return {void}
    179179                                         */
    180180                                        updateoEmbed: function() {
    … …  
    201201                                         * Fetch media.
    202202                                         *
    203                                          * @returns {void}
     203                                         * @return {void}
    204204                                         */
    205205                                        fetch: function() {
    … …  
    277277                                         * uses {jQuery.fn.show()} which adds an inline style. This avoids the need for !important.
    278278                                         *
    279                                          * @returns {void}
     279                                         * @return {void}
    280280                                         */
    281281                                        renderFail: function renderFail() {
    … …  
    307307                 * Create the default states.
    308308                 *
    309                  * @returns {void}
     309                 * @return {void}
    310310                 */
    311311                createStates: function createStates() {
    … …  
    359359                 * @param {wp.Backbone.View} view - Toolbar view.
    360360                 * @this {wp.media.controller.Library}
    361                  * @returns {void}
     361                 * @return {void}
    362362                 */
    363363                mainInsertToolbar: function mainInsertToolbar( view ) {
    … …  
    375375                                 *
    376376                                 * @fires wp.media.controller.State#insert()
    377                                  * @returns {void}
     377                                 * @return {void}
    378378                                 */
    379379                                click: function onClick() {
    … …  
    394394                 * @param {wp.Backbone.View} toolbar - Toolbar view.
    395395                 * @this {wp.media.controller.Library}
    396                  * @returns {void}
     396                 * @return {void}
    397397                 */
    398398                mainEmbedToolbar: function mainEmbedToolbar( toolbar ) {
    … …  
    409409                 * Forked override of {wp.media.view.MediaFrame.Post#embedContent()} to suppress irrelevant "link text" field.
    410410                 *
    411                  * @returns {void}
     411                 * @return {void}
    412412                 */
    413413                embedContent: function embedContent() {
    … …  
    490490                 * @param {jQuery}         options.syncContainer - Container element where fields are synced for the server.
    491491                 *
    492                  * @returns {void}
     492                 * @return {void}
    493493                 */
    494494                initialize: function initialize( options ) {
    … …  
    594594                 * Update the selected attachment if necessary.
    595595                 *
    596                  * @returns {void}
     596                 * @return {void}
    597597                 */
    598598                updateSelectedAttachment: function updateSelectedAttachment() {
    … …  
    620620                 * Sync the model attributes to the hidden inputs, and update previewTemplateProps.
    621621                 *
    622                  * @returns {void}
     622                 * @return {void}
    623623                 */
    624624                syncModelToPreviewProps: function syncModelToPreviewProps() {
    … …  
    630630                 * Sync the model attributes to the hidden inputs, and update previewTemplateProps.
    631631                 *
    632                  * @returns {void}
     632                 * @return {void}
    633633                 */
    634634                syncModelToInputs: function syncModelToInputs() {
    … …  
    660660                 * Get template.
    661661                 *
    662                  * @returns {Function} Template.
     662                 * @return {Function} Template.
    663663                 */
    664664                template: function template() {
    … …  
    673673                 * Render template.
    674674                 *
    675                  * @returns {void}
     675                 * @return {void}
    676676                 */
    677677                render: function render() {
    … …  
    696696                 *
    697697                 * @abstract
    698                  * @returns {void}
     698                 * @return {void}
    699699                 */
    700700                renderPreview: function renderPreview() {
    … …  
    705705                 * Whether a media item is selected.
    706706                 *
    707                  * @returns {boolean} Whether selected and no error.
     707                 * @return {boolean} Whether selected and no error.
    708708                 */
    709709                isSelected: function isSelected() {
    … …  
    721721                 *
    722722                 * @param {jQuery.Event} event - Event.
    723                  * @returns {void}
     723                 * @return {void}
    724724                 */
    725725                handleMediaLibraryLinkClick: function handleMediaLibraryLinkClick( event ) {
    … …  
    732732                 * Open the media select frame to chose an item.
    733733                 *
    734                  * @returns {void}
     734                 * @return {void}
    735735                 */
    736736                selectMedia: function selectMedia() {
    … …  
    819819                 *
    820820                 * @param {wp.media.view.MediaFrame.Select} mediaFrame - Select frame.
    821                  * @returns {Object} Props.
     821                 * @return {Object} Props.
    822822                 */
    823823                getModelPropsFromMediaFrame: function getModelPropsFromMediaFrame( mediaFrame ) {
    … …  
    868868                 *
    869869                 * @param {Object} mediaFrameProps - Media frame props.
    870                  * @returns {Object} Model props.
     870                 * @return {Object} Model props.
    871871                 */
    872872                mapMediaToModelProps: function mapMediaToModelProps( mediaFrameProps ) {
    … …  
    919919                 *
    920920                 * @param {Object} modelProps - Model props.
    921                  * @returns {Object} Media frame props.
     921                 * @return {Object} Media frame props.
    922922                 */
    923923                mapModelToMediaFrameProps: function mapModelToMediaFrameProps( modelProps ) {
    … …  
    943943                 * Map model props to previewTemplateProps.
    944944                 *
    945                  * @returns {Object} Preview Template Props.
     945                 * @return {Object} Preview Template Props.
    946946                 */
    947947                mapModelToPreviewTemplateProps: function mapModelToPreviewTemplateProps() {
    … …  
    962962                 *
    963963                 * @abstract
    964                  * @returns {void}
     964                 * @return {void}
    965965                 */
    966966                editMedia: function editMedia() {
    … …  
    10101010                 * Get default attribute values.
    10111011                 *
    1012                  * @returns {Object} Mapping of property names to their default values.
     1012                 * @return {Object} Mapping of property names to their default values.
    10131013                 */
    10141014                defaults: function() {
    … …  
    10301030                 * @param {mixed|Object}  [val] - Attribute value or options object.
    10311031                 * @param {Object}        [options] - Options when attribute name and value are passed separately.
    1032                  * @returns {wp.mediaWidgets.MediaWidgetModel} This model.
     1032                 * @return {wp.mediaWidgets.MediaWidgetModel} This model.
    10331033                 */
    10341034                set: function set( key, val, options ) {
    … …  
    10841084                 * Get props which are merged on top of the model when an embed is chosen (as opposed to an attachment).
    10851085                 *
    1086                  * @returns {Object} Reset/override props.
     1086                 * @return {Object} Reset/override props.
    10871087                 */
    10881088                getEmbedResetProps: function getEmbedResetProps() {
    … …  
    11211121         * @param {jQuery}       widgetContainer - Widget container element.
    11221122         *
    1123          * @returns {void}
     1123         * @return {void}
    11241124         */
    11251125        component.handleWidgetAdded = function handleWidgetAdded( event, widgetContainer ) {
    … …  
    12041204         * @memberOf wp.mediaWidgets
    12051205         *
    1206          * @returns {void}
     1206         * @return {void}
    12071207         */
    12081208        component.setupAccessibleMode = function setupAccessibleMode() {
    … …  
    12581258         * @param {jQuery}       widgetContainer - Widget container element.
    12591259         *
    1260          * @returns {void}
     1260         * @return {void}
    12611261         */
    12621262        component.handleWidgetUpdated = function handleWidgetUpdated( event, widgetContainer ) {
    … …  
    12921292         * @memberOf wp.mediaWidgets
    12931293         *
    1294          * @returns {void}
     1294         * @return {void}
    12951295         */
    12961296        component.init = function init() {

  • trunk/src/js/_enqueues/wp/widgets/text.js

    r46586 r46800  
    3737                 * @param {jQuery} options.syncContainer - Container element where fields are synced for the server.
    3838                 *
    39                  * @returns {void}
     39                 * @return {void}
    4040                 */
    4141                initialize: function initialize( options ) {
    … …  
    106106                 *
    107107                 * @param {Array} pointers Pointer IDs to dismiss.
    108                  * @returns {void}
     108                 * @return {void}
    109109                 */
    110110                dismissPointers: function dismissPointers( pointers ) {
    … …  
    121121                 *
    122122                 * @since 4.8.1
    123                  * @returns {void}
     123                 * @return {void}
    124124                 */
    125125                openAvailableWidgetsPanel: function openAvailableWidgetsPanel() {
    … …  
    146146                 * overwriting content that the user is entering.
    147147                 *
    148                  * @returns {void}
     148                 * @return {void}
    149149                 */
    150150                updateFields: function updateFields() {
    … …  
    169169                 * Initialize editor.
    170170                 *
    171                  * @returns {void}
     171                 * @return {void}
    172172                 */
    173173                initializeEditor: function initializeEditor() {
    … …  
    180180                         * Trigger change if dirty.
    181181                         *
    182                          * @returns {void}
     182                         * @return {void}
    183183                         */
    184184                        triggerChangeIfDirty = function() {
    … …  
    226226                         * Build (or re-build) the visual editor.
    227227                         *
    228                          * @returns {void}
     228                         * @return {void}
    229229                         */
    230230                        function buildEditor() {
    … …  
    275275                                 *
    276276                                 * @param {jQuery} pointerElement Pointer element.
    277                                  * @returns {void}
     277                                 * @return {void}
    278278                                 */
    279279                                showPointerElement = function( pointerElement ) {
    … …  
    378378         * @param {jQuery}       widgetContainer - Widget container element.
    379379         *
    380          * @returns {void}
     380         * @return {void}
    381381         */
    382382        component.handleWidgetAdded = function handleWidgetAdded( event, widgetContainer ) {
    … …  
    443443         * @memberOf wp.textWidgets
    444444         *
    445          * @returns {void}
     445         * @return {void}
    446446         */
    447447        component.setupAccessibleMode = function setupAccessibleMode() {
    … …  
    485485         * @param {jQuery.Event} event - Event.
    486486         * @param {jQuery}       widgetContainer - Widget container element.
    487          * @returns {void}
     487         * @return {void}
    488488         */
    489489        component.handleWidgetUpdated = function handleWidgetUpdated( event, widgetContainer ) {
    … …  
    514514         * @memberOf wp.textWidgets
    515515         *
    516          * @returns {void}
     516         * @return {void}
    517517         */
    518518        component.init = function init() {

  • trunk/src/js/media/controllers/cropper.js

    r43309 r46800  
    3232         * @since 4.2.0
    3333         *
    34          * @returns {void}
     34         * @return {void}
    3535         */
    3636        activate: function() {
    … …  
    4545         * @since 4.2.0
    4646         *
    47          * @returns {void}
     47         * @return {void}
    4848         */
    4949        deactivate: function() {
    … …  
    6060         * @fires crop window
    6161         *
    62          * @returns {void}
     62         * @return {void}
    6363         */
    6464        createCropContent: function() {
    … …  
    7777         * @since 4.2.0
    7878         *
    79          * @returns {void}
     79         * @return {void}
    8080         */
    8181        removeCropper: function() {
    … …  
    9191         * @since 4.2.0
    9292         *
    93          * @returns {void}
     93         * @return {void}
    9494         */
    9595        createCropToolbar: function() {
    … …  
    153153         * @since 4.2.0
    154154         *
    155          * @returns {$.promise} A jQuery promise with the custom header crop details.
     155         * @return {$.promise} A jQuery promise with the custom header crop details.
    156156         */
    157157        doCrop: function( attachment ) {

  • trunk/src/js/media/controllers/customize-image-cropper.js

    r46586 r46800  
    2323         * @param {Object} attachment The attachment to crop.
    2424         *
    25          * @returns {$.promise} A jQuery promise that represents the crop image request.
     25         * @return {$.promise} A jQuery promise that represents the crop image request.
    2626         */
    2727        doCrop: function( attachment ) {

  • trunk/src/js/media/controllers/edit-image.js

    r43309 r46800  
    3737         * @since 3.9.0
    3838         *
    39          * @returns {void}
     39         * @return {void}
    4040         */
    4141        activate: function() {
    … …  
    4848         * @since 3.9.0
    4949         *
    50          * @returns {void}
     50         * @return {void}
    5151         */
    5252        deactivate: function() {
    … …  
    6363         * @since 3.9.0
    6464         *
    65          * @returns {void}
     65         * @return {void}
    6666         */
    6767        toolbar: function() {

  • trunk/src/js/media/controllers/gallery-add.js

    r43309 r46800  
    5656         * @since 3.5.0
    5757         *
    58          * @returns {void}
     58         * @return {void}
    5959         */
    6060        initialize: function() {
    … …  
    7474         * @since 3.5.0
    7575         *
    76          * @returns {void}
     76         * @return {void}
    7777         */
    7878        activate: function() {

  • trunk/src/js/media/controllers/library.js

    r43309 r46800  
    154154         *
    155155         * @param {wp.media.model.Attachment} attachment
    156          * @returns {Backbone.Model}
     156         * @return {Backbone.Model}
    157157         */
    158158        display: function( attachment ) {
    … …  
    171171         *
    172172         * @param {wp.media.model.Attachment} attachment
    173          * @returns {Object}
     173         * @return {Object}
    174174         */
    175175        defaultDisplaySettings: function( attachment ) {
    … …  
    191191         *
    192192         * @param {wp.media.model.Attachment} attachment
    193          * @returns {Boolean}
     193         * @return {Boolean}
    194194         */
    195195        isImageAttachment: function( attachment ) {
    … …  
    208208         *
    209209         * @param {wp.media.model.Attachment} attachment
    210          * @returns {Boolean}
     210         * @return {Boolean}
    211211         */
    212212        canEmbed: function( attachment ) {

  • trunk/src/js/media/controllers/region.js

    r46799 r46800  
    3939         * @fires Region#deactivate
    4040         *
    41          * @returns {wp.media.controller.Region} Returns itself to allow chaining.
     41         * @return {wp.media.controller.Region} Returns itself to allow chaining.
    4242         */
    4343        mode: function( mode ) {
    … …  
    7878         * @fires Region#render
    7979         *
    80          * @returns {wp.media.controller.Region} Returns itself to allow chaining.
     80         * @return {wp.media.controller.Region} Returns itself to allow chaining.
    8181         */
    8282        render: function( mode ) {
    … …  
    121121         * @since 3.5.0
    122122         *
    123          * @returns {wp.media.View}
     123         * @return {wp.media.View}
    124124         */
    125125        get: function() {
    … …  
    134134         * @param {Array|Object} views
    135135         * @param {Object} [options={}]
    136          * @returns {wp.Backbone.Subviews} Subviews is returned to allow chaining.
     136         * @return {wp.Backbone.Subviews} Subviews is returned to allow chaining.
    137137         */
    138138        set: function( views, options ) {
    … …  
    149149         *
    150150         * @param {string} event
    151          * @returns {undefined|wp.media.controller.Region} Returns itself to allow chaining.
     151         * @return {undefined|wp.media.controller.Region} Returns itself to allow chaining.
    152152         */
    153153        trigger: function( event ) {

  • trunk/src/js/media/controllers/state-machine.js

    r46799 r46800  
    3232         *
    3333         * Ensure that the `states` collection exists so the `StateMachine`
    34          *   can be used as a mixin.
     34         * can be used as a mixin.
    3535         *
    3636         * @since 3.5.0
    3737         *
    3838         * @param {string} id
    39          * @returns {wp.media.controller.State} Returns a State model
    40          *   from the StateMachine collection
     39         * @return {wp.media.controller.State} Returns a State model from
     40         *                                     the StateMachine collection.
    4141         */
    4242        state: function( id ) {
    … …  
    6666         * @fires wp.media.controller.State#activate
    6767         *
    68          * @returns {wp.media.controller.StateMachine} Returns itself to allow chaining.
     68         * @return {wp.media.controller.StateMachine} Returns itself to allow chaining.
    6969         */
    7070        setState: function( id ) {
    … …  
    9494         * @since 3.5.0
    9595         *
    96          * @returns {wp.media.controller.State} Returns a State model
    97          *    from the StateMachine collection
     96         * @return {wp.media.controller.State} Returns a State model from
     97         *                                     the StateMachine collection.
    9898         */
    9999        lastState: function() {
    … …  
    110110         * @memberOf wp.media.controller.StateMachine
    111111         * @instance
    112          * @returns {wp.media.controller.StateMachine} Returns itself to allow chaining.
     112         * @return {wp.media.controller.StateMachine} Returns itself to allow chaining.
    113113         */
    114114        /**
    … …  
    116116         * @memberOf wp.media.controller.StateMachine
    117117         * @instance
    118          * @returns {wp.media.controller.StateMachine} Returns itself to allow chaining.
     118         * @return {wp.media.controller.StateMachine} Returns itself to allow chaining.
    119119         */
    120120        /**
    … …  
    122122         * @memberOf wp.media.controller.StateMachine
    123123         * @instance
    124          * @returns {wp.media.controller.StateMachine} Returns itself to allow chaining.
     124         * @return {wp.media.controller.StateMachine} Returns itself to allow chaining.
    125125         */
    126126        StateMachine.prototype[ method ] = function() {

  • trunk/src/js/media/models/attachment.js

    r43309 r46800  
    1919         * @param {Object} [options={}]
    2020         *
    21          * @returns {Promise}
     21         * @return {Promise}
    2222         */
    2323        sync: function( method, model, options ) {
    … …  
    101101         *
    102102         * @param {Object} resp The raw response object, typically returned by fetch()
    103          * @returns {Object} The modified response object, which is the attributes hash
    104          *    to be set on the model.
     103         * @return {Object} The modified response object, which is the attributes hash
     104         *                  to be set on the model.
    105105         */
    106106        parse: function( resp ) {
    … …  
    119119         * @this Backbone.Model
    120120         *
    121          * @returns {Promise}
     121         * @return {Promise}
    122122         */
    123123        saveCompat: function( data, options ) {
    … …  
    144144         *
    145145         * @param {Object} attrs
    146          * @returns {wp.media.model.Attachment}
     146         * @return {wp.media.model.Attachment}
    147147         */
    148148        create: function( attrs ) {
    … …  
    159159         * @param {string} id A string used to identify a model.
    160160         * @param {Backbone.Model|undefined} attachment
    161          * @returns {wp.media.model.Attachment}
     161         * @return {wp.media.model.Attachment}
    162162         */
    163163        get: _.memoize( function( id, attachment ) {

  • trunk/src/js/media/models/attachments.js

    r46799 r46800  
    149149         *
    150150         * @param {wp.media.model.Attachment} attachment
    151          * @returns {Boolean}
     151         * @return {Boolean}
    152152         */
    153153        validator: function( attachment ) {
    … …  
    173173         * @param {wp.media.model.Attachment} attachment
    174174         * @param {Object} options
    175          * @returns {wp.media.model.Attachments} Returns itself to allow chaining.
     175         * @return {wp.media.model.Attachments} Returns itself to allow chaining.
    176176         */
    177177        validate: function( attachment, options ) {
    … …  
    196196         * @fires wp.media.model.Attachments#reset
    197197         *
    198          * @returns {wp.media.model.Attachments} Returns itself to allow chaining.
     198         * @return {wp.media.model.Attachments} Returns itself to allow chaining.
    199199         */
    200200        validateAll: function( attachments, options ) {
    … …  
    215215         *
    216216         * @param {wp.media.model.Attachments} The attachments collection to observe.
    217          * @returns {wp.media.model.Attachments} Returns itself to allow chaining.
     217         * @return {wp.media.model.Attachments} Returns itself to allow chaining.
    218218         */
    219219        observe: function( attachments ) {
    … …  
    230230         *
    231231         * @param {wp.media.model.Attachments} The attachments collection to stop observing.
    232          * @returns {wp.media.model.Attachments} Returns itself to allow chaining.
     232         * @return {wp.media.model.Attachments} Returns itself to allow chaining.
    233233         */
    234234        unobserve: function( attachments ) {
    … …  
    253253         * @param {Object} options
    254254         *
    255          * @returns {wp.media.model.Attachments} Returns itself to allow chaining.
     255         * @return {wp.media.model.Attachments} Returns itself to allow chaining.
    256256         */
    257257        _validateHandler: function( attachment, attachments, options ) {
    … …  
    269269         * @param {wp.media.model.Attachments} attachments
    270270         * @param {Object} options
    271          * @returns {wp.media.model.Attachments} Returns itself to allow chaining.
     271         * @return {wp.media.model.Attachments} Returns itself to allow chaining.
    272272         */
    273273        _validateAllHandler: function( attachments, options ) {
    … …  
    279279         *
    280280         * @param {wp.media.model.Attachments} The attachments collection to mirror.
    281          * @returns {wp.media.model.Attachments} Returns itself to allow chaining.
     281         * @return {wp.media.model.Attachments} Returns itself to allow chaining.
    282282         */
    283283        mirror: function( attachments ) {
    … …  
    317317         *
    318318         * @param {object} options
    319          * @returns {Promise}
     319         * @return {Promise}
    320320         */
    321321        more: function( options ) {
    … …  
    350350         * server persistence by itself.
    351351         *
    352          * @returns {boolean}
     352         * @return {boolean}
    353353         */
    354354        hasMore: function() {
    … …  
    362362         * @param {Object|Array} resp The raw response Object/Array.
    363363         * @param {Object} xhr
    364          * @returns {Array} The array of model attributes to be added to the collection
     364         * @return {Array} The array of model attributes to be added to the collection
    365365         */
    366366        parse: function( resp, xhr ) {
    … …  
    406406         * the menu order to the database.
    407407         *
    408          * @returns {undefined|Promise}
     408         * @return {undefined|Promise}
    409409         */
    410410        saveMenuOrder: function() {
    … …  
    445445         * @param {Backbone.Model} b
    446446         * @param {Object} options
    447          * @returns {Number} -1 if the first model should come before the second,
    448          *    0 if they are of the same rank and
    449          *    1 if the first model should come after.
     447         * @return {Number} -1 if the first model should come before the second,
     448         *                   0 if they are of the same rank and
     449         *                   1 if the first model should come after.
    450450         */
    451451        comparator: function( a, b, options ) {
    … …  
    481481                 * @this wp.media.model.Attachments
    482482                 *
    483                  * @returns {Boolean}
     483                 * @return {Boolean}
    484484                 */
    485485                search: function( attachment ) {
    … …  
    499499                 * @this wp.media.model.Attachments
    500500                 *
    501                  * @returns {Boolean}
     501                 * @return {Boolean}
    502502                 */
    503503                type: function( attachment ) {
    … …  
    526526                 * @this wp.media.model.Attachments
    527527                 *
    528                  * @returns {Boolean}
     528                 * @return {Boolean}
    529529                 */
    530530                uploadedTo: function( attachment ) {
    … …  
    542542                 * @this wp.media.model.Attachments
    543543                 *
    544                  * @returns {Boolean}
     544                 * @return {Boolean}
    545545                 */
    546546                status: function( attachment ) {

  • trunk/src/js/media/models/query.js

    r43309 r46800  
    8181         * that match the collection's query.
    8282         *
    83          * @returns {boolean}
     83         * @return {boolean}
    8484         */
    8585        hasMore: function() {
    … …  
    9090         *
    9191         * @param   {object}  [options={}]
    92          * @returns {Promise}
     92         * @return {Promise}
    9393         */
    9494        more: function( options ) {
    … …  
    120120         * @param {Backbone.Model} model
    121121         * @param {Object} [options={}]
    122          * @returns {Promise}
     122         * @return {Promise}
    123123         */
    124124        sync: function( method, model, options ) {
    … …  
    222222         * @param {Object} [options]
    223223         *
    224          * @returns {wp.media.model.Query} A new Attachments Query collection.
     224         * @return {wp.media.model.Query} A new Attachments Query collection.
    225225         */
    226226        get: (function(){
    … …  
    232232
    233233                /**
    234                  * @returns {Query}
     234                 * @return {Query}
    235235                 */
    236236                return function( props, options ) {

  • trunk/src/js/media/models/selection.js

    r43309 r46800  
    3838         * @param {Array} models
    3939         * @param {Object} options
    40          * @returns {wp.media.model.Attachment[]}
     40         * @return {wp.media.model.Attachment[]}
    4141         */
    4242        add: function( models, options ) {
    … …  
    5858         * @fires wp.media.model.Selection#selection:unsingle
    5959         *
    60          * @returns {Backbone.Model}
     60         * @return {Backbone.Model}
    6161         */
    6262        single: function( model ) {

  • trunk/src/js/media/views/attachment-compat.js

    r46799 r46800  
    2929        },
    3030        /**
    31          * @returns {wp.media.view.AttachmentCompat} Returns itself to allow chaining.
     31         * @return {wp.media.view.AttachmentCompat} Returns itself to allow chaining.
    3232         */
    3333        dispose: function() {
    … …  
    4141        },
    4242        /**
    43          * @returns {wp.media.view.AttachmentCompat} Returns itself to allow chaining.
     43         * @return {wp.media.view.AttachmentCompat} Returns itself to allow chaining.
    4444         */
    4545        render: function() {

  • trunk/src/js/media/views/attachment.js

    r46799 r46800  
    7070        },
    7171        /**
    72          * @returns {wp.media.view.Attachment} Returns itself to allow chaining.
     72         * @return {wp.media.view.Attachment} Returns itself to allow chaining.
    7373         */
    7474        dispose: function() {
    … …  
    8888        },
    8989        /**
    90          * @returns {wp.media.view.Attachment} Returns itself to allow chaining.
     90         * @return {wp.media.view.Attachment} Returns itself to allow chaining.
    9191         */
    9292        render: function() {
    … …  
    283283        },
    284284        /**
    285          * @returns {unresolved|Boolean}
     285         * @return {unresolved|Boolean}
    286286         */
    287287        selected: function() {
    … …  
    351351        /**
    352352         * @param {string} size
    353          * @returns {Object}
     353         * @return {Object}
    354354         */
    355355        imageSize: function( size ) {
    … …  
    435435        /**
    436436         * @param {string} status
    437          * @returns {wp.media.view.Attachment} Returns itself to allow chaining.
     437         * @return {wp.media.view.Attachment} Returns itself to allow chaining.
    438438         */
    439439        updateSave: function( status ) {
    … …  
    530530         * @param {Backbone.Model} model
    531531         * @param {string} value
    532          * @returns {wp.media.view.Attachment} Returns itself to allow chaining.
     532         * @return {wp.media.view.Attachment} Returns itself to allow chaining.
    533533         */
    534534        /**
    … …  
    539539         * @param {Backbone.Model} model
    540540         * @param {string} value
    541          * @returns {wp.media.view.Attachment} Returns itself to allow chaining.
     541         * @return {wp.media.view.Attachment} Returns itself to allow chaining.
    542542         */
    543543        /**
    … …  
    548548         * @param {Backbone.Model} model
    549549         * @param {string} value
    550          * @returns {wp.media.view.Attachment} Returns itself to allow chaining.
     550         * @return {wp.media.view.Attachment} Returns itself to allow chaining.
    551551         */
    552552        /**
    … …  
    557557         * @param {Backbone.Model} model
    558558         * @param {string} value
    559          * @returns {wp.media.view.Attachment} Returns itself to allow chaining.
     559         * @return {wp.media.view.Attachment} Returns itself to allow chaining.
    560560         */
    561561        Attachment.prototype[ method ] = function( model, value ) {

  • trunk/src/js/media/views/attachment/details.js

    r45561 r46800  
    3535         * @augments wp.media.view.Attachment
    3636         *
    37          * @returns {void}
     37         * @return {void}
    3838         */
    3939        initialize: function() {
    … …  
    107107         * @param {MouseEvent} event A click event.
    108108         *
    109          * @returns {void}
     109         * @return {void}
    110110         */
    111111        deleteAttachment: function( event ) {
    … …  
    130130         * @param {MouseEvent} event A click event.
    131131         *
    132          * @returns {void}
     132         * @return {void}
    133133         */
    134134        trashAttachment: function( event ) {
    … …  
    166166         * @param {MouseEvent} event A click event.
    167167         *
    168          * @returns {void}
     168         * @return {void}
    169169         */
    170170        untrashAttachment: function( event ) {
    … …  
    185185         * @param {MouseEvent} event A click event.
    186186         *
    187          * @returns {void}
     187         * @return {void}
    188188         */
    189189        editAttachment: function( event ) {
    … …  
    211211         * @param {KeyboardEvent} event A keyboard event.
    212212         *
    213          * @returns {boolean|void} Returns false or undefined.
     213         * @return {boolean|void} Returns false or undefined.
    214214         */
    215215        toggleSelectionHandler: function( event ) {

  • trunk/src/js/media/views/attachments.js

    r45524 r46800  
    117117         * @listens window:resize
    118118         *
    119          * @returns {void}
     119         * @return {void}
    120120         */
    121121        bindEvents: function() {
    … …  
    128128         * @since 4.0.0
    129129         *
    130          * @returns {void}
     130         * @return {void}
    131131         */
    132132        attachmentFocus: function() {
    … …  
    155155         * @since 4.0.0
    156156         *
    157          * @returns {void}
     157         * @return {void}
    158158         */
    159159        restoreFocus: function() {
    … …  
    170170         * @param {KeyboardEvent} event The keyboard event that triggered this function.
    171171         *
    172          * @returns {void}
     172         * @return {void}
    173173         */
    174174        arrowEvent: function( event ) {
    … …  
    220220         * @since 3.5.0
    221221         *
    222          * @returns {void}
     222         * @return {void}
    223223         */
    224224        dispose: function() {
    … …  
    240240         * @since 4.0.0
    241241         *
    242          * @returns {void}
     242         * @return {void}
    243243         */
    244244        setColumns: function() {
    … …  
    265265         * @fires collection:reset
    266266         *
    267          * @returns {void}
     267         * @return {void}
    268268         */
    269269        initSortable: function() {
    … …  
    339339         * @since 3.5.0
    340340         *
    341          * @returns {void}
     341         * @return {void}
    342342         */
    343343        refreshSortable: function() {
    … …  
    360360         * @param {wp.media.model.Attachment} attachment
    361361         *
    362          * @returns {wp.media.View} The created view.
     362         * @return {wp.media.View} The created view.
    363363         */
    364364        createAttachmentView: function( attachment ) {
    … …  
    381381         * @since 3.5.0
    382382         *
    383          * @returns {void}
     383         * @return {void}
    384384         */
    385385        prepare: function() {
    … …  
    398398         * @since 3.5.0
    399399         *
    400          * @returns {void}
     400         * @return {void}
    401401         */
    402402        ready: function() {
    … …  
    412412         * @since 3.5.0
    413413         *
    414          * @returns {void}
     414         * @return {void}
    415415         */
    416416        scroll: function() {

  • trunk/src/js/media/views/attachments/browser.js

    r46799 r46800  
    9696         * @since 5.3.0
    9797         *
    98          * @returns {void}
     98         * @return {void}
    9999         */
    100100        announceSearchResults: _.debounce( function() {
    … …  
    124124
    125125        /**
    126          * @returns {wp.media.view.AttachmentsBrowser} Returns itself to allow chaining.
     126         * @return {wp.media.view.AttachmentsBrowser} Returns itself to allow chaining.
    127127         */
    128128        dispose: function() {

  • trunk/src/js/media/views/button-group.js

    r43309 r46800  
    3636
    3737        /**
    38          * @returns {wp.media.view.ButtonGroup}
     38         * @return {wp.media.view.ButtonGroup}
    3939         */
    4040        render: function() {

  • trunk/src/js/media/views/button.js

    r46799 r46800  
    4848        },
    4949        /**
    50          * @returns {wp.media.view.Button} Returns itself to allow chaining.
     50         * @return {wp.media.view.Button} Returns itself to allow chaining.
    5151         */
    5252        render: function() {

  • trunk/src/js/media/views/embed/url.js

    r46799 r46800  
    4040        },
    4141        /**
    42          * @returns {wp.media.view.EmbedUrl} Returns itself to allow chaining.
     42         * @return {wp.media.view.EmbedUrl} Returns itself to allow chaining.
    4343         */
    4444        render: function() {

  • trunk/src/js/media/views/focus-manager.js

    r46363 r46800  
    3838         * @param {object} event jQuery event object.
    3939         *
    40          * @returns {void}
     40         * @return {void}
    4141         */
    4242        focusManagementMode: function( event ) {
    … …  
    5555         * @since 5.3.0
    5656         *
    57          * @returns {object} A jQuery collection of tabbable elements.
     57         * @return {object} A jQuery collection of tabbable elements.
    5858         */
    5959        getTabbables: function() {
    … …  
    6767         * @since 3.5.0
    6868         *
    69          * @returns {void}
     69         * @return {void}
    7070         */
    7171        focus: function() {
    … …  
    8080         * @param {Object} event A keydown jQuery event.
    8181         *
    82          * @returns {void}
     82         * @return {void}
    8383         */
    8484        constrainTabbing: function( event ) {
    … …  
    117117         * @param {object} visibleElement The jQuery object representing the element that should not be hidden.
    118118         *
    119          * @returns {void}
     119         * @return {void}
    120120         */
    121121        setAriaHiddenOnBodyChildren: function( visibleElement ) {
    … …  
    156156         * @since 5.2.3
    157157         *
    158          * @returns {void}
     158         * @return {void}
    159159         */
    160160        removeAriaHiddenFromBodyChildren: function() {
    … …  
    174174         * @param {object} element The DOM element that should be checked.
    175175         *
    176          * @returns {boolean} Whether the element should not be hidden from assistive technologies.
     176         * @return {boolean} Whether the element should not be hidden from assistive technologies.
    177177         */
    178178        elementShouldBeHidden: function( element ) {
    … …  
    221221         * @param {object} event jQuery event object.
    222222         *
    223          * @returns {void}
     223         * @return {void}
    224224         */
    225225        setupAriaTabs: function() {
    … …  
    245245         * @param {object} event jQuery event object.
    246246         *
    247          * @returns {void}
     247         * @return {void}
    248248         */
    249249        tabsNavigation: function( event ) {
    … …  
    281281         * @param {object} event jQuery event object.
    282282         *
    283          * @returns {void}
     283         * @return {void}
    284284         */
    285285        switchTabs: function( event ) {
    … …  
    332332         * @param {object} tab The tab DOM element.
    333333         *
    334          * @returns {void}
     334         * @return {void}
    335335         */
    336336        activateTab: function( tab ) {

  • trunk/src/js/media/views/frame.js

    r46799 r46800  
    8181         * Reset all states on the frame to their defaults.
    8282         *
    83          * @returns {wp.media.view.Frame} Returns itself to allow chaining.
     83         * @return {wp.media.view.Frame} Returns itself to allow chaining.
    8484         */
    8585        reset: function() {
    … …  
    115115         *
    116116         * @param string mode Mode ID.
    117          * @returns {this} Returns itself to allow chaining.
     117         * @return {this} Returns itself to allow chaining.
    118118         */
    119119        activateMode: function( mode ) {
    … …  
    132132         *
    133133         * @param string mode Mode ID.
    134          * @returns {this} Returns itself to allow chaining.
     134         * @return {this} Returns itself to allow chaining.
    135135         */
    136136        deactivateMode: function( mode ) {

  • trunk/src/js/media/views/iframe.js

    r46799 r46800  
    1212        className: 'media-iframe',
    1313        /**
    14          * @returns {wp.media.view.Iframe} Returns itself to allow chaining.
     14         * @return {wp.media.view.Iframe} Returns itself to allow chaining.
    1515         */
    1616        render: function() {

  • trunk/src/js/media/views/media-details.js

    r46799 r46800  
    124124
    125125        /**
    126          * @returns {media.view.MediaDetails} Returns itself to allow chaining.
     126         * @return {media.view.MediaDetails} Returns itself to allow chaining.
    127127         */
    128128        render: function() {
    … …  
    149149         *
    150150         * @param {HTMLElement} elem
    151          * @returns {HTMLElement}
     151         * @return {HTMLElement}
    152152         */
    153153        prepareSrc : function( elem ) {

  • trunk/src/js/media/views/media-frame.js

    r46799 r46800  
    9595         * @since 5.3.0
    9696         *
    97          * @returns {void}
     97         * @return {void}
    9898         */
    9999        setMenuTabPanelAriaAttributes: function() {
    … …  
    122122         * @since 5.3.0
    123123         *
    124          * @returns {void}
     124         * @return {void}
    125125         */
    126126        setRouterTabPanelAriaAttributes: function() {
    … …  
    144144
    145145        /**
    146          * @returns {wp.media.view.MediaFrame} Returns itself to allow chaining.
     146         * @return {wp.media.view.MediaFrame} Returns itself to allow chaining.
    147147         */
    148148        render: function() {
    … …  
    317317         * @instance
    318318         *
    319          * @returns {wp.media.view.MediaFrame} Returns itself to allow chaining.
     319         * @return {wp.media.view.MediaFrame} Returns itself to allow chaining.
    320320         */
    321321        /**
    … …  
    324324         * @instance
    325325         *
    326          * @returns {wp.media.view.MediaFrame} Returns itself to allow chaining.
     326         * @return {wp.media.view.MediaFrame} Returns itself to allow chaining.
    327327         */
    328328        /**
    … …  
    331331         * @instance
    332332         *
    333          * @returns {wp.media.view.MediaFrame} Returns itself to allow chaining.
     333         * @return {wp.media.view.MediaFrame} Returns itself to allow chaining.
    334334         */
    335335        /**
    … …  
    338338         * @instance
    339339         *
    340          * @returns {wp.media.view.MediaFrame} Returns itself to allow chaining.
     340         * @return {wp.media.view.MediaFrame} Returns itself to allow chaining.
    341341         */
    342342        /**
    … …  
    345345         * @instance
    346346         *
    347          * @returns {wp.media.view.MediaFrame} Returns itself to allow chaining.
     347         * @return {wp.media.view.MediaFrame} Returns itself to allow chaining.
    348348         */
    349349        MediaFrame.prototype[ method ] = function() {

  • trunk/src/js/media/views/menu-item.js

    r46799 r46800  
    4848
    4949        /**
    50          * @returns {wp.media.view.MenuItem} returns itself to allow chaining.
     50         * @return {wp.media.view.MenuItem} returns itself to allow chaining.
    5151         */
    5252        render: function() {

  • trunk/src/js/media/views/menu.js

    r46363 r46800  
    4949         * @param {Object} options
    5050         * @param {string} id
    51          * @returns {wp.media.View}
     51         * @return {wp.media.View}
    5252         */
    5353        toView: function( options, id ) {

  • trunk/src/js/media/views/modal.js

    r46799 r46800  
    3838        },
    3939        /**
    40          * @returns {Object}
     40         * @return {Object}
    4141         */
    4242        prepare: function() {
    … …  
    4848
    4949        /**
    50          * @returns {wp.media.view.Modal} Returns itself to allow chaining.
     50         * @return {wp.media.view.Modal} Returns itself to allow chaining.
    5151         */
    5252        attach: function() {
    … …  
    6969
    7070        /**
    71          * @returns {wp.media.view.Modal} Returns itself to allow chaining.
     71         * @return {wp.media.view.Modal} Returns itself to allow chaining.
    7272         */
    7373        detach: function() {
    … …  
    8282
    8383        /**
    84          * @returns {wp.media.view.Modal} Returns itself to allow chaining.
     84         * @return {wp.media.view.Modal} Returns itself to allow chaining.
    8585         */
    8686        open: function() {
    … …  
    126126        /**
    127127         * @param {Object} options
    128          * @returns {wp.media.view.Modal} Returns itself to allow chaining.
     128         * @return {wp.media.view.Modal} Returns itself to allow chaining.
    129129         */
    130130        close: function( options ) {
    … …  
    165165        },
    166166        /**
    167          * @returns {wp.media.view.Modal} Returns itself to allow chaining.
     167         * @return {wp.media.view.Modal} Returns itself to allow chaining.
    168168         */
    169169        escape: function() {
    … …  
    180180        /**
    181181         * @param {Array|Object} content Views to register to '.media-modal-content'
    182          * @returns {wp.media.view.Modal} Returns itself to allow chaining.
     182         * @return {wp.media.view.Modal} Returns itself to allow chaining.
    183183         */
    184184        content: function( content ) {
    … …  
    192192         *
    193193         * @param {string} id
    194          * @returns {wp.media.view.Modal} Returns itself to allow chaining.
     194         * @return {wp.media.view.Modal} Returns itself to allow chaining.
    195195         */
    196196        propagate: function( id ) {

  • trunk/src/js/media/views/priority-list.js

    r46799 r46800  
    2626         * @param {wp.media.View|Object} view
    2727         * @param {Object} options
    28          * @returns {wp.media.view.PriorityList} Returns itself to allow chaining.
     28         * @return {wp.media.view.PriorityList} Returns itself to allow chaining.
    2929         */
    3030        set: function( id, view, options ) {
    … …  
    6767        /**
    6868         * @param {string} id
    69          * @returns {wp.media.View}
     69         * @return {wp.media.View}
    7070         */
    7171        get: function( id ) {
    … …  
    7474        /**
    7575         * @param {string} id
    76          * @returns {wp.media.view.PriorityList}
     76         * @return {wp.media.view.PriorityList}
    7777         */
    7878        unset: function( id ) {
    … …  
    8888        /**
    8989         * @param {Object} options
    90          * @returns {wp.media.View}
     90         * @return {wp.media.View}
    9191         */
    9292        toView: function( options ) {

  • trunk/src/js/media/views/search.js

    r46799 r46800  
    2525
    2626        /**
    27          * @returns {wp.media.view.Search} Returns itself to allow chaining.
     27         * @return {wp.media.view.Search} Returns itself to allow chaining.
    2828         */
    2929        render: function() {

  • trunk/src/js/media/views/settings.js

    r46799 r46800  
    3232        },
    3333        /**
    34          * @returns {wp.media.view.Settings} Returns itself to allow chaining.
     34         * @return {wp.media.view.Settings} Returns itself to allow chaining.
    3535         */
    3636        render: function() {

  • trunk/src/js/media/views/settings/attachment-display.js

    r46799 r46800  
    4343        },
    4444        /**
    45          * @returns {wp.media.view.AttachmentDisplay} Returns itself to allow chaining.
     45         * @return {wp.media.view.AttachmentDisplay} Returns itself to allow chaining.
    4646         */
    4747        render: function() {

  • trunk/src/js/media/views/toolbar.js

    r46799 r46800  
    5151        },
    5252        /**
    53          * @returns {wp.media.view.Toolbar} Returns itsef to allow chaining
     53         * @return {wp.media.view.Toolbar} Returns itsef to allow chaining
    5454         */
    5555        dispose: function() {
    … …  
    7575         * @param {Backbone.View|Object} view
    7676         * @param {Object} [options={}]
    77          * @returns {wp.media.view.Toolbar} Returns itself to allow chaining.
     77         * @return {wp.media.view.Toolbar} Returns itself to allow chaining.
    7878         */
    7979        set: function( id, view, options ) {
    … …  
    109109        /**
    110110         * @param {string} id
    111          * @returns {wp.media.view.Button}
     111         * @return {wp.media.view.Button}
    112112         */
    113113        get: function( id ) {
    … …  
    117117         * @param {string} id
    118118         * @param {Object} options
    119          * @returns {wp.media.view.Toolbar} Returns itself to allow chaining.
     119         * @return {wp.media.view.Toolbar} Returns itself to allow chaining.
    120120         */
    121121        unset: function( id, options ) {

  • trunk/src/js/media/views/uploader/editor.js

    r43309 r46800  
    6565         * Check browser support for drag'n'drop.
    6666         *
    67          * @return Boolean
     67         * @return {Boolean}
    6868         */
    6969        browserSupport: function() {

  • trunk/src/js/media/views/uploader/inline.js

    r46799 r46800  
    6161        },
    6262        /**
    63          * @returns {wp.media.view.UploaderInline} Returns itself to allow chaining.
     63         * @return {wp.media.view.UploaderInline} Returns itself to allow chaining.
    6464         */
    6565        dispose: function() {
    … …  
    7878        },
    7979        /**
    80          * @returns {wp.media.view.UploaderInline} Returns itself to allow chaining.
     80         * @return {wp.media.view.UploaderInline} Returns itself to allow chaining.
    8181         */
    8282        remove: function() {
    … …  
    9898        },
    9999        /**
    100          * @returns {wp.media.view.UploaderInline}
     100         * @return {wp.media.view.UploaderInline}
    101101         */
    102102        ready: function() {

  • trunk/src/js/media/views/uploader/status.js

    r46321 r46800  
    3434        },
    3535        /**
    36          * @returns {wp.media.view.UploaderStatus}
     36         * @return {wp.media.view.UploaderStatus}
    3737         */
    3838        dispose: function() {
    … …  
    103103        /**
    104104         * @param {string} filename
    105          * @returns {string}
     105         * @return {string}
    106106         */
    107107        filename: function( filename ) {

  • trunk/src/js/media/views/view.js

    r46799 r46800  
    2929         *       care of this in Backbone.View now.
    3030         *
    31          * @returns {wp.media.View} Returns itself to allow chaining.
     31         * @return {wp.media.View} Returns itself to allow chaining.
    3232         */
    3333        dispose: function() {
    … …  
    5353        },
    5454        /**
    55          * @returns {wp.media.View} Returns itself to allow chaining.
     55         * @return {wp.media.View} Returns itself to allow chaining.
    5656         */
    5757        remove: function() {
Note: See TracChangeset for help on using the changeset viewer.