diff options
| author |   Mauro Carvalho Chehab <mchehab+huawei@kernel.org> | 2020-09-28 11:22:12 +0200 |
|---|---|---|
| committer | Mauro Carvalho Chehab <mchehab+huawei@kernel.org> | 2020-10-15 07:49:37 +0200 |
| commit | 91fc6d8afe06698326bdd4d3bcb362c17c52e288 (patch) | |
| tree | 24bea94db04da227e41187a33e48b9313daf9721 /Documentation/sphinx/kerneldoc.py | |
| parent | docs: cdomain.py: extend it to handle new Sphinx 3.x tags (diff) | |
| download | linux-dev-91fc6d8afe06698326bdd4d3bcb362c17c52e288.tar.xz linux-dev-91fc6d8afe06698326bdd4d3bcb362c17c52e288.zip | |
docs: kerneldoc.py: append the name of the parsed doc file
Finding where an error like this was generated:
../lib/math/div64.c:73: WARNING: Duplicate C declaration, also defined in 'kernel-api'.
Can take some time, as there's no glue about what kernel-doc
tag generated it. It is a way better to display it as:
.../Documentation/core-api/kernel-api:171: ../lib/math/div64.c:73: WARNING: Duplicate C declaration, also defined in 'kernel-api'.
Declaration is 'div_s64_rem'.
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Diffstat (limited to '')
| -rw-r--r-- | Documentation/sphinx/kerneldoc.py | 3 |
1 files changed, 2 insertions, 1 deletions
diff --git a/Documentation/sphinx/kerneldoc.py b/Documentation/sphinx/kerneldoc.py index 1a1b12242a45..a3a5427130da 100644 --- a/Documentation/sphinx/kerneldoc.py +++ b/Documentation/sphinx/kerneldoc.py @@ -141,7 +141,8 @@ class KernelDocDirective(Directive): lineoffset = int(match.group(1)) - 1 # we must eat our comments since the upset the markup else: - result.append(line, filename, lineoffset) + doc = env.srcdir + "/" + env.docname + ":" + str(self.lineno) + result.append(line, doc + ": " + filename, lineoffset) lineoffset += 1 node = nodes.section() |