metacity(1)							   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 configure 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 window manager
			       by running the new WM with the --replace option, and subsequently saving the session.

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

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

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

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE 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							    16 Sep 2008 						       metacity(1)