[empathy] [help] Wrote most of the previous conversations topic, needs more work

[Milo Casagrande <miloc src gnome org>]

commit 2492382f950439be2e9b44362e091155b0589616
Author: Milo Casagrande <milo ubuntu com>
Date:   Tue Aug 18 23:21:44 2009 +0200

    [help] Wrote most of the previous conversations topic, needs more work

 help/C/prev-conv.page |  103 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 103 insertions(+), 0 deletions(-)
---
diff --git a/help/C/prev-conv.page b/help/C/prev-conv.page
index ed59892..de9e0f2 100644
--- a/help/C/prev-conv.page
+++ b/help/C/prev-conv.page
@@ -21,4 +21,107 @@
 
   <title>Previous conversations</title>
 
+  <p>
+    <app>Empathy</app> automatically saves all your text conversations with your contacts,
+    and you can perform two different kinds of search: a normal text search, or a
+    per-conversation search.
+  </p>
+  <p>
+    The normal search is a <em>full text</em> search: it will search the exact text in
+    all your previous conversations.
+  </p>
+  <p>
+    The per-conversation search permits you to limit the search to a particular
+    contact and conversation, and permits you to look at all the previous
+    conversations you had with your contacts.
+  </p>
+
+  <note>
+    <p>
+      You do not need to be connected to the Internet to search your previous
+      conversations.
+    </p>
+  </note>
+
+  <steps>
+    <item>
+      <p>
+        To start searching your previous conversations, perform one of the following:
+      </p>
+      <list>
+        <item>
+          <p>
+            Press <key>F3</key>.
+          </p>
+        </item>
+        <item>
+          <p>
+            Choose <guiseq><gui>View</gui><gui>Previous Conversations</gui></guiseq>.
+          </p>
+        </item>
+      </list>
+    </item>
+    <item>
+      <p>
+        Based on the kind of search you want to perform, see
+        <link xref="prev-conv#normal-search"/> or <link xref="prev-conv#contact-search"/>
+        for more information.
+      </p>
+    </item>
+  </steps>
+
+  <section id="normal-search">
+  <title>Normal search</title>
+  <steps>
+    <item>
+      <p>
+        Select the <gui>Search</gui> tab.
+      </p>
+    </item>
+    <item>
+      <p>
+        In the <gui>For</gui> text box, type the text you want to search, and click on
+        <gui>Find</gui>.
+      </p>
+    </item>
+    <item>
+      <p>
+        If there are results, they will be shown in the first pane, ordered by date.
+      </p>
+    </item>
+    <item>
+      <p>
+        Click on the result to see the exact text you were searching for on the
+        bottom pane. The search result will be highlighted.
+      </p>
+    </item>
+  </steps>
+  </section>
+
+  <section id="contact-search">
+  <title>Conversation search</title>
+  <steps>
+    <item>
+      <p>
+        Select the <gui>Conversations</gui> tab.
+      </p>
+    </item>
+    <item>
+      <p>
+        From the drop-down list at the top of the window, select your account.
+      </p>
+    </item>
+    <item>
+      <p>
+        From the left top pane, select the contact you want to look the previous
+        conversations of.
+      </p>
+      <p>
+        Based on your account selected, and the service of the account, in this
+        pane it will be possible to select contacts, IRC rooms or group conversations. 
+      </p>
+    </item>
+  </steps>
+  </section>
+
 </page>