chiark / gitweb /
Say "you"
[ircbot.git] / helpinfos
index 7d05c432af68ef5d280fa0f9a26704357f418fcc..f4181809a4a26b0a08d03493a12322472c58a1fe 100644 (file)
--- a/helpinfos
+++ b/helpinfos
@@ -10,11 +10,12 @@ General commands:           Registration and user settings:
  !help [<cmd>|<opt>|<topic>]  !register [insecure|delete]
  !seen <nick>                 !set [<opt> [<value>]]      who [<nick>]
  !summon <username>           (See `help !identify', `help !blight-id')
- !invite [<chan>] <nick>...  Channel settings (see `help channel'):
- !op [<chan>]                 !channel [<chan>] <setting> [....]
- !leave [<chan>]             Additional help topics:
- !ping [<stuff ...>]          !identify !identpass !invite !blight-id
- !tell <nick> <message ...>
+ !invite [<chan>] <nick>...  For channel managers (`help !channel'):
+ !ping [<stuff ...>]          !op [<chan>]
+ !kill <nick> [<reason>]      !leave [<chan>]
+ !tell <nick> <message ...>   !channel [<chan>] <setting> [....]
+Additional help topics:
+ !tutorial (long\!)  !identify !identpass !invite !blight-id
 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.
 
@@ -32,22 +33,23 @@ tell <nick> <message ...>
  `help !untell' and `help !delmsg'.
 
 :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.
+!untell <nick> ...
+ Forgets about all message(s) you've sent with !tell 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.
+The !tellme command 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 insecure              When I see you.
  set tellme secure [<!interval>]   Hide body (reminding) until ident.
- set tellme refuse                Do not accept messages.
+ set tellme reject                Do not accept messages.
  set tellme mailto <email-addr>   By email.  (Secure nicks only.)
-and also when to consider them delivered (see `help !untell'):
+Default: `secure 600'.  For insecure nicks `secure' == `insecure'.
+To set when to consider messages delivered (see `help !untell'):
  set tellme unreliable            Tell you once, then forget.
- set tellme remind <every-interval> [<within-interval>]
+ 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.)
  set tellme pester <interval>     Remind until you say !delmsg
@@ -189,6 +191,12 @@ invite <channel> <nick> ...   privately
  This can be disabled for managed channels - see `help !userinvite'.
 To get me to join a channel, just invite me to it.
 
+:kill
+kill <nick> [<reason>]
+ Asks me to throw that client off IRC completely, using my IRC
+ Operator privilege.  You must have identified yourself as the user
+ to whom the nick is registered.  (See `help !register'.)
+
 :register
 register            register your nick (or make it secure)
 register delete     delete your nick registration
@@ -203,13 +211,15 @@ 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|<!interval>
-            !tellme ...
+ Options:  !timeformat ks|hms|beat
+           !marktime off|once|<n>[k]s|<n>m|<n>h
+           !tellme ...
  See also `help <option>', `help !register' and `help !identify'
 
 :timeformat
-!set timeformat ks   show times in seconds, kiloseconds, etc.
-set timeformat hms  use days, hours, minutes, seconds
+!set timeformat ks    show times in seconds, kiloseconds, etc.
+set timeformat hms   use days, hours, minutes, seconds
+set timeformat beat  use beats (1000 B = 1 day)
 
 :ping
 ping [<string>]
@@ -232,6 +242,10 @@ set marktime <!interval> Also send info regularly (min. interval 5m).
 Intervals in commands are <amount><unit>, where the unit is one of
 s for seconds, ks for kiloseconds, m for minutes, h for hours.
 
+:tutorial
+Sorry, there is no tutorial.  If you would like to contribute by
+writing one, please email ijackson@chiark.greenend.org.uk.
+
 # Local variables:
 # fill-column: 69
 # End: