From f785b8b333f1fa141fc635ef4f4977235d727459 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Michael=20Vo=C5=99=C3=AD=C5=A1ek?= <mvorisek@mvorisek.cz>
Date: Fri, 18 Aug 2023 03:54:23 +0200
Subject: [PATCH] Fix references resolving (#60)

* Fix resolve for absolute reference names
* move test/unit to test
* move test/must-build to test
* push changes to forks and only once per workflow
* assert log using CI
* fix method/property render /w explicit class name
* remove dead code and prevent NS refetch
* improve comments
* refactor "modname" to "namespace"
* refactor remaining module mentions
* remove dead code
* reserved names are never resolved using NS
* "global" is for global variables only
* stricter identifier matching in signature
* improve separators def
* log unable to parse signature
* always resolve refs using namespace, never fallback to global
* Enforce Coding Style using Black
* "numeric" type is not reserved keyword
* add mvorisek as coauthor
* test warnings and non-zero exit code
* fix ref type mismatch
* fix .gitignore

---------

Co-authored-by: Mark Story <mark@mark-story.com>
---
 .github/workflows/ci.yml                      |   68 +-
 .gitignore                                    |    3 +-
 README.rst                                    |    1 +
 doc/conf.py                                   |  129 +-
 setup.py                                      |   32 +-
 sphinxcontrib/__init__.py                     |    3 +-
 sphinxcontrib/phpdomain.py                    |  914 ++++---
 test/{must-build => }/Makefile                |    0
 test/conf.py                                  |   17 +
 test/{unit => }/index.md                      |    0
 test/log.html                                 |   61 +
 test/log.md                                   |   25 +
 test/log.txt                                  |   13 +
 test/{must-build => }/make.bat                |    0
 test/{unit => }/method.html                   |    0
 test/{unit => }/method.md                     |    0
 test/must-build/conf.py                       |  210 --
 test/ns.html                                  |  171 ++
 test/ns.md                                    |   53 +
 test/{unit => }/requirements.txt              |    0
 test/rst_doc.html                             | 2201 +++++++++++++++++
 test/{must-build/test_doc.rst => rst_doc.md}  |  138 +-
 test/rst_doc2.html                            |  100 +
 .../{must-build/test_doc2.rst => rst_doc2.md} |   19 +-
 test/rst_index.html                           |  110 +
 test/{must-build/index.rst => rst_index.md}   |    9 +-
 test/rst_nesting_regression.html              |   68 +
 ...gression.rst => rst_nesting_regression.md} |    2 +
 test/unit/Makefile                            |  130 -
 test/unit/conf.py                             |   17 -
 test/unit/make.bat                            |  155 --
 test/unit/ns.html                             |   51 -
 test/unit/ns.md                               |   14 -
 33 files changed, 3535 insertions(+), 1179 deletions(-)
 rename test/{must-build => }/Makefile (100%)
 create mode 100644 test/conf.py
 rename test/{unit => }/index.md (100%)
 create mode 100644 test/log.html
 create mode 100644 test/log.md
 create mode 100644 test/log.txt
 rename test/{must-build => }/make.bat (100%)
 rename test/{unit => }/method.html (100%)
 rename test/{unit => }/method.md (100%)
 delete mode 100644 test/must-build/conf.py
 create mode 100644 test/ns.html
 create mode 100644 test/ns.md
 rename test/{unit => }/requirements.txt (100%)
 create mode 100644 test/rst_doc.html
 rename test/{must-build/test_doc.rst => rst_doc.md} (76%)
 create mode 100644 test/rst_doc2.html
 rename test/{must-build/test_doc2.rst => rst_doc2.md} (60%)
 create mode 100644 test/rst_index.html
 rename test/{must-build/index.rst => rst_index.md} (80%)
 create mode 100644 test/rst_nesting_regression.html
 rename test/{must-build/test_nesting_regression.rst => rst_nesting_regression.md} (96%)
 delete mode 100644 test/unit/Makefile
 delete mode 100644 test/unit/conf.py
 delete mode 100644 test/unit/make.bat
 delete mode 100644 test/unit/ns.html
 delete mode 100644 test/unit/ns.md

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 3c603587..f4c715e1 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -33,46 +33,66 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         pip install -r requirements.txt
-        pip install -r test/unit/requirements.txt
+        pip install -r test/requirements.txt
         pip install .
 
-    - name: Build Test
+    - name: Build Unit Tests
       run: |
-        cd test/must-build && make html SPHINXOPTS='-W'
+        cd test
+        find . -name '*.html' -exec rm {} \;
 
-    - name: Build Test with toc show_parents=hide
-      run: |
-        cd test/must-build && make html SPHINXOPTS='-W -D toc_object_entries_show_parents=hide'
+        sed -i 's~, "log\.md"~~' conf.py
+        make html SPHINXOPTS='' 2>&1 | tee log.txt
+        git restore conf.py
 
-    - name: Build Test with toc show_parents=domain
-      run: |
-        cd test/must-build && make html SPHINXOPTS='-W -D toc_object_entries_show_parents=domain'
-
-    - name: Build Test with toc show_parents=all
-      run: |
-        cd test/must-build && make html SPHINXOPTS='-W -D toc_object_entries_show_parents=all'
+        (cd _build/html && rm genindex.html index.html search.html php-modindex.html)
+        (cd _build/html && find . -name '*.html' -exec sh -c 'xmllint {} --xpath '"'"'//div[@role="main"]'"'"' | xmllint --format - > ../../{}' \;)
+        sed -i -r 's~.*/(test/)~\1~;t;d' log.txt
 
-    - name: Run Unit Testing
+    - name: Apply Coding Style
+      if: matrix.python == '3.11'
       run: |
-        cd test/unit
-        find . -name '*.html' -exec rm {} \;
-        make html SPHINXOPTS='-W'
-        (cd _build/html && find . -name '*.html' -exec sh -c 'xmllint {} --xpath '"'"'//div[@role="main"]'"'"' | xmllint --format - > ../../{}' \;)
-        rm genindex.html index.html search.html php-modindex.html
+        pip install black
+        python -m black .
 
-    - name: Diff Unit Outputs
+    - name: Diff Unit Tests Output and Coding Style
       run: |
-        cd test/unit
+        cd test
         rm -r _build
         git add . -N && git diff --exit-code
 
-    - name: Push Unit Changes
-      if: failure()
+    - name: Push Unit Tests Output
+      if: failure() && github.repository_owner != 'markstory' && matrix.python == '3.11'
       uses: stefanzweifel/git-auto-commit-action@v4
       with:
         branch: ${{ github.head_ref || github.ref_name }}.changes
+        create_branch: true
         push_options: '--force'
-        commit_message: Unit Changes
+        commit_message: Unit Tests Changes
         commit_user_name: Bot
         commit_user_email: bot@example.com
         commit_author: Bot <bot@example.com>
+
+    - name: Build Unit Tests with '-W' option
+      run: |
+        cd test
+        make html SPHINXOPTS='-W'
+
+        sed -i 's~, "log\.md"~~' conf.py
+        ! make html SPHINXOPTS='-W' || (echo 'Unexpected zero exit code'; false)
+        git restore conf.py
+
+    - name: Build Unit Tests with toc show_parents=hide
+      run: |
+        cd test
+        make html SPHINXOPTS='-W -D toc_object_entries_show_parents=hide'
+
+    - name: Build Unit Tests with toc show_parents=domain
+      run: |
+        cd test
+        make html SPHINXOPTS='-W -D toc_object_entries_show_parents=domain'
+
+    - name: Build Unit Tests with toc show_parents=all
+      run: |
+        cd test
+        make html SPHINXOPTS='-W -D toc_object_entries_show_parents=all'
diff --git a/.gitignore b/.gitignore
index 508e0cc1..c28a058b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,8 +1,7 @@
 dist/
 build/
 doc/_build
-test/must-build/_build
-test/unit/_build
+test/_build
 *.pyc
 *.egg-info
 .DS_Store
diff --git a/README.rst b/README.rst
index c197aa99..9407f786 100644
--- a/README.rst
+++ b/README.rst
@@ -2,6 +2,7 @@ PHP Domain for Sphinx
 #####################
 
 :author: Mark Story <mark at mark-story.com>
+:author: Michael Voříšek
 
 About
 =====
diff --git a/doc/conf.py b/doc/conf.py
index 39131ca1..21e646aa 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -1,203 +1,195 @@
-# -*- coding: utf-8 -*-
-#
-# sphinxcontrib-rubydomain-acceptancetest documentation build configuration file, created by
-# sphinx-quickstart on Sun Apr 25 13:27:18 2010.
-#
-# This file is execfile()d with the current directory set to its containing dir.
-#
-# Note that not all possible configuration values are present in this
-# autogenerated file.
-#
-# All configuration values have a default; values that are commented out
-# serve to show the default.
-
 import sys, os
 
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
-sys.path.append(os.path.abspath('..'))
+sys.path.append(os.path.abspath(".."))
 
 # -- General configuration -----------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.
-needs_sphinx = '1.0'
+needs_sphinx = "1.0"
 
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ['sphinxcontrib.phpdomain']
+extensions = ["sphinxcontrib.phpdomain"]
 
 # Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
+templates_path = ["_templates"]
 
 # The suffix of source filenames.
-source_suffix = '.rst'
+source_suffix = ".rst"
 
 # The encoding of source files.
-#source_encoding = 'utf-8-sig'
+# source_encoding = 'utf-8-sig'
 
 # The master toctree document.
-master_doc = 'index'
+master_doc = "index"
 
 # General information about the project.
-project = u'sphinxcontrib-phpdomain'
-copyright = u'2011, Mark Story'
+project = "sphinxcontrib-phpdomain"
+copyright = "2011 - 2023, Mark Story and Michael Voříšek"
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 # The short X.Y version.
-version = '0.1'
+version = "0.1"
 # The full version, including alpha/beta/rc tags.
-release = '0.1'
+release = "0.1"
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
-#language = None
+# language = None
 
 # There are two options for replacing |today|: either, you set today to some
 # non-false value, then it is used:
-#today = ''
+# today = ''
 # Else, today_fmt is used as the format for a strftime call.
-#today_fmt = '%B %d, %Y'
+# today_fmt = '%B %d, %Y'
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
-exclude_patterns = ['_build']
+exclude_patterns = ["_build"]
 
 # The reST default role (used for this markup: `text`) to use for all documents.
-#default_role = None
+# default_role = None
 
 # If true, '()' will be appended to :func: etc. cross-reference text.
-#add_function_parentheses = True
+# add_function_parentheses = True
 
 # If true, the current module name will be prepended to all description
 # unit titles (such as .. function::).
-#add_module_names = True
+# add_module_names = True
 
 # If true, sectionauthor and moduleauthor directives will be shown in the
 # output. They are ignored by default.
-#show_authors = False
+# show_authors = False
 
 # The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'sphinx'
+pygments_style = "sphinx"
 
 # A list of ignored prefixes for module index sorting.
-#modindex_common_prefix = []
+# modindex_common_prefix = []
 
 
 # -- Options for HTML output ---------------------------------------------------
 
 # The theme to use for HTML and HTML Help pages.  Major themes that come with
 # Sphinx are currently 'default' and 'sphinxdoc'.
-html_theme = 'sphinxdoc'
+html_theme = "sphinxdoc"
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
-#html_theme_options = {}
+# html_theme_options = {}
 
 # Add any paths that contain custom themes here, relative to this directory.
-#html_theme_path = []
+# html_theme_path = []
 
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".
-#html_title = None
+# html_title = None
 
 # A shorter title for the navigation bar.  Default is the same as html_title.
-#html_short_title = None
+# html_short_title = None
 
 # The name of an image file (relative to this directory) to place at the top
 # of the sidebar.
-#html_logo = None
+# html_logo = None
 
 # The name of an image file (within the static path) to use as favicon of the
 # docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
 # pixels large.
-#html_favicon = None
+# html_favicon = None
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-#html_static_path = ['_static']
+# html_static_path = ['_static']
 
 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
 # using the given strftime format.
-#html_last_updated_fmt = '%b %d, %Y'
+# html_last_updated_fmt = '%b %d, %Y'
 
 # If true, SmartyPants will be used to convert quotes and dashes to
 # typographically correct entities.
-#html_use_smartypants = True
+# html_use_smartypants = True
 
 # Custom sidebar templates, maps document names to template names.
-#html_sidebars = {}
+# html_sidebars = {}
 
 # Additional templates that should be rendered to pages, maps page names to
 # template names.
-#html_additional_pages = {}
+# html_additional_pages = {}
 
 # If false, no module index is generated.
-#html_domain_indices = True
+# html_domain_indices = True
 
 # If false, no index is generated.
-#html_use_index = True
+# html_use_index = True
 
 # If true, the index is split into individual pages for each letter.
-#html_split_index = False
+# html_split_index = False
 
 # If true, links to the reST sources are added to the pages.
-#html_show_sourcelink = True
+# html_show_sourcelink = True
 
 # If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
-#html_show_sphinx = True
+# html_show_sphinx = True
 
 # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
-#html_show_copyright = True
+# html_show_copyright = True
 
 # If true, an OpenSearch description file will be output, and all pages will
 # contain a <link> tag referring to it.  The value of this option must be the
 # base URL from which the finished HTML is served.
-#html_use_opensearch = ''
+# html_use_opensearch = ''
 
 # If nonempty, this is the file name suffix for HTML files (e.g. ".xhtml").
-#html_file_suffix = ''
+# html_file_suffix = ''
 
 # Output file base name for HTML help builder.
-htmlhelp_basename = 'sphinxcontrib-phpdomain'
+htmlhelp_basename = "sphinxcontrib-phpdomain"
 
 
 # -- Options for LaTeX output --------------------------------------------------
 
 # The paper size ('letter' or 'a4').
-#latex_paper_size = 'letter'
+# latex_paper_size = 'letter'
 
 # The font size ('10pt', '11pt' or '12pt').
-#latex_font_size = '10pt'
+# latex_font_size = '10pt'
 
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title, author, documentclass [howto/manual]).
 latex_documents = [
-  ('index', 'sphinxcontrib-phpdomain.tex', u'sphinxcontrib-phpdomain Documentation',
-   u'Mark Story', 'manual'),
+    (
+        "index",
+        "sphinxcontrib-phpdomain.tex",
+        "sphinxcontrib-phpdomain Documentation",
+        "Mark Story and Michael Voříšek",
+        "manual",
+    ),
 ]
 
 # The name of an image file (relative to this directory) to place at the top of
 # the title page.
-#latex_logo = None
+# latex_logo = None
 
 # For "manual" documents, if this is true, then toplevel headings are parts,
 # not chapters.
-#latex_use_parts = False
+# latex_use_parts = False
 
 # Additional stuff for the LaTeX preamble.
-#latex_preamble = ''
+# latex_preamble = ''
 
 # Documents to append as an appendix to all manuals.
-#latex_appendices = []
+# latex_appendices = []
 
 # If false, no module index is generated.
-#latex_domain_indices = True
+# latex_domain_indices = True
 
 
 # -- Options for manual page output --------------------------------------------
@@ -205,6 +197,11 @@
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
 man_pages = [
-    ('index', 'sphinxcontrib-phpdomain', u'sphinxcontrib-phpdomain Documentation',
-     [u'Mark Story'], 1)
+    (
+        "index",
+        "sphinxcontrib-phpdomain",
+        "sphinxcontrib-phpdomain Documentation",
+        ["Mark Story and Michael Voříšek"],
+        1,
+    )
 ]
diff --git a/setup.py b/setup.py
index 081c95e3..e6039e2b 100644
--- a/setup.py
+++ b/setup.py
@@ -1,12 +1,10 @@
-# -*- coding: utf-8 -*-
 import os
 from setuptools import setup, find_packages
 
-with open(os.path.join(os.path.dirname(__file__),
-                       'requirements.txt'), 'r') as f:
+with open(os.path.join(os.path.dirname(__file__), "requirements.txt"), "r") as f:
     requirements = f.read()
 
-long_desc = '''
+long_desc = """
 This package provides a Sphinx extension for documenting PHP projects.
 
 PHP Domain supports following objects:
@@ -27,7 +25,7 @@
     * Properties
 
 * Enums
-'''
+"""
 
 setup(
     name='sphinxcontrib-phpdomain',
@@ -40,22 +38,22 @@
     description='Sphinx extension to enable documenting PHP code',
     long_description=long_desc,
     project_urls={
-        'Documentation': 'https://markstory.github.io/sphinxcontrib-phpdomain/',
+        "Documentation": "https://markstory.github.io/sphinxcontrib-phpdomain/",
     },
     classifiers=[
-        'Environment :: Console',
-        'Environment :: Web Environment',
-        'Intended Audience :: Developers',
-        'License :: OSI Approved :: BSD License',
-        'Operating System :: OS Independent',
-        'Programming Language :: Python',
-        'Topic :: Documentation',
-        'Topic :: Utilities',
+        "Environment :: Console",
+        "Environment :: Web Environment",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: BSD License",
+        "Operating System :: OS Independent",
+        "Programming Language :: Python",
+        "Topic :: Documentation",
+        "Topic :: Utilities",
     ],
-    platforms='any',
+    platforms="any",
     dependency_links=[],
-    namespace_packages=['sphinxcontrib'],
-    packages=find_packages(exclude=['test*']),
+    namespace_packages=["sphinxcontrib"],
+    packages=find_packages(exclude=["test*"]),
     include_package_data=True,
     install_requires=requirements,
     zip_safe=False,
diff --git a/sphinxcontrib/__init__.py b/sphinxcontrib/__init__.py
index fad99fcd..0e5de82e 100644
--- a/sphinxcontrib/__init__.py
+++ b/sphinxcontrib/__init__.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 """
     sphinxcontrib
     ~~~~~~~~~~~~~
@@ -11,4 +10,4 @@
     :license: BSD, see LICENSE for details.
 """
 
-__import__('pkg_resources').declare_namespace(__name__)
+__import__("pkg_resources").declare_namespace(__name__)
diff --git a/sphinxcontrib/phpdomain.py b/sphinxcontrib/phpdomain.py
index d73860fc..8dc5e84a 100644
--- a/sphinxcontrib/phpdomain.py
+++ b/sphinxcontrib/phpdomain.py
@@ -1,14 +1,13 @@
-# -*- coding: utf-8 -*-
 """
-    sphinx.domains.php
-    ~~~~~~~~~~~~~~~~~~~
-
+    Sphinx PHP domain.
+    
     The PHP domain. Based off of the rubydomain by SHIBUKAWA Yoshiki
 
     :copyright: Copyright 2016 by Mark Story
     :license: BSD, see LICENSE for details.
 """
 import re
+import inspect
 
 from docutils import nodes
 from docutils.parsers.rst import directives, Directive
@@ -18,38 +17,71 @@
 from sphinx.locale import _
 from sphinx.domains import Domain, ObjType, Index
 from sphinx.directives import ObjectDescription
+from sphinx.util import logging
 from sphinx.util.nodes import make_refnode
 from sphinx.util.docfields import Field, GroupedField, TypedField
 from sphinx import __version__ as sphinx_version
 
-php_sig_re = re.compile(
-    r'''^ (public\ |protected\ |private\ )? # visibility
-          (final\ |abstract\ |static\ )?    # modifiers
-          ([\w.]*\:\:)?                     # class name(s)
-          (\$?\w+)  \s*                     # thing name
-          (?: \((.*)\)                      # optional: arguments
-          (?:\s* -> \s* (.*))?)?            # return annotation
-          (?:\s* : \s* (.*))?               # backed enum type / case value
-          $                                 # and nothing more
-          ''', re.VERBOSE)
+
+def log_info(fromdocnode, message: str):
+    """
+    Log informative message. Should have no effect on exit code.
+    """
+    logger = logging.getLogger(__name__)
+    logger.info(f"[phpdomain] {message}", location=fromdocnode)
 
 
-NS = '\\'
+def log_warning(fromdocnode, message: str):
+    """
+    Log warning. Should set exit code to non-zero.
+    """
+    logger = logging.getLogger(__name__)
+    logger.warning(f"[phpdomain] {message}", location=fromdocnode, type="phpdomain")
+
+
+def throw_if_false(fromdocnode, value, message: str):
+    """
+    Log warning if the value is not true and throw ValueError. Should set exit code to non-zero.
+    """
+    if not value:
+        log_warning(fromdocnode, message)
+        raise ValueError
+
+
+php_sig_re = re.compile(
+    r"""
+    ^
+    (public\ |protected\ |private\ )? # visibility
+    (final\ |abstract\ |static\ )?    # modifiers
+    ((?:\\?(?!\d)\w+)\:\:)?           # class name
+    (\$?(?:\\?(?!\d)\w+)+) \s*        # thing name
+    (?:
+        \((.*)\)                      # optional: arguments
+        (?: \s* -> \s* (.*))?         # return annotation
+    )?
+    (?: \s* : \s* (.*))?              # backed enum type / case value
+    $                                 # and nothing more
+    """,
+    re.VERBOSE,
+)
+
+
+NS = "\\"
 
 separators = {
-  'method': '::',
-  'function': NS,
-  'class': NS,
-  'namespace': NS,
-  'global': '',
-  'const': '::',
-  'attr': '::$',
-  'exception': '',
-  'staticmethod': '::',
-  'interface': NS,
-  'trait': NS,
-  'enum': NS,
-  'case': '::',
+    "global": None,
+    "namespace": None,
+    "function": None,
+    "interface": None,
+    "class": None,
+    "trait": None,
+    "enum": None,
+    "exception": None,
+    "method": "::",
+    "const": "::",
+    "attr": "::$",
+    "staticmethod": "::",
+    "case": "::",
 }
 
 php_separator = re.compile(r"(\w+)?(?:[:]{2})?")
@@ -57,7 +89,8 @@
 
 def _pseudo_parse_arglist(signode, arglist):
     # type: (addnodes.desc_signature, unicode) -> None
-    """"Parse" a list of arguments separated by commas.
+    """
+    "Parse" a list of arguments separated by commas.
     Arguments can have "optional" annotations given by enclosing them in
     brackets.  Currently, this will split at any comma, even if it's inside a
     string literal (e.g. default argument value).
@@ -67,20 +100,20 @@ def _pseudo_parse_arglist(signode, arglist):
     paramlist = addnodes.desc_parameterlist()
     stack = [paramlist]
     try:
-        for argument in arglist.split(','):
+        for argument in arglist.split(","):
             argument = argument.strip()
             ends_open = ends_close = 0
-            while argument.startswith('['):
+            while argument.startswith("["):
                 stack.append(addnodes.desc_optional())
                 stack[-2] += stack[-1]
                 argument = argument[1:].strip()
-            while argument.startswith(']'):
+            while argument.startswith("]"):
                 stack.pop()
                 argument = argument[1:].strip()
-            while argument.endswith(']') and not argument.endswith('[]'):
+            while argument.endswith("]") and not argument.endswith("[]"):
                 ends_close += 1
                 argument = argument[:-1].strip()
-            while argument.endswith('['):
+            while argument.endswith("["):
                 ends_open += 1
                 argument = argument[:-1].strip()
             if argument:
@@ -106,41 +139,64 @@ def _pseudo_parse_arglist(signode, arglist):
 
 def php_rsplit(fullname):
     items = [item for item in php_separator.findall(fullname)]
-    return ''.join(items[:-2]), ''.join(items[1:-1])
+    return "".join(items[:-2]), "".join(items[1:-1])
 
 
 class PhpObject(ObjectDescription):
     """
     Description of a general PHP object.
     """
+
     option_spec = {
-        'noindex': directives.flag,
-        'noindexentry': directives.flag,
-        'nocontentsentry': directives.flag,
-        'module': directives.unchanged,
+        "noindex": directives.flag,
+        "noindexentry": directives.flag,
+        "nocontentsentry": directives.flag,
+        "module": directives.unchanged,
     }
 
     doc_field_types = [
-        TypedField('parameter', label=_('Parameters'),
-                   names=('param', 'parameter', 'arg', 'argument'),
-                   typerolename='obj', typenames=('paramtype', 'type')),
-        TypedField('variable', label=_('Variables'), rolename='obj',
-                   names=('var', 'ivar', 'cvar'),
-                   typerolename='obj', typenames=('vartype',)),
-        GroupedField('exceptions', label=_('Throws'), rolename='exc',
-                     names=('throws', 'throw', 'exception', 'except'),
-                     can_collapse=True),
-        Field('returnvalue', label=_('Returns'), has_arg=False,
-              names=('returns', 'return')),
-        Field('returntype', label=_('Return type'), has_arg=False,
-              names=('rtype', 'returntype'), bodyrolename='obj'),
+        TypedField(
+            "parameter",
+            label=_("Parameters"),
+            names=("param", "parameter", "arg", "argument"),
+            typerolename="obj",
+            typenames=("paramtype", "type"),
+        ),
+        TypedField(
+            "variable",
+            label=_("Variables"),
+            rolename="obj",
+            names=("var", "ivar", "cvar"),
+            typerolename="obj",
+            typenames=("vartype",),
+        ),
+        GroupedField(
+            "exceptions",
+            label=_("Throws"),
+            rolename="exc",
+            names=("throws", "throw", "exception", "except"),
+            can_collapse=True,
+        ),
+        Field(
+            "returnvalue",
+            label=_("Returns"),
+            has_arg=False,
+            names=("returns", "return"),
+        ),
+        Field(
+            "returntype",
+            label=_("Return type"),
+            has_arg=False,
+            names=("rtype", "returntype"),
+            bodyrolename="obj",
+        ),
     ]
 
     def get_signature_prefix(self, sig):
         """
         May return a prefix to put before the object name in the signature.
         """
-        return ''
+        return ""
 
     def needs_arglist(self):
         """
