gi-compile-repository(1)

💖 gi-compile-repository — ok bestie, it's the Typelib compiler 💖

gi-compile-repository is a little tool from the General Commands Manual family, and she's here to turn your GIR files into typelibs. Come on, let's go 🦋

---

✨ SYNOPSIS ✨

gi-compile-repository [OPTION…] GIRFILE

Yeah. That's the whole vibe. Options plus a GIR file. Slay ✨

---

🌸 DESCRIPTION 🌸

So gi-compile-repository takes one or more GIR files and converts them into one or more typelibs. Iconic behaviour, honestly. 💅

The output goes to standard output by default — unless you pass --output, in which case it goes wherever you told it to. Periodt.

On Debian-derived systems 👑 each architecture ships its own version of gi-compile-repository, prefixed with the DEB_HOST_GNU_TYPE from dpkg-architecture(1). So like, for example:

arm-linux-gnueabihf-gi-compile-repository

These architecture-prefixed names use the appropriate search paths for whatever architecture you're targeting, and you should use them when you're cross-compiling. 🧚

Want the whole lore dump? Go read <file:///usr/share/doc/gobject-introspection/README.Debian.gz>. It's giving documentation, bestie 📖

---

🎀 OPTIONS 🎀

• --help — shows the help options. Your classic "wait what does this do again" moment 🙈
• --output FILENAME, -o FILENAME — saves the resulting output into FILENAME. No more yelling into stdout, we're being organised now 💖
• --verbose — shows verbose messages. She will talk more. Let her 🗣️
• --debug — shows debug messages. Maximum yapping mode, for when something is lowkey wrong 💀
• --includedir DIRECTORY — adds DIRECTORY to the search path for GIR XML. You can use this option more than once, and the first DIRECTORY on the command-line gets searched first (that's highest precedence, babe 👑).
• --shared-library FILENAME, -l FILENAME — specifies the shared library where the symbols in the typelib can be found. Here's the tea though: the library name should not contain the ending shared library suffix 🫖. You can use this option more than once, for typelibs that describe more than one shared library.
• --version — shows the program's version number and dips. Exit stage left 💅

---

🌈 EXAMPLE 🌈

$ gi-compile-repository -o Gio-2.0.typelib /usr/share/gir-1.0/Gio-2.0.gir

Look at her go. Not a single note. Ate 🔥

---

😭 BUGS 😭

Found a bug? Don't suffer in silence, bestie — report it at <https://gitlab.gnome.org/GNOME/glib/-/issues> 🫶

---

💜 HOMEPAGE and CONTACT 💜

<https://gi.readthedocs.io/> — go say hi, she's friendly ✨

---

⭐ AUTHORS ⭐

Matthias Clasen 👑

---

And that's the whole page, fr fr — brought to you by the General Commands Manual, version/date energy from gi-compile-repository(1). Stay compiled, bestie 🦋💖