aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/session.txt19
-rw-r--r--doc/stanza.txt20
2 files changed, 39 insertions, 0 deletions
diff --git a/doc/session.txt b/doc/session.txt
new file mode 100644
index 00000000..3b4a4958
--- /dev/null
+++ b/doc/session.txt
@@ -0,0 +1,19 @@
+
+Structure of a session:
+
+
+session {
+ -- properties --
+ conn -- the tcp connection
+ notopen -- true if stream has not been initiated, removed after receiving <stream:steam>
+ priority -- the resource priority, default: 0
+ type -- the connection type. Valid values include:
+ -- "c2s_unauthed" - connection has not been authenticated yet
+ -- "c2s" - from a local client to the server
+ username -- the node part of the client's jid (not defined before auth)
+ host -- the host part of the client's jid (not defined before stream initiation)
+ resource -- the resource part of the client's full jid (not defined before resource binding)
+
+ -- methods --
+ send(x) -- converts x to a string, and writes it to the connection
+} \ No newline at end of file
diff --git a/doc/stanza.txt b/doc/stanza.txt
new file mode 100644
index 00000000..7f18ddd0
--- /dev/null
+++ b/doc/stanza.txt
@@ -0,0 +1,20 @@
+
+Structure of a stanza:
+
+
+stanza {
+ --- properties ---
+ tags -- array of tags
+
+ --- static methods ---
+ iq(attrs) --
+
+ --- read-only methods ---
+ reply -- return new stanza with attributes of current stanza
+ child_with_name(string name) -- return the first child of the current tag with the matching name
+
+ --- write methods ---
+ tag(name, sttrs) -- create a new child of the current tag, and set the child as current
+ up() -- move to the parent of the current tag
+ text(string) -- append a new text node to the current tag
+}