aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorjluehrs2 <jluehrs2@uiuc.edu>2007-09-02 13:41:44 -0500
committerjluehrs2 <jluehrs2@uiuc.edu>2007-09-02 13:41:44 -0500
commitf251f4114f28af6a35a5dafb32a24ac9e9f7cefd (patch)
tree67d35c88cad9945aa596c799aff5dc77143cf15c
parentf7bae2b2b332ec622851deda0df9aa7999371947 (diff)
downloadluairc-f251f4114f28af6a35a5dafb32a24ac9e9f7cefd.tar.gz
luairc-f251f4114f28af6a35a5dafb32a24ac9e9f7cefd.zip
document ctcp commands
-rw-r--r--src/irc.lua33
1 files changed, 30 insertions, 3 deletions
diff --git a/src/irc.lua b/src/irc.lua
index fa16e9f..4a21a96 100644
--- a/src/irc.lua
+++ b/src/irc.lua
@@ -816,7 +816,16 @@ end
-- }}}
-- ctcp commands {{{
--- ctcp_ping() - send a CTCP ping request {{{
+-- ctcp_ping {{{
+---
+-- Send a CTCP ping request.
+-- @param cb Callback to call when the information is available. The single
+-- table parameter to this callback will contain the fields:
+-- <ul>
+-- <li><i>nick:</i> the nick which responded to the request</li>
+-- <li><i>time:</i> the roundtrip ping time, in seconds</li>
+-- </ul>
+-- @param nick User to ping
function ctcp_ping(cb, nick)
nick = nick:lower()
if not icallbacks.ctcp_ping[nick] then
@@ -828,7 +837,16 @@ function ctcp_ping(cb, nick)
end
-- }}}
--- ctcp_time() - send a localtime request {{{
+-- ctcp_time {{{
+---
+-- Send a localtime request.
+-- @param cb Callback to call when the information is available. The single
+-- table parameter to this callback will contain the fields:
+-- <ul>
+-- <li><i>nick:</i> the nick which responded to the request</li>
+-- <li><i>time:</i> the localtime reported by the remote client</li>
+-- </ul>
+-- @param nick User to request the localtime from
function ctcp_time(cb, nick)
nick = nick:lower()
if not icallbacks.ctcp_time[nick] then
@@ -840,7 +858,16 @@ function ctcp_time(cb, nick)
end
-- }}}
--- ctcp_version() - send a client version request {{{
+-- ctcp_version {{{
+---
+-- Send a client version request.
+-- @param cb Callback to call when the information is available. The single
+-- table parameter to this callback will contain the fields:
+-- <ul>
+-- <li><i>nick:</i> the nick which responded to the request</li>
+-- <li><i>version:</i> the version reported by the remote client</li>
+-- </ul>
+-- @param nick User to request the client version from
function ctcp_version(cb, nick)
nick = nick:lower()
if not icallbacks.ctcp_version[nick] then