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 [--bindir] [--sbindir] [--libexecdir] [--datadir] [--sysconfdir]
14 [--sharedstatedir] [--localstatedir] [--libdir] [--infodir] [--mandir]
15 [--includedir] [--gimpplugindir] [--gimpdatadir] [--libs] [--libs-noui]
16 [--cflags] [--cflags-noi] [--build plug-in.c] [--build-strip plug-in.c]
17 [--install plug-in.c] [--install-strip plug-in.c] [--install-admin
18 plug-in.c] [--install-bin plug-in] [--install-admin-strip plug-in.c]
19 [--install-bin-strip plug-in] [--install-admin-bin plug-in]
20 [--install-script script.scm] [--install-admin-script script.scm]
21 [--uninstall-bin plug-in] [--uninstall-admin-bin plug-in] [--unin‐
22 stall-script script.scm] [--uninstall-admin-script script.scm]
23
27 gimptool-2.0 is a tool that can, among other things, build plug-ins or
28 scripts and install them if they are distributed in one source file.
29 gimptool-2.0 can also be used by programs that need to know what
31 libraries and include-paths GIMP was compiled with. gimptool-2.0 uses
32 pkg-config for this task. For use in Makefiles, it is recommended that
33 you use pkg-config directly instead of calling gimptool-2.0.
34
38 gimptool-2.0 accepts the following options:
39 --version
41 Print the currently installed version of GIMP on the standard
42 output.
43 --help Print out the help blurb, showing commonly used commandline
45 options.
46 --quiet Run quietly without echoing any of the build commands.
48 --silent
50 Run silently without echoing any of the build commands. Same as
51 --quiet.
52 -n Test mode. Print the commands but don't actually execute them.
54 Useful for making dry runs for testing.
55 --just-print
57 Test mode. Print the commands but don't actually execute them.
58 Same as -n.
59 --dry-run
61 Test mode. Print the commands but don't actually execute them.
62 Same as -n.
63 --recon Test mode. Print the commands but don't actually execute them.
65 Same as -n.
66 --bindir
68 Outputs the bindir used to install the GIMP.
69 --sbindir
71 Outputs the sbindir used to install the GIMP.
72 --libexecdir
74 Outputs the libexecdir used to install the GIMP.
75 --datadir
77 Outputs the datadir used to install the GIMP.
78 --sysconfdir
80 Outputs the sysconfdir used to install the GIMP.
81 --sharedstatedir
83 Outputs the sharedstatedir used to install the GIMP.
84 --localstatedir
86 Outputs the localstatedir used to install the GIMP.
87 --libdir
89 Outputs the libdir used to install the GIMP.
90 --infodir
92 Outputs the infodir used to install the GIMP.
93 --mandir
95 Outputs the mandir used to install the GIMP.
96 --includedir
98 Outputs the includedir used to install the GIMP.
99 --gimpdatadir
101 Outputs the actual directory where the GIMP data files were
102 installed.
103 --gimpplugindir
105 Outputs the actual directory where the GIMP plug-ins were
106 installed.
107 --build plug-in.c
109 Compile and link plug-in.c into a GIMP plug-in.
110 --build-strip plug-in.c
112 Compile,link, and strip plug-in.c into a GIMP plug-in.
113 --install plug-in.c
115 Compile, link, and install plug-in.c into the user's personal
116 GIMP plug-in directory ($HOME/.gimp-2.4/plug-ins)
117 --install-strip plug-in.c
119 Compile, link,strip, and install plug-in.c into the user's per‐
120 sonal GIMP plug-in directory ($HOME/.gimp-2.4/plug-ins)
121 --install-admin plug-in.c
123 Compile, link, and install plug-in.c into the system-wide GIMP
124 plug-in directory (/usr/lib64/gimp/2.0/plug-ins)
125 --install-bin plug-in
127 Install plug-in into the user's personal GIMP plug-in directory
128 ($HOME/.gimp-2.4/plug-ins)
129 --install-admin-bin plug-in
131 Install plug-in into the system-wide GIMP plug-in directory
132 (/usr/lib64/gimp/2.0/plug-ins)
133 --install-bin-strip plug-in
135 Install stripped plug-in into the user's personal GIMP plug-in
136 directory ($HOME/.gimp-2.4/plug-ins)
137 --install-admin-bin-strip plug-in
139 Install stripped plug-in into the system-wide GIMP plug-in
140 directory (/usr/lib64/gimp/2.0/plug-ins)
141 --install-script script.scm
143 Install script.scm into the user's personal GIMP script direc‐
144 tory ($HOME/.gimp-2.4/scripts)
145 --install-admin-script script.scm
147 Install script.scm into the system-wide GIMP script directory
148 (/usr/share/gimp/2.0/scripts)
149 --uninstall-bin plug-in
151 Uninstall plug-in from the user's personal GIMP plug-in direc‐
152 tory ($HOME/.gimp-2.4/plug-ins)
153 --uninstall-admin-bin plug-in
155 Uninstall plug-in from the system-wide GIMP plug-in directory
156 (/usr/lib64/gimp/2.0/plug-ins)
157 --uninstall-script script.scm
159 Uninstall script.scm from the user's personal GIMP script
160 directory ($HOME/.gimp-2.4/scripts)
161 --uninstall-admin-script script.scm
163 Uninstall script.scm from the system-wide GIMP script directory
164 (/usr/share/gimp/2.0/scripts)
165 --libs Print the linker flags that are necessary to link a GIMP plug-
167 in.
168 --libs-noui
170 Print the linker flags that are necessary to link a GIMP plug-
171 in, for plug-ins that do not require the GTK+ libraries.
172 --cflags
174 Print the compiler flags that are necessary to compile a GIMP
175 plug-in.
176 --clags-noui
178 Print the compiler flags that are necessary to compile a GIMP
179 plug-in for plug-ins that do not require the GTK+ libraries.
180 --prefix=PREFIX
182 If specified, use PREFIX instead of the installation prefix
183 that GIMP was built with when computing the output for the
184 --cflags and --libs options. This option is also used for the
185 exec prefix if --exec-prefix was not specified. This option
186 must be specified before any --libs or --cflags options.
187 --exec-prefix=PREFIX
189 If specified, use PREFIX instead of the installation exec pre‐
190 fix that GIMP was built with when computing the output for the
191 --cflags and --libs options. This option must be specified
192 before any --libs or --cflags options.
193
197 CC to get the name of the desired C compiler.
198 CFLAGS to get the preferred flags to pass to the C compiler for plug-
200 in building.
201 DESTDIR to add a prefix to the install/uninstall path.
203 LDFLAGS to get the preferred flags for passing to the linker.
205 LIBS for passing extra libs that may be needed in the build process.
207 For example, LIBS=-lintl .
208 PKG_CONFIG
210 to get the location of the pkg-config program that is used to
211 determine details about your glib, pango, gtk+ and gimp instal‐
212 lation.
213
217 gimp(1), gimprc(5), pkg-config(1)
218
222 gimptool was written by Manish Singh (yosh@gimp.org) and is based on
223 gtk-config by Owen Taylor (owen@gtk.org).
224 This man page was written by Ben Gertzfield (che@debian.org), and
226 tweaked by Manish Singh (yosh@gimp.org), Adrian Likins
227 (adrian@gimp.org) and Marc Lehmann (pcg@goof.com>).
228GIMP Manual Pages Version 2.4.5 GIMPTOOL-2.0(1)