← Back to branch summary

~ubuntu-branches/ubuntu/hoary/gimp/hoary

« back to all changes in this revision

Viewing changes to docs/gimp-remote.1.in

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2005-04-04 14:51:23 UTC
  • Revision ID: james.westby@ubuntu.com-20050404145123-9py049eeelfymur8
Tags: upstream-2.2.2
Import upstream version 2.2.2

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/gimp-remote.1.in
 
1
.TH GIMP-REMOTE 1 "March 23 2004" "Version @GIMP_VERSION@" "GIMP Manual Pages"
 
2
 
 
3
.SH NAME
 
4
gimp\-remote - tells a running GIMP to open a (local or remote) image file.
 
5
.SH SYNOPSIS
 
6
.B gimp-remote
 
7
[\-h] [\-\-help] [-v] [\-\-version] [\-\-display \fIdisplay\fP]
 
8
[\-e] [\-\-existing] [\-q] [\-\-query]  [\-s] [\-\-no\-splash]
 
9
\fIfilename\fP ...
 
10
 
 
11
 
 
12
.SH DESCRIPTION
 
13
.PP
 
14
\fIgimp-remote\fP is a small utility that tells a running GIMP to open
 
15
one or more (local or remote) image files.  It does so by searching
 
16
for a GIMP toolbox on the active display.  If it can find a GIMP
 
17
toolbox, a synthetic drop event is created which makes GIMP think the
 
18
files would have been dropped onto the toolbox. More than one filename
 
19
or URL can be specified on the commandline. 
 
20
 
 
21
.PP
 
22
If no GIMP window is found, \fIgimp-remote\fP will start a new GIMP
 
23
instance and ask it to load the specified images. If no filename or
 
24
URL is given, \fIgimp-remote\fP will start a new GIMP. This behaviour
 
25
can be altered using the command-line options described below.
 
26
 
 
27
 
 
28
.SH OPTIONS
 
29
.l 
 
30
\fIgimp\-remote\fP accepts the following options:
 
31
.TP 8
 
32
.B  \-h, \-\-help
 
33
Display a list of all commandline options.
 
34
.TP 8
 
35
.B \-v, \-\-version
 
36
Output the version info.
 
37
.TP 8
 
38
.B \-\-display  \fIdisplay\fP
 
39
Use the designated X display.
 
40
.TP 8
 
41
.B \-e, \-\-existing
 
42
If no running GIMP instance is found, don't start a new one but exit.
 
43
.TP 8
 
44
.B \-q, \-\-query
 
45
Check if GIMP is running and exit. A status code of 0 indicates that
 
46
a GIMP toolbox window has been found on this display.
 
47
.TP 8
 
48
.B \-s, \-\-no\-splash
 
49
When starting GIMP, do not show the splash screen.
 
50
 
 
51
 
 
52
.SH EXAMPLES
 
53
.TP
 
54
.BI gimp\-remote\ http://www.gimp.org/images/wilber_the_gimp.png
 
55
Loads the image from the GIMP website into a running GIMP or starts
 
56
a new one.
 
57
.TP
 
58
.BI gimp\-remote\ wilber.xcf\ wilma.xcf
 
59
Loads the local files wilber.xcf and wilma.xcf into a running GIMP
 
60
or starts a new one. 
 
61
 
 
62
 
 
63
.SH ENVIRONMENT
 
64
.PP
 
65
.TP 8
 
66
.B DISPLAY
 
67
to get the default host and display number.
 
68
 
 
69
 
 
70
.SH AUTHORS
 
71
Sven Neumann and Simon Budig.
 
72
 
 
73
 
 
74
.SH "SEE ALSO"
 
75
.BR gimp (1), 
 
76
.BR gimprc (5), 
 
77
.BR gimptool (1)