File: netscape-remote.1x

package info (click to toggle)
netscape4.base 1%3A4.77-1
  • links: PTS
  • area: contrib
  • in suites: potato
  • size: 320 kB
  • ctags: 190
  • sloc: ansic: 1,452; sh: 597; makefile: 159
file content (161 lines) | stat: -rw-r--r-- 4,022 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
.TH netscape-remote 1 "May 25th, 1997"
.SH NAME
netscape-remote \- a program to remotely control mozilla
.SH SYNOPSIS
.B netscape-remote 
.RB [\| \-id
.IR window \|]
.RB [\| \-raise \|]
.RB [\| \-noraise \|]
.B \-remote 
.BI ' \|action \|'
.SH DESCRIPTION
.B netscape-remote
is used to remotely control the Netscape web browser.  If it is called,
and there is no Netscape running, it will start a new
one and pass the
.I action
command on to it.  Otherwise, it will pass the
.I action
command to an already running Netscape.  

The functionality
provided by this program is identical to running Netscape
with the
.B \-remote
argument.  However, since it is provided in a separate, small
program, it will start much more quickly than
.B netscape
itself.

Full documentation and source code is available at:

.RS
http://www.netscape.com/newsref/std/x-remote.html
.RE
.SH OPTIONS
.TP 
.BI \-remote\  \  ' \|action \|'
This option is required.  The 
.I action
argument is described below.
.TP
.BI \-id\  window
You can select a window to control with the 
.B -id 
command-line option; 
otherwise, the first Netscape Navigator window found will be used. 
The argument to this option is an X window id, as a decimal or 
hexadecimal number. (You can find window IDs with the 
.B xwininfo(1) 
or
.B xlswins(1) 
programs.) For example:

.RS 
.B netscape -id 0x3c00124 -remote 'openURL(http://home.netscape.com)'
.RE
.TP
.BR \-raise \|,\  \-noraise
You can control whether the 
.B -remote 
command will cause the Netscape window to
automatically raise itself to the top with the 
.B -raise 
and 
.B -noraise 
options. The default is to raise, but this may be disabled as follows: 

.RS
.B netscape -noraise -remote 'openURL(http://home.netscape.com)'

The 
.B -raise 
and 
.B -noraise 
options apply to all following 
.B -remote 
commands on the command line, and may be interleaved. For example, 
to add a bookmark without raising the window, and
then open a URL and raise the window, one could do 

.B netscape -noraise -remote 'addBookmark(http://foo)' -raise -remote 'openURL(http://bar)'
.RE

.SH ACTIONS
.B openURL ( ) 
.RS 
Prompts for a URL with a dialog box. 
.RE
.B openURL (URL) 
.RS
Opens the specified document without prompting. 
.RE
.B openURL (URL,new-window) 
.RS
Create a new window displaying the specified document. 
.RE
.B openFile ( ) 
.RS
Prompts for a file with a dialog box. 
.RE
.B openFile (File) 
.RS
Opens the specified file without prompting. 
.RE
.B saveAs ( ) 
.RS
Prompts for a file with a dialog box (like the menu item). 
.RE
.B saveAs (Output-File) 
.RS
Writes HTML to the specified file without prompting. 
.RE
.B saveAs (Output-File, Type) 
.RS
Writes to the specified file with the type specified - the type may be HTML, Text, or
PostScript. 
.RE
.B mailto ( ) 
.RS
pops up the mail dialog with the To: field empty. 
.RE
.B mailto (a, b, c) 
.RS
Puts the addresses "a, b, c" in the default To: field. 
.RE
.B addBookmark ( ) 
.RS
Adds the current document to the bookmark list. 
.RE
.B addBookmark (URL) 
.RS
Adds the given document to the bookmark list. 
.RE
.B addBookmark (URL, Title) 
.RS
Adds the given document to the bookmark list, with the given title. 
.RE

.SH EXAMPLES
.TP
.B netscape-remote \-remote 'openURL(http://www.jimpick.com/)'
This would open the specified website in an already existing
Netsape window, or would launch Netscape if it wasn't running.
.TP
.B netscape\-remote \-remote \n 'openURL(http://www.jimpick.com),new_window)'
This would open the specified website in a new Netscape window,
or would launch Netscape if it wasn't running.
.SH KNOWN BUGS
The 
.B netscape-remote
program is very finicky about the command line options.  You
have to use it with the
.B \-remote
option, or it will spit out not very helpful error messages.
Also, it is known to not work with some beta versions of Netscape
and any version of Netscape before version 1.1.
.SH AUTHOR
This man page was written by Jim Pick <jim@jimpick.com>, based
on information from the Netscape web site.