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.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingwaiting_upstreamWaiting on a feature or fix in dependencies before this can be merged

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions