1GIMPTOOL-2.0(1) General Commands Manual GIMPTOOL-2.0(1)
2
6 gimptool-2.0 - script to perform various GIMPy functions
7
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
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 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
39 gimptool-2.0 accepts the following options:
40 --version
42 Print the currently installed version of GIMP on the standard
43 output.
44 --help Print out the help blurb, showing commonly used commandline
46 options.
47 --quiet Run quietly without echoing any of the build commands.
49 --silent
51 Run silently without echoing any of the build commands. Same as
52 --quiet.
53 -n Test mode. Print the commands but don't actually execute them.
55 Useful for making dry runs for testing.
56 --just-print
58 Test mode. Print the commands but don't actually execute them.
59 Same as -n.
60 --dry-run
62 Test mode. Print the commands but don't actually execute them.
63 Same as -n.
64 --recon Test mode. Print the commands but don't actually execute them.
66 Same as -n.
67 --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 --bindir
74 Outputs the bindir used to install the GIMP.
75 --sbindir
77 Outputs the sbindir used to install the GIMP.
78 --libexecdir
80 Outputs the libexecdir used to install the GIMP.
81 --datadir
83 Outputs the datadir used to install the GIMP.
84 --sysconfdir
86 Outputs the sysconfdir used to install the GIMP.
87 --sharedstatedir
89 Outputs the sharedstatedir used to install the GIMP.
90 --localstatedir
92 Outputs the localstatedir used to install the GIMP.
93 --libdir
95 Outputs the libdir used to install the GIMP.
96 --infodir
98 Outputs the infodir used to install the GIMP.
99 --mandir
101 Outputs the mandir used to install the GIMP.
102 --includedir
104 Outputs the includedir used to install the GIMP.
105 --gimpdatadir
107 Outputs the actual directory where the GIMP data files were
108 installed.
109 --gimpplugindir
111 Outputs the actual directory where the GIMP plug-ins were
112 installed.
113 --build plug-in.c
115 Compile and link plug-in.c into a GIMP plug-in.
116 --build-strip plug-in.c
118 Compile,link, and strip plug-in.c into a GIMP plug-in.
119 --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.6/plug-ins)
123 --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.6/plug-ins)
127 --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 --install-bin plug-in
133 Install plug-in into the user's personal GIMP plug-in directory
134 ($HOME/.gimp-2.6/plug-ins)
135 --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 --install-bin-strip plug-in
141 Install stripped plug-in into the user's personal GIMP plug-in
142 directory ($HOME/.gimp-2.6/plug-ins)
143 --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 --install-script script.scm
149 Install script.scm into the user's personal GIMP script direc‐
150 tory ($HOME/.gimp-2.6/scripts)
151 --install-admin-script script.scm
153 Install script.scm into the system-wide GIMP script directory
154 (/usr/share/gimp/2.0/scripts)
155 --uninstall-bin plug-in
157 Uninstall plug-in from the user's personal GIMP plug-in direc‐
158 tory ($HOME/.gimp-2.6/plug-ins)
159 --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 --uninstall-script script.scm
165 Uninstall script.scm from the user's personal GIMP script
166 directory ($HOME/.gimp-2.6/scripts)
167 --uninstall-admin-script script.scm
169 Uninstall script.scm from the system-wide GIMP script directory
170 (/usr/share/gimp/2.0/scripts)
171 --libs Print the linker flags that are necessary to link a GIMP plug-
173 in.
174 --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 --cflags
180 Print the compiler flags that are necessary to compile a GIMP
181 plug-in.
182 --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 --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 --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
203 CC to get the name of the desired C compiler.
204 CFLAGS to get the preferred flags to pass to the C compiler for plug-
206 in building.
207 DESTDIR to add a prefix to the install/uninstall path.
209 LDFLAGS to get the preferred flags for passing to the linker.
211 LIBS for passing extra libs that may be needed in the build process.
213 For example, LIBS=-lintl .
214 PKG_CONFIG
216 to get the location of the pkg-config program that is used to
217 determine details about your glib, pango, gtk+ and gimp instal‐
218 lation.
219
223 gimp(1), gimprc(5), pkg-config(1)
224
228 gimptool was written by Manish Singh (yosh@gimp.org) and is based on
229 gtk-config by Owen Taylor (owen@gtk.org).
230 This man page was written by Ben Gertzfield (che@debian.org), and
232 tweaked by Manish Singh (yosh@gimp.org), Adrian Likins
233 (adrian@gimp.org) and Marc Lehmann (pcg@goof.com>).
234GIMP Manual Pages Version 2.6.9 GIMPTOOL-2.0(1)