@@ -160,82 +216,76 @@ def handle_signature(self, sig, signode):
         """
         m = php_sig_re.match(sig)
         if m is None:
-            raise ValueError
+            throw_if_false(signode, False, "Invalid signature")
 
         visibility, modifiers, name_prefix, name, arglist, retann, enumtype = m.groups()
 
         if not name_prefix:
             name_prefix = ""
 
-        # determine module and class name (if applicable), as well as full name
-        modname = self.options.get(
-            'namespace', self.env.temp_data.get('php:namespace'))
-
-        classname = self.env.temp_data.get('php:class')
+        # determine namespace and class name (if applicable), as well as full name
+        namespace = self.options.get(
+            "namespace", self.env.temp_data.get("php:namespace")
+        )
         separator = separators[self.objtype]
 
-        # Method declared as Class::methodName
-        if not classname and '::' in name_prefix:
-            classname = name_prefix.rstrip('::')
-        if self.objtype == 'global' or self.objtype == 'function':
-            add_module = False
-            modname = None
+        if "::" in name_prefix:
+            classname = name_prefix.rstrip("::")
+        else:
+            classname = self.env.temp_data.get("php:class")
+
+        if self.objtype == "global":
+            namespace = None
             classname = None
             fullname = name
         else:
-            add_module = True
-            # name_prefix and a non-static method, means the classname was
-            # repeated. Trim off the <class>::
-            if name_prefix and self.objtype != 'staticmethod':
-                if name_prefix.startswith(classname):
-                    name_prefix = name_prefix[len(classname):].rstrip('::')
-                classname = classname.rstrip('::')
-                fullname = name_prefix + classname + separator + name
-            elif name_prefix:
-                classname = classname.rstrip('::')
+            if name_prefix:
                 fullname = name_prefix + name
 
             # Currently in a class, but not creating another class,
-            elif classname and not self.objtype in ['class', 'exception', 'interface', 'trait', 'enum']:
-                if not self.env.temp_data['php:in_class']:
+            elif classname and not self.objtype in [
+                "class",
+                "exception",
+                "interface",
+                "trait",
+                "enum",
+                "function",
+            ]:
+                if not self.env.temp_data["php:in_class"]:
                     name_prefix = classname + separator
 
                 fullname = classname + separator + name
             else:
-                classname = ''
+                classname = ""
                 fullname = name
 
-        signode['namespace'] = modname
-        signode['class'] = self.class_name = classname
-        signode['fullname'] = fullname
+        signode["namespace"] = namespace
+        signode["class"] = self.class_name = classname
+        signode["fullname"] = fullname
 
         if visibility:
             signode += addnodes.desc_annotation(visibility, visibility)
 
         sig_prefix = self.get_signature_prefix(sig)
 
-        if modifiers and not (sig_prefix and 'static' in sig_prefix):
-                signode += addnodes.desc_annotation(modifiers, modifiers)
+        if modifiers and not (sig_prefix and "static" in sig_prefix):
+            signode += addnodes.desc_annotation(modifiers, modifiers)
 
         if sig_prefix:
             signode += addnodes.desc_annotation(sig_prefix, sig_prefix)
 
         if name_prefix:
-            if modname and not self.env.temp_data['php:in_class']:
-                name_prefix = modname + NS + name_prefix
+            if namespace and not self.env.temp_data["php:in_class"]:
+                name_prefix = namespace + NS + name_prefix
             signode += addnodes.desc_addname(name_prefix, name_prefix)
 
-        elif add_module and self.env.config.add_module_names:
-            if self.objtype == 'global':
-                nodetext = ''
-                signode += addnodes.desc_addname(nodetext, nodetext)
-            else:
-                modname = self.options.get(
-                    'namespace', self.env.temp_data.get('php:namespace'))
-
-                if modname and not self.env.temp_data.get('php:in_class', False):
-                    nodetext = modname + NS
-                    signode += addnodes.desc_addname(nodetext, nodetext)
+        elif (
+            namespace
+            and not self.env.temp_data.get("php:in_class", False)
+            and self.env.config.add_module_names
+        ):
+            nodetext = namespace + NS
+            signode += addnodes.desc_addname(nodetext, nodetext)
 
         signode += addnodes.desc_name(name, name)
         if not arglist:
@@ -257,83 +307,87 @@ def handle_signature(self, sig, signode):
         return fullname, name_prefix
 
     def _object_hierarchy_parts(self, sig_node: addnodes.desc_signature):
-        if 'fullname' not in sig_node:
+        if "fullname" not in sig_node:
             return ()
-        namespace = sig_node.get('namespace')
-        fullname = sig_node['fullname']
+        namespace = sig_node.get("namespace")
+        fullname = sig_node["fullname"]
 
         if isinstance(namespace, str):
-            return (namespace, *fullname.split('::'))
+            return (namespace, *fullname.split("::"))
         else:
-            return tuple(fullname.split('::'))
+            return tuple(fullname.split("::"))
 
     def _toc_entry_name(self, sig_node: addnodes.desc_signature) -> str:
-        if not sig_node.get('_toc_parts'):
-            return ''
+        if not sig_node.get("_toc_parts"):
+            return ""
 
         config = self.env.app.config
-        objtype = sig_node.parent.get('objtype')
-        if config.add_function_parentheses and objtype in {'function', 'method'}:
-            parens = '()'
+        objtype = sig_node.parent.get("objtype")
+        if config.add_function_parentheses and objtype in {"function", "method"}:
+            parens = "()"
         else:
-            parens = ''
-        *parents, name = sig_node['_toc_parts']
-        if config.toc_object_entries_show_parents == 'domain':
-            return sig_node.get('fullname', name) + parens
-        if config.toc_object_entries_show_parents == 'hide':
+            parens = ""
+        *parents, name = sig_node["_toc_parts"]
+        if config.toc_object_entries_show_parents == "domain":
+            return sig_node.get("fullname", name) + parens
+        if config.toc_object_entries_show_parents == "hide":
             return name + parens
-        if config.toc_object_entries_show_parents == 'all':
-            if objtype in {'method', 'const', 'attr', 'staticmethod', 'case'} and len(parents) > 0:
-                name = parents.pop() + '::' + name
-            return '\\'.join(parents + [name + parens])
-        return ''
-
-    def get_index_text(self, modname, name):
+        if config.toc_object_entries_show_parents == "all":
+            if (
+                objtype in {"method", "const", "attr", "staticmethod", "case"}
+                and len(parents) > 0
+            ):
+                name = parents.pop() + "::" + name
+            return "\\".join(parents + [name + parens])
+        return ""
+
+    def get_index_text(self, namespace, name):
         """
         Return the text for the index entry of the object.
         """
-        raise NotImplementedError('must be implemented in subclasses')
+        raise NotImplementedError("must be implemented in subclasses")
 
     def _is_class_member(self):
-        return (self.objtype.startswith('method') or
-                self.objtype.startswith('attr'))
+        return self.objtype.startswith("method") or self.objtype.startswith("attr")
 
     def add_target_and_index(self, name_cls, sig, signode):
-        if self.objtype == 'global':
-            modname = ''
+        if self.objtype == "global":
+            namespace = None
         else:
-            modname = self.options.get(
-                'namespace', self.env.temp_data.get('php:namespace'))
-        separator = separators[self.objtype]
+            namespace = self.options.get(
+                "namespace", self.env.temp_data.get("php:namespace")
+            )
         if self._is_class_member():
-            if signode['class']:
-                prefix = modname and modname + NS or ''
+            if signode["class"]:
+                prefix = namespace and namespace + NS or ""
             else:
-                prefix = modname and modname + NS or ''
+                prefix = namespace and namespace + NS or ""
         else:
-            prefix = modname and modname + NS or ''
+            prefix = namespace and namespace + NS or ""
         fullname = prefix + name_cls[0]
 
         # note target
         if fullname not in self.state.document.ids:
-            signode['names'].append(fullname)
-            signode['ids'].append(fullname)
-            signode['first'] = (not self.names)
+            signode["names"].append(fullname)
+            signode["ids"].append(fullname)
+            signode["first"] = not self.names
             self.state.document.note_explicit_target(signode)
-            objects = self.env.domaindata['php']['objects']
+            objects = self.env.domaindata["php"]["objects"]
             if fullname in objects:
                 self.state_machine.reporter.warning(
-                    'duplicate object description of %s, ' % fullname +
-                    'other instance in ' +
-                    self.env.doc2path(objects[fullname][0]),
-                    line=self.lineno)
+                    "duplicate object description of %s, " % fullname
+                    + "other instance in "
+                    + self.env.doc2path(objects[fullname][0]),
+                    line=self.lineno,
+                )
             objects[fullname] = (self.env.docname, self.objtype)
 
-        if 'noindexentry' not in self.options:
-            indextext = self.get_index_text(modname, name_cls)
+        if "noindexentry" not in self.options:
+            indextext = self.get_index_text(namespace, name_cls)
             if indextext:
-                self.indexnode['entries'].append(('single', indextext,
-                                                  fullname, fullname, None))
+                self.indexnode["entries"].append(
+                    ("single", indextext, fullname, fullname, None)
+                )
 
 
 class PhpGloballevel(PhpObject):
@@ -341,11 +395,11 @@ class PhpGloballevel(PhpObject):
     Description of an object on global level (global variables).
     """
 
-    def get_index_text(self, modname, name_cls):
-        if self.objtype == 'global':
-            return _('%s (global variable)') % name_cls[0]
+    def get_index_text(self, namespace, name_cls):
+        if self.objtype == "global":
+            return _("%s (global variable)") % name_cls[0]
         else:
-            return ''
+            return ""
 
 
 class PhpNamespacelevel(PhpObject):
@@ -354,160 +408,168 @@ class PhpNamespacelevel(PhpObject):
     """
 
     def needs_arglist(self):
-        return self.objtype == 'function'
+        return self.objtype == "function"
 
     def get_signature_prefix(self, sig):
         """
         Adds class prefix for constants created inside classes
         """
-        if self.objtype == 'const':
-            return _('constant ')
-        if self.class_name and self.class_name != '':
-            return self.class_name + '::'
-
-    def get_index_text(self, modname, name_cls):
-        if self.objtype == 'function':
-            if not modname:
-                return _('%s() (global function)') % name_cls[0]
-            return _('%s() (function in %s)') % (name_cls[0], modname)
-        elif self.objtype == 'const' and self.class_name != '':
-            return _('%s (class constant)') % (name_cls[0])
-        elif self.objtype == 'const':
-            if not modname:
-                return _('%s (global constant)') % (name_cls[0])
-            return _('%s (constant in %s)') % (name_cls[0], modname)
+        if self.objtype == "const":
+            return _("constant ")
+        if self.class_name and self.class_name != "":
+            return self.class_name + "::"
+
+    def get_index_text(self, namespace, name_cls):
+        if self.objtype == "function":
+            if not namespace:
+                return _("%s() (global function)") % name_cls[0]
+            return _("%s() (function in %s)") % (name_cls[0], namespace)
+        elif self.objtype == "const" and self.class_name != "":
+            return _("%s (class constant)") % (name_cls[0])
+        elif self.objtype == "const":
+            if not namespace:
+                return _("%s (global constant)") % (name_cls[0])
+            return _("%s (constant in %s)") % (name_cls[0], namespace)
         else:
-            return ''
+            return ""
 
 
 class PhpClasslike(PhpObject):
     """
     Description of a class-like object
-    (classes, exceptions, interfaces, traits, enums).
+    (classes, interfaces, traits, enums).
     """
 
     def get_signature_prefix(self, sig):
-        return self.objtype + ' '
-
-    def get_index_text(self, modname, name_cls):
-        if self.objtype == 'class':
-            if not modname:
-                return _('%s (class)') % name_cls[0]
-            return _('%s (class in %s)') % (name_cls[0], modname)
-        elif self.objtype == 'interface':
-            if not modname:
-                return _('%s (interface)') % name_cls[0]
-            return _('%s (interface in %s)') % (name_cls[0], modname)
-        elif self.objtype == 'trait':
-            if not modname:
-                return _('%s (trait)') % name_cls[0]
-            return _('%s (trait in %s)') % (name_cls[0], modname)
-        elif self.objtype == 'enum':
-            if not modname:
-                return _('%s (enum)') % name_cls[0]
-            return _('%s (enum in %s)') % (name_cls[0], modname)
-        elif self.objtype == 'exception':
+        return self.objtype + " "
+
+    def get_index_text(self, namespace, name_cls):
+        if self.objtype == "class":
+            if not namespace:
+                return _("%s (class)") % name_cls[0]
+            return _("%s (class in %s)") % (name_cls[0], namespace)
+        elif self.objtype == "interface":
+            if not namespace:
+                return _("%s (interface)") % name_cls[0]
+            return _("%s (interface in %s)") % (name_cls[0], namespace)
+        elif self.objtype == "trait":
+            if not namespace:
+                return _("%s (trait)") % name_cls[0]
+            return _("%s (trait in %s)") % (name_cls[0], namespace)
+        elif self.objtype == "enum":
+            if not namespace:
+                return _("%s (enum)") % name_cls[0]
+            return _("%s (enum in %s)") % (name_cls[0], namespace)
+        elif self.objtype == "exception":
             return name_cls[0]
         else:
-            return ''
+            return ""
 
     def after_content(self):
-        self.env.temp_data['php:in_class'] = False
+        self.env.temp_data["php:in_class"] = False
 
     def before_content(self):
-        self.env.temp_data['php:in_class'] = True
+        self.env.temp_data["php:in_class"] = True
         if self.names:
-            self.env.temp_data['php:class'] = self.names[0][0]
+            self.env.temp_data["php:class"] = self.names[0][0]
 
 
 class PhpClassmember(PhpObject):
     """
-    Description of a class member (methods, attributes).
+    Description of a class member (methods, properties).
     """
 
     def get_signature_prefix(self, sig):
-        if self.objtype == 'attr':
-            return _('property ')
-        if self.objtype == 'staticmethod':
-            return _('static ')
-        if self.objtype == 'case':
-            return _('case ')
-        return ''
+        if self.objtype == "attr":
+            return _("property ")
+        if self.objtype == "staticmethod":
+            return _("static ")
+        if self.objtype == "case":
+            return _("case ")
+        return ""
 
     def needs_arglist(self):
-        return self.objtype == 'method'
+        return self.objtype == "method"
 
-    def get_index_text(self, modname, name_cls):
+    def get_index_text(self, namespace, name_cls):
         name, cls = name_cls
-        add_modules = self.env.config.add_module_names
 
-        if self.objtype.endswith('method') or self.objtype == 'attr' or self.objtype == 'case':
+        if (
+            self.objtype.endswith("method")
+            or self.objtype == "attr"
+            or self.objtype == "case"
+        ):
             try:
                 clsname, propname = php_rsplit(name)
             except ValueError:
                 propname = name
                 clsname = None
 
-        if self.objtype.endswith('method'):
-            if modname and clsname is None:
-                return _('%s() (in namespace %s)') % (name, modname)
-            elif modname and add_modules:
-                return _('%s() (%s\\%s method)') % (propname, modname, clsname)
+        if self.objtype.endswith("method"):
+            if namespace and clsname is None:
+                return _("%s() (in namespace %s)") % (name, namespace)
+            elif namespace and self.env.config.add_module_names:
+                return _("%s() (%s\\%s method)") % (propname, namespace, clsname)
             else:
-                return _('%s() (%s method)') % (propname, clsname)
-        elif self.objtype == 'attr':
-            if modname and clsname is None:
-                return _('%s (in namespace %s)') % (name, modname)
-            elif modname and add_modules:
-                return _('%s (%s\\%s property)') % (propname, modname, clsname)
+                return _("%s() (%s method)") % (propname, clsname)
+        elif self.objtype == "attr":
+            if namespace and clsname is None:
+                return _("%s (in namespace %s)") % (name, namespace)
+            elif namespace and self.env.config.add_module_names:
+                return _("%s (%s\\%s property)") % (propname, namespace, clsname)
             else:
-                return _('%s (%s property)') % (propname, clsname)
-        elif self.objtype == 'case':
-            if modname and clsname is None:
-                return _('%s enum case') % (name)
-            elif modname and add_modules:
-                return _('%s (%s\\%s enum case)') % (propname, modname, clsname)
+                return _("%s (%s property)") % (propname, clsname)
+        elif self.objtype == "case":
+            if namespace and clsname is None:
+                return _("%s enum case") % (name)
+            elif namespace and self.env.config.add_module_names:
+                return _("%s (%s\\%s enum case)") % (propname, namespace, clsname)
             else:
-                return _('%s (%s enum case)') % (propname, clsname)
+                return _("%s (%s enum case)") % (propname, clsname)
         else:
-            return ''
+            return ""
 
 
 class PhpNamespace(Directive):
     """
-    Directive to start a new PHP namespace, which are similar to modules.
+    Directive to start a new PHP namespace, which is similar to module.
     """
+
     has_content = False
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = False
     option_spec = {
-        'synopsis': lambda x: x,
-        'noindex': directives.flag,
-        'deprecated': directives.flag,
+        "synopsis": lambda x: x,
+        "noindex": directives.flag,
+        "deprecated": directives.flag,
     }
 
     def run(self):
         env = self.state.document.settings.env
-        modname = self.arguments[0].strip()
-        noindex = 'noindex' in self.options
-        env.temp_data['php:namespace'] = modname
-        env.temp_data['php:class'] = None
-        env.domaindata['php']['namespaces'][modname] = (
-            env.docname, self.options.get('synopsis', ''),
-            'deprecated' in self.options)
-
-        targetnode = nodes.target('', '', ids=['namespace-' + modname],
-                                  ismod=True)
+        namespace = self.arguments[0].strip()
+        noindex = "noindex" in self.options
+        env.temp_data["php:namespace"] = namespace
+        env.temp_data["php:class"] = None
+        env.domaindata["php"]["namespaces"][namespace] = (
+            env.docname,
+            self.options.get("synopsis", ""),
+            "deprecated" in self.options,
+        )
+
+        targetnode = nodes.target("", "", ids=["namespace-" + namespace], ismod=True)
         self.state.document.note_explicit_target(targetnode)
         ret = [targetnode]
 
         # the synopsis isn't printed; in fact, it is only used in the
         # modindex currently
         if not noindex:
-            indextext = _('%s (namespace)') % modname
-            inode = addnodes.index(entries=[('single', indextext,
-                                             'namespace-' + modname, modname, None)])
+            indextext = _("%s (namespace)") % namespace
+            inode = addnodes.index(
+                entries=[
+                    ("single", indextext, "namespace-" + namespace, namespace, None)
+                ]
+            )
             ret.append(inode)
         return ret
 
@@ -526,11 +588,11 @@ class PhpCurrentNamespace(Directive):
 
     def run(self):
         env = self.state.document.settings.env
-        modname = self.arguments[0].strip()
-        if modname == 'None':
-            env.temp_data['php:namespace'] = None
+        namespace = self.arguments[0].strip()
+        if namespace == "None":
+            env.temp_data["php:namespace"] = None
         else:
-            env.temp_data['php:namespace'] = modname
+            env.temp_data["php:namespace"] = namespace
         return []
 
 
@@ -538,86 +600,104 @@ class PhpXRefRole(XRefRole):
     """
     Provides cross reference links for PHP objects
     """
+
     def process_link(self, env, refnode, has_explicit_title, title, target):
         if not has_explicit_title:
-            if title.startswith("::"):
-                title = title[2:]
-            target = target.lstrip('~')  # only has a meaning for the title
-
-            # If the first char is ~ don't display the leading namespace & class.
-            if title.startswith('~'):
-                m = re.search(r"(?:.+[:]{2}|(?:.*?\\{1,2})+)?(.*)\Z", title)
-                if m:
-                    title = m.group(1)
+            # If the first char is '~' don't display the leading namespace & class.
+            if target.startswith("~"):  # only has a meaning for the title
+                target = title[1:]
+            if title.startswith("~"):
+                title = title[1:]
+                title = re.sub(r"^[\w\\]+::", "", title)
+
+            if title.startswith(NS):
+                title = title[1:]
+
+        reftype = refnode.attributes["reftype"]
+        if reftype == "global":
+            namespace = None
+            classname = None
+        else:
+            namespace = env.temp_data.get("php:namespace")
+            classname = env.temp_data.get("php:class")
 
-        refnode['php:namespace'] = env.temp_data.get('php:namespace')
-        refnode['php:class'] = env.temp_data.get('php:class')
+        refnode["php:namespace"] = namespace
+        refnode["php:class"] = classname
 
         return title, target
 
 
 class PhpNamespaceIndex(Index):
     """
