:summon
summon <username>
- 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.
+ Invites a user onto IRC. By default a message, similar to a talk
+ request, will written to their terminal; if the user is not logged
+ on to the system 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 time_t).
:who
who [<nick>]