AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity
2738d1475c
gtk2/docs/reference/gtk/gtk-update-icon-cache.1

47 lines
1.8 KiB
Groff
Raw Normal View History

Complain when there is no index.theme file in the specified directory, 2005-08-23 Matthias Clasen <mclasen@redhat.com> * gtk/updateiconcache.c: Complain when there is no index.theme file in the specified directory, unless --force is used. Also add an --index-only option to create caches without image data.
2005-08-23 15:18:08 +00:00
.\" ** You probably do not want to edit this file directly **
.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
.\" Instead of manually editing it, you probably should edit the DocBook XML
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
Add a separate --ignore-theme-index option to avoid overloading --force. 2005-08-26 Matthias Clasen <mclasen@redhat.com> * gtk/updateiconcache.c: Add a separate --ignore-theme-index option to avoid overloading --force. (JP Rosevaar)
2005-08-26 19:05:31 +00:00
.TH "GTK\-UPDATE\-ICON\-CACH" "1" "08/26/2005" "" ""
Complain when there is no index.theme file in the specified directory, 2005-08-23 Matthias Clasen <mclasen@redhat.com> * gtk/updateiconcache.c: Complain when there is no index.theme file in the specified directory, unless --force is used. Also add an --index-only option to create caches without image data.
2005-08-23 15:18:08 +00:00
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
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.
2004-10-19 18:45:41 +00:00
.ad l
Complain when there is no index.theme file in the specified directory, 2005-08-23 Matthias Clasen <mclasen@redhat.com> * gtk/updateiconcache.c: Complain when there is no index.theme file in the specified directory, unless --force is used. Also add an --index-only option to create caches without image data.
2005-08-23 15:18:08 +00:00
.SH "NAME"
gtk\-update\-icon\-cache \- Icon theme caching utility
.SH "SYNOPSIS"
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.
2004-10-19 18:45:41 +00:00
.HP 22
Add a separate --ignore-theme-index option to avoid overloading --force. 2005-08-26 Matthias Clasen <mclasen@redhat.com> * gtk/updateiconcache.c: Add a separate --ignore-theme-index option to avoid overloading --force. (JP Rosevaar)
2005-08-26 19:05:31 +00:00
\fBgtk\-update\-icon\-cache\fR [\-\-force] [\-\-index\-only] [\-\-ignore\-theme\-index] [\-\-quiet] {iconpath}
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.
2004-10-19 18:45:41 +00:00
.SH "DESCRIPTION"
.PP
Complain when there is no index.theme file in the specified directory, 2005-08-23 Matthias Clasen <mclasen@redhat.com> * gtk/updateiconcache.c: Complain when there is no index.theme file in the specified directory, unless --force is used. Also add an --index-only option to create caches without image data.
2005-08-23 15:18:08 +00:00
\fBgtk\-update\-icon\-cache\fR
creates mmap()able cache files for icon themes.
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.
2004-10-19 18:45:41 +00:00
.PP
Complain when there is no index.theme file in the specified directory, 2005-08-23 Matthias Clasen <mclasen@redhat.com> * gtk/updateiconcache.c: Complain when there is no index.theme file in the specified directory, unless --force is used. Also add an --index-only option to create caches without image data.
2005-08-23 15:18:08 +00:00
If expects to be given the path to a icon theme directory containing an
\fIindex.theme\fR, e.g.
\fI/usr/share/icons/hicolor\fR, and writes a
\fIicon\-theme.cache\fR
containing cached information about the icons in the directory tree below the given directory.
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.
2004-10-19 18:45:41 +00:00
.PP
Complain when there is no index.theme file in the specified directory, 2005-08-23 Matthias Clasen <mclasen@redhat.com> * gtk/updateiconcache.c: Complain when there is no index.theme file in the specified directory, unless --force is used. Also add an --index-only option to create caches without image data.
2005-08-23 15:18:08 +00:00
GTK+ can use the cache files created by
\fBgtk\-update\-icon\-cache\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.
Add a --quiet option. 2005-02-01 Matthias Clasen <mclasen@redhat.com> * gtk/updateiconcache.c (main): Add a --quiet option.
2005-02-01 13:55:08 +00:00
.SH "OPTIONS"
.TP
\-\-force, \-f
Complain when there is no index.theme file in the specified directory, 2005-08-23 Matthias Clasen <mclasen@redhat.com> * gtk/updateiconcache.c: Complain when there is no index.theme file in the specified directory, unless --force is used. Also add an --index-only option to create caches without image data.
2005-08-23 15:18:08 +00:00
Overwrite an existing cache file even if it appears to be uptodate.
.TP
Add a separate --ignore-theme-index option to avoid overloading --force. 2005-08-26 Matthias Clasen <mclasen@redhat.com> * gtk/updateiconcache.c: Add a separate --ignore-theme-index option to avoid overloading --force. (JP Rosevaar)
2005-08-26 19:05:31 +00:00
\-\-ignore\-theme\-index, \-t
Don't check for the existence of 'index.theme' in the icon theme directory. Without this option,
\fBgtk\-update\-icon\-cache\fR
refuses to create an icon cache in a directory which does not appear to be the toplevel directory of an icon theme.
.TP
Complain when there is no index.theme file in the specified directory, 2005-08-23 Matthias Clasen <mclasen@redhat.com> * gtk/updateiconcache.c: Complain when there is no index.theme file in the specified directory, unless --force is used. Also add an --index-only option to create caches without image data.
2005-08-23 15:18:08 +00:00
\-\-index\-only, \-i
Don't include image data in the cache.
Add a --quiet option. 2005-02-01 Matthias Clasen <mclasen@redhat.com> * gtk/updateiconcache.c (main): Add a --quiet option.
2005-02-01 13:55:08 +00:00
.TP
\-\-quiet, \-q
Complain when there is no index.theme file in the specified directory, 2005-08-23 Matthias Clasen <mclasen@redhat.com> * gtk/updateiconcache.c: Complain when there is no index.theme file in the specified directory, unless --force is used. Also add an --index-only option to create caches without image data.
2005-08-23 15:18:08 +00:00
Turn off verbose output.
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.
2004-10-19 18:45:41 +00:00
.SH "BUGS"
.PP
Complain when there is no index.theme file in the specified directory, 2005-08-23 Matthias Clasen <mclasen@redhat.com> * gtk/updateiconcache.c: Complain when there is no index.theme file in the specified directory, unless --force is used. Also add an --index-only option to create caches without image data.
2005-08-23 15:18:08 +00:00
None known yet.
Reference in New Issue Copy Permalink