Changed protocol a bit to be more clear and universal

docs/samples/request_get.xml

@@ -1,12 +1,16 b''
 <request>
     <version>
         <protocol>1</protocol>
         <models>
             <post>1</post>
         </models>
     </version>
     <data>
-        <id>id1/1</id>
-        <id>id2/56</id>
+        <type>get</type>
+        <model>post</model>
+        <options>
+            <id>id1/1</id>
+            <id>id2/56</id>
+        </options>
     </data>
 </request>

docs/samples/request_pull.xml

@@ -1,26 +1,32 b''
 <?xml version="1.1" encoding="UTF-8" ?>
 <request>
     <version>
         <protocol>1</protocol>
         <models>
             <post>1</post>
         </models>
     </version>
     <data>
+        <!-- Request type -->
         <type>pull</type>
-        <timestamp>0</timestamp>
+        <!-- Model which we wish to pull -->
+        <model>post</model>
+        <options>
+            <timestamp_from>0</timestamp_from>
+            <timestamp_to>0</timestamp_to>
+            <tags>
+                <tag>tag1</tag>
+            </tags>
+        </options>
         <hosts>
             <allow>
                 <host>*</host>
             </allow>
             <deny></deny>
             <pools>
                 <pool>test1</pool>
                 <pool>test2</pool>
             </pools>
-            <tags>
-                <tag>tag1</tag>
-            </tags>
         </hosts>
     </data>
 </request>

docs/sync.markdown

@@ -1,32 +1,29 b''
 # INTRO #
 
 This document discribes the server sync protocol.
 
 # DRAFT PROTOCOL DESCRIPTION #
 
-Version:
-* Protocol version
-* Model version
-
-Node data:
-* Public key
-
-Object data:
-* Post
-* Post list (for sync)
-
 The node requests other node's changes list since some time (since epoch if
 this is the start). The other node sends a list of post ids or posts in the
 XML or JSON format.
 
 Protocol version is the version of the sync api. Model version is the version
 of data models. If at least one of them is different, the sync cannot be
 performed.
 
 The node signs the data with its key. The receiving node saves the key at the
 first sync and checks it every time. If the key has changed, the info won't be
 saved from the node (or the node id must be changed).
 
 Each node holds a list of networks it wants to get info from.
 
 Each post has an ID in the unique format: node-id/post-id
+
+All requests pass a request type, protocol and model versions and a list of
+optional arguments used for filtering.
+
+# REQUESTS #
+Request types:
+* pull - pull the desired model ids
+* get - get models by ids