gtk4-builder-tool - GtkBuilder file utility
gtk4-builder-tool [COMMAND] [OPTION...] FILE
GTK4-BUILDER-TOOL(1) User Commands GTK4-BUILDER-TOOL(1)
NAME
gtk4-builder-tool - GtkBuilder file utility
SYNOPSIS
gtk4-builder-tool [COMMAND] [OPTION...] FILE
DESCRIPTION
gtk4-builder-tool can perform various operations on GtkBuilder .ui
files.
The validate command validates the .ui file and reports errors to
stderr.
The enumerate command lists all the named objects that are created in
the .ui file.
The preview command displays the .ui file. This command accepts options
to specify the ID of the toplevel object and a .css file to use.
The simplify command simplifies the .ui file by removing properties
that are set to their default values and writes the resulting XML to
stdout, or back to the input file.
When the --3to4 is specified, simplify interprets the input as a GTK 3
ui file and attempts to convert it to GTK 4 equivalents. It performs
various conversions, such as renaming properties, translating child
properties to layout properties, rewriting the setup for GtkNotebook,
GtkStack, GtkAssistant or changing toolbars into boxes.
You should always test the modified .ui files produced by
gtk4-builder-tool before using them in production.
Note in particular that the conversion done with --3to4 is meant as a
starting point for a port from GTK 3 to GTK 4. It is expected that you
will have to do manual fixups after the initial conversion.
SIMPLIFY OPTIONS
The simplify command accepts the following options:
--replace
Write the content back to the .ui file instead of stdout.
--3to4
Transform a GTK 3 ui file to GTK 4
PREVIEW OPTIONS
The preview command accepts the following options:
--id=ID
The ID of the object to preview. If not specified,
gtk4-builder-tool will choose a suitable object on its own.
--css=FILE
Load style information from the given .css file.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+-----------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------------+
|Availability | library/desktop/gtk4 |
+---------------+-----------------------+
|Stability | Pass-through volatile |
+---------------+-----------------------+
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from
https://download.gnome.org/sources/gtk/4.3/gtk-4.3.0.tar.xz.
Further information about this software can be found on the open source
community website at https://www.gtk.org/.
GTK GTK4-BUILDER-TOOL(1)