Update docs to prevent most duplicate delcarations.

Use .. cpp:namespace:: to put each example in its own namespace.

documentation/Makefile

@@ -2,7 +2,7 @@
 #
 
 # You can set these variables from the command line.
-SPHINXOPTS    =
+SPHINXOPTS    = -vn
 SPHINXBUILD   = sphinx-build
 PAPER         =
 BUILDDIR     ?= build

documentation/source/autofile.rst

@@ -22,4 +22,3 @@ It produces this output:
 
 .. autodoxygenfile:: auto_class.h
    :project: auto
-   :no-link:

documentation/source/autoindex.rst

@@ -20,7 +20,8 @@ With the following config value::
 
 It produces this output:
 
+.. cpp:namespace:: @ex_autoindex
+
 .. autodoxygenindex::
    :project: auto
-   :no-link:
 

documentation/source/class.rst

@@ -43,6 +43,8 @@ specified class.
 Basic Example
 -------------
 
+.. cpp:namespace:: @ex_class_basic
+
 This displays the class documentation without any members:
 
 .. code-block:: rst
@@ -54,12 +56,13 @@ It produces this output:
 
 .. doxygenclass:: Nutshell
    :project: nutshell
-   :no-link:
 
 
 Template Specialisation Example
 -------------------------------
 
+.. cpp:namespace:: @ex_class_template_spec
+
 You can reference class template specialisations by include the specialisation
 in the name:
 
@@ -72,7 +75,6 @@ Produces this output:
 
 .. doxygenclass:: TemplateClass< T * >
    :project: template_specialisation
-   :no-link:
 
 Where as without the specialisation, the directive references the generic
 declaration:
@@ -86,12 +88,13 @@ Produces this output:
 
 .. doxygenclass:: TemplateClass
    :project: template_specialisation
-   :no-link:
 
 
 Members Example
 ---------------
 
+.. cpp:namespace:: @ex_class_members
+
 This directive call will display the class documentation with all the public
 members:
 
@@ -106,12 +109,13 @@ It produces this output:
 .. doxygenclass:: Nutshell
    :project: nutshell
    :members:
-   :no-link:
 
 
 Specific Members Example
 ------------------------
 
+.. cpp:namespace:: @ex_class_members_specific
+
 This displays the class documentation with only the members listed in the
 ``:members:`` option:
 
@@ -126,12 +130,13 @@ It produces this output:
 .. doxygenclass:: Nutshell
    :project: nutshell
    :members: crack, isCracked
-   :no-link:
 
 
 Protected Members
 -----------------
 
+.. cpp:namespace:: @ex_class_members_protected
+
 This displays only the protected members of the class. Normally this is combined
 with the ``:members:`` option to show the public members as well.
 
@@ -146,12 +151,13 @@ It produces this output:
 .. doxygenclass:: GroupedClassTest
    :project: group
    :protected-members:
-   :no-link:
 
 
 Private Members
 ---------------
 
+.. cpp:namespace:: @ex_class_members_private
+
 This displays only the private members of the class. Normally this is combined
 with the ``:members:`` option to show the public members as well.
 
@@ -166,11 +172,12 @@ It produces this output:
 .. doxygenclass:: Nutshell
    :project: nutshell
    :private-members:
-   :no-link:
 
 Undocumented Members
 --------------------
 
+.. cpp:namespace:: @ex_class_members_undocumented
+
 This displays the undocumented members of the class which are suppressed by
 default. Undocumented public members are only shown if the ``:members:`` option
 is also used. The same goes for the undocumented private members and the
@@ -191,7 +198,6 @@ It produces this output:
    :members:
    :private-members:
    :undoc-members:
-   :no-link:
 
 .. note::
 
@@ -201,6 +207,8 @@ It produces this output:
 Outline Example
 ---------------
 
+.. cpp:namespace:: @ex_class_outline
+
 This displays only the names of the class members and not their
 documentation. The ``:members:`` and ``:private-members:`` options determine
 which members are displayed.
@@ -218,12 +226,13 @@ It produces this output:
    :project: nutshell
    :members:
    :outline:
-   :no-link:
 
 
 Qt Signals & Slots Example
 --------------------------
 
+.. cpp:namespace:: @ex_class_qt
+
 Doxygen is aware of Qt Signals and Slots and so Breathe can pick them up and
 display them in the output. They are displayed in appropriate ``Signals``,
 ``Public Slots``, ``Protected Slots`` and ``Private Slots`` sections.
@@ -239,11 +248,12 @@ Produces the following output:
 .. doxygenclass:: QtSignalSlotExample
    :project: qtsignalsandslots
    :members:
-   :no-link:
 
 Failing Example
 ---------------
 
+.. cpp:namespace:: @ex_class_failing
+
 This intentionally fails:
 
 .. code-block:: rst

documentation/source/domains.rst

@@ -15,6 +15,8 @@ The following targets are supported:
 Class Example
 -------------
 
+.. cpp:namespace:: @ex_domains_class
+
 Given the following Breathe directives::
 
    .. doxygenclass:: testnamespace::NamespacedClassTest
@@ -38,6 +40,8 @@ which renders as: :cpp:class:`another reference <testnamespace::NamespacedClassT
 Inner Class Example
 -------------------
 
+.. cpp:namespace:: @ex_domains_inner_class
+
 Given the following Breathe directive::
 
    .. doxygenclass:: OuterClass
@@ -59,6 +63,8 @@ which renders as :cpp:class:`OuterClass::InnerClass`.
 Function Examples
 -----------------
 
+.. cpp:namespace:: @ex_domains_function
+
 Given the following Breathe directives::
 
    .. doxygenfunction:: testnamespace::NamespacedClassTest::function
@@ -99,6 +105,8 @@ which renders as: :c:func:`another reference <frob_foos()>`. Note the use of the
 Typedef Examples
 ----------------
 
+.. cpp:namespace:: @ex_domains_typedef
+
 Given the following Breathe directives::
 
    .. doxygentypedef:: TestTypedef
@@ -140,6 +148,8 @@ which renders as :cpp:type:`TestClass::MemberTypedef`.
 Enum Value Examples
 -------------------
 
+.. cpp:namespace:: @ex_domains_enum
+
 Given the following Breathe directives::
 
    .. doxygenenumvalue:: VALUE