pandas-dev · TomAugspurger · Mar 12, 2018 · Mar 10, 2018 · Mar 10, 2018 · Mar 11, 2018
diff --git a/doc/source/savefig/andrews_curve_winter.png b/doc/source/savefig/andrews_curve_winter.png
diff --git a/doc/source/savefig/andrews_curves.png b/doc/source/savefig/andrews_curves.png
diff --git a/doc/source/savefig/area_plot_stacked.png b/doc/source/savefig/area_plot_stacked.png
diff --git a/doc/source/savefig/area_plot_unstacked.png b/doc/source/savefig/area_plot_unstacked.png
diff --git a/doc/source/savefig/autocorrelation_plot.png b/doc/source/savefig/autocorrelation_plot.png
diff --git a/doc/source/savefig/bar_plot_ex.png b/doc/source/savefig/bar_plot_ex.png
diff --git a/doc/source/savefig/bar_plot_multi_ex.png b/doc/source/savefig/bar_plot_multi_ex.png
diff --git a/doc/source/savefig/bar_plot_stacked_ex.png b/doc/source/savefig/bar_plot_stacked_ex.png
diff --git a/doc/source/savefig/barh_plot_stacked_ex.png b/doc/source/savefig/barh_plot_stacked_ex.png
diff --git a/doc/source/savefig/basics_assign.png b/doc/source/savefig/basics_assign.png
diff --git a/doc/source/savefig/bollinger.png b/doc/source/savefig/bollinger.png
diff --git a/doc/source/savefig/bootstrap_plot.png b/doc/source/savefig/bootstrap_plot.png
diff --git a/doc/source/savefig/box_new_colorize.png b/doc/source/savefig/box_new_colorize.png
diff --git a/doc/source/savefig/box_new_kwargs.png b/doc/source/savefig/box_new_kwargs.png
diff --git a/doc/source/savefig/box_plot_ex.png b/doc/source/savefig/box_plot_ex.png
diff --git a/doc/source/savefig/box_plot_ex2.png b/doc/source/savefig/box_plot_ex2.png
diff --git a/doc/source/savefig/box_plot_ex3.png b/doc/source/savefig/box_plot_ex3.png
diff --git a/doc/source/savefig/box_plot_new.png b/doc/source/savefig/box_plot_new.png
diff --git a/doc/source/savefig/boxplot_groupby.png b/doc/source/savefig/boxplot_groupby.png
diff --git a/doc/source/savefig/compare_interpolations.png b/doc/source/savefig/compare_interpolations.png
diff --git a/doc/source/savefig/cubehelix.png b/doc/source/savefig/cubehelix.png
diff --git a/doc/source/savefig/cubehelix_cm.png b/doc/source/savefig/cubehelix_cm.png
diff --git a/doc/source/savefig/df_pie_plot.png b/doc/source/savefig/df_pie_plot.png
diff --git a/doc/source/savefig/df_plot_xy.png b/doc/source/savefig/df_plot_xy.png
diff --git a/doc/source/savefig/errorbar_example.png b/doc/source/savefig/errorbar_example.png
diff --git a/doc/source/savefig/ewma_ex.png b/doc/source/savefig/ewma_ex.png
diff --git a/doc/source/savefig/expanding_mean_frame.png b/doc/source/savefig/expanding_mean_frame.png
diff --git a/doc/source/savefig/frame_hist_ex.png b/doc/source/savefig/frame_hist_ex.png
diff --git a/doc/source/savefig/frame_plot_basic.png b/doc/source/savefig/frame_plot_basic.png
diff --git a/doc/source/savefig/frame_plot_basic_noleg.png b/doc/source/savefig/frame_plot_basic_noleg.png
diff --git a/doc/source/savefig/frame_plot_secondary_y.png b/doc/source/savefig/frame_plot_secondary_y.png
diff --git a/doc/source/savefig/frame_plot_secondary_y_no_right.png b/doc/source/savefig/frame_plot_secondary_y_no_right.png
diff --git a/doc/source/savefig/frame_plot_subplots.png b/doc/source/savefig/frame_plot_subplots.png
diff --git a/doc/source/savefig/frame_plot_subplots_layout.png b/doc/source/savefig/frame_plot_subplots_layout.png
diff --git a/doc/source/savefig/frame_plot_subplots_multi_ax.png b/doc/source/savefig/frame_plot_subplots_multi_ax.png
diff --git a/doc/source/savefig/greens.png b/doc/source/savefig/greens.png
diff --git a/doc/source/savefig/groupby_boxplot.png b/doc/source/savefig/groupby_boxplot.png
diff --git a/doc/source/savefig/groupby_boxplot_vis.png b/doc/source/savefig/groupby_boxplot_vis.png
diff --git a/doc/source/savefig/groupby_transform_plot.png b/doc/source/savefig/groupby_transform_plot.png
diff --git a/doc/source/savefig/grouped_hist.png b/doc/source/savefig/grouped_hist.png
diff --git a/doc/source/savefig/hexbin_plot.png b/doc/source/savefig/hexbin_plot.png
diff --git a/doc/source/savefig/hexbin_plot_agg.png b/doc/source/savefig/hexbin_plot_agg.png
diff --git a/doc/source/savefig/hist_new.png b/doc/source/savefig/hist_new.png
diff --git a/doc/source/savefig/hist_new_kwargs.png b/doc/source/savefig/hist_new_kwargs.png
diff --git a/doc/source/savefig/hist_new_stacked.png b/doc/source/savefig/hist_new_stacked.png
diff --git a/doc/source/savefig/hist_plot_ex.png b/doc/source/savefig/hist_plot_ex.png
diff --git a/doc/source/savefig/kde_plot.png b/doc/source/savefig/kde_plot.png
diff --git a/doc/source/savefig/lag_plot.png b/doc/source/savefig/lag_plot.png
diff --git a/doc/source/savefig/line_plot_table_data.png b/doc/source/savefig/line_plot_table_data.png
diff --git a/doc/source/savefig/line_plot_table_describe.png b/doc/source/savefig/line_plot_table_describe.png
diff --git a/doc/source/savefig/line_plot_table_true.png b/doc/source/savefig/line_plot_table_true.png
diff --git a/doc/source/savefig/merge_on_index_and_column.png b/doc/source/savefig/merge_on_index_and_column.png
diff --git a/doc/source/savefig/merging_append1.png b/doc/source/savefig/merging_append1.png
diff --git a/doc/source/savefig/merging_append2.png b/doc/source/savefig/merging_append2.png
diff --git a/doc/source/savefig/merging_append3.png b/doc/source/savefig/merging_append3.png
diff --git a/doc/source/savefig/merging_append_dits.png b/doc/source/savefig/merging_append_dits.png
diff --git a/doc/source/savefig/merging_append_ignore_index.png b/doc/source/savefig/merging_append_ignore_index.png
diff --git a/doc/source/savefig/merging_append_series_as_row.png b/doc/source/savefig/merging_append_series_as_row.png
diff --git a/doc/source/savefig/merging_combine_first.png b/doc/source/savefig/merging_combine_first.png
diff --git a/doc/source/savefig/merging_concat_axis1.png b/doc/source/savefig/merging_concat_axis1.png
diff --git a/doc/source/savefig/merging_concat_axis1_inner.png b/doc/source/savefig/merging_concat_axis1_inner.png
diff --git a/doc/source/savefig/merging_concat_axis1_join_axes.png b/doc/source/savefig/merging_concat_axis1_join_axes.png
diff --git a/doc/source/savefig/merging_concat_basic.png b/doc/source/savefig/merging_concat_basic.png
diff --git a/doc/source/savefig/merging_concat_dict.png b/doc/source/savefig/merging_concat_dict.png
diff --git a/doc/source/savefig/merging_concat_dict_keys.png b/doc/source/savefig/merging_concat_dict_keys.png
diff --git a/doc/source/savefig/merging_concat_dict_keys_names.png b/doc/source/savefig/merging_concat_dict_keys_names.png
diff --git a/doc/source/savefig/merging_concat_group_keys2.png b/doc/source/savefig/merging_concat_group_keys2.png
diff --git a/doc/source/savefig/merging_concat_ignore_index.png b/doc/source/savefig/merging_concat_ignore_index.png
diff --git a/doc/source/savefig/merging_concat_keys.png b/doc/source/savefig/merging_concat_keys.png
diff --git a/doc/source/savefig/merging_concat_mixed_ndim.png b/doc/source/savefig/merging_concat_mixed_ndim.png
diff --git a/doc/source/savefig/merging_concat_series_ignore_index.png b/doc/source/savefig/merging_concat_series_ignore_index.png
diff --git a/doc/source/savefig/merging_concat_unnamed_series.png b/doc/source/savefig/merging_concat_unnamed_series.png
diff --git a/doc/source/savefig/merging_join.png b/doc/source/savefig/merging_join.png
diff --git a/doc/source/savefig/merging_join_inner.png b/doc/source/savefig/merging_join_inner.png
diff --git a/doc/source/savefig/merging_join_key_columns.png b/doc/source/savefig/merging_join_key_columns.png
diff --git a/doc/source/savefig/merging_join_multi_df.png b/doc/source/savefig/merging_join_multi_df.png
diff --git a/doc/source/savefig/merging_join_multiindex_inner.png b/doc/source/savefig/merging_join_multiindex_inner.png
diff --git a/doc/source/savefig/merging_join_multikeys.png b/doc/source/savefig/merging_join_multikeys.png
diff --git a/doc/source/savefig/merging_join_multikeys_inner.png b/doc/source/savefig/merging_join_multikeys_inner.png
diff --git a/doc/source/savefig/merging_join_outer.png b/doc/source/savefig/merging_join_outer.png
diff --git a/doc/source/savefig/merging_merge_index_inner.png b/doc/source/savefig/merging_merge_index_inner.png
diff --git a/doc/source/savefig/merging_merge_index_outer.png b/doc/source/savefig/merging_merge_index_outer.png
diff --git a/doc/source/savefig/merging_merge_key_columns.png b/doc/source/savefig/merging_merge_key_columns.png
diff --git a/doc/source/savefig/merging_merge_multiindex_alternative.png b/doc/source/savefig/merging_merge_multiindex_alternative.png
diff --git a/doc/source/savefig/merging_merge_on_key.png b/doc/source/savefig/merging_merge_on_key.png
diff --git a/doc/source/savefig/merging_merge_on_key_dup.png b/doc/source/savefig/merging_merge_on_key_dup.png
diff --git a/doc/source/savefig/merging_merge_on_key_inner.png b/doc/source/savefig/merging_merge_on_key_inner.png
diff --git a/doc/source/savefig/merging_merge_on_key_left.png b/doc/source/savefig/merging_merge_on_key_left.png
diff --git a/doc/source/savefig/merging_merge_on_key_multiple.png b/doc/source/savefig/merging_merge_on_key_multiple.png
diff --git a/doc/source/savefig/merging_merge_on_key_outer.png b/doc/source/savefig/merging_merge_on_key_outer.png
diff --git a/doc/source/savefig/merging_merge_on_key_right.png b/doc/source/savefig/merging_merge_on_key_right.png
diff --git a/doc/source/savefig/merging_merge_overlapped.png b/doc/source/savefig/merging_merge_overlapped.png
diff --git a/doc/source/savefig/merging_merge_overlapped_multi_suffix.png b/doc/source/savefig/merging_merge_overlapped_multi_suffix.png
diff --git a/doc/source/savefig/merging_merge_overlapped_suffix.png b/doc/source/savefig/merging_merge_overlapped_suffix.png
diff --git a/doc/source/savefig/merging_merge_two_multiindex.png b/doc/source/savefig/merging_merge_two_multiindex.png
diff --git a/doc/source/savefig/merging_update.png b/doc/source/savefig/merging_update.png
diff --git a/doc/source/savefig/parallel_coordinates.png b/doc/source/savefig/parallel_coordinates.png
diff --git a/doc/source/savefig/parallel_gist_rainbow.png b/doc/source/savefig/parallel_gist_rainbow.png
diff --git a/doc/source/savefig/quartile_boxplot.png b/doc/source/savefig/quartile_boxplot.png
diff --git a/doc/source/savefig/radviz.png b/doc/source/savefig/radviz.png
diff --git a/doc/source/savefig/rolling_apply_ex.png b/doc/source/savefig/rolling_apply_ex.png
diff --git a/doc/source/savefig/rolling_corr_pairwise_ex.png b/doc/source/savefig/rolling_corr_pairwise_ex.png
diff --git a/doc/source/savefig/rolling_mean_ex.png b/doc/source/savefig/rolling_mean_ex.png
diff --git a/doc/source/savefig/rolling_mean_frame.png b/doc/source/savefig/rolling_mean_frame.png
diff --git a/doc/source/savefig/scatter_matrix_kde.png b/doc/source/savefig/scatter_matrix_kde.png
diff --git a/doc/source/savefig/scatter_plot.png b/doc/source/savefig/scatter_plot.png
diff --git a/doc/source/savefig/scatter_plot_bubble.png b/doc/source/savefig/scatter_plot_bubble.png
diff --git a/doc/source/savefig/scatter_plot_colored.png b/doc/source/savefig/scatter_plot_colored.png
diff --git a/doc/source/savefig/scatter_plot_repeated.png b/doc/source/savefig/scatter_plot_repeated.png
diff --git a/doc/source/savefig/ser_plot_suppress.png b/doc/source/savefig/ser_plot_suppress.png
diff --git a/doc/source/savefig/ser_plot_suppress_context.png b/doc/source/savefig/ser_plot_suppress_context.png
diff --git a/doc/source/savefig/ser_plot_suppress_parm.png b/doc/source/savefig/ser_plot_suppress_parm.png
diff --git a/doc/source/savefig/series_interpolate.png b/doc/source/savefig/series_interpolate.png
diff --git a/doc/source/savefig/series_pie_plot.png b/doc/source/savefig/series_pie_plot.png
diff --git a/doc/source/savefig/series_pie_plot_options.png b/doc/source/savefig/series_pie_plot_options.png
diff --git a/doc/source/savefig/series_pie_plot_semi.png b/doc/source/savefig/series_pie_plot_semi.png
diff --git a/doc/source/savefig/series_plot_basic.png b/doc/source/savefig/series_plot_basic.png
diff --git a/doc/source/savefig/series_plot_basic2.png b/doc/source/savefig/series_plot_basic2.png
diff --git a/doc/source/savefig/series_plot_logy.png b/doc/source/savefig/series_plot_logy.png
diff --git a/doc/source/savefig/series_plot_multi.png b/doc/source/savefig/series_plot_multi.png
diff --git a/doc/source/savefig/series_plot_secondary_y.png b/doc/source/savefig/series_plot_secondary_y.png
diff --git a/pandas/core/generic.py b/pandas/core/generic.py
@@ -7522,8 +7522,7 @@ def _add_numeric_operations(cls):
 
         cls.any = _make_logical_function(
             cls, 'any', name, name2, axis_descr,
-            'Return whether any element is True over requested axis',
-            nanops.nanany)
+            _any_desc, nanops.nanany, _any_examples, _any_also)
         cls.all = _make_logical_function(
             cls, 'all', name, name2, axis_descr,
             'Return whether all elements are True over requested axis',
@@ -7784,25 +7783,29 @@ def _doc_parms(cls):
 %(outname)s : %(name1)s or %(name2)s (if level specified)\n"""
 
 _bool_doc = """
-
 %(desc)s
 
 Parameters
 ----------
-axis : %(axis_descr)s
+axis : int, default 0
+    Select the axis which can be 0 for indices and 1 for columns.
 skipna : boolean, default True
     Exclude NA/null values. If an entire row/column is NA, the result
-    will be NA
+    will be NA.
 level : int or level name, default None
     If the axis is a MultiIndex (hierarchical), count along a
-    particular level, collapsing into a %(name1)s
+    particular level, collapsing into a %(name1)s.
 bool_only : boolean, default None
     Include only boolean columns. If None, will attempt to use everything,
     then use only boolean data. Not implemented for Series.
 
 Returns
 -------
-%(outname)s : %(name1)s or %(name2)s (if level specified)\n"""
+%(outname)s : %(name1)s or %(name2)s (if level specified)
+
+%(examples)s
+%(see_also)s
+"""
 
 _cnum_doc = """
 
@@ -7825,6 +7828,49 @@ def _doc_parms(cls):
 
 """
 
+_any_also = """\
+See Also
+--------
+pandas.DataFrame.all : Return whether all elements are True \
+over requested axis."""
+
+_any_desc = """\
+Return whether any element is True over requested axis.
+
+One dimensional pandas.Series having boolean values will be returned. \
+Unlike pandas.DataFrame.all, pandas.DataFrame.any performs OR operation; \
+in other word, if any of the values along the specified axis is True, \
+pandas.DataFrame.any will return True."""
+
+_any_examples = """\
+Examples
+--------
+By default, any from an empty DataFrame is empty Series::
+
+    >> pd.DataFrame([]).any()
+    Series([], dtype: bool)
+
+Non-boolean values will always give True::
+
+    >> pd.DataFrame({"A": [1, 2, 3], "B": [4, 5, 6]}).any()
+    A    True
+    B    True
+    dtype: bool
+
+It is performing OR along the specified axis::
+
+    >> pd.DataFrame({"A": [1, False, 3], "B": [4, 5, 6]}).any(axis=1)
+    0    True
+    1    True
+    2    True
+    dtype: bool
+
+    >> pd.DataFrame({"A": [1, False, 3], "B": [4, False, 6]}).any(axis=1)
+    0    True
+    1    False
+    2    True
+    dtype: bool
+"""
 
 _sum_examples = """\
 Examples
@@ -7985,9 +8031,11 @@ def cum_func(self, axis=None, skipna=True, *args, **kwargs):
     return set_function_name(cum_func, name, cls)
 
 
-def _make_logical_function(cls, name, name1, name2, axis_descr, desc, f):
+def _make_logical_function(cls, name, name1, name2, axis_descr, desc, f,
+                           examples='', see_also=''):
+
     @Substitution(outname=name, desc=desc, name1=name1, name2=name2,
-                  axis_descr=axis_descr)
+                  axis_descr=axis_descr, examples=examples, see_also=see_also)
     @Appender(_bool_doc)
     def logical_func(self, axis=None, bool_only=None, skipna=None, level=None,
                      **kwargs):

diff --git a/pandas/core/groupby.py b/pandas/core/groupby.py
@@ -1245,7 +1245,8 @@ def result_to_bool(result):
     @Substitution(name='groupby')
     @Appender(_doc_template)
     def any(self, skipna=True):
-        """Returns True if any value in the group is truthful, else False
+        """
+        Returns True if any value in the group is truthful, else False
 
         Parameters
         ----------