modm-io / modm

modm: a C++23 library generator for AVR and ARM Cortex-M devices
https://modm.io
Mozilla Public License 2.0
748 stars 132 forks source link

Segmentation fault when building documentation files #1046

Open Joebeazelman opened 1 year ago

Joebeazelman commented 1 year ago

I am following the instructions under the Explore Examples section of the guide on my Mac MacOS Monterey using the latest mode release. I encountered no issues until I got to the generate Doxypress documentation where I received the following segmentation fault error message:

➜  blinky git:(develop) cd modm/docs && doxypress doxypress.json

DoxyPress Version: 1.5.1

**  Read Project Configuration
**  Verify Project Configuration

Initialization
Parse input files
[1]    57207 segmentation fault  doxypress doxypress.json
➜  docs git:(develop) 

Please advise.

salkinium commented 1 year ago

Well that sucks. Not even a useful error message.

You can try generating the docs with doxygen instead, there should also be another config file in the same location (doxygen.cfg?).

We use doxypress since it works better with new C++ syntax, but it also has issues.

rleh commented 1 year ago

We had issues with doxypress in the past, e.g. https://github.com/copperspice/doxypress/issues/34. Could you run it in GDB (just execute gdb doxypress) and check the backtrace?

salkinium commented 9 months ago

I can reproduce this, but even with lldb it's not immediately clear what produces this.