1GIMPTOOL-2.0(1) General Commands Manual GIMPTOOL-2.0(1)
2
3
4
6 gimptool-2.0 - script to perform various GIMPy functions
7
8
9
11 gimptool-2.0 [--prefix[=DIR]] [--exec-prefix[=DIR]] [--version]
12 [--help] [--quiet] [--silent] [-n] [--just-print] [--dry-run] [--recon]
13 [--msvc-syntax] [--bindir] [--sbindir] [--libexecdir] [--datadir]
14 [--sysconfdir] [--sharedstatedir] [--localstatedir] [--libdir]
15 [--infodir] [--mandir] [--includedir] [--gimpplugindir] [--gimpdatadir]
16 [--libs] [--libs-noui] [--cflags] [--cflags-noi] [--build plug-in.c]
17 [--build-strip plug-in.c] [--install plug-in.c] [--install-strip
18 plug-in.c] [--install-admin plug-in.c] [--install-bin plug-in]
19 [--install-admin-strip plug-in.c] [--install-bin-strip plug-in]
20 [--install-admin-bin plug-in] [--install-script script.scm]
21 [--install-admin-script script.scm] [--uninstall-bin plug-in] [--unin‐
22 stall-admin-bin plug-in] [--uninstall-script script.scm] [--unin‐
23 stall-admin-script script.scm]
24
25
26
28 gimptool-2.0 is a tool that can, among other things, build plug-ins or
29 scripts and install them if they are distributed in one source file.
30
31 gimptool-2.0 can also be used by programs that need to know what
32 libraries and include-paths GIMP was compiled with. gimptool-2.0 uses
33 pkg-config for this task. For use in Makefiles, it is recommended that
34 you use pkg-config directly instead of calling gimptool-2.0.
35
36
37
39 gimptool-2.0 accepts the following options:
40
41 --version
42 Print the currently installed version of GIMP on the standard
43 output.
44
45 --help Print out the help blurb, showing commonly used commandline
46 options.
47
48 --quiet Run quietly without echoing any of the build commands.
49
50 --silent
51 Run silently without echoing any of the build commands. Same as
52 --quiet.
53
54 -n Test mode. Print the commands but don't actually execute them.
55 Useful for making dry runs for testing.
56
57 --just-print
58 Test mode. Print the commands but don't actually execute them.
59 Same as -n.
60
61 --dry-run
62 Test mode. Print the commands but don't actually execute them.
63 Same as -n.
64
65 --recon Test mode. Print the commands but don't actually execute them.
66 Same as -n.
67
68 --msvc-syntax
69 Useful on Windows. Outputs the compiler and linker flags in the
70 syntax used by Microsoft's toolchain. Passed to the pkg-config
71 command that does most of gimptool-2.0's work.
72
73 --bindir
74 Outputs the bindir used to install the GIMP.
75
76 --sbindir
77 Outputs the sbindir used to install the GIMP.
78
79 --libexecdir
80 Outputs the libexecdir used to install the GIMP.
81
82 --datadir
83 Outputs the datadir used to install the GIMP.
84
85 --sysconfdir
86 Outputs the sysconfdir used to install the GIMP.
87
88 --sharedstatedir
89 Outputs the sharedstatedir used to install the GIMP.
90
91 --localstatedir
92 Outputs the localstatedir used to install the GIMP.
93
94 --libdir
95 Outputs the libdir used to install the GIMP.
96
97 --infodir
98 Outputs the infodir used to install the GIMP.
99
100 --mandir
101 Outputs the mandir used to install the GIMP.
102
103 --includedir
104 Outputs the includedir used to install the GIMP.
105
106 --gimpdatadir
107 Outputs the actual directory where the GIMP data files were
108 installed.
109
110 --gimpplugindir
111 Outputs the actual directory where the GIMP plug-ins were
112 installed.
113
114 --build plug-in.c
115 Compile and link plug-in.c into a GIMP plug-in.
116
117 --build-strip plug-in.c
118 Compile,link, and strip plug-in.c into a GIMP plug-in.
119
120 --install plug-in.c
121 Compile, link, and install plug-in.c into the user's personal
122 GIMP plug-in directory ($HOME/.gimp-2.8/plug-ins)
123
124 --install-strip plug-in.c
125 Compile, link,strip, and install plug-in.c into the user's per‐
126 sonal GIMP plug-in directory ($HOME/.gimp-2.8/plug-ins)
127
128 --install-admin plug-in.c
129 Compile, link, and install plug-in.c into the system-wide GIMP
130 plug-in directory (/usr/lib64/gimp/2.0/plug-ins)
131
132 --install-bin plug-in
133 Install plug-in into the user's personal GIMP plug-in directory
134 ($HOME/.gimp-2.8/plug-ins)
135
136 --install-admin-bin plug-in
137 Install plug-in into the system-wide GIMP plug-in directory
138 (/usr/lib64/gimp/2.0/plug-ins)
139
140 --install-bin-strip plug-in
141 Install stripped plug-in into the user's personal GIMP plug-in
142 directory ($HOME/.gimp-2.8/plug-ins)
143
144 --install-admin-bin-strip plug-in
145 Install stripped plug-in into the system-wide GIMP plug-in
146 directory (/usr/lib64/gimp/2.0/plug-ins)
147
148 --install-script script.scm
149 Install script.scm into the user's personal GIMP script direc‐
150 tory ($HOME/.gimp-2.8/scripts)
151
152 --install-admin-script script.scm
153 Install script.scm into the system-wide GIMP script directory
154 (/usr/share/gimp/2.0/scripts)
155
156 --uninstall-bin plug-in
157 Uninstall plug-in from the user's personal GIMP plug-in direc‐
158 tory ($HOME/.gimp-2.8/plug-ins)
159
160 --uninstall-admin-bin plug-in
161 Uninstall plug-in from the system-wide GIMP plug-in directory
162 (/usr/lib64/gimp/2.0/plug-ins)
163
164 --uninstall-script script.scm
165 Uninstall script.scm from the user's personal GIMP script
166 directory ($HOME/.gimp-2.8/scripts)
167
168 --uninstall-admin-script script.scm
169 Uninstall script.scm from the system-wide GIMP script directory
170 (/usr/share/gimp/2.0/scripts)
171
172 --libs Print the linker flags that are necessary to link a GIMP plug-
173 in.
174
175 --libs-noui
176 Print the linker flags that are necessary to link a GIMP plug-
177 in, for plug-ins that do not require the GTK+ libraries.
178
179 --cflags
180 Print the compiler flags that are necessary to compile a GIMP
181 plug-in.
182
183 --clags-noui
184 Print the compiler flags that are necessary to compile a GIMP
185 plug-in for plug-ins that do not require the GTK+ libraries.
186
187 --prefix=PREFIX
188 If specified, use PREFIX instead of the installation prefix
189 that GIMP was built with when computing the output for the
190 --cflags and --libs options. This option is also used for the
191 exec prefix if --exec-prefix was not specified. This option
192 must be specified before any --libs or --cflags options.
193
194 --exec-prefix=PREFIX
195 If specified, use PREFIX instead of the installation exec pre‐
196 fix that GIMP was built with when computing the output for the
197 --cflags and --libs options. This option must be specified
198 before any --libs or --cflags options.
199
200
201
203 CC to get the name of the desired C compiler.
204
205 CFLAGS to get the preferred flags to pass to the C compiler for plug-
206 in building.
207
208 LDFLAGS to get the preferred flags for passing to the linker.
209
210 LIBS for passing extra libs that may be needed in the build process.
211 For example, LIBS=-lintl .
212
213 PKG_CONFIG
214 to get the location of the pkg-config program that is used to
215 determine details about your glib, pango, gtk+ and gimp instal‐
216 lation.
217
218
219
221 gimp(1), gimprc(5), pkg-config(1)
222
223
224
226 gimptool was written by Manish Singh (yosh@gimp.org) and is based on
227 gtk-config by Owen Taylor (owen@gtk.org).
228
229 This man page was written by Ben Gertzfield (che@debian.org), and
230 tweaked by Manish Singh (yosh@gimp.org), Adrian Likins
231 (adrian@gimp.org) and Marc Lehmann (pcg@goof.com>).
232
233
234
235
236GIMP Manual Pages Version 2.8.22 GIMPTOOL-2.0(1)