diff options
| author | Peter Maydell <peter.maydell@linaro.org> | 2023-03-14 11:44:31 +0000 |
|---|---|---|
| committer | Laurent Vivier <laurent@vivier.eu> | 2023-03-16 14:39:10 +0100 |
| commit | 364206640c6b34bae3bb9e428817e51d23a794d0 (patch) | |
| tree | 0c8084427cf1b25f76fc625920f2cd1866fb5bd8 /hw/virtio/virtio-input-host-pci.c | |
| parent | ad4052f104ab2a6e78f13e1d3053508e00599de3 (diff) | |
| download | focaccia-qemu-364206640c6b34bae3bb9e428817e51d23a794d0.tar.gz focaccia-qemu-364206640c6b34bae3bb9e428817e51d23a794d0.zip | |
docs/sphinx/kerneldoc.py: Honour --enable-werror
Currently, the kerneldoc Sphinx plugin doesn't honour the --enable-werror configure option, so its warnings are never fatal. This is because although we do pass sphinx-build the -W switch, the warnings from kerneldoc are produced by the scripts/kernel-doc script directly and don't go through Sphinx's "emit a warning" function. When --enable-werror is in effect, pass sphinx-build an extra argument -Dkerneldoc_werror=1. The kerneldoc plugin can then use this to determine whether it should be passing the kernel-doc script -Werror. We do this because there is no documented mechanism for a Sphinx plugin to determine whether sphinx-build was passed -W or not; if one is provided then we can switch to that at a later date: https://github.com/sphinx-doc/sphinx/issues/11239 Signed-off-by: Peter Maydell <peter.maydell@linaro.org> Reviewed-by: Thomas Huth <thuth@redhat.com> Message-Id: <20230314114431.1096972-1-peter.maydell@linaro.org> Signed-off-by: Laurent Vivier <laurent@vivier.eu>
Diffstat (limited to 'hw/virtio/virtio-input-host-pci.c')
0 files changed, 0 insertions, 0 deletions