Merge pull request #4000 from MathieuDuponchelle/gir_multiple_libs

gnome.generate_gir: refactor and allow passing multiple libraries

2 files changed, 16 insertions, 4 deletions

diff --git a/docs/markdown/Gnome-module.md b/docs/markdown/Gnome-module.md
index 6b63f8a..cc85d87 100644
--- a/docs/markdown/Gnome-module.md
+++ b/docs/markdown/Gnome-module.md
@@ -67,10 +67,15 @@ executable(
 
 ### gnome.generate_gir()
 
-Generates GObject introspection data. Takes one positional argument,
-the build target you want to build gir data for. There are several
-keyword arguments. Many of these map directly to the `g-ir-scanner`
-tool so see its documentation for more information.
+Generates GObject introspection data.
+
+Takes one or more positional arguments:
+
+Either one or more library objects you want to build gir data for, or a single
+executable object.
+
+There are several keyword arguments. Many of these map directly to the
+`g-ir-scanner` tool so see its documentation for more information.
 
 * `dependencies`: deps to use during introspection scanning
 * `extra_args`: command line arguments to pass to gir compiler
diff --git a/docs/markdown/snippets/generate_gir_multiple_libraries.md b/docs/markdown/snippets/generate_gir_multiple_libraries.md
new file mode 100644
index 0000000..3541b71
--- /dev/null
+++ b/docs/markdown/snippets/generate_gir_multiple_libraries.md
@@ -0,0 +1,7 @@
+## gnome.generate_gir() now optionally accepts multiple libraries
+
+The GNOME module can now generate a single gir for multiple libraries, which
+is something `g-ir-scanner` supported, but had not been exposed yet.
+
+gnome.generate_gir() will now accept multiple positional arguments, if none
+of these arguments are an `Executable` instance.