'\" t
.\"     Title: gtk-update-icon-cache-3.0
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 11/08/2010
.\"    Manual: [FIXME: manual]
.\"    Source: [FIXME: source]
.\"  Language: English
.\"
.TH "GTK\-UPDATE\-ICON\-C" "1" "11/08/2010" "[FIXME: source]" "[FIXME: manual]"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
gtk-update-icon-cache-3.0 \- Icon theme caching utility
.SH "SYNOPSIS"
.HP \w'\fBgtk\-update\-icon\-cache\-3\&.0\fR\ 'u
\fBgtk\-update\-icon\-cache\-3\&.0\fR [\-\-force] [\-\-ignore\-theme\-index] [\-\-index\-only] [\-\-source\ [name]] [\-\-quiet] [\-\-validate] {iconpath}
.SH "DESCRIPTION"
.PP

\fBgtk\-update\-icon\-cache\-3\&.0\fR
creates mmap()able cache files for icon themes\&.
.PP
It expects to be given the path to a icon theme directory containing an
index\&.theme, e\&.g\&.
/usr/share/icons/hicolor, and writes a
icon\-theme\&.cache
containing cached information about the icons in the directory tree below the given directory\&.
.PP
GTK+ can use the cache files created by
\fBgtk\-update\-icon\-cache\-3\&.0\fR
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\&.
.SH "OPTIONS"
.PP
\-\-force, \-f
.RS 4
Overwrite an existing cache file even if it appears to be uptodate\&.
.RE
.PP
\-\-ignore\-theme\-index, \-t
.RS 4
Don\*(Aqt check for the existence of \*(Aqindex\&.theme\*(Aq in the icon theme directory\&. Without this option,
\fBgtk\-update\-icon\-cache\-3\&.0\fR
refuses to create an icon cache in a directory which does not appear to be the toplevel directory of an icon theme\&.
.RE
.PP
\-\-index\-only, \-i
.RS 4
Don\*(Aqt include image data in the cache\&.
.RE
.PP
\-\-source, \-c
.RS 4
Output a C header file declaring a constant
\fIname\fR
with the contents of the icon cache\&.
.RE
.PP
\-\-quiet, \-q
.RS 4
Turn off verbose output\&.
.RE
.PP
\-\-validate, \-v
.RS 4
Validate existing icon cache\&.
.RE
.SH "BUGS"
.PP
None known yet\&.
