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]
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

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

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
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.6/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.6/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.6/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.6/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.6/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.6/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.6/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

ENVIRONMENT

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       DESTDIR to add a prefix to the install/uninstall path.
209
210       LDFLAGS to get the preferred flags for passing to the linker.
211
212       LIBS    for passing extra libs that may be needed in the build process.
213               For example, LIBS=-lintl .
214
215       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
220
221

SEE ALSO

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

AUTHORS

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