From c390b90bdb5ae3a4a1fff041fc6b7f2f0eb2bcf2 Mon Sep 17 00:00:00 2001
From: "Stephen L. Blum" <stephen@pubnub.com>
Date: Thu, 7 Mar 2013 10:19:40 -0800
Subject: [PATCH] added presence details.

---
 README.md | 33 ++++++++++++++++++++++++++++++++-
 1 file changed, 32 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 44638fb11..0864c6318 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,3 @@
-
 [![browser support](http://ci.testling.com/devendram/javascript.png)](http://ci.testling.com/devendram/javascript)
 
 # YOU MUST HAVE A PUBNUB ACCOUNT TO USE THE API.
@@ -311,6 +310,38 @@ To use AES encryption in PubNub, simply do the following:
 ```
 
 
+## PRESENCE
+
+PubNub Network offers Channel Presence which
+allows you to ask the question "Who's There?"
+and get back an answer with list of users and the occupancy count.
+
+```html
+<div id=pubnub pub-key=demo sub-key=demo></div>
+<script src=http://cdn.pubnub.com/pubnub-3.4.2.min.js ></script>
+<script>(function(){
+    PUBNUB.subscribe({
+        channel    : "hello_world",                        // CONNECT TO THIS CHANNEL.
+        message    : function( message, env, channel ) {}, // RECEIVED A MESSAGE.
+        presence   : function( message, env, channel ) {   // PRESENCE
+            console.log( "Channel: ",            channel           );
+            console.log( "Join/Leave/Timeout: ", message.action    );
+            console.log( "Occupancy: ",          message.occupancy );
+            console.log( "User ID: ",            message.uuid      );
+            /* message is = {
+                    "action"    : "join",
+                    "timestamp" : 1347946204,
+                    "uuid"      : "6e08b25f-48c0-4e94-92d0-0778a8b6013d",
+                    "occupancy" : 1
+            } */
+        }
+        
+    })
+})();
+</script>
+```
+
+
 ## REPLAY
 
 Replay is an API that allows you to "replay" the events of a channel