X-Git-Url: https://git.distorted.org.uk/~mdw/ircbot/blobdiff_plain/93fe4099bbb4e50ad1d0ba1f323c384803e04a6d..b52676c054b2a5b2b98cc5875263aba0a90309fa:/helpinfos diff --git a/helpinfos b/helpinfos index aa9a174..f418180 100644 --- a/helpinfos +++ b/helpinfos @@ -10,11 +10,14 @@ 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 [] [....] -Options: Additional help topics: - timeformat ks|hms !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. :help help gives an overview and lists the topics &c @@ -22,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 @@ -54,26 +93,50 @@ op (privately) I'll give you channel operator privilege, if you're a manager. See `help !manager'. +:leave +leave [] on channel +leave (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 [] [show] show settings channel [] !manager +|-|= ... set manager list channel [] !autojoin yes|no join at bot start ? -channel [] !userinvite pub|here|all|none who can \!invite ? +channel [] !userinvite pub|here|all|none who can !invite ? channel [] !mode *|+...-... set modes when alone +channel [] !topic leave | set set topic when alone? +channel [] !topic see|tell +|-|= |* ... See `help ' (eg, `help manager') for more info. +:topic +channel [] topic set set topic when alone +channel [] topic leave don't (default) + If set to `topic set ' then whenever I'm alone in the channel + I'll reset the topic; if se to `topic leave' I'll leave it alone. +channel [] topic see|tell +|-|= |* ... + 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 [] autojoin yes|no (`yes' is the default.) Controls whether I'll join the channel when I'm (re)started. :userinvite - \!invite /msg ... invite ... -channel [] userinvite pub allowed refused -channel [] userinvite here allowed only if user on chan -channel [] userinvite all allowed any user can invite -channel [] userinvite none refused refused +channel [] userinvite pub users on chan can \!invite +channel [] userinvite here users on chan can \!invite and /msg +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.) @@ -128,28 +191,61 @@ invite ... privately This can be disabled for managed channels - see `help !userinvite'. To get me to join a channel, just invite me to it. +: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) register delete delete your nick registration register insecure register your nick insecurely I only store settings for registered nicks. For `insecure' nicks - anyone who currently holds that nick can change its settings, - including securing it to their username. `secure' nicks can only - have their settings changed by the user to which they are - registered, after identifying themselves (see `help !identify'). + anyone who currently holds that nick can change its settings (see + `help !set', including securing it to their username. `secure' + nicks can only have their settings changed by the user to which they + are registered, after identifying themselves (see `help !identify'). :set set show your current settings set