ENH: pandas read_* wildcard pandas-dev#15904

Author: dwkenefick

doc/source/cookbook.rst

@@ -946,7 +946,7 @@ Reading multiple files to create a single DataFrame
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The best way to combine multiple files into a single DataFrame is to read the individual frames one by one, put all
-of the individual frames into a list, and then combine the frames in the list using ``pd.concat``:
+of the individual frames into a list, and then combine the frames in the list using :func:`pd.concat`:
 
 .. ipython:: python
 
@@ -956,22 +956,18 @@ of the individual frames into a list, and then combine the frames in the list us
 
     frames = []
     files = ['file_0.csv', 'file_1.csv', 'file_2.csv']
-    for f in files:
-        frames.append(pd.read_csv(f))
-    result = pd.concat(frames)
+    result = pd.concat([pd.read_csv(f) for f in files], ignore_index=True)
 
 You can use the same approach to read all files matching a pattern.  Here is an example using ``glob``:
 
 .. ipython:: python
 
     import glob
     frames = []
-    for f in glob.glob('file_*.csv'):
-       frames.append(pd.read_csv(f))
-    result = pd.concat(frames)
+    files = glob.glob('file_*.csv')
+    result = pd.concat([pd.read_csv(f) for f in files], ignore_index=True)
 
-This performs significantly better than using ``pd.append`` to add each of the files to an existing DataFrame.
-Finally, this strategy will work with the other ``read_`` functions described in the :ref:`io docs<io>`.
+Finally, this strategy will work with the other ``read_*(...)`` functions described in the :ref:`io docs<io>`.
 
 .. ipython:: python
     :supress:

doc/source/io.rst

@@ -1444,7 +1444,7 @@ class of the csv module. For this, you have to specify ``sep=None``.
 Reading multiple files to create a single DataFrame
 '''''''''''''''''''''''''''''''''''''''''''''''''''
 
-It's best to use ``pd.concat`` to combine multiple files, rather than ``pd.append``.
+It's best to use :func:`~pandas.concat` to combine multiple files.
 See the :ref:`cookbook<cookbook.csv.multiple_files>` for an example.
 
 .. _io.chunking: