mirror of
https://github.com/Cantera/cantera.git
synced 2026-08-17 16:35:17 -05:00
Bryan W. Weber
4ff4b78d5e
This has been bugging me for years, and I'm very happy to have finally fixed it! To debug this, I used the -vv output from sphinx-build to inspect what autodoc was doing. autodoc seemed to have no problem reading the source, but it was indeed generating reST with unmatched emphasis and strong markers. Although it really seems like autodoc should be able to handle this case, apparently it can't. Then, I was reading the autodoc documentation when I noticed this idea of an event handler, a function that gets called whenever a particular event happens. I realized I could get in and munge the docstring text to replace any unescaped splats with escaped ones.