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.
|