details on weekday argument for DateOffset docs

Author: Detoro

doc/books.xml

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<bookstore>
+  <book category="cooking">
+    <title lang="en">Everyday Italian</title>
+    <author>Giada De Laurentiis</author>
+    <year>2005</year>
+    <price>30.00</price>
+  </book>
+  <book category="children">
+    <title lang="en">Harry Potter</title>
+    <author>J K. Rowling</author>
+    <year>2005</year>
+    <price>29.99</price>
+  </book>
+  <book category="web">
+    <title lang="en">Learning XML</title>
+    <author>Erik T. Ray</author>
+    <year>2003</year>
+    <price>39.95</price>
+  </book>
+</bookstore>

doc/source/getting_started/intro_tutorials/04_plotting.rst

@@ -49,7 +49,7 @@ How do I create plots in pandas?
 I want a quick visual check of the data.
 
 .. ipython:: python
-
+    :okwarning:
     @savefig 04_airqual_quick.png
     air_quality.plot()
     plt.show()
@@ -78,7 +78,7 @@ I want to plot only the columns of the data table with the data from Paris.
     plt.clf()
 
 .. ipython:: python
-
+    :okwarning:
     @savefig 04_airqual_paris.png
     air_quality["station_paris"].plot()
     plt.show()
@@ -101,7 +101,7 @@ method. Hence, the :meth:`~DataFrame.plot` method works on both ``Series`` and
 I want to visually compare the :math:`NO_2` values measured in London versus Paris.
 
 .. ipython:: python
-
+    :okwarning:
     @savefig 04_airqual_scatter.png
     air_quality.plot.scatter(x="station_london", y="station_paris", alpha=0.5)
     plt.show()
@@ -133,7 +133,7 @@ One of the options is :meth:`DataFrame.plot.box`, which refers to a
 method is applicable on the air quality example data:
 
 .. ipython:: python
-
+    :okwarning:
     @savefig 04_airqual_boxplot.png
     air_quality.plot.box()
     plt.show()
@@ -157,7 +157,7 @@ For an introduction to plots other than the default line plot, see the user guid
 I want each of the columns in a separate subplot.
 
 .. ipython:: python
-
+    :okwarning:
     @savefig 04_airqual_area_subplot.png
     axs = air_quality.plot.area(figsize=(12, 4), subplots=True)
     plt.show()
@@ -190,7 +190,7 @@ Some more formatting options are explained in the user guide section on :ref:`pl
 I want to further customize, extend or save the resulting plot.
 
 .. ipython:: python
-
+    :okwarning:
     fig, axs = plt.subplots(figsize=(12, 4))
     air_quality.plot.area(ax=axs)
     axs.set_ylabel("NO$_2$ concentration")
@@ -200,7 +200,7 @@ I want to further customize, extend or save the resulting plot.
 
 .. ipython:: python
    :suppress:
-
+    :okwarning:
    import os
 
    os.remove("no2_concentrations.png")

doc/source/user_guide/10min.rst

@@ -747,7 +747,7 @@ If running under Jupyter Notebook, the plot will appear on :meth:`~Series.plot`.
 `matplotlib.pyplot.savefig <https://matplotlib.org/3.1.1/api/_as_gen/matplotlib.pyplot.savefig.html>`__ to write it to a file.
 
 .. ipython:: python
-
+   :okwarning:
    plt.show();
 
 On a DataFrame, the :meth:`~DataFrame.plot` method is a convenience to plot all

pandas/_libs/tslibs/offsets.pyx

@@ -1373,7 +1373,25 @@ class DateOffset(RelativeDeltaOffset, metaclass=OffsetMeta):
         previous midnight.
     **kwds
         Temporal parameter that add to or replace the offset value.
+    weekday : int {0, 1, ..., 6}, default 0
+        A specific integer for the day of the week.
+        - 0 is Monday
+        - 1 is Tuesday
+        - 2 is Wednesday
+        - 3 is Thursday
+        - 4 is Friday
+        - 5 is Saturday
+        - 6 is Sunday.
 
+        Instead Weekday type from dateutil.relativedelta can be used.
+        - MO is Monday
+        - TU is Tuesday
+        - WE is Wednesday
+        - TH is Thursday
+        - FR is Friday
+        - SA is Saturday
+        - SU is Sunday.
+        
         Parameters that **add** to the offset (like Timedelta):
 
         - years