linuxdoc
linuxdoc copied to clipboard
return42
Sphinx-doc extensions for sophisticated C developer
It is really annoying to have different text in the source language and in the translation. This PR adds processor to the event `doctree-resolved` so all unnecessary nodes are removed...
The [kenerl-doc-man builder](https://return42.github.io/linuxdoc/linuxdoc-howto/man-pages.html) produces false positive warnings when using the [`:internal:`](https://return42.github.io/linuxdoc/linuxdoc-howto/kernel-doc-tests.html#option-internal) option of the [kernel-doc](https://return42.github.io/linuxdoc/linuxdoc-howto/kernel-doc-directive.html#kernel-doc-options) directive: ``` docs/linuxdoc-howto/test_internals.c:24: WARNING: Duplicate explicit target name: "test_internals_a.bar". docs/linuxdoc-howto/test_internals.c:24: WARNING: Duplicate C declaration, also...
This is the history of the origin kernel-doc script (Perl) we should have an eye on: - https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/log/scripts/kernel-doc?qt=grep&q= - https://salsa.debian.org/guest/kernel-doc/-/commits/rework/scripts/kernel-doc possible candidates for a takeover: - [ ] [kernel-doc: better...
Replace deprecated warn methods from: https://github.com/search?q=repo%3Areturn42%2Flinuxdoc+%22.warn%28%22&type=code