User Commands                                         metacity(1)



NAME
     metacity,  metacity-theme-viewer  -  GNOME  desktop   window
     manager, theme viewer for the metacity window manager themes

SYNOPSIS
     metacity  [--display=display]  [--help]  [--replace]  [--sm-
     client-id=id]   [--sm-disable]   [--sm-save-file=file]   [--
     version]

     metacity-theme-viewer [theme-name]

DESCRIPTION
     metacity is  a  fully  integrated  window  manager  that  is
     designed  to integrate well with the GNOME desktop.  To con-
     figure metacity, use the GNOME preferences dialogs.

     metacity-theme-viewer is  an  application  for  testing  and
     displaying metacity themes.

     Note: The metacity window manager also  provides  a  library
     called  libmetacity-private.  This library is licensed under
     GPL.     Please     see     the     license     file      at
     /usr/share/doc/SUNWgnome-wm/COPYING.bz2   for   implications
     when writing a program which uses this library.

OPTIONS
     The following options are supported:

     --display=display       Specify the remote X display  to  be
                             used  by  the  window manager, where
                             display is in the following format:

                             hostname:displaynumber.screennumber



     -?, --help              Display detailed usage message.



     --replace               A window manager which is running is
                             replaced  by  metacity.   Users  are
                             encouraged to change the GNOME  win-
                             dow  manager  by  running the new WM
                             with the --replace option, and  sub-
                             sequently saving the session.



     --sm-client-id=id       Specify a session management id.





SunOS 5.11          Last change: 16 Sep 2008                    1






User Commands                                         metacity(1)



     --sm-disable            Disable the session management.



     --sm-save-file=file     Specifies  the  session   management
                             file  to  be  used.  By default, the
                             $HOME/.metacity/sessions   file   is
                             used.



     --version               Display the version information  for
                             metacity.



OPERANDS
     The following operands are supported:

     theme-name              Specifies the theme  that  metacity-
                             theme-viewer   should  use.   If  no
                             theme is specified  on  the  command
                             line,   then   metacity-theme-viewer
                             loads the Crux theme. An error  mes-
                             sage  is displayed if the theme does
                             not exist.



EXAMPLES
     Example 1: Starting metacity From the Command  Line  When  a
     metacity is Already Running

     example% metacity --replace

     Example 2: Starting  metacity  With  a  Non-Default  Session
     Management File

     example% metacity --sm-save-file=filename

EXIT STATUS
     The following exit values are returned:

     0        Application exited successfully



     >0       Application exited with failure







SunOS 5.11          Last change: 16 Sep 2008                    2






User Commands                                         metacity(1)



FILES
     The following files are used by this application:

     /usr/bin/metacity

         The command-line  executable  for  the  metacity  window
         manager.



     /usr/bin/metacity-theme-viewer

         The  command-line  executable  for  the  metacity  theme
         viewer application.



     /usr/share/doc/SUNWgnome-wm/COPYING.bz2

         Location of license file



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

     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWgnome-wm                
    
     Interface stability          Volatile                    
    


SEE ALSO
     Latest version of the GNOME  Desktop  User  Guide  for  your
     platform.

     metacity-message(1),   metacity-window-demo(1),    bzip2(1),
     attributes(5)

     http:/www.fsf.org/licensing/

NOTES
     Written  by  Laszlo  Kovacs,  updated  by  Halton  Huo,  Sun
     Microsystems Inc., 2003, 2006, 2007, 2008.







SunOS 5.11          Last change: 16 Sep 2008                    3