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] [--in‐
15 fodir] [--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] [--in‐
19 stall-admin-strip plug-in.c] [--install-bin-strip plug-in] [--in‐
20 stall-admin-bin plug-in] [--install-script script.scm] [--install-ad‐
21 min-script script.scm] [--uninstall-bin plug-in] [--uninstall-admin-bin
22 plug-in] [--uninstall-script script.scm] [--uninstall-admin-script
23 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 li‐
32 braries 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 op‐
46 tions.
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 in‐
108 stalled.
109 --gimpplugindir
111 Outputs the actual directory where the GIMP plug-ins were in‐
112 stalled.
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 ($XDG_CONFIG_HOME/GIMP/2.10/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 ($XDG_CONFIG_HOME/GIMP/2.10/plug-
127 ins)
128 --install-admin plug-in.c
130 Compile, link, and install plug-in.c into the system-wide GIMP
131 plug-in directory (/usr/lib64/gimp/2.0/plug-ins)
132 --install-bin plug-in
134 Install plug-in into the user's personal GIMP plug-in directory
135 ($XDG_CONFIG_HOME/GIMP/2.10/plug-ins)
136 --install-admin-bin plug-in
138 Install plug-in into the system-wide GIMP plug-in directory
139 (/usr/lib64/gimp/2.0/plug-ins)
140 --install-bin-strip plug-in
142 Install stripped plug-in into the user's personal GIMP plug-in
143 directory ($XDG_CONFIG_HOME/GIMP/2.10/plug-ins)
144 --install-admin-bin-strip plug-in
146 Install stripped plug-in into the system-wide GIMP plug-in di‐
147 rectory (/usr/lib64/gimp/2.0/plug-ins)
148 --install-script script.scm
150 Install script.scm into the user's personal GIMP script direc‐
151 tory ($XDG_CONFIG_HOME/GIMP/2.10/scripts)
152 --install-admin-script script.scm
154 Install script.scm into the system-wide GIMP script directory
155 (/usr/share/gimp/2.0/scripts)
156 --uninstall-bin plug-in
158 Uninstall plug-in from the user's personal GIMP plug-in direc‐
159 tory ($XDG_CONFIG_HOME/GIMP/2.10/plug-ins)
160 --uninstall-admin-bin plug-in
162 Uninstall plug-in from the system-wide GIMP plug-in directory
163 (/usr/lib64/gimp/2.0/plug-ins)
164 --uninstall-script script.scm
166 Uninstall script.scm from the user's personal GIMP script di‐
167 rectory ($XDG_CONFIG_HOME/GIMP/2.10/scripts)
168 --uninstall-admin-script script.scm
170 Uninstall script.scm from the system-wide GIMP script directory
171 (/usr/share/gimp/2.0/scripts)
172 --libs Print the linker flags that are necessary to link a GIMP plug-
174 in.
175 --libs-noui
177 Print the linker flags that are necessary to link a GIMP plug-
178 in, for plug-ins that do not require the GTK+ libraries.
179 --cflags
181 Print the compiler flags that are necessary to compile a GIMP
182 plug-in.
183 --clags-noui
185 Print the compiler flags that are necessary to compile a GIMP
186 plug-in for plug-ins that do not require the GTK+ libraries.
187 --prefix=PREFIX
189 If specified, use PREFIX instead of the installation prefix
190 that GIMP was built with when computing the output for the
191 --cflags and --libs options. This option is also used for the
192 exec prefix if --exec-prefix was not specified. This option
193 must be specified before any --libs or --cflags options.
194 --exec-prefix=PREFIX
196 If specified, use PREFIX instead of the installation exec pre‐
197 fix that GIMP was built with when computing the output for the
198 --cflags and --libs options. This option must be specified be‐
199 fore any --libs or --cflags options.
200
204 CC to get the name of the desired C compiler.
205 CFLAGS to get the preferred flags to pass to the C compiler for plug-
207 in building.
208 LDFLAGS to get the preferred flags for passing to the linker.
210 LIBS for passing extra libs that may be needed in the build process.
212 For example, LIBS=-lintl .
213 PKG_CONFIG
215 to get the location of the pkg-config program that is used to
216 determine details about your glib, pango, gtk+ and gimp instal‐
217 lation.
218
222 gimp(1), gimprc(5), pkg-config(1)
223
227 gimptool was written by Manish Singh (yosh@gimp.org) and is based on
228 gtk-config by Owen Taylor (owen@gtk.org).
229 This man page was written by Ben Gertzfield (che@debian.org), and
231 tweaked by Manish Singh (yosh@gimp.org), Adrian Likins
232 (adrian@gimp.org) and Marc Lehmann (pcg@goof.com>).
233GIMP Manual Pages Version 2.10.24 GIMPTOOL-2.0(1)