~ubuntu-branches/ubuntu/jaunty/gimp/jaunty-security

« back to all changes in this revision

Viewing changes to docs/gimp.1.in

  • Committer: Bazaar Package Importer
  • Author(s): Daniel Holbach
  • Date: 2007-05-02 16:33:03 UTC
  • mfrom: (1.1.4 upstream)
  • Revision ID: james.westby@ubuntu.com-20070502163303-bvzhjzbpw8qglc4y
Tags: 2.3.16-1ubuntu1
* Resynchronized with Debian, remaining Ubuntu changes:
  - debian/rules: i18n magic.
* debian/control.in:
  - Maintainer: Ubuntu Core Developers <ubuntu-devel@lists.ubuntu.com>
* debian/patches/02_help-message.patch,
  debian/patches/03_gimp.desktop.in.in.patch,
  debian/patches/10_dont_show_wizard.patch: updated.
* debian/patches/04_composite-signedness.patch,
  debian/patches/05_add-letter-spacing.patch: dropped, used upstream.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.TH GIMP 1 "March 23 2004" "Version @GIMP_VERSION@" "GIMP Manual Pages"
 
1
.TH GIMP 1 "Januar 23 2007" "Version @GIMP_VERSION@" "GIMP Manual Pages"
2
2
 
3
3
.SH NAME
4
4
gimp - an image manipulation and paint program.
6
6
 
7
7
.SH SYNOPSIS
8
8
.B gimp
9
 
[\-h] [\-\-help] [-v] [\-\-version] [\-\-verbose] [\-\-no\-shm]
10
 
[\-\-no\-cpu\-accel] [\-\-display \fIdisplay\fP] [\-d] [\-\-no\-data]
11
 
[\-f] [\-\-no\-fonts] [\-i] [\-\-no\-interface] [\-s] [\-\-no\-splash]
12
 
[\-\-session \fI<name>\fP] [\-g] [\-\-gimprc \fI<gimprc>\fP]
13
 
[\-\-system\-gimprc \fI<gimprc>\fP] [\-\-dump\-gimprc\fP]
14
 
[\-\-console\-messages] [\-\-debug\-handlers]
15
 
[\-\-batch\-interpreter \fI<procedure>\fP] [\-b] [\-\-batch \fI<commands>\fP]
 
9
[\-h] [\-\-help] [\-\-help-all] [\-\-help-gtk] [-v] [\-\-version]
 
10
[\-\-license] [\-\-verbose] [\-n] [\-\-new\-instance] [\-a] [\-\-as\-new]
 
11
[\-i] [\-\-no\-interface] [\-d] [\-\-no\-data] [\-f] [\-\-no\-fonts]
 
12
[\-s] [\-\-no\-splash]  [\-\-no\-shm] [\-\-no\-cpu\-accel]
 
13
[\-\-display \fIdisplay\fP] [\-\-session \fI<name>\fP]
 
14
[\-g] [\-\-gimprc \fI<gimprc>\fP] [\-\-system\-gimprc \fI<gimprc>\fP]
 
15
[\-\-dump\-gimprc\fP] [\-\-console\-messages] [\-\-debug\-handlers]
 
16
[\-\-stack\-trace\-mode \fI<mode>\fP] [\-\-pdb\-compat\-mode \fI<mode>\fP]
 
17
[\-\-batch\-interpreter \fI<procedure>\fP] [\-b] [\-\-batch \fI<command>\fP]
16
18
[\fIfilename\fP] ...
17
19
 
18
20
 
19
21
.SH DESCRIPTION
20
22
.PP
21
 
The \fIGIMP\fP is the GNU Image Manipulation Program. It is used to
22
 
edit and manipulate images. It can load and save a variety of image
23
 
formats and can be used to convert between formats.
 
23
GIMP is the \fIGNU Image Manipulation Program\fP. It is used to edit
 
24
and manipulate images. It can load and save a variety of image formats
 
25
and can be used to convert between formats.
24
26
.PP
25
27
GIMP can also be used as a paint program. It features a set of drawing
26
28
and painting tools such as airbrush, clone, pencil, and paint
29
31
selection tools like rectangle, ellipse, fuzzy select, bezier select,
30
32
intelligent scissors, and select by color.
31
33
.PP
32
 
GIMP offers a variety of plugins that perform a variety of image
 
34
GIMP offers a variety of plug-ins that perform a variety of image
33
35
manipulations.  Examples include bumpmap, edge detect, gaussian blur,
34
 
and many others.
35
 
.PP
36
 
In addition, GIMP has several scripting extension which allow for
37
 
advanced non-interactive processing and creation of images.
 
36
and many others. In addition, GIMP has several scripting extension
 
37
which allow for advanced non-interactive processing and creation of
 
38
images.
 
39
.PP
 
40
GIMP ships with a second binary called \fIgimp-console\fP. This binary
 
41
is a console-only version and behaves as if \fIgimp\fP was called with
 
42
the \-\-no\-interface command\-line option.
 
43
.PP
 
44
On platforms with the D-Bus message bus system, GIMP will by default check
 
45
if an instance is already running in this user session. If it detects that,
 
