chiark / gitweb /
marktime settings moved from irccore.tcl to bot.tcl; inform message senders about...
[ircbot] / helpinfos
index 2e06f86d621c6ab6b7712e401a705dc43e74c415..cefe77e124dd2162183c2620fdac66d515769dbb 100644 (file)
--- a/helpinfos
+++ b/helpinfos
@@ -27,34 +27,37 @@ 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'.
+ their `!set !tellme'.  I will tell you about your undelivered tells
+ whenever I see you arriving, or when you say `!ping'.  See also
+ `help !untell' and `help !delmsg'.
 
-: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.)
+:untell
+!untell [<nick> ...]
+ Forgets about all message(s) you've sent with !tell, or those to
+ particular nick(s).  Use !delmsg to delete messages sent *to* you.
+ There is no way to untell individual messages to the same nick.
+ If your nick is secure, you must !identify yourself to use untell.
 
 :tellme
+!tellme  repeats any messages you have outstanding.
 !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:
+and also when to consider them delivered (see `help !untell'):
  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.
+ Forgets about !tell messages I've passed on: 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.
+ Use !untell to delete messages you've sent, rather than received.
 
 :seen
 seen <nick>
@@ -200,7 +203,8 @@ register insecure   register your nick insecurely
 set                  show your current settings
 set <option>         show the current setting of <option>
 set <option> <value> set <option> to <value>
- Options:   !timeformat ks|hms   !marktime off|once|<n>[k]s|<n>m|<n>h
+ Options:   !timeformat ks|hms   !marktime off|once|<!interval>
+            !tellme ...
  See also `help <option>', `help !register' and `help !identify'
 
 :timeformat
@@ -216,6 +220,8 @@ Replies with hopefully-useful information, including:
   actual message traffic counts, and \!-commands don't count either.
 * The specified string, if any.
 I can tell you this automatically if you like - see `help !marktime'.
+If you have undelivered messages sent with !tell by or to you, I'll
+let you know about those too (privately, if you ping on channel).
 
 :marktime
 !set marktime off        Only an explicit `!ping' command sends info.