man-pages/man1/gtk-update-icon-cache.1.html
2021-03-31 01:06:50 +01:00

136 lines
2.6 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of GTK-UPDATE-ICON-C</TITLE>
</HEAD><BODY>
<H1>GTK-UPDATE-ICON-C</H1>
Section: User Commands (1)<BR>Updated: <BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
gtk-update-icon-cache - Icon theme caching utility
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<DL COMPACT>
<DT id="1">
<B>gtk-update-icon-cache</B> [--force] [--ignore-theme-index] [--index-only | --include-image-data] [--source&nbsp;<I>NAME</I>] [--quiet] [--validate] <I>PATH</I>
</DL>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<P>
<B>gtk-update-icon-cache</B>
<DD>creates mmapable cache files for icon themes.
<P>
It expects to be given the
<I>PATH</I>
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.
<P>
GTK+ can use the cache files created by
<B>gtk-update-icon-cache</B>
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 mmaped shared between multiple applications, the overall memory consumption is reduced as well.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<P>
--force, -f
<DL COMPACT><DT id="2"><DD>
Overwrite an existing cache file even if it appears to be uptodate.
</DL>
<P>
--ignore-theme-index, -t
<DL COMPACT><DT id="3"><DD>
Don't check for the existence of
index.theme
in the icon theme directory. Without this option,
<B>gtk-update-icon-cache</B>
refuses to create an icon cache in a directory which does not appear to be the toplevel directory of an icon theme.
</DL>
<P>
--index-only, -i
<DL COMPACT><DT id="4"><DD>
Don't include image data in the cache.
</DL>
<P>
--include-image-data
<DL COMPACT><DT id="5"><DD>
Include image data in the cache.
</DL>
<P>
--source, -c
<DL COMPACT><DT id="6"><DD>
Output a C header file declaring a constant
<I>NAME</I>
with the contents of the icon cache.
</DL>
<P>
--quiet, -q
<DL COMPACT><DT id="7"><DD>
Turn off verbose output.
</DL>
<P>
--validate, -v
<DL COMPACT><DT id="8"><DD>
Validate existing icon cache.
</DL>
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="9"><A HREF="#lbAB">NAME</A><DD>
<DT id="10"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="11"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="12"><A HREF="#lbAE">OPTIONS</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:16 GMT, March 31, 2021
</BODY>
</HTML>