forked from AuroraMiddleware/gtk
6fc2b8118a
2004-10-19 Matthias Clasen <mclasen@redhat.com> Implement icon theme caching. (#154034, Martijn Vernooij, caching schema proposed by Owen Taylor, initial implementation by Anders Carlsson) * gtk/gtkdebug.h: * gtk/gtkmain.c: Add a "icontheme" debug flag. * gtk/Makefile.am (gtk_c_sources): Add gtkiconcache.c (gtk_private_h_sources): Add gtkiconcache.h (bin_PROGRAMS): Add gtk-update-icon-cache * gtk/gtkicontheme.c: Use icon caches if they are available. Currently, GTK+ uses the cache to get information about the available sizes, image file formats and .icon files. The actual image data, and the .icon file contents are not cached yet. * gtk/updateiconcache.c: A cmdline utility for generating icon cache files. * gtk/gtkiconcache.h: * gtk/gtkiconcache.c: The glue code to mmap an icon cache file and manage the information it contains.
54 lines
1.4 KiB
XML
54 lines
1.4 KiB
XML
<refentry id="gtk-update-icon-cache">
|
|
|
|
<refmeta>
|
|
<refentrytitle>gtk-update-icon-cache</refentrytitle>
|
|
<manvolnum>1</manvolnum>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname>gtk-update-icon-cache</refname>
|
|
<refpurpose>Icon theme caching utility</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<cmdsynopsis>
|
|
<command>gtk-update-icon-cache</command>
|
|
<arg choice="opt">--force</arg>
|
|
<arg choice="req">iconpath</arg>
|
|
</cmdsynopsis>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1><title>Description</title>
|
|
<para>
|
|
<command>gtk-update-icon-cache</command> creates mmap()able cache files for
|
|
icon themes.
|
|
</para>
|
|
<para>
|
|
If expects to be given the path to a icon theme directory, 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>gtk-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 mmap()ed shared between
|
|
multiple applications, the overall memory consumption is reduced as well.
|
|
</para>
|
|
<para>
|
|
If called with the --force argument,
|
|
<command>gtk-update-icon-cache</command> will overwrite an existing cache
|
|
file even if it appears to be uptodate.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1><title>Bugs</title>
|
|
<para>
|
|
None known yet.
|
|
</para>
|
|
</refsect1>
|
|
|
|
</refentry>
|
|
|
|
|