diff options
author | Emmanuele Bassi <ebassi@gnome.org> | 2021-09-24 18:00:08 +0100 |
---|---|---|
committer | Emmanuele Bassi <ebassi@gnome.org> | 2021-09-24 18:01:00 +0100 |
commit | 113d54648604f173fbf826668f44ebed9e9f3856 (patch) | |
tree | c0e707d2eca012e3364e4c080ab11127a49a1125 /docs | |
parent | 2c810c747d5c21161dd5a786101d2017f330c548 (diff) | |
download | gtk+-113d54648604f173fbf826668f44ebed9e9f3856.tar.gz |
docs: Remove the last remaining XML files
Diffstat (limited to 'docs')
-rw-r--r-- | docs/reference/gtk/gtk4-broadwayd.xml | 84 | ||||
-rw-r--r-- | docs/reference/gtk/gtk4-builder-tool.xml | 110 | ||||
-rw-r--r-- | docs/reference/gtk/gtk4-demo-application.xml | 44 | ||||
-rw-r--r-- | docs/reference/gtk/gtk4-demo.xml | 81 | ||||
-rw-r--r-- | docs/reference/gtk/gtk4-encode-symbolic-svg.xml | 74 | ||||
-rw-r--r-- | docs/reference/gtk/gtk4-icon-browser.xml | 55 | ||||
-rw-r--r-- | docs/reference/gtk/gtk4-launch.xml | 85 | ||||
-rw-r--r-- | docs/reference/gtk/gtk4-query-settings.xml | 45 | ||||
-rw-r--r-- | docs/reference/gtk/gtk4-update-icon-cache.xml | 123 | ||||
-rw-r--r-- | docs/reference/gtk/gtk4-widget-factory.xml | 63 | ||||
-rw-r--r-- | docs/reference/gtk/overview.xml | 101 |
11 files changed, 0 insertions, 865 deletions
diff --git a/docs/reference/gtk/gtk4-broadwayd.xml b/docs/reference/gtk/gtk4-broadwayd.xml deleted file mode 100644 index 4c6450944d..0000000000 --- a/docs/reference/gtk/gtk4-broadwayd.xml +++ /dev/null @@ -1,84 +0,0 @@ -<?xml version="1.0"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" - "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ -]> -<refentry id="gtk4-broadwayd"> - -<refentryinfo> - <title>gtk4-broadwayd</title> - <productname>GTK</productname> - <authorgroup> - <author> - <contrib>Developer</contrib> - <firstname>Alexander</firstname> - <surname>Larsson</surname> - </author> - </authorgroup> -</refentryinfo> - -<refmeta> - <refentrytitle>gtk4-broadwayd</refentrytitle> - <manvolnum>1</manvolnum> - <refmiscinfo class="manual">User Commands</refmiscinfo> -</refmeta> - -<refnamediv> - <refname>gtk4-broadwayd</refname> - <refpurpose>Broadway display server</refpurpose> -</refnamediv> - -<refsynopsisdiv> -<cmdsynopsis> -<command>gtk4-broadwayd</command> -<arg choice="opt">--port <replaceable>PORT</replaceable></arg> -<arg choice="opt">--address <replaceable>ADDRESS</replaceable></arg> -<arg choice="opt">--unixsocket <replaceable>ADDRESS</replaceable></arg> -<arg choice="opt"><replaceable>:DISPLAY</replaceable></arg> -</cmdsynopsis> -</refsynopsisdiv> - -<refsect1><title>Description</title> -<para> -<command>gtk4-broadwayd</command> is a display server for the Broadway -GDK backend. It allows multiple GTK applications to display their -windows in the same web browser, by connecting to gtk4-broadwayd. -</para> -<para> -When using gtk4-broadwayd, specify the display number to use, prefixed -with a colon, similar to X. The default display number is 0. -<programlisting> -gtk4-broadwayd :5 -</programlisting> -Then point your web browser at <literal>http://127.0.0.1:8085</literal>. -Start your applications like this: -<programlisting> -GDK_BACKEND=broadway BROADWAY_DISPLAY=:5 gtk4-demo -</programlisting> -</para> -</refsect1> - -<refsect1><title>Options</title> -<variablelist> - <varlistentry> - <term>--port</term> - <listitem><para>Use <replaceable>PORT</replaceable> as the HTTP - port, instead of the default 8080 + (<replaceable>DISPLAY</replaceable> - 1). - </para></listitem> - </varlistentry> - <varlistentry> - <term>--address</term> - <listitem><para>Use <replaceable>ADDRESS</replaceable> as the HTTP - address, instead of the default <literal>http://127.0.0.1:<replaceable>PORT</replaceable></literal>. - </para></listitem> - </varlistentry> - <varlistentry> - <term>--unixsocket</term> - <listitem><para>Use <replaceable>ADDRESS</replaceable> as the unix domain socket - address. This option overrides <literal>--address</literal> and <literal>--port</literal>. - It is available only on Unix-like systems. - </para></listitem> - </varlistentry> -</variablelist> -</refsect1> - -</refentry> diff --git a/docs/reference/gtk/gtk4-builder-tool.xml b/docs/reference/gtk/gtk4-builder-tool.xml deleted file mode 100644 index c6c6d1ae70..0000000000 --- a/docs/reference/gtk/gtk4-builder-tool.xml +++ /dev/null @@ -1,110 +0,0 @@ -<?xml version="1.0"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" - "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ -]> -<refentry id="gtk4-builder-tool"> - -<refentryinfo> - <title>gtk4-builder-tool</title> - <productname>GTK</productname> - <authorgroup> - <author> - <contrib>Developer</contrib> - <firstname>Matthias</firstname> - <surname>Clasen</surname> - </author> - </authorgroup> -</refentryinfo> - -<refmeta> - <refentrytitle>gtk4-builder-tool</refentrytitle> - <manvolnum>1</manvolnum> - <refmiscinfo class="manual">User Commands</refmiscinfo> -</refmeta> - -<refnamediv> - <refname>gtk4-builder-tool</refname> - <refpurpose>GtkBuilder file utility</refpurpose> -</refnamediv> - -<refsynopsisdiv> -<cmdsynopsis> -<command>gtk4-builder-tool</command> -<arg choice="opt"><replaceable>COMMAND</replaceable></arg> -<arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> -<arg choice="plain"><replaceable>FILE</replaceable></arg> -</cmdsynopsis> -</refsynopsisdiv> - -<refsect1><title>Description</title> -<para> - <command>gtk4-builder-tool</command> can perform various operations - on GtkBuilder .ui files. -</para> -<para> - The <option>validate</option> command validates the .ui file and reports - errors to stderr. -</para> -<para> - The <option>enumerate</option> command lists all the named objects that - are created in the .ui file. -</para> -<para> - The <option>preview</option> command displays the .ui file. This command - accepts options to specify the ID of the toplevel object and a .css file - to use. -</para> -<para> - The <option>simplify</option> 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. -</para> -<para> - When the <option>--3to4</option> is specified, <option>simplify</option> - 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. -</para> -<para> - You should always test the modified .ui files produced by gtk4-builder-tool - before using them in production. -</para> -<para> - Note in particular that the conversion - done with <option>--3to4</option> 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. -</para> -</refsect1> - -<refsect1><title>Simplify Options</title> - <para>The <option>simplify</option> command accepts the following options:</para> - <variablelist> - <varlistentry> - <term><option>--replace</option></term> - <listitem><para>Write the content back to the .ui file instead of stdout.</para></listitem> - </varlistentry> - <varlistentry> - <term><option>--3to4</option></term> - <listitem><para>Transform a GTK 3 ui file to GTK 4</para></listitem> - </varlistentry> - </variablelist> -</refsect1> - -<refsect1><title>Preview Options</title> - <para>The <option>preview</option> command accepts the following options:</para> - <variablelist> - <varlistentry> - <term><option>--id=<arg choice="plain">ID</arg></option></term> - <listitem><para>The ID of the object to preview. If not specified, - gtk4-builder-tool will choose a suitable object on its own.</para></listitem> - </varlistentry> - <varlistentry> - <term><option>--css=<arg choice="plain">FILE</arg></option></term> - <listitem><para>Load style information from the given .css file.</para></listitem> - </varlistentry> - </variablelist> -</refsect1> - -</refentry> diff --git a/docs/reference/gtk/gtk4-demo-application.xml b/docs/reference/gtk/gtk4-demo-application.xml deleted file mode 100644 index 4b7b51972d..0000000000 --- a/docs/reference/gtk/gtk4-demo-application.xml +++ /dev/null @@ -1,44 +0,0 @@ -<?xml version="1.0"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" - "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ -]> -<refentry id="gtk4-demo-application"> - -<refentryinfo> - <title>gtk4-demo-application</title> - <productname>GTK</productname> - <authorgroup> - <author> - <contrib>Developer</contrib> - <firstname>Matthias</firstname> - <surname>Clasen</surname> - </author> - </authorgroup> -</refentryinfo> - -<refmeta> - <refentrytitle>gtk4-demo-application</refentrytitle> - <manvolnum>1</manvolnum> - <refmiscinfo class="manual">User Commands</refmiscinfo> -</refmeta> - -<refnamediv> - <refname>gtk4-demo-application</refname> - <refpurpose>Demonstrate GtkApplication</refpurpose> -</refnamediv> - -<refsynopsisdiv> -<cmdsynopsis> -<command>gtk4-demo-application</command> -</cmdsynopsis> -</refsynopsisdiv> - -<refsect1><title>Description</title> -<para> -<command>gtk4-demo-application</command> is an example application -used by <command>gtk4-demo</command>. There is no need to call it -manually. -</para> -</refsect1> - -</refentry> diff --git a/docs/reference/gtk/gtk4-demo.xml b/docs/reference/gtk/gtk4-demo.xml deleted file mode 100644 index 009f82d03c..0000000000 --- a/docs/reference/gtk/gtk4-demo.xml +++ /dev/null @@ -1,81 +0,0 @@ -<?xml version="1.0"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" - "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ -]> -<refentry id="gtk4-demo"> - -<refentryinfo> - <title>gtk4-demo</title> - <productname>GTK</productname> - <authorgroup> - <author> - <contrib>Developer</contrib> - <firstname>Matthias</firstname> - <surname>Clasen</surname> - </author> - </authorgroup> -</refentryinfo> - -<refmeta> - <refentrytitle>gtk4-demo</refentrytitle> - <manvolnum>1</manvolnum> - <refmiscinfo class="manual">User Commands</refmiscinfo> -</refmeta> - -<refnamediv> - <refname>gtk4-demo</refname> - <refpurpose>Demonstrate GTK widgets</refpurpose> -</refnamediv> - -<refsynopsisdiv> -<cmdsynopsis> -<command>gtk4-demo</command> -<arg choice="opt">--help</arg> -<arg choice="opt">--version</arg> -<arg choice="opt">--list</arg> -<arg choice="opt">--run <replaceable>EXAMPLE</replaceable></arg> -<arg choice="opt">--autoquit</arg> -</cmdsynopsis> -</refsynopsisdiv> - -<refsect1><title>Description</title> -<para> -<command>gtk4-demo</command> is a collection of examples. -Its purpose is to demonstrate many GTK widgets in a form -that is useful to application developers. -</para> -<para> -The application shows the source code for each example, as well as -other used resources, such as ui files and icons. -</para> -</refsect1> - -<refsect1><title>Options</title> - <para>The following options are understood:</para> - <variablelist> - <varlistentry> - <term><option>-h</option>, <option>--help</option></term> - <listitem><para>Show help options</para></listitem> - </varlistentry> - <varlistentry> - <term><option>--version</option></term> - <listitem><para>Show program version</para></listitem> - </varlistentry> - <varlistentry> - <term><option>--list</option></term> - <listitem><para>List available examples.</para></listitem> - </varlistentry> - <varlistentry> - <term><option>-run <replaceable>EXAMPLE</replaceable></option></term> - <listitem><para>Run the named example. Use <option>--list</option> to - see the available examples.</para></listitem> - </varlistentry> - <varlistentry> - <term><option>--autoquit</option></term> - <listitem><para>Quit after a short timeout. This is intended for use - with <option>--run</option>, e.g. when profiling.</para></listitem> - </varlistentry> - </variablelist> -</refsect1> - -</refentry> diff --git a/docs/reference/gtk/gtk4-encode-symbolic-svg.xml b/docs/reference/gtk/gtk4-encode-symbolic-svg.xml deleted file mode 100644 index 330795bc92..0000000000 --- a/docs/reference/gtk/gtk4-encode-symbolic-svg.xml +++ /dev/null @@ -1,74 +0,0 @@ -<?xml version="1.0"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" - "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ -]> -<refentry id="gtk4-encode-symbolic-svg"> - -<refentryinfo> - <title>gtk4-encode-symbolic-svg</title> - <productname>GTK</productname> - <authorgroup> - <author> - <contrib>Developer</contrib> - <firstname>Alexander</firstname> - <surname>Larsson</surname> - </author> - </authorgroup> -</refentryinfo> - -<refmeta> - <refentrytitle>gtk4-encode-symbolic-svg</refentrytitle> - <manvolnum>1</manvolnum> - <refmiscinfo class="manual">User Commands</refmiscinfo> -</refmeta> - -<refnamediv> - <refname>gtk4-encode-symbolic-svg</refname> - <refpurpose>Symbolic icon conversion utility</refpurpose> -</refnamediv> - -<refsynopsisdiv> -<cmdsynopsis> -<command>gtk4-encode-symbolic-svg</command> -<arg choice="opt">OPTION...</arg> -<arg choice="plain"><replaceable>PATH</replaceable></arg> -<arg choice="plain"><replaceable>WIDTH</replaceable>x<replaceable>HEIGHT</replaceable></arg> -</cmdsynopsis> -</refsynopsisdiv> - -<refsect1><title>Description</title> -<para> - <command>gtk4-encode-symbolic-svg</command> converts symbolic svg icons into - specially prepared png files. GTK can load and recolor these pngs, just like - original svgs, but loading them is much faster. -</para> -<para> - <replaceable>PATH</replaceable> is the name of a symbolic svg file, - <replaceable>WIDTH</replaceable>x<replaceable>HEIGHT</replaceable> are the - desired dimensions for the generated png file. -</para> -<para> - To distinguish them from ordinary pngs, the generated files have the extension - <filename>.symbolic.png</filename>. -</para> -</refsect1> - -<refsect1><title>Options</title> -<variablelist> - <varlistentry> - <term>-o <replaceable>DIRECTORY</replaceable></term> - <term>--output <replaceable>DIRECTORY</replaceable></term> - <listitem><para>Write png files to <replaceable>DIRECTORY</replaceable> - instead of the current working directory.</para></listitem> - </varlistentry> - <varlistentry> - <term>--debug</term> - <listitem><para>Generate png files of the various channels during - the conversion. If these files are not monochrome green, they - are often helpful in pinpointing the problematic parts of - the source svg.</para></listitem> - </varlistentry> -</variablelist> -</refsect1> - -</refentry> diff --git a/docs/reference/gtk/gtk4-icon-browser.xml b/docs/reference/gtk/gtk4-icon-browser.xml deleted file mode 100644 index ee37d55352..0000000000 --- a/docs/reference/gtk/gtk4-icon-browser.xml +++ /dev/null @@ -1,55 +0,0 @@ -<?xml version="1.0"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" - "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ -]> -<refentry id="gtk4-icon-browser"> - -<refentryinfo> - <title>gtk4-icon-browser</title> - <productname>GTK</productname> - <authorgroup> - <author> - <contrib>Developer</contrib> - <firstname>Matthias</firstname> - <surname>Clasen</surname> - </author> - </authorgroup> -</refentryinfo> - -<refmeta> - <refentrytitle>gtk4-icon-browser</refentrytitle> - <manvolnum>1</manvolnum> - <refmiscinfo class="manual">User Commands</refmiscinfo> -</refmeta> - -<refnamediv> - <refname>gtk4-icon-browser</refname> - <refpurpose>List themed icons</refpurpose> -</refnamediv> - -<refsynopsisdiv> -<cmdsynopsis> -<command>gtk4-icon-browser</command> -<arg choice="opt">--help</arg> -</cmdsynopsis> -</refsynopsisdiv> - -<refsect1><title>Description</title> -<para> -<command>gtk4-icon-browser</command> is a utility to explore the icons -in the current icon theme. It shows icons in various sizes, their symbolic -variants where available, as well as a description of the icon and its context. -</para> -</refsect1> - -<refsect1><title>Options</title> - <para>The following options are understood:</para> - <variablelist> - <varlistentry> - <term><option>-h</option>, <option>--help</option></term> - <listitem><para>Show help options</para></listitem> - </varlistentry> - </variablelist> -</refsect1> - -</refentry> diff --git a/docs/reference/gtk/gtk4-launch.xml b/docs/reference/gtk/gtk4-launch.xml deleted file mode 100644 index 8ee32141a0..0000000000 --- a/docs/reference/gtk/gtk4-launch.xml +++ /dev/null @@ -1,85 +0,0 @@ -<?xml version="1.0"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" - "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ -]> -<refentry id="gtk4-launch"> - -<refentryinfo> - <title>gtk4-launch</title> - <productname>GTK</productname> - <authorgroup> - <author> - <contrib>Developer</contrib> - <firstname>Tomáš</firstname> - <surname>Bžatek</surname> - <email>tbzatek@redhat.com</email> - </author> - </authorgroup> -</refentryinfo> - -<refmeta> - <refentrytitle>gtk4-launch</refentrytitle> - <manvolnum>1</manvolnum> - <refmiscinfo class="manual">User Commands</refmiscinfo> -</refmeta> - -<refnamediv> - <refname>gtk4-launch</refname> - <refpurpose>Launch an application</refpurpose> -</refnamediv> - -<refsynopsisdiv> -<cmdsynopsis> -<command>gtk4-launch</command> -<arg choice="opt" rep="repeat">OPTION</arg> -<arg choice="plain">APPLICATION</arg> -<arg choice="opt" rep="repeat">URI</arg> -</cmdsynopsis> -</refsynopsisdiv> - -<refsect1><title>Description</title> -<para> -<command>gtk4-launch</command> launches an application using the given name. -The application is started with proper startup notification on a default -display, unless specified otherwise. -</para> -<para> -<command>gtk4-launch</command> takes at least one argument, the name of -the application to launch. The name should match application desktop file name, -as residing in the applications subdirectories of the XDG data directories, with -or without the '.desktop' suffix. -</para> -<para> -If called with more than one argument, the rest of them besides the application -name are considered URI locations and are passed as arguments to the launched -application. -</para> -</refsect1> - -<refsect1><title>Options</title> - <para>The following options are understood:</para> - <variablelist> - <varlistentry> - <term><option>-?</option>, <option>--help</option></term> - <listitem><para>Prints a short help text and exits.</para></listitem> - </varlistentry> - </variablelist> - <variablelist> - <varlistentry> - <term><option>--version</option></term> - <listitem><para>Prints the program version and exits.</para></listitem> - </varlistentry> - </variablelist> -</refsect1> - -<refsect1><title>Environment</title> - <para>Some environment variables affect the behavior of <command>gtk4-launch</command>.</para> - <variablelist> - <varlistentry> - <term><option>XDG_DATA_HOME</option>, <option>XDG_DATA_DIRS</option></term> - <listitem><para>The environment variables specifying the XDG dta directories.</para></listitem> - </varlistentry> - </variablelist> -</refsect1> - -</refentry> diff --git a/docs/reference/gtk/gtk4-query-settings.xml b/docs/reference/gtk/gtk4-query-settings.xml deleted file mode 100644 index 881e88180a..0000000000 --- a/docs/reference/gtk/gtk4-query-settings.xml +++ /dev/null @@ -1,45 +0,0 @@ -<?xml version="1.0"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" - "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ -]> -<refentry id="gtk4-query-settings"> - -<refentryinfo> - <title>gtk4-query-settings</title> - <productname>GTK</productname> - <authorgroup> - <author> - <contrib>Developer</contrib> - <firstname>Timm</firstname> - <surname>Bäder</surname> - </author> - </authorgroup> -</refentryinfo> - -<refmeta> - <refentrytitle>gtk4-query-settings</refentrytitle> - <manvolnum>1</manvolnum> - <refmiscinfo class="manual">User Commands</refmiscinfo> -</refmeta> - -<refnamediv> - <refname>gtk4-query-settings</refname> - <refpurpose>Utility to print name and value of all GtkSettings properties</refpurpose> -</refnamediv> - -<refsynopsisdiv> -<cmdsynopsis> -<command>gtk4-query-settings</command> -<arg choice="opt"><replaceable>PATTERN</replaceable></arg> -</cmdsynopsis> -</refsynopsisdiv> - -<refsect1><title>Description</title> -<para> - <command>gtk4-query-settings</command> prints both name and value of all properties - available in the GtkSettings class. Optionally, you can filter which properties - to list by specifying a PATTERN. -</para> -</refsect1> - -</refentry> diff --git a/docs/reference/gtk/gtk4-update-icon-cache.xml b/docs/reference/gtk/gtk4-update-icon-cache.xml deleted file mode 100644 index 769853a57b..0000000000 --- a/docs/reference/gtk/gtk4-update-icon-cache.xml +++ /dev/null @@ -1,123 +0,0 @@ -<?xml version="1.0"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" - "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ -]> -<refentry id="gtk4-update-icon-cache"> - -<refentryinfo> - <title>gtk4-update-icon-cache</title> - <productname>GTK</productname> - <authorgroup> - <author> - <contrib>Developer</contrib> - <firstname>Matthias</firstname> - <surname>Clasen</surname> - </author> - </authorgroup> -</refentryinfo> - -<refmeta> - <refentrytitle>gtk4-update-icon-cache</refentrytitle> - <manvolnum>1</manvolnum> - <refmiscinfo class="manual">User Commands</refmiscinfo> -</refmeta> - -<refnamediv> - <refname>gtk4-update-icon-cache</refname> - <refpurpose>Icon theme caching utility</refpurpose> -</refnamediv> - -<refsynopsisdiv> -<cmdsynopsis> -<command>gtk4-update-icon-cache</command> -<arg choice="opt">--force</arg> -<arg choice="opt">--ignore-theme-index</arg> -<group> - <arg choice="plain">--index-only</arg> - <arg choice="plain">--include-image-data</arg> -</group> -<arg choice="opt">--source <arg choice="plain"><replaceable>NAME</replaceable></arg></arg> -<arg choice="opt">--quiet</arg> -<arg choice="opt">--validate</arg> -<arg choice="plain"><replaceable>PATH</replaceable></arg> -</cmdsynopsis> -</refsynopsisdiv> - -<refsect1><title>Description</title> -<para> - <command>gtk4-update-icon-cache</command> creates mmapable cache - files for icon themes. -</para> -<para> - It expects to be given the <replaceable>PATH</replaceable> to an icon theme - directory containing an <filename>index.theme</filename>, e.g. - <filename>/usr/share/icons/hicolor</filename>, and writes a - <filename>icon-theme.cache</filename> containing cached information about - the icons in the directory tree below the given directory. -</para> -<para> - GTK can use the cache files created by <command>gtk4-update-icon-cache</command> - to avoid a lot of system call and disk seek overhead when the application - starts. Since the format of the cache files allows them to be shared across - multiple processes, for instance using the POSIX <command>mmap()</command> system - call, the overall memory consumption is reduced as well. -</para> -</refsect1> - -<refsect1><title>Options</title> -<variablelist> - <varlistentry> - <term>--force</term> - <term>-f</term> - <listitem><para>Overwrite an existing cache file even if it appears to be - up-to-date.</para></listitem> - </varlistentry> - - <varlistentry> - <term>--ignore-theme-index</term> - <term>-t</term> - <listitem><para>Don't check for the existence of <filename>index.theme</filename> - in the icon theme directory. Without this option, <command>gtk4-update-icon-cache</command> - refuses to create an icon cache in a directory which does not appear to - be the toplevel directory of an icon theme. - </para></listitem> - </varlistentry> - - <varlistentry> - <term>--index-only</term> - <term>-i</term> - <listitem><para>Don't include image data in the cache. - </para></listitem> - </varlistentry> - - <varlistentry> - <term>--include-image-data</term> - <listitem><para>Include image data in the cache. - </para></listitem> - </varlistentry> - - <varlistentry> - <term>--source</term> - <term>-c</term> - <listitem><para>Output a C header file declaring a constant - <replaceable>NAME</replaceable> with the contents of the icon - cache.</para></listitem> - </varlistentry> - - <varlistentry> - <term>--quiet</term> - <term>-q</term> - <listitem><para>Turn off verbose output. - </para></listitem> - </varlistentry> - - <varlistentry> - <term>--validate</term> - <term>-v</term> - <listitem><para>Validate existing icon cache. - </para></listitem> - </varlistentry> -</variablelist> -</refsect1> - -</refentry> diff --git a/docs/reference/gtk/gtk4-widget-factory.xml b/docs/reference/gtk/gtk4-widget-factory.xml deleted file mode 100644 index 6233fe65df..0000000000 --- a/docs/reference/gtk/gtk4-widget-factory.xml +++ /dev/null @@ -1,63 +0,0 @@ -<?xml version="1.0"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" - "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ -]> -<refentry id="gtk4-widget-factory"> - -<refentryinfo> - <title>gtk4-widget-factory</title> - <productname>GTK</productname> - <authorgroup> - <author> - <contrib>Developer</contrib> - <firstname>Matthias</firstname> - <surname>Clasen</surname> - </author> - </authorgroup> -</refentryinfo> - -<refmeta> - <refentrytitle>gtk4-widget-factory</refentrytitle> - <manvolnum>1</manvolnum> - <refmiscinfo class="manual">User Commands</refmiscinfo> -</refmeta> - -<refnamediv> - <refname>gtk4-widget-factory</refname> - <refpurpose>Demonstrate GTK widgets</refpurpose> -</refnamediv> - -<refsynopsisdiv> -<cmdsynopsis> -<command>gtk4-widget-factory</command> -<arg choice="opt">--help</arg> -</cmdsynopsis> -</refsynopsisdiv> - -<refsect1><title>Description</title> -<para> -<command>gtk4-widget-factory</command> is a collection of examples. -Its purpose is to demonstrate many GTK widgets in a form -that is useful to GTK theme developers. -</para> -<para> -The application shows widgets in different, typical combinations -and states. -</para> -</refsect1> - -<refsect1><title>Options</title> - <para>The following options are understood:</para> - <variablelist> - <varlistentry> - <term><option>-h</option>, <option>--help</option></term> - <listitem><para>Show help options</para></listitem> - </varlistentry> - <varlistentry> - <term><option>--version</option></term> - <listitem><para>Show program version</para></listitem> - </varlistentry> - </variablelist> -</refsect1> - -</refentry> diff --git a/docs/reference/gtk/overview.xml b/docs/reference/gtk/overview.xml deleted file mode 100644 index 0435836586..0000000000 --- a/docs/reference/gtk/overview.xml +++ /dev/null @@ -1,101 +0,0 @@ -<?xml version="1.0"?> -<!DOCTYPE partintro PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" - "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ - ]> -<partintro> -<para> -GTK is a library for creating graphical user interfaces. It -works on many UNIX-like platforms, Windows, and OS X. -GTK is released under the GNU Library General Public License -(GNU LGPL), which allows for flexible licensing of client -applications. GTK has a C-based object-oriented architecture that -allows for maximum flexibility. Bindings for many other languages have -been written, including C++, Objective-C, Guile/Scheme, Perl, Python, -TOM, Ada95, Free Pascal, and Eiffel. The GTK library itself contains -<firstterm>widgets</firstterm>, that is, GUI components such as GtkButton -or GtkTextView. - -</para> -<para> -GTK depends on the following libraries: -<variablelist> - -<varlistentry> -<term>GLib</term> -<listitem><para> -A general-purpose utility library, not specific to graphical user interfaces. -GLib provides many useful data types, macros, type conversions, -string utilities, file utilities, a main loop abstraction, and so on. -</para></listitem> -</varlistentry> - -<varlistentry> -<term>GObject</term> -<listitem><para>A library that provides a type system, a collection of -fundamental types including an object type, a signal system. -</para></listitem> -</varlistentry> - -<varlistentry> -<term>GIO</term> -<listitem><para>A modern, easy-to-use VFS API including abstractions for -files, drives, volumes, stream IO, as well as network programming and -DBus communication. -</para></listitem> -</varlistentry> - -<varlistentry> -<term>cairo</term> -<listitem><para>Cairo is a 2D graphics library with support for multiple -output devices. -</para></listitem> -</varlistentry> - -<varlistentry> -<term>Pango</term> -<listitem><para> -Pango is a library for internationalized text handling. It centers -around the PangoLayout object, representing a paragraph of text. -Pango provides the engine for GtkTextView, GtkLabel, GtkEntry, and -other widgets that display text. -</para></listitem> -</varlistentry> - -<varlistentry> -<term>GdkPixbuf</term> -<listitem><para> -This is a small library which allows you to create GdkPixbuf -("pixel buffer") objects from image data or image files. -Use a GdkPixbuf in combination with GtkImage to display images. -</para></listitem> -</varlistentry> - -<varlistentry> -<term>graphene</term> -<listitem><para> -This is a small library which provides vector and matrix datatypes -and operations. graphene provides optimized implementations using -various SIMD instruction sets such as SSE. -</para></listitem> -</varlistentry> - -<varlistentry> -<term>GDK</term> -<listitem><para> -GDK is the abstraction layer that allows GTK to support multiple -windowing systems. GDK provides window system facilities on Wayland, -X11, Windows, and OS X. -</para></listitem> -</varlistentry> - -<varlistentry> -<term>GSK</term> -<listitem><para> -GSK is a library for creating a scene graph from render nodes, -and rendering it using different rendering APIs. GSK provides renderers -for OpenGL, Vulkan and cairo. -</para></listitem> -</varlistentry> -</variablelist> -</para> -</partintro> |