<page xmlns="http://projectmallard.org/1.0/"
      xmlns:e="http://projectmallard.org/experimental/"
      type="topic" style="tasks"
      id="prev-conv">

  <info>
    <link type="guide" xref="index#text-conv"/>
    <desc>Browse or search your previous conversations.</desc>
    <revision pkgversion="2.28" version="0.1" date="2009-08-17" status="stub"/>
    <revision pkgversion="2.28" version="0.2" date="2009-08-31" status="review">
      <!--
      <e:review by="shaunm@gnome.org" date="2009-08-31" status="done"/>
      -->
    </revision>
    <revision pkgversion="3.2" version="0.2" date="2011-12-19" status="review"/>
    <credit type="author">
      <name>Milo Casagrande</name>
      <email>milo@ubuntu.com</email>
    </credit>
    <credit type="author">
      <name>Shaun McCance</name>
      <email>shaunm@gnome.org</email>
    </credit>
    <license>
      <p>Creative Commons Share Alike 3.0</p>
    </license>
<!--
    <copyright>
      <year>2009</year>
      <name>GNOME Documentation Project</name>
    </copyright>
    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
-->
  </info>

  <title>View previous conversations</title>

  <p>
    <app>Empathy</app> automatically saves all your text conversations you have
    with your contacts.  You can <link xref="#search">search through all of your
    previous conversations</link> or <link xref="#browse">browse previous
    conversations</link> by contact and date.
  </p>

  <note>
    <p>
      You do not need to be connected to the Internet to view and search your previous
      conversations.
    </p>
  </note>

  <section id="search" style="task">
  <title>Search previous conversations</title>

  <p>You can perform a full-text search through all of your previous conversations.</p>

  <steps>
    <item>
      <p>From the <gui>Contact List</gui> window, choose <guiseq><gui>View</gui>
      <gui>Previous Conversations</gui></guiseq>.  Alternatively, press <key>F3</key>.</p>
    </item>
    <item>
      <p>Select an account from the drop-down list in the top.  A list of
      contacts and chat room for that account will be shown below.</p>
    </item>
    <item>
      <p>Type the text you want to search for in the <gui>Search</gui> text field.
      </p>
    </item>
    <item>
      <p>
        Any conversations that matched your search terms will be shown. By
        default, conversations are ordered by date.
      </p>
    </item>
  </steps>
  </section>

  <section id="browse" style="task">
  <title>Browse previous conversations</title>

  <p>You can browse your previous conversations with your contacts or in
  chat rooms by date.</p>

  <steps>
    <item>
      <p>From the <gui>Contact List</gui> window, choose <guiseq><gui>View</gui>
      <gui>Previous Conversations</gui></guiseq>.  Alternatively, press <key>F3</key>.</p>
    </item>
    <item>
      <p>Select an account from the drop-down list in the top left.  A list of
      contacts and chat room for that account will be shown below.</p>
    </item>
    <item>
      <p>Select a contact or chat room to view your previous conversations from.
      By default the most recent conversation will be shown.</p>
    </item>
    <item>
      <p>You can browse your conversations by date.  Days on which you had a conversation
      with the selected contact will be shown in bold text.  Click a date to select it.
      Click the arrows next to the month and year to browse earlier dates.</p>
    </item>
  </steps>

  <p>
    You can search for text in the conversations by typing into the
    search field at the top. The matching conversations will be showed.
  </p>

  <note style="tip">
    <p>You can quickly view the previous conversations with one of your contacts
    from the <gui>Contact List</gui> window.  Simply right click the contact and
    choose <gui>Previous Conversations</gui>.  The <gui>Previous
    Conversations</gui> window will open with that contact already selected.</p>
  </note>

  </section>
</page>
