diff options
| -rw-r--r-- | ido-mode/README.md | 140 | ||||
| -rw-r--r-- | vim-mode/README.md | 327 |
2 files changed, 0 insertions, 467 deletions
diff --git a/ido-mode/README.md b/ido-mode/README.md deleted file mode 100644 index d6206cb..0000000 --- a/ido-mode/README.md +++ /dev/null @@ -1,140 +0,0 @@ -# NAME - -ido_switcher.pl - -# DESCRIPTION - -Search and select windows similar to ido-mode for emacs - -# INSTALLATION - -This script requires that you have first installed and loaded `uberprompt.pl` - -Uberprompt can be downloaded from: - -[https://github.com/shabble/irssi-scripts/raw/master/prompt_info/uberprompt.pl](https://github.com/shabble/irssi-scripts/raw/master/prompt_info/uberprompt.pl) - -and follow the instructions at the top of that file for installation. - -If uberprompt.pl is available, but not loaded, this script will make one -attempt to load it before giving up. This eliminates the need to precisely -arrange the startup order of your scripts. - -## SETUP - -`/bind ^G /ido_switch_start [options]` - -## USAGE - -`C-g` (or whatever you've set the above bind to), enters IDO window switching mode. -You can then type either a search string, or use one of the additional key-bindings -to change the behaviour of the search. `C-h` provides online help regarding -the possible interactive options. - -### EXTENDED USAGE: - -It is possible to pass arguments to the /ido_switch_start command, which -correspond to some of the interactively settable parameters listed below. - -The following options are available: - -- `-channels` -- search through only channels. -- `-queries` -- search through only queries. -- `-all` -- search both queries and channels (Default). -- `-active` -- limit search to only window items with activity. -- `-exact` -- enable exact-substring matching -- `-flex` -- enable flex-string matching - -_If neither of `-exact` or `-flex` are given, the default is the value of -`/set ido_use_flex`_ - -#### EXAMPLE - -- `/bind ^G /ido_switch_start -channels` -- `/bind ^F /ido_switch_start -queries -active` - -__NOTE:__ When entering window switching mode, the contents of your input line will -be saved and cleared, to avoid visual clutter whilst using the switching -interface. It will be restored once you exit the mode using either `C-g`, `Esc`, -or `RET`. - -### INTERACTIVE COMMANDS - -The following key-bindings are available only once the mode has been -activated: - -- `C-g` - Exit the mode without changing windows. -- `Esc` - Exit, as above. -- `C-s` - Rotate the list of window candidates forward by 1 -- `C-r` - Rotate the list of window candidates backward by 1 -- `C-e` - Toggle 'Active windows only' filter -- `C-f` - Switch between 'Flex' and 'Exact' matching. -- `C-d` - Select a network or server to filter candidates by -- `C-u` - Clear the current search string -- `C-q` - Cycle between showing only queries, channels, or all. -- `C-SPC` - Filter candidates by current search string, and then reset - the search string -- `RET` - Select the current head of the candidate list (the green one) -- `SPC` - Select the current head of the list, without exiting the - switching mode. The head is then moved one place to the right, - allowing one to cycle through channels by repeatedly pressing space. -- `TAB` - __[currently in development]__ displays all possible completions - at the bottom of the current window. -- _All other keys_ (`a-z, A-Z`, etc) - Add that character to the current search - string. - -### USAGE NOTES - -- Using C-e (show actives), followed by repeatedly pressing space will cycle - through all your currently active windows. -- If you enter a search string fragment, and realise that more than one candidate - is still presented, rather than delete the whole string and modify it, you can - use C-SPC to 'lock' the current matching candidates, but allow you to search - through those matches alone. - -# AUTHORS - -Based originally on [window_switcher.pl](http://scripts.irssi.org/scripts/window_switcher.pl) script Copyright 2007 Wouter Coekaerts -`<coekie@irssi.org>`. - -Primary functionality Copyright 2010-2011 Tom Feist -`<shabble+irssi@metavore.org>`. - -# LICENCE - -This program is free software; you can redistribute it and/or modify -it under the terms of the GNU General Public License as published by -the Free Software Foundation; either version 2 of the License, or -(at your option) any later version. - -This program is distributed in the hope that it will be useful, -but WITHOUT ANY WARRANTY; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -GNU General Public License for more details. - -You should have received a copy of the GNU General Public License -along with this program; if not, write to the Free Software -Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA - -# BUGS: - -- __FIXED__ Sometimes selecting a channel with the same name on a different - network will take you to the wrong channel. - -# TODO - -- __DONE__ C-g - cancel -- __DONE__ C-spc - narrow -- __DONE__ flex matching (on by default, but optional) -- TODO server/network narrowing -- __DONE__ colourised output (via uberprompt) -- __DONE__ C-r / C-s rotate matches -- __DONE__ toggle queries/channels -- __DONE__ remove inputline content, restore it afterwards. -- TODO tab - display all possibilities in window (clean up afterwards) -how exactly will this work? -- __DONE__ sort by recent activity/recently used windows (separate commands?) -- __TODO__ need to be able to switch ordering of active ones (numerical, or most -recently active, priority to PMs/hilights, etc?) -- __DONE__ should space auto-move forward to next window for easy stepping - through sequential/active windows?
\ No newline at end of file diff --git a/vim-mode/README.md b/vim-mode/README.md deleted file mode 100644 index 593d39d..0000000 --- a/vim-mode/README.md +++ /dev/null @@ -1,327 +0,0 @@ -# NAME - -vim_mode.pl - -# DESCRIPTION - -An Irssi script to emulate some of the vi(m) features for the Irssi inputline. - -# INSTALLATION - -Copy into your `~/.irssi/scripts/` directory and load with -`/SCRIPT LOAD vim_mode.pl`. You may wish to have it autoload in one of the -[usual ways](https://github.com/shabble/irssi-docs/wiki/Guide#Autorunning_Scripts). - -## DEPENDENCIES - -For proper :ex mode support, vim-mode requires the installation of `uberprompt.pl` -Uberprompt can be downloaded from: - -[https://github.com/shabble/irssi-scripts/raw/master/prompt_info/uberprompt.pl](https://github.com/shabble/irssi-scripts/raw/master/prompt_info/uberprompt.pl) - -and follow the instructions at the top of that file for installation. - -If you don't need Ex-mode, you can run vim_mode.pl without the -uberprompt.pl script, but it is strongly recommended that you use it. - -### Irssi requirements - -0.8.12 and above should work fine. However the following features are -disabled in irssi < 0.8.13: - -- `j` `k` (only with count, they work fine without count in older versions) -- `gg`, `G` - -It is intended to work with at Irssi 0.8.12 and later versions. However some -features are disabled in older versions (see below for details). - -Perl >= 5.8.1 is recommended for UTF-8 support (which can be disabled if -necessary). Please report bugs in older versions as well, we'll try to fix -them. Later versions of Perl are also faster, which is probably beneficial -to a script of this size and complexity. - -## SETUP - -Run the following command to add a statusbar item that shows which mode -you're in. - -`/statusbar window add vim_mode` - -And the following to let `:b [str]` display a list of channels matching your -search string. - -`/statusbar window add vim_windows` - -__Note:__ Remember to `/save` after adding these statusbar items to make them -permanent. - - - -### FILE-BASED CONFIGURATION - -Additionally to the irssi settings described in [SETTINGS](#pod_SETTINGS), vim_mode -can be configured through an external configuration file named "vim_moderc" -located in `~/.irssi/vim_moderc`. If available it's loaded on startup and every -supported ex-command is run. Its syntax is similar to "vimrc". To (re)load it -while vim_mode is running use `:so[urce]`. - -Currently Supported ex-commands: - -- `:map` - -# USAGE - -The following section is divided into the different modes as supported by Vim itself: - -## COMMAND MODE - -It supports most commonly used command mode features: - -- Insert/Command mode. `Escape` and `Ctrl-C` enter command mode. `/set -vim_mode_cmd_seq j` allows to use `jj` as Escape (any other character can be used as well). -- Cursor motion: `h l 0 ^ $ <Space> <BS> f t F T` -- History motion: `j k gg G` `gg` moves to the oldest (first) history -line. `G` without a count moves to the current input line, with a count it goes to the _count-th_ history line (1 is the oldest). -- Cursor word motion: `w b ge e W gE B E` -- Word objects (only the following work yet): `aw aW` -- Yank and paste: `y p P` -- Change and delete: `c d` -- Delete at cursor: `x X` -- Replace at cursor: `r` -- Insert mode: `i a I A` -- Switch case: `~` -- Repeat change: `.` -- Repeat `ftFT: ; ,` -- Registers: `"a-"z "" "0 "* "+ "_` (black hole) -- Line-wise shortcuts: `dd cc yy` -- Shortcuts: `s S C D` -- Scroll the scrollback buffer: `Ctrl-E Ctrl-D Ctrl-Y Ctrl-U Ctrl-F Ctrl-B` -- Switch to last active window: `Ctrl-6/Ctrl-^` -- Switch split windows: <Ctrl-W j Ctrl-W k> -- Undo/Redo: `u Ctrl-R` - -Counts and combinations work as well, e.g. `d5fx` or `3iabc<esc>`. Counts also work with mapped ex-commands (see below), e.g. if you map `gb` to do `:bn`, then `2gb` will switch to the second next buffer. Repeat also supports counts. - -### REGISTERS - -- Appending to register with `"A-"Z` -- `""` is the default yank/delete register. -- `"0` contains the last yank (if no register was specified). -- The special registers `"* "+` both contain irssi's internal cut-buffer. - -## INSERT MODE - -The following insert mode mappings are supported: - -- Insert register content: Ctrl-R x (where x is the register to insert) - -## EX-MODE - -Ex-mode (activated by `:` in command mode) supports the following commands: - -- Command History: - -`<uparrow>` - cycle backwards through history - -`<downarrow>` - cycle forwards through history - -`:eh` - show ex history - -- Switching buffers: - -`:[N]b [N]` - switch to channel number - -`:b#` - switch to last channel - -`:b` <partial-channel-name> - -`:b` <partial-server>/<partial-channel> - -`:buffer {args}` (same as `:b`) - -`:[N]bn[ext] [N]` - switch to next window - -`:[N]bp[rev] [N]` - switch to previous window - -- Close window: - -`:[N]bd[elete] [N]` - -- Display windows: - -`:ls`, `:buffers` - -- Display registers: - -<:reg[isters] {args}>, `:di[splay] {args}` - -- Display undolist: - -`:undol[ist]` (mostly used for debugging) - -- Source files: - -`:so[urce]` - only sources vim_moderc at the moment, - `{file}` not supported - -- Mappings: - -`:map` - display custom mappings - -- Save mappings: - -`:mkv[imrc][!]` - like in Vim, but [file] not supported - -- Substitute: - -`:s///` - _i_ and _g_ are supported as flags, only /// can be used as - separator, uses Perl regex instead of Vim regex - -- Settings: - -`:se[t]` - display all options - -`:se[t] {option}` - display all matching options - -`:se[t] {option} {value}` - change option to value - -### MAPPINGS - -#### Commands - -- `:map {lhs}` - display mappings starting with {lhs} -- `:map {lhs} {rhs}` - add mapping -- `:unm[ap] {lhs}` - remove custom mapping - -#### Parameters - -_{lhs}_ is the key combination to be mapped, _{rhs}_ the target. The -`<>` notation is used - -(e.g. `<C-F>` is _Ctrl-F_), case is ignored. - Supported `<>` keys are: - -- `<C-A>` - `<C-Z>`, -- `<C-^>`, `<C-6>` -- `<Space>` -- `<CR>` - Enter -- `<BS>` - Backspace -- `<Nop>` - No-op (Do Nothing). - -Mapping ex-mode and irssi commands is supported. When mapping ex-mode commands -the trailing `<Cr>` is not necessary. Only default mappings can be used -in _{rhs}_. - -Examples: - -- `:map w W` - to remap w to work like W -- `:map gb :bnext` - to map gb to call :bnext -- `:map gB :bprev` -- `:map g1 :b 1` - to map g1 to switch to buffer 1 -- `:map gb :b` - to map gb to :b, 1gb switches to buffer 1, 5gb to 5 -- `:map <C-L> /clear` - map Ctrl-L to irssi command /clear -- `:map <C-G> /window goto 1` -- `:map <C-E> <Nop`> - disable <C-E>, it does nothing now -- `:unmap <C-E>` - restore default behavior of `<C-E>` -after disabling it - -Note that you must use `/` for irssi commands (like `/clear`), the current value -of Irssi's cmdchars does __not__ work! This is necessary do differentiate between -ex-commands and irssi commands. - -## SETTINGS - -The settings are stored as irssi settings and can be set using `/set` as usual -(prepend `vim_mode_` to setting name) or using the `:set` ex-command. The -following settings are available: - -- utf8: support UTF-8 characters, boolean, default on -- debug: enable debug output, boolean, default off -- cmd_seq: char that when double-pressed simulates `<Esc>`, string, default '' (disabled) -- start_cmd: start every line in command mode, boolean, default off -- max_undo_lines: size of the undo buffer. Integer, default 50 items. -- ex_history_size: number of items stored in the ex-mode history. Integer, default 100. -- prompt_leading_space: determines whether ex mode prepends a space to the displayed input. Boolean, default on - -In contrast to irssi's settings, `:set` accepts 0 and 1 as values for boolean -settings, but only vim_mode's settings can be set/displayed. - -Examples: - - :set cmd_seq=j # set cmd_seq to j - :set cmd_seq= # disable cmd_seq - :set debug=on # enable debug - :set debug=off # disable debug - -# SUPPORT - -Any behavior different from Vim (unless explicitly documented) should be -considered a bug and reported. - -__NOTE:__ This script is still under heavy development, and there may be bugs. -Please submit reproducible sequences to the bug-tracker at: -[http://github.com/shabble/irssi-scripts/issues/new](http://github.com/shabble/irssi-scripts/issues/new) - -or contact rudi_s or shabble on irc.freenode.net (#irssi and #irssi_vim) - -# AUTHORS - -Copyright © 2010-2011 Tom Feist `<shabble+irssi@metavore.org>` and -Copyright © 2010-2011 Simon Ruderich `<simon@ruderich.org>` - -# THANKS - -Particular thanks go to - -- estragib: a lot of testing and many bug reports and feature requests -- iaj: testing -- tmr: explaining how various bits of vim work - -as well as the rest of `#irssi` and `#irssi_vim` on Freenode IRC. - -# LICENCE - -Permission is hereby granted, free of charge, to any person obtaining a copy -of this software and associated documentation files (the "Software"), to deal -in the Software without restriction, including without limitation the rights -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: - -The above copyright notice and this permission notice shall be included in -all copies or substantial portions of the Software. - -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN -THE SOFTWARE. - -# BUGS - -- count before register doesn't work: e.g. 3"ap doesn't work, but "a3p does -- mapping an incomplete ex-command doesn't open the ex-mode with the partial - command (e.g. `:map gb :b` causes an error instead of opening the ex-mode and - displaying `:b<cursor>`) -- undo/redo cursor positions are mostly wrong - -# TODO - - - History: - - ` * /,?,n,N` to search through history (like rl_history_search.pl) - - - Window switching (`:b`) - - Tab completion of window(-item) names - - non-sequential matches(?) - -See also the TODO file at -[github](https://github.com/shabble/irssi-scripts/blob/master/vim-mode/TODO) for -many many more things. - -## WONTFIX - -Things we're not ever likely to do: - -- Macros
\ No newline at end of file |