Keep original gotchas label for references

Author: jorisvandenbossche

doc/source/10min.rst

@@ -810,4 +810,4 @@ If you are trying an operation and you see an exception like:
 
 See :ref:`Comparisons<basics.compare>` for an explanation and what to do.
 
-See :ref:`FAQ<faq>` as well.
+See :ref:`Gotchas<gotchas>` as well.

doc/source/basics.rst

@@ -313,7 +313,7 @@ To evaluate single-element pandas objects in a boolean context, use the method
 
        ValueError: The truth value of an array is ambiguous. Use a.empty, a.any() or a.all().
 
-See :ref:`FAQ<faq.truth>` for a more detailed discussion.
+See :ref:`gotchas<gotchas.truth>` for a more detailed discussion.
 
 .. _basics.equals:
 
@@ -1889,7 +1889,7 @@ gotchas
 
 Performing selection operations on ``integer`` type data can easily upcast the data to ``floating``.
 The dtype of the input data will be preserved in cases where ``nans`` are not introduced (starting in 0.11.0)
-See also :ref:`Support for integer ``NA`` <faq.intna>`
+See also :ref:`Support for integer ``NA`` <gotchas.intna>`
 
 .. ipython:: python
 

doc/source/gotchas.rst

@@ -1,5 +1,5 @@
 .. currentmodule:: pandas
-.. _faq:
+.. _gotchas:
 
 ********************************
 Frequently Asked Questions (FAQ)
@@ -88,7 +88,7 @@ representation; i.e., 1KB = 1024 bytes).
 
 See also :ref:`Categorical Memory Usage <categorical.memory>`.
 
-.. _faq.truth:
+.. _gotchas.truth:
 
 Using If/Truth Statements with pandas
 -------------------------------------
@@ -208,7 +208,7 @@ detect NA values.
 However, it comes with it a couple of trade-offs which I most certainly have
 not ignored.
 
-.. _faq.intna:
+.. _gotchas.intna:
 
 Support for integer ``NA``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -308,7 +308,7 @@ where the data copying occurs.
 See `this link <http://stackoverflow.com/questions/13592618/python-pandas-dataframe-thread-safe>`__
 for more information.
 
-.. _faq.html:
+.. _gotchas.html:
 
 HTML Table Parsing
 ------------------

doc/source/install.rst

@@ -294,16 +294,12 @@ Optional Dependencies
        `lxml`_ or `html5lib`_ or both.
        :func:`~pandas.read_html` will **not** work with *only*
        `BeautifulSoup4`_ installed.
-     * You are highly encouraged to read :ref:`HTML Table Parsing <faq.html>`.
+     * You are highly encouraged to read :ref:`HTML Table Parsing gotchas <gotchas.html>`.
        It explains issues surrounding the installation and
        usage of the above three libraries.
-       Additionally, if you're using `Anaconda`_ you should definitely
-       read.
      * You may need to install an older version of `BeautifulSoup4`_:
        Versions 4.2.1, 4.1.3 and 4.0.2 have been confirmed for 64 and 32-bit
        Ubuntu/Debian
-     * Additionally, if you're using `Anaconda`_ you should definitely
-       read :ref:`the gotchas about HTML parsing libraries <html-gotchas>`
 
   .. note::
 
@@ -320,7 +316,6 @@ Optional Dependencies
 .. _html5lib: https://github.com/html5lib/html5lib-python
 .. _BeautifulSoup4: http://www.crummy.com/software/BeautifulSoup
 .. _lxml: http://lxml.de
-.. _Anaconda: https://store.continuum.io/cshop/anaconda
 
 .. note::
 

doc/source/io.rst

@@ -2043,7 +2043,7 @@ Reading HTML Content
 
 .. warning::
 
-   We **highly encourage** you to read the :ref:`HTML Table Parsing<faq.html>`
+   We **highly encourage** you to read the :ref:`HTML Table Parsing gotchas<gotchas.html>`
    regarding the issues surrounding the BeautifulSoup4/html5lib/lxml parsers.
 
 .. versionadded:: 0.12.0

doc/source/whatsnew/v0.13.0.txt

@@ -111,7 +111,7 @@ API changes
 
 - Infer and downcast dtype if ``downcast='infer'`` is passed to ``fillna/ffill/bfill`` (:issue:`4604`)
 - ``__nonzero__`` for all NDFrame objects, will now raise a ``ValueError``, this reverts back to (:issue:`1073`, :issue:`4633`)
-  behavior. See :ref:`FAQ<faq.truth>` for a more detailed discussion.
+  behavior. See :ref:`gotchas<gotchas.truth>` for a more detailed discussion.
 
   This prevents doing boolean comparison on *entire* pandas objects, which is inherently ambiguous. These all will raise a ``ValueError``.
 

doc/source/whatsnew/v0.15.0.txt

@@ -864,7 +864,7 @@ a transparent change with only very limited API implications (:issue:`5080`, :is
 
 - you may need to unpickle pandas version < 0.15.0 pickles using ``pd.read_pickle`` rather than ``pickle.load``. See :ref:`pickle docs <io.pickle>`
 - when plotting with a ``PeriodIndex``, the matplotlib internal axes will now be arrays of ``Period`` rather than a ``PeriodIndex`` (this is similar to how a ``DatetimeIndex`` passes arrays of ``datetimes`` now)
-- MultiIndexes will now raise similary to other pandas objects w.r.t. truth testing, see :ref:`here <faq.truth>` (:issue:`7897`).
+- MultiIndexes will now raise similary to other pandas objects w.r.t. truth testing, see :ref:`here <gotchas.truth>` (:issue:`7897`).
 - When plotting a DatetimeIndex directly with matplotlib's `plot` function,
   the axis labels will no longer be formatted as dates but as integers (the
   internal representation of a ``datetime64``). **UPDATE** This is fixed