What produces a warning
=======================
Content the extension can't render faithfully produces a warning naming the
declaration, instead of disappearing from the page. These aren't live examples:
this site builds with ``-W``, so a real warning would fail it.
.. list-table::
:header-rows: 1
:widths: 35 45 20
* - In your source or page
- What the warning says
- Category
* - ``///`` Markdown comments
- Markdown documentation comments are not supported
- ``java.extract``
* - An unknown block tag, such as ``@todo``
- Unsupported block tag @todo
- ``java.extract``
* - External snippets, regions or markup
- Unsupported snippet attributes or markup
- ``java.extract``
* - ``{@link}`` or ``@throws`` naming a symbol the compiler can't find
- Unresolved Javadoc reference
- ``java.extract``
* - An override without its own text, such as ``toString``, whose ancestor has
no source documentation
- Cannot inherit
- ``java.inherit``
* - ``{@inheritDoc}`` without ancestor source
- Cannot resolve inheritDoc
- ``java.extract``
* - An HTML element outside the supported subset, such as ``
``
- Unsupported Javadoc HTML
- ``java.html``
* - A ``:members:`` entry that doesn't exist
- Java member ... was not found
- ``java.member``
* - The same declaration documented twice without ``:no-index:``
- Duplicate Java documentation
- ``java.duplicate``
* - An overloaded method named without parameters
- Ambiguous Java reference
- ``java.ambiguous``
Unsupported content stays in the page as literal text where possible, such as
``[unresolved inheritDoc]``. See :doc:`../troubleshooting` for fixes and
:doc:`../javadoc-support` for the supported content.