← Back to branch summary

~ucl-cs-study-devs/activityfinder/gtk+2.0-2.24.27

« back to all changes in this revision

Viewing changes to docs/reference/gtk/gtk-update-icon-cache.1

  • Committer: Package Import Robot
  • Author(s): Iain Lane
  • Date: 2015-02-20 17:48:37 UTC
  • mfrom: (1.14.27)
  • Revision ID: package-import@ubuntu.com-20150220174837-slkw5y3egvqijcyu
Tags: 2.24.26-0ubuntu1
https://launchpad.net/bugs/1351890
* New upstream release.
  + Protect gdk_event_apply_filters_safe from changes in the filter list
  (LP: #1351890)
* Now need to build with --enable-man to build the manpages, and build-dep
  on libxml2-utils to get xmlcatalog which configure uses to decide whether
  to build them.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/gtk-update-icon-cache.1
1
 
'\" t
2
 
.\"     Title: gtk-update-icon-cache
3
 
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
4
 
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
5
 
.\"      Date: 10/10/2014
6
 
.\"    Manual: [FIXME: manual]
7
 
.\"    Source: [FIXME: source]
8
 
.\"  Language: English
9
 
.\"
10
 
.TH "GTK\-UPDATE\-ICON\-C" "1" "10/10/2014" "[FIXME: source]" "[FIXME: manual]"
11
 
.\" -----------------------------------------------------------------
12
 
.\" * Define some portability stuff
13
 
.\" -----------------------------------------------------------------
14
 
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15
 
.\" http://bugs.debian.org/507673
16
 
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17
 
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18
 
.ie \n(.g .ds Aq \(aq
19
 
.el       .ds Aq '
20
 
.\" -----------------------------------------------------------------
21
 
.\" * set default formatting
22
 
.\" -----------------------------------------------------------------
23
 
.\" disable hyphenation
24
 
.nh
25
 
.\" disable justification (adjust text to left margin only)
26
 
.ad l
27
 
.\" -----------------------------------------------------------------
28
 
.\" * MAIN CONTENT STARTS HERE *
29
 
.\" -----------------------------------------------------------------
30
 
.SH "NAME"
31
 
gtk-update-icon-cache \- Icon theme caching utility
32
 
.SH "SYNOPSIS"
33
 
.HP \w'\fBgtk\-update\-icon\-cache\fR\ 'u
34
 
\fBgtk\-update\-icon\-cache\fR [\-\-force] [\-\-ignore\-theme\-index] [\-\-index\-only | \-\-include\-image\-data] [\-\-source\ \fINAME\fR] [\-\-quiet] [\-\-validate] {iconpath}
35
 
.SH "DESCRIPTION"
36
 
.PP
37
 
\fBgtk\-update\-icon\-cache\fR
38
 
creates mmap()able cache files for icon themes\&.
39
 
.PP
40
 
It expects to be given the path to a icon theme directory containing an
41
 
index\&.theme, e\&.g\&.
42
 
/usr/share/icons/hicolor, and writes a
43
 
icon\-theme\&.cache
44
 
containing cached information about the icons in the directory tree below the given directory\&.
45
 
.PP
46
 
GTK+ can use the cache files created by
47
 
\fBgtk\-update\-icon\-cache\fR
48
 
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\&.
49
 
.SH "OPTIONS"
50
 
.PP
51
 
\-\-force, \-f
52
 
.RS 4
53
 
Overwrite an existing cache file even if it appears to be uptodate\&.
54
 
.RE
55
 
.PP
56
 
\-\-ignore\-theme\-index, \-t
57
 
.RS 4
58
 
Don\*(Aqt check for the existence of \*(Aqindex\&.theme\*(Aq in the icon theme directory\&. Without this option,
59
 
\fBgtk\-update\-icon\-cache\fR
60
 
refuses to create an icon cache in a directory which does not appear to be the toplevel directory of an icon theme\&.
61
 
.RE
62
 
.PP
63
 
\-\-index\-only, \-i
64
 
.RS 4
65
 
Don\*(Aqt include image data in the cache\&.
66
 
.RE
67
 
.PP
68
 
\-\-include\-image\-data
69
 
.RS 4
70
 
Include image data in the cache\&.
71
 
.RE
72
 
.PP
73
 
\-\-source, \-c
74
 
.RS 4
75
 
Output a C header file declaring a constant
76
 
\fIname\fR
77
 
with the contents of the icon cache\&.
78
 
.RE
79
 
.PP
80
 
\-\-quiet, \-q
81
 
.RS 4
82
 
Turn off verbose output\&.
83
 
.RE
84
 
.PP
85
 
\-\-validate, \-v
86
 
.RS 4
87
 
Validate existing icon cache\&.
88
 
.RE
89
 
.SH "BUGS"
90
 
.PP
91
 
None known yet\&.