aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorTom Feist <shabble@metavore.org>2011-04-18 14:28:57 +0000
committerTom Feist <shabble@metavore.org>2011-04-18 14:28:57 +0000
commitdd243797725c9e6d95bb38a9ff9cd9e82430b39f (patch)
treeebe073ad59f47af3b1803ae313977d1d633b3511
parentprotecting my newly podded docs against a rogue README generator. (diff)
downloadirssi-scripts-dd243797725c9e6d95bb38a9ff9cd9e82430b39f.tar.gz
irssi-scripts-dd243797725c9e6d95bb38a9ff9cd9e82430b39f.zip
removed original markdown readmes
-rw-r--r--ido-mode/README.md140
-rw-r--r--vim-mode/README.md327
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 &copy; 2010-2011 Tom Feist `<shabble+irssi@metavore.org>` and
-Copyright &copy; 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