From 3aa71f277abc08eef73391d447b5dc1ae5354b7a Mon Sep 17 00:00:00 2001
From: Richard Gibson <richard.gibson@gmail.com>
Date: Sun, 13 Nov 2016 17:21:31 -0500
Subject: [PATCH] Dimensions: Document empty-context getters

Fixes gh-997
Closes gh-998
---
 entries/innerHeight.xml | 2 +-
 entries/innerWidth.xml  | 2 +-
 entries/outerHeight.xml | 2 +-
 entries/outerWidth.xml  | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/entries/innerHeight.xml b/entries/innerHeight.xml
index b8c5654e..bdc22f23 100644
--- a/entries/innerHeight.xml
+++ b/entries/innerHeight.xml
@@ -9,7 +9,7 @@
   </signature>
   <desc>Get the current computed height for the first element in the set of matched elements, including padding but not border.</desc>
   <longdesc>
-    <p>This method returns the height of the element, including top and bottom padding, in pixels.</p>
+    <p>This method returns the height of the element, including top and bottom padding, in pixels. If called on an empty set of elements, returns <code>undefined</code> (<code>null</code> before jQuery 3.0).</p>
     <p>This method is not applicable to <code>window</code> and <code>document</code> objects; for these, use <code><a href="/height/">.height()</a></code> instead.</p>
     <figure>
       <img src="/resources/0042_04_02.png"/>
diff --git a/entries/innerWidth.xml b/entries/innerWidth.xml
index 6e9fd0d3..d3641b00 100644
--- a/entries/innerWidth.xml
+++ b/entries/innerWidth.xml
@@ -8,7 +8,7 @@
   </signature>
   <desc>Get the current computed inner width for the first element in the set of matched elements, including padding but not border.</desc>
   <longdesc>
-    <p>This method returns the width of the element, including left and right padding, in pixels.</p>
+    <p>This method returns the width of the element, including left and right padding, in pixels. If called on an empty set of elements, returns <code>undefined</code> (<code>null</code> before jQuery 3.0).</p>
     <p>This method is not applicable to <code>window</code> and <code>document</code> objects; for these, use <code><a href="/width/">.width()</a></code> instead.</p>
     <figure>
       <img src="/resources/0042_04_05.png"/>
diff --git a/entries/outerHeight.xml b/entries/outerHeight.xml
index 9f3a8fe5..c50dd23d 100644
--- a/entries/outerHeight.xml
+++ b/entries/outerHeight.xml
@@ -11,7 +11,7 @@
   </signature>
   <desc>Get the current computed outer height (including padding, border, and optionally margin) for the first element in the set of matched elements.</desc>
   <longdesc>
-    <p>Returns the height of the element, including top and bottom padding, border, and optionally margin, in pixels.</p>
+    <p>Returns the height of the element, including top and bottom padding, border, and optionally margin, in pixels. If called on an empty set of elements, returns <code>undefined</code> (<code>null</code> before jQuery 3.0).</p>
     <p>This method is not applicable to <code>window</code> and <code>document</code> objects; for these, use <code><a href="/height/">.height()</a></code> instead. Although <code>.outerHeight()</code> can be used on table elements, it may give unexpected results on tables using the <code>border-collapse: collapse</code> CSS property.</p>
     <figure>
       <img src="/resources/0042_04_03.png"/>
diff --git a/entries/outerWidth.xml b/entries/outerWidth.xml
index dcf7d23c..bb37d571 100644
--- a/entries/outerWidth.xml
+++ b/entries/outerWidth.xml
@@ -11,7 +11,7 @@
   </signature>
   <desc>Get the current computed outer width (including padding, border, and optionally margin) for the first element in the set of matched elements.</desc>
   <longdesc>
-    <p>Returns the width of the element, including left and right padding, border, and optionally margin, in pixels.</p>
+    <p>Returns the width of the element, including left and right padding, border, and optionally margin, in pixels. If called on an empty set of elements, returns <code>undefined</code> (<code>null</code> before jQuery 3.0).</p>
     <p>This method is not applicable to <code>window</code> and <code>document</code> objects; for these, use <code><a href="/width/">.width()</a></code> instead. Although <code>.outerWidth()</code> can be used on table elements, it may give unexpected results on tables using the <code>border-collapse: collapse</code> CSS property.</p>
     <figure>
       <img src="/resources/0042_04_06.png"/>