.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "GI-DECOMPILE-TYPELIB" 1 "" ""
.SH NAME
gi-decompile-typelib \- Typelib decompiler
.\" This has to be duplicated from above to make it machine-readable by `reuse`:
.\" SPDX-FileCopyrightText: 2008, 2010 Johan Dahlin
.\" SPDX-FileCopyrightText: 2014 Robert Roth
.\" SPDX-FileCopyrightText: 2015 Dieter Verfaillie
.\" SPDX-FileCopyrightText: 2018 Tomasz Miąsko
.\" SPDX-FileCopyrightText: 2018 Christoph Reiter
.\" SPDX-FileCopyrightText: 2020 Jan Tojnar
.\" SPDX-FileCopyrightText: 2024 Collabora Ltd.
.\" SPDX-License-Identifier: LGPL-2.1-or-later
.
.SH SYNOPSIS
.sp
\fBgi\-decompile\-typelib\fP [\fIOPTION\fP…] \fITYPELIB\fP [\fITYPELIB\fP…]
.SH DESCRIPTION
.sp
gi\-decompile\-typelib is a GIR decompiler, using the repository API.
It generates GIR XML files from the compiled binary typelib format.
The output will be written to standard output unless the \fB\-\-output\fP
is specified.
.sp
The binary typelib format stores a subset of the information available
in GIR XML, so not all typelibs can be decompiled in this way, and the
resulting GIR XML might be incomplete.
.sp
Normally, GIR XML should be generated from source code, headers and
shared libraries using \fI\%g\-ir\-scanner(1)\fP
instead of using this tool.
.sp
On Debian\-derived systems, each architecture provides a version of
\fBgi\-decompile\-typelib\fP prefixed with the \fIDEB_HOST_GNU_TYPE\fP from
\fBdpkg\-architecture\fP(1), for example
\fBarm\-linux\-gnueabihf\-gi\-decompile\-typelib\fP\&.
These architecture\-prefixed names use appropriate search paths for the
given architecture, and should be used when cross\-compiling.
Please see \fI\%file:///usr/share/doc/gobject\-introspection/README.Debian.gz\fP
for more details.
.SH OPTIONS
.INDENT 0.0
.TP
.B \fB\-\-help\fP
Show help options.
.TP
.B \fB\-\-output\fP \fIFILENAME\fP, \fB\-o\fP \fIFILENAME\fP
Save the resulting output in \fIFILENAME\fP\&.
.TP
.B \fB\-\-includedir\fP \fIDIRECTORY\fP
Add \fIDIRECTORY\fP to the search path for typelibs.
This option can be used more than once.
The first \fIDIRECTORY\fP on the command\-line will be searched first
(highest precedence).
.TP
.B \fB\-\-all\fP
Show all available information.
.TP
.B \fB\-\-version\fP
Show program’s version number and exit.
.UNINDENT
.SH EXAMPLE
.INDENT 0.0
.TP
.B ::
$ libdir=/usr/lib/x86_64\-linux\-gnu     # or /usr/lib64 or similar
$ gi\-decompile\-typelib \-o Gio\-2.0.gir 
.IP "System Message: ERROR/3 (../../../docs/reference/girepository/gi-decompile-typelib.rst:, line 93)"
Unexpected indentation.
.INDENT 7.0
.INDENT 3.5
$libdir/girepository\-1.0/Gio\-2.0.typelib
.UNINDENT
.UNINDENT
.sp
$ diff \-u /usr/share/gir\-1.0/Gio\-2.0.gir Gio\-2.0.gir
.UNINDENT
.sp
You will see that the original GIR XML contains much more information
than the decompiled typelib.
.SH BUGS
.sp
Report bugs at \fI\%https://gitlab.gnome.org/GNOME/glib/\-/issues\fP
.SH HOMEPAGE AND CONTACT
.sp
\fI\%https://gi.readthedocs.io/\fP
.SH AUTHORS
.sp
Matthias Clasen
.\" Generated by docutils manpage writer.
.