From 825c33fc661d4664e5112e9cf6693a51c7fd6ce7 Mon Sep 17 00:00:00 2001 From: y-p Date: Tue, 14 Jan 2014 15:54:04 +0200 Subject: [PATCH 1/4] BLD: Explicitly request utf-8 encoding in docs conf.py (is default) --- doc/source/conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/source/conf.py b/doc/source/conf.py index c3c946a5180ba..9a49b6b3aad75 100644 --- a/doc/source/conf.py +++ b/doc/source/conf.py @@ -58,7 +58,7 @@ source_suffix = '.rst' # The encoding of source files. -# source_encoding = 'utf-8' +source_encoding = 'utf-8' # The master toctree document. master_doc = 'index' From 332a70e7c634347e742c0f28ef0dd630fde8ce20 Mon Sep 17 00:00:00 2001 From: y-p Date: Tue, 14 Jan 2014 15:54:43 +0200 Subject: [PATCH 2/4] DOC: suppress warning during doc building --- doc/source/dsintro.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/doc/source/dsintro.rst b/doc/source/dsintro.rst index 3cc93d2f3e122..7d49e26759dd4 100644 --- a/doc/source/dsintro.rst +++ b/doc/source/dsintro.rst @@ -11,6 +11,7 @@ np.set_printoptions(precision=4, suppress=True) set_option('display.precision', 4, 'display.max_columns', 8) options.display.max_rows=15 + import pandas as pd ************************ @@ -488,6 +489,12 @@ TimeSeries (which it will be automatically if the index contains datetime objects), and the DataFrame index also contains dates, the broadcasting will be column-wise: +.. ipython:: python + :suppress: + + import warnings + warnings.filterwarnings("ignore",message='TimeSeries broadcasting',category=FutureWarning) + .. ipython:: python index = date_range('1/1/2000', periods=8) From a771e853ab7c71f46ef728fd5e13bf517f74614c Mon Sep 17 00:00:00 2001 From: y-p Date: Tue, 14 Jan 2014 16:13:28 +0200 Subject: [PATCH 3/4] DOC: move _templates out of source/ files to avoid warning --- doc/{source => }/_templates/autosummary/class.rst | 0 doc/source/conf.py | 2 +- 2 files changed, 1 insertion(+), 1 deletion(-) rename doc/{source => }/_templates/autosummary/class.rst (100%) diff --git a/doc/source/_templates/autosummary/class.rst b/doc/_templates/autosummary/class.rst similarity index 100% rename from doc/source/_templates/autosummary/class.rst rename to doc/_templates/autosummary/class.rst diff --git a/doc/source/conf.py b/doc/source/conf.py index 9a49b6b3aad75..30d47d0a306a0 100644 --- a/doc/source/conf.py +++ b/doc/source/conf.py @@ -52,7 +52,7 @@ ] # Add any paths that contain templates here, relative to this directory. -templates_path = ['_templates'] +templates_path = ['../_templates'] # The suffix of source filenames. source_suffix = '.rst' From 6f8fed6d51c2c6a901ce9a7d2f5be4777ca9fbe4 Mon Sep 17 00:00:00 2001 From: y-p Date: Tue, 14 Jan 2014 22:18:45 +0200 Subject: [PATCH 4/4] DOC: disable running monkey patch example through ipython_directive Makes line numbering break in following documents run through sphinx. Very strange, --- doc/source/faq.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/source/faq.rst b/doc/source/faq.rst index c826d95e9c1d7..68f6e3d53cdca 100644 --- a/doc/source/faq.rst +++ b/doc/source/faq.rst @@ -81,7 +81,7 @@ life easier is missing. In that case you have several options: For example, here is an example of adding an ``just_foo_cols()`` method to the dataframe class: -.. ipython:: python +:: import pandas as pd def just_foo_cols(self):