From 052ec9817dde470b7b1ff4f06c6be68306ae0717 Mon Sep 17 00:00:00 2001
From: "JHM Darbyshire (iMac)" <attack68@users.noreply.github.com>
Date: Sun, 16 Jan 2022 18:02:54 +0100
Subject: [PATCH 1/3] doc string replacement

---
 pandas/io/formats/style.py | 37 ++++++++++++++++++-------------------
 1 file changed, 18 insertions(+), 19 deletions(-)

diff --git a/pandas/io/formats/style.py b/pandas/io/formats/style.py
index 87d4bbcc38373..830b06e9d0641 100644
--- a/pandas/io/formats/style.py
+++ b/pandas/io/formats/style.py
@@ -97,6 +97,15 @@ def _mpl(func: Callable):
 color = """color : str, default 'yellow'
            Background color to use for highlighting."""
 
+buf = """buf : str, path object, file-like object, optional
+         String, path object (implementing ``os.PathLike[str]``), or file-like
+         object implementing a string ``write()`` function. If `None`, the result is
+         returned as a string."""
+
+encoding = """encoding : str, optional
+              Character encoding setting for file output (and meta tags if available).
+              Defaults to ``pandas.options.styler.render.encoding`` value of "utf-8"."""
+
 #
 ###
 
@@ -485,6 +494,7 @@ def to_excel(
             engine=engine,
         )
 
+    @Substitution(buf=buf, encoding=encoding)
     def to_latex(
         self,
         buf: FilePath | WriteBuffer[str] | None = None,
@@ -512,10 +522,7 @@ def to_latex(
 
         Parameters
         ----------
-        buf : str, path object, file-like object, or None, default None
-            String, path object (implementing ``os.PathLike[str]``), or file-like
-            object implementing a string ``write()`` function. If None, the result is
-            returned as a string.
+        %(buf)s
         column_format : str, optional
             The LaTeX column specification placed in location:
 
@@ -600,9 +607,7 @@ def to_latex(
             ``pandas.options.styler.latex.environment``, which is `None`.
 
             .. versionadded:: 1.4.0
-        encoding : str, optional
-            Character encoding setting. Defaults
-            to ``pandas.options.styler.render.encoding``, which is "utf-8".
+        %(encoding)s
         convert_css : bool, default False
             Convert simple cell-styles from CSS to LaTeX format. Any CSS not found in
             conversion table is dropped. A style can be forced by adding option
@@ -1053,6 +1058,7 @@ def to_latex(
             latex, buf=buf, encoding=None if buf is None else encoding
         )
 
+    @Substitution(buf=buf, encoding=encoding)
     def to_html(
         self,
         buf: FilePath | WriteBuffer[str] | None = None,
@@ -1077,10 +1083,7 @@ def to_html(
 
         Parameters
         ----------
-        buf : str, path object, file-like object, or None, default None
-            String, path object (implementing ``os.PathLike[str]``), or file-like
-            object implementing a string ``write()`` function. If None, the result is
-            returned as a string.
+        %(buf)s
         table_uuid : str, optional
             Id attribute assigned to the <table> HTML element in the format:
 
@@ -1127,9 +1130,7 @@ def to_html(
             which is 262144 (18 bit browser rendering).
 
             .. versionadded:: 1.4.0
-        encoding : str, optional
-            Character encoding setting for file output, and HTML meta tags.
-            Defaults to ``pandas.options.styler.render.encoding`` value of "utf-8".
+        %(encoding)s
         doctype_html : bool, default False
             Whether to output a fully structured HTML file including all
             HTML elements, or just the core ``<style>`` and ``<table>`` elements.
@@ -1189,6 +1190,7 @@ def to_html(
             html, buf=buf, encoding=(encoding if buf is not None else None)
         )
 
+    @Substitution(buf=buf, encoding=encoding)
     def to_string(
         self,
         buf=None,
@@ -1207,11 +1209,8 @@ def to_string(
 
         Parameters
         ----------
-        buf : str, Path, or StringIO-like, optional, default None
-            Buffer to write to. If ``None``, the output is returned as a string.
-        encoding : str, optional
-            Character encoding setting for file output.
-            Defaults to ``pandas.options.styler.render.encoding`` value of "utf-8".
+        %(buf)s
+        %(encoding)s
         sparse_index : bool, optional
             Whether to sparsify the display of a hierarchical index. Setting to False
             will display each explicit level element in a hierarchical key for each row.

From 18f455acb5439e424c4bf9d62f42b15cd9f19895 Mon Sep 17 00:00:00 2001
From: "JHM Darbyshire (iMac)" <attack68@users.noreply.github.com>
Date: Sat, 22 Jan 2022 12:05:30 +0100
Subject: [PATCH 2/3] stall changes to_latex

---
 pandas/io/formats/style.py | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/pandas/io/formats/style.py b/pandas/io/formats/style.py
index c3223555f5458..72672116e4e57 100644
--- a/pandas/io/formats/style.py
+++ b/pandas/io/formats/style.py
@@ -494,7 +494,6 @@ def to_excel(
             engine=engine,
         )
 
-    @Substitution(buf=buf, encoding=encoding)
     def to_latex(
         self,
         buf: FilePath | WriteBuffer[str] | None = None,
@@ -522,7 +521,10 @@ def to_latex(
 
         Parameters
         ----------
-        %(buf)s
+        buf : str, path object, file-like object, or None, default None
+            String, path object (implementing ``os.PathLike[str]``), or file-like
+            object implementing a string ``write()`` function. If None, the result is
+            returned as a string.
         column_format : str, optional
             The LaTeX column specification placed in location:
 
@@ -607,7 +609,9 @@ def to_latex(
             ``pandas.options.styler.latex.environment``, which is `None`.
 
             .. versionadded:: 1.4.0
-        %(encoding)s
+        encoding : str, optional
+            Character encoding setting. Defaults
+            to ``pandas.options.styler.render.encoding``, which is "utf-8".
         convert_css : bool, default False
             Convert simple cell-styles from CSS to LaTeX format. Any CSS not found in
             conversion table is dropped. A style can be forced by adding option

From 86b10aeec8e564b14e5410f132e82916c4c9cbb0 Mon Sep 17 00:00:00 2001
From: JHM Darbyshire <24256554+attack68@users.noreply.github.com>
Date: Tue, 25 Jan 2022 12:36:34 +0100
Subject: [PATCH 3/3] Update pandas/io/formats/style.py

---
 pandas/io/formats/style.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pandas/io/formats/style.py b/pandas/io/formats/style.py
index 72672116e4e57..432e12f303919 100644
--- a/pandas/io/formats/style.py
+++ b/pandas/io/formats/style.py
@@ -99,7 +99,7 @@ def _mpl(func: Callable):
 
 buf = """buf : str, path object, file-like object, optional
          String, path object (implementing ``os.PathLike[str]``), or file-like
-         object implementing a string ``write()`` function. If `None`, the result is
+         object implementing a string ``write()`` function. If ``None``, the result is
          returned as a string."""
 
 encoding = """encoding : str, optional