From 66fda286e1b422558bd1ec77f77cc709b636746b Mon Sep 17 00:00:00 2001
From: Simon McVittie <smcv@collabora.com>
Date: Wed, 14 Feb 2024 11:41:14 +0000
Subject: [PATCH] g-ir- tools: Add examples to man pages

Signed-off-by: Simon McVittie <smcv@collabora.com>
---
 .../girepository/gi-compile-repository.rst         |  7 +++++++
 .../girepository/gi-decompile-typelib.rst          | 14 ++++++++++++++
 2 files changed, 21 insertions(+)

diff --git a/docs/reference/girepository/gi-compile-repository.rst b/docs/reference/girepository/gi-compile-repository.rst
index 27cfbe6ec..a1af705e2 100644
--- a/docs/reference/girepository/gi-compile-repository.rst
+++ b/docs/reference/girepository/gi-compile-repository.rst
@@ -78,6 +78,13 @@ OPTIONS
     Show program’s version number and exit.
 
 
+EXAMPLE
+=======
+
+::
+    $ gi-compile-repository -o Gio-2.0.typelib /usr/share/gir-1.0/Gio-2.0.gir
+
+
 BUGS
 ====
 
diff --git a/docs/reference/girepository/gi-decompile-typelib.rst b/docs/reference/girepository/gi-decompile-typelib.rst
index e6aa1f907..fbec91b86 100644
--- a/docs/reference/girepository/gi-decompile-typelib.rst
+++ b/docs/reference/girepository/gi-decompile-typelib.rst
@@ -75,6 +75,20 @@ OPTIONS
     Show program’s version number and exit.
 
 
+EXAMPLE
+=======
+
+::
+    $ libdir=/usr/lib/x86_64-linux-gnu     # or /usr/lib64 or similar
+    $ gi-decompile-typelib -o Gio-2.0.gir \
+      $libdir/girepository-1.0/Gio-2.0.typelib
+
+    $ diff -u /usr/share/gir-1.0/Gio-2.0.gir Gio-2.0.gir
+
+You will see that the original GIR XML contains much more information
+than the decompiled typelib.
+
+
 BUGS
 ====