Brendan

breathe doesn't pass `c:function` properly with a C array syntax in parameter declaration

1

This was discovered in #816 when resolving all warning produced by `sphinx-build`. So, the test project (see link below) is taken from the original breathe docs, namely _examples/specific/array.h_. The C...

I just noticed that all admonitions for a page (at various places with in the page) are grouped and displayed at the bottom of the page when using `doxygenpage` directive....

This issue was discovered in the course of #816. It is centered around ```rst .. doxygenenumvalue:: EnumNS::Bar::BAZ And here is a broken reference to :cpp:enumerator:`EnumNS::BAZ`. And here is a working...

use RST domain in the docs

1

Hmm, we should probably change to use the directives [reStructuredText domain](https://www.sphinx-doc.org/en/master/usage/restructuredtext/domains.html#the-restructuredtext-domain) and then refer to them with the ``:rst:dir:``. Perhaps in a separate PR [...] _Originally posted by @jakobandersen in...

using CI to test against different versions of doxygen

1

I did this for a completely different project, but I thought I might share the idea. The following yaml will install doxygen from the pre-built binary archives available via [Doxygen's...

organize the growing list of class members

5

I think we should organize the class docs better somehow because there are so many functions. I’ll have to think about how to categorize them… _Originally posted by @TMRh20 in...

Device name: nRF24L01 Protocol: GPIO/SPI URL of example product: https://www.sparkfun.com/products/691 Further information: [nRF24L01+ datasheet](http://www.sparkfun.com/datasheets/Wireless/Nordic/nRF24L01P_Product_Specification_1_0.pdf) Example code for using this device with CircuitPython (on a RPi): ```python import board from circuitpython_nrf24l01.rf24...

**Describe the bug** I cannot document sequence-like return type inferred from the signature annotation. `Tuple[x, x]` throws a "index out of range" exception. Please feel free to edit the this...

html_codeblock_linenos_style will be deprecated in sphinx v6.0

2

[The fix for #26] will have to change soon (related to https://github.com/jbms/sphinx-immaterial/issues/26#issuecomment-1067465334). Sphinx v6.0 will no longer support this `html_codeblock_linenos_style` config option (which means inline line numbers for code blocks)....

python.apigen excluded imports option

7

I just tried this apigen.python ext on some docs I'm migrating to sphinx. While I think its cool to see third party dependencies (& lots of python std libs) get...