<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type" content="text/html; charset=utf-8" />
<title>[39345] trunk/src: Customize: Clean up docs and code style for customize changes in 4.7.</title>
</head>
<body>

<style type="text/css"><!--
#msg dl.meta { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dl.meta dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer, #logmsg { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt;  }
#msg dl a { font-weight: bold}
#msg dl a:link    { color:#fc3; }
#msg dl a:active  { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre { overflow: auto; background: #ffc; border: 1px #fa0 solid; padding: 6px; }
#logmsg { background: #ffc; border: 1px #fa0 solid; padding: 1em 1em 0 1em; }
#logmsg p, #logmsg pre, #logmsg blockquote { margin: 0 0 1em 0; }
#logmsg p, #logmsg li, #logmsg dt, #logmsg dd { line-height: 14pt; }
#logmsg h1, #logmsg h2, #logmsg h3, #logmsg h4, #logmsg h5, #logmsg h6 { margin: .5em 0; }
#logmsg h1:first-child, #logmsg h2:first-child, #logmsg h3:first-child, #logmsg h4:first-child, #logmsg h5:first-child, #logmsg h6:first-child { margin-top: 0; }
#logmsg ul, #logmsg ol { padding: 0; list-style-position: inside; margin: 0 0 0 1em; }
#logmsg ul { text-indent: -1em; padding-left: 1em; }#logmsg ol { text-indent: -1.5em; padding-left: 1.5em; }
#logmsg > ul, #logmsg > ol { margin: 0 0 1em 0; }
#logmsg pre { background: #eee; padding: 1em; }
#logmsg blockquote { border: 1px solid #fa0; border-left-width: 10px; padding: 1em 1em 0 1em; background: white;}
#logmsg dl { margin: 0; }
#logmsg dt { font-weight: bold; }
#logmsg dd { margin: 0; padding: 0 0 0.5em 0; }
#logmsg dd:before { content:'\00bb';}
#logmsg table { border-spacing: 0px; border-collapse: collapse; border-top: 4px solid #fa0; border-bottom: 1px solid #fa0; background: #fff; }
#logmsg table th { text-align: left; font-weight: normal; padding: 0.2em 0.5em; border-top: 1px dotted #fa0; }
#logmsg table td { text-align: right; border-top: 1px dotted #fa0; padding: 0.2em 0.5em; }
#logmsg table thead th { text-align: center; border-bottom: 1px solid #fa0; }
#logmsg table th.Corner { text-align: left; }
#logmsg hr { border: none 0; border-top: 2px dashed #fa0; height: 1px; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff  {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<div id="msg">
<dl class="meta" style="font-size: 105%">
<dt style="float: left; width: 6em; font-weight: bold">Revision</dt> <dd><a style="font-weight: bold" href="https://core.trac.wordpress.org/changeset/39345">39345</a><script type="application/ld+json">{"@context":"http://schema.org","@type":"EmailMessage","description":"Review this Commit","action":{"@type":"ViewAction","url":"https://core.trac.wordpress.org/changeset/39345","name":"Review Commit"}}</script></dd>
<dt style="float: left; width: 6em; font-weight: bold">Author</dt> <dd>westonruter</dd>
<dt style="float: left; width: 6em; font-weight: bold">Date</dt> <dd>2016-11-23 06:04:23 +0000 (Wed, 23 Nov 2016)</dd>
</dl>

<pre style='padding-left: 1em; margin: 2em 0; border-left: 2px solid #ccc; line-height: 1.25; font-size: 105%; font-family: sans-serif'>Customize: Clean up docs and code style for customize changes in 4.7.

* Adds missing `resolve`/`fail` for promise returned by `loadThemePreview`.
* Adds missing jsdoc blocks and tags.
* Adds missing phpdoc and makes corrections.

See <a href="https://core.trac.wordpress.org/ticket/37770">#37770</a>.
Fixes <a href="https://core.trac.wordpress.org/ticket/38908">#38908</a>.</pre>

<h3>Modified Paths</h3>
<ul>
<li><a href="#trunksrcwpadminjscustomizecontrolsjs">trunk/src/wp-admin/js/customize-controls.js</a></li>
<li><a href="#trunksrcwpadminjscustomizenavmenusjs">trunk/src/wp-admin/js/customize-nav-menus.js</a></li>
<li><a href="#trunksrcwpincludesclasswpcustomizecontrolphp">trunk/src/wp-includes/class-wp-customize-control.php</a></li>
<li><a href="#trunksrcwpincludesclasswpcustomizemanagerphp">trunk/src/wp-includes/class-wp-customize-manager.php</a></li>
<li><a href="#trunksrcwpincludescustomizeclasswpcustomizecolorcontrolphp">trunk/src/wp-includes/customize/class-wp-customize-color-control.php</a></li>
<li><a href="#trunksrcwpincludescustomizeclasswpcustomizecustomcsssettingphp">trunk/src/wp-includes/customize/class-wp-customize-custom-css-setting.php</a></li>
<li><a href="#trunksrcwpincludescustomizeclasswpcustomizenavmenuitemsettingphp">trunk/src/wp-includes/customize/class-wp-customize-nav-menu-item-setting.php</a></li>
<li><a href="#trunksrcwpincludesjscustomizepreviewjs">trunk/src/wp-includes/js/customize-preview.js</a></li>
<li><a href="#trunksrcwpincludesjscustomizeselectiverefreshjs">trunk/src/wp-includes/js/customize-selective-refresh.js</a></li>
</ul>

</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunksrcwpadminjscustomizecontrolsjs"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-admin/js/customize-controls.js</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-admin/js/customize-controls.js       2016-11-23 02:54:24 UTC (rev 39344)
+++ trunk/src/wp-admin/js/customize-controls.js 2016-11-23 06:04:23 UTC (rev 39345)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -45,6 +45,9 @@
</span><span class="cx" style="display: block; padding: 0 10px">                 * previewer.send() call to then fallback to refresh will not work.
</span><span class="cx" style="display: block; padding: 0 10px">                 *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @since 3.4.0
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                 * @access public
+                *
+                * @returns {void}
</ins><span class="cx" style="display: block; padding: 0 10px">                  */
</span><span class="cx" style="display: block; padding: 0 10px">                preview: function() {
</span><span class="cx" style="display: block; padding: 0 10px">                        var setting = this, transport;
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -55,9 +58,9 @@
</span><span class="cx" style="display: block; padding: 0 10px">                        }
</span><span class="cx" style="display: block; padding: 0 10px"> 
</span><span class="cx" style="display: block; padding: 0 10px">                        if ( 'postMessage' === transport ) {
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                                return setting.previewer.send( 'setting', [ setting.id, setting() ] );
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                         setting.previewer.send( 'setting', [ setting.id, setting() ] );
</ins><span class="cx" style="display: block; padding: 0 10px">                         } else if ( 'refresh' === transport ) {
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                                return setting.previewer.refresh();
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                         setting.previewer.refresh();
</ins><span class="cx" style="display: block; padding: 0 10px">                         }
</span><span class="cx" style="display: block; padding: 0 10px">                },
</span><span class="cx" style="display: block; padding: 0 10px"> 
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -130,6 +133,9 @@
</span><span class="cx" style="display: block; padding: 0 10px">        /**
</span><span class="cx" style="display: block; padding: 0 10px">         * Get the dirty setting values.
</span><span class="cx" style="display: block; padding: 0 10px">         *
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         * @since 4.7.0
+        * @access public
+        *
</ins><span class="cx" style="display: block; padding: 0 10px">          * @param {object} [options] Options.
</span><span class="cx" style="display: block; padding: 0 10px">         * @param {boolean} [options.unsaved=false] Whether only values not saved yet into a changeset will be returned (differential changes).
</span><span class="cx" style="display: block; padding: 0 10px">         * @returns {object} Dirty setting values.
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -158,9 +164,12 @@
</span><span class="cx" style="display: block; padding: 0 10px">        /**
</span><span class="cx" style="display: block; padding: 0 10px">         * Request updates to the changeset.
</span><span class="cx" style="display: block; padding: 0 10px">         *
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         * @since 4.7.0
+        * @access public
+        *
</ins><span class="cx" style="display: block; padding: 0 10px">          * @param {object} [changes] Mapping of setting IDs to setting params each normally including a value property, or mapping to null.
</span><span class="cx" style="display: block; padding: 0 10px">         *                           If not provided, then the changes will still be obtained from unsaved dirty settings.
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         * @returns {jQuery.Promise}
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+  * @returns {jQuery.Promise} Promise resolving with the response data.
</ins><span class="cx" style="display: block; padding: 0 10px">          */
</span><span class="cx" style="display: block; padding: 0 10px">        api.requestChangesetUpdate = function requestChangesetUpdate( changes ) {
</span><span class="cx" style="display: block; padding: 0 10px">                var deferred, request, submittedChanges = {}, data;
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -684,10 +693,10 @@
</span><span class="cx" style="display: block; padding: 0 10px">                 * Animate container state change if transitions are supported by the browser.
</span><span class="cx" style="display: block; padding: 0 10px">                 *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @since 4.7.0
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                 * @private
</ins><span class="cx" style="display: block; padding: 0 10px">                  *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @param {function} completeCallback Function to be called after transition is completed.
</span><span class="cx" style="display: block; padding: 0 10px">                 * @returns {void}
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                 * @private
</del><span class="cx" style="display: block; padding: 0 10px">                  */
</span><span class="cx" style="display: block; padding: 0 10px">                _animateChangeExpanded: function( completeCallback ) {
</span><span class="cx" style="display: block; padding: 0 10px">                        // Return if CSS transitions are not supported.
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -778,6 +787,7 @@
</span><span class="cx" style="display: block; padding: 0 10px">                 * method to handle animating the panel/section into and out of view.
</span><span class="cx" style="display: block; padding: 0 10px">                 *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @since 4.7.0
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                 * @access public
</ins><span class="cx" style="display: block; padding: 0 10px">                  *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @returns {jQuery} Detached content element.
</span><span class="cx" style="display: block; padding: 0 10px">                 */
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -935,7 +945,7 @@
</span><span class="cx" style="display: block; padding: 0 10px">                                content.toggleClass( 'open' );
</span><span class="cx" style="display: block; padding: 0 10px">                                content.slideToggle();
</span><span class="cx" style="display: block; padding: 0 10px">                                content.attr( 'aria-expanded', function ( i, attr ) {
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                                        return attr === 'true' ? 'false' : 'true';
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                                 return 'true' === attr ? 'false' : 'true';
</ins><span class="cx" style="display: block; padding: 0 10px">                                 });
</span><span class="cx" style="display: block; padding: 0 10px">                        });
</span><span class="cx" style="display: block; padding: 0 10px">                },
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1419,6 +1429,7 @@
</span><span class="cx" style="display: block; padding: 0 10px">                 * Load theme preview.
</span><span class="cx" style="display: block; padding: 0 10px">                 *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @since 4.7.0
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                 * @access public
</ins><span class="cx" style="display: block; padding: 0 10px">                  *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @param {string} themeId Theme ID.
</span><span class="cx" style="display: block; padding: 0 10px">                 * @returns {jQuery.promise} Promise.
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1451,9 +1462,11 @@
</span><span class="cx" style="display: block; padding: 0 10px">                                request.done( function() {
</span><span class="cx" style="display: block; padding: 0 10px">                                        $( window ).off( 'beforeunload.customize-confirm' );
</span><span class="cx" style="display: block; padding: 0 10px">                                        top.location.href = urlParser.href;
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                                        deferred.resolve();
</ins><span class="cx" style="display: block; padding: 0 10px">                                 } );
</span><span class="cx" style="display: block; padding: 0 10px">                                request.fail( function() {
</span><span class="cx" style="display: block; padding: 0 10px">                                        overlay.removeClass( 'customize-loading' );
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                                        deferred.reject();
</ins><span class="cx" style="display: block; padding: 0 10px">                                 } );
</span><span class="cx" style="display: block; padding: 0 10px">                        };
</span><span class="cx" style="display: block; padding: 0 10px"> 
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -2273,8 +2286,8 @@
</span><span class="cx" style="display: block; padding: 0 10px">                                // Reset the create page form.
</span><span class="cx" style="display: block; padding: 0 10px">                                container.slideUp( 180 );
</span><span class="cx" style="display: block; padding: 0 10px">                                toggle.slideDown( 180 );
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                        } )
-                       .always( function() {
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                 } );
+                       promise.always( function() {
</ins><span class="cx" style="display: block; padding: 0 10px">                                 input.val( '' ).removeAttr( 'disabled' );
</span><span class="cx" style="display: block; padding: 0 10px">                        } );
</span><span class="cx" style="display: block; padding: 0 10px">                }
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -2320,7 +2333,7 @@
</span><span class="cx" style="display: block; padding: 0 10px">                        }
</span><span class="cx" style="display: block; padding: 0 10px"> 
</span><span class="cx" style="display: block; padding: 0 10px">                        control.setting.bind( function ( value ) {
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                                // bail if the update came from the control itself
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                         // Bail if the update came from the control itself.
</ins><span class="cx" style="display: block; padding: 0 10px">                                 if ( updating ) {
</span><span class="cx" style="display: block; padding: 0 10px">                                        return;
</span><span class="cx" style="display: block; padding: 0 10px">                                }
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -2641,6 +2654,7 @@
</span><span class="cx" style="display: block; padding: 0 10px">                 * Set up control UI once embedded in DOM and settings are created.
</span><span class="cx" style="display: block; padding: 0 10px">                 *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @since 4.7.0
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                 * @access public
</ins><span class="cx" style="display: block; padding: 0 10px">                  */
</span><span class="cx" style="display: block; padding: 0 10px">                ready: function() {
</span><span class="cx" style="display: block; padding: 0 10px">                        var control = this, updateRadios;
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -3713,8 +3727,7 @@
</span><span class="cx" style="display: block; padding: 0 10px">                                        parsedCandidateUrls.unshift( urlParser );
</span><span class="cx" style="display: block; padding: 0 10px">                                }
</span><span class="cx" style="display: block; padding: 0 10px"> 
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                                // Attempt to match the URL to the control frame's scheme
-                               // and check if it's allowed. If not, try the original URL.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                         // Attempt to match the URL to the control frame's scheme and check if it's allowed. If not, try the original URL.
</ins><span class="cx" style="display: block; padding: 0 10px">                                 parsedAllowedUrl = document.createElement( 'a' );
</span><span class="cx" style="display: block; padding: 0 10px">                                _.find( parsedCandidateUrls, function( parsedCandidateUrl ) {
</span><span class="cx" style="display: block; padding: 0 10px">                                        return ! _.isUndefined( _.find( previewer.allowedUrls, function( allowedUrl ) {
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -3771,6 +3784,7 @@
</span><span class="cx" style="display: block; padding: 0 10px">                 * Handle the preview receiving the ready message.
</span><span class="cx" style="display: block; padding: 0 10px">                 *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @since 4.7.0
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                 * @access public
</ins><span class="cx" style="display: block; padding: 0 10px">                  *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @param {object} data - Data from preview.
</span><span class="cx" style="display: block; padding: 0 10px">                 * @param {string} data.currentUrl - Current URL.
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -3845,6 +3859,7 @@
</span><span class="cx" style="display: block; padding: 0 10px">                 * If a message is not received in the allotted time then the iframe will be set back to the last known valid URL.
</span><span class="cx" style="display: block; padding: 0 10px">                 *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @since 4.7.0
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                 * @access public
</ins><span class="cx" style="display: block; padding: 0 10px">                  *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @returns {void}
</span><span class="cx" style="display: block; padding: 0 10px">                 */
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -3904,6 +3919,10 @@
</span><span class="cx" style="display: block; padding: 0 10px"> 
</span><span class="cx" style="display: block; padding: 0 10px">                /**
</span><span class="cx" style="display: block; padding: 0 10px">                 * Refresh the preview seamlessly.
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                 *
+                * @since 3.4.0
+                * @access public
+                * @returns {void}
</ins><span class="cx" style="display: block; padding: 0 10px">                  */
</span><span class="cx" style="display: block; padding: 0 10px">                refresh: function() {
</span><span class="cx" style="display: block; padding: 0 10px">                        var previewer = this, onSettingChange;
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -4299,7 +4318,9 @@
</span><span class="cx" style="display: block; padding: 0 10px">                        /**
</span><span class="cx" style="display: block; padding: 0 10px">                         * Build the query to send along with the Preview request.
</span><span class="cx" style="display: block; padding: 0 10px">                         *
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                         * @since 3.4.0
</ins><span class="cx" style="display: block; padding: 0 10px">                          * @since 4.7.0 Added options param.
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                         * @access public
</ins><span class="cx" style="display: block; padding: 0 10px">                          *
</span><span class="cx" style="display: block; padding: 0 10px">                         * @param {object}  [options] Options.
</span><span class="cx" style="display: block; padding: 0 10px">                         * @param {boolean} [options.excludeCustomizedSaved=false] Exclude saved settings in customized response (values pending writing to changeset).
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -4333,12 +4354,14 @@
</span><span class="cx" style="display: block; padding: 0 10px">                         * A revision will be made for the changeset post if revisions support
</span><span class="cx" style="display: block; padding: 0 10px">                         * has been added to the post type.
</span><span class="cx" style="display: block; padding: 0 10px">                         *
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                         * @since 3.4.0
+                        * @since 4.7.0 Added args param and return value.
+                        *
</ins><span class="cx" style="display: block; padding: 0 10px">                          * @param {object} [args] Args.
</span><span class="cx" style="display: block; padding: 0 10px">                         * @param {string} [args.status=publish] Status.
</span><span class="cx" style="display: block; padding: 0 10px">                         * @param {string} [args.date] Date, in local time in MySQL format.
</span><span class="cx" style="display: block; padding: 0 10px">                         * @param {string} [args.title] Title
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                         *
-                        * @returns {jQuery.promise}
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                  * @returns {jQuery.promise} Promise.
</ins><span class="cx" style="display: block; padding: 0 10px">                          */
</span><span class="cx" style="display: block; padding: 0 10px">                        save: function( args ) {
</span><span class="cx" style="display: block; padding: 0 10px">                                var previewer = this,
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -4693,6 +4716,15 @@
</span><span class="cx" style="display: block; padding: 0 10px">                                }
</span><span class="cx" style="display: block; padding: 0 10px">                        });
</span><span class="cx" style="display: block; padding: 0 10px"> 
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                        /**
+                        * Populate URL with UUID via `history.replaceState()`.
+                        *
+                        * @since 4.7.0
+                        * @access private
+                        *
+                        * @param {boolean} isIncluded Is UUID included.
+                        * @returns {void}
+                        */
</ins><span class="cx" style="display: block; padding: 0 10px">                         populateChangesetUuidParam = function( isIncluded ) {
</span><span class="cx" style="display: block; padding: 0 10px">                                var urlParser, queryParams;
</span><span class="cx" style="display: block; padding: 0 10px">                                urlParser = document.createElement( 'a' );
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -4829,7 +4861,15 @@
</span><span class="cx" style="display: block; padding: 0 10px">                                changeContainer, getHeaderHeight, releaseStickyHeader, resetStickyHeader, positionStickyHeader,
</span><span class="cx" style="display: block; padding: 0 10px">                                activeHeader, lastScrollTop;
</span><span class="cx" style="display: block; padding: 0 10px"> 
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                        // Determine which panel or section is currently expanded.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                 /**
+                        * Determine which panel or section is currently expanded.
+                        *
+                        * @since 4.7.0
+                        * @access private
+                        *
+                        * @param {wp.customize.Panel|wp.customize.Section} container Construct.
+                        * @returns {void}
+                        */
</ins><span class="cx" style="display: block; padding: 0 10px">                         changeContainer = function( container ) {
</span><span class="cx" style="display: block; padding: 0 10px">                                var newInstance = container,
</span><span class="cx" style="display: block; padding: 0 10px">                                        expandedSection = api.state( 'expandedSection' ).get(),
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -4905,7 +4945,15 @@
</span><span class="cx" style="display: block; padding: 0 10px">                                headerParent.css( 'padding-top', '' );
</span><span class="cx" style="display: block; padding: 0 10px">                        };
</span><span class="cx" style="display: block; padding: 0 10px"> 
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                        // Get header height.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                 /**
+                        * Get header height.
+                        *
+                        * @since 4.7.0
+                        * @access private
+                        *
+                        * @param {jQuery} headerElement Header element.
+                        * @returns {number} Height.
+                        */
</ins><span class="cx" style="display: block; padding: 0 10px">                         getHeaderHeight = function( headerElement ) {
</span><span class="cx" style="display: block; padding: 0 10px">                                var height = headerElement.data( 'height' );
</span><span class="cx" style="display: block; padding: 0 10px">                                if ( ! height ) {
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -4915,7 +4963,17 @@
</span><span class="cx" style="display: block; padding: 0 10px">                                return height;
</span><span class="cx" style="display: block; padding: 0 10px">                        };
</span><span class="cx" style="display: block; padding: 0 10px"> 
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                        // Reposition header on throttled `scroll` event.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                 /**
+                        * Reposition header on throttled `scroll` event.
+                        *
+                        * @since 4.7.0
+                        * @access private
+                        *
+                        * @param {object}  header        Header.
+                        * @param {number}  scrollTop     Scroll top.
+                        * @param {boolean} isScrollingUp Is scrolling up?
+                        * @returns {void}
+                        */
</ins><span class="cx" style="display: block; padding: 0 10px">                         positionStickyHeader = function( header, scrollTop, isScrollingUp ) {
</span><span class="cx" style="display: block; padding: 0 10px">                                var headerElement = header.element,
</span><span class="cx" style="display: block; padding: 0 10px">                                        headerParent = header.parent,
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -5362,6 +5420,7 @@
</span><span class="cx" style="display: block; padding: 0 10px">                        /**
</span><span class="cx" style="display: block; padding: 0 10px">                         * Request changeset update and then re-schedule the next changeset update time.
</span><span class="cx" style="display: block; padding: 0 10px">                         *
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                         * @since 4.7.0
</ins><span class="cx" style="display: block; padding: 0 10px">                          * @private
</span><span class="cx" style="display: block; padding: 0 10px">                         */
</span><span class="cx" style="display: block; padding: 0 10px">                        updateChangesetWithReschedule = function() {
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -5377,6 +5436,7 @@
</span><span class="cx" style="display: block; padding: 0 10px">                        /**
</span><span class="cx" style="display: block; padding: 0 10px">                         * Schedule changeset update.
</span><span class="cx" style="display: block; padding: 0 10px">                         *
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                         * @since 4.7.0
</ins><span class="cx" style="display: block; padding: 0 10px">                          * @private
</span><span class="cx" style="display: block; padding: 0 10px">                         */
</span><span class="cx" style="display: block; padding: 0 10px">                        scheduleChangesetUpdate = function() {
</span></span></pre></div>
<a id="trunksrcwpadminjscustomizenavmenusjs"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-admin/js/customize-nav-menus.js</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-admin/js/customize-nav-menus.js      2016-11-23 02:54:24 UTC (rev 39344)
+++ trunk/src/wp-admin/js/customize-nav-menus.js        2016-11-23 06:04:23 UTC (rev 39345)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -85,6 +85,9 @@
</span><span class="cx" style="display: block; padding: 0 10px">        /**
</span><span class="cx" style="display: block; padding: 0 10px">         * Insert a new `auto-draft` post.
</span><span class="cx" style="display: block; padding: 0 10px">         *
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         * @since 4.7.0
+        * @access public
+        *
</ins><span class="cx" style="display: block; padding: 0 10px">          * @param {object} params - Parameters for the draft post to create.
</span><span class="cx" style="display: block; padding: 0 10px">         * @param {string} params.post_type - Post type to add.
</span><span class="cx" style="display: block; padding: 0 10px">         * @param {string} params.post_title - Post title to use.
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -562,7 +565,15 @@
</span><span class="cx" style="display: block; padding: 0 10px">                        itemName.val( '' );
</span><span class="cx" style="display: block; padding: 0 10px">                },
</span><span class="cx" style="display: block; padding: 0 10px"> 
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                // Submit handler for keypress (enter) on field and click on button.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         /**
+                * Submit handler for keypress (enter) on field and click on button.
+                *
+                * @since 4.7.0
+                * @private
+                *
+                * @param {jQuery.Event} event Event.
+                * @returns {void}
+                */
</ins><span class="cx" style="display: block; padding: 0 10px">                 _submitNew: function( event ) {
</span><span class="cx" style="display: block; padding: 0 10px">                        var container;
</span><span class="cx" style="display: block; padding: 0 10px"> 
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -580,7 +591,15 @@
</span><span class="cx" style="display: block; padding: 0 10px">                        this.submitNew( container );
</span><span class="cx" style="display: block; padding: 0 10px">                },
</span><span class="cx" style="display: block; padding: 0 10px"> 
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                // Creates a new object and adds an associated menu item to the menu.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         /**
+                * Creates a new object and adds an associated menu item to the menu.
+                *
+                * @since 4.7.0
+                * @private
+                *
+                * @param {jQuery} container
+                * @returns {void}
+                */
</ins><span class="cx" style="display: block; padding: 0 10px">                 submitNew: function( container ) {
</span><span class="cx" style="display: block; padding: 0 10px">                        var panel = this,
</span><span class="cx" style="display: block; padding: 0 10px">                                itemName = container.find( '.create-item-input' ),
</span></span></pre></div>
<a id="trunksrcwpincludesclasswpcustomizecontrolphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/class-wp-customize-control.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/class-wp-customize-control.php      2016-11-23 02:54:24 UTC (rev 39344)
+++ trunk/src/wp-includes/class-wp-customize-control.php        2016-11-23 06:04:23 UTC (rev 39345)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -119,7 +119,7 @@
</span><span class="cx" style="display: block; padding: 0 10px">         *
</span><span class="cx" style="display: block; padding: 0 10px">         * @since 4.7.0
</span><span class="cx" style="display: block; padding: 0 10px">         * @access public
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         * @var array
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+  * @var bool
</ins><span class="cx" style="display: block; padding: 0 10px">          */
</span><span class="cx" style="display: block; padding: 0 10px">        public $allow_addition = false;
</span><span class="cx" style="display: block; padding: 0 10px"> 
</span></span></pre></div>
<a id="trunksrcwpincludesclasswpcustomizemanagerphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/class-wp-customize-manager.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/class-wp-customize-manager.php      2016-11-23 02:54:24 UTC (rev 39344)
+++ trunk/src/wp-includes/class-wp-customize-manager.php        2016-11-23 06:04:23 UTC (rev 39345)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -3967,27 +3967,27 @@
</span><span class="cx" style="display: block; padding: 0 10px">                        if ( ! in_array( $value, array( 'repeat-x', 'repeat-y', 'repeat', 'no-repeat' ) ) ) {
</span><span class="cx" style="display: block; padding: 0 10px">                                return new WP_Error( 'invalid_value', __( 'Invalid value for background repeat.' ) );
</span><span class="cx" style="display: block; padding: 0 10px">                        }
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                } else if ( 'background_attachment' === $setting->id ) {
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         } elseif ( 'background_attachment' === $setting->id ) {
</ins><span class="cx" style="display: block; padding: 0 10px">                         if ( ! in_array( $value, array( 'fixed', 'scroll' ) ) ) {
</span><span class="cx" style="display: block; padding: 0 10px">                                return new WP_Error( 'invalid_value', __( 'Invalid value for background attachment.' ) );
</span><span class="cx" style="display: block; padding: 0 10px">                        }
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                } else if ( 'background_position_x' === $setting->id ) {
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         } elseif ( 'background_position_x' === $setting->id ) {
</ins><span class="cx" style="display: block; padding: 0 10px">                         if ( ! in_array( $value, array( 'left', 'center', 'right' ), true ) ) {
</span><span class="cx" style="display: block; padding: 0 10px">                                return new WP_Error( 'invalid_value', __( 'Invalid value for background position X.' ) );
</span><span class="cx" style="display: block; padding: 0 10px">                        }
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                } else if ( 'background_position_y' === $setting->id ) {
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         } elseif ( 'background_position_y' === $setting->id ) {
</ins><span class="cx" style="display: block; padding: 0 10px">                         if ( ! in_array( $value, array( 'top', 'center', 'bottom' ), true ) ) {
</span><span class="cx" style="display: block; padding: 0 10px">                                return new WP_Error( 'invalid_value', __( 'Invalid value for background position Y.' ) );
</span><span class="cx" style="display: block; padding: 0 10px">                        }
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                } else if ( 'background_size' === $setting->id ) {
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         } elseif ( 'background_size' === $setting->id ) {
</ins><span class="cx" style="display: block; padding: 0 10px">                         if ( ! in_array( $value, array( 'auto', 'contain', 'cover' ), true ) ) {
</span><span class="cx" style="display: block; padding: 0 10px">                                return new WP_Error( 'invalid_value', __( 'Invalid value for background size.' ) );
</span><span class="cx" style="display: block; padding: 0 10px">                        }
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                } else if ( 'background_preset' === $setting->id ) {
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         } elseif ( 'background_preset' === $setting->id ) {
</ins><span class="cx" style="display: block; padding: 0 10px">                         if ( ! in_array( $value, array( 'default', 'fill', 'fit', 'repeat', 'custom' ), true ) ) {
</span><span class="cx" style="display: block; padding: 0 10px">                                return new WP_Error( 'invalid_value', __( 'Invalid value for background size.' ) );
</span><span class="cx" style="display: block; padding: 0 10px">                        }
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-                } else if ( 'background_image' === $setting->id || 'background_image_thumb' === $setting->id ) {
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         } elseif ( 'background_image' === $setting->id || 'background_image_thumb' === $setting->id ) {
</ins><span class="cx" style="display: block; padding: 0 10px">                         $value = empty( $value ) ? '' : esc_url_raw( $value );
</span><span class="cx" style="display: block; padding: 0 10px">                } else {
</span><span class="cx" style="display: block; padding: 0 10px">                        return new WP_Error( 'unrecognized_setting', __( 'Unrecognized background setting.' ) );
</span></span></pre></div>
<a id="trunksrcwpincludescustomizeclasswpcustomizecolorcontrolphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/customize/class-wp-customize-color-control.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/customize/class-wp-customize-color-control.php      2016-11-23 02:54:24 UTC (rev 39344)
+++ trunk/src/wp-includes/customize/class-wp-customize-color-control.php        2016-11-23 06:04:23 UTC (rev 39345)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -16,21 +16,28 @@
</span><span class="cx" style="display: block; padding: 0 10px">  */
</span><span class="cx" style="display: block; padding: 0 10px"> class WP_Customize_Color_Control extends WP_Customize_Control {
</span><span class="cx" style="display: block; padding: 0 10px">        /**
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         * Type.
+        *
</ins><span class="cx" style="display: block; padding: 0 10px">          * @access public
</span><span class="cx" style="display: block; padding: 0 10px">         * @var string
</span><span class="cx" style="display: block; padding: 0 10px">         */
</span><span class="cx" style="display: block; padding: 0 10px">        public $type = 'color';
</span><span class="cx" style="display: block; padding: 0 10px"> 
</span><span class="cx" style="display: block; padding: 0 10px">        /**
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         * Statuses.
+        *
</ins><span class="cx" style="display: block; padding: 0 10px">          * @access public
</span><span class="cx" style="display: block; padding: 0 10px">         * @var array
</span><span class="cx" style="display: block; padding: 0 10px">         */
</span><span class="cx" style="display: block; padding: 0 10px">        public $statuses;
</span><span class="cx" style="display: block; padding: 0 10px"> 
</span><span class="cx" style="display: block; padding: 0 10px">        /**
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-        * @access public
-       * @var string
-       */
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+  * Mode.
+        *
+        * @since 4.7.0
+        * @access public
+        * @var string
+        */
</ins><span class="cx" style="display: block; padding: 0 10px">         public $mode = 'full';
</span><span class="cx" style="display: block; padding: 0 10px"> 
</span><span class="cx" style="display: block; padding: 0 10px">        /**
</span></span></pre></div>
<a id="trunksrcwpincludescustomizeclasswpcustomizecustomcsssettingphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/customize/class-wp-customize-custom-css-setting.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/customize/class-wp-customize-custom-css-setting.php 2016-11-23 02:54:24 UTC (rev 39344)
+++ trunk/src/wp-includes/customize/class-wp-customize-custom-css-setting.php   2016-11-23 06:04:23 UTC (rev 39345)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -21,10 +21,9 @@
</span><span class="cx" style="display: block; padding: 0 10px">        /**
</span><span class="cx" style="display: block; padding: 0 10px">         * The setting type.
</span><span class="cx" style="display: block; padding: 0 10px">         *
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         * @var string
-        *
</del><span class="cx" style="display: block; padding: 0 10px">          * @since 4.7.0
</span><span class="cx" style="display: block; padding: 0 10px">         * @access public
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         * @var string
</ins><span class="cx" style="display: block; padding: 0 10px">          */
</span><span class="cx" style="display: block; padding: 0 10px">        public $type = 'custom_css';
</span><span class="cx" style="display: block; padding: 0 10px"> 
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -33,7 +32,6 @@
</span><span class="cx" style="display: block; padding: 0 10px">         *
</span><span class="cx" style="display: block; padding: 0 10px">         * @since 4.7.0
</span><span class="cx" style="display: block; padding: 0 10px">         * @access public
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         *
</del><span class="cx" style="display: block; padding: 0 10px">          * @var string
</span><span class="cx" style="display: block; padding: 0 10px">         */
</span><span class="cx" style="display: block; padding: 0 10px">        public $transport = 'postMessage';
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -43,7 +41,6 @@
</span><span class="cx" style="display: block; padding: 0 10px">         *
</span><span class="cx" style="display: block; padding: 0 10px">         * @since 4.7.0
</span><span class="cx" style="display: block; padding: 0 10px">         * @access public
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         *
</del><span class="cx" style="display: block; padding: 0 10px">          * @var string
</span><span class="cx" style="display: block; padding: 0 10px">         */
</span><span class="cx" style="display: block; padding: 0 10px">        public $capability = 'edit_css';
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -53,7 +50,6 @@
</span><span class="cx" style="display: block; padding: 0 10px">         *
</span><span class="cx" style="display: block; padding: 0 10px">         * @since 4.7.0
</span><span class="cx" style="display: block; padding: 0 10px">         * @access public
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-         *
</del><span class="cx" style="display: block; padding: 0 10px">          * @var string
</span><span class="cx" style="display: block; padding: 0 10px">         */
</span><span class="cx" style="display: block; padding: 0 10px">        public $stylesheet = '';
</span></span></pre></div>
<a id="trunksrcwpincludescustomizeclasswpcustomizenavmenuitemsettingphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/customize/class-wp-customize-nav-menu-item-setting.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/customize/class-wp-customize-nav-menu-item-setting.php      2016-11-23 02:54:24 UTC (rev 39344)
+++ trunk/src/wp-includes/customize/class-wp-customize-nav-menu-item-setting.php        2016-11-23 06:04:23 UTC (rev 39345)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -267,6 +267,7 @@
</span><span class="cx" style="display: block; padding: 0 10px">         * Get original title.
</span><span class="cx" style="display: block; padding: 0 10px">         *
</span><span class="cx" style="display: block; padding: 0 10px">         * @since 4.7.0
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+         * @access protected
</ins><span class="cx" style="display: block; padding: 0 10px">          *
</span><span class="cx" style="display: block; padding: 0 10px">         * @param object $item Nav menu item.
</span><span class="cx" style="display: block; padding: 0 10px">         * @return string The original title.
</span></span></pre></div>
<a id="trunksrcwpincludesjscustomizepreviewjs"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/js/customize-preview.js</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/js/customize-preview.js     2016-11-23 02:54:24 UTC (rev 39344)
+++ trunk/src/wp-includes/js/customize-preview.js       2016-11-23 06:04:23 UTC (rev 39345)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -132,6 +132,7 @@
</span><span class="cx" style="display: block; padding: 0 10px">                 * Handle link clicks in preview.
</span><span class="cx" style="display: block; padding: 0 10px">                 *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @since 4.7.0
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                 * @access public
</ins><span class="cx" style="display: block; padding: 0 10px">                  *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @param {jQuery.Event} event Event.
</span><span class="cx" style="display: block; padding: 0 10px">                 */
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -178,6 +179,7 @@
</span><span class="cx" style="display: block; padding: 0 10px">                 * Handle form submit.
</span><span class="cx" style="display: block; padding: 0 10px">                 *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @since 4.7.0
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                 * @access public
</ins><span class="cx" style="display: block; padding: 0 10px">                  *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @param {jQuery.Event} event Event.
</span><span class="cx" style="display: block; padding: 0 10px">                 */
</span></span></pre></div>
<a id="trunksrcwpincludesjscustomizeselectiverefreshjs"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/src/wp-includes/js/customize-selective-refresh.js</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/src/wp-includes/js/customize-selective-refresh.js   2016-11-23 02:54:24 UTC (rev 39344)
+++ trunk/src/wp-includes/js/customize-selective-refresh.js     2016-11-23 06:04:23 UTC (rev 39345)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -104,6 +104,7 @@
</span><span class="cx" style="display: block; padding: 0 10px">                 * Create and show the edit shortcut for a given partial placement container.
</span><span class="cx" style="display: block; padding: 0 10px">                 *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @since 4.7.0
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                 * @access public
</ins><span class="cx" style="display: block; padding: 0 10px">                  *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @param {Placement} placement The placement container element.
</span><span class="cx" style="display: block; padding: 0 10px">                 * @returns {void}
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -132,6 +133,7 @@
</span><span class="cx" style="display: block; padding: 0 10px">                 * Add an edit shortcut to the placement container.
</span><span class="cx" style="display: block; padding: 0 10px">                 *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @since 4.7.0
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                 * @access public
</ins><span class="cx" style="display: block; padding: 0 10px">                  *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @param {Placement} placement The placement for the partial.
</span><span class="cx" style="display: block; padding: 0 10px">                 * @param {jQuery} $editShortcut The shortcut element as a jQuery object.
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -149,6 +151,7 @@
</span><span class="cx" style="display: block; padding: 0 10px">                 * Return the unique class name for the edit shortcut button for this partial.
</span><span class="cx" style="display: block; padding: 0 10px">                 *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @since 4.7.0
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                 * @access public
</ins><span class="cx" style="display: block; padding: 0 10px">                  *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @return {string} Partial ID converted into a class name for use in shortcut.
</span><span class="cx" style="display: block; padding: 0 10px">                 */
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -162,6 +165,7 @@
</span><span class="cx" style="display: block; padding: 0 10px">                 * Return the appropriate translated string for the edit shortcut button.
</span><span class="cx" style="display: block; padding: 0 10px">                 *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @since 4.7.0
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                 * @access public
</ins><span class="cx" style="display: block; padding: 0 10px">                  *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @return {string} Tooltip for edit shortcut.
</span><span class="cx" style="display: block; padding: 0 10px">                 */
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -187,6 +191,7 @@
</span><span class="cx" style="display: block; padding: 0 10px">                 * Will use `params.type` if set, but otherwise will try to infer type from settingId.
</span><span class="cx" style="display: block; padding: 0 10px">                 *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @since 4.7.0
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                 * @access public
</ins><span class="cx" style="display: block; padding: 0 10px">                  *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @return {string} Type of partial derived from type param or the related setting ID.
</span><span class="cx" style="display: block; padding: 0 10px">                 */
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -209,6 +214,7 @@
</span><span class="cx" style="display: block; padding: 0 10px">                 * Create an edit shortcut button for this partial.
</span><span class="cx" style="display: block; padding: 0 10px">                 *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @since 4.7.0
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+                 * @access public
</ins><span class="cx" style="display: block; padding: 0 10px">                  *
</span><span class="cx" style="display: block; padding: 0 10px">                 * @return {jQuery} The edit shortcut button element.
</span><span class="cx" style="display: block; padding: 0 10px">                 */
</span></span></pre>
</div>
</div>

</body>
</html>