netscape(1)
NAME
netscape - start Netscape Communicator for Solaris
SYNOPSIS
/usr/dt/bin/netscape [options] [arguments]
DESCRIPTION
Netscape Communicator for Solaris is comprised of a
comprehensive set of components that integrates browsing,
email, web-based word processing, chat, and group scheduling
to allow users to easily communicate, share, and access
information.
OPTIONS
Any argument that is not a switch is interpreted as either a
file or URL. The following options are supported:
-component-bar
Shows only the Component Bar.
-composer
Opens all command line URLs in Composer.
-discussions
Shows Collabra Discussions.
-display dpy
Specifies the X server to use for display.
-dont-force-window-stacking
Ignores the alwaysraised, alwayslowered, and z-lock
JavaScript window.open() attributes.
-dont-save-geometry-prefs
Does not save window geometry preferences for the ses-
sion.
-edit See -composer.
-geometry =WxH+X+Y
Positions and sizes the Netscape window.
-help Shows the command line options for Netscape.
-iconic
Minimizes Netscape after start up.
-id window-id
Identifies an X window to receive -remote commands. If
you do not specify a window, the first window found is
used.
-ignore-geometry-prefs
Ignores saved window geometry preferences for the
current session.
-install
Installs private colormap.
-irix-session-management
Enables IRIX session management. On SGI systems, IRIX
session management is enabled by default. IRIX session
management is available on other platforms and may
work with session managers other than the IRIX desk-
top. See -no-irix-session-management.
-mail Same as -messenger.
-messenger
Shows the Messenger Mailbox (Inbox).
-mono Forces a one-bit deep image display.
-ncols N
Sets the maximum number of colors to allocate for
images when not using -install.
-nethelp
Starts NetHelp, Netscape's online help system.
-news Same as -discussions.
-no-about-splash
Bypasses the startup license page.
-no-install
Uses the default colormap.
-no-irix-session-management
Disables IRIX session management. See -irix-session-
management.
-no-session-management
Disables session management. Session management is
enabled by default. See -session-management.
-noraise
Does not display the remote window on top when using
-remote commands. See -raise and -remote.
-raise
Displays the remote window on top when using -remote
commands. See -noraise and -remote.
-remote remote-command
Connects to and controls an existing process. You can
issue multiple -remote options on the same command
line. The commands are executed sequentially unless a
command fails. If there is no Netscape process
currently running, this command fails. If the command
fails, an error message will be reported to stderr and
it will exit with a nonzero status. See REMOTE ACTIONS
section below and EXAMPLES.
The following options exist for finer-grained control
of the -remote commands:
-id X_window_ID
If there is more than one Netscape Navigator
window open, this option selects the window to
control. If you do not use this option, the
first window found is controlled. See EXAMPLES.
-raise
-noraise
Controls whether the -remote command option
causes the Netscape window to raise or not raise
itself to the top. The default is -raise.
You can use -raise and -noraise options with the
addBookmark and openURL arguments. See EXAMPLES.
-session-management
Enables session management. Session management is
enabled by default. See -no-session-management.
-version
Displays the version number and build date.
-visual id-or-number
Uses the specified server visual.
-xrm resource-spec
Sets the specified X resource.
REMOTE ACTIONS
When Netscape Navigator is invoked with the -remote argu-
ment, it does not open a window, but instead connects to and
controls an already existing process. The argument to the
-remote switch is an Xt action to invoke, with optional
arguments. Remote control is implemented using X properties,
so the two processes need not be running on the same
machine, and need not share a file system. See
http://home.netscape.com/newsref/std/x-remote.html.
All of Netscape's action names are the same as its resource
names. For example, if you wanted to know the name of the
action that corresponds to the ``Add Bookmark'' menu item,
you could look in Netscape for ``Add Bookmark'' and see that
the resource that is set to that string is addBookmark. That
is the name of the Action as well. Note: To find the
Netscape file, use the full path name which is, by default,
/usr/dt/appconfig/netscape/lib/locale/C/app-
defaults/Netscape.
You can use Actions in Translation tables in the usual Xt
manner, but you can also invoke them directly via the
-remote option, like this:
netscape -remote 'addBookmark()'
That command will cause the existing Netscape Navigator pro-
cess to add its current URL to the bookmarks, just as if you
had selected that menu item.
To open a document, enter:
netscape -remote 'openURL(http://home.netscape.com)'
Invoking an action with no arguments has the same effect as
selecting the corresponding menu item. However, with some
actions you can pass the following arguments:
addBookmark( )
Adds the current document to the Bookmark list.
addBookmark(URL)
Adds the specified document to the Bookmark list. See
EXAMPLES.
addBookmark(URL, title)
Adds the specified document and title to the Bookmark
list.
mailto( )
Opens the mail dialog box with an empty To: field.
mailto(a, b. c)
Inserts the specified address(es) in the default To:
field.
openFile( )
Opens a dialog box that prompts for a file.
openFile(filename)
Opens the specified file.
openURL( )
Opens a dialog box that prompts for a URL.
openURL(URL)
Opens the specified document. See EXAMPLES.
openURL(URL, new window)
Opens a new window displaying the specified document.
saveAs( )
Opens a dialog box that prompts for a URL.
saveAs(output_file)
Writes HTML to the specified file.
saveAs(output_file, type)
Writes the type to the specified file (HTML, text, or
PostScript).
EXIT STATUS
If a command fails, an error message is reported to stderr
and the command exits with a nonzero status.
EXAMPLES
The following are all examples of using the -remote command
option. For more information and examples, see
http://home.netscape.com/newsref/std/x-remote.html
Example 1: Selecting among open Netscape windows
example% netscape -id 0x3c00124 -remote 'openURL(http://www.example.com)'
Example 2: Adding a bookmark without raising a window
To add a bookmark without raising a window, followed by
opening a URL and raising the window, enter:
example% netscape -noraise -remote 'addBookmark(http://www.example.com)' \
-raise -remote 'openURL(http://home.netscape.com)'
Example 3: Adding a specified document to the Bookmark list
example% netscape -remote 'addBookmark(http://www.example.com)'
Example 4: Opening a specified document
example% netscape -remote 'openURL(http://www.example.com)'
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | NSCPcom |
|_____________________________|_____________________________|
SEE ALSO
attributes(5)
Refer to the Netscape Communicator online help for more
information.
Man(1) output converted with
man2html