1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
|
.. _gi-decompile-typelib(1):
.. meta::
:copyright: Copyright 2008, 2010 Johan Dahlin
:copyright: Copyright 2014 Robert Roth
:copyright: Copyright 2015 Dieter Verfaillie
:copyright: Copyright 2018 Tomasz Miąsko
:copyright: Copyright 2018 Christoph Reiter
:copyright: Copyright 2020 Jan Tojnar
:copyright: Copyright 2024 Collabora Ltd.
:license: LGPL-2.1-or-later
..
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
====================
gi-decompile-typelib
====================
------------------
Typelib decompiler
------------------
:Manual section: 1
SYNOPSIS
========
**gi-decompile-typelib** [*OPTION*…] *TYPELIB* [*TYPELIB*\ …]
DESCRIPTION
===========
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 ``--output``
is specified.
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.
Normally, GIR XML should be generated from source code, headers and
shared libraries using `g-ir-scanner(1) <man:g-ir-scanner(1)>`_
instead of using this tool.
On Debian-derived systems, each architecture provides a version of
**gi-decompile-typelib** prefixed with the *DEB_HOST_GNU_TYPE* from
**dpkg-architecture**\ (1), for example
**arm-linux-gnueabihf-gi-decompile-typelib**.
These architecture-prefixed names use appropriate search paths for the
given architecture, and should be used when cross-compiling.
Please see file:///usr/share/doc/gobject-introspection/README.Debian.gz
for more details.
OPTIONS
=======
``--help``
Show help options.
``--output`` *FILENAME*, ``-o`` *FILENAME*
Save the resulting output in *FILENAME*.
``--includedir`` *DIRECTORY*
Add *DIRECTORY* to the search path for typelibs.
This option can be used more than once.
The first *DIRECTORY* on the command-line will be searched first
(highest precedence).
``--all``
Show all available information.
``--version``
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
====
Report bugs at https://gitlab.gnome.org/GNOME/glib/-/issues
HOMEPAGE and CONTACT
====================
https://gi.readthedocs.io/
AUTHORS
=======
Matthias Clasen
|
