gimptool(1)
NAME
gimptool - perform various Gimpy functions
SYNOPSIS
gimptool [--prefix[=DIR]] [--exec-prefix[=DIR]] [--ver sion] [--help] [--quiet] [--silent] [-n] [--just-print] [--dry-run] [--recon] [--bindir] [--sbindir] [--libex ecdir] [--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] [--unin stall-script script.scm] [--uninstall-admin-script script.scm]
DESCRIPTION
gimptool is a tool that can, among other things, build
plug-ins or scripts and install them if they are dis
tributed in one source file.
gimptool can also be used by programs that need to know
what libraries and include-paths Gimp was compiled with.
This is especially useful in Makefiles.
On Unix, gimptool is a script. On Windows, it is a pro
gram. They should be more or less compatible. This manual
page describes the Unix script version.
OPTIONS
gimptool 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 com
- mands.
- --silent
- Run silently without echoing any of the build com
mands. Same as --quiet. - -n Test mode. Print the commands but dont actually
- execute them. Useful for making dry runs for test
ing. - --just-print
- Test mode. Print the commands but dont actually
execute them. Same as -n. - --dry-run
- Test mode. Print the commands but dont actually
execute them. Same as -n. - --recon Test mode. Print the commands but dont actually
- execute them. Same as -n.
- --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
($HOME/.gimp-1.2/plug-ins) - --install-strip plug-in.c
- Compile, link,strip, and install plug-in.c into
the user's personal Gimp plug-in directory
($HOME/.gimp-1.2/plug-ins) - --install-admin plug-in.c
- Compile, link, and install plug-in.c into the sys
tem-wide Gimp plug-in directory
(/usr/lib/gimp/1.2/plug-ins) - --install-bin plug-in
- Install plug-in into the user's personal Gimp plug-in directory ($HOME/.gimp-1.2/plug-ins)
- --install-admin-bin plug-in
- Install plug-in into the system-wide Gimp plug-in directory (/usr/lib/gimp/1.2/plug-ins)
- --install-bin-strip plug-in
- Install stripped plug-in into the user's personal Gimp plug-in directory ($HOME/.gimp-1.2/plug-ins)
- --install-admin-bin-strip plug-in
- Install stripped plug-in into the system-wide Gimp plug-in directory (/usr/lib/gimp/1.2/plug-ins)
- --install-script script.scm
- Install script.scm into the user's personal Gimp script directory ($HOME/.gimp-1.2/scripts)
- --install-admin-script script.scm
- Install script.scm into the system-wide Gimp
script directory (${pre
fix}/share/gimp/1.2/scripts) - --uninstall-bin plug-in
- Uninstall plug-in from the user's personal Gimp plug-in directory ($HOME/.gimp-1.2/plug-ins)
- --uninstall-admin-bin plug-in
- Uninstall plug-in from the system-wide Gimp plugin directory (/usr/lib/gimp/1.2/plug-ins)
- --uninstall-script script.scm
- Uninstall script.scm from the user's personal Gimp script directory ($HOME/.gimp-1.2/scripts)
- --uninstall-admin-script script.scm
- Uninstall script.scm from the system-wide Gimp
script directory (${pre
fix}/share/gimp/1.2/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 plugins that do not require
the GTK libs. - --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 plugins that do not
require the GTK libs. - --prefix=PREFIX
- If specified, use PREFIX instead of the installa
tion prefix that Gimp was built with when comput
ing 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 installa
tion 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
- GTK_CONFIG
- to get the location of the gtk-config program.
- CC to get the name of the desired C compiler.
- CFLAGS to get the preferred flags to pass to the C com
- piler for plug-in building.
- DESTDIR to add a prefix to the install/uninstall path.
- LDFLAGS to get the prefered flags for passing to the
- linker.
- LIBS for passing extra libs that may be needed in the
- build process. For example, LIBS=-lintl .
- GTK_CONFIG
- path to the gtk-config shell script used by gimp
tool and in the build process of many gtk apps.
SEE ALSO
gimp(1), gimprc(5), gimp-remote(1), gtk-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>).