-    Index subclass to provide the Php module index.
+    Index subclass to provide the PHP namespace index.
     """
 
-    name = 'modindex'
-    localname = _('PHP Namespace Index')
-    shortname = _('namespaces')
+    name = "modindex"
+    localname = _("PHP Namespace Index")
+    shortname = _("namespaces")
 
     def generate(self, docnames=None):
         content = {}
         # list of prefixes to ignore
-        ignores = self.domain.env.config['modindex_common_prefix']
+        ignores = self.domain.env.config["modindex_common_prefix"]
         ignores = sorted(ignores, key=len, reverse=True)
-        # list of all modules, sorted by module name
-        modules = sorted(self.domain.data['namespaces'].items(),
-                         key=lambda x: x[0].lower())
-        # sort out collapsable modules
-        prev_modname = ''
+        # list of all namespaces, sorted by name
+        namespaces = sorted(
+            self.domain.data["namespaces"].items(), key=lambda x: x[0].lower()
+        )
+        # sort out collapsable namespaces
+        prev_namespace = ""
         num_toplevels = 0
-        for modname, (docname, synopsis, deprecated) in modules:
+        for namespace, (docname, synopsis, deprecated) in namespaces:
             if docnames and docname not in docnames:
                 continue
 
             for ignore in ignores:
-                if modname.startswith(ignore):
-                    modname = modname[len(ignore):]
+                if namespace.startswith(ignore):
+                    namespace = namespace[len(ignore) :]
                     stripped = ignore
                     break
             else:
-                stripped = ''
+                stripped = ""
 
-            # we stripped the whole module name?
-            if not modname:
-                modname, stripped = stripped, ''
+            # we stripped the whole namespace name?
+            if not namespace:
+                namespace, stripped = stripped, ""
 
-            entries = content.setdefault(modname[0].lower(), [])
+            entries = content.setdefault(namespace[0].lower(), [])
 
-            package = modname.split(NS)[0]
-            if package != modname:
-                # it's a submodule
-                if prev_modname == package:
-                    # first submodule - make parent a group head
+            package = namespace.split(NS)[0]
+            if package != namespace:
+                # it's a subnamespace
+                if prev_namespace == package:
+                    # first subnamespace - make parent a group head
                     entries[-1][1] = 1
-                elif not prev_modname.startswith(package):
-                    # submodule without parent in list, add dummy entry
-                    entries.append([stripped + package, 1, '', '', '', '', ''])
+                elif not prev_namespace.startswith(package):
+                    # subnamespace without parent in list, add dummy entry
+                    entries.append([stripped + package, 1, "", "", "", "", ""])
                 subtype = 2
             else:
                 num_toplevels += 1
                 subtype = 0
 
-            qualifier = deprecated and _('Deprecated') or ''
-            entries.append([stripped + modname, subtype, docname,
-                            'namespace-' + stripped + modname, '',
-                            qualifier, synopsis])
-            prev_modname = modname
+            qualifier = deprecated and _("Deprecated") or ""
+            entries.append(
+                [
+                    stripped + namespace,
+                    subtype,
+                    docname,
+                    "namespace-" + stripped + namespace,
+                    "",
+                    qualifier,
+                    synopsis,
+                ]
+            )
+            prev_namespace = namespace
 
         # apply heuristics when to collapse modindex at page load:
-        # only collapse if number of toplevel modules is larger than
-        # number of submodules
-        collapse = len(modules) - num_toplevels < num_toplevels
+        # only collapse if number of toplevel namespaces is larger than
+        # number of subnamespaces
+        collapse = len(namespaces) - num_toplevels < num_toplevels
 
         # sort by first letter
         content = sorted(content.items())
@@ -626,183 +706,193 @@ def generate(self, docnames=None):
 
 
 class PhpDomain(Domain):
-    """PHP language domain."""
-    name = 'php'
-    label = 'PHP'
+    """
+    PHP language domain.
+    """
+
+    name = "php"
+    label = "PHP"
     object_types = {
-        'function': ObjType(_('function'), 'func', 'obj'),
-        'global': ObjType(_('global variable'), 'global', 'obj'),
-        'const': ObjType(_('const'), 'const', 'obj'),
-        'method': ObjType(_('method'), 'meth', 'obj'),
-        'class': ObjType(_('class'), 'class', 'obj'),
-        'attr': ObjType(_('attribute'), 'attr', 'obj'),
-        'exception': ObjType(_('exception'), 'exc', 'obj'),
-        'namespace': ObjType(_('namespace'), 'ns', 'obj'),
-        'interface': ObjType(_('interface'), 'interface', 'obj'),
-        'trait': ObjType(_('trait'), 'trait', 'obj'),
-        'enum': ObjType(_('enum'), 'enum', 'obj'),
-        'case': ObjType(_('case'), 'case', 'obj'),
+        "function": ObjType(_("function"), "func", "obj"),
+        "global": ObjType(_("global variable"), "global", "obj"),
+        "const": ObjType(_("const"), "const", "obj"),
+        "method": ObjType(_("method"), "meth", "obj"),
+        "class": ObjType(_("class"), "class", "obj"),
+        "attr": ObjType(_("attribute"), "attr", "obj"),
+        "exception": ObjType(_("exception"), "exc", "obj"),
+        "namespace": ObjType(_("namespace"), "ns", "obj"),
+        "interface": ObjType(_("interface"), "interface", "obj"),
+        "trait": ObjType(_("trait"), "trait", "obj"),
+        "enum": ObjType(_("enum"), "enum", "obj"),
+        "case": ObjType(_("case"), "case", "obj"),
     }
 
     directives = {
-        'function': PhpNamespacelevel,
-        'global': PhpGloballevel,
-        'const': PhpNamespacelevel,
-        'class': PhpClasslike,
-        'method': PhpClassmember,
-        'staticmethod': PhpClassmember,
-        'attr': PhpClassmember,
-        'case': PhpClassmember,
-        'exception': PhpClasslike,
-        'interface': PhpClasslike,
-        'trait': PhpClasslike,
-        'enum': PhpClasslike,
-        'namespace': PhpNamespace,
-        'currentmodule': PhpCurrentNamespace,
-        'currentnamespace': PhpCurrentNamespace,
+        "function": PhpNamespacelevel,
+        "global": PhpGloballevel,
+        "const": PhpNamespacelevel,
+        "class": PhpClasslike,
+        "method": PhpClassmember,
+        "staticmethod": PhpClassmember,
+        "attr": PhpClassmember,
+        "case": PhpClassmember,
+        "exception": PhpClasslike,
+        "interface": PhpClasslike,
+        "trait": PhpClasslike,
+        "enum": PhpClasslike,
+        "namespace": PhpNamespace,
+        "currentmodule": PhpCurrentNamespace,
+        "currentnamespace": PhpCurrentNamespace,
     }
 
     roles = {
-        'func': PhpXRefRole(fix_parens=False),
-        'global': PhpXRefRole(),
-        'class': PhpXRefRole(),
-        'exc': PhpXRefRole(),
-        'meth': PhpXRefRole(fix_parens=False),
-        'attr': PhpXRefRole(),
-        'const': PhpXRefRole(),
-        'ns': PhpXRefRole(),
-        'obj': PhpXRefRole(),
-        'interface': PhpXRefRole(),
-        'trait': PhpXRefRole(),
-        'enum': PhpXRefRole(),
-        'case': PhpXRefRole(),
+        "func": PhpXRefRole(fix_parens=False),
+        "global": PhpXRefRole(),
+        "class": PhpXRefRole(),
+        "exc": PhpXRefRole(),
+        "meth": PhpXRefRole(fix_parens=False),
+        "attr": PhpXRefRole(),
+        "const": PhpXRefRole(),
+        "ns": PhpXRefRole(),
+        "obj": PhpXRefRole(),
+        "interface": PhpXRefRole(),
+        "trait": PhpXRefRole(),
+        "enum": PhpXRefRole(),
+        "case": PhpXRefRole(),
     }
 
     initial_data = {
-        'objects': {},  # fullname -> docname, objtype
-        'namespaces': {},  # namespace -> docname, synopsis
+        "objects": {},  # fullname -> docname, objtype
+        "namespaces": {},  # namespace -> docname, synopsis
     }
     indices = [
         PhpNamespaceIndex,
     ]
 
     def clear_doc(self, docname):
-        for fullname, (fn, _l) in list(self.data['objects'].items()):
+        for fullname, (fn, _l) in list(self.data["objects"].items()):
             if fn == docname:
-                del self.data['objects'][fullname]
-        for ns, (fn, _x, _x) in list(self.data['namespaces'].items()):
+                del self.data["objects"][fullname]
+        for ns, (fn, _x, _x) in list(self.data["namespaces"].items()):
             if fn == docname:
-                del self.data['namespaces'][ns]
+                del self.data["namespaces"][ns]
 
     def merge_domaindata(self, docnames, otherdata):
-        for fullname, (fn, objtype) in otherdata['objects'].items():
+        for fullname, (fn, objtype) in otherdata["objects"].items():
             if fn in docnames:
-                self.data['objects'][fullname] = (fn, objtype)
-        for namespace, data in otherdata['namespaces'].items():
+                self.data["objects"][fullname] = (fn, objtype)
+        for namespace, data in otherdata["namespaces"].items():
             if data[0] in docnames:
-                self.data['namespaces'][namespace] = data
+                self.data["namespaces"][namespace] = data
 
-    def resolve_any_xref(self, env, fromdocname, builder,
-                         target, node, contnode):
+    def resolve_any_xref(self, env, fromdocname, builder, target, node, contnode):
         for typ in self.roles:
-            resolve = self.resolve_xref(env, fromdocname, builder,
-                                        typ, target, node, contnode)
+            resolve = self.resolve_xref(
+                env, fromdocname, builder, typ, target, node, contnode
+            )
             if resolve:
-                return [('php:%s' % typ, resolve)]
+                return [("php:%s" % typ, resolve)]
         return []
 
-    def resolve_xref(self, env, fromdocname, builder,
-                     typ, target, node, contnode):
-        if (typ == 'ns' or
-                typ == 'obj' and target in self.data['namespaces']):
-            docname, synopsis, deprecated = self.data['namespaces'].get(
-                target,
-                ('', '', '')
+    def resolve_xref(self, env, fromdocname, builder, typ, target, node, contnode):
+        if typ == "ns" or typ == "obj" and target in self.data["namespaces"]:
+            docname, synopsis, deprecated = self.data["namespaces"].get(
+                target, ("", "", "")
             )
             if not docname:
                 return None
             else:
-                title = '%s%s' % (synopsis,
-                                  (deprecated and ' (deprecated)' or ''))
+                title = "%s%s" % (synopsis, (deprecated and " (deprecated)" or ""))
                 return make_refnode(
                     builder,
                     fromdocname,
                     docname,
-                    'namespace-' + target,
+                    "namespace-" + target,
                     contnode,
-                    title)
+                    title,
+                )
         else:
-            modname = node.get('php:namespace')
-            clsname = node.get('php:class')
-            searchorder = node.hasattr('refspecific') and 1 or 0
-            name, obj = self.find_obj(env, modname, clsname,
-                                      target, typ, searchorder)
+            namespace = node.get("php:namespace")
+            clsname = node.get("php:class")
+            name, obj = self.find_obj(env, node, namespace, clsname, target, typ)
             if not obj:
                 return None
             else:
-                return make_refnode(builder, fromdocname, obj[0], name,
-                                    contnode, name)
+                return make_refnode(builder, fromdocname, obj[0], name, contnode, name)
 
-    def find_obj(self, env, modname, classname, name, type, searchorder=0):
+    def find_obj(self, env, fromdocnode, namespace, classname, name, type):
         """
