adding individual troubleshooting blocks for caches

Author: ceb8

docs/atomic/atomic.rst

@@ -40,6 +40,20 @@ the atomic package takes care to support all spectral units.
           199.0122     C IV   E1 ... 1/2-* 157000000.0 0.00 -   502481.80
 
 
+Troubleshooting
+===============
+
+If you are repeatedly getting failed queries, or bad/out-of-date results, try clearing your cache:
+
+.. code-block:: python
+
+    >>> from astroquery.atomic import AtomicLineList
+    >>> AtomicLineList.clear_cache()
+
+If this function is unavailable, upgrade your version of astroquery. 
+The `clear_cache` function was introduced in version 0.4.7.dev8479.
+
+
 Reference/API
 =============
 

docs/casda/casda.rst

@@ -194,6 +194,21 @@ is shown below:
     >>> filelist = casda.download_files(url_list, savedir='/tmp')
 
 
+Troubleshooting
+===============
+
+If you are repeatedly getting failed queries, or bad/out-of-date results, try clearing your cache:
+
+.. code-block:: python
+
+    >>> from astroquery.casda import Casda
+    >>> Casda.clear_cache()
+
+If this function is unavailable, upgrade your version of astroquery. 
+The `clear_cache` function was introduced in version 0.4.7.dev8479.
+
+
+
 Reference/API
 =============
 

docs/dace/dace.rst

@@ -31,6 +31,20 @@ If you need to get radial velocities data for an object you can do the following
     Length = 600 rows
 
 
+Troubleshooting
+===============
+
+If you are repeatedly getting failed queries, or bad/out-of-date results, try clearing your cache:
+
+.. code-block:: python
+
+    >>> from astroquery.dace import Dace
+    >>> Dace.clear_cache()
+
+If this function is unavailable, upgrade your version of astroquery. 
+The `clear_cache` function was introduced in version 0.4.7.dev8479.
+
+
 Reference/API
 =============
 

docs/esa/hsa/hsa.rst

@@ -238,6 +238,20 @@ After obtaining the desire ID, download the product of the observation '13422050
   '1342205057.tar'
 
 
+Troubleshooting
+===============
+
+If you are repeatedly getting failed queries, or bad/out-of-date results, try clearing your cache:
+
+.. code-block:: python
+
+    >>> from astroquery.esa.hsa import HSA
+    >>> HSA.clear_cache()
+
+If this function is unavailable, upgrade your version of astroquery. 
+The `clear_cache` function was introduced in version 0.4.7.dev8479.
+
+  
 Reference/API
 =============
 

docs/esa/iso/iso.rst

@@ -399,6 +399,20 @@ And spectra can be displayed by using the following code:
    :alt: Dynamic exploration of ISO spectra in python
 
 
+Troubleshooting
+===============
+
+If you are repeatedly getting failed queries, or bad/out-of-date results, try clearing your cache:
+
+.. code-block:: python
+
+    >>> from astroquery.esa.iso import ISO
+    >>> ISO.clear_cache()
+
+If this function is unavailable, upgrade your version of astroquery. 
+The `clear_cache` function was introduced in version 0.4.7.dev8479.
+
+
 Reference/API
 =============
 

docs/esa/xmm_newton/xmm_newton.rst

@@ -194,6 +194,21 @@ The EPIC metadata can be found in four tables in the XSA TAP:
 
 This will return the metadata within the four TAP tables in four `~astropy.table.Table` for the given target.
 
+
+Troubleshooting
+===============
+
+If you are repeatedly getting failed queries, or bad/out-of-date results, try clearing your cache:
+
+.. code-block:: python
+
+    >>> from astroquery.esa.xmm_newton import XMMNewton
+    >>> XMMNewton.clear_cache()
+
+If this function is unavailable, upgrade your version of astroquery. 
+The `clear_cache` function was introduced in version 0.4.7.dev8479.
+
+
 Reference/API
 =============
 

docs/eso/eso.rst

@@ -383,6 +383,20 @@ To force the retrieval of data that are present in the destination directory, us
 in the call to :meth:`~astroquery.eso.EsoClass.retrieve_data`.
 
 
+Troubleshooting
+===============
+
+If you are repeatedly getting failed queries, or bad/out-of-date results, try clearing your cache:
+
+.. code-block:: python
+
+    >>> from astroquery.eso import Eso
+    >>> Eso.clear_cache()
+
+If this function is unavailable, upgrade your version of astroquery. 
+The `clear_cache` function was introduced in version 0.4.7.dev8479.
+
+
 Reference/API
 =============
 

docs/fermi/fermi.rst

@@ -10,14 +10,27 @@ centered on M 31 for the energy range 1 to 100 GeV for the first day in 2013.
 
 .. doctest-remote-data::
 
-    >>> from astroquery import fermi
-    >>> result = fermi.FermiLAT.query_object('M31', energyrange_MeV='1000, 100000',
+    >>> from astroquery.fermi import FermiLAT
+    >>> result = FermiLAT.query_object('M31', energyrange_MeV='1000, 100000',
     ...                                      obsdates='2013-01-01 00:00:00, 2013-01-02 00:00:00')
     >>> print(result)  # doctest: +IGNORE_OUTPUT
     ['https://fermi.gsfc.nasa.gov/FTP/fermi/data/lat/queries/L210111120827756AAA3A88_PH00.fits',
     'https://fermi.gsfc.nasa.gov/FTP/fermi/data/lat/queries/L210111120827756AAA3A88_SC00.fits']
 
 
+Troubleshooting
+===============
+
+If you are repeatedly getting failed queries, or bad/out-of-date results, try clearing your cache:
+
+.. code-block:: python
+
+    >>> from astroquery.fermi import FermiLAT
+    >>> FermiLAT.clear_cache()
+
+If this function is unavailable, upgrade your version of astroquery. 
+The `clear_cache` function was introduced in version 0.4.7.dev8479.
+
 
 Reference/API
 =============

docs/gama/gama.rst

@@ -50,6 +50,21 @@ first 100 spectroscopic objects in the database:
     1031448324500121600   SDSS           1 212.70039 ... 0.05        0       0
     Length = 100 rows
 
+
+Troubleshooting
+===============
+
+If you are repeatedly getting failed queries, or bad/out-of-date results, try clearing your cache:
+
+.. code-block:: python
+
+    >>> from astroquery.gama import GAMA
+    >>> GAMA.clear_cache()
+
+If this function is unavailable, upgrade your version of astroquery. 
+The `clear_cache` function was introduced in version 0.4.7.dev8479.
+
+    
 Reference/API
 =============
 

docs/heasarc/heasarc.rst

@@ -284,6 +284,20 @@ tables listing the most recent INTEGRAL data.
     Length = 1601 rows
 
 
+Troubleshooting
+===============
+
+If you are repeatedly getting failed queries, or bad/out-of-date results, try clearing your cache:
+
+.. code-block:: python
+
+    >>> from astroquery.heasarc import Heasarc
+    >>> Heasarc.clear_cache()
+
+If this function is unavailable, upgrade your version of astroquery. 
+The `clear_cache` function was introduced in version 0.4.7.dev8479.
+
+
 Reference/API
 =============