123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226 |
- .TH GIMPTOOL-1.3 1 "25 November 2001" "Version @GIMP_VERSION@" "GIMP Manual Pages"
- .SH NAME
- gimptool-1.3 - script to perform various GIMPy functions
- .SH SYNOPSIS
- .B gimptool-1.3
- [\-\-prefix\fI[=DIR]\fP] [\-\-exec\-prefix\fI[=DIR]\fP] [\-\-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 \fIplug\-in.c\fP]
- [\-\-build\-strip \fIplug\-in.c\fP] [\-\-install \fIplug\-in.c\fP]
- [\-\-install-strip \fIplug\-in.c\fP] [\-\-install-admin \fIplug-in.c\fP]
- [\-\-install\-bin \fIplug\-in\fP]
- [\-\-install\-admin\-strip \fIplug-in.c\fP]
- [\-\-install\-bin\-strip \fIplug\-in\fP]
- [\-\-\install\-admin\-bin \fIplug\-in\fP]
- [\-\-install\-script \fIscript.scm\fP]
- [\-\-\install\-admin\-script \fIscript.scm\fP]
- [\-\-uninstall\-bin \fIplug\-in\fP] [\-\-uninstall\-admin\-bin \fIplug\-in\fP]
- [\-\-uninstall\-script \fIscript.scm\fP]
- [\-\-uninstall\-admin\-script \fIscript.scm\fP]
- .SH DESCRIPTION
- .PP
- \fIgimptool-1.3\fP is a tool that can, among other things, build
- plug-ins or scripts and install them if they are distributed in one
- source file.
- .PP
- \fIgimptool-1.3\fP can also be used by programs that need to know what
- libraries and include-paths \fIGIMP\fP was compiled with. This is
- especially useful in Makefiles.
- .SH OPTIONS
- .l
- \fIgimptool-1.3\fP accepts the following options:
- .TP 8
- .B \-\-version
- Print the currently installed version of \fIGIMP\fP on the standard output.
- .TP 8
- .B \-\-help
- Print out the help blurb, showing commonly used commandline options.
- .TP 8
- .B \-\-quiet
- Run quietly without echoing any of the build commands.
- .TP 8
- .B \-\-silent
- Run silently without echoing any of the build commands. Same as \-\-quiet.
- .TP 8
- .B \-n
- Test mode. Print the commands but dont actually execute them. Useful for
- making dry runs for testing.
- .TP 8
- .B \-\-just-print
- Test mode. Print the commands but dont actually execute them. Same as \-n.
- .TP 8
- .B \-\-dry-run
- Test mode. Print the commands but dont actually execute them. Same as \-n.
- .TP 8
- .B \-\-recon
- Test mode. Print the commands but dont actually execute them. Same as \-n.
- .TP 8
- .B \-\-bindir
- Outputs the bindir used to install the \fIGIMP\fP.
- .TP 8
- .B \-\-sbindir
- Outputs the sbindir used to install the \fIGIMP\fP.
- .TP 8
- .B \-\-libexecdir
- Outputs the libexecdir used to install the \fIGIMP\fP.
- .TP 8
- .B \-\-datadir
- Outputs the datadir used to install the \fIGIMP\fP.
- .TP 8
- .B \-\-sysconfdir
- Outputs the sysconfdir used to install the \fIGIMP\fP.
- .TP 8
- .B \-\-sharedstatedir
- Outputs the sharedstatedir used to install the \fIGIMP\fP.
- .TP 8
- .B \-\-localstatedir
- Outputs the localstatedir used to install the \fIGIMP\fP.
- .TP 8
- .B \-\-libdir
- Outputs the libdir used to install the \fIGIMP\fP.
- .TP 8
- .B \-\-infodir
- Outputs the infodir used to install the \fIGIMP\fP.
- .TP 8
- .B \-\-mandir
- Outputs the mandir used to install the \fIGIMP\fP.
- .TP 8
- .B \-\-includedir
- Outputs the includedir used to install the \fIGIMP\fP.
- .TP 8
- .B \-\-gimpdatadir
- Outputs the actual directory where the \fIGIMP\fP data files were installed.
- .TP 8
- .B \-\-gimpplugindir
- Outputs the actual directory where the \fIGIMP\fP plugins were installed.
- .TP 8
- .B \-\-build \fIplug-in.c\fP
- Compile and link \fIplug-in.c\fP into a \fIGIMP\fP plug-in.
- .TP 8
- .B \-\-build\-strip \fIplug-in.c\fP
- Compile,link, and strip \fIplug-in.c\fP into a \fIGIMP\fP plug-in.
- .TP 8
- .B \-\-install \fIplug-in.c\fP
- Compile, link, and install \fIplug-in.c\fP into the user's personal
- \fIGIMP\fP plug-in directory (\fB$HOME\fP/@gimpdir@/plug-ins)
- .TP 8
- .B \-\-install\-strip \fIplug-in.c\fP
- Compile, link,strip, and install \fIplug-in.c\fP into the user's
- personal \fIGIMP\fP
- plug-in directory (\fB$HOME\fP/@gimpdir@/plug-ins)
- .TP 8
- .B \-\-install\-admin \fIplug-in.c\fP
- Compile, link, and install \fIplug-in.c\fP into the system-wide \fIGIMP\fP
- plug-in directory (@gimpplugindir@/plug-ins)
- .TP 8
- .B \-\-install\-bin \fIplug-in\fP
- Install \fIplug-in\fP into the user's personal \fIGIMP\fP
- plug-in directory (\fB$HOME\fP/@gimpdir@/plug-ins)
- .TP 8
- .B \-\-install\-admin\-bin \fIplug-in\fP
- Install \fIplug-in\fP into the system-wide \fIGIMP\fP
- plug-in directory (@gimpplugindir@/plug-ins)
- .TP 8
- .B \-\-install\-bin\-strip \fIplug-in\fP
- Install stripped \fIplug-in\fP into the user's personal \fIGIMP\fP
- plug-in directory (\fB$HOME\fP/@gimpdir@/plug-ins)
- .TP 8
- .B \-\-install\-admin\-bin\-strip \fIplug-in\fP
- Install stripped \fIplug-in\fP into the system-wide \fIGIMP\fP
- plug-in directory (@gimpplugindir@/plug-ins)
- .TP 8
- .B \-\-install\-script \fIscript.scm\fP
- Install \fIscript.scm\fP into the user's personal \fIGIMP\fP
- script directory (\fB$HOME\fP/@gimpdir@/scripts)
- .TP 8
- .B \-\-install\-admin\-script \fIscript.scm\fP
- Install \fIscript.scm\fP into the system-wide \fIGIMP\fP
- script directory (@gimpdatadir@/scripts)
- .TP 8
- .B \-\-uninstall\-bin \fIplug-in\fP
- Uninstall \fIplug-in\fP from the user's personal \fIGIMP\fP
- plug-in directory (\fB$HOME\fP/@gimpdir@/plug-ins)
- .TP 8
- .B \-\-uninstall\-admin\-bin \fIplug-in\fP
- Uninstall \fIplug-in\fP from the system-wide \fIGIMP\fP
- plug-in directory (@gimpplugindir@/plug-ins)
- .TP 8
- .B \-\-uninstall\-script \fIscript.scm\fP
- Uninstall \fIscript.scm\fP from the user's personal \fIGIMP\fP
- script directory (\fB$HOME\fP/@gimpdir@/scripts)
- .TP 8
- .B \-\-uninstall\-admin\-script \fIscript.scm\fP
- Uninstall \fIscript.scm\fP from the system-wide \fIGIMP\fP
- script directory (@gimpdatadir@/scripts)
- .TP 8
- .B \-\-libs
- Print the linker flags that are necessary to link a \fIGIMP\fP plug-in.
- .TP 8
- .B \-\-libs-noui
- Print the linker flags that are necessary to link a \fIGIMP\fP plug-in, for
- plugins that do not require the GTK libs.
- .TP 8
- .B \-\-cflags
- Print the compiler flags that are necessary to compile a \fIGIMP\fP plug-in.
- .TP 8
- .B \-\-clags-noui
- Print the compiler flags that are necessary to compile a \fIGIMP\fP plug-in
- for plugins that do not require the GTK libs.
- .TP 8
- .B \-\-prefix=PREFIX
- If specified, use PREFIX instead of the installation prefix that \fIGIMP\fP
- 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.
- .TP 8
- .B \-\-exec\-prefix=PREFIX
- If specified, use PREFIX instead of the installation exec prefix that
- \fIGIMP\fP was built with when computing the output for the \-\-cflags
- and \-\-libs options. This option must be specified before any
- \-\-libs or \-\-cflags options.
- .SH ENVIRONMENT
- .PP
- .TP 8
- .B CC
- to get the name of the desired C compiler.
- .TP 8
- .B CFLAGS
- to get the preferred flags to pass to the C compiler for plug-in building.
- .TP 8
- .B DESTDIR
- to add a prefix to the install/uninstall path.
- .TP 8
- .B LDFLAGS
- to get the prefered flags for passing to the linker.
- .TP 8
- .B LIBS
- for passing extra libs that may be needed in the build process. For example,
- LIBS=-lintl .
- .TP 8
- .B PKG_CONFIG
- to get the location of the pkg-config program used to determine details
- about your glib, pango and gtk+ installation.
- .SH SEE ALSO
- .BR gimp (1),
- .BR gimprc (5),
- .BR pkg-config (1)
- .SH 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>).
|