Software-update - Doxygen 1.15.0

In dit artikel:

Doxygen 1.15.0 is beschikbaar: de opensource documentatiegenerator voor Windows, Linux en macOS is bijgewerkt met nieuwe functies, een grote reeks bugfixes, interne refactoringen en verbeterde documentatie.

Wat en wie
- De release komt van het Doxygen-project en richt zich op gebruikers die automatische documentatie genereren uit broncode (HTML, PDF, Word, XML).
- Belangrijke uitbreidingen: ondersteuning voor MathJax 4, een bijgewerkte Letse vertaling en kleine verbeteringen aan Doxywizard. De configuratie krijgt tevens een hogere limiet voor het aantal threads.

Belangrijkste wijzigingen en compatibiliteit
- Nieuwe configuratieoptie MARKDOWN_STRICT staat standaard aan. Dat verandert hoe aanhalingstekens en backticks in Markdown worden geïnterpreteerd (bijvoorbeeld `word' wordt niet meer als afgesloten beschouwd). Wie het oude gedrag wil behouden kan MARKDOWN_STRICT=NO instellen.
- Diverse fixes voorkomen onjuiste weergave van Markdown, LaTeX en HTML (onder andere onvolledige codeblocks, kapotte tabellen en foutieve LaTeX-uitvoer).
- Zoekfunctie en linkgeneratie in grote projecten zijn hersteld waar die door regressies problemen gaven.

Bugfixes en stabiliteit
- Oplossingen voor vele concrete issues: verkeerd herkende commands (@plantumlfile), problemen met lokale includes, beeldkopie bij read-only bestanden, foutieve ID-toekenning bij macro-definities, en diverse C++/Java analyses (o.a. templates, trailing return types).
- Prestatie- en stabiliteitsverbeteringen: geheugenlekken aangepakt, buffer-overflow-gevaar verminderd, betere Windows-prestaties bij het starten van externe processen en fixes voor crashes die in eerdere versies optraden.

Refactoring, codekwaliteit en build
- Groot onderhoud: modernisering van code (C++17-aanpassingen), verwijdering van dode code, vele kleine refactors voor leesbaarheid en onderhoudbaarheid.
- Build- en ontwikkelverbeteringen: standaard naar Qt6, CMake-link-time-optimisaties, .clang-format optioneel en fixes voor MinGW-w64.

Documentatie en vertalingen
- Meerdere taalkundige correcties, consistentieverbeteringen in documentatie en aanwijzingen voor juiste versies van afhankelijkheden (zoals winflexbison).

Kortom: 1.15.0 richt zich op robuustheid en onderhoudbaarheid: veel regressies en Markdown/LaTeX-gerelateerde problemen zijn verholpen, terwijl ondersteuning voor moderne tools (MathJax 4, Qt6) en interne codeverbeteringen zijn toegevoegd. Gebruikers met specifieke Markdown-afhankelijkheden moeten controleren of MARKDOWN_STRICT invloed heeft op hun huidige documentatie en kunnen die optie desgewenst uitzetten.