chiark / gitweb /
Startup for chiark.
[ircbot] / helpinfos
index aa9a1744df9f5ee8cfb5d2a8898f7b1ffa767f61..e801bd3e53a115f14a4d402437d31f8612757748 100644 (file)
--- a/helpinfos
+++ b/helpinfos
@@ -12,8 +12,9 @@ General commands:           Registration and user settings:
  !summon <username>           (See `help !identify', `help !blight-id')
  !invite [<chan>] <nick>...  Channel settings (see `help channel'):
  !op [<chan>]                 !channel [<chan>] <setting> [....]
+ !leave [<chan>]
 Options:                    Additional help topics:
- timeformat ks|hms           !identify !identpass !invite !blight-id
!timeformat ks|hms           !identify !identpass !invite !blight-id
 Send commands to me by /msg, or say them in channel with \! in front.
 
 :help
@@ -54,24 +55,47 @@ op <channel>       (privately)
  I'll give you channel operator privilege, if you're a manager.
  See `help !manager'.
 
+:leave
+leave [<channel>]     on channel
+leave <channel>       (privately)
+ I'll leave the channel, if you're a manager.  For an unmanaged
+ channel, I'll leave when I'm the last one on the channel.
+
 :channel
 channel [<chan>] [show]                       show settings
 channel [<chan>] !manager +|-|= <nick> ...     set manager list
 channel [<chan>] !autojoin yes|no              join at bot start ?
 channel [<chan>] !userinvite pub|here|all|none who can \!invite ?
 channel [<chan>] !mode *|+...-...              set modes when alone
+channel [<chan>] !topic leave | set <topic>    set topic when alone?
+channel [<chan>] !topic see|tell +|-|= <chan>|* ...
  See `help <setting>' (eg, `help manager') for more info.
 
+:topic
+channel [<chan>] topic set <topic>    set topic when alone
+channel [<chan>] topic leave          don't (default)
+ If set to `topic set <topic>' then whenever I'm alone in the channel
+ I'll reset the topic; if se to `topic leave' I'll leave it alone.
+channel [<chan>] topic see|tell +|-|= <chan>|* ...
+ I can inform one channel about topic changes in another.  Each
+ channel has a `see list' and a `tell list' which may be empty or
+ contain some channel names and/or a `*'.  I'll tell channel #spy
+ whenever I see the topic change in #showoff if: #showoff or * is
+ mentioned in #spy's see list, and #spy or * is mentioned in
+ #showoff's tell list, and at least one those mentions is not a `*'.
+ + adds items to the relevant list, - removes them, and = sets the
+ list to exactly those items specified.  Both lists are empty by
+ default, but a good permissive value is just `*' for both lists.
+
 :autojoin
 !channel [<chan>] autojoin yes|no      (`yes' is the default.)
  Controls whether I'll join the channel when I'm (re)started.
 
 :userinvite
-                                   \!invite   /msg ... invite ...
-channel [<chan>] userinvite pub    allowed   refused
-channel [<chan>] userinvite here   allowed   only if user on chan
-channel [<chan>] userinvite all    allowed   any user can invite
-channel [<chan>] userinvite none   refused   refused
+channel [<chan>] userinvite pub    users on chan can \!invite
+channel [<chan>] userinvite here   users on chan can \!invite and /msg
+channel [<chan>] userinvite all    anyone can \!invite and /msg
+channel [<chan>] userinvite none   \!invite and /msg are disabled
  Controls whether the `invite' command works for this channel, and
  who can use it (`help !invite').  `userinvite pub' is the default.
 
@@ -133,10 +157,10 @@ register            register your nick (or make it secure)
 register delete     delete your nick registration
 register insecure   register your nick insecurely
  I only store settings for registered nicks.  For `insecure' nicks
- anyone who currently holds that nick can change its settings,
- including securing it to their username.  `secure' nicks can only
- have their settings changed by the user to which they are
- registered, after identifying themselves (see `help !identify').
+ anyone who currently holds that nick can change its settings (see
+ `help !set', including securing it to their username.  `secure'
+ nicks can only have their settings changed by the user to which they
are registered, after identifying themselves (see `help !identify').
 
 :set
 set                  show your current settings