netscape - start Netscape Communicator for Solaris


     /usr/dt/bin/netscape [options] [arguments]


     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


     Any argument that is not a switch is interpreted as either a
     file or URL. The following options are supported:

           Shows only the Component Bar.

           Opens all command line URLs in Composer.

           Shows Collabra Discussions.

     -display dpy
           Specifies the X server to use for display.

           Ignores the alwaysraised,  alwayslowered,  and  z-lock
           JavaScript attributes.

           Does not save window geometry preferences for the ses-

     -edit See -composer.

     -geometry =WxH+X+Y
           Positions and sizes the Netscape window.

     -help Shows the command line options for Netscape.

           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

           Ignores saved  window  geometry  preferences  for  the
           current session.

           Installs  private colormap.

           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.

           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.

           Starts NetHelp, Netscape's online help system.

     -news Same as -discussions.

           Bypasses the startup license page.

           Uses the default colormap.

           Disables IRIX session management.  See  -irix-session-

           Disables session  management.  Session  management  is
           enabled by default. See -session-management.

           Does not display the remote window on top  when  using
           -remote commands. See -raise and -remote.

           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.


                 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.

           Enables  session  management.  Session  management  is
           enabled by default. See -no-session-management.

           Displays the version number and build date.

     -visual id-or-number
           Uses the specified server visual.

     -xrm resource-spec
           Sets the specified X resource.


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

     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('

     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.

           Adds the specified document to the Bookmark list.  See

     addBookmark(URL, title)
           Adds the specified document and title to the  Bookmark

     mailto( )
           Opens the mail dialog box with an empty To: field.

     mailto(a, b. c)
           Inserts the specified address(es) in the  default  To:

     openFile( )
           Opens a dialog box that prompts for a file.

           Opens the specified file.

     openURL( )
           Opens a dialog box that prompts for a 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.

           Writes HTML to the specified file.

     saveAs(output_file, type)
           Writes the type to the specified file (HTML, text,  or


     If a command fails, an error message is reported  to  stderr
     and the command exits with a nonzero status.


     The following are all examples of using the -remote  command
     option.    For    more   information   and   examples,   see

     Example 1: Selecting among open Netscape windows

     example% netscape -id 0x3c00124 -remote 'openURL('

     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(' \
        -raise -remote 'openURL('

     Example 3: Adding a specified document to the Bookmark list

     example% netscape -remote 'addBookmark('

     Example 4: Opening a specified document

     example% netscape -remote 'openURL('


     See attributes(5) for descriptions of the  following  attri-

    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    | Availability                | NSCPcom                     |



     Refer to the Netscape  Communicator  online  help  for  more

Man(1) output converted with man2html