Hawkmoth

------------------

:Date: 2024-10-26

Added
~~~~~

* Support for C++ namespaces
* Domain specific config options ``hawkmoth_clang_c`` and
``hawkmoth_clang_cpp``.

Changed
~~~~~~~

* Bumped Python dependency requirement to v3.9, as v3.8 is reaching end of life
* The ``hawkmoth.ext.transformations`` extension is no longer loaded
automatically as it has been deprecated
* Moved developer documentation under doc/developer/
* Switched from ``setup.cfg`` to ``pyproject.toml``
* Switched build backend to hatchling

Deprecated
~~~~~~~~~~

* The ``hawkmoth.ext.transformations`` extension and the
``hawkmoth.util.doccompat`` module in favour of the ``hawkmoth.ext.javadoc``
and ``hawkmoth.ext.napoleon`` extensions and the
``hawkmoth-process-docstring`` event.

Removed
~~~~~~~

* ``hawkmoth --compat={none,javadoc-basic,javadoc-liberal,kernel-doc}`` option
from CLI
* ``cautodoc_root`` configuration option in favour of ``hawkmoth_root``
* ``cautodoc_clang`` configuration option in favour of ``hawkmoth_clang``

------------------

:Date: 2024-04-14

Added
~~~~~

* Added support for documenting C++ alias type definitions
* Added support variadic macros with named variable argument

Changed
~~~~~~~

* Bumped Python dependency requirement to v3.8, as the earlier versions have
reached end of life

Fixed
~~~~~

* Fixed C++ ``extern "C"`` block parsing for Clang 18 and later

------------------

:Date: 2023-12-10

Added
~~~~~

* Considerably improved Javadoc/Doxygen support
* Started making GitHub releases
* Support for adding automated source links
* Tips and tricks documentation
* ``hawkmoth --version`` option to CLI
* ``hawkmoth --process-docstring={javadoc,napoleon}`` option to CLI

Changed
~~~~~~~

* Switched from CRITICAL to ERROR level for Sphinx errors
* Internally, refactored cursor handling

Fixed
~~~~~

* Clang language option to handle headers better
* Line number references in error messages
* Referencing typedefed anonymous structs, unions, and enums on Clang 15 and earlier

------------------

:Date: 2023-10-22

Added
~~~~~

* Normalization of _Bool to bool
* Symbolic dimensions to array documentation
* Dockerfiles for running tests in more distros

Changed
~~~~~~~

* Naming of typedef anonymous struct/union/enum to use typedef name instead of
generated ``anonymous_*``

Fixed
~~~~~

* setup.cfg license_file deprecation warning
* Documentation intersphinx references to Sphinx documentation
* Test suite docutils warnings
* Test suite system include path for e.g. Fedora
* Handling of anonymous struct/union/enum with libclang v16 and later
* Workaround libclang tokenization issue
* Running test suite with plain ``pytest`` in root directory

------------------

:Date: 2023-08-17

Added
~~~~~

* ``autosection`` directive to include generic documentation comments
* ``.readthedocs.yaml`` config file
* Documentation on how to use Hawkmoth on Read the Docs more reliably
* Values in enumerator documentation when explicitly initialized in source code

Changed
~~~~~~~

* The ``:file:`` option is optional for files that have been previously parsed
* Test case yaml schema

Removed
~~~~~~~

* Development dependency on the deprecated ``sphinx_testing`` package
* Docker containers

Fixed
~~~~~

* Handling of empty documentation comments
* Parser error propagation

------------------

:Date: 2023-04-01

Added
~~~~~

* Build and deploy stable and development documentation at GitHub pages

Changed
~~~~~~~

* Switch the project to src/ hierarchy
* Test the installed package instead of source to detect packaging issues
* Require functional hawkmoth to build documentation

Removed
~~~~~~~

* Sunset the mailing list as contact

Fixed
~~~~~

* Fix packaging of hawkmoth.ext.* sub-packages