EclassDocMissingInternal: new check for missing @internal

arthurzam · arthurzam · commit 330746b60014 · 2026-02-01T18:19:43.000+02:00
Requested-by: Ulrich Müller &lt;ulm@gentoo.org&gt;
Signed-off-by: Arthur Zamarin &lt;arthurzam@gentoo.org&gt;
diff --git a/testdata/data/repos/eclass/EclassCheck/EclassDocMissingInternal/expected.json b/testdata/data/repos/eclass/EclassCheck/EclassDocMissingInternal/expected.json
@@ -0,0 +1 @@
+{"__class__": "EclassDocMissingInternal", "eclass": "missing-internal", "function": "_missing_internal_func"}
diff --git a/testdata/data/repos/eclass/EclassCheck/EclassDocMissingInternal/fix.patch b/testdata/data/repos/eclass/EclassCheck/EclassDocMissingInternal/fix.patch
@@ -0,0 +1,10 @@
+--- eclass/eclass/missing-internal.eclass
++++ fixed/eclass/missing-internal.eclass
+@@ -10,6 +10,7 @@
+ _elibtoolize() { :; }
+
+ # @FUNCTION: _missing_internal_func
++# @INTERNAL
+ # @DESCRIPTION:
+ # missing internal tag
+ _missing_internal_func() { :; }
diff --git a/testdata/repos/eclass/eclass/missing-internal.eclass b/testdata/repos/eclass/eclass/missing-internal.eclass
@@ -0,0 +1,15 @@
+# @ECLASS: missing-internal.eclass
+# @MAINTAINER:
+# Random Person <maintainer@random.email>
+# @SUPPORTED_EAPIS: 6 7
+# @BLURB: Stub eclass with missing internal for function documentation.
+
+# @FUNCTION: _elibtoolize
+# @DESCRIPTION:
+# in whitelist
+_elibtoolize() { :; }
+
+# @FUNCTION: _missing_internal_func
+# @DESCRIPTION:
+# missing internal tag
+_missing_internal_func() { :; }

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+{"__class__": "EclassDocMissingInternal", "eclass": "missing-internal", "function": "_missing_internal_func"}`