1GIMPTOOL-2.0(1)             General Commands Manual            GIMPTOOL-2.0(1)
2
3
4

NAME

6       gimptool-2.0 - script to perform various GIMPy functions
7
8
9

SYNOPSIS

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
25
26

DESCRIPTION

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  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
36
37

OPTIONS

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 op‐
46               tions.
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 in‐
108               stalled.
109
110       --gimpplugindir
111               Outputs  the  actual directory where the GIMP plug-ins were in‐
112               stalled.
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 ($XDG_CONFIG_HOME/GIMP/2.10/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  ($XDG_CONFIG_HOME/GIMP/2.10/plug-
127               ins)
128
129       --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
133       --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
137       --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
141       --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
145       --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
149       --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
153       --install-admin-script script.scm
154               Install  script.scm  into the system-wide GIMP script directory
155               (/usr/share/gimp/2.0/scripts)
156
157       --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
161       --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
165       --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
169       --uninstall-admin-script script.scm
170               Uninstall script.scm from the system-wide GIMP script directory
171               (/usr/share/gimp/2.0/scripts)
172
173       --libs  Print the linker flags that are necessary to link a GIMP  plug-
174               in.
175
176       --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
180       --cflags
181               Print the compiler flags that are necessary to compile  a  GIMP
182               plug-in.
183
184       --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
188       --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
195       --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
201
202

ENVIRONMENT

204       CC      to get the name of the desired C compiler.
205
206       CFLAGS  to  get the preferred flags to pass to the C compiler for plug-
207               in building.
208
209       LDFLAGS to get the preferred flags for passing to the linker.
210
211       LIBS    for passing extra libs that may be needed in the build process.
212               For example, LIBS=-lintl .
213
214       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
219
220

SEE ALSO

222       gimp(1), gimprc(5), pkg-config(1)
223
224
225

AUTHORS

227       gimptool  was  written  by Manish Singh (yosh@gimp.org) and is based on
228       gtk-config by Owen Taylor (owen@gtk.org).
229
230       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>).
233
234
235
236
237GIMP Manual Pages               Version 2.10.24                GIMPTOOL-2.0(1)
Impressum