Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

CREATE_SUBDIRS and C++20 modules: Doxygen doesn't create directories #10763

Closed
ColoredCarrot opened this issue Mar 22, 2024 · 3 comments
Closed
Labels
bug C/C++ C++20 For features introduced in the 2020 spec of C++

Comments

@ColoredCarrot
Copy link

Description

When using CREATE_SUBDIRS = YES together with C++20 modules, Doxygen fails to create the HTML documentation files for the module files.

  • Doxygen errors with error: Could not open file some/path/html/module_dd/d3c/my__module.html for writing
  • The error causes the entire docs generation process to fail (non-zero exit code)
  • Manually creating the directory from the error message "fixes" this; Doxygen then runs successfully

Seems like there's just some code missing to create the necessary directories.

To reproduce

  1. Set CREATE_SUBDIRS = YES along with other necessary options.
  2. Create a C++20 module file, e.g.:
export module my_module;

/** @brief Do the thing */
export void foo() {}
  1. Run doxygen

Minimal example: DoxygenModulesErrorRepro.zip

Version
Running Doxygen 1.10.0 (ebc57c6) on Windows 11, 64 bit.

albert-github added a commit to albert-github/doxygen that referenced this issue Mar 29, 2024
… create directories

The `module_` should be part of the (file) name not prepended to the directory name.
@albert-github albert-github added the C++20 For features introduced in the 2020 spec of C++ label Mar 29, 2024
@albert-github
Copy link
Collaborator

I've just pushed a proposed patch, pull request #10772

doxygen added a commit that referenced this issue Mar 31, 2024
issue #10763 CREATE_SUBDIRS and C++20 modules: Doxygen doesn't create directories
@albert-github albert-github added the fixed but not released Bug is fixed in github, but still needs to make its way to an official release label Apr 1, 2024
@albert-github
Copy link
Collaborator

Code has been integrated in master on GitHub (please don't close the issue as this will be done at the moment of an official release).

@doxygen
Copy link
Owner

doxygen commented May 20, 2024

This issue was previously marked 'fixed but not released',
which means it should be fixed in doxygen version 1.11.0.
Please verify if this is indeed the case. Reopen the
issue if you think it is not fixed and please include any additional information
that you think can be relevant (preferably in the form of a self-contained example).

@doxygen doxygen removed the fixed but not released Bug is fixed in github, but still needs to make its way to an official release label May 20, 2024
@doxygen doxygen closed this as completed May 20, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug C/C++ C++20 For features introduced in the 2020 spec of C++
Projects
None yet
Development

No branches or pull requests

3 participants