GIMPTOOL-2.0(1)         GIMP Manual Pages         GIMPTOOL-2.0(1)



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]   [--bindir]  [--sbindir]
       [--libexecdir] [--datadir] [--sysconfdir]  [--sharedstate-
       dir]  [--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-2.0 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-2.0 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.


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  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-2.0/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-2.0/plug-ins)

       --install-admin plug-in.c
               Compile, link, and install plug-in.c into the sys-
               tem-wide        GIMP       plug-in       directory
               (${exec_prefix}/lib/gimp/2.0/plug-ins)

       --install-bin plug-in
               Install plug-in  into  the  user's  personal  GIMP
               plug-in directory ($HOME/.gimp-2.0/plug-ins)

       --install-admin-bin plug-in
               Install  plug-in into the system-wide GIMP plug-in
               directory (${exec_prefix}/lib/gimp/2.0/plug-ins)

       --install-bin-strip plug-in
               Install stripped plug-in into the user's  personal
               GIMP plug-in directory ($HOME/.gimp-2.0/plug-ins)

       --install-admin-bin-strip plug-in
               Install stripped plug-in into the system-wide GIMP
               plug-in           directory           (${exec_pre-
               fix}/lib/gimp/2.0/plug-ins)

       --install-script script.scm
               Install  script.scm  into the user's personal GIMP
               script directory ($HOME/.gimp-2.0/scripts)

       --install-admin-script script.scm
               Install  script.scm  into  the  system-wide   GIMP
               script              directory              (${pre-
               fix}/share/gimp/2.0/scripts)

       --uninstall-bin plug-in
               Uninstall plug-in from the  user's  personal  GIMP
               plug-in directory ($HOME/.gimp-2.0/plug-ins)

       --uninstall-admin-bin plug-in
               Uninstall  plug-in from the system-wide GIMP plug-
               in  directory   (${exec_prefix}/lib/gimp/2.0/plug-
               ins)

       --uninstall-script script.scm
               Uninstall script.scm from the user's personal GIMP
               script directory ($HOME/.gimp-2.0/scripts)

       --uninstall-admin-script script.scm
               Uninstall script.scm  from  the  system-wide  GIMP
               script              directory              (${pre-
               fix}/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 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
               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  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
       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 .

       PKG_CONFIG
               to get the location of the pkg-config program used
               to determine details about your  glib,  pango  and
               gtk+ 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>).




Version 2.0.0             March 23 2004           GIMPTOOL-2.0(1)