214N/A<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [

198N/A<!--ArborText, Inc., 1988-1999, v.4002-->

214N/A<!ENTITY cmd "gnome-sound-properties">

198N/A<!ENTITY % commonents SYSTEM "smancommon.ent">

198N/A%commonents;

198N/A<!ENTITY % booktitles SYSTEM "booktitles.ent">

198N/A%booktitles;

198N/A<!ENTITY suncopy "Copyright (c) 2003,2006,2007 Sun Microsystems, Inc. All Rights Reserved.">

198N/A]>

198N/A<?Pub UDT _bookmark _target>

198N/A<?Pub Inc>

198N/A<refentry id="gnome-sound-properties-1">

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

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