From 54c50687ddfcd79814aa1f854056b51eacd4e9e1 Mon Sep 17 00:00:00 2001
From: ahmedibrhm <81244897+ahmedibrhm@users.noreply.github.com>
Date: Fri, 8 Jul 2022 00:29:21 -0700
Subject: [PATCH 1/2] DOC #45443 edited the documentation of where/mask
 functions

---
 pandas/core/generic.py | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/pandas/core/generic.py b/pandas/core/generic.py
index ba3474a2513fb..b46eff137394c 100644
--- a/pandas/core/generic.py
+++ b/pandas/core/generic.py
@@ -9614,7 +9614,8 @@ def where(
         The {name} method is an application of the if-then idiom. For each
         element in the calling DataFrame, if ``cond`` is ``{cond}`` the
         element is used; otherwise the corresponding element from the DataFrame
-        ``other`` is used.
+        ``other`` is used. If `cond` {klass} is less in size than `other`, the default bool
+        for the missing value is {cond_rev}.
 
         The signature for :func:`DataFrame.where` differs from
         :func:`numpy.where`. Roughly ``df1.where(m, df2)`` is equivalent to
@@ -9641,6 +9642,23 @@ def where(
         4    NaN
         dtype: float64
 
+        >>> s = pd.Series(range(5))
+        >>> t = pd.Series([True, False])
+        >>> s.where(t,99)
+        0     0
+        1    99
+        2    99
+        3    99
+        4    99
+        dtype: int64
+        >>> s.mask(t, 99)
+        0    99
+        1     1
+        2    99
+        3    99
+        4    99
+        dtype: int64
+
         >>> s.where(s > 1, 10)
         0    10
         1    10

From 2951fb14ef8c589f50b5a28e76878de410968b79 Mon Sep 17 00:00:00 2001
From: ahmedibrhm <81244897+ahmedibrhm@users.noreply.github.com>
Date: Fri, 8 Jul 2022 00:39:29 -0700
Subject: [PATCH 2/2] DOC #45443 edited the documentation of where/mask
 functions

---
 pandas/core/generic.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pandas/core/generic.py b/pandas/core/generic.py
index b46eff137394c..489ad1e3bf5c2 100644
--- a/pandas/core/generic.py
+++ b/pandas/core/generic.py
@@ -9614,8 +9614,8 @@ def where(
         The {name} method is an application of the if-then idiom. For each
         element in the calling DataFrame, if ``cond`` is ``{cond}`` the
         element is used; otherwise the corresponding element from the DataFrame
-        ``other`` is used. If `cond` {klass} is less in size than `other`, the default bool
-        for the missing value is {cond_rev}.
+        ``other`` is used. If `cond` {klass} is less in size than `other`, the
+        default bool for the missing value is {cond_rev}.
 
         The signature for :func:`DataFrame.where` differs from
         :func:`numpy.where`. Roughly ``df1.where(m, df2)`` is equivalent to