forked from AuroraMiddleware/gtk
124 lines
3.7 KiB
XML
124 lines
3.7 KiB
XML
<?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>
|