<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!--ARC : LSARC 2008/452 - Avant Window Navigator-->
<!ENTITY cmd "avant-window-navigator">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY suncopy "Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved.">
]>
<refentry id="avant-window-navigator-1">
<!-- %Z%%M% %I% %E% SMI; -->
<refmeta><refentrytitle>&cmd;</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">18 Aug 2008</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&release;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
</refmeta>
<indexterm><primary>&cmd;</primary></indexterm>
<indexterm><primary>Avant Window Navigator</primary></indexterm>
<refnamediv id="avant-window-navigator-1-name"><refname>&cmd;</refname>
<refpurpose>Dock-like navigation bar for the desktop</refpurpose></refnamediv>
<refsynopsisdiv id="avant-window-navigator-1-synp"><title>&synp-tt;</title>
<cmdsynopsis><command>&cmd;</command>
<arg choice="opt"><option role="nodash">-v</option></arg>

</cmdsynopsis></refsynopsisdiv>

<refsect1 id="avant-window-navigator-1-desc"><title>&desc-tt;</title>
<para>
Avant Window Navigator (AWN/Awn) provides an alternative GUI panel which
displays a dock-like navigation bar that positions itself at the bottom of the
screen. It can be used to keep track of open windows and behaves like a normal
window list.
</para>

<para>
AWN shows the user all of their running applications and allows users to easily
switch between them.  It also allows users to specify commonly used folders on
the system which will be shown to the user, so they can quickly navigate to
them by clicking on an icon.  The user can also install additional applets from
the upstream community if desired. Refer to
http://wiki.awn-project.org/Awn_Extras.
</para>

<para>
You can edit preferences by either launching Awn Manager from 
System->Preferences->Awn Manager, or by right-clicking on the far left or right
of the main bar, and selecting 'Preferences'.</para>

<para>
AWN can only run on X86/64 machines.  Before running AWN, you must start Compiz
first.
</para>

</refsect1>

<refsect1 id="avant-window-navigator-1-opts"><title>&opts-tt;</title>
<para>The following options are supported:</para>
<variablelist termlength="narrow">
    <varlistentry>
      <term><option>v</option></term>
      <listitem>
        <para>Prints the version number.</para>
      </listitem>
    </varlistentry>
</variablelist></refsect1>

<refsect1 id="avant-window-navigator-1-exam"><title>&exam-tt;</title>
<example role="example">
<title>Launching Avant Window Navigator</title>
<para><screen>example% <userinput>&cmd; 
or Launch Menu-> All Applications -> Accessories ->Avant Window Navigator
</userinput></screen></para>
</example>

<example role="example">
<title>Show version information for &cmd;</title>
<para><screen>example% <userinput>&cmd; -v</userinput></screen></para>
</example>
</refsect1>

<refsect1 id="avant-window-navigator-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="avant-window-navigator-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 the Avant Window Navigator</para>
     </listitem>
   </varlistentry>

</variablelist></refsect1>

<refsect1 id="avant-window-navigator-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>SUNWavant</para></entry>
<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry
colname="COLSPEC1"><para>Uncommitted</para></entry></row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 id="avant-window-navigator-1-also"><title>&also-tt;</title>
<!--Reference to another man page-->
<!--Reference to a Help manual-->
<!--Reference to a book.-->
<para>
<citerefentry><refentrytitle>awn-applet-activation</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>awn-launch-editor</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>awn-manager</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>awn-schema-to-gconf</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>libawn</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>
</para>
</refsect1>

<refsect1 id="avant-window-navigator-1-note"><title>&note-tt;</title>
<para>Written by Henry Zhang, Sun Microsystems Inc., 2008.</para>
</refsect1>
</refentry>
