gimptool (1)
NAME
gimptool - perform various Gimpy functions
SYNOPSIS
gimptool [--prefix[=DIR]] [--exec-prefix[=DIR]] [--version] [--help]
[--quiet] [--silent] [-n] [--just-print] [--dry-run] [--recon]
[--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] [--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 distributed 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 program. 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 commands.
--silent
Run silently without echoing any of the build commands. Same as
--quiet.
-n Test mode. Print the commands but dont actually execute them.
Useful for making dry runs for testing.
--just-print
Test mode. Print the commands but dont actually execute them.
Same as -n.
--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 plugins 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 system-wide Gimp
plug-in directory (/usr/lib/gimp/1.2/plug-ins)
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 direc-
tory ($HOME/.gimp-1.2/scripts)
--install-admin-script script.scm
Install script.scm into the system-wide Gimp script directory
(/usr/share/gimp/1.2/scripts)
--uninstall-bin plug-in
Uninstall plug-in from the user's personal Gimp plug-in direc-
tory ($HOME/.gimp-1.2/plug-ins)
--uninstall-admin-bin plug-in
Uninstall plug-in from the system-wide Gimp plug-in 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
(/usr/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 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 pre-
fix that Gimp was built with when computing the output for the
--cflags and --libs options. This option must be specified
CFLAGS to get the preferred flags to pass to the C compiler 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 gimptool 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 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>).
COPYRIGHT
Copyright © 1998 Owen Taylor and Manish Singh
Permission to use, copy, modify, and distribute this software and its
documentation for any purpose and without fee is hereby granted, pro-
vided that the above copyright notice appear in all copies and that
both that copyright notice and this permission notice appear in sup-
porting documentation.
Version 1.2.3 26 June 2001 gimptool(1)