diff options
| author | Mauro Carvalho Chehab <mchehab+samsung@kernel.org> | 2019-06-04 09:26:27 -0300 |
|---|---|---|
| committer | Jonathan Corbet <corbet@lwn.net> | 2019-06-07 11:33:16 -0600 |
| commit | b1663d7e3a7961fc45262fd68a89253f2803036c (patch) | |
| tree | e7e424e2d6bf9b53d846db99d421c19ffb1042ec /Documentation | |
| parent | 3f9564e680efb2092dfb826e2f768920c9eb203b (diff) | |
docs: Kbuild/Makefile: allow check for missing docs at build time
While this doesn't make sense for production Kernels, in order to
avoid regressions when documents are touched, let's add a
check target at the make file.
Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Diffstat (limited to 'Documentation')
| -rw-r--r-- | Documentation/Kconfig | 13 | ||||
| -rw-r--r-- | Documentation/Makefile | 5 |
2 files changed, 18 insertions, 0 deletions
diff --git a/Documentation/Kconfig b/Documentation/Kconfig new file mode 100644 index 000000000000..66046fa1c341 --- /dev/null +++ b/Documentation/Kconfig @@ -0,0 +1,13 @@ +config WARN_MISSING_DOCUMENTS + + bool "Warn if there's a missing documentation file" + depends on COMPILE_TEST + help + It is not uncommon that a document gets renamed. + This option makes the Kernel to check for missing dependencies, + warning when something is missing. Works only if the Kernel + is built from a git tree. + + If unsure, select 'N'. + + diff --git a/Documentation/Makefile b/Documentation/Makefile index 2df0789f90b7..e145e4db508b 100644 --- a/Documentation/Makefile +++ b/Documentation/Makefile @@ -4,6 +4,11 @@ subdir-y := devicetree/bindings/ +# Check for broken documentation file references +ifeq ($(CONFIG_WARN_MISSING_DOCUMENTS),y) +$(shell $(srctree)/scripts/documentation-file-ref-check --warn) +endif + # You can set these variables from the command line. SPHINXBUILD = sphinx-build SPHINXOPTS = |