GIMPTOOL\-2.0
Section: User Commands (1)
Updated: Version 2.10.24
Page Index
NAME
gimptool-2.0 - script to perform various GIMPy functions
SYNOPSIS
gimptool-2.0
[--prefix
[=DIR]] [--exec-prefix
[=DIR]] [--version]
[--help] [--quiet] [--silent] [-n] [--just-print] [--dry-run]
[--recon] [--msvc-syntax]
[--bindir] [--sbindir] [--libexecdir] [--datadir]
[--sysconfdir] [--sharedstatedir] [--localstatedir] [--libdir]
[--infodir] [--mandir] [--includedir] [--gimpplugindir]
[--gimpdatadir] [--libs] [--libs-noui] [--cflags] [--cflags-noi]
[--build
plug-in.c]
[--build-strip
plug-in.c] [--install
plug-in.c]
[--install-strip
plug-in.c] [--install-admin
plug-in.c]
[--install-bin
plug-in]
[--install-admin-strip
plug-in.c]
[--install-bin-strip
plug-in]
[--install-admin-bin
plug-in]
[--install-script
script.scm]
[--install-admin-script
script.scm]
[--uninstall-bin
plug-in] [--uninstall-admin-bin
plug-in]
[--uninstall-script
script.scm]
[--uninstall-admin-script
script.scm]
DESCRIPTION
gimptool-2.0 is a tool that can, among other things, build
plug-ins or scripts and install them if they are distributed in one
source file.
gimptool-2.0 can also be used by programs that need to know what
libraries and include-paths GIMP was compiled with. gimptool-2.0
uses pkg-config for this task. For use in Makefiles, it is recommended
that you use pkg-config directly instead of calling gimptool-2.0.
OPTIONS
gimptool-2.0 accepts the following options:
- --version
-
Print the currently installed version of GIMP on the standard output.
- --help
-
Print out the help blurb, showing commonly used commandline options.
- --quiet
-
Run quietly without echoing any of the build commands.
- --silent
-
Run silently without echoing any of the build commands. Same as --quiet.
- -n
-
Test mode. Print the commands but don't actually execute them. Useful for
making dry runs for testing.
- --just-print
-
Test mode. Print the commands but don't actually execute them. Same as -n.
- --dry-run
-
Test mode. Print the commands but don't actually execute them. Same as -n.
- --recon
-
Test mode. Print the commands but don't actually execute them. Same as -n.
- --msvc-syntax
-
Useful on Windows. Outputs the compiler and linker flags in the syntax
used by Microsoft's toolchain. Passed to the pkg-config command that
does most of gimptool-2.0's work.
- --bindir
-
Outputs the bindir used to install the GIMP.
- --sbindir
-
Outputs the sbindir used to install the GIMP.
- --libexecdir
-
Outputs the libexecdir used to install the GIMP.
- --datadir
-
Outputs the datadir used to install the GIMP.
- --sysconfdir
-
Outputs the sysconfdir used to install the GIMP.
- --sharedstatedir
-
Outputs the sharedstatedir used to install the GIMP.
- --localstatedir
-
Outputs the localstatedir used to install the GIMP.
- --libdir
-
Outputs the libdir used to install the GIMP.
- --infodir
-
Outputs the infodir used to install the GIMP.
- --mandir
-
Outputs the mandir used to install the GIMP.
- --includedir
-
Outputs the includedir used to install the GIMP.
- --gimpdatadir
-
Outputs the actual directory where the GIMP data files were installed.
- --gimpplugindir
-
Outputs the actual directory where the GIMP plug-ins were installed.
- --build plug-in.c
-
Compile and link plug-in.c into a GIMP plug-in.
- --build-strip plug-in.c
-
Compile,link, and strip plug-in.c into a GIMP plug-in.
- --install plug-in.c
-
Compile, link, and install plug-in.c into the user's personal
GIMP plug-in directory ($XDG_CONFIG_HOME/GIMP/2.10/plug-ins)
- --install-strip plug-in.c
-
Compile, link,strip, and install plug-in.c into the user's
personal GIMP
plug-in directory ($XDG_CONFIG_HOME/GIMP/2.10/plug-ins)
- --install-admin plug-in.c
-
Compile, link, and install plug-in.c into the system-wide GIMP
plug-in directory (/usr/lib64/gimp/2.0/plug-ins)
- --install-bin plug-in
-
Install plug-in into the user's personal GIMP
plug-in directory ($XDG_CONFIG_HOME/GIMP/2.10/plug-ins)
- --install-admin-bin plug-in
-
Install plug-in into the system-wide GIMP
plug-in directory (/usr/lib64/gimp/2.0/plug-ins)
- --install-bin-strip plug-in
-
Install stripped plug-in into the user's personal GIMP
plug-in directory ($XDG_CONFIG_HOME/GIMP/2.10/plug-ins)
- --install-admin-bin-strip plug-in
-
Install stripped plug-in into the system-wide GIMP
plug-in directory (/usr/lib64/gimp/2.0/plug-ins)
- --install-script script.scm
-
Install script.scm into the user's personal GIMP
script directory ($XDG_CONFIG_HOME/GIMP/2.10/scripts)
- --install-admin-script script.scm
-
Install script.scm into the system-wide GIMP
script directory (/usr/share/gimp/2.0/scripts)
- --uninstall-bin plug-in
-
Uninstall plug-in from the user's personal GIMP
plug-in directory ($XDG_CONFIG_HOME/GIMP/2.10/plug-ins)
- --uninstall-admin-bin plug-in
-
Uninstall plug-in from the system-wide GIMP
plug-in directory (/usr/lib64/gimp/2.0/plug-ins)
- --uninstall-script script.scm
-
Uninstall script.scm from the user's personal GIMP
script directory ($XDG_CONFIG_HOME/GIMP/2.10/scripts)
- --uninstall-admin-script script.scm
-
Uninstall script.scm from the system-wide GIMP
script directory (/usr/share/gimp/2.0/scripts)
- --libs
-
Print the linker flags that are necessary to link a GIMP plug-in.
- --libs-noui
-
Print the linker flags that are necessary to link a GIMP plug-in, for
plug-ins that do not require the GTK+ libraries.
- --cflags
-
Print the compiler flags that are necessary to compile a GIMP plug-in.
- --clags-noui
-
Print the compiler flags that are necessary to compile a GIMP plug-in
for plug-ins that do not require the GTK+ libraries.
- --prefix=PREFIX
-
If specified, use PREFIX instead of the installation prefix that GIMP
was built with when computing the output for the --cflags and
--libs options. This option is also used for the exec prefix
if --exec-prefix was not specified. This option must be specified
before any --libs or --cflags options.
- --exec-prefix=PREFIX
-
If specified, use PREFIX instead of the installation exec prefix that
GIMP was built with when computing the output for the --cflags
and --libs options. This option must be specified before any
--libs or --cflags options.
ENVIRONMENT
- CC
-
to get the name of the desired C compiler.
- CFLAGS
-
to get the preferred flags to pass to the C compiler for plug-in building.
- LDFLAGS
-
to get the preferred flags for passing to the linker.
- LIBS
-
for passing extra libs that may be needed in the build process. For example,
LIBS=-lintl .
- PKG_CONFIG
-
to get the location of the pkg-config program that is used to determine
details about your glib, pango, gtk+ and gimp installation.
SEE ALSO
gimp(1),
gimprc(5),
pkg-config(1)
AUTHORS
gimptool was written by Manish Singh (
yosh@gimp.org) and is based on
gtk-config by Owen Taylor (
owen@gtk.org).
This man page was written by Ben Gertzfield (che@debian.org), and tweaked
by Manish Singh (yosh@gimp.org), Adrian Likins (adrian@gimp.org) and Marc
Lehmann (pcg@goof.com>).