<page xmlns="http://projectmallard.org/1.0/"
      xmlns:e="http://projectmallard.org/experimental/"
      type="topic" style="task"
      id="audio-call">

  <info>
    <link type="guide" xref="index#audio-video"/>
    <link type="seealso" xref="audio-video"/>
    <desc>Call your contacts over the Internet.</desc>
    <revision pkgversion="2.28" version="0.1" date="2009-08-02" status="stub"/>
    <revision pkgversion="2.28" version="0.2" date="2009-08-07" status="review">
      <!--
      <e:review by="shaunm@gnome.org" date="2009-09-04" status="done"/>
      -->
    </revision>
    <revision pkgversion="2.30" version="0.3" date="2010-02-14" status="review"/>
    <revision pkgversion="2.32" version="0.4" date="2010-09-09" status="review"/>   
    <credit type="author">
      <name>Milo Casagrande</name>
      <email>milo@ubuntu.com</email>
    </credit>
    <license>
      <p>Creative Commons Share Alike 3.0</p>
    </license>
  </info>

  <title>Start an audio conversation</title>

  <p>You can call your contacts and have an audio conversation with them.
  This features only works with certain types of accounts, and it requires
  the other person to have an application that supports audio calls.</p>
  <steps>
    <item>
      <p>
        From the <gui>Contact List</gui> window, click the
        <media type="image" mime="image/png" src="figures/camera-web.png">video call</media>
        icon next to the name of the contact you wish to call and
        choose <gui style="menuitem">Audio Call</gui>.
      </p>
    </item>
    <item>
      <p>
        A new window will open. When the connection is established, you will
        see <gui>Connected</gui> at the bottom of the window, along with the
        total conversation time.</p>
    </item>
    <item>
      <p>
        To end the conversation, click on <gui style="button">Hang up</gui>.
      </p>
    </item>
  </steps>
  
  <note style="tip">
    <p>
      To turn an audio conversation into a video conversation, choose
      <guiseq><gui style="menu">Video</gui>
      <gui style="menuitem">Video On</gui></guiseq>.
    </p>
  </note>
  
  <section id="audio-meta-contact">
    <title>Start an audio conversation with a meta-contact</title>
    <steps>
      <item>
        <p>
          From the <gui>Contact List</gui> window, right-click on the meta-contact.   
        </p>
      </item>
      <item>
        <p>
          Select the contact you want to have the conversation, and from the menu
          select <gui style="menuitem">Audio Call</gui>.
        </p>
      </item>
    </steps>
    <note style="tip">
      <p>
        To recognize if a contact is a <em>meta-contact</em>, move your mouse on
        a contact in the <gui>Contact List</gui> window, and stop over it for a
        second: a small pop-up message will appear showing the number of the
        contacts that form the meta-contact.
      </p>
    </note>
  </section>

</page>
