Welcome to Hawkmoth Discussions!

[jnikula]

👋 Welcome!

We’re using Discussions as a place to connect with other members of our community. We hope that you:

• Ask questions you’re wondering about, maybe with a lower bar than filing issues or venturing to IRC.
• Share ideas.
• Engage with other community members.
• Welcome others and are open-minded. Remember that this is a community we
  build together 💪.

[Daniel-Fundarek]

Hi, I wanted to create documentation for my ros2 project(cpp, python). I tried to use hawkmoth extension for cpp documentation, but i got this error everytime when i tried to build it. Do you know what can cause this error and how to solve it?

/home/dfundo/ros2_ws/src/dcs_utils/dcs_error_manager/docs/index.rst:15: ERROR: /home/dfundo/ros2_ws/src/dcs_utils/dcs_error_manager/src/dcs_error_manager.cpp: Error parsing translation unit.
/home/dfundo/ros2_ws/src/dcs_utils/dcs_error_manager/docs/index.rst:15: WARNING: "cpp:autoclass:: DCSErrorManager" does not match documented symbols.

This is my index.rst file

Welcome to My Project's documentation!
======================================

.. toctree::
  :maxdepth: 2

C++ classes
-----------

.. cpp:autoclass:: DCSErrorManager
   :file: dcs_error_manager.cpp
   :members:

Package structure:

├── CMakeLists.txt
├── dcs_error_manager
│   ├── augument_dataset.py
│   ├── dcs_error_manager.py
│   ├── __init__.py
│   └── __pycache__
│       ├── augument_dataset.cpython-38.pyc
│       ├── dcs_error_manager.cpython-38.pyc
│       └── __init__.cpython-38.pyc
├── docs
│   ├── _build
│   ├── conf.py
│   ├── index.rst
│   ├── make.bat
│   ├── Makefile
│   ├── _static
│   └── _templates
├── include
│   └── dcs_error_manager
│       └── dcs_error_manager.hpp
├── package.xml
├── src
│   ├── dcs_error_manager.cpp
│   └── dcs_error_manager_node.cpp
└── test
    ├── __init__.py
    ├── __pycache__
    │   ├── __init__.cpython-38.pyc
    │   └── test_dcs_error_manager.cpython-38.pyc
    └── test_dcs_error_manager.py

Also i am not sure if i included headers correctly in conf.py:

from clang.cindex import Config
Config.set_library_path('/usr/lib/python3/dist-packages/clang')
Config.set_library_file('/usr/lib/llvm-10/lib/libclang.so')

hawkmoth_clang = ['../include/dcs_error_manager', '-DHAWKMOTH']
hawkmoth_root = os.path.join(os.path.abspath(os.path.dirname(__file__)), '../src')

[jnikula]

Try adding -I in the clang params:

hawkmoth_clang = ['-I../include/dcs_error_manager', '-DHAWKMOTH']

[jnikula]

@Daniel-Fundarek Did you try this? Did it help?