<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!--ARC : LSARC 2001/352 GNOME Control Center-->
<!ENTITY cmd "gnome-sound-properties">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY suncopy "Copyright (c) 2003,2006,2007 Sun Microsystems, Inc. All Rights Reserved.">
]>
<?Pub UDT _bookmark _target>
<?Pub Inc>
<refentry id="gnome-sound-properties-1">
<!-- %Z%%M% %I% %E% SMI; -->
<refmeta><refentrytitle>gnome-sound-properties</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">09 Nov 2007</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&release;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
</refmeta>
<indexterm><primary>gnome-sound-properties</primary></indexterm><indexterm>
<primary>enable sound, and associate sounds with events</primary></indexterm>
<refnamediv id="gnome-sound-properties-1-name"><refname>gnome-sound-properties</refname><refpurpose>
enable sound, and associate sounds with events</refpurpose></refnamediv>
<refsynopsisdiv id="gnome-sound-properties-1-synp"><title>&synp-tt;</title>
<cmdsynopsis><command>&cmd;</command>
<arg choice="opt"><option>-apply</option></arg>
<arg choice="opt"><option>-get-legacy</option></arg>
<arg choice="opt"><option>-init-session-settings</option></arg>
<arg choice="opt"><option role="nodash"><replaceable>gnome-std-options</replaceable></option></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1 id="gnome-sound-properties-1-desc"><title>&desc-tt;</title>
<para>The GNOME sound preference tool enables you to control which sound
device is used for audio playback.  You can specify sounds to play when
particular events occur, and control system beep behavior.</para>
</refsect1>
<refsect1 id="gnome-sound-properties-1-opts"><title>&opts-tt;</title>
<para>The following options are supported:</para>
<variablelist termlength="medium">
<varlistentry><term><option>-apply</option></term><listitem><para>
Apply the settings and quit (supported for backwards compatibility only)
</para></listitem></varlistentry>
<varlistentry><term><option>-init-session-settings</option></term><listitem><para>
Just apply settings and quit (supported for backwards compatibility only)
</para></listitem></varlistentry>
<varlistentry><term><option>-get-legacy</option></term><listitem><para>
Retrieve and store legacy settings
</para></listitem></varlistentry>
<varlistentry><term><option role="nodash"><replaceable>
gnome-std-options</replaceable></option></term><listitem><para>Standard options
available for use with most GNOME applications. See <citerefentry><refentrytitle>
gnome-std-options</refentrytitle><manvolnum>5</manvolnum></citerefentry> for
more information.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1 id="gnome-sound-properties-1-exam"><title>&exam-tt;</title>
<example role="example"><title>Launching the &cmd; tool</title>
<para><screen>example% <userinput>&cmd; </userinput></screen></para>
</example>
</refsect1>
<refsect1 id="gnome-sound-properties-1-exit"><title>&exit-tt;</title>
<para>The following exit values are returned:</para>
<variablelist termlength="xtranarrow"><varlistentry><term><returnvalue>0</returnvalue></term>
<listitem><para>Application exited successfully</para>
</listitem></varlistentry>
<varlistentry><term><returnvalue>>0</returnvalue></term><listitem><para>Application
exited with failure</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1 id="gnome-sound-properties-1-file"><title>&file-tt;</title>
<para>The following files are used by this application:</para>
<variablelist termlength="wide"><varlistentry><term><filename>/usr/bin/&cmd;</filename> 
</term><listitem><para>
Executable for &cmd;
</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1 id="gnome-sound-properties-1-attr"><title>&attr-tt;</title>
<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>
<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>
for descriptions of the following attributes:</para>
<informaltable frame="all">
<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">
<colspec colname="COLSPEC1" colwidth="1*">
<thead>
<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"
valign="middle">ATTRIBUTE VALUE</entry></row>
</thead>
<tbody>
<row><entry><para>Availability</para></entry><entry><para>gnome/preferences/control-center
</para></entry></row>
<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry
colname="COLSPEC1"><para>Volatile</para></entry></row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="gnome-sound-properties-1-also"><title>&also-tt;</title>
<!--Reference to another man page-->
<!--Reference to a Help manual-->
<!--Reference to a book.-->
<para><citetitle>Preference Tools Manual</citetitle></para>
<para>Latest version of the <citetitle>GNOME Desktop User Guide</citetitle> for your platform.</para>
<para>
<citerefentry><refentrytitle>gnome-control-center</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>libesd</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>gnome-std-options</refentrytitle><manvolnum>5</manvolnum></citerefentry>
</para>
</refsect1>
<refsect1 id="gnome-sound-properties-1-note"><title>&note-tt;</title>
<para>Written by Glynn Foster, Sun Microsystems Inc., 2003, 2006, 2007.</para>
</refsect1>
</refentry>
