Doxymacs

Doxymacs is an elisp package created to facilitate the utilization and production of Doxygen for {X}Emacs enthusiasts. The project offers a set of functions that help users browse documentation for classes, functions, and members through the browser of their choice. Furthermore, it includes fontification of Doxygen keywords and an automatic addition of Doxygen comments. In addition to existing styles like JavaDoc, Qt, or C++, it provides a system to create personalized templates.

Some of the prominent features available in Doxymacs are the potential to browse the documentation of symbols from {X}Emacs in a chosen browser and an easy insertion of Doxygen-style comments into the source. It is also possible to use an "external" (i.e., written in C) XML parser that speeds up the construction of the completion list. Another highlighted aspect is the capacity to highlight Doxygen keywords.

Doxymacs requires W3, tempo, and version 2.6.13 or greater of libxml2. To install Doxymacs, use the configure script that can be run as following - configure, make, make install. In order to make the package available in the .emacs file, it is crucial to add ${datadir}/share/${EMACS}/site-lisp to the load-path. However, a notification to keep in mind is that there might be some errors when executing the make file. In this scenario, we must set the EMACSLOADPATH variable: $ EMACSLOADPATH=... make, where ... is an associated list of directories to seach for packages.

In the latest release of Doxymacs, some significant bugs have been fixed, such as the ability to allow spaces in @param [in] style documentation responsible for developers to use a better method for obtaining a user's email address.