Commit 91fc6d8a authored Sep 28, 2020 by Mauro Carvalho Chehab

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>

parent 95f49490

Documentation/sphinx/kerneldoc.py

+2 −1

Original line number	Diff line number	Diff line
		@@ -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()

Admin message