diff options
| author | Matthias Clasen <mclasen@redhat.com> | 2004-10-19 18:45:41 +0000 |
|---|---|---|
| committer | Matthias Clasen <matthiasc@src.gnome.org> | 2004-10-19 18:45:41 +0000 |
| commit | 6fc2b8118a77a4d3f6d237d573805302db5e54b7 (patch) | |
| tree | 3705cce0a4866838f8230b0e369e1c080c27cfc2 /docs/reference/gtk/gtk-update-icon-cache.xml | |
| parent | b087f7655108019d797ca6096077443761915431 (diff) | |
| download | gtk+-6fc2b8118a77a4d3f6d237d573805302db5e54b7.tar.gz | |
Implement icon theme caching. (#154034, Martijn Vernooij, caching schema
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.
Diffstat (limited to 'docs/reference/gtk/gtk-update-icon-cache.xml')
| -rw-r--r-- | docs/reference/gtk/gtk-update-icon-cache.xml | 53 |
1 files changed, 53 insertions, 0 deletions
diff --git a/docs/reference/gtk/gtk-update-icon-cache.xml b/docs/reference/gtk/gtk-update-icon-cache.xml new file mode 100644 index 0000000000..e7baad89d5 --- /dev/null +++ b/docs/reference/gtk/gtk-update-icon-cache.xml @@ -0,0 +1,53 @@ +<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> + + |