From b8cc23940870cd2a78f629624fc8256a373f12d5 Mon Sep 17 00:00:00 2001
From: Ian Gulliver <ian@isinglasstheater.org>
Date: Sun, 8 Jun 2014 12:21:24 -0700
Subject: [PATCH] Document getMessages and getLastMessage

---
 reference.html | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/reference.html b/reference.html
index 18d07d6..f7f50e2 100644
--- a/reference.html
+++ b/reference.html
@@ -509,6 +509,41 @@ current profile.</p>
 back from the server. You can filter messages by comparing their sender field to the return value
 of <a href="#currentProfile">currentProfile()</a> to avoid processing your own messages.</p>
 
+
+<h4><a name="getMessages">getMessages()</a></h4>
+
+<p>Arguments:
+<ol>
+  <li><code>subject</code>: A valid <a href="#subject">subject</a> (string, number or object with
+  specific keys)</li>
+</ol></p>
+
+<p>Returns: An ordered (oldest to newest) array of <a href="#message">message</a> objects.</p>
+
+<p>The client library keeps a cache of messages received from
+<a href="#subscription">subscriptions</a>. getMessage() returns the contents of that cache.</p>
+
+<p>Note that only subjects for which <a href="#subscribe">subscribe()</a> has been called are valid
+to pass to getMessage(), and that getMessage() only returns historical messages as specified by the
+arguments to subscribe(). To fetch more historical messages, call subscribe() again with different
+arguments.</p>
+
+
+<h4><a name="getLastMessage">getLastMessage()</a></h4>
+
+<p>Arguments:
+<ol>
+  <li><code>subject</code>: A valid <a href="#subject">subject</a> (string, number or object with
+  specific keys)</li>
+</ol></p>
+
+<p>Returns: The most recent <a href="#message">message</a> object received, or null if none.</p>
+
+<p>Similar to <a href="#getMessages">getMessages()</a>, but only returns the most recent message
+received from the server (in server sequence number ordering). This is useful for applications
+using Cosmopolite as a key/value store that don't need to interact with the historical messages.
+</p>
+
       </section>
     </div>
 <script>