Document internal dep support in pkgconfig.generate requires arg

Added in mesonbuild#14750 for 1.9.0.

Also add FeatureNew.

Author: bgilbert

docs/markdown/Pkgconfig-module.md

@@ -44,7 +44,9 @@ keyword arguments.
   `${PREFIX}/include/foobar-1`, the correct value for this argument
   would be `foobar-1`
 - `requires` list of strings, pkgconfig-dependencies or libraries that
-   `pkgconfig.generate()` was used on to put in the `Requires` field
+  `pkgconfig.generate()` was used on to put in the `Requires` field.
+  *Since 1.9.0* internal dependencies are supported if `pkgconfig.generate()`
+  was used on them.
 - `requires_private` the same as `requires` but for the `Requires.private` field
 - `url` a string with a url for the library
 - `license` (*Since 1.9.0*) a string with a SPDX license to add to the generated file.

docs/markdown/snippets/pkgconfig-requires.md

@@ -0,0 +1,4 @@
+## pkgconfig.generate supports internal dependencies in `requires`
+
+Internal dependencies can now be specified to `requires` if
+pkgconfig.generate was called on the underlying library.

mesonbuild/modules/pkgconfig.py

@@ -157,6 +157,8 @@ def _process_reqs(self, reqs: T.Sequence[T.Union[str, build.StaticLibrary, build
             elif isinstance(obj, dependencies.ExternalDependency) and obj.name == 'threads':
                 pass
             elif isinstance(obj, dependencies.InternalDependency) and all(lib.get_id() in self.metadata for lib in obj.libraries):
+                FeatureNew.single_use('pkgconfig.generate requirement from internal dependency', '1.9.0',
+                                      self.state.subproject, location=self.state.current_node)
                 # Ensure BothLibraries are resolved:
                 if self.pub_libs and isinstance(self.pub_libs[0], build.StaticLibrary):
                     obj = obj.get_as_static(recursive=True)
@@ -166,8 +168,10 @@ def _process_reqs(self, reqs: T.Sequence[T.Union[str, build.StaticLibrary, build
                     processed_reqs.append(self.metadata[lib.get_id()].filebase)
             else:
                 raise mesonlib.MesonException('requires argument not a string, '
-                                              'library with pkgconfig-generated file '
-                                              f'or pkgconfig-dependency object, got {obj!r}')
+                                              'library with pkgconfig-generated file, '
+                                              'pkgconfig-dependency object, or '
+                                              'internal-dependency object with '
+                                              f'pkgconfig-generated file, got {obj!r}')
         return processed_reqs
 
     def add_cflags(self, cflags: T.List[str]) -> None: