summaryrefslogtreecommitdiff
path: root/doc/en/autogen/user/alias_commands.txt
blob: 41190ec3b4eb6c3e8111213f018f9c4381664c42 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
[[command_alias_alias]]
[command]*`alias`* create an alias for a command::

----------------------------------------
/alias  [-completion <completion>] <alias> [<command> [;<command>...]]

completion: completion for alias (optional, by default completion is done with target command)
            note: you can use %%command to use completion of an existing command
     alias: name of alias (can start or end with "*" for alias listing)
   command: command name with arguments (many commands can be separated by semicolons)

Without argument, this command lists all defined alias.

Note: in command, special variables are replaced:
        $n: argument 'n' (between 1 and 9)
       $-m: arguments from 1 to 'm'
       $n-: arguments from 'n' to last
      $n-m: arguments from 'n' to 'm'
        $*: all arguments
        $~: last argument
      $var: where "var" is a local variable of buffer (see /buffer localvar)
            examples: $nick, $channel, $server, $plugin, $name

To remove an alias, use command /unalias.

Examples:
  alias /split to split window horizontally:
    /alias split /window splith
  alias /hello to say "hello" on all channels but not on #weechat:
    /alias hello /allchan -exclude=#weechat msg * hello
  alias /forcejoin to send IRC command "forcejoin" with completion of /sajoin:
    /alias -completion %%sajoin forcejoin /quote forcejoin
----------------------------------------