-        Find a PHP object for "name", perhaps using the given namespace and/or
-        classname.
+        Find a PHP object for "name", using the given namespace and classname.
         """
-        # skip parens
-        if name[-2:] == '()':
+        # strip parenthesis
+        if name[-2:] == "()":
             name = name[:-2]
 
-        if not name:
-            return None, None
-
-        objects = self.data['objects']
-
-        newname = None
-        if searchorder == 1:
-            if modname and classname and \
-                     modname + NS + classname + '::' + name in objects:
-                newname = modname + NS + classname + '::' + name
-            elif modname and modname + NS + name in objects:
-                newname = modname + NS + name
-            elif modname and modname + NS + name in objects:
-                newname = modname + NS + name
-            elif classname and classname + '::' + name in objects:
-                newname = classname + '.' + name
-            elif classname and classname + '::$' + name in objects:
-                newname = classname + '::$' + name
-            elif name in objects:
-                newname = name
+        objects = self.data["objects"]
+
+        if name.startswith(NS):
+            absname = name[1:]
         else:
-            if name in objects:
-                newname = name
-            elif classname and classname + '::' + name in objects:
-                newname = classname + '::' + name
-            elif classname and classname + '::$' + name in objects:
-                newname = classname + '::$' + name
-            elif modname and modname + NS + name in objects:
-                newname = modname + NS + name
-            elif modname and classname and \
-                    modname + NS + classname + '::' + name in objects:
-                newname = modname + NS + classname + '::' + name
-            elif modname and classname and \
-                    modname + NS + classname + '::$' + name in objects:
-                newname = modname + NS + classname + '::$' + name
-            # special case: object methods
-            elif type in ('func', 'meth') and '::' not in name and \
-                    'object::' + name in objects:
-                newname = 'object::' + name
-        if newname is None:
-            return None, None
-        return newname, objects[newname]
+            absname = (namespace + NS if namespace else "") + name
+
+            if absname not in objects and name in objects:
+                # constants/functions can be namespaced, but allow fallback to global namespace the same way as PHP does
+                name_type = objects[name][1]
+                if (
+                    (name_type == "function" or name_type == "const")
+                    and NS not in name
+                    and "::" not in name
+                ):
+                    absname = name
+                else:
+                    if namespace and name.startswith(namespace + NS):
+                        log_info(
+                            fromdocnode,
+                            f"Target {absname} not found - did you mean to write {name[len(namespace + NS):]}?",
+                        )
+                    else:
+                        log_info(
+                            fromdocnode,
+                            f"Target {absname} not found - did you mean to write {NS + name}?",
+                        )
+                    absname = name  # fallback for BC, might be removed in the next major release
+
+        if absname in objects:
+            return absname, objects[absname]
+
+        # PHP reserved keywords are never resolved using NS and ignore them when not defined
+        if name not in [
+            "array",
+            "bool",
+            "callable",
+            "false",
+            "float",
+            "int",
+            "iterable",
+            "mixed",
+            "never",
+            "null",
+            "object",
+            "parent",
+            "resource",
+            "self",
+            "static",
+            "string",
+            "true",
+            "void",
+        ]:
+            log_info(fromdocnode, f"Target {absname} not found")
+
+        return None, None
 
     def get_objects(self):
-        for ns, info in self.data['namespaces'].items():
-            yield (ns, ns, 'namespace', info[0], 'namespace-' + ns, 0)
-        for refname, (docname, type) in self.data['objects'].items():
+        for ns, info in self.data["namespaces"].items():
+            yield (ns, ns, "namespace", info[0], "namespace-" + ns, 0)
+        for refname, (docname, type) in self.data["objects"].items():
             yield (refname, refname, type, docname, refname, 1)
 
 
 def setup(app):
     app.add_domain(PhpDomain)
 
-    return {'version': sphinx_version, 'parallel_read_safe': True}
+    return {"version": sphinx_version, "parallel_read_safe": True}
diff --git a/test/must-build/Makefile b/test/Makefile
similarity index 100%
rename from test/must-build/Makefile
rename to test/Makefile
diff --git a/test/conf.py b/test/conf.py
new file mode 100644
index 00000000..2be6ab33
--- /dev/null
+++ b/test/conf.py
@@ -0,0 +1,17 @@
+import sys, os
+
+sys.path.append(os.path.abspath(".."))
+
+extensions = [
+    "sphinxcontrib.phpdomain",
+    "myst_parser",
+]
+
+myst_enable_extensions = ["colon_fence"]
+
+source_suffix = ".md"
+master_doc = "index"
+
+exclude_patterns = ["_build", "log.md"]
+
+html_theme = "default"
diff --git a/test/unit/index.md b/test/index.md
similarity index 100%
rename from test/unit/index.md
rename to test/index.md
diff --git a/test/log.html b/test/log.html
new file mode 100644
index 00000000..b6a2cb37
--- /dev/null
+++ b/test/log.html
@@ -0,0 +1,61 @@
+<?xml version="1.0"?>
+<div class="body" role="main">
+  <section id="invalid-domain-type">
+    <h1>Invalid domain type<a class="headerlink" href="#invalid-domain-type" title="Permalink to this heading">&#xB6;</a></h1>
+  </section>
+  <section id="invalid-signature">
+    <h1>Invalid signature<a class="headerlink" href="#invalid-signature" title="Permalink to this heading">&#xB6;</a></h1>
+    <dl class="php method">
+      <dt class="sig sig-object php">
+        <span class="sig-name descname">
+          <span class="pre">x();</span>
+        </span>
+      </dt>
+      <dd/>
+    </dl>
+  </section>
+  <section id="unresolved-references">
+    <h1>Unresolved references<a class="headerlink" href="#unresolved-references" title="Permalink to this heading">&#xB6;</a></h1>
+    <ul class="simple">
+      <li>
+        <p>
+          <code class="xref php php-class docutils literal notranslate">
+            <span class="pre">Foo\Aa</span>
+          </code>
+        </p>
+      </li>
+      <li>
+        <p>
+          <code class="xref php php-meth docutils literal notranslate">
+            <span class="pre">Foo\A::simplifyy</span>
+          </code>
+        </p>
+      </li>
+    </ul>
+    <span class="target" id="namespace-Foo"/>
+    <ul class="simple">
+      <li>
+        <p>
+          <a class="reference internal" href="ns.html#Foo\A::simplify" title="Foo\A::simplify">
+            <code class="xref php php-meth docutils literal notranslate">
+              <span class="pre">Foo\A::simplify</span>
+            </code>
+          </a>
+        </p>
+      </li>
+    </ul>
+    <span class="target" id="namespace-Fooo"/>
+    <ul class="simple">
+      <li>
+        <p>
+          <a class="reference internal" href="ns.html#Foo\A::simplify" title="Foo\A::simplify">
+            <code class="xref php php-meth docutils literal notranslate">
+              <span class="pre">Foo\A::simplify</span>
+            </code>
+          </a>
+        </p>
+      </li>
+    </ul>
+  </section>
+  <div class="clearer"/>
+</div>
diff --git a/test/log.md b/test/log.md
new file mode 100644
index 00000000..fd119717
--- /dev/null
+++ b/test/log.md
@@ -0,0 +1,25 @@
+# Invalid domain type
+
+:::{php:namespacee} Foo
+:::
+
+# Invalid signature
+
+:::{php:method} x();
+:::
+
+# Unresolved references
+
+- {php:class}`Foo\Aa`
+
+- {php:meth}`Foo\A::simplifyy`
+
+:::{php:namespace} Foo
+:::
+
+- {php:meth}`Foo\A::simplify`
+
+:::{php:namespace} Fooo
+:::
+
+- {php:meth}`Foo\A::simplify`
diff --git a/test/log.txt b/test/log.txt
new file mode 100644
index 00000000..12ca82b9
--- /dev/null
+++ b/test/log.txt
@@ -0,0 +1,13 @@
+test/log.md:3: WARNING: Unknown directive type: 'php:namespacee' [myst.directive_unknown]
+test/log.md:8: WARNING: [phpdomain] Invalid signature
+test/log.md:13: [phpdomain] Target Foo\Aa not found
+test/log.md:15: [phpdomain] Target Foo\A::simplifyy not found
+test/log.md:20: [phpdomain] Target Foo\Foo\A::simplify not found - did you mean to write A::simplify?
+test/log.md:25: [phpdomain] Target Fooo\Foo\A::simplify not found - did you mean to write \Foo\A::simplify?
+test/ns.md:48: [phpdomain] Target A2::simplify not found
+test/ns.md:53: [phpdomain] Target Bar2\A::simplify not found
+test/rst_doc.md:506: [phpdomain] Target OtherLibrary\int|string|ReturnedClass|\LibraryName\SubPackage\SubpackageInterface|null not found
+test/rst_doc2.md:11: [phpdomain] Target Imagine\Image\ImageInterface::draw not found
+test/rst_doc2.md:17: [phpdomain] Target Imagine\Image\PointInterface not found
+test/rst_doc2.md:17: [phpdomain] Target Imagine\Image\BoxInterface not found
+test/rst_doc2.md:17: [phpdomain] Target Imagine\Image\Color not found
diff --git a/test/must-build/make.bat b/test/make.bat
similarity index 100%
rename from test/must-build/make.bat
rename to test/make.bat
diff --git a/test/unit/method.html b/test/method.html
similarity index 100%
rename from test/unit/method.html
rename to test/method.html
diff --git a/test/unit/method.md b/test/method.md
similarity index 100%
rename from test/unit/method.md
rename to test/method.md
diff --git a/test/must-build/conf.py b/test/must-build/conf.py
deleted file mode 100644
index e3bde517..00000000
--- a/test/must-build/conf.py
+++ /dev/null
@@ -1,210 +0,0 @@
-# -*- coding: utf-8 -*-
-#
-# sphinxcontrib-rubydomain-acceptancetest documentation build configuration file, created by
-# sphinx-quickstart on Sun Apr 25 13:27:18 2010.
-#
-# This file is execfile()d with the current directory set to its containing dir.
-#
-# Note that not all possible configuration values are present in this
-# autogenerated file.
-#
-# All configuration values have a default; values that are commented out
-# serve to show the default.
-
-import sys, os
-
-# If extensions (or modules to document with autodoc) are in another directory,
-# add these directories to sys.path here. If the directory is relative to the
-# documentation root, use os.path.abspath to make it absolute, like shown here.
-sys.path.append(os.path.abspath('..'))
-
-# -- General configuration -----------------------------------------------------
-
-# If your documentation needs a minimal Sphinx version, state it here.
-needs_sphinx = '1.0'
-
-# Add any Sphinx extension module names here, as strings. They can be extensions
-# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ['sphinxcontrib.phpdomain']
-
-# Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
-
-# The suffix of source filenames.
-source_suffix = '.rst'
-
-# The encoding of source files.
-#source_encoding = 'utf-8-sig'
-
-# The master toctree document.
-master_doc = 'index'
-
-# General information about the project.
-project = u'sphinxcontrib-phpdomain-acceptancetest'
-copyright = u'2011, Mark Story'
-
-# The version info for the project you're documenting, acts as replacement for
-# |version| and |release|, also used in various other places throughout the
-# built documents.
-#
-# The short X.Y version.
-version = '0.1'
-# The full version, including alpha/beta/rc tags.
-release = '0.1'
-
-# The language for content autogenerated by Sphinx. Refer to documentation
-# for a list of supported languages.
-#language = None
-
-# There are two options for replacing |today|: either, you set today to some
-# non-false value, then it is used:
-#today = ''
-# Else, today_fmt is used as the format for a strftime call.
-#today_fmt = '%B %d, %Y'
-
-# List of patterns, relative to source directory, that match files and
-# directories to ignore when looking for source files.
-exclude_patterns = ['_build']
-
-# The reST default role (used for this markup: `text`) to use for all documents.
-#default_role = None
-
-# If true, '()' will be appended to :func: etc. cross-reference text.
-#add_function_parentheses = True
-
-# If true, the current module name will be prepended to all description
-# unit titles (such as .. function::).
-#add_module_names = True
-
-# If true, sectionauthor and moduleauthor directives will be shown in the
-# output. They are ignored by default.
-#show_authors = False
-
-# The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'sphinx'
-
-# A list of ignored prefixes for module index sorting.
-#modindex_common_prefix = []
-
-
-# -- Options for HTML output ---------------------------------------------------
-
-# The theme to use for HTML and HTML Help pages.  Major themes that come with
-# Sphinx are currently 'default' and 'sphinxdoc'.
-html_theme = 'default'
-
-# Theme options are theme-specific and customize the look and feel of a theme
-# further.  For a list of options available for each theme, see the
-# documentation.
-#html_theme_options = {}
-
-# Add any paths that contain custom themes here, relative to this directory.
-#html_theme_path = []
-
-# The name for this set of Sphinx documents.  If None, it defaults to
-# "<project> v<release> documentation".
-#html_title = None
-
-# A shorter title for the navigation bar.  Default is the same as html_title.
-#html_short_title = None
-
-# The name of an image file (relative to this directory) to place at the top
-# of the sidebar.
-#html_logo = None
-
-# The name of an image file (within the static path) to use as favicon of the
-# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
-# pixels large.
-#html_favicon = None
-
-# Add any paths that contain custom static files (such as style sheets) here,
-# relative to this directory. They are copied after the builtin static files,
-# so a file named "default.css" will overwrite the builtin "default.css".
-#html_static_path = ['_static']
-
-# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
-# using the given strftime format.
-#html_last_updated_fmt = '%b %d, %Y'
-
-# If true, SmartyPants will be used to convert quotes and dashes to
-# typographically correct entities.
-#html_use_smartypants = True
-
-# Custom sidebar templates, maps document names to template names.
-#html_sidebars = {}
-
-# Additional templates that should be rendered to pages, maps page names to
-# template names.
-#html_additional_pages = {}
-
-# If false, no module index is generated.
-#html_domain_indices = True
-
-# If false, no index is generated.
-#html_use_index = True
-
-# If true, the index is split into individual pages for each letter.
-#html_split_index = False
-
-# If true, links to the reST sources are added to the pages.
-#html_show_sourcelink = True
-
-# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
-#html_show_sphinx = True
-
-# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
-#html_show_copyright = True
-
-# If true, an OpenSearch description file will be output, and all pages will
-# contain a <link> tag referring to it.  The value of this option must be the
-# base URL from which the finished HTML is served.
-#html_use_opensearch = ''
-
-# If nonempty, this is the file name suffix for HTML files (e.g. ".xhtml").
-#html_file_suffix = ''
-
-# Output file base name for HTML help builder.
-htmlhelp_basename = 'sphinxcontrib-phpdomain-acceptancetestdoc'
-
-
-# -- Options for LaTeX output --------------------------------------------------
-
-# The paper size ('letter' or 'a4').
-#latex_paper_size = 'letter'
-
-# The font size ('10pt', '11pt' or '12pt').
-#latex_font_size = '10pt'
-
-# Grouping the document tree into LaTeX files. List of tuples
-# (source start file, target name, title, author, documentclass [howto/manual]).
-latex_documents = [
-  ('index', 'sphinxcontrib-phpdomain-acceptancetest.tex', u'sphinxcontrib-phpdomain-acceptancetest Documentation',
-   u'Mark Story', 'manual'),
-]
-
-# The name of an image file (relative to this directory) to place at the top of
-# the title page.
-#latex_logo = None
-
-# For "manual" documents, if this is true, then toplevel headings are parts,
-# not chapters.
-#latex_use_parts = False
-
-# Additional stuff for the LaTeX preamble.
-#latex_preamble = ''
-
-# Documents to append as an appendix to all manuals.
-#latex_appendices = []
-
-# If false, no module index is generated.
-#latex_domain_indices = True
-
-
-# -- Options for manual page output --------------------------------------------
-
-# One entry per manual page. List of tuples
-# (source start file, name, description, authors, manual section).
-man_pages = [
-    ('index', 'sphinxcontrib-phpdomain-acceptancetest', u'sphinxcontrib-phpdomain-acceptancetest Documentation',
-     [u'Mark Story'], 1)
-]
diff --git a/test/ns.html b/test/ns.html
new file mode 100644
index 00000000..cbfc2d8f
--- /dev/null
+++ b/test/ns.html
@@ -0,0 +1,171 @@
+<?xml version="1.0"?>
+<div class="body" role="main">
+  <section id="namespace-Foo">
+    <span id="simple-ns"/>
+    <h1>Simple NS<a class="headerlink" href="#namespace-Foo" title="Permalink to this heading">&#xB6;</a></h1>
+    <dl class="php class">
+      <dt class="sig sig-object php" id="Foo\A">
+        <em class="property">
+          <span class="pre">class</span>
+        </em>
+        <span class="sig-prename descclassname">
+          <span class="pre">Foo\</span>
+        </span>
+        <span class="sig-name descname">
+          <span class="pre">A</span>
+        </span>
+        <a class="headerlink" href="#Foo\A" title="Permalink to this definition">&#xB6;</a>
+      </dt>
+      <dd/>
+    </dl>
+    <dl class="php method">
+      <dt class="sig sig-object php" id="Foo\A::simplify">
+        <span class="sig-prename descclassname">
+          <span class="pre">Foo\A::</span>
+        </span>
+        <span class="sig-name descname">
+          <span class="pre">simplify</span>
+        </span>
+        <span class="sig-paren">(</span>
+        <span class="sig-paren">)</span>
+        <a class="headerlink" href="#Foo\A::simplify" title="Permalink to this definition">&#xB6;</a>
+      </dt>
+      <dd/>
+    </dl>
+    <section id="cross-linking">
+      <h2>Cross linking<a class="headerlink" href="#cross-linking" title="Permalink to this heading">&#xB6;</a></h2>
+      <ul class="simple">
+        <li>
+          <p>
+            <a class="reference internal" href="#Foo\A::simplify" title="Foo\A::simplify">
+              <code class="xref php php-meth docutils literal notranslate">
+                <span class="pre">A::simplify</span>
+              </code>
+            </a>
+          </p>
+        </li>
+      </ul>
+    </section>
+  </section>
+  <section id="namespace-Foo\Bar">
+    <span id="ns-can-be-changed"/>
+    <h1>NS can be changed<a class="headerlink" href="#namespace-Foo\Bar" title="Permalink to this heading">&#xB6;</a></h1>
+    <dl class="php class">
+      <dt class="sig sig-object php" id="Foo\Bar\A">
+        <em class="property">
+          <span class="pre">class</span>
+        </em>
+        <span class="sig-prename descclassname">
+          <span class="pre">Foo\Bar\</span>
+        </span>
+        <span class="sig-name descname">
+          <span class="pre">A</span>
+        </span>
+        <a class="headerlink" href="#Foo\Bar\A" title="Permalink to this definition">&#xB6;</a>
+      </dt>
+      <dd/>
+    </dl>
+    <dl class="php method">
+      <dt class="sig sig-object php" id="Foo\Bar\A::simplify">
+        <span class="sig-prename descclassname">
+          <span class="pre">Foo\Bar\A::</span>
+        </span>
+        <span class="sig-name descname">
+          <span class="pre">simplify</span>
+        </span>
+        <span class="sig-paren">(</span>
+        <span class="sig-paren">)</span>
+        <a class="headerlink" href="#Foo\Bar\A::simplify" title="Permalink to this definition">&#xB6;</a>
+      </dt>
+      <dd/>
+    </dl>
+    <span class="target" id="namespace-Bar"/>
+    <dl class="php class">
+      <dt class="sig sig-object php" id="Bar\A">
+        <em class="property">
+          <span class="pre">class</span>
+        </em>
+        <span class="sig-prename descclassname">
+          <span class="pre">Bar\</span>
+        </span>
+        <span class="sig-name descname">
+          <span class="pre">A</span>
+        </span>
+        <a class="headerlink" href="#Bar\A" title="Permalink to this definition">&#xB6;</a>
+      </dt>
+      <dd/>
+    </dl>
+    <dl class="php method">
+      <dt class="sig sig-object php" id="Bar\A::simplify">
+        <span class="sig-prename descclassname">
+          <span class="pre">Bar\A::</span>
+        </span>
+        <span class="sig-name descname">
+          <span class="pre">simplify</span>
+        </span>
+        <span class="sig-paren">(</span>
+        <span class="sig-paren">)</span>
+        <a class="headerlink" href="#Bar\A::simplify" title="Permalink to this definition">&#xB6;</a>
+      </dt>
+      <dd/>
+    </dl>
+    <section id="id1">
+      <h2>Cross linking<a class="headerlink" href="#id1" title="Permalink to this heading">&#xB6;</a></h2>
+      <ul class="simple">
+        <li>
+          <p>
+            <a class="reference internal" href="#Bar\A::simplify" title="Bar\A::simplify">
+              <code class="xref php php-meth docutils literal notranslate">
+                <span class="pre">A::simplify</span>
+              </code>
+            </a>
+          </p>
+        </li>
+        <li>
+          <p>
+            <a class="reference internal" href="#Foo\Bar\A::simplify" title="Foo\Bar\A::simplify">
+              <code class="xref php php-meth docutils literal notranslate">
+                <span class="pre">Foo\Bar\A::simplify</span>
+              </code>
+            </a>
+          </p>
+        </li>
+        <li>
+          <p>
+            <a class="reference internal" href="#Bar\A::simplify" title="Bar\A::simplify">
+              <code class="xref php php-meth docutils literal notranslate">
+                <span class="pre">Bar\A::simplify</span>
+              </code>
+            </a>
+          </p>
+        </li>
+      </ul>
+    </section>
+  </section>
+  <section id="ns-must-not-be-guessed">
+    <h1>NS must not be guessed<a class="headerlink" href="#ns-must-not-be-guessed" title="Permalink to this heading">&#xB6;</a></h1>
+    <div class="note docutils">
+      <p>These cross references must not have a link as the target methods are not defined.</p>
+    </div>
+    <ul class="simple">
+      <li>
+        <p>
+          <code class="xref php php-meth docutils literal notranslate">
+            <span class="pre">A2::simplify</span>
+          </code>
+        </p>
+      </li>
+    </ul>
+    <span class="target" id="namespace-Bar2"/>
+    <ul class="simple">
+      <li>
+        <p>
+          <code class="xref php php-meth docutils literal notranslate">
+            <span class="pre">A::simplify</span>
+          </code>
+        </p>
+      </li>
+    </ul>
+  </section>
+  <div class="clearer"/>
+</div>
diff --git a/test/ns.md b/test/ns.md
new file mode 100644
index 00000000..fc594651
--- /dev/null
+++ b/test/ns.md
@@ -0,0 +1,53 @@
+# Simple NS
+
+:::{php:namespace} Foo
+:::
+
+:::{php:class} A
+:::
+
+:::{php:method} simplify()
+:::
+
+## Cross linking
+
+- {php:meth}`A::simplify`
+
+# NS can be changed
+
+:::{php:namespace} Foo\Bar
+:::
+
+:::{php:class} A
+:::
+
+:::{php:method} simplify()
+:::
+
+:::{php:namespace} Bar
+:::
+
+:::{php:class} A
+:::
+
+:::{php:method} simplify()
+:::
+
+## Cross linking
+
+- {php:meth}`A::simplify`
+- {php:meth}`\Foo\Bar\A::simplify`
+- {php:meth}`\Bar\A::simplify`
+
+# NS must not be guessed
+
+:::note
+These cross references must not have a link as the target methods are not defined.
+:::
+
+- {php:meth}`\A2::simplify`
+
+:::{php:namespace} Bar2
+:::
+
+- {php:meth}`A::simplify`
diff --git a/test/unit/requirements.txt b/test/requirements.txt
similarity index 100%
rename from test/unit/requirements.txt
rename to test/requirements.txt
diff --git a/test/rst_doc.html b/test/rst_doc.html
new file mode 100644
index 00000000..e6dfa1af
--- /dev/null
+++ b/test/rst_doc.html
@@ -0,0 +1,2201 @@
+<?xml version="1.0"?>
+<div class="body" role="main">
+  <section id="acceptance-tests-for-phpdomain">
+    <h1>Acceptance tests for PHPdomain<a class="headerlink" href="#acceptance-tests-for-phpdomain" title="Permalink to this heading">&#xB6;</a></h1>
+    <section id="globals">
+      <h2>Globals<a class="headerlink" href="#globals" title="Permalink to this heading">&#xB6;</a></h2>
+      <dl class="php global">
+        <dt class="sig sig-object php" id="$global_var">
+          <span class="sig-name descname">
+            <span class="pre">$global_var</span>
+          </span>
+          <a class="headerlink" href="#$global_var" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>A global variable</p>
+        </dd>
+      </dl>
+      <dl class="php const">
+        <dt class="sig sig-object php" id="SOME_CONSTANT">
+          <em class="property">
+            <span class="pre">constant</span>
+          </em>
+          <span class="sig-name descname">
+            <span class="pre">SOME_CONSTANT</span>
+          </span>
+          <a class="headerlink" href="#SOME_CONSTANT" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>A global constant</p>
+        </dd>
+      </dl>
+      <dl class="php const">
+        <dt class="sig sig-object php" id="VALUE">
+          <em class="property">
+            <span class="pre">constant</span>
+          </em>
+          <span class="sig-name descname">
+            <span class="pre">VALUE</span>
+          </span>
+          <a class="headerlink" href="#VALUE" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>A global constant</p>
+        </dd>
+      </dl>
+      <dl class="php function">
+        <dt class="sig sig-object php" id="in_array"><span class="sig-name descname"><span class="pre">in_array</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="pre">needle</span></em>, <em class="sig-param"><span class="pre">haystack</span></em><span class="sig-paren">)</span><a class="headerlink" href="#in_array" title="Permalink to this definition">&#xB6;</a></dt>
+        <dd>
+          <p>Checks for needle in haystack.</p>
+          <dl class="field-list simple">
+            <dt class="field-odd">Parameters<span class="colon">:</span></dt>
+            <dd class="field-odd">
+              <ul class="simple">
+                <li>
+                  <p><strong>needle</strong> &#x2013; The element to search for.</p>
+                </li>
+                <li>
+                  <p><strong>haystack</strong> (<span><code class="xref php php-obj docutils literal notranslate"><span class="pre">array</span></code></span>) &#x2013; The array to search.</p>
+                </li>
+              </ul>
+            </dd>
+            <dt class="field-even">Returns<span class="colon">:</span></dt>
+            <dd class="field-even">
+              <p>Element exists in array.</p>
+            </dd>
+            <dt class="field-odd">Return type<span class="colon">:</span></dt>
+            <dd class="field-odd">
+              <p>
+                <span>
+                  <code class="xref php php-obj docutils literal notranslate">
+                    <span class="pre">bool</span>
+                  </code>
+                </span>
+              </p>
+            </dd>
+          </dl>
+        </dd>
+      </dl>
+    </section>
+    <section id="classes">
+      <h2>Classes<a class="headerlink" href="#classes" title="Permalink to this heading">&#xB6;</a></h2>
+      <dl class="php class">
+        <dt class="sig sig-object php" id="DateTime">
+          <em class="property">
+            <span class="pre">class</span>
+          </em>
+          <span class="sig-name descname">
+            <span class="pre">DateTime</span>
+          </span>
+          <a class="headerlink" href="#DateTime" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>Datetime class</p>
+          <dl class="php method">
+            <dt class="sig sig-object php" id="DateTime::setDate"><span class="sig-name descname"><span class="pre">setDate</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="pre">$year</span></em>, <em class="sig-param"><span class="pre">$month</span></em>, <em class="sig-param"><span class="pre">$day</span></em><span class="sig-paren">)</span><a class="headerlink" href="#DateTime::setDate" title="Permalink to this definition">&#xB6;</a></dt>
+            <dd>
+              <p>Set the date in the datetime object</p>
+              <dl class="field-list simple">
+                <dt class="field-odd">Parameters<span class="colon">:</span></dt>
+                <dd class="field-odd">
+                  <ul class="simple">
+                    <li>
+                      <p><strong>$year</strong> (<span><code class="xref php php-obj docutils literal notranslate"><span class="pre">int</span></code></span>) &#x2013; The year.</p>
+                    </li>
+                    <li>
+                      <p><strong>$month</strong> (<span><code class="xref php php-obj docutils literal notranslate"><span class="pre">int</span></code></span>) &#x2013; The month.</p>
+                    </li>
+                    <li>
+                      <p><strong>$day</strong> (<span><code class="xref php php-obj docutils literal notranslate"><span class="pre">int</span></code></span>) &#x2013; The day.</p>
+                    </li>
+                  </ul>
+                </dd>
+              </dl>
+            </dd>
+          </dl>
+          <dl class="php method">
+            <dt class="sig sig-object php" id="DateTime::setTime"><span class="sig-name descname"><span class="pre">setTime</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="pre">$hour</span></em>, <em class="sig-param"><span class="pre">$minute</span></em><span class="optional">[</span>, <em class="sig-param"><span class="pre">$second</span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#DateTime::setTime" title="Permalink to this definition">&#xB6;</a></dt>
+            <dd>
+              <p>Set the time</p>
+              <dl class="field-list simple">
+                <dt class="field-odd">Parameters<span class="colon">:</span></dt>
+                <dd class="field-odd">
+                  <ul class="simple">
+                    <li>
+                      <p><strong>$hour</strong> (<span><code class="xref php php-obj docutils literal notranslate"><span class="pre">int</span></code></span>) &#x2013; The hour</p>
+                    </li>
+                    <li>
+                      <p><strong>$minute</strong> (<span><code class="xref php php-obj docutils literal notranslate"><span class="pre">int</span></code></span>) &#x2013; The minute</p>
+                    </li>
+                    <li>
+                      <p><strong>$second</strong> (<span><code class="xref php php-obj docutils literal notranslate"><span class="pre">int</span></code></span>) &#x2013; The second</p>
+                    </li>
+                  </ul>
+                </dd>
+              </dl>
+            </dd>
+          </dl>
+          <dl class="php method">
+            <dt class="sig sig-object php" id="DateTime::getLastErrors">
+              <em class="property">
+                <span class="pre">public</span>
+              </em>
+              <em class="property">
+                <span class="pre">static</span>
+              </em>
+              <span class="sig-name descname">
+                <span class="pre">getLastErrors</span>
+              </span>
+              <span class="sig-paren">(</span>
+              <span class="sig-paren">)</span>
+              <a class="headerlink" href="#DateTime::getLastErrors" title="Permalink to this definition">&#xB6;</a>
+            </dt>
+            <dd>
+              <p>Returns the warnings and errors</p>
+              <dl class="field-list simple">
+                <dt class="field-odd">Returns<span class="colon">:</span></dt>
+                <dd class="field-odd">
+                  <p>array Returns array containing info about warnings and errors.</p>
+                </dd>
+              </dl>
+            </dd>
+          </dl>
+          <dl class="php const">
+            <dt class="sig sig-object php" id="DateTime::ATOM">
+              <em class="property">
+                <span class="pre">constant</span>
+              </em>
+              <span class="sig-name descname">
+                <span class="pre">ATOM</span>
+              </span>
+              <a class="headerlink" href="#DateTime::ATOM" title="Permalink to this definition">&#xB6;</a>
+            </dt>
+            <dd>
+              <p>Y-m-dTH:i:sP</p>
+            </dd>
+          </dl>
+          <dl class="php attr">
+            <dt class="sig sig-object php" id="DateTime::$testattr">
+              <em class="property">
+                <span class="pre">property</span>
+              </em>
+              <span class="sig-name descname">
+                <span class="pre">testattr</span>
+              </span>
+              <a class="headerlink" href="#DateTime::$testattr" title="Permalink to this definition">&#xB6;</a>
+            </dt>
+            <dd>
+              <p>Value of some attribute</p>
+            </dd>
+          </dl>
+        </dd>
+      </dl>
+      <dl class="php class">
+        <dt class="sig sig-object php" id="OtherClass">
+          <em class="property">
+            <span class="pre">class</span>
+          </em>
+          <span class="sig-name descname">
+            <span class="pre">OtherClass</span>
+          </span>
+          <a class="headerlink" href="#OtherClass" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>Another class</p>
+        </dd>
+      </dl>
+      <dl class="php method">
+        <dt class="sig sig-object php" id="OtherClass::update"><span class="sig-prename descclassname"><span class="pre">OtherClass::</span></span><span class="sig-name descname"><span class="pre">update</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="pre">$arg</span><span class="pre">=</span><span class="pre">''</span></em>, <em class="sig-param"><span class="pre">$arg2</span><span class="pre">=</span><span class="pre">[]</span></em>, <em class="sig-param"><span class="pre">$arg3</span><span class="pre">=</span><span class="pre">[]</span></em><span class="sig-paren">)</span><a class="headerlink" href="#OtherClass::update" title="Permalink to this definition">&#xB6;</a></dt>
+        <dd>
+          <p>Update something.</p>
+        </dd>
+      </dl>
+      <dl class="php attr">
+        <dt class="sig sig-object php" id="OtherClass::$nonIndentedAttribute">
+          <em class="property">
+            <span class="pre">property</span>
+          </em>
+          <span class="sig-prename descclassname">
+            <span class="pre">OtherClass::$</span>
+          </span>
+          <span class="sig-name descname">
+            <span class="pre">nonIndentedAttribute</span>
+          </span>
+          <a class="headerlink" href="#OtherClass::$nonIndentedAttribute" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>This attribute wasn&#x2019;t indented</p>
+        </dd>
+      </dl>
+      <dl class="php const">
+        <dt class="sig sig-object php" id="OtherClass::NO_INDENT">
+          <em class="property">
+            <span class="pre">constant</span>
+          </em>
+          <span class="sig-prename descclassname">
+            <span class="pre">OtherClass::</span>
+          </span>
+          <span class="sig-name descname">
+            <span class="pre">NO_INDENT</span>
+          </span>
+          <a class="headerlink" href="#OtherClass::NO_INDENT" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>This class constant wasn&#x2019;t indented</p>
+        </dd>
+      </dl>
+      <dl class="php staticmethod">
+        <dt class="sig sig-object php" id="OtherClass::staticMethod">
+          <em class="property">
+            <span class="pre">static</span>
+          </em>
+          <span class="sig-prename descclassname">
+            <span class="pre">OtherClass::</span>
+          </span>
+          <span class="sig-name descname">
+            <span class="pre">staticMethod</span>
+          </span>
+          <a class="headerlink" href="#OtherClass::staticMethod" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>A static method.</p>
+        </dd>
+      </dl>
+    </section>
+    <section id="exceptions">
+      <h2>Exceptions<a class="headerlink" href="#exceptions" title="Permalink to this heading">&#xB6;</a></h2>
+      <dl class="php exception">
+        <dt class="sig sig-object php" id="InvalidArgumentException">
+          <em class="property">
+            <span class="pre">exception</span>
+          </em>
+          <span class="sig-name descname">
+            <span class="pre">InvalidArgumentException</span>
+          </span>
+          <a class="headerlink" href="#InvalidArgumentException" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>Throw when you get an argument that is bad.</p>
+        </dd>
+      </dl>
+    </section>
+    <section id="interfaces">
+      <h2>Interfaces<a class="headerlink" href="#interfaces" title="Permalink to this heading">&#xB6;</a></h2>
+      <dl class="php interface">
+        <dt class="sig sig-object php" id="DateTimeInterface">
+          <em class="property">
+            <span class="pre">interface</span>
+          </em>
+          <span class="sig-name descname">
+            <span class="pre">DateTimeInterface</span>
+          </span>
+          <a class="headerlink" href="#DateTimeInterface" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>Datetime interface</p>
+          <dl class="php method">
+            <dt class="sig sig-object php" id="DateTimeInterface::setDate"><span class="sig-name descname"><span class="pre">setDate</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="pre">$year</span></em>, <em class="sig-param"><span class="pre">$month</span></em>, <em class="sig-param"><span class="pre">$day</span></em><span class="sig-paren">)</span><a class="headerlink" href="#DateTimeInterface::setDate" title="Permalink to this definition">&#xB6;</a></dt>
+            <dd>
+              <p>Set the date in the datetime object</p>
+              <dl class="field-list simple">
+                <dt class="field-odd">Parameters<span class="colon">:</span></dt>
+                <dd class="field-odd">
+                  <ul class="simple">
+                    <li>
+                      <p><strong>$year</strong> (<span><code class="xref php php-obj docutils literal notranslate"><span class="pre">int</span></code></span>) &#x2013; The year.</p>
+                    </li>
+                    <li>
+                      <p><strong>$month</strong> (<span><code class="xref php php-obj docutils literal notranslate"><span class="pre">int</span></code></span>) &#x2013; The month.</p>
+                    </li>
+                    <li>
+                      <p><strong>$day</strong> (<span><code class="xref php php-obj docutils literal notranslate"><span class="pre">int</span></code></span>) &#x2013; The day.</p>
+                    </li>
+                  </ul>
+                </dd>
+              </dl>
+            </dd>
+          </dl>
+          <dl class="php method">
+            <dt class="sig sig-object php" id="DateTimeInterface::setTime"><span class="sig-name descname"><span class="pre">setTime</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="pre">$hour</span></em>, <em class="sig-param"><span class="pre">$minute</span></em><span class="optional">[</span>, <em class="sig-param"><span class="pre">$second</span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#DateTimeInterface::setTime" title="Permalink to this definition">&#xB6;</a></dt>
+            <dd>
+              <p>Set the time</p>
+              <dl class="field-list simple">
+                <dt class="field-odd">Parameters<span class="colon">:</span></dt>
+                <dd class="field-odd">
+                  <ul class="simple">
+                    <li>
+                      <p><strong>$hour</strong> (<span><code class="xref php php-obj docutils literal notranslate"><span class="pre">int</span></code></span>) &#x2013; The hour</p>
+                    </li>
+                    <li>
+                      <p><strong>$minute</strong> (<span><code class="xref php php-obj docutils literal notranslate"><span class="pre">int</span></code></span>) &#x2013; The minute</p>
+                    </li>
+                    <li>
+                      <p><strong>$second</strong> (<span><code class="xref php php-obj docutils literal notranslate"><span class="pre">int</span></code></span>) &#x2013; The second</p>
+                    </li>
+                  </ul>
+                </dd>
+              </dl>
+            </dd>
+          </dl>
+          <dl class="php const">
+            <dt class="sig sig-object php" id="DateTimeInterface::ATOM">
+              <em class="property">
+                <span class="pre">constant</span>
+              </em>
+              <span class="sig-name descname">
+                <span class="pre">ATOM</span>
+              </span>
+              <a class="headerlink" href="#DateTimeInterface::ATOM" title="Permalink to this definition">&#xB6;</a>
+            </dt>
+            <dd>
+              <p>Y-m-dTH:i:sP</p>
+            </dd>
+          </dl>
+          <dl class="php attr">
+            <dt class="sig sig-object php" id="DateTimeInterface::$testattr">
+              <em class="property">
+                <span class="pre">property</span>
+              </em>
+              <span class="sig-name descname">
+                <span class="pre">testattr</span>
+              </span>
+              <a class="headerlink" href="#DateTimeInterface::$testattr" title="Permalink to this definition">&#xB6;</a>
+            </dt>
+            <dd>
+              <p>Value of some attribute</p>
+            </dd>
+          </dl>
+        </dd>
+      </dl>
+      <dl class="php interface">
+        <dt class="sig sig-object php" id="OtherInterface">
+          <em class="property">
+            <span class="pre">interface</span>
+          </em>
+          <span class="sig-name descname">
+            <span class="pre">OtherInterface</span>
+          </span>
+          <a class="headerlink" href="#OtherInterface" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>Another interface</p>
+        </dd>
+      </dl>
+    </section>
+    <section id="traits">
+      <h2>Traits<a class="headerlink" href="#traits" title="Permalink to this heading">&#xB6;</a></h2>
+      <dl class="php trait">
+        <dt class="sig sig-object php" id="LogTrait">
+          <em class="property">
+            <span class="pre">trait</span>
+          </em>
+          <span class="sig-name descname">
+            <span class="pre">LogTrait</span>
+          </span>
+          <a class="headerlink" href="#LogTrait" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>A logging trait</p>
+          <dl class="php method">
+            <dt class="sig sig-object php" id="LogTrait::log"><span class="sig-name descname"><span class="pre">log</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="pre">$level</span></em>, <em class="sig-param"><span class="pre">$string</span></em><span class="sig-paren">)</span><a class="headerlink" href="#LogTrait::log" title="Permalink to this definition">&#xB6;</a></dt>
+            <dd>
+              <p>A method description.</p>
+            </dd>
+          </dl>
+        </dd>
+      </dl>
+    </section>
+    <section id="more-globals-after-classes">
+      <h2>More globals after classes<a class="headerlink" href="#more-globals-after-classes" title="Permalink to this heading">&#xB6;</a></h2>
+      <dl class="php global">
+        <dt class="sig sig-object php" id="$other_global_var">
+          <span class="sig-name descname">
+            <span class="pre">$other_global_var</span>
+          </span>
+          <a class="headerlink" href="#$other_global_var" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>A global variable</p>
+        </dd>
+      </dl>
+      <dl class="php function">
+        <dt class="sig sig-object php" id="strpos"><span class="sig-name descname"><span class="pre">strpos</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="pre">$needle</span></em>, <em class="sig-param"><span class="pre">$haystack</span></em><span class="sig-paren">)</span><a class="headerlink" href="#strpos" title="Permalink to this definition">&#xB6;</a></dt>
+        <dd>
+          <p>Position of needle in haystack</p>
+        </dd>
+      </dl>
+      <section id="test-case-global-symbols-with-no-namespaces">
+        <h3>Test Case - Global symbols with no namespaces<a class="headerlink" href="#test-case-global-symbols-with-no-namespaces" title="Permalink to this heading">&#xB6;</a></h3>
+        <p>
+          <a class="reference internal" href="#$global_var" title="$global_var">
+            <code class="xref php php-global docutils literal notranslate">
+              <span class="pre">$global_var</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#$other_global_var" title="$other_global_var">
+            <code class="xref php php-global docutils literal notranslate">
+              <span class="pre">$other_global_var</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#SOME_CONSTANT" title="SOME_CONSTANT">
+            <code class="xref php php-const docutils literal notranslate">
+              <span class="pre">SOME_CONSTANT</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#in_array" title="in_array">
+            <code class="xref php php-func docutils literal notranslate">
+              <span class="pre">in_array</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#strpos" title="strpos">
+            <code class="xref php php-func docutils literal notranslate">
+              <span class="pre">strpos</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#DateTime" title="DateTime">
+            <code class="xref php php-class docutils literal notranslate">
+              <span class="pre">DateTime</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#DateTime::setTime" title="DateTime::setTime">
+            <code class="xref php php-meth docutils literal notranslate">
+              <span class="pre">DateTime::setTime()</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#DateTime::getLastErrors" title="DateTime::getLastErrors">
+            <code class="xref php php-meth docutils literal notranslate">
+              <span class="pre">DateTime::getLastErrors()</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#DateTime::setDate" title="DateTime::setDate">
+            <code class="xref php php-meth docutils literal notranslate">
+              <span class="pre">DateTime::setDate()</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#DateTime::ATOM" title="DateTime::ATOM">
+            <code class="xref php php-const docutils literal notranslate">
+              <span class="pre">DateTime::ATOM</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#DateTime::$testattr" title="DateTime::$testattr">
+            <code class="xref php php-attr docutils literal notranslate">
+              <span class="pre">DateTime::$testattr</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#OtherClass::update" title="OtherClass::update">
+            <code class="xref php php-meth docutils literal notranslate">
+              <span class="pre">OtherClass::update</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#OtherClass::$nonIndentedAttribute" title="OtherClass::$nonIndentedAttribute">
+            <code class="xref php php-attr docutils literal notranslate">
+              <span class="pre">OtherClass::$nonIndentedAttribute</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#OtherClass::NO_INDENT" title="OtherClass::NO_INDENT">
+            <code class="xref php php-const docutils literal notranslate">
+              <span class="pre">OtherClass::NO_INDENT</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#OtherClass::staticMethod" title="OtherClass::staticMethod">
+            <code class="xref php php-func docutils literal notranslate">
+              <span class="pre">OtherClass::staticMethod</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#InvalidArgumentException" title="InvalidArgumentException">
+            <code class="xref php php-exc docutils literal notranslate">
+              <span class="pre">InvalidArgumentException</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#DateTimeInterface" title="DateTimeInterface">
+            <code class="xref php php-interface docutils literal notranslate">
+              <span class="pre">DateTimeInterface</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#DateTimeInterface::setTime" title="DateTimeInterface::setTime">
+            <code class="xref php php-meth docutils literal notranslate">
+              <span class="pre">DateTimeInterface::setTime()</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#DateTimeInterface::setDate" title="DateTimeInterface::setDate">
+            <code class="xref php php-meth docutils literal notranslate">
+              <span class="pre">setDate()</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#DateTimeInterface::ATOM" title="DateTimeInterface::ATOM">
+            <code class="xref php php-const docutils literal notranslate">
+              <span class="pre">DateTimeInterface::ATOM</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#DateTimeInterface::$testattr" title="DateTimeInterface::$testattr">
+            <code class="xref php php-attr docutils literal notranslate">
+              <span class="pre">DateTimeInterface::$testattr</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#OtherInterface" title="OtherInterface">
+            <code class="xref php php-interface docutils literal notranslate">
+              <span class="pre">OtherInterface</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LogTrait" title="LogTrait">
+            <code class="xref php php-trait docutils literal notranslate">
+              <span class="pre">LogTrait</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LogTrait::log" title="LogTrait::log">
+            <code class="xref php php-meth docutils literal notranslate">
+              <span class="pre">LogTrait::log()</span>
+            </code>
+          </a>
+        </p>
+      </section>
+      <section id="test-case-prefix-less-links">
+        <h3>Test Case - Prefix less links<a class="headerlink" href="#test-case-prefix-less-links" title="Permalink to this heading">&#xB6;</a></h3>
+        <p>The following links should not be prefixed with a classname.</p>
+        <p>
+          <a class="reference internal" href="#DateTime::setDate" title="DateTime::setDate">
+            <code class="xref php php-meth docutils literal notranslate">
+              <span class="pre">setDate()</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#DateTime::$testattr" title="DateTime::$testattr">
+            <code class="xref php php-attr docutils literal notranslate">
+              <span class="pre">$testattr</span>
+            </code>
+          </a>
+        </p>
+      </section>
+    </section>
+    <section id="namespace-LibraryName">
+      <span id="namespaced-elements"/>
+      <h2>Namespaced elements<a class="headerlink" href="#namespace-LibraryName" title="Permalink to this heading">&#xB6;</a></h2>
+      <dl class="php function">
+        <dt class="sig sig-object php" id="LibraryName\namespaced_function"><span class="sig-prename descclassname"><span class="pre">LibraryName\</span></span><span class="sig-name descname"><span class="pre">namespaced_function</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="pre">$one</span></em><span class="optional">[</span>, <em class="sig-param"><span class="pre">$two</span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#LibraryName\namespaced_function" title="Permalink to this definition">&#xB6;</a></dt>
+        <dd>
+          <p>A function in a namespace</p>
+          <dl class="field-list simple">
+            <dt class="field-odd">Parameters<span class="colon">:</span></dt>
+            <dd class="field-odd">
+              <ul class="simple">
+                <li>
+                  <p><strong>$one</strong> (<span><code class="xref php php-obj docutils literal notranslate"><span class="pre">string</span></code></span>) &#x2013; First parameter.</p>
+                </li>
+                <li>
+                  <p><strong>$two</strong> (<span><code class="xref php php-obj docutils literal notranslate"><span class="pre">string</span></code></span>) &#x2013; Second parameter.</p>
+                </li>
+              </ul>
+            </dd>
+          </dl>
+        </dd>
+      </dl>
+      <dl class="php const">
+        <dt class="sig sig-object php" id="LibraryName\NS_CONST">
+          <em class="property">
+            <span class="pre">constant</span>
+          </em>
+          <span class="sig-prename descclassname">
+            <span class="pre">LibraryName\</span>
+          </span>
+          <span class="sig-name descname">
+            <span class="pre">NS_CONST</span>
+          </span>
+          <a class="headerlink" href="#LibraryName\NS_CONST" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>A constant in a namespace</p>
+        </dd>
+      </dl>
+      <dl class="php exception">
+        <dt class="sig sig-object php" id="LibraryName\NamespaceException">
+          <em class="property">
+            <span class="pre">exception</span>
+          </em>
+          <span class="sig-prename descclassname">
+            <span class="pre">LibraryName\</span>
+          </span>
+          <span class="sig-name descname">
+            <span class="pre">NamespaceException</span>
+          </span>
+          <a class="headerlink" href="#LibraryName\NamespaceException" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>This exception is in a namespace.</p>
+        </dd>
+      </dl>
+      <dl class="php class">
+        <dt class="sig sig-object php" id="LibraryName\LibraryClass">
+          <em class="property">
+            <span class="pre">class</span>
+          </em>
+          <span class="sig-prename descclassname">
+            <span class="pre">LibraryName\</span>
+          </span>
+          <span class="sig-name descname">
+            <span class="pre">LibraryClass</span>
+          </span>
+          <a class="headerlink" href="#LibraryName\LibraryClass" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>A class in a namespace</p>
+          <dl class="php method">
+            <dt class="sig sig-object php" id="LibraryName\LibraryClass::instanceMethod">
+              <span class="sig-prename descclassname">
+                <span class="pre">LibraryClass::</span>
+              </span>
+              <span class="sig-name descname">
+                <span class="pre">instanceMethod</span>
+              </span>
+              <span class="sig-paren">(</span>
+              <em class="sig-param">
+                <span class="pre">$foo</span>
+              </em>
+              <span class="sig-paren">)</span>
+              <a class="headerlink" href="#LibraryName\LibraryClass::instanceMethod" title="Permalink to this definition">&#xB6;</a>
+            </dt>
+            <dd>
+              <p>An instance method</p>
+            </dd>
+          </dl>
+          <dl class="php const">
+            <dt class="sig sig-object php" id="LibraryName\LibraryClass::TEST_CONST">
+              <em class="property">
+                <span class="pre">constant</span>
+              </em>
+              <span class="sig-name descname">
+                <span class="pre">TEST_CONST</span>
+              </span>
+              <a class="headerlink" href="#LibraryName\LibraryClass::TEST_CONST" title="Permalink to this definition">&#xB6;</a>
+            </dt>
+            <dd>
+              <p>Test constant</p>
+            </dd>
+          </dl>
+          <dl class="php attr">
+            <dt class="sig sig-object php" id="LibraryName\LibraryClass::$property">
+              <em class="property">
+                <span class="pre">property</span>
+              </em>
+              <span class="sig-name descname">
+                <span class="pre">property</span>
+              </span>
+              <a class="headerlink" href="#LibraryName\LibraryClass::$property" title="Permalink to this definition">&#xB6;</a>
+            </dt>
+            <dd>
+              <p>A property!</p>
+            </dd>
+          </dl>
+        </dd>
+      </dl>
+      <dl class="php staticmethod">
+        <dt class="sig sig-object php" id="LibraryName\LibraryClass::staticMethod">
+          <em class="property">
+            <span class="pre">static</span>
+          </em>
+          <span class="sig-prename descclassname">
+            <span class="pre">LibraryName\LibraryClass::</span>
+          </span>
+          <span class="sig-name descname">
+            <span class="pre">staticMethod</span>
+          </span>
+          <a class="headerlink" href="#LibraryName\LibraryClass::staticMethod" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>A static method in a namespace</p>
+        </dd>
+      </dl>
+      <dl class="php class">
+        <dt class="sig sig-object php" id="LibraryName\NamespaceClass">
+          <em class="property">
+            <span class="pre">class</span>
+          </em>
+          <span class="sig-prename descclassname">
+            <span class="pre">LibraryName\</span>
+          </span>
+          <span class="sig-name descname">
+            <span class="pre">NamespaceClass</span>
+          </span>
+          <a class="headerlink" href="#LibraryName\NamespaceClass" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>A class in the namespace, no indenting on children</p>
+        </dd>
+      </dl>
+      <dl class="php method">
+        <dt class="sig sig-object php" id="LibraryName\NamespaceClass::firstMethod"><span class="sig-prename descclassname"><span class="pre">LibraryName\NamespaceClass::</span></span><span class="sig-name descname"><span class="pre">firstMethod</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="pre">$one</span></em>, <em class="sig-param"><span class="pre">$two</span></em><span class="sig-paren">)</span><a class="headerlink" href="#LibraryName\NamespaceClass::firstMethod" title="Permalink to this definition">&#xB6;</a></dt>
+        <dd>
+          <p>A normal instance method.</p>
+        </dd>
+      </dl>
+      <dl class="php attr">
+        <dt class="sig sig-object php" id="LibraryName\NamespaceClass::$property">
+          <em class="property">
+            <span class="pre">property</span>
+          </em>
+          <span class="sig-prename descclassname">
+            <span class="pre">LibraryName\NamespaceClass::$</span>
+          </span>
+          <span class="sig-name descname">
+            <span class="pre">property</span>
+          </span>
+          <a class="headerlink" href="#LibraryName\NamespaceClass::$property" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>A property</p>
+        </dd>
+      </dl>
+      <dl class="php const">
+        <dt class="sig sig-object php" id="LibraryName\NamespaceClass::NAMESPACE_CONST">
+          <em class="property">
+            <span class="pre">constant</span>
+          </em>
+          <span class="sig-prename descclassname">
+            <span class="pre">LibraryName\NamespaceClass::</span>
+          </span>
+          <span class="sig-name descname">
+            <span class="pre">NAMESPACE_CONST</span>
+          </span>
+          <a class="headerlink" href="#LibraryName\NamespaceClass::NAMESPACE_CONST" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>Const on class in namespace</p>
+        </dd>
+      </dl>
+      <dl class="php staticmethod">
+        <dt class="sig sig-object php" id="LibraryName\NamespaceClass::namespaceStatic">
+          <em class="property">
+            <span class="pre">static</span>
+          </em>
+          <span class="sig-prename descclassname">
+            <span class="pre">LibraryName\NamespaceClass::</span>
+          </span>
+          <span class="sig-name descname">
+            <span class="pre">namespaceStatic</span>
+          </span>
+          <span class="sig-paren">(</span>
+          <em class="sig-param">
+            <span class="pre">$foo</span>
+          </em>
+          <span class="sig-paren">)</span>
+          <a class="headerlink" href="#LibraryName\NamespaceClass::namespaceStatic" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>A static method here.</p>
+        </dd>
+      </dl>
+      <dl class="php class">
+        <dt class="sig sig-object php" id="LibraryName\LibraryClassFinal">
+          <em class="property">
+            <span class="pre">final</span>
+          </em>
+          <em class="property">
+            <span class="pre">class</span>
+          </em>
+          <span class="sig-prename descclassname">
+            <span class="pre">LibraryName\</span>
+          </span>
+          <span class="sig-name descname">
+            <span class="pre">LibraryClassFinal</span>
+          </span>
+          <a class="headerlink" href="#LibraryName\LibraryClassFinal" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>A final class</p>
+        </dd>
+      </dl>
+      <dl class="php method">
+        <dt class="sig sig-object php" id="LibraryName\LibraryClassFinal::firstMethod"><em class="property"><span class="pre">public</span></em><span class="sig-prename descclassname"><span class="pre">LibraryName\LibraryClassFinal::</span></span><span class="sig-name descname"><span class="pre">firstMethod</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="pre">$one</span></em>, <em class="sig-param"><span class="pre">$two</span></em><span class="sig-paren">)</span><a class="headerlink" href="#LibraryName\LibraryClassFinal::firstMethod" title="Permalink to this definition">&#xB6;</a></dt>
+        <dd>
+          <p>A public instance method.</p>
+        </dd>
+      </dl>
+      <dl class="php method">
+        <dt class="sig sig-object php" id="LibraryName\LibraryClassFinal::secondMethod"><em class="property"><span class="pre">protected</span></em><span class="sig-prename descclassname"><span class="pre">LibraryName\LibraryClassFinal::</span></span><span class="sig-name descname"><span class="pre">secondMethod</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="pre">$one</span></em>, <em class="sig-param"><span class="pre">$two</span></em><span class="sig-paren">)</span><a class="headerlink" href="#LibraryName\LibraryClassFinal::secondMethod" title="Permalink to this definition">&#xB6;</a></dt>
+        <dd>
+          <p>A protected instance method.</p>
+        </dd>
+      </dl>
+      <dl class="php method">
+        <dt class="sig sig-object php" id="LibraryName\LibraryClassFinal::thirdMethod"><em class="property"><span class="pre">private</span></em><span class="sig-prename descclassname"><span class="pre">LibraryName\LibraryClassFinal::</span></span><span class="sig-name descname"><span class="pre">thirdMethod</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="pre">$one</span></em>, <em class="sig-param"><span class="pre">$two</span></em><span class="sig-paren">)</span><a class="headerlink" href="#LibraryName\LibraryClassFinal::thirdMethod" title="Permalink to this definition">&#xB6;</a></dt>
+        <dd>
+          <p>A private instance method.</p>
+        </dd>
+      </dl>
+      <dl class="php method">
+        <dt class="sig sig-object php" id="LibraryName\LibraryClassFinal::fourthMethod"><em class="property"><span class="pre">static</span></em><span class="sig-prename descclassname"><span class="pre">LibraryName\LibraryClassFinal::</span></span><span class="sig-name descname"><span class="pre">fourthMethod</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="pre">$one</span></em>, <em class="sig-param"><span class="pre">$two</span></em><span class="sig-paren">)</span><a class="headerlink" href="#LibraryName\LibraryClassFinal::fourthMethod" title="Permalink to this definition">&#xB6;</a></dt>
+        <dd>
+          <p>A static method.</p>
+        </dd>
+      </dl>
+      <dl class="php method">
+        <dt class="sig sig-object php" id="LibraryName\LibraryClassFinal::fifthMethod"><em class="property"><span class="pre">protected</span></em><em class="property"><span class="pre">final</span></em><span class="sig-prename descclassname"><span class="pre">LibraryName\LibraryClassFinal::</span></span><span class="sig-name descname"><span class="pre">fifthMethod</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="pre">$one</span></em>, <em class="sig-param"><span class="pre">$two</span></em><span class="sig-paren">)</span><a class="headerlink" href="#LibraryName\LibraryClassFinal::fifthMethod" title="Permalink to this definition">&#xB6;</a></dt>
+        <dd>
+          <p>A protected final method.</p>
+        </dd>
+      </dl>
+      <dl class="php class">
+        <dt class="sig sig-object php" id="LibraryName\LibraryClassAbstract">
+          <em class="property">
+            <span class="pre">abstract</span>
+          </em>
+          <em class="property">
+            <span class="pre">class</span>
+          </em>
+          <span class="sig-prename descclassname">
+            <span class="pre">LibraryName\</span>
+          </span>
+          <span class="sig-name descname">
+            <span class="pre">LibraryClassAbstract</span>
+          </span>
+          <a class="headerlink" href="#LibraryName\LibraryClassAbstract" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>An abstract class</p>
+        </dd>
+      </dl>
+      <dl class="php interface">
+        <dt class="sig sig-object php" id="LibraryName\LibraryInterface">
+          <em class="property">
+            <span class="pre">interface</span>
+          </em>
+          <span class="sig-prename descclassname">
+            <span class="pre">LibraryName\</span>
+          </span>
+          <span class="sig-name descname">
+            <span class="pre">LibraryInterface</span>
+          </span>
+          <a class="headerlink" href="#LibraryName\LibraryInterface" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>A interface in a namespace</p>
+          <dl class="php method">
+            <dt class="sig sig-object php" id="LibraryName\LibraryInterface::instanceMethod">
+              <span class="sig-name descname">
+                <span class="pre">instanceMethod</span>
+              </span>
+              <span class="sig-paren">(</span>
+              <em class="sig-param">
+                <span class="pre">$foo</span>
+              </em>
+              <span class="sig-paren">)</span>
+              <a class="headerlink" href="#LibraryName\LibraryInterface::instanceMethod" title="Permalink to this definition">&#xB6;</a>
+            </dt>
+            <dd/>
+          </dl>
+          <p>An instance method</p>
+        </dd>
+      </dl>
+      <dl class="php trait">
+        <dt class="sig sig-object php" id="LibraryName\TemplateTrait">
+          <em class="property">
+            <span class="pre">trait</span>
+          </em>
+          <span class="sig-prename descclassname">
+            <span class="pre">LibraryName\</span>
+          </span>
+          <span class="sig-name descname">
+            <span class="pre">TemplateTrait</span>
+          </span>
+          <a class="headerlink" href="#LibraryName\TemplateTrait" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>A trait in a namespace</p>
+          <dl class="php method">
+            <dt class="sig sig-object php" id="LibraryName\TemplateTrait::render">
+              <span class="sig-name descname">
+                <span class="pre">render</span>
+              </span>
+              <span class="sig-paren">(</span>
+              <em class="sig-param">
+                <span class="pre">$template</span>
+              </em>
+              <span class="sig-paren">)</span>
+              <a class="headerlink" href="#LibraryName\TemplateTrait::render" title="Permalink to this definition">&#xB6;</a>
+            </dt>
+            <dd/>
+          </dl>
+          <p>Render a template.</p>
+        </dd>
+      </dl>
+      <section id="test-case-not-including-namespace">
+        <h3>Test Case - not including namespace<a class="headerlink" href="#test-case-not-including-namespace" title="Permalink to this heading">&#xB6;</a></h3>
+        <p>Within a namespace context you don&#x2019;t need to include the namespace in links.</p>
+        <p>
+          <a class="reference internal" href="#namespace-LibraryName">
+            <code class="xref php php-ns docutils literal notranslate">
+              <span class="pre">LibraryName</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\namespaced_function" title="LibraryName\namespaced_function">
+            <code class="xref php php-func docutils literal notranslate">
+              <span class="pre">namespaced_function()</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\NS_CONST" title="LibraryName\NS_CONST">
+            <code class="xref php php-const docutils literal notranslate">
+              <span class="pre">NS_CONST</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\LibraryClass" title="LibraryName\LibraryClass">
+            <code class="xref php php-class docutils literal notranslate">
+              <span class="pre">LibraryClass</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\LibraryClass::instanceMethod" title="LibraryName\LibraryClass::instanceMethod">
+            <code class="xref php php-func docutils literal notranslate">
+              <span class="pre">LibraryClass::instanceMethod</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\LibraryClass::staticMethod" title="LibraryName\LibraryClass::staticMethod">
+            <code class="xref php php-func docutils literal notranslate">
+              <span class="pre">LibraryClass::staticMethod()</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\LibraryClass::$property" title="LibraryName\LibraryClass::$property">
+            <code class="xref php php-attr docutils literal notranslate">
+              <span class="pre">LibraryClass::$property</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\LibraryClass::TEST_CONST" title="LibraryName\LibraryClass::TEST_CONST">
+            <code class="xref php php-const docutils literal notranslate">
+              <span class="pre">LibraryClass::TEST_CONST</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="rst_doc2.html#LibraryName\OtherClass" title="LibraryName\OtherClass">
+            <code class="xref php php-class docutils literal notranslate">
+              <span class="pre">OtherClass</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="rst_doc2.html#LibraryName\ThirdClass" title="LibraryName\ThirdClass">
+            <code class="xref php php-class docutils literal notranslate">
+              <span class="pre">ThirdClass</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\NamespaceClass" title="LibraryName\NamespaceClass">
+            <code class="xref php php-class docutils literal notranslate">
+              <span class="pre">NamespaceClass</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\NamespaceClass::firstMethod" title="LibraryName\NamespaceClass::firstMethod">
+            <code class="xref php php-func docutils literal notranslate">
+              <span class="pre">NamespaceClass::firstMethod</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\NamespaceClass::$property" title="LibraryName\NamespaceClass::$property">
+            <code class="xref php php-attr docutils literal notranslate">
+              <span class="pre">NamespaceClass::$property</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\NamespaceClass::NAMESPACE_CONST" title="LibraryName\NamespaceClass::NAMESPACE_CONST">
+            <code class="xref php php-const docutils literal notranslate">
+              <span class="pre">NamespaceClass::NAMESPACE_CONST</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\LibraryClassFinal" title="LibraryName\LibraryClassFinal">
+            <code class="xref php php-class docutils literal notranslate">
+              <span class="pre">LibraryClassFinal</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\LibraryClassFinal::firstMethod" title="LibraryName\LibraryClassFinal::firstMethod">
+            <code class="xref php php-meth docutils literal notranslate">
+              <span class="pre">LibraryClassFinal::firstMethod</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\LibraryClassFinal::secondMethod" title="LibraryName\LibraryClassFinal::secondMethod">
+            <code class="xref php php-meth docutils literal notranslate">
+              <span class="pre">LibraryClassFinal::secondMethod</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\LibraryClassFinal::thirdMethod" title="LibraryName\LibraryClassFinal::thirdMethod">
+            <code class="xref php php-meth docutils literal notranslate">
+              <span class="pre">LibraryClassFinal::thirdMethod</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\LibraryClassFinal::fourthMethod" title="LibraryName\LibraryClassFinal::fourthMethod">
+            <code class="xref php php-meth docutils literal notranslate">
+              <span class="pre">LibraryClassFinal::fourthMethod</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\LibraryClassFinal::fifthMethod" title="LibraryName\LibraryClassFinal::fifthMethod">
+            <code class="xref php php-meth docutils literal notranslate">
+              <span class="pre">LibraryClassFinal::fifthMethod</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\LibraryInterface" title="LibraryName\LibraryInterface">
+            <code class="xref php php-interface docutils literal notranslate">
+              <span class="pre">LibraryInterface</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\LibraryInterface::instanceMethod" title="LibraryName\LibraryInterface::instanceMethod">
+            <code class="xref php php-func docutils literal notranslate">
+              <span class="pre">LibraryInterface::instanceMethod</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\NamespaceException" title="LibraryName\NamespaceException">
+            <code class="xref php php-exc docutils literal notranslate">
+              <span class="pre">NamespaceException</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\TemplateTrait" title="LibraryName\TemplateTrait">
+            <code class="xref php php-trait docutils literal notranslate">
+              <span class="pre">TemplateTrait</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\TemplateTrait::render" title="LibraryName\TemplateTrait::render">
+            <code class="xref php php-meth docutils literal notranslate">
+              <span class="pre">TemplateTrait::render()</span>
+            </code>
+          </a>
+        </p>
+      </section>
+      <section id="test-case-links-with-prefix-trimming">
+        <h3>Test Case - Links with prefix trimming<a class="headerlink" href="#test-case-links-with-prefix-trimming" title="Permalink to this heading">&#xB6;</a></h3>
+        <p>All of the following links should not be prefixed with a namespace.</p>
+        <p>
+          <a class="reference internal" href="#LibraryName\LibraryInterface" title="LibraryName\LibraryInterface">
+            <code class="xref php php-interface docutils literal notranslate">
+              <span class="pre">LibraryInterface</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\LibraryClass" title="LibraryName\LibraryClass">
+            <code class="xref php php-class docutils literal notranslate">
+              <span class="pre">LibraryClass</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\TemplateTrait" title="LibraryName\TemplateTrait">
+            <code class="xref php php-trait docutils literal notranslate">
+              <span class="pre">TemplateTrait</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\NamespaceException" title="LibraryName\NamespaceException">
+            <code class="xref php php-exc docutils literal notranslate">
+              <span class="pre">NamespaceException</span>
+            </code>
+          </a>
+        </p>
+        <p>All of the following links should not be prefixed with a classname.</p>
+        <p>
+          <a class="reference internal" href="#LibraryName\LibraryClass::instanceMethod" title="LibraryName\LibraryClass::instanceMethod">
+            <code class="xref php php-func docutils literal notranslate">
+              <span class="pre">instanceMethod</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\LibraryClass::TEST_CONST" title="LibraryName\LibraryClass::TEST_CONST">
+            <code class="xref php php-const docutils literal notranslate">
+              <span class="pre">TEST_CONST</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\LibraryClass::$property" title="LibraryName\LibraryClass::$property">
+            <code class="xref php php-attr docutils literal notranslate">
+              <span class="pre">$property</span>
+            </code>
+          </a>
+        </p>
+      </section>
+      <section id="test-case-global-access">
+        <h3>Test Case - global access<a class="headerlink" href="#test-case-global-access" title="Permalink to this heading">&#xB6;</a></h3>
+        <p>
+          <a class="reference internal" href="#DateTime" title="DateTime">
+            <code class="xref php php-class docutils literal notranslate">
+              <span class="pre">DateTime</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#DateTime::setTime" title="DateTime::setTime">
+            <code class="xref php php-func docutils literal notranslate">
+              <span class="pre">DateTime::setTime()</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#$global_var" title="$global_var">
+            <code class="xref php php-global docutils literal notranslate">
+              <span class="pre">$global_var</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#SOME_CONSTANT" title="SOME_CONSTANT">
+            <code class="xref php php-const docutils literal notranslate">
+              <span class="pre">SOME_CONSTANT</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#in_array" title="in_array">
+            <code class="xref php php-func docutils literal notranslate">
+              <span class="pre">in_array()</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\LibraryClass::$property" title="LibraryName\LibraryClass::$property">
+            <code class="xref php php-attr docutils literal notranslate">
+              <span class="pre">LibraryName\LibraryClass::$property</span>
+            </code>
+          </a>
+        </p>
+        <p><a class="reference internal" href="#LibraryName\LibraryClass::$property" title="LibraryName\LibraryClass::$property"><code class="xref php php-attr docutils literal notranslate"><span class="pre">$property</span></code></a> Should not be prefixed with classname.</p>
+        <p>
+          <a class="reference internal" href="#LibraryName\LibraryClass::TEST_CONST" title="LibraryName\LibraryClass::TEST_CONST">
+            <code class="xref php php-const docutils literal notranslate">
+              <span class="pre">LibraryName\LibraryClass::TEST_CONST</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\NS_CONST" title="LibraryName\NS_CONST">
+            <code class="xref php php-const docutils literal notranslate">
+              <span class="pre">LibraryName\NS_CONST</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#DateTimeInterface" title="DateTimeInterface">
+            <code class="xref php php-interface docutils literal notranslate">
+              <span class="pre">DateTimeInterface</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#DateTimeInterface::setTime" title="DateTimeInterface::setTime">
+            <code class="xref php php-func docutils literal notranslate">
+              <span class="pre">DateTimeInterface::setTime()</span>
+            </code>
+          </a>
+        </p>
+      </section>
+    </section>
+    <section id="any-cross-ref">
+      <h2>Any Cross Ref<a class="headerlink" href="#any-cross-ref" title="Permalink to this heading">&#xB6;</a></h2>
+      <p>
+        <a class="reference internal" href="#LibraryName\NS_CONST" title="LibraryName\NS_CONST">
+          <code class="xref any php php-func docutils literal notranslate">
+            <span class="pre">LibraryName\NS_CONST</span>
+          </code>
+        </a>
+      </p>
+      <p>
+        <a class="reference internal" href="#DateTimeInterface::setTime" title="DateTimeInterface::setTime">
+          <code class="xref any php php-func docutils literal notranslate">
+            <span class="pre">DateTimeInterface::setTime()</span>
+          </code>
+        </a>
+      </p>
+    </section>
+    <section id="namespace-LibraryName\SubPackage">
+      <span id="nested-namespaces"/>
+      <h2>Nested namespaces<a class="headerlink" href="#namespace-LibraryName\SubPackage" title="Permalink to this heading">&#xB6;</a></h2>
+      <dl class="php exception">
+        <dt class="sig sig-object php" id="LibraryName\SubPackage\NestedNamespaceException">
+          <em class="property">
+            <span class="pre">exception</span>
+          </em>
+          <span class="sig-prename descclassname">
+            <span class="pre">LibraryName\SubPackage\</span>
+          </span>
+          <span class="sig-name descname">
+            <span class="pre">NestedNamespaceException</span>
+          </span>
+          <a class="headerlink" href="#LibraryName\SubPackage\NestedNamespaceException" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>In a package</p>
+        </dd>
+      </dl>
+      <dl class="php class">
+        <dt class="sig sig-object php" id="LibraryName\SubPackage\SubpackageClass">
+          <em class="property">
+            <span class="pre">class</span>
+          </em>
+          <span class="sig-prename descclassname">
+            <span class="pre">LibraryName\SubPackage\</span>
+          </span>
+          <span class="sig-name descname">
+            <span class="pre">SubpackageClass</span>
+          </span>
+          <a class="headerlink" href="#LibraryName\SubPackage\SubpackageClass" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>A class in a subpackage</p>
+        </dd>
+      </dl>
+      <dl class="php interface">
+        <dt class="sig sig-object php" id="LibraryName\SubPackage\SubpackageInterface">
+          <em class="property">
+            <span class="pre">interface</span>
+          </em>
+          <span class="sig-prename descclassname">
+            <span class="pre">LibraryName\SubPackage\</span>
+          </span>
+          <span class="sig-name descname">
+            <span class="pre">SubpackageInterface</span>
+          </span>
+          <a class="headerlink" href="#LibraryName\SubPackage\SubpackageInterface" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>A class in a subpackage</p>
+        </dd>
+      </dl>
+      <section id="test-case-test-subpackage-links">
+        <h3>Test Case - Test subpackage links<a class="headerlink" href="#test-case-test-subpackage-links" title="Permalink to this heading">&#xB6;</a></h3>
+        <p>
+          <a class="reference internal" href="#namespace-LibraryName\SubPackage">
+            <code class="xref php php-ns docutils literal notranslate">
+              <span class="pre">LibraryName\SubPackage</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <code class="xref php php-ns docutils literal notranslate">
+            <span class="pre">LibraryName\SubPackage</span>
+          </code>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\SubPackage\SubpackageClass" title="LibraryName\SubPackage\SubpackageClass">
+            <code class="xref php php-class docutils literal notranslate">
+              <span class="pre">SubpackageClass</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\SubPackage\SubpackageClass" title="LibraryName\SubPackage\SubpackageClass">
+            <code class="xref php php-class docutils literal notranslate">
+              <span class="pre">LibraryName\SubPackage\SubpackageClass</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\SubPackage\SubpackageInterface" title="LibraryName\SubPackage\SubpackageInterface">
+            <code class="xref php php-interface docutils literal notranslate">
+              <span class="pre">SubpackageInterface</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\SubPackage\SubpackageInterface" title="LibraryName\SubPackage\SubpackageInterface">
+            <code class="xref php php-class docutils literal notranslate">
+              <span class="pre">LibraryName\SubPackage\SubpackageInterface</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\SubPackage\NestedNamespaceException" title="LibraryName\SubPackage\NestedNamespaceException">
+            <code class="xref php php-exc docutils literal notranslate">
+              <span class="pre">NestedNamespaceException</span>
+            </code>
+          </a>
+        </p>
+        <p>
+          <a class="reference internal" href="#LibraryName\SubPackage\NestedNamespaceException" title="LibraryName\SubPackage\NestedNamespaceException">
+            <code class="xref php php-exc docutils literal notranslate">
+              <span class="pre">LibraryName\SubPackage\NestedNamespaceException</span>
+            </code>
+          </a>
+        </p>
+      </section>
+    </section>
+    <section id="namespace-OtherLibrary">
+      <span id="return-types"/>
+      <h2>Return Types<a class="headerlink" href="#namespace-OtherLibrary" title="Permalink to this heading">&#xB6;</a></h2>
+      <dl class="php class">
+        <dt class="sig sig-object php" id="OtherLibrary\ReturningClass">
+          <em class="property">
+            <span class="pre">class</span>
+          </em>
+          <span class="sig-prename descclassname">
+            <span class="pre">OtherLibrary\</span>
+          </span>
+          <span class="sig-name descname">
+            <span class="pre">ReturningClass</span>
+          </span>
+          <a class="headerlink" href="#OtherLibrary\ReturningClass" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>A class to do some returning.</p>
+          <dl class="php method">
+            <dt class="sig sig-object php" id="OtherLibrary\ReturningClass::returnClassFromSameNamespace">
+              <span class="sig-name descname">
+                <span class="pre">returnClassFromSameNamespace</span>
+              </span>
+              <span class="sig-paren">(</span>
+              <span class="sig-paren">)</span>
+              <a class="headerlink" href="#OtherLibrary\ReturningClass::returnClassFromSameNamespace" title="Permalink to this definition">&#xB6;</a>
+            </dt>
+            <dd>
+              <dl class="field-list simple">
+                <dt class="field-odd">Returns<span class="colon">:</span></dt>
+                <dd class="field-odd">
+                  <p>An object instance of a class from the same namespace.</p>
+                </dd>
+                <dt class="field-even">Return type<span class="colon">:</span></dt>
+                <dd class="field-even">
+                  <p>
+                    <span>
+                      <a class="reference internal" href="#OtherLibrary\ReturnedClass" title="OtherLibrary\ReturnedClass">
+                        <code class="xref php php-obj docutils literal notranslate">
+                          <span class="pre">ReturnedClass</span>
+                        </code>
+                      </a>
+                    </span>
+                  </p>
+                </dd>
+              </dl>
+            </dd>
+          </dl>
+          <dl class="php method">
+            <dt class="sig sig-object php" id="OtherLibrary\ReturningClass::returnClassFromOtherNamespace">
+              <span class="sig-name descname">
+                <span class="pre">returnClassFromOtherNamespace</span>
+              </span>
+              <span class="sig-paren">(</span>
+              <span class="sig-paren">)</span>
+              <a class="headerlink" href="#OtherLibrary\ReturningClass::returnClassFromOtherNamespace" title="Permalink to this definition">&#xB6;</a>
+            </dt>
+            <dd>
+              <dl class="field-list simple">
+                <dt class="field-odd">Returns<span class="colon">:</span></dt>
+                <dd class="field-odd">
+                  <p>An object instance of a class from another namespace.</p>
+                </dd>
+                <dt class="field-even">Return type<span class="colon">:</span></dt>
+                <dd class="field-even">
+                  <p>
+                    <span>
+                      <a class="reference internal" href="#LibraryName\SubPackage\SubpackageInterface" title="LibraryName\SubPackage\SubpackageInterface">
+                        <code class="xref php php-obj docutils literal notranslate">
+                          <span class="pre">LibraryName\SubPackage\SubpackageInterface</span>
+                        </code>
+                      </a>
+                    </span>
+                  </p>
+                </dd>
+              </dl>
+            </dd>
+          </dl>
+          <dl class="php method">
+            <dt class="sig sig-object php" id="OtherLibrary\ReturningClass::returnClassConstant">
+              <span class="sig-name descname">
+                <span class="pre">returnClassConstant</span>
+              </span>
+              <span class="sig-paren">(</span>
+              <span class="sig-paren">)</span>
+              <a class="headerlink" href="#OtherLibrary\ReturningClass::returnClassConstant" title="Permalink to this definition">&#xB6;</a>
+            </dt>
+            <dd>
+              <dl class="field-list simple">
+                <dt class="field-odd">Returns<span class="colon">:</span></dt>
+                <dd class="field-odd">
+                  <p>The value of a specific class constant.</p>
+                </dd>
+                <dt class="field-even">Return type<span class="colon">:</span></dt>
+                <dd class="field-even">
+                  <p>
+                    <span>
+                      <a class="reference internal" href="#LibraryName\NamespaceClass::NAMESPACE_CONST" title="LibraryName\NamespaceClass::NAMESPACE_CONST">
+                        <code class="xref php php-obj docutils literal notranslate">
+                          <span class="pre">LibraryName\NamespaceClass::NAMESPACE_CONST</span>
+                        </code>
+                      </a>
+                    </span>
+                  </p>
+                </dd>
+              </dl>
+            </dd>
+          </dl>
+          <dl class="php method">
+            <dt class="sig sig-object php" id="OtherLibrary\ReturningClass::returnGlobalConstant">
+              <span class="sig-name descname">
+                <span class="pre">returnGlobalConstant</span>
+              </span>
+              <span class="sig-paren">(</span>
+              <span class="sig-paren">)</span>
+              <a class="headerlink" href="#OtherLibrary\ReturningClass::returnGlobalConstant" title="Permalink to this definition">&#xB6;</a>
+            </dt>
+            <dd>
+              <dl class="field-list simple">
+                <dt class="field-odd">Returns<span class="colon">:</span></dt>
+                <dd class="field-odd">
+                  <p>The value of a specific global constant. # TODO link is not working without &#x201C;\&#x201D;</p>
+                </dd>
+                <dt class="field-even">Return type<span class="colon">:</span></dt>
+                <dd class="field-even">
+                  <p>
+                    <span>
+                      <a class="reference internal" href="#SOME_CONSTANT" title="SOME_CONSTANT">
+                        <code class="xref php php-obj docutils literal notranslate">
+                          <span class="pre">SOME_CONSTANT</span>
+                        </code>
+                      </a>
+                    </span>
+                  </p>
+                </dd>
+              </dl>
+            </dd>
+          </dl>
+          <dl class="php method">
+            <dt class="sig sig-object php" id="OtherLibrary\ReturningClass::returnExceptionInstance">
+              <span class="sig-name descname">
+                <span class="pre">returnExceptionInstance</span>
+              </span>
+              <span class="sig-paren">(</span>
+              <span class="sig-paren">)</span>
+              <a class="headerlink" href="#OtherLibrary\ReturningClass::returnExceptionInstance" title="Permalink to this definition">&#xB6;</a>
+            </dt>
+            <dd>
+              <dl class="field-list simple">
+                <dt class="field-odd">Returns<span class="colon">:</span></dt>
+                <dd class="field-odd">
+                  <p>An instance of an exception.</p>
+                </dd>
+                <dt class="field-even">Return type<span class="colon">:</span></dt>
+                <dd class="field-even">
+                  <p>
+                    <span>
+                      <a class="reference internal" href="#InvalidArgumentException" title="InvalidArgumentException">
+                        <code class="xref php php-obj docutils literal notranslate">
+                          <span class="pre">InvalidArgumentException</span>
+                        </code>
+                      </a>
+                    </span>
+                  </p>
+                </dd>
+              </dl>
+            </dd>
+          </dl>
+          <dl class="php method">
+            <dt class="sig sig-object php" id="OtherLibrary\ReturningClass::returnScalarType">
+              <span class="sig-name descname">
+                <span class="pre">returnScalarType</span>
+              </span>
+              <span class="sig-paren">(</span>
+              <span class="sig-paren">)</span>
+              <a class="headerlink" href="#OtherLibrary\ReturningClass::returnScalarType" title="Permalink to this definition">&#xB6;</a>
+            </dt>
+            <dd>
+              <dl class="field-list simple">
+                <dt class="field-odd">Returns<span class="colon">:</span></dt>
+                <dd class="field-odd">
+                  <p>A scalar string type.</p>
+                </dd>
+                <dt class="field-even">Return type<span class="colon">:</span></dt>
+                <dd class="field-even">
+                  <p>
+                    <span>
+                      <code class="xref php php-obj docutils literal notranslate">
+                        <span class="pre">string</span>
+                      </code>
+                    </span>
+                  </p>
+                </dd>
+              </dl>
+            </dd>
+          </dl>
+          <dl class="php method">
+            <dt class="sig sig-object php" id="OtherLibrary\ReturningClass::returnUnionType">
+              <span class="sig-name descname">
+                <span class="pre">returnUnionType</span>
+              </span>
+              <span class="sig-paren">(</span>
+              <span class="sig-paren">)</span>
+              <a class="headerlink" href="#OtherLibrary\ReturningClass::returnUnionType" title="Permalink to this definition">&#xB6;</a>
+            </dt>
+            <dd>
+              <dl class="field-list simple">
+                <dt class="field-odd">Returns<span class="colon">:</span></dt>
+                <dd class="field-odd">
+                  <p>Any of a whole bunch of things specified with a PHP 8 union type.</p>
+                </dd>
+                <dt class="field-even">Return type<span class="colon">:</span></dt>
+                <dd class="field-even">
+                  <p>
+                    <span>
+                      <code class="xref php php-obj docutils literal notranslate">
+                        <span class="pre">int|string|ReturnedClass|\LibraryName\SubPackage\SubpackageInterface|null</span>
+                      </code>
+                    </span>
+                  </p>
+                </dd>
+              </dl>
+            </dd>
+          </dl>
+        </dd>
+      </dl>
+      <dl class="php class">
+        <dt class="sig sig-object php" id="OtherLibrary\ReturnedClass">
+          <em class="property">
+            <span class="pre">class</span>
+          </em>
+          <span class="sig-prename descclassname">
+            <span class="pre">OtherLibrary\</span>
+          </span>
+          <span class="sig-name descname">
+            <span class="pre">ReturnedClass</span>
+          </span>
+          <a class="headerlink" href="#OtherLibrary\ReturnedClass" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>A class to return.</p>
+        </dd>
+      </dl>
+    </section>
+    <section id="enums">
+      <h2>Enums<a class="headerlink" href="#enums" title="Permalink to this heading">&#xB6;</a></h2>
+      <section id="namespace-Example\Basic">
+        <span id="basic-enumerations"/>
+        <h3>Basic Enumerations<a class="headerlink" href="#namespace-Example\Basic" title="Permalink to this heading">&#xB6;</a></h3>
+        <dl class="php enum">
+          <dt class="sig sig-object php" id="Example\Basic\Suit">
+            <em class="property">
+              <span class="pre">enum</span>
+            </em>
+            <span class="sig-prename descclassname">
+              <span class="pre">Example\Basic\</span>
+            </span>
+            <span class="sig-name descname">
+              <span class="pre">Suit</span>
+            </span>
+            <a class="headerlink" href="#Example\Basic\Suit" title="Permalink to this definition">&#xB6;</a>
+          </dt>
+          <dd>
+            <p>In playing cards, a suit is one of the categories into which the cards of a
+deck are divided.</p>
+            <dl class="php case">
+              <dt class="sig sig-object php" id="Example\Basic\Suit::Hearts">
+                <em class="property">
+                  <span class="pre">case</span>
+                </em>
+                <span class="sig-name descname">
+                  <span class="pre">Hearts</span>
+                </span>
+                <a class="headerlink" href="#Example\Basic\Suit::Hearts" title="Permalink to this definition">&#xB6;</a>
+              </dt>
+              <dd/>
+            </dl>
+            <dl class="php case">
+              <dt class="sig sig-object php" id="Example\Basic\Suit::Diamonds">
+                <em class="property">
+                  <span class="pre">case</span>
+                </em>
+                <span class="sig-name descname">
+                  <span class="pre">Diamonds</span>
+                </span>
+                <a class="headerlink" href="#Example\Basic\Suit::Diamonds" title="Permalink to this definition">&#xB6;</a>
+              </dt>
+              <dd/>
+            </dl>
+            <dl class="php case">
+              <dt class="sig sig-object php" id="Example\Basic\Suit::Clubs">
+                <em class="property">
+                  <span class="pre">case</span>
+                </em>
+                <span class="sig-name descname">
+                  <span class="pre">Clubs</span>
+                </span>
+                <a class="headerlink" href="#Example\Basic\Suit::Clubs" title="Permalink to this definition">&#xB6;</a>
+              </dt>
+              <dd/>
+            </dl>
+            <dl class="php case">
+              <dt class="sig sig-object php" id="Example\Basic\Suit::Spades">
+                <em class="property">
+                  <span class="pre">case</span>
+                </em>
+                <span class="sig-name descname">
+                  <span class="pre">Spades</span>
+                </span>
+                <a class="headerlink" href="#Example\Basic\Suit::Spades" title="Permalink to this definition">&#xB6;</a>
+              </dt>
+              <dd/>
+            </dl>
+          </dd>
+        </dl>
+      </section>
+      <section id="namespace-Example\Backed">
+        <span id="backed-enumerations"/>
+        <h3>Backed Enumerations<a class="headerlink" href="#namespace-Example\Backed" title="Permalink to this heading">&#xB6;</a></h3>
+        <dl class="php enum">
+          <dt class="sig sig-object php" id="Example\Backed\Suit">
+            <em class="property">
+              <span class="pre">enum</span>
+            </em>
+            <span class="sig-prename descclassname">
+              <span class="pre">Example\Backed\</span>
+            </span>
+            <span class="sig-name descname">
+              <span class="pre">Suit</span>
+            </span>
+            <span class="sig-return">
+              <span class="sig-return-icon">&#x2192;</span>
+              <span class="sig-return-typehint">
+                <span class="pre">string</span>
+              </span>
+            </span>
+            <a class="headerlink" href="#Example\Backed\Suit" title="Permalink to this definition">&#xB6;</a>
+          </dt>
+          <dd>
+            <p>In playing cards, a suit is one of the categories into which the cards of a
+deck are divided.</p>
+            <dl class="php case">
+              <dt class="sig sig-object php" id="Example\Backed\Suit::Hearts">
+                <em class="property">
+                  <span class="pre">case</span>
+                </em>
+                <span class="sig-name descname">
+                  <span class="pre">Hearts</span>
+                </span>
+                <span class="sig-return">
+                  <span class="sig-return-icon">&#x2192;</span>
+                  <span class="sig-return-typehint">
+                    <span class="pre">'H'</span>
+                  </span>
+                </span>
+                <a class="headerlink" href="#Example\Backed\Suit::Hearts" title="Permalink to this definition">&#xB6;</a>
+              </dt>
+              <dd/>
+            </dl>
+            <dl class="php case">
+              <dt class="sig sig-object php" id="Example\Backed\Suit::Diamonds">
+                <em class="property">
+                  <span class="pre">case</span>
+                </em>
+                <span class="sig-name descname">
+                  <span class="pre">Diamonds</span>
+                </span>
+                <span class="sig-return">
+                  <span class="sig-return-icon">&#x2192;</span>
+                  <span class="sig-return-typehint">
+                    <span class="pre">'D'</span>
+                  </span>
+                </span>
+                <a class="headerlink" href="#Example\Backed\Suit::Diamonds" title="Permalink to this definition">&#xB6;</a>
+              </dt>
+              <dd/>
+            </dl>
+            <dl class="php case">
+              <dt class="sig sig-object php" id="Example\Backed\Suit::Clubs">
+                <em class="property">
+                  <span class="pre">case</span>
+                </em>
+                <span class="sig-name descname">
+                  <span class="pre">Clubs</span>
+                </span>
+                <span class="sig-return">
+                  <span class="sig-return-icon">&#x2192;</span>
+                  <span class="sig-return-typehint">
+                    <span class="pre">'C'</span>
+                  </span>
+                </span>
+                <a class="headerlink" href="#Example\Backed\Suit::Clubs" title="Permalink to this definition">&#xB6;</a>
+              </dt>
+              <dd/>
+            </dl>
+            <dl class="php case">
+              <dt class="sig sig-object php" id="Example\Backed\Suit::Spades">
+                <em class="property">
+                  <span class="pre">case</span>
+                </em>
+                <span class="sig-name descname">
+                  <span class="pre">Spades</span>
+                </span>
+                <span class="sig-return">
+                  <span class="sig-return-icon">&#x2192;</span>
+                  <span class="sig-return-typehint">
+                    <span class="pre">'S'</span>
+                  </span>
+                </span>
+                <a class="headerlink" href="#Example\Backed\Suit::Spades" title="Permalink to this definition">&#xB6;</a>
+              </dt>
+              <dd/>
+            </dl>
+          </dd>
+        </dl>
+      </section>
+      <section id="namespace-Example\Advanced">
+        <span id="advanced-enumerations"/>
+        <h3>Advanced Enumerations<a class="headerlink" href="#namespace-Example\Advanced" title="Permalink to this heading">&#xB6;</a></h3>
+        <dl class="php enum">
+          <dt class="sig sig-object php" id="Example\Advanced\Suit">
+            <em class="property">
+              <span class="pre">enum</span>
+            </em>
+            <span class="sig-prename descclassname">
+              <span class="pre">Example\Advanced\</span>
+            </span>
+            <span class="sig-name descname">
+              <span class="pre">Suit</span>
+            </span>
+            <span class="sig-return">
+              <span class="sig-return-icon">&#x2192;</span>
+              <span class="sig-return-typehint">
+                <span class="pre">string</span>
+              </span>
+            </span>
+            <a class="headerlink" href="#Example\Advanced\Suit" title="Permalink to this definition">&#xB6;</a>
+          </dt>
+          <dd>
+            <p>In playing cards, a suit is one of the categories into which the cards of a
+deck are divided.</p>
+            <dl class="php case">
+              <dt class="sig sig-object php" id="Example\Advanced\Suit::Hearts">
+                <em class="property">
+                  <span class="pre">case</span>
+                </em>
+                <span class="sig-name descname">
+                  <span class="pre">Hearts</span>
+                </span>
+                <span class="sig-return">
+                  <span class="sig-return-icon">&#x2192;</span>
+                  <span class="sig-return-typehint">
+                    <span class="pre">'H'</span>
+                  </span>
+                </span>
+                <a class="headerlink" href="#Example\Advanced\Suit::Hearts" title="Permalink to this definition">&#xB6;</a>
+              </dt>
+              <dd/>
+            </dl>
+            <dl class="php case">
+              <dt class="sig sig-object php" id="Example\Advanced\Suit::Diamonds">
+                <em class="property">
+                  <span class="pre">case</span>
+                </em>
+                <span class="sig-name descname">
+                  <span class="pre">Diamonds</span>
+                </span>
+                <span class="sig-return">
+                  <span class="sig-return-icon">&#x2192;</span>
+                  <span class="sig-return-typehint">
+                    <span class="pre">'D'</span>
+                  </span>
+                </span>
+                <a class="headerlink" href="#Example\Advanced\Suit::Diamonds" title="Permalink to this definition">&#xB6;</a>
+              </dt>
+              <dd/>
+            </dl>
+            <dl class="php case">
+              <dt class="sig sig-object php" id="Example\Advanced\Suit::Clubs">
+                <em class="property">
+                  <span class="pre">case</span>
+                </em>
+                <span class="sig-name descname">
+                  <span class="pre">Clubs</span>
+                </span>
+                <span class="sig-return">
+                  <span class="sig-return-icon">&#x2192;</span>
+                  <span class="sig-return-typehint">
+                    <span class="pre">'C'</span>
+                  </span>
+                </span>
+                <a class="headerlink" href="#Example\Advanced\Suit::Clubs" title="Permalink to this definition">&#xB6;</a>
+              </dt>
+              <dd/>
+            </dl>
+            <dl class="php case">
+              <dt class="sig sig-object php" id="Example\Advanced\Suit::Spades">
+                <em class="property">
+                  <span class="pre">case</span>
+                </em>
+                <span class="sig-name descname">
+                  <span class="pre">Spades</span>
+                </span>
+                <span class="sig-return">
+                  <span class="sig-return-icon">&#x2192;</span>
+                  <span class="sig-return-typehint">
+                    <span class="pre">'S'</span>
+                  </span>
+                </span>
+                <a class="headerlink" href="#Example\Advanced\Suit::Spades" title="Permalink to this definition">&#xB6;</a>
+              </dt>
+              <dd/>
+            </dl>
+            <dl class="php method">
+              <dt class="sig sig-object php" id="Example\Advanced\Suit::color">
+                <span class="sig-name descname">
+                  <span class="pre">color</span>
+                </span>
+                <span class="sig-paren">(</span>
+                <span class="sig-paren">)</span>
+                <span class="sig-return">
+                  <span class="sig-return-icon">&#x2192;</span>
+                  <span class="sig-return-typehint">
+                    <span class="pre">string</span>
+                  </span>
+                </span>
+                <a class="headerlink" href="#Example\Advanced\Suit::color" title="Permalink to this definition">&#xB6;</a>
+              </dt>
+              <dd>
+                <p>Returns &#x201C;red&#x201D; for hearts and diamonds, &#x201C;black&#x201D; for clubs and spades.</p>
+              </dd>
+            </dl>
+            <dl class="php staticmethod">
+              <dt class="sig sig-object php" id="Example\Advanced\Suit::values">
+                <em class="property">
+                  <span class="pre">static</span>
+                </em>
+                <span class="sig-name descname">
+                  <span class="pre">values</span>
+                </span>
+                <span class="sig-return">
+                  <span class="sig-return-icon">&#x2192;</span>
+                  <span class="sig-return-typehint">
+                    <span class="pre">string[]</span>
+                  </span>
+                </span>
+                <a class="headerlink" href="#Example\Advanced\Suit::values" title="Permalink to this definition">&#xB6;</a>
+              </dt>
+              <dd>
+                <p>Returns an array of the values of all the cases on this enum.</p>
+              </dd>
+            </dl>
+            <dl class="php const">
+              <dt class="sig sig-object php" id="Example\Advanced\Suit::Roses">
+                <em class="property">
+                  <span class="pre">constant</span>
+                </em>
+                <span class="sig-name descname">
+                  <span class="pre">Roses</span>
+                </span>
+                <span class="sig-return">
+                  <span class="sig-return-icon">&#x2192;</span>
+                  <span class="sig-return-typehint">
+                    <span class="pre">Hearts</span>
+                  </span>
+                </span>
+                <a class="headerlink" href="#Example\Advanced\Suit::Roses" title="Permalink to this definition">&#xB6;</a>
+              </dt>
+              <dd>
+                <p>An alias for <a class="reference internal" href="#Example\Advanced\Suit::Hearts" title="Example\Advanced\Suit::Hearts"><code class="xref php php-case docutils literal notranslate"><span class="pre">Suit::Hearts</span></code></a>.</p>
+              </dd>
+            </dl>
+            <dl class="php const">
+              <dt class="sig sig-object php" id="Example\Advanced\Suit::Bells">
+                <em class="property">
+                  <span class="pre">constant</span>
+                </em>
+                <span class="sig-name descname">
+                  <span class="pre">Bells</span>
+                </span>
+                <span class="sig-return">
+                  <span class="sig-return-icon">&#x2192;</span>
+                  <span class="sig-return-typehint">
+                    <span class="pre">Diamonds</span>
+                  </span>
+                </span>
+                <a class="headerlink" href="#Example\Advanced\Suit::Bells" title="Permalink to this definition">&#xB6;</a>
+              </dt>
+              <dd>
+                <p>An alias for <a class="reference internal" href="#Example\Advanced\Suit::Diamonds" title="Example\Advanced\Suit::Diamonds"><code class="xref php php-case docutils literal notranslate"><span class="pre">Suit::Diamonds</span></code></a>.</p>
+              </dd>
+            </dl>
+            <dl class="php const">
+              <dt class="sig sig-object php" id="Example\Advanced\Suit::Acorns">
+                <em class="property">
+                  <span class="pre">constant</span>
+                </em>
+                <span class="sig-name descname">
+                  <span class="pre">Acorns</span>
+                </span>
+                <span class="sig-return">
+                  <span class="sig-return-icon">&#x2192;</span>
+                  <span class="sig-return-typehint">
+                    <span class="pre">Clubs</span>
+                  </span>
+                </span>
+                <a class="headerlink" href="#Example\Advanced\Suit::Acorns" title="Permalink to this definition">&#xB6;</a>
+              </dt>
+              <dd>
+                <p>An alias for <a class="reference internal" href="#Example\Advanced\Suit::Clubs" title="Example\Advanced\Suit::Clubs"><code class="xref php php-case docutils literal notranslate"><span class="pre">Suit::Clubs</span></code></a>.</p>
+              </dd>
+            </dl>
+            <dl class="php const">
+              <dt class="sig sig-object php" id="Example\Advanced\Suit::Shields">
+                <em class="property">
+                  <span class="pre">constant</span>
+                </em>
+                <span class="sig-name descname">
+                  <span class="pre">Shields</span>
+                </span>
+                <span class="sig-return">
+                  <span class="sig-return-icon">&#x2192;</span>
+                  <span class="sig-return-typehint">
+                    <span class="pre">Spades</span>
+                  </span>
+                </span>
+                <a class="headerlink" href="#Example\Advanced\Suit::Shields" title="Permalink to this definition">&#xB6;</a>
+              </dt>
+              <dd>
+                <p>An alias for <a class="reference internal" href="#Example\Advanced\Suit::Spades" title="Example\Advanced\Suit::Spades"><code class="xref php php-case docutils literal notranslate"><span class="pre">Suit::Spades</span></code></a>.</p>
+              </dd>
+            </dl>
+          </dd>
+        </dl>
+      </section>
+      <section id="enumeration-links">
+        <h3>Enumeration Links<a class="headerlink" href="#enumeration-links" title="Permalink to this heading">&#xB6;</a></h3>
+        <section id="links-to-basic-enumeration-example">
+          <h4>Links to Basic Enumeration Example<a class="headerlink" href="#links-to-basic-enumeration-example" title="Permalink to this heading">&#xB6;</a></h4>
+          <p>
+            <a class="reference internal" href="#Example\Basic\Suit" title="Example\Basic\Suit">
+              <code class="xref php php-enum docutils literal notranslate">
+                <span class="pre">Example\Basic\Suit</span>
+              </code>
+            </a>
+          </p>
+          <p>
+            <a class="reference internal" href="#Example\Basic\Suit::Hearts" title="Example\Basic\Suit::Hearts">
+              <code class="xref php php-case docutils literal notranslate">
+                <span class="pre">Example\Basic\Suit::Hearts</span>
+              </code>
+            </a>
+          </p>
+          <p>
+            <a class="reference internal" href="#Example\Basic\Suit::Diamonds" title="Example\Basic\Suit::Diamonds">
+              <code class="xref php php-case docutils literal notranslate">
+                <span class="pre">Example\Basic\Suit::Diamonds</span>
+              </code>
+            </a>
+          </p>
+          <p>
+            <a class="reference internal" href="#Example\Basic\Suit::Clubs" title="Example\Basic\Suit::Clubs">
+              <code class="xref php php-case docutils literal notranslate">
+                <span class="pre">Example\Basic\Suit::Clubs</span>
+              </code>
+            </a>
+          </p>
+          <p>
+            <a class="reference internal" href="#Example\Basic\Suit::Spades" title="Example\Basic\Suit::Spades">
+              <code class="xref php php-case docutils literal notranslate">
+                <span class="pre">Example\Basic\Suit::Spades</span>
+              </code>
+            </a>
+          </p>
+        </section>
+        <section id="links-to-backed-enumeration-example">
+          <h4>Links to Backed Enumeration Example<a class="headerlink" href="#links-to-backed-enumeration-example" title="Permalink to this heading">&#xB6;</a></h4>
+          <p>
+            <a class="reference internal" href="#Example\Backed\Suit" title="Example\Backed\Suit">
+              <code class="xref php php-enum docutils literal notranslate">
+                <span class="pre">Example\Backed\Suit</span>
+              </code>
+            </a>
+          </p>
+          <p>
+            <a class="reference internal" href="#Example\Backed\Suit::Hearts" title="Example\Backed\Suit::Hearts">
+              <code class="xref php php-case docutils literal notranslate">
+                <span class="pre">Example\Backed\Suit::Hearts</span>
+              </code>
+            </a>
+          </p>
+          <p>
+            <a class="reference internal" href="#Example\Backed\Suit::Diamonds" title="Example\Backed\Suit::Diamonds">
+              <code class="xref php php-case docutils literal notranslate">
+                <span class="pre">Example\Backed\Suit::Diamonds</span>
+              </code>
+            </a>
+          </p>
+          <p>
+            <a class="reference internal" href="#Example\Backed\Suit::Clubs" title="Example\Backed\Suit::Clubs">
+              <code class="xref php php-case docutils literal notranslate">
+                <span class="pre">Example\Backed\Suit::Clubs</span>
+              </code>
+            </a>
+          </p>
+          <p>
+            <a class="reference internal" href="#Example\Backed\Suit::Spades" title="Example\Backed\Suit::Spades">
+              <code class="xref php php-case docutils literal notranslate">
+                <span class="pre">Example\Backed\Suit::Spades</span>
+              </code>
+            </a>
+          </p>
+        </section>
+        <section id="links-to-advanced-enumeration-example">
+          <h4>Links to Advanced Enumeration Example<a class="headerlink" href="#links-to-advanced-enumeration-example" title="Permalink to this heading">&#xB6;</a></h4>
+          <p>
+            <a class="reference internal" href="#Example\Advanced\Suit" title="Example\Advanced\Suit">
+              <code class="xref php php-enum docutils literal notranslate">
+                <span class="pre">Suit</span>
+              </code>
+            </a>
+          </p>
+          <p>
+            <a class="reference internal" href="#Example\Advanced\Suit::Hearts" title="Example\Advanced\Suit::Hearts">
+              <code class="xref php php-case docutils literal notranslate">
+                <span class="pre">Suit::Hearts</span>
+              </code>
+            </a>
+          </p>
+          <p>
+            <a class="reference internal" href="#Example\Advanced\Suit::Diamonds" title="Example\Advanced\Suit::Diamonds">
+              <code class="xref php php-case docutils literal notranslate">
+                <span class="pre">Suit::Diamonds</span>
+              </code>
+            </a>
+          </p>
+          <p>
+            <a class="reference internal" href="#Example\Advanced\Suit::Clubs" title="Example\Advanced\Suit::Clubs">
+              <code class="xref php php-case docutils literal notranslate">
+                <span class="pre">Suit::Clubs</span>
+              </code>
+            </a>
+          </p>
+          <p>
+            <a class="reference internal" href="#Example\Advanced\Suit::Spades" title="Example\Advanced\Suit::Spades">
+              <code class="xref php php-case docutils literal notranslate">
+                <span class="pre">Suit::Spades</span>
+              </code>
+            </a>
+          </p>
+          <p>
+            <a class="reference internal" href="#Example\Advanced\Suit::color" title="Example\Advanced\Suit::color">
+              <code class="xref php php-meth docutils literal notranslate">
+                <span class="pre">Suit::color</span>
+              </code>
+            </a>
+          </p>
+          <p>
+            <a class="reference internal" href="#Example\Advanced\Suit::values" title="Example\Advanced\Suit::values">
+              <code class="xref php php-meth docutils literal notranslate">
+                <span class="pre">Suit::values</span>
+              </code>
+            </a>
+          </p>
+          <p>
+            <a class="reference internal" href="#Example\Advanced\Suit::Roses" title="Example\Advanced\Suit::Roses">
+              <code class="xref php php-const docutils literal notranslate">
+                <span class="pre">Suit::Roses</span>
+              </code>
+            </a>
+          </p>
+          <p>
+            <a class="reference internal" href="#Example\Advanced\Suit::Bells" title="Example\Advanced\Suit::Bells">
+              <code class="xref php php-const docutils literal notranslate">
+                <span class="pre">Suit::Bells</span>
+              </code>
+            </a>
+          </p>
+          <p>
+            <a class="reference internal" href="#Example\Advanced\Suit::Acorns" title="Example\Advanced\Suit::Acorns">
+              <code class="xref php php-const docutils literal notranslate">
+                <span class="pre">Suit::Acorns</span>
+              </code>
+            </a>
+          </p>
+          <p>
+            <a class="reference internal" href="#Example\Advanced\Suit::Shields" title="Example\Advanced\Suit::Shields">
+              <code class="xref php php-const docutils literal notranslate">
+                <span class="pre">Suit::Shields</span>
+              </code>
+            </a>
+          </p>
+        </section>
+      </section>
+    </section>
+  </section>
+  <div class="clearer"/>
+</div>
diff --git a/test/must-build/test_doc.rst b/test/rst_doc.md
similarity index 76%
rename from test/must-build/test_doc.rst
rename to test/rst_doc.md
index 862936a5..d29c7c8d 100644
--- a/test/must-build/test_doc.rst
+++ b/test/rst_doc.md
@@ -1,3 +1,4 @@
+```{eval-rst}
 Acceptance tests for PHPdomain
 ##############################
 
@@ -23,7 +24,7 @@ Globals
     :param needle: The element to search for.
     :param array haystack: The array to search.
     :returns: Element exists in array.
-    :returntype: boolean
+    :returntype: bool
 
 Classes
 =======
@@ -142,7 +143,7 @@ More globals after classes
 
     A global variable
 
-.. php:global:: strpos($needle, $haystack)
+.. php:function:: strpos($needle, $haystack)
 
     Position of needle in haystack
 
@@ -162,17 +163,17 @@ Test Case - Global symbols with no namespaces
 
 :php:class:`DateTime`
 
-:php:func:`DateTime::setTime()`
+:php:meth:`DateTime::setTime()`
 
-:php:func:`DateTime::getLastErrors()`
+:php:meth:`DateTime::getLastErrors()`
 
-:php:func:`DateTime::setDate()`
+:php:meth:`DateTime::setDate()`
 
-:php:func:`DateTime::ATOM`
+:php:const:`DateTime::ATOM`
 
-:php:func:`DateTime::$testattr`
+:php:attr:`DateTime::$testattr`
 
-:php:func:`OtherClass::update`
+:php:meth:`OtherClass::update`
 
 :php:attr:`OtherClass::$nonIndentedAttribute`
 
@@ -184,26 +185,26 @@ Test Case - Global symbols with no namespaces
 
 :php:interface:`DateTimeInterface`
 
-:php:func:`DateTimeInterface::setTime()`
+:php:meth:`DateTimeInterface::setTime()`
 
-:php:func:`~DateTimeInterface::setDate()`
+:php:meth:`~DateTimeInterface::setDate()`
 
-:php:func:`DateTimeInterface::ATOM`
+:php:const:`DateTimeInterface::ATOM`
 
-:php:func:`DateTimeInterface::$testattr`
+:php:attr:`DateTimeInterface::$testattr`
 
-:php:func:`OtherInterface`
+:php:interface:`OtherInterface`
 
 :php:trait:`LogTrait`
 
-:php:func:`LogTrait::log()`
+:php:meth:`LogTrait::log()`
 
 Test Case - Prefix less links
 -----------------------------
 
 The following links should not be prefixed with a classname.
 
-:php:func:`~DateTime::setDate()`
+:php:meth:`~DateTime::setDate()`
 
 :php:attr:`~DateTime::$testattr`
 
@@ -336,9 +337,9 @@ Within a namespace context you don't need to include the namespace in links.
 
 :php:const:`LibraryClass::TEST_CONST`
 
-:php:class:`LibraryName\\OtherClass`
+:php:class:`OtherClass`
 
-:php:class:`LibraryName\\ThirdClass`
+:php:class:`ThirdClass`
 
 :php:class:`NamespaceClass`
 
@@ -368,22 +369,20 @@ Within a namespace context you don't need to include the namespace in links.
 
 :php:trait:`TemplateTrait`
 
-:php:trait:`LibraryName\\TemplateTrait`
-
-:php:func:`LibraryName\\TemplateTrait::render()`
+:php:meth:`TemplateTrait::render()`
 
 Test Case - Links with prefix trimming
 --------------------------------------
 
 All of the following links should not be prefixed with a namespace.
 
-:php:interface:`~LibraryName\\LibraryInterface`
+:php:interface:`~LibraryInterface`
 
-:php:class:`~LibraryName\\LibraryClass`
+:php:class:`~LibraryClass`
 
-:php:trait:`~LibraryName\\TemplateTrait`
+:php:trait:`~TemplateTrait`
 
-:php:exc:`~LibraryName\\NamespaceException`
+:php:exc:`~NamespaceException`
 
 All of the following links should not be prefixed with a classname.
 
@@ -397,25 +396,27 @@ All of the following links should not be prefixed with a classname.
 Test Case - global access
 -------------------------
 
-:php:class:`DateTime`
+:php:class:`\\DateTime`
 
-:php:func:`DateTime::setTime()`
+:php:func:`\\DateTime::setTime()`
 
 :php:global:`$global_var`
 
 :php:const:`SOME_CONSTANT`
 
-:php:attr:`LibraryName\\LibraryClass::$property`
+:php:func:`in_array()`
 
-:php:attr:`~LibraryName\\LibraryClass::$property` Should not be prefixed with classname.
+:php:attr:`\\LibraryName\\LibraryClass::$property`
 
-:php:const:`LibraryName\\LibraryClass::TEST_CONST`
+:php:attr:`~\\LibraryName\\LibraryClass::$property` Should not be prefixed with classname.
 
-:php:const:`LibraryName\\NS_CONST`
+:php:const:`\\LibraryName\\LibraryClass::TEST_CONST`
 
-:php:interface:`DateTimeInterface`
+:php:const:`\\LibraryName\\NS_CONST`
 
-:php:func:`DateTimeInterface::setTime()`
+:php:interface:`\\DateTimeInterface`
+
+:php:func:`\\DateTimeInterface::setTime()`
 
 Any Cross Ref
 =============
@@ -446,15 +447,19 @@ Test Case - Test subpackage links
 
 :php:ns:`LibraryName\\SubPackage`
 
+:php:ns:`\\LibraryName\\SubPackage`
+
 :php:class:`SubpackageClass`
 
-:php:class:`LibraryName\\SubPackage\\SubpackageClass`
+:php:class:`\\LibraryName\\SubPackage\\SubpackageClass`
 
 :php:interface:`SubpackageInterface`
 
-:php:class:`LibraryName\\SubPackage\\SubpackageInterface`
+:php:class:`\\LibraryName\\SubPackage\\SubpackageInterface`
+
+:php:exc:`NestedNamespaceException`
 
-:php:exc:`LibraryName\\SubPackage\\NestedNamespaceException`
+:php:exc:`\\LibraryName\\SubPackage\\NestedNamespaceException`
 
 Return Types
 ============
@@ -468,27 +473,27 @@ Return Types
     .. php:method:: returnClassFromSameNamespace()
 
         :returns: An object instance of a class from the same namespace.
-        :returntype: OtherLibrary\\ReturnedClass
+        :returntype: ReturnedClass
 
     .. php:method:: returnClassFromOtherNamespace()
 
         :returns: An object instance of a class from another namespace.
-        :returntype: LibraryName\\SubPackage\\SubpackageInterface
+        :returntype: \\LibraryName\\SubPackage\\SubpackageInterface
 
     .. php:method:: returnClassConstant()
 
         :returns: The value of a specific class constant.
-        :returntype: LibraryName\\NamespaceClass::NAMESPACE_CONST
+        :returntype: \\LibraryName\\NamespaceClass::NAMESPACE_CONST
 
     .. php:method:: returnGlobalConstant()
 
-        :returns: The value of a specific global constant.
+        :returns: The value of a specific global constant. # TODO link is not working without "\\"
         :returntype: SOME_CONSTANT
 
     .. php:method:: returnExceptionInstance()
 
         :returns: An instance of an exception.
-        :returntype: InvalidArgumentException
+        :returntype: \\InvalidArgumentException
 
     .. php:method:: returnScalarType()
 
@@ -498,7 +503,7 @@ Return Types
     .. php:method:: returnUnionType()
 
         :returns: Any of a whole bunch of things specified with a PHP 8 union type.
-        :returntype: int|string|OtherLibrary\\ReturnedClass|LibraryName\\SubPackage\\SubpackageInterface|null
+        :returntype: int|string|ReturnedClass|\\LibraryName\\SubPackage\\SubpackageInterface|null
 
 .. php:class:: ReturnedClass
 
@@ -562,19 +567,19 @@ Advanced Enumerations
 
     .. php:const:: Roses() : Hearts
 
-        An alias for :php:case:`Example\\Advanced\\Suit::Hearts`.
+        An alias for :php:case:`Suit::Hearts`.
 
     .. php:const:: Bells : Diamonds
 
-        An alias for :php:case:`Example\\Advanced\\Suit::Diamonds`.
+        An alias for :php:case:`Suit::Diamonds`.
 
     .. php:const:: Acorns : Clubs
 
-        An alias for :php:case:`Example\\Advanced\\Suit::Clubs`.
+        An alias for :php:case:`Suit::Clubs`.
 
     .. php:const:: Shields : Spades
 
-        An alias for :php:case:`Example\\Advanced\\Suit::Spades`.
+        An alias for :php:case:`Suit::Spades`.
 
 Enumeration Links
 -----------------
@@ -582,50 +587,51 @@ Enumeration Links
 Links to Basic Enumeration Example
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-:php:enum:`Example\\Basic\\Suit`
+:php:enum:`\\Example\\Basic\\Suit`
 
-:php:case:`Example\\Basic\\Suit::Hearts`
+:php:case:`\\Example\\Basic\\Suit::Hearts`
 
-:php:case:`Example\\Basic\\Suit::Diamonds`
+:php:case:`\\Example\\Basic\\Suit::Diamonds`
 
-:php:case:`Example\\Basic\\Suit::Clubs`
+:php:case:`\\Example\\Basic\\Suit::Clubs`
 
-:php:case:`Example\\Basic\\Suit::Spades`
+:php:case:`\\Example\\Basic\\Suit::Spades`
 
 Links to Backed Enumeration Example
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-:php:enum:`Example\\Backed\\Suit`
+:php:enum:`\\Example\\Backed\\Suit`
 
-:php:case:`Example\\Backed\\Suit::Hearts`
+:php:case:`\\Example\\Backed\\Suit::Hearts`
 
-:php:case:`Example\\Backed\\Suit::Diamonds`
+:php:case:`\\Example\\Backed\\Suit::Diamonds`
 
-:php:case:`Example\\Backed\\Suit::Clubs`
+:php:case:`\\Example\\Backed\\Suit::Clubs`
 
-:php:case:`Example\\Backed\\Suit::Spades`
+:php:case:`\\Example\\Backed\\Suit::Spades`
 
 Links to Advanced Enumeration Example
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-:php:enum:`Example\\Advanced\\Suit`
+:php:enum:`Suit`
 
-:php:case:`Example\\Advanced\\Suit::Hearts`
+:php:case:`Suit::Hearts`
 
-:php:case:`Example\\Advanced\\Suit::Diamonds`
+:php:case:`Suit::Diamonds`
 
-:php:case:`Example\\Advanced\\Suit::Clubs`
+:php:case:`Suit::Clubs`
 
-:php:case:`Example\\Advanced\\Suit::Spades`
+:php:case:`Suit::Spades`
 
-:php:meth:`Example\\Advanced\\Suit::color`
+:php:meth:`Suit::color`
 
-:php:meth:`Example\\Advanced\\Suit::values`
+:php:meth:`Suit::values`
 
-:php:const:`Example\\Advanced\\Suit::Roses`
+:php:const:`Suit::Roses`
 
-:php:const:`Example\\Advanced\\Suit::Bells`
+:php:const:`Suit::Bells`
 
-:php:const:`Example\\Advanced\\Suit::Acorns`
+:php:const:`Suit::Acorns`
 
-:php:const:`Example\\Advanced\\Suit::Shields`
+:php:const:`Suit::Shields`
+```
diff --git a/test/rst_doc2.html b/test/rst_doc2.html
new file mode 100644
index 00000000..cf7f78f9
--- /dev/null
+++ b/test/rst_doc2.html
@@ -0,0 +1,100 @@
+<?xml version="1.0"?>
+<div class="body" role="main">
+  <section id="top-level-namespace">
+    <h1>Top Level Namespace<a class="headerlink" href="#top-level-namespace" title="Permalink to this heading">&#xB6;</a></h1>
+    <p>namespace <code class="docutils literal notranslate"><span class="pre">Imagine\Draw</span></code></p>
+    <span class="target" id="namespace-Imagine\Draw"/>
+    <dl class="php class">
+      <dt class="sig sig-object php" id="Imagine\Draw\DrawerInterface">
+        <em class="property">
+          <span class="pre">class</span>
+        </em>
+        <span class="sig-prename descclassname">
+          <span class="pre">Imagine\Draw\</span>
+        </span>
+        <span class="sig-name descname">
+          <span class="pre">DrawerInterface</span>
+        </span>
+        <a class="headerlink" href="#Imagine\Draw\DrawerInterface" title="Permalink to this definition">&#xB6;</a>
+      </dt>
+      <dd/>
+    </dl>
+    <p>Instance of this interface is returned by <code class="xref php php-meth docutils literal notranslate"><span class="pre">Imagine\Image\ImageInterface::draw</span></code>.</p>
+    <dl class="php method">
+      <dt class="sig sig-object php" id="Imagine\Draw\DrawerInterface::arc"><span class="sig-prename descclassname"><span class="pre">Imagine\Draw\DrawerInterface::</span></span><span class="sig-name descname"><span class="pre">arc</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="pre">PointInterface</span><span class="pre">$center</span></em>, <em class="sig-param"><span class="pre">BoxInterface</span><span class="pre">$size</span></em>, <em class="sig-param"><span class="pre">$start</span></em>, <em class="sig-param"><span class="pre">$end</span></em>, <em class="sig-param"><span class="pre">Color</span><span class="pre">$color</span></em><span class="sig-paren">)</span><a class="headerlink" href="#Imagine\Draw\DrawerInterface::arc" title="Permalink to this definition">&#xB6;</a></dt>
+      <dd>
+        <p>Draws an arc on a starting at a given x, y coordinates under a given start and end angles</p>
+        <dl class="field-list simple">
+          <dt class="field-odd">Parameters<span class="colon">:</span></dt>
+          <dd class="field-odd">
+            <ul class="simple">
+              <li>
+                <p><strong>$center</strong> (<span><code class="xref php php-obj docutils literal notranslate"><span class="pre">Imagine\Image\PointInterface</span></code></span>) &#x2013; Center of the arc.</p>
+              </li>
+              <li>
+                <p><strong>$size</strong> (<span><code class="xref php php-obj docutils literal notranslate"><span class="pre">Imagine\Image\BoxInterface</span></code></span>) &#x2013; Size of the bounding box.</p>
+              </li>
+              <li>
+                <p><strong>$start</strong> (<span><code class="xref php php-obj docutils literal notranslate"><span class="pre">int</span></code></span>) &#x2013; Start angle.</p>
+              </li>
+              <li>
+                <p><strong>$end</strong> (<span><code class="xref php php-obj docutils literal notranslate"><span class="pre">int</span></code></span>) &#x2013; End angle.</p>
+              </li>
+              <li>
+                <p><strong>$color</strong> (<span><code class="xref php php-obj docutils literal notranslate"><span class="pre">Imagine\Image\Color</span></code></span>) &#x2013; Line color.</p>
+              </li>
+            </ul>
+          </dd>
+          <dt class="field-even">Throws<span class="colon">:</span></dt>
+          <dd class="field-even">
+            <p>\Imagine\Exception\RuntimeException</p>
+          </dd>
+          <dt class="field-odd">Returns<span class="colon">:</span></dt>
+          <dd class="field-odd">
+            <p>DrawerInterface</p>
+          </dd>
+        </dl>
+      </dd>
+    </dl>
+    <section id="re-used-namespace">
+      <h2>Re-used namespace<a class="headerlink" href="#re-used-namespace" title="Permalink to this heading">&#xB6;</a></h2>
+      <p>No indexing errors or links should point to this namespace.</p>
+      <dl class="php class">
+        <dt class="sig sig-object php" id="LibraryName\ThirdClass">
+          <em class="property">
+            <span class="pre">class</span>
+          </em>
+          <span class="sig-prename descclassname">
+            <span class="pre">LibraryName\</span>
+          </span>
+          <span class="sig-name descname">
+            <span class="pre">ThirdClass</span>
+          </span>
+          <a class="headerlink" href="#LibraryName\ThirdClass" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>Another class in a currentmodule block</p>
+        </dd>
+      </dl>
+      <p>No indexing errors or links should point to this namespace.</p>
+      <dl class="php class">
+        <dt class="sig sig-object php" id="LibraryName\OtherClass">
+          <em class="property">
+            <span class="pre">class</span>
+          </em>
+          <span class="sig-prename descclassname">
+            <span class="pre">LibraryName\</span>
+          </span>
+          <span class="sig-name descname">
+            <span class="pre">OtherClass</span>
+          </span>
+          <a class="headerlink" href="#LibraryName\OtherClass" title="Permalink to this definition">&#xB6;</a>
+        </dt>
+        <dd>
+          <p>Another class in a reused namespace</p>
+        </dd>
+      </dl>
+    </section>
+  </section>
+  <div class="clearer"/>
+</div>
diff --git a/test/must-build/test_doc2.rst b/test/rst_doc2.md
similarity index 60%
rename from test/must-build/test_doc2.rst
rename to test/rst_doc2.md
index 2da3f00c..79b7e168 100644
--- a/test/must-build/test_doc2.rst
+++ b/test/rst_doc2.md
@@ -1,3 +1,4 @@
+```{eval-rst}
 Top Level Namespace
 ###################
 
@@ -7,21 +8,21 @@ namespace ``Imagine\Draw``
 
 .. php:class:: DrawerInterface
 
-Instance of this interface is returned by :php:meth:`Imagine\Image\ImageInterface::draw`.
+Instance of this interface is returned by :php:meth:`\\Imagine\\Image\\ImageInterface::draw`.
 
 .. php:method:: arc(PointInterface $center, BoxInterface $size, $start, $end, Color $color)
 
     Draws an arc on a starting at a given x, y coordinates under a given start and end angles
 
-    :param Imagine\Image\PointInterface $center: Center of the arc. 
-    :param Imagine\Image\BoxInterface $size: Size of the bounding box.
-    :param integer $start: Start angle.
-    :param integer $end: End angle.
-    :param Imagine\Image\Color $color: Line color.
+    :param \\Imagine\\Image\\PointInterface $center: Center of the arc. 
+    :param \\Imagine\\Image\\BoxInterface $size: Size of the bounding box.
+    :param int $start: Start angle.
+    :param int $end: End angle.
+    :param \\Imagine\\Image\\Color $color: Line color.
 
-    :throws: Imagine\Exception\RuntimeException
+    :throws: \\Imagine\\Exception\\RuntimeException
 
-    :returns: Imagine\Draw\DrawerInterface
+    :returns: DrawerInterface
 
 Re-used namespace
 =================
@@ -41,4 +42,4 @@ No indexing errors or links should point to this namespace.
 .. php:class:: OtherClass
 
     Another class in a reused namespace
-
+```
diff --git a/test/rst_index.html b/test/rst_index.html
new file mode 100644
index 00000000..fc236e7e
--- /dev/null
+++ b/test/rst_index.html
@@ -0,0 +1,110 @@
+<?xml version="1.0"?>
+<div class="body" role="main">
+  <section id="welcome-to-sphinxcontrib-phpdomain-acceptancetest-s-documentation">
+    <h1>Welcome to sphinxcontrib-phpdomain-acceptancetest&#x2019;s documentation!<a class="headerlink" href="#welcome-to-sphinxcontrib-phpdomain-acceptancetest-s-documentation" title="Permalink to this heading">&#xB6;</a></h1>
+    <p>Contents:</p>
+    <div class="toctree-wrapper compound">
+      <ul>
+        <li class="toctree-l1">
+          <a class="reference internal" href="rst_doc.html">Acceptance tests for PHPdomain</a>
+          <ul>
+            <li class="toctree-l2">
+              <a class="reference internal" href="rst_doc.html#globals">Globals</a>
+            </li>
+            <li class="toctree-l2">
+              <a class="reference internal" href="rst_doc.html#classes">Classes</a>
+            </li>
+            <li class="toctree-l2">
+              <a class="reference internal" href="rst_doc.html#exceptions">Exceptions</a>
+            </li>
+            <li class="toctree-l2">
+              <a class="reference internal" href="rst_doc.html#interfaces">Interfaces</a>
+            </li>
+            <li class="toctree-l2">
+              <a class="reference internal" href="rst_doc.html#traits">Traits</a>
+            </li>
+            <li class="toctree-l2">
+              <a class="reference internal" href="rst_doc.html#more-globals-after-classes">More globals after classes</a>
+            </li>
+            <li class="toctree-l2">
+              <a class="reference internal" href="rst_doc.html#namespace-LibraryName">Namespaced elements</a>
+            </li>
+            <li class="toctree-l2">
+              <a class="reference internal" href="rst_doc.html#any-cross-ref">Any Cross Ref</a>
+            </li>
+            <li class="toctree-l2">
+              <a class="reference internal" href="rst_doc.html#namespace-LibraryName\SubPackage">Nested namespaces</a>
+            </li>
+            <li class="toctree-l2">
+              <a class="reference internal" href="rst_doc.html#namespace-OtherLibrary">Return Types</a>
+            </li>
+            <li class="toctree-l2">
+              <a class="reference internal" href="rst_doc.html#enums">Enums</a>
+            </li>
+          </ul>
+        </li>
+        <li class="toctree-l1">
+          <a class="reference internal" href="rst_doc2.html">Top Level Namespace</a>
+          <ul>
+            <li class="toctree-l2">
+              <a class="reference internal" href="rst_doc2.html#Imagine\Draw\DrawerInterface">
+                <code class="docutils literal notranslate">
+                  <span class="pre">DrawerInterface</span>
+                </code>
+              </a>
+            </li>
+            <li class="toctree-l2">
+              <a class="reference internal" href="rst_doc2.html#re-used-namespace">Re-used namespace</a>
+            </li>
+          </ul>
+        </li>
+        <li class="toctree-l1">
+          <a class="reference internal" href="rst_nesting_regression.html">Nested method Regression</a>
+          <ul>
+            <li class="toctree-l2">
+              <a class="reference internal" href="rst_nesting_regression.html#Largo_Byline::populate_variables">
+                <code class="docutils literal notranslate">
+                  <span class="pre">Largo_Byline::populate_variables()</span>
+                </code>
+              </a>
+            </li>
+            <li class="toctree-l2">
+              <a class="reference internal" href="rst_nesting_regression.html#Largo_Byline::generate_byline">
+                <code class="docutils literal notranslate">
+                  <span class="pre">Largo_Byline::generate_byline()</span>
+                </code>
+              </a>
+            </li>
+          </ul>
+        </li>
+      </ul>
+    </div>
+  </section>
+  <section id="indices-and-tables">
+    <h1>Indices and tables<a class="headerlink" href="#indices-and-tables" title="Permalink to this heading">&#xB6;</a></h1>
+    <ul class="simple">
+      <li>
+        <p>
+          <a class="reference internal" href="genindex.html">
+            <span class="std std-ref">Index</span>
+          </a>
+        </p>
+      </li>
+      <li>
+        <p>
+          <a class="reference internal" href="py-modindex.html">
+            <span class="std std-ref">Module Index</span>
+          </a>
+        </p>
+      </li>
+      <li>
+        <p>
+          <a class="reference internal" href="search.html">
+            <span class="std std-ref">Search Page</span>
+          </a>
+        </p>
+      </li>
+    </ul>
+  </section>
+  <div class="clearer"/>
+</div>
diff --git a/test/must-build/index.rst b/test/rst_index.md
similarity index 80%
rename from test/must-build/index.rst
rename to test/rst_index.md
index cc97f676..798ea246 100644
--- a/test/must-build/index.rst
+++ b/test/rst_index.md
@@ -1,3 +1,4 @@
+```{eval-rst}
 Welcome to sphinxcontrib-phpdomain-acceptancetest's documentation!
 ===================================================================
 
@@ -6,9 +7,9 @@ Contents:
 .. toctree::
    :maxdepth: 2
 
-   test_doc
-   test_doc2
-   test_nesting_regression
+   rst_doc
+   rst_doc2
+   rst_nesting_regression
 
 Indices and tables
 ==================
@@ -16,4 +17,4 @@ Indices and tables
 * :ref:`genindex`
 * :ref:`modindex`
 * :ref:`search`
-
+```
diff --git a/test/rst_nesting_regression.html b/test/rst_nesting_regression.html
new file mode 100644
index 00000000..8661e110
--- /dev/null
+++ b/test/rst_nesting_regression.html
@@ -0,0 +1,68 @@
+<?xml version="1.0"?>
+<div class="body" role="main">
+  <section id="nested-method-regression">
+    <h1>Nested method Regression<a class="headerlink" href="#nested-method-regression" title="Permalink to this heading">&#xB6;</a></h1>
+    <p>Test nested methods to ensure page generation doesn&#x2019;t hard fail.</p>
+    <dl class="php method">
+      <dt class="sig sig-object php" id="Largo_Byline::populate_variables">
+        <span class="sig-prename descclassname">
+          <span class="pre">Largo_Byline::</span>
+        </span>
+        <span class="sig-name descname">
+          <span class="pre">populate_variables</span>
+        </span>
+        <span class="sig-paren">(</span>
+        <span class="sig-paren">)</span>
+        <a class="headerlink" href="#Largo_Byline::populate_variables" title="Permalink to this definition">&#xB6;</a>
+      </dt>
+      <dd>
+        <blockquote>
+          <div>
+            <p>Set us up the vars</p>
+            <blockquote>
+              <div>
+                <ul class="simple">
+                  <li>
+                    <p>&#x2018;post_id&#x2019;: an integer post ID</p>
+                  </li>
+                  <li>
+                    <p>&#x2018;exclude_date&#x2019;: boolean whether or not to include the date in the byline</p>
+                  </li>
+                </ul>
+              </div>
+            </blockquote>
+            <dl class="field-list simple">
+              <dt class="field-odd">param array $args<span class="colon">:</span></dt>
+              <dd class="field-odd">
+                <p>Associative array containing following keys:</p>
+              </dd>
+            </dl>
+          </div>
+        </blockquote>
+        <dl class="php method">
+          <dt class="sig sig-object php" id="Largo_Byline::generate_byline">
+            <span class="sig-prename descclassname">
+              <span class="pre">Largo_Byline::</span>
+            </span>
+            <span class="sig-name descname">
+              <span class="pre">generate_byline</span>
+            </span>
+            <span class="sig-paren">(</span>
+            <span class="sig-paren">)</span>
+            <a class="headerlink" href="#Largo_Byline::generate_byline" title="Permalink to this definition">&#xB6;</a>
+          </dt>
+          <dd>
+            <p>this creates the byline text and adds it to $this-&gt;output</p>
+            <dl class="field-list simple">
+              <dt class="field-odd">See<span class="colon">:</span></dt>
+              <dd class="field-odd">
+                <p>$output $reates this</p>
+              </dd>
+            </dl>
+          </dd>
+        </dl>
+      </dd>
+    </dl>
+  </section>
+  <div class="clearer"/>
+</div>
diff --git a/test/must-build/test_nesting_regression.rst b/test/rst_nesting_regression.md
similarity index 96%
rename from test/must-build/test_nesting_regression.rst
rename to test/rst_nesting_regression.md
index e4eb4d63..54d9cabe 100644
--- a/test/must-build/test_nesting_regression.rst
+++ b/test/rst_nesting_regression.md
@@ -1,3 +1,4 @@
+```{eval-rst}
 Nested method Regression
 ========================
 
@@ -17,3 +18,4 @@ Test nested methods to ensure page generation doesn't hard fail.
       this creates the byline text and adds it to $this->output
 
       :see: $output $reates this
+```
diff --git a/test/unit/Makefile b/test/unit/Makefile
deleted file mode 100644
index f61d9887..00000000
--- a/test/unit/Makefile
+++ /dev/null
@@ -1,130 +0,0 @@
-# Makefile for Sphinx documentation
-#
-
-# You can set these variables from the command line.
-SPHINXOPTS    =
-SPHINXBUILD   = sphinx-build
-PAPER         =
-BUILDDIR      = _build
-
-# Internal variables.
-PAPEROPT_a4     = -D latex_paper_size=a4
-PAPEROPT_letter = -D latex_paper_size=letter
-ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
-
-.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest
-
-help:
-	@echo "Please use \`make <target>' where <target> is one of"
-	@echo "  html       to make standalone HTML files"
-	@echo "  dirhtml    to make HTML files named index.html in directories"
-	@echo "  singlehtml to make a single large HTML file"
-	@echo "  pickle     to make pickle files"
-	@echo "  json       to make JSON files"
-	@echo "  htmlhelp   to make HTML files and a HTML help project"
-	@echo "  qthelp     to make HTML files and a qthelp project"
-	@echo "  devhelp    to make HTML files and a Devhelp project"
-	@echo "  epub       to make an epub"
-	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
-	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
-	@echo "  text       to make text files"
-	@echo "  man        to make manual pages"
-	@echo "  changes    to make an overview of all changed/added/deprecated items"
-	@echo "  linkcheck  to check all external links for integrity"
-	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
-
-clean:
-	-rm -rf $(BUILDDIR)/*
-
-html:
-	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
-	@echo
-	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
-
-dirhtml:
-	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
-	@echo
-	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
-
-singlehtml:
-	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
-	@echo
-	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
-
-pickle:
-	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
-	@echo
-	@echo "Build finished; now you can process the pickle files."
-
-json:
-	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
-	@echo
-	@echo "Build finished; now you can process the JSON files."
-
-htmlhelp:
-	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
-	@echo
-	@echo "Build finished; now you can run HTML Help Workshop with the" \
-	      ".hhp project file in $(BUILDDIR)/htmlhelp."
-
-qthelp:
-	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
-	@echo
-	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
-	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
-	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/sphinxcontrib-rubydomain-acceptancetest.qhcp"
-	@echo "To view the help file:"
-	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/sphinxcontrib-rubydomain-acceptancetest.qhc"
-
-devhelp:
-	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
-	@echo
-	@echo "Build finished."
-	@echo "To view the help file:"
-	@echo "# mkdir -p $$HOME/.local/share/devhelp/sphinxcontrib-rubydomain-acceptancetest"
-	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/sphinxcontrib-rubydomain-acceptancetest"
-	@echo "# devhelp"
-
-epub:
-	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
-	@echo
-	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
-
-latex:
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
-	@echo
-	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
-	@echo "Run \`make all-pdf' or \`make all-ps' in that directory to" \
-	      "run these through (pdf)latex."
-
-latexpdf: latex
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
-	@echo "Running LaTeX files through pdflatex..."
-	make -C $(BUILDDIR)/latex all-pdf
-	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
-
-text:
-	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
-	@echo
-	@echo "Build finished. The text files are in $(BUILDDIR)/text."
-
-man:
-	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
-	@echo
-	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
-
-changes:
-	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
-	@echo
-	@echo "The overview file is in $(BUILDDIR)/changes."
-
-linkcheck:
-	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
-	@echo
-	@echo "Link check complete; look for any errors in the above output " \
-	      "or in $(BUILDDIR)/linkcheck/output.txt."
-
-doctest:
-	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
-	@echo "Testing of doctests in the sources finished, look at the " \
-	      "results in $(BUILDDIR)/doctest/output.txt."
diff --git a/test/unit/conf.py b/test/unit/conf.py
deleted file mode 100644
index 2487b293..00000000
--- a/test/unit/conf.py
+++ /dev/null
@@ -1,17 +0,0 @@
-import sys, os
-
-sys.path.append(os.path.abspath('..'))
-
-extensions = [
-    'sphinxcontrib.phpdomain',
-    'myst_parser',
-]
-
-myst_enable_extensions = ['colon_fence']
-
-source_suffix = '.rst'
-master_doc = 'index'
-
-exclude_patterns = ['_build']
-
-html_theme = 'default'
diff --git a/test/unit/make.bat b/test/unit/make.bat
deleted file mode 100644
index 4310ae15..00000000
--- a/test/unit/make.bat
+++ /dev/null
@@ -1,155 +0,0 @@
-@ECHO OFF
-
-REM Command file for Sphinx documentation
-
-if "%SPHINXBUILD%" == "" (
-	set SPHINXBUILD=sphinx-build
-)
-set BUILDDIR=_build
-set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% .
-if NOT "%PAPER%" == "" (
-	set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%
-)
-
-if "%1" == "" goto help
-
-if "%1" == "help" (
-	:help
-	echo.Please use `make ^<target^>` where ^<target^> is one of
-	echo.  html       to make standalone HTML files
-	echo.  dirhtml    to make HTML files named index.html in directories
-	echo.  singlehtml to make a single large HTML file
-	echo.  pickle     to make pickle files
-	echo.  json       to make JSON files
-	echo.  htmlhelp   to make HTML files and a HTML help project
-	echo.  qthelp     to make HTML files and a qthelp project
-	echo.  devhelp    to make HTML files and a Devhelp project
-	echo.  epub       to make an epub
-	echo.  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter
-	echo.  text       to make text files
-	echo.  man        to make manual pages
-	echo.  changes    to make an overview over all changed/added/deprecated items
-	echo.  linkcheck  to check all external links for integrity
-	echo.  doctest    to run all doctests embedded in the documentation if enabled
-	goto end
-)
-
-if "%1" == "clean" (
-	for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i
-	del /q /s %BUILDDIR%\*
-	goto end
-)
-
-if "%1" == "html" (
-	%SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html
-	echo.
-	echo.Build finished. The HTML pages are in %BUILDDIR%/html.
-	goto end
-)
-
-if "%1" == "dirhtml" (
-	%SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml
-	echo.
-	echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml.
-	goto end
-)
-
-if "%1" == "singlehtml" (
-	%SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml
-	echo.
-	echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml.
-	goto end
-)
-
-if "%1" == "pickle" (
-	%SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle
-	echo.
-	echo.Build finished; now you can process the pickle files.
-	goto end
-)
-
-if "%1" == "json" (
-	%SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json
-	echo.
-	echo.Build finished; now you can process the JSON files.
-	goto end
-)
-
-if "%1" == "htmlhelp" (
-	%SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp
-	echo.
-	echo.Build finished; now you can run HTML Help Workshop with the ^
-.hhp project file in %BUILDDIR%/htmlhelp.
-	goto end
-)
-
-if "%1" == "qthelp" (
-	%SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp
-	echo.
-	echo.Build finished; now you can run "qcollectiongenerator" with the ^
-.qhcp project file in %BUILDDIR%/qthelp, like this:
-	echo.^> qcollectiongenerator %BUILDDIR%\qthelp\sphinxcontrib-rubydomain-acceptancetest.qhcp
-	echo.To view the help file:
-	echo.^> assistant -collectionFile %BUILDDIR%\qthelp\sphinxcontrib-rubydomain-acceptancetest.ghc
-	goto end
-)
-
-if "%1" == "devhelp" (
-	%SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp
-	echo.
-	echo.Build finished.
-	goto end
-)
-
-if "%1" == "epub" (
-	%SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub
-	echo.
-	echo.Build finished. The epub file is in %BUILDDIR%/epub.
-	goto end
-)
-
-if "%1" == "latex" (
-	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
-	echo.
-	echo.Build finished; the LaTeX files are in %BUILDDIR%/latex.
-	goto end
-)
-
-if "%1" == "text" (
-	%SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text
-	echo.
-	echo.Build finished. The text files are in %BUILDDIR%/text.
-	goto end
-)
-
-if "%1" == "man" (
-	%SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man
-	echo.
-	echo.Build finished. The manual pages are in %BUILDDIR%/man.
-	goto end
-)
-
-if "%1" == "changes" (
-	%SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes
-	echo.
-	echo.The overview file is in %BUILDDIR%/changes.
-	goto end
-)
-
-if "%1" == "linkcheck" (
-	%SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck
-	echo.
-	echo.Link check complete; look for any errors in the above output ^
-or in %BUILDDIR%/linkcheck/output.txt.
-	goto end
-)
-
-if "%1" == "doctest" (
-	%SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest
-	echo.
-	echo.Testing of doctests in the sources finished, look at the ^
-results in %BUILDDIR%/doctest/output.txt.
-	goto end
-)
-
-:end
diff --git a/test/unit/ns.html b/test/unit/ns.html
deleted file mode 100644
index bf0c670a..00000000
--- a/test/unit/ns.html
+++ /dev/null
@@ -1,51 +0,0 @@
-<?xml version="1.0"?>
-<div class="body" role="main">
-  <section id="namespace-Foo">
-    <span id="simple-ns"/>
-    <h1>Simple NS<a class="headerlink" href="#namespace-Foo" title="Permalink to this heading">&#xB6;</a></h1>
-    <dl class="php class">
-      <dt class="sig sig-object php" id="Foo\A">
-        <em class="property">
-          <span class="pre">class</span>
-        </em>
-        <span class="sig-prename descclassname">
-          <span class="pre">Foo\</span>
-        </span>
-        <span class="sig-name descname">
-          <span class="pre">A</span>
-        </span>
-        <a class="headerlink" href="#Foo\A" title="Permalink to this definition">&#xB6;</a>
-      </dt>
-      <dd/>
-    </dl>
-    <dl class="php method">
-      <dt class="sig sig-object php" id="Foo\A::simplify">
-        <span class="sig-prename descclassname">
-          <span class="pre">Foo\A::</span>
-        </span>
-        <span class="sig-name descname">
-          <span class="pre">simplify</span>
-        </span>
-        <span class="sig-paren">(</span>
-        <span class="sig-paren">)</span>
-        <a class="headerlink" href="#Foo\A::simplify" title="Permalink to this definition">&#xB6;</a>
-      </dt>
-      <dd/>
-    </dl>
-    <section id="cross-linking">
-      <h2>Cross linking<a class="headerlink" href="#cross-linking" title="Permalink to this heading">&#xB6;</a></h2>
-      <ul class="simple">
-        <li>
-          <p>
-            <a class="reference internal" href="#Foo\A::simplify" title="Foo\A::simplify">
-              <code class="xref php php-meth docutils literal notranslate">
-                <span class="pre">A::simplify</span>
-              </code>
-            </a>
-          </p>
-        </li>
-      </ul>
-    </section>
-  </section>
-  <div class="clearer"/>
-</div>
diff --git a/test/unit/ns.md b/test/unit/ns.md
deleted file mode 100644
index 1ebfe4dd..00000000
--- a/test/unit/ns.md
+++ /dev/null
@@ -1,14 +0,0 @@
-# Simple NS
-
-:::{php:namespace} Foo
-:::
-
-:::{php:class} A
-:::
-
-:::{php:method} simplify()
-:::
-
-## Cross linking
-
-- {php:meth}`A::simplify`