Proposed "tell" specification.

diff --git a/helpinfos b/helpinfos
index a82ec539af1f14f513d88998333710ce30cb900b..1c43fc2421ca1153a37f87b0b17ef54cd9794d67 100644 (file)
--- a/helpinfos
+++ b/helpinfos
@@ -14,6 +14,7 @@ General commands:           Registration and user settings:
  !op [<chan>]                 !channel [<chan>] <setting> [....]
  !leave [<chan>]             Additional help topics:
  !ping [<stuff ...>]          !identify !identpass !invite !blight-id
+ !tell <nick> <message ...>
 Send commands to me by /msg, or say them in channel with \! in front.
 To get me on a channel, invite me.  To become channel manager, op me.
 
@@ -23,6 +24,38 @@ help <command>   gives help on a command
 help <opt>       gives help on an option
 help <topic>     gives help on an additional topic
 
+:tell
+tell <nick> <message ...>
+ Leaves a message for someone, which will be delivered according to
+ their `set !tellme' setting, or failing that your `set !tellbounce'.
+
+:tellbounce
+!set tellbounce after <!interval>   (Default: 80h.)
+ If undelivered longer than that, I will:
+!set tellbounce discard              Just throw it away.  (Default.)
+!set tellbounce tellme <interval>    Try a bounce `tell' that long.
+!set tellbounce mailto <email-addr>  Email you.  (Secure nicks only.)
+
+:tellme
+!set tellme configures how you receive messages sent with !tell:
+ set tellme insecure              When I see you.  (Default.)
+ set tellme secure                Hide body until secure ident.
+ set tellme refuse                Do not accept messages.
+ set tellme mailto <email-addr>   By email.  (Secure nicks only.)
+and also when to consider them delivered:
+ set tellme unreliable            Tell you once, then forget.
+ set tellme pester <interval>     Remind until you say !delmsg.
+ set tellme reliable <interval>   Like pester, but identify req'd.
+ set tellme remind <every-!interval> [<within-interval>]
+    Remind until you talk on channel within <within-interval>
+    of me having told you.  (Default is remind 1h 30s.)
+
+:delmsg
+delmsg [<nick> ...]
+Forgets about messages I've told you about: either all of them, or
+only those from certain nicks.  Necessary if you !set !tellme pester
+or reliable, and also works with remind, but not with unreliable.
+
 :seen
 seen <nick>
  Tells you or the channel when I last saw that nick in
@@ -185,12 +218,13 @@ Replies with hopefully-useful information, including:
 I can tell you this automatically if you like - see `help !marktime'.
 
 :marktime
-!set marktime off    Only an explicit `!ping' command sends you info.
-set marktime once   Send ping info shortly after I first see you.
-set marktime <n>s   Also send info every <n> seconds (min 300s).
-set marktime <n>ks  Also send info every <n> kiloseconds (min 1ks).
-set marktime <n>m   Also send info every <n> minutes (min 5m).
-set marktime <n>h   Also send info every <n> hours (min 1h).
+!set marktime off        Only an explicit `!ping' command sends info.
+set marktime once       Send ping info shortly after I first see you.
+set marktime <!interval> Also send info regularly (min. interval 5m).
+
+:interval
+Intervals in commands are <amount><unit>, where the unit is one of
+s for seconds, ks for kiloseconds, m for minutes, h for hours.
 
 # Local variables:
 # fill-column: 69