X-Git-Url: https://git.distorted.org.uk/~mdw/ircbot/blobdiff_plain/f9de645dba148dadf1147c531249c698ee96e6b9..46dd680302a462ffc1a110893f2238e839842861:/helpinfos?ds=sidebyside

diff --git a/helpinfos b/helpinfos
index 8a2e2bd..2db412b 100644
--- a/helpinfos
+++ b/helpinfos
@@ -10,7 +10,7 @@ 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>...  For channel managers (see `help channel'):
+ !invite [<chan>] <nick>...  For channel managers (`help !channel'):
  !ping [<stuff ...>]          !op [<chan>]
  !kill <nick> [<reason>]      !leave [<chan>]
  !tell <nick> <message ...>   !channel [<chan>] <setting> [....]
@@ -68,9 +68,23 @@ seen <nick>
 
 :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 (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>]
@@ -188,8 +202,9 @@ By default this checks the md5sum against ~/.userv/irc-pass-md5.
 invite <nick> ...             on channel
 invite <channel> <nick> ...   privately
  This command gets me to invite the specified people to the channel.
+ This is useful because only IRC channel operators can use /invite.
  This can be disabled for managed channels - see `help !userinvite'.
-To get me to join a channel, just invite me to it.
+To get me to join a channel, a channel operator should /invite me.
 
 :kill
 kill <nick> [<reason>]