46
it will pass all filenames given on the command-line to the already running
 
47
GIMP instance and quit. 
38
48
 
39
49
 
40
50
.SH OPTIONS
41
 
.l 
42
 
The \fIgimp\fP accepts the following options:
 
51
.l
 
52
GIMP accepts the following options:
43
53
.TP 8
44
54
.B  \-h, \-\-help
45
 
Display a list of all commandline options.
 
55
Show GIMP command\-line options.
 
56
.TP 8
 
57
.B  \-\-help\-all
 
58
Show all command\-line options.
 
59
.TP 8
 
60
.B  \-\-help-gtk
 
61
Show GTK+ command\-line options.
46
62
.TP 8
47
63
.B \-v, \-\-version
48
 
Output the version info.
 
64
Output version information and exit.
 
65
.TP 8
 
66
.B \-\-license
 
67
Output license information and exit.
49
68
.TP 8
50
69
.B \-\-verbose
51
 
Show startup messages.
52
 
.TP 8 
53
 
.B \-\-no\-shm
54
 
Do not use shared memory between GIMP and its plugins. 
55
 
Instead of using shared memory, GIMP will send the data via pipe. This
56
 
will result in slower performance than using shared memory.
57
 
.TP 8
58
 
.B \-\-no\-cpu\-accel
59
 
Do not use CPU accelerations such as MMX or SSE even if GIMP detects
60
 
that your CPU provides this functionality.
 
70
Be verbose and create information on standard output.
 
71
.TP 8
 
72
.B \-n, \-\-new\-instance
 
73
Do not attempt to reuse an already running GIMP instance. Always start a
 
74
new one.
 
75
.TP 8
 
76
.B \-a, \-\-as\-new
 
77
Open filenames passed on the command-line as new images, don't set the
 
78
filename on them.
 
79
.TP 8
 
80
.B \-i, \-\-no\-interface
 
81
Run without a user interface.
61
82
.TP 8
62
83
.B \-d, \-\-no\-data
63
84
Do not load patterns, gradients, palettes, or brushes. Often useful
67
88
Do not load any fonts. No text functionality will be available if this
68
89
option is used.
69
90
.TP 8
70
 
.B \-i, \-\-no\-interface
71
 
Run without a user interface.
72
 
.TP 8
73
91
.B \-\-display \fIdisplay\fP
74
92
Use the designated X display.
75
93
.TP 8
76
94
.B \-s, \-\-no\-splash
77
95
Do not show the splash screen.
78
96
.TP 8
 
97
.B \-\-no\-shm
 
98
Do not use shared memory between GIMP and its plug-ins.
 
99
Instead of using shared memory, GIMP will send the data via pipe. This
 
100
will result in slower performance than using shared memory.
 
101
.TP 8
 
102
.B \-\-no\-cpu\-accel
 
103
Do not use CPU accelerations such as MMX or SSE even if GIMP detects
 
104
that your CPU provides this functionality.
 
105
.TP 8
79
106
.B \-\-session \fI<name>\fP
80
107
Use a different sessionrc for this GIMP session. The given session
81
108
name is appended to the default sessionrc filename.
82
109
.TP 8
83
110
.B \-g, \-\-gimprc \fI<gimprc>\fP
84
111
Use an alternative gimprc instead of the default one. Useful in
85
 
cases where plugins paths or machine specs may be different.
 
112
cases where plug-in paths or machine specs may be different.
86
113
.TP 8
87
114
.B \-\-system\-gimprc \fI<gimprc>\fP
88
115
Use an alternate system gimprc file.
107
134
Specifies the procedure to use to process batch events. The default is
108
135
to let Script-Fu evaluate the commands.
109
136
.TP 8
110
 
.B \-b, \-\-batch \fI<commands>\fP
111
 
Execute the set of \fI<commands>\fP non-interactively. The set
112
 
of \fI<commands>\fP is typically in the form of a script that
113
 
can be executed by one of the GIMP scripting extensions. When
114
 
\fI<commands>\fP is \fB-\fP the commands are read from standard
115
 
input.
116
 
.TP 8
 
137
.B \-b, \-\-batch \fI<command>\fP
 
138
Execute \fI<command>\fP non-interactively. This option may appear
 
139
multiple times.  The \fI<command>\fP is passed to the batch
 
140
interpreter. When \fI<command>\fP is \fB-\fP the commands are read
 
141
from standard input.
117
142
 
118
143
 
119
144
.SH ENVIRONMENT
 
145
GIMP respects a number of environment variables.
120
146
.PP
121
147
.TP 8
122
148
.B DISPLAY
123
149
to get the default host and display number.
124
150
.TP 8
125
 
.B XENVIRONMENT
126
 
to get the name of a resource file that overrides the global resources
127
 
stored in the RESOURCE_MANAGER property.
 
151
.B GIMP2_DIRECTORY
 
152
to get the name of the personal GIMP directory. If unset @gimpdir@ is
 
153
used.  If this is an absolute path, it is used as is.  If it is a
 
154
relative path, it is taken to be a subdirectory of the home directory.
 
155
.TP 8
 
156
.B GIMP2_DATADIR
 
157
to get the base location for data files such as brushes and patterns.
 
158
If unset @gimpdatadir@ is used.
 
159
.TP 8
 
160
.B GIMP2_LOCALEDIR
 
161
to get the base location for translations. If unset @gimplocaledir@
 
162
is used.
 
163
.TP 8
 
164
.B GIMP2_PLUGINDIR
 
165
to get the base location for plug-ins and modules. If unset
 
166
@gimpplugindir@ is used.
 
167
.TP 8
 
168
.B GIMP2_SYSCONFDIR
 
169
to get the location of configuration files. If unset @gimpsysconfdir@
 
170
is used.
 
171
 
 
172
On Linux GIMP can be compiled with support for binary relocatibility.
 
173
This will cause data, plug-ins and configuration files to be searched
 
174
relative to the location of the gimp executable file unless overridden
 
175
by the environment variables mentioned above.
128
176
 
129
177
 
130
178
.SH FILES
135
183
 
136
184
Most GIMP configuration is read in from the user's init file,
137
185
\fB$HOME\fP/@gimpdir@/gimprc. The system wide equivalent is in
138
 
@sysconfdir@/gimprc. The system wide file is parsed 
139
 
first and the user gimprc can override the system settings. 
 
186
@sysconfdir@/gimprc. The system wide file is parsed
 
187
first and the user gimprc can override the system settings.
140
188
@sysconfdir@/gimprc_user is the default gimprc
141
189
placed in users' home directories the first time GIMP is run.
142
190
 
143
191
\fB$HOME\fP/@gimpdir@/devicerc - holds settings for input devices
144
 
together with the tool, colors, brush, pattern and gradient 
 
192
together with the tool, colors, brush, pattern and gradient
145
193
associated to that device.
146
194
 
147
 
\fB$HOME\fP/@gimpdir@/documents - lists all images that have been 
 
195
\fB$HOME\fP/@gimpdir@/documents - lists all images that have been
148
196
opened or saved using GIMP.
149
197
 
150
198
\fB$HOME\fP/@gimpdir@/gtkrc - users set of GIMP-specific GTK config
180
228
supposed to edit it manually, but of course you can do.  This file
181
229
will be entirely rewritten every time you quit the GIMP.
182
230
 
183
 
\fB$HOME\fP/@gimpdir@/plug-ins - location of user installed plugins.
 
231
\fB$HOME\fP/@gimpdir@/plug-ins - location of user installed plug-ins.
184
232
 
185
 
\fB$HOME\fP/@gimpdir@/pluginrc - plugin initialization values are
 
233
\fB$HOME\fP/@gimpdir@/pluginrc - plug-in initialization values are
186
234
stored here. This file is parsed on startup and regenerated if need
187
235
be.
188
236
 
196
244
\fB$HOME\fP/@gimpdir@/brushes - user created and installed brush
197
245
files. These files are in the .gbr, .gih or .vbr file formats.
198
246
 
199
 
\fB$HOME\fP/@gimpdir@/curves - Curve profiles and presets as saved from 
 
247
\fB$HOME\fP/@gimpdir@/curves - Curve profiles and presets as saved from
200
248
the Curves tool.
201
249
 
202
 
\fB$HOME\fP/@gimpdir@/gimpressionist - Presets and user created brushes 
 
250
\fB$HOME\fP/@gimpdir@/gimpressionist - Presets and user created brushes
203
251
and papers are stored here.
204
252
 
205
 
\fB$HOME\fP/@gimpdir@/levels - Level profiles and presets as saved from 
 
253
\fB$HOME\fP/@gimpdir@/levels - Level profiles and presets as saved from
206
254
the Levels tool.
207
255
 
208
256
@gimpdatadir@/palettes - the system wide palette files.
281
329
Here you can find links to just about many other GIMP sites,
282
330
tutorials, data sets, mailing list archives, and more.
283
331
 
284
 
There is also a GIMP User Manual available at 
285
 
http://manual.gimp.org/ that goes into much more detail 
286
 
about the interactive use of GIMP.
 
332
There is also a GIMP User Manual available at http://docs.gimp.org/
 
333
that goes into much more detail about the interactive use of GIMP.
287
334
 
288
 
The latest version of GIMP and the GTK+ libs is always available at 
 
335
The latest version of GIMP and the GTK+ libs is always available at
289
336
ftp://ftp.gimp.org/.
290
337
 
291
338
 
292
339
.SH AUTHORS
293
 
Spencer Kimball and Peter Mattis.
 
340
Spencer Kimball, Peter Mattis and the GIMP Development Team.
294
341
 
295
 
With patches, fixes, plugins, extensions, scripts,
296
 
translations, documentation, and more from lots 
297
 
and lots of people all over the world.
 
342
With patches, fixes, plug-ins, extensions, scripts, translations,
 
343
documentation and more from lots and lots of people all over the
 
344
world.
298
345
 
299
346
 
300
347
.SH "SEE ALSO"
301
 
.BR gimprc (5), 
302
 
.BR gimptool (1), 
 
348
.BR gimprc (5),
 
349
.BR gimptool (1),
303
350
.BR gimp\-remote (1)