netscape(1) (man pages section 1: User Commands)

man pages section 1: User Commands

netscape(1)

NAME

netscape- start Netscape Communicator for Solaris

SYNOPSIS

/usr/dt/bin/netscape

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

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 causes the Netscape window to raise/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.

ARGUMENTS

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

Example 1 Selecting among open Netscape windows

example% netscape -id 0x3c00124 -remote 'openURL(http://www.sun.com)'

Example 2 Adding a bookmark without raising a window

To add a bookmark without raising a window, then open a URL and raise the window:

example% netscape -noraise -remote `addBookmark(http://www.sun.com)' \
   -raise -remote `openURL(http://home.netscape.com)'

For more information and examples, see http://home.netscape.com/newsref/std/x-remote.html

Example 3 Adding a specified document to the Bookmark list

example% netscape -remote `addBookmark(http://www.sun.com)'

Example 4 Opening a specified document

example% netscape -remote `openURL(http://www.sun.com)'

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	NSCPcom