10139N/A<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
10139N/A<!--ArborText, Inc., 1988-1999, v.4002-->
13634N/A<!--ARC : LSARC 2001/420 GNOME 2.x Window Manager, Metacity-->
10139N/A<!ENTITY cmd "metacity">
10139N/A<!ENTITY % commonents SYSTEM "smancommon.ent">
10139N/A%commonents;
10139N/A<!ENTITY % booktitles SYSTEM "booktitles.ent">
10139N/A%booktitles;
20295N/A<!ENTITY suncopy "Copyright (c) 2003,2011 Oracle and/or its affiliates. All Rights Reserved.">
10139N/A]>
10139N/A<refentry id="metacity-1">
10139N/A<!-- %Z%%M% %I% %E% SMI; -->
10139N/A<refmeta><refentrytitle>metacity</refentrytitle><manvolnum>1</manvolnum>
14342N/A<refmiscinfo class="date">16 Sep 2008</refmiscinfo>
10139N/A<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
10139N/A<refmiscinfo class="software">&release;</refmiscinfo>
10139N/A<refmiscinfo class="arch">generic</refmiscinfo>
10139N/A<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
10139N/A</refmeta>
17593N/A<indexterm><primary>metacity</primary></indexterm>
17593N/A<indexterm><primary>metacity-theme-viewer</primary></indexterm>
17593N/A<indexterm><primary>GNOME desktop window manager</primary></indexterm>
17593N/A<indexterm><primary>theme viewer for the <command>metacity</command>
17593N/Awindow manager themes</primary></indexterm>
17593N/A<refnamediv id="metacity-1-name">
17593N/A<refname>metacity</refname>
20295N/A<refname>metacity&mdash;theme-viewer</refname>
20295N/A<refpurpose>
10139N/AGNOME desktop window manager, theme viewer for the <command>metacity</command>
20295N/Awindow manager themes</refpurpose>
20295N/A</refnamediv>
20295N/A<refsynopsisdiv id="metacity-1-synp">
20295N/A<title>&synp-tt;</title>
10139N/A<cmdsynopsis><command>&cmd;</command>
11904N/A<arg choice="opt"><option>-display=<replaceable>display</replaceable></option></arg>
11904N/A<arg choice="opt"><option>-help</option></arg>
11904N/A<arg choice="opt"><option>-replace</option></arg>
10139N/A<arg choice="opt"><option>-sm-client-id=<replaceable>id</replaceable></option></arg>
11904N/A<arg choice="opt"><option>-sm-disable</option></arg>
11904N/A<arg choice="opt"><option>-sm-save-file=<replaceable>file</replaceable></option></arg>
10139N/A<arg choice="opt"><option>-version</option></arg>
10139N/A</cmdsynopsis>
20295N/A<cmdsynopsis>
20295N/A<command>&cmd;-theme-viewer</command>
11904N/A<arg choice="opt"><option role="nodash"><replaceable>theme-name</replaceable></option></arg>
20295N/A</cmdsynopsis>
20295N/A</refsynopsisdiv>
17593N/A
20295N/A<refsect1 id="metacity-1-desc">
20295N/A<title>&desc-tt;</title>
17593N/A<para>
17593N/A<command>&cmd;</command> is a fully integrated window manager that is designed
17593N/Ato integrate well with the GNOME desktop. To configure
17593N/A<command>&cmd;</command>, use the GNOME preferences dialogs.
17593N/A</para>
17593N/A<para>
17593N/A<command>&cmd;-theme-viewer</command> is an application for testing and
17593N/Adisplaying <command>&cmd;</command> themes.
17593N/A</para>
17593N/A<para>
17593N/ANote: The metacity window manager also provides a library called
17593N/Alibmetacity-private. This library is licensed under GPL. Please see the license
17593N/Afile at <filename>/usr/share/doc/SUNWgnome-wm/COPYING.bz2</filename> for
17593N/Aimplications when writing a program which uses this library.
17593N/A</para>
10139N/A</refsect1>
17593N/A
20295N/A<refsect1 id="metacity-1-opts">
20295N/A<title>&opts-tt;</title>
17593N/A<para>
20295N/AThe following options are supported by <command>metacity</command>:
17593N/A</para>
20295N/A<variablelist termlength="wholeline">
11904N/A<varlistentry>
11904N/A<term><option>-display=<replaceable>display</replaceable></option></term>
11904N/A<listitem><para>
11904N/ASpecify the remote X <replaceable>display</replaceable> to be used by the
11904N/Awindow manager, where <replaceable>display</replaceable> is in the following
11904N/Aformat:</para>
17593N/A<para>
17593N/A<replaceable>hostname</replaceable>:<replaceable>displaynumber</replaceable>.<replaceable>screennumber</replaceable>
17593N/A</para>
10139N/A</listitem></varlistentry>
11904N/A<varlistentry>
11904N/A<term><option>?</option>, <option>-help</option></term>
11904N/A<listitem><para>
11904N/ADisplay detailed usage message.</para>
10139N/A</listitem></varlistentry>
11904N/A<varlistentry>
11904N/A<term><option>-replace</option></term>
11904N/A<listitem><para>
10139N/AA window manager which is running is replaced by <command>&cmd;</command>.
10139N/AUsers are encouraged to change the GNOME window manager by running the
10139N/Anew WM with the <option>-replace</option> option, and subsequently
17593N/Asaving the session.
17593N/A</para></listitem></varlistentry>
11904N/A<varlistentry>
11904N/A<term><option>-sm-client-id=<replaceable>id</replaceable></option></term>
11904N/A<listitem><para>
17593N/ASpecify a session management <replaceable>id</replaceable>.
17593N/A</para></listitem></varlistentry>
11904N/A<varlistentry>
11904N/A<term><option>-sm-disable</option></term>
11904N/A<listitem><para>
17593N/ADisable the session management.
17593N/A</para></listitem></varlistentry>
11904N/A<varlistentry>
11904N/A<term><option>-sm-save-file=<replaceable>file</replaceable></option></term>
11904N/A<listitem><para>
11904N/ASpecifies the session management <replaceable>file</replaceable> to be used.
11904N/ABy default, the <filename>$HOME/.metacity/sessions</filename> file is
17593N/Aused.
17593N/A</para></listitem></varlistentry>
11904N/A<varlistentry>
11904N/A<term><option>-version</option></term>
11904N/A<listitem><para>
17593N/ADisplay the version information for <command>&cmd;</command>.
17593N/A</para></listitem></varlistentry>
10139N/A</variablelist></refsect1>
17593N/A
20295N/A<refsect1 id="metacity-1-oper">
20295N/A<title>&oper-tt;</title>
17593N/A<para>
20295N/AThe following operands are supported by <command>metacity-theme-viewer</command>:
17593N/A</para>
20295N/A<variablelist termlength="short">
11904N/A<varlistentry>
11904N/A<term><option role="nodash"><replaceable>theme-name</replaceable></option></term>
11904N/A<listitem><para>
11904N/ASpecifies the theme that <command>&cmd;-theme-viewer</command> should use. If
11904N/Ano theme is specified on the command line, then
20295N/A<command>&cmd;-theme-viewer</command> loads the "Atlanta" theme. An error
20295N/Amessage is displayed if the specified theme does not exist.
11904N/A</para>
10139N/A</listitem></varlistentry>
20295N/A</variablelist>
20295N/A</refsect1>
17593N/A
20295N/A<refsect1 id="metacity-1-exam">
20295N/A<title>&exam-tt;</title>
17593N/A<example role="example">
17593N/A<title>Starting &cmd; From the Command Line When a <command>&cmd;</command> is
17593N/AAlready Running</title>
17593N/A<para>
17593N/A<screen>example% <userinput>&cmd; <option>-replace</option></userinput></screen></para>
10139N/A</example>
17593N/A<example role="example">
20295N/A<title>Starting &cmd-theme-viewer to view the "Crux" theme</title>
17593N/A<para>
20295N/A<screen>example% <userinput>&cmd;-theme-viewer Crux</userinput>
20295N/A</screen>
20295N/A</para>
10139N/A</example>
10139N/A</refsect1>
17593N/A
10139N/A<refsect1 id="metacity-1-exit"><title>&exit-tt;</title>
17593N/A<para>
17593N/AThe following exit values are returned:
17593N/A</para>
17593N/A<variablelist termlength="xtranarrow"><varlistentry>
17593N/A<term><returnvalue>0</returnvalue></term>
17593N/A<listitem><para>
17593N/AApplication exited successfully
17593N/A</para>
10139N/A</listitem></varlistentry>
17593N/A<varlistentry>
17593N/A<term><returnvalue>>0</returnvalue></term>
17593N/A<listitem><para>
17593N/AApplication exited with failure
17593N/A</para></listitem></varlistentry>
20295N/A</variablelist>
20295N/A</refsect1>
17593N/A
20295N/A<refsect1 id="metacity-1-file">
20295N/A<title>&file-tt;</title>
17593N/A<para>
17593N/AThe following files are used by this application:
17593N/A</para>
17593N/A<variablelist termlength="wholeline">
17593N/A<varlistentry>
17593N/A<term><filename>/usr/bin/&cmd;</filename></term>
17593N/A<listitem><para>
17593N/AThe command-line executable for the metacity window manager.
17593N/A</para></listitem></varlistentry>
17593N/A<varlistentry>
17593N/A<term><filename>/usr/bin/&cmd;&mdash;theme-viewer</filename></term>
17593N/A<listitem><para>
17593N/AThe command-line executable for the metacity theme viewer application.
17593N/A</para></listitem></varlistentry>
17593N/A<varlistentry>
17593N/A<term><filename>/usr/share/doc/SUNWgnome-wm/COPYING.bz2</filename></term>
17593N/A<listitem><para>
17593N/ALocation of license file
17593N/A</para></listitem></varlistentry>
10139N/A</variablelist></refsect1>
17593N/A
20295N/A<refsect1 id="metacity-1-attr">
20295N/A<title>&attr-tt;</title>
17593N/A<para>
17593N/ASee <olink targetdocent="REFMAN5" localinfo="attributes-5">
17593N/A<citerefentry><refentrytitle>attributes</refentrytitle>
17593N/A<manvolnum>5</manvolnum></citerefentry></olink>
17593N/Afor descriptions of the following attributes:
17593N/A</para>
10139N/A<informaltable frame="all">
17593N/A<tgroup cols="2" colsep="1" rowsep="1">
17593N/A<colspec colname="COLSPEC0" colwidth="1*">
10139N/A<colspec colname="COLSPEC1" colwidth="1*">
10139N/A<thead>
17593N/A<row>
17593N/A<entry align="center" valign="middle">ATTRIBUTE TYPE</entry>
17593N/A<entry align="center" valign="middle">ATTRIBUTE VALUE</entry></row>
10139N/A</thead>
10139N/A<tbody>
17593N/A<row>
17593N/A<entry><para>Availability</para></entry>
18745N/A<entry><para>gnome/window-manager/metacity</para></entry>
10139N/A</row>
17593N/A<row>
17593N/A<entry colname="COLSPEC0"><para>Interface stability</para></entry>
17593N/A<entry colname="COLSPEC1"><para>Volatile</para></entry></row>
10139N/A</tbody>
10139N/A</tgroup>
10139N/A</informaltable>
10139N/A</refsect1>
17593N/A
20295N/A<refsect1 id="metacity-1-also">
20295N/A<title>&also-tt;</title>
10139N/A<!--Reference to another man page-->
10139N/A<!--Reference to a Help manual-->
10139N/A<!--Reference to a book.-->
20295N/A<para>
20295N/ALatest version of the <citetitle>GNOME Desktop User Guide</citetitle> for your platform.
20295N/A</para>
20295N/A
10139N/A<para>
10139N/A<citerefentry><refentrytitle>metacity-message</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
11904N/A<citerefentry><refentrytitle>metacity-window-demo</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
14342N/A<citerefentry><refentrytitle>bzip2</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
11904N/A<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>
10139N/A</para>
14342N/A<variablelist termlength="wholeline">
14342N/A<varlistentry>
14342N/A<literal>http://www.fsf.org/licensing/</literal>
14342N/A</varlistentry>
14342N/A<variablelist>
10139N/A</refsect1>
17593N/A
10139N/A<refsect1 id="metacity-1-note"><title>&note-tt;</title>
17593N/A<para>
17593N/AWritten by Laszlo Kovacs, updated by Halton Huo, Sun Microsystems Inc., 2003,
20295N/A2006, 2007, 2008. Updated by Brian Cameron, Oracle and/or its affiliates,
20295N/A2011.
17593N/A</para>
10139N/A</refsect1>
10139N/A</refentry>