- Invites a logged-on user onto IRC. If the user is not logged on
- you'll be told. Target users can change this (eg, to disable it)
- by reconfiguring the userv service `irc-summon'. See ~ian/.userv.
-
-!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)
-
-!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').
-(Not yet implemented!)
-
-!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.
-(Not yet implemented!)
-
-!identify
-You must identify yourself to change your settings and to use channel
-management commands. In ircII on chiark, just say `/blight-id'. For
-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
+ Invites a user onto IRC. By default a message (like a talk request)
+ will be written to their terminal; if they're not logged on to the
+ machine running Blight, or are `mesg n', you'll be told. A user can
+ change the way they are summoned (eg, to disable it) by reconfiguring
+ the userv service `irc-summon'. See `help !irc-summon'.
+
+:irc-summon
+userv <user> irc-summon <callingnick> <callingpath> <channel>
+ This userv invocation is invoked by Blight when `!summon' is used.
+ For examples of how to (re)configure it, see
+ ~ian/.userv/services.d/irc-summon
+ /etc/userv/services.d/irc-summon
+ The service should immediately print one of these, and exit:
+ problem <description> => The user `<user>' <description>.
+ ok <tty> <lastactivity> =>..invites <user> (<tty>, idle for ..)..
+ and Blight will respond as shown. <tty> need not be an actual
+ terminal name; <lastactivity> must be a decimal absolute time_t).
+
+: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.
+ See `help !register'.
+
+#: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 [<channel>] on channel
+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
+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.
+ Channel managers can always use the `invite' command.
+
+:mode
+!channel [<chan>] mode *|+...-... (`mode *' is default.)
+ If not set to `*' then whenever I'm alone in the channel I'll set
+ and unset the channel modes specified. Only the modes imnpst are
+ supported. Precede one or more mode letters with + to set, - to
+ unset; any letters not mentioned will be left alone.
+
+: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 if your nick is
+secure, and to use channel management commands. In ircII on chiark,
+just say `/!blight-id'. For 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 `help !invite'). See also `help !register'.
+
+:blight-id