Skip to content

A comment on a Doxygen command (and a note about some typos) #2130

Description

@jschleus

The file src/openvas.c contains the following lines, which probably serve to generate possible Doxygen documentation:

/**
 * @mainpage
 *
 * @section Introduction
 * @verbinclude README.md
 *
 * @section license License Information
 * @verbinclude COPYING
 */

But the @verbinclude command includes the contents of the file README.md verbatim in the documentation and inhibits so the rendering of the contained markdown as can be seen here:

https://fossies.org/dox/openvas-scanner-23.39.4/
 (or using a version independent URL: https://fossies.org/dox/openvas-scanner/)

If this is not the desired behavior, the command should be replaced with
@include{doc} (or the old fashioned @includedoc).

Incidentally, the server fossies.org now also generates codespell reports, including for the openvas-scanner project:

https://fossies.org/linux/misc/openvas/openvas-scanner/codespell.html
 and
https://fossies.org/linux/misc/openvas/openvas-scanner/codespell.full.html
 (including also "Changes"-related files and "test" like directories).

But good news: No severe errors were found.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions