X-Git-Url: https://git.distorted.org.uk/~mdw/ircbot/blobdiff_plain/904451e244dc5b97ade762863d3e890fae40a49d..46dd680302a462ffc1a110893f2238e839842861:/helpinfos diff --git a/helpinfos b/helpinfos index 4453857..2db412b 100644 --- a/helpinfos +++ b/helpinfos @@ -10,10 +10,12 @@ General commands: Registration and user settings: !help [||] !register [insecure|delete] !seen !set [ []] who [] !summon (See `help !identify', `help !blight-id') - !invite [] ... Channel settings (see `help channel'): - !op [] !channel [] [....] - !leave [] Additional help topics: - !identify !identpass !invite !blight-id + !invite [] ... For channel managers (`help !channel'): + !ping [] !op [] + !kill [] !leave [] + !tell !channel [] [....] +Additional help topics: + !tutorial (long\!) !identify !identpass !invite !blight-id Send commands to me by /msg, or say them in channel with \! in front. To get me on a channel, invite me. To become channel manager, op me. @@ -23,6 +25,42 @@ help gives help on a command help gives help on an option help gives help on an additional topic +:tell +tell + Leaves a message for someone, which will be delivered according to + their `!set !tellme'. I will tell you about your undelivered tells + whenever I see you arriving, or when you say `!ping'. See also + `help !untell' and `help !delmsg'. + +:untell +!untell ... + Forgets about all message(s) you've sent with !tell to particular + nick(s). Use !delmsg to delete messages sent *to* you. There is no + way to untell individual messages to the same nick. If your nick is + secure, you must !identify yourself to use untell. + +:tellme +The !tellme command repeats any messages you have outstanding. +!set tellme configures how you receive messages sent with !tell: + set tellme insecure When I see you. + set tellme secure [] Hide body (reminding) until ident. + set tellme reject Do not accept messages. + set tellme mailto By email. (Secure nicks only.) +Default: `secure 600'. For insecure nicks `secure' == `insecure'. +To set when to consider messages delivered (see `help !untell'): + set tellme unreliable Tell you once, then forget. + set tellme remind [ []] + Remind until you talk on channel within + of me having told you. (Default is remind 1h 30s.) + set tellme pester Remind until you say !delmsg + +:delmsg +delmsg [ ...] + Forgets about !tell messages I've passed on: either all of them, or + only those from certain nicks. Necessary if you !set !tellme pester + or reliable, and also works with remind, but not with unreliable. + Use !untell to delete messages you've sent, rather than received. + :seen seen Tells you or the channel when I last saw that nick in @@ -30,9 +68,23 @@ seen :summon summon - 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 irc-summon + 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 => The user `' . + ok =>..invites (, idle for ..).. + and Blight will respond as shown. need not be an actual + terminal name; must be a decimal absolute time_t). :who who [] @@ -98,6 +150,7 @@ channel [] userinvite all anyone can \!invite and /msg channel [] 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 [] mode *|+...-... (`mode *' is default.) @@ -149,8 +202,15 @@ By default this checks the md5sum against ~/.userv/irc-pass-md5. invite ... on channel invite ... 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 [] + Asks me to throw that client off IRC completely, using my IRC + Operator privilege. You must have identified yourself as the user + to whom the nick is registered. (See `help !register'.) :register register register your nick (or make it secure) @@ -166,30 +226,40 @@ register insecure register your nick insecurely set show your current settings set