chiark / gitweb /
Reorganise a bit. Now fails if the server goes away, or it fails to connect properly.
[ircbot] / helpinfos
index e1ef082d18ab480cc280029d1ce3932704c40683..fa74e7566d76a1963416a53c3e5de10d1fe4c0c1 100644 (file)
--- a/helpinfos
+++ b/helpinfos
@@ -1,12 +1,12 @@
 !
 General commands:           Registration and user settings:
  help [<cmd>|<opt>|<topic>]  register [insecure|delete]
- seen <nick>                 set [<opt> [<value>]]
- summon <username>           (See `help identify'.)
- convert <number> <unit>    Channel settings:
- ops                         oplist [<chan>] [+|-|= [?]<nick> ...]
+ seen <nick>                 set [<opt> [<value>]]      who [<nick>]
+ summon <username>           (See `help identify', `help blight-id')
+ convert <number> <unit>    Channel settings (see `help channel'):
+ ops                         channel [<chan>] <setting> [....]
 Options:                    Additional help topics:
- timeformat ks|hms           identify identpass invite
+ timeformat ks|hms           identify identpass invite blight-id
 Send commands to me by /msg, or say them in channel with ! in front.
 
 !help
@@ -26,26 +26,46 @@ summon <username>
  you'll be told.  Target users can change this (eg, to disable it)
  by reconfiguring the userv service `irc-summon'.  See ~ian/.userv.
 
+!who
+who [<nick>]
+ Gives information about who I think the nick is (or who I think you
+ are), including whether the nick is registered, whether it is
+ associated with a username and if so who, and whether the current
+ user of the nick has identified themselves to me.
+
 !convert
 convert <number> <unit>
  Converts the specified quantity into SI units.  Units that are
  understood are any understood by units(1) and also
    kelvin celsius fahrenheit    (convert to celsius or kelvin)
+(Not yet implemented.)
+
+!op
+op             on channel
+op <channel>   (privately)
+ I'll give you channel operator privilege, if you're a manager.
+
+!channel
+channel [<chan>] [show]                     show settings
+channel [<chan>] manager +|-|= <nick> ...   set manager list
+channel [<chan>] autojoin yes|no            join at bot start ?
+ See `help <setting>' (eg, `help manager') for more info.
 
-!ops
-ops             on channel
-ops <channel>   (privately)
- Asks me to give you channel operator privilege.  You must be using
- a secure nick and have identified yourself (see `help identify').
-
-!oplist
-oplist [<chan>]                      show chop list
-oplist [<chan>] + <nick> <nick> ...  add nicks to chop list
-oplist [<chan>] - <nick> <nick> ...  remove nicks from chop list
-oplist [<chan>] = <nick> <nick> ...  set chop list
- Configures the list of who may use the `ops' command.  You must be
- on the oplist yourself to do this.  If you op me on a channel I'll
- automatically add you to the oplist if you have identified yourself.
+!autojoin
+channel [<chan>] autojoin yes|no      (`yes' is default.)
+ Controls whether I'll join the channel when I'm (re)started.
+(Not yet implemented.)
+
+!manager
+channel [<chan>] manager + <nick> <nick> ...  add managers
+channel [<chan>] manager - <nick> <nick> ...  remove managers
+channel [<chan>] manager = <nick> <nick> ...  set new manager list
+ Managers are those who can use the `channel' command to change
+ channel settings.  Manager status is only effective for secure
+ nicks, after the manager has identified themselves.
+ If you op me on an unmanaged channel you become the only manager,
+ but you must use `channel' to change a channel setting to make this
+ permanent.  To make a channel unmanaged, make it have no managers.
 
 !identify
 You must identify yourself to change your settings and to use channel
@@ -54,11 +74,24 @@ other clients, see `help identpass'.  Once you are identified you can
 then register new nicks, change settings, etc. - so long as you
 remain on a channel that I'm on too.  (See also `help invite'.)
 
+!blight-id
+/blight-id is a command available in ircII (and possibly other
+clients) on chiark.  It sets up a password if you don't already have
+one, and then uses it to identify you to Blight.  If you want to
+change your password, delete the file ~/.userv/irc-pass-md5.
+
 !identpass
 identpass <username> <password>
- Identification, for example with /blight-id, is actually done with
- `identpass', which feeds the md5sum of the password to `userv
- <username> irc-identpass <nick>'.  That must exit 0 if all is well.
+ Identifies you to Blight.  To set up your password, or be reminded
+ of it, run the shell command `irc-blight-id' on chiark.
+ (On ircII on chiark `/blight-id' is easier, see `help blight-id'.)
+ See `help identpass-internals' for technical details.
+
+!identpass-internals
+Identification, for example with /blight-id, is actually done with
+`identpass', which feeds the md5sum of the password to `userv
+<username> irc-identpass <nick>'.  That must exit 0 if all is well.
+By default this checks the md5sum against ~/.userv/irc-pass-md5.
 
 !invite
 If you invite me to a channel I'll join it.
@@ -85,3 +118,6 @@ set timeformat ks   show times in seconds, kiloseconds, etc.
 set timeformat hms  use days, hours, minutes, seconds
 
 #
+# Local variables:
+# fill-column: 69
+# End.