Docs: Improve inline comments per the documentation standards.

Includes minor code layout fixes for better readability.

See #48303.
Built from https://develop.svn.wordpress.org/trunk@47122


git-svn-id: http://core.svn.wordpress.org/trunk@46922 1a063a9b-81f0-0310-95a4-ce76da25c4cd

wp-includes/js/wp-pointer.js

@@ -90,11 +90,11 @@
 			var o   = this.options,
 				tip = this.pointer;
 
-			// Handle document transfer
+			// Handle document transfer.
 			if ( key === 'document' && value !== o.document ) {
 				tip.detach().appendTo( value.body );
 
-			// Handle class change
+			// Handle class change.
 			} else if ( key === 'pointerClass' ) {
 				tip.removeClass( o.pointerClass ).addClass( value );
 			}
@@ -102,11 +102,11 @@
 			// Call super method.
 			$.Widget.prototype._setOption.apply( this, arguments );
 
-			// Reposition automatically
+			// Reposition automatically.
 			if ( key === 'position' ) {
 				this.reposition();
 
-			// Update content automatically if pointer is open
+			// Update content automatically if pointer is open.
 			} else if ( key === 'content' && this.active ) {
 				this.update();
 			}
@@ -234,7 +234,7 @@
 			}).show().position($.extend({
 				of: this.element,
 				collision: 'fit none'
-			}, position )); // the object comes before this.options.position so the user can override position.of.
+			}, position )); // The object comes before this.options.position so the user can override position.of.
 
 			this.repoint();
 		},