From 0a221742649cf39db96da69dead0292fd38c7b66 Mon Sep 17 00:00:00 2001 From: Geert Hauwaerts Date: Wed, 2 Jul 2014 22:35:17 +0200 Subject: [PATCH] Syntax documentation rewrite for B-commands Rewrote the syntax documentation for all the commands starting with B. --- docs/help/in/ban.in | 46 +++++++++++++++++++++++------------- docs/help/in/beep.in | 13 ++++++++-- docs/help/in/bind.in | 56 ++++++++++++++++---------------------------- 3 files changed, 61 insertions(+), 54 deletions(-) diff --git a/docs/help/in/ban.in b/docs/help/in/ban.in index 8d6d02bf..72474dce 100644 --- a/docs/help/in/ban.in +++ b/docs/help/in/ban.in @@ -1,27 +1,41 @@ +Syntax: + @SYNTAX:ban@ -Bans the specified nick or userhost mask. +Parameters: -If nick is given as parameter, the ban type is used to generate the ban -mask. /SET ban_type specified the default ban type. Ban type is one of -the following: + -normal: Uses the *!*user@*.domain.net format. + -user: Uses the *!*user@* format. + -host: Uses the *!*@host.domain.net format. + -domain: Uses the *!*@*.domain.net format. + -custom: Uses the custom format. - Normal - *!*user@*.domain.net - User - *!*user@* - Host - *!*@host.domain.net - Domain - *!*@*.domain.net - Custom [nick] [user] [host] [domain] + A channel and the nicknames or hostnames to ban. If no arguments are given + the bans in the active channel are displayed. -If no arguments are given the current bans in this channel are displayed. + If no ban format parameter is given, the value of the ban_type setting will + be used to generate the hostmask to ban. + +Description: + + Adds one or more bans to a channel. + +Configuring the custom format: + + You must set the custom ban_type to the format you would like to use. For + example, if you set the custom ban_type to "nick domain", it will generate + a ban based on the nick!*@*.domain.net format. Examples: - /BAN loser - Bans the nick 'loser' - /BAN -host loser - Bans the host of nick 'loser' - /BAN *!*@*.org - Bans all the users coming from any .org domain. - /SET ban_type custom nick domain - nick!*@*.domain.net - /SET ban_type custom user host - *!user@host.domain.net + /BAN mike + /BAN -host bob + /BAN *!*@*.basement.cat + /BAN -domain sarah -See also: KNOCKOUT, KICKBAN + /SET ban_type custom nick domain + /SET ban_type custom user host + +See also: KICKBAN, KNOCKOUT diff --git a/docs/help/in/beep.in b/docs/help/in/beep.in index 12df1ae7..fdb3857a 100644 --- a/docs/help/in/beep.in +++ b/docs/help/in/beep.in @@ -1,6 +1,15 @@ +Syntax: + @SYNTAX:beep@ -Outputs the bell-character, usually causing -your terminal beep. +Description: + + Outputs the bell-character, usually causing your terminal to beep. + +Examples: + + /BEEP + +See also: CLEAR diff --git a/docs/help/in/bind.in b/docs/help/in/bind.in index d48dcd69..5eff4145 100644 --- a/docs/help/in/bind.in +++ b/docs/help/in/bind.in @@ -1,48 +1,32 @@ +Syntax: + @SYNTAX:bind@ -Bind some action to specified keystroke. Remember that all characters -in keystrokes are case-sensitive! Uppercase letter usually means that -you need to keep SHIFT pressed to get the key to work. +Parameters: -Most most commonly used keystrokes are: + -list: Displays a list of all the bindable commands. + -delete: Removes the binding, - ^X - Ctrl-X - meta-x - Meta-x (Meta is quite often Alt-key in PCs, ESC-x works too) + A name of the binding and the command to perform. -Irssi has by default also defined several other keys which you can use: +Details: - return - The return/enter key - space, backspace - Space / backspace - up, down, left, right - Arrow keys - cleft, cright - Ctrl-left/right - home, end, prior, next - prior = Page Up, next = Page Down - insert, delete + Adds or removes a binding. The binding itself is case-sensitive and may + contain as many characters as you want. -The keystroke can contain as many key presses as you want, and you can -define names for different key sequences to use them more easily (the -keys above are done like that). For example, you may want to manage -windows with ^W key, so that ^W^C creates new window, ^W^K kills the -active window, etc. you may do it like: - - /BIND ^W^C /WINDOW NEW HIDE - /BIND ^W^K /WINDOW KILL - -But maybe you wish to give these binds to other people who want to use -some other key than ^W, then it would be better done as: - - /BIND ^W key window - /BIND window-^C /WINDOW NEW HIDE - /BIND window-^K /WINDOW KILL - - -To get a list of all bindable commands use /bind -list. + Uppercase characters usually indicate that you need to keep the shift-key + pressed to use the binding. Examples: -Clear screen: - /BIND meta-c /CLEAR + /BIND meta-c /CLEAR + /BIND meta-q change_window 16 + /BIND -delete meta-y + /BIND ^W^C /WINDOW NEW HIDE + /BIND ^W^K /WINDOW KILL + /BIND ^[[11~ command AWAY I'm off for today :) + /BIND ^[[12~ command AWAY + +See also: ALIAS -People with qwertz layout probably want to swap meta-y and meta-z: - /BIND meta-z change_window 16 - /BIND -delete meta-y