n-wouda / docblock

Parse C++ documentation blocks using Python.

Hi, I'm Niels! 👋

I like to write software tools that help humans make better decisions. Check out the repositories below to see some of my work!

docblock's Issues

Aligned structs or classes are not understood

Describe the bug

Currently, the following C++ snippet is not parsed correctly.
This is due to the alignas(16) in between class and Foo, which docblock does not understand.

Code sample

class alignas(16) Foo
{
  /**
   * A documentation block describing Foo::bar.
   */
  int bar();
}

Note: Please be sure you are using the latest released version of docblock, or a recent build of main.
If your problem has been fixed in an unreleased version, you might be able to use main until a new release occurs.

Note: If you are using a released version, have you verified that the bug exists in the main branch of this repository?

If the issue has not been resolved, please file it in the issue tracker.
Make sure to include the version of Python you are using, and the version of docblock you run.
You can copy-paste the output of import docblock; docblock.show_versions() to achieve this.

Expected Output

A clear and concise description of what you expected to happen.