Retitle gi-* man pages and update content

gi-compile-repository --module and gi-decompile-typelib --shlib are
intentionally undocumented here: they will be removed in !3926.

Signed-off-by: Simon McVittie <smcv@collabora.com>
This commit is contained in:
Simon McVittie 2024-02-13 16:14:54 +00:00
parent 615c51988d
commit d0cb89538a
2 changed files with 63 additions and 42 deletions

View File

@ -7,6 +7,7 @@
: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`:
@ -17,11 +18,12 @@
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
=============
g-ir-compiler
=============
=====================
gi-compile-repository
=====================
----------------
Typelib compiler
@ -33,51 +35,53 @@ Typelib compiler
SYNOPSIS
========
**g-ir-compiler** [OPTION...] GIRFILE
**gi-compile-repository** [*OPTION*…] *GIRFILE*
DESCRIPTION
===========
g-ir-compiler converts one or more GIR files into one or more typelib. The
output will be written to standard output unless the ``--output`` is
gi-compile-repository converts one or more GIR files into one or more typelibs.
The output will be written to standard output unless the ``--output`` is
specified.
OPTIONS
=======
--help
Show help options
``--help``
Show help options.
--output=FILENAME
Save the resulting output in FILENAME.
``--output`` *FILENAME*, ``-o`` *FILENAME*
Save the resulting output in *FILENAME*.
--verbose
Show verbose messages
``--verbose``
Show verbose messages.
--debug
Show debug messages
``--debug``
Show debug messages.
--includedir=DIRECTORY
Adds a directory which will be used to find includes inside the GIR format.
``--includedir`` *DIRECTORY*
Add *DIRECTORY* to the search path for GIR XML.
This option can be used more than once.
The first *DIRECTORY* on the command-line will be searched first
(highest precedence).
--module=MODULE
FIXME
--shared-library=FILENAME
``--shared-library`` *FILENAME*, ``-l`` *FILENAME*
Specifies the shared library where the symbols in the typelib can be
found. The name of the library should not contain the ending shared
library suffix.
This option can be used more than once, for typelibs that describe
more than one shared library.
--version
Show program's version number and exit
``--version``
Show programs version number and exit.
BUGS
====
Report bugs at https://gitlab.gnome.org/GNOME/gobject-introspection/issues
Report bugs at https://gitlab.gnome.org/GNOME/glib/-/issues
HOMEPAGE and CONTACT

View File

@ -6,6 +6,7 @@
: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`:
@ -15,15 +16,16 @@
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
=============
g-ir-generate
=============
====================
gi-decompile-typelib
====================
-----------------
Typelib generator
-----------------
------------------
Typelib decompiler
------------------
:Manual section: 1
@ -31,37 +33,52 @@ Typelib generator
SYNOPSIS
========
**g-ir-generate** [OPTION...] FILES...
**gi-decompile-typelib** [*OPTION*…] *TYPELIB* [*TYPELIB*\ …]
DESCRIPTION
===========
g-ir-generate is an GIR generator, using the repository API. It generates GIR
files from a raw typelib or in a shared library (``--shlib``). The output will
be written to standard output unless the ``--output`` is specified.
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.
OPTIONS
=======
--help
Show help options
``--help``
Show help options.
--shlib=FILENAME
The shared library to read the symbols from.
``--output`` *FILENAME*, ``-o`` *FILENAME*
Save the resulting output in *FILENAME*.
--output=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).
--version
Show program's version number and exit
``--all``
Show all available information.
``--version``
Show programs version number and exit.
BUGS
====
Report bugs at https://gitlab.gnome.org/GNOME/gobject-introspection/issues
Report bugs at https://gitlab.gnome.org/GNOME/glib/-/issues
HOMEPAGE and CONTACT