From a8a6d4d815106dff926d5435ecf2b939e35ea8c3 Mon Sep 17 00:00:00 2001
From: Richard Gibson <richard.gibson@gmail.com>
Date: Thu, 19 Dec 2013 08:13:29 -0500
Subject: [PATCH] Synchronize .width() and .height() documentation

* Include the style/script warning
* Follow the style guide (http://contribute.jquery.org/style-guide/js/#comments)

Ref jQuery #14545
---
 entries/height.xml | 7 +++++--
 entries/width.xml  | 3 +++
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/entries/height.xml b/entries/height.xml
index 3632ed02..08a2daf0 100644
--- a/entries/height.xml
+++ b/entries/height.xml
@@ -14,8 +14,11 @@
       </p>
       <p>This method is also able to find the height of the window and document.</p>
       <pre><code>
-$( window ).height(); // returns height of browser viewport
-$( document ).height(); // returns height of HTML document
+// Returns height of browser viewport
+$( window ).height();
+
+// Returns height of HTML document
+$( document ).height();
       </code></pre>
       <p>Note that <code>.height()</code> will always return the content height, regardless of the value of the CSS <code>box-sizing</code> property. As of jQuery 1.8, this may require retrieving the CSS height plus <code>box-sizing</code> property and then subtracting any potential border and padding on each element when the element has <code>box-sizing: border-box</code>. To avoid this penalty, use <code>.css( "height" )</code> rather than <code>.height()</code>.</p>
       <div class="warning">
diff --git a/entries/width.xml b/entries/width.xml
index 9c49066e..ddc69ca0 100644
--- a/entries/width.xml
+++ b/entries/width.xml
@@ -21,6 +21,9 @@ $( window ).width();
 $( document ).width();
       </code></pre>
       <p>Note that <code>.width()</code> will always return the content width, regardless of the value of the CSS <code>box-sizing</code> property. As of jQuery 1.8, this may require retrieving the CSS width plus <code>box-sizing</code> property and then subtracting any potential border and padding on each element when the element has <code>box-sizing: border-box</code>. To avoid this penalty, use <code>.css( "width" )</code> rather than <code>.width()</code>.</p>
+      <div class="warning">
+        <p><strong>Note:</strong> Although <code>style</code> and <code>script</code> tags will report a value for <code>.width()</code> or <code>height()</code> when absolutely positioned and given <code>display:block</code>, it is strongly discouraged to call those methods on these tags. In addition to being a bad practice, the results may also prove unreliable.</p>
+      </div>
     </longdesc>
     <example>
       <desc>Show various widths.  Note the values are from the iframe so might be smaller than you expected.  The yellow highlight shows the iframe body.</desc>