history-search-multi-word/README.md

## Introduction

Binds `Ctrl-R` to a widget that searches for multiple keywords in `AND` fashion.
In other words, you can enter multiple words, and history entries that match
all of them will be found.

Video – view on [asciinema](https://asciinema.org/a/46371). You can resize the video by pressing `Ctrl-+` or `Cmd-+`.

[![asciicast](https://asciinema.org/a/46371.png)](https://asciinema.org/a/46371)

## News

* 20-09-2016
  - Keys Page Up and Page Down work and page-wise move along history. Also, `Ctrl-P`, `Ctrl-N`
    move to previous and next entries

* 19-09-2016
  - Better immunity to [zsh-autosuggestions](https://github.com/zsh-users/zsh-autosuggestions)
    and [zsh-syntax-highlighting](https://github.com/zsh-users/zsh-syntax-highlighting) – home,
    end, left and right cursor keys now work smoothly

* 25-05-2016
  - Cooperation with
    [zsh-autosuggestions](https://github.com/zsh-users/zsh-autosuggestions)
    plugin
  - Configuration option to set page size, example use:

    ```zsh
    zstyle ":history-search-multi-word" page-size "5"
    ```

## Installation

**The plugin is "standalone"**, which means that only sourcing it is needed. So to
install, unpack `history-search-multi-word` somewhere and add

```zsh
source {where-hsmw-is}/history-search-multi-word.plugin.zsh
```

to `zshrc`.

If using a plugin manager, then `Zplugin` is recommended, but you can use any
other too, and also install with `Oh My Zsh` (by copying directory to
`~/.oh-my-zsh/custom/plugins`).


### [Zplugin](https://github.com/psprint/zplugin)

Add `zplugin load psprint/history-search-multi-word` to your `.zshrc` file.
Zplugin will handle cloning the plugin for you automatically the next time you
start zsh.

### Antigen

Add `antigen bundle psprint/history-search-multi-word` to your `.zshrc` file.
Antigen will handle cloning the plugin for you automatically the next time you
start zsh. You can also add the plugin to a running zsh with `antigen bundle
psprint/history-search-multi-word` for testing before adding it to your
`.zshrc`.

### Oh-My-Zsh

1. `cd ~/.oh-my-zsh/custom/plugins`
2. `git clone git@github.com:psprint/history-search-multi-word.git`
3. Add `history-search-multi-word` to your plugin list

### Zgen

Add `zgen load psprint/history-search-multi-word` to your .zshrc file in the same
place you're doing your other `zgen load` calls in.

### Manual installation

Copy the file `history-search-multi-word` to your `site-functions` directory and add:

```zsh
autoload history-search-multi-word
zle -N history-search-multi-word
zle -N history-search-multi-word-backwards history-search-multi-word
zle -N history-search-multi-word-pbackwards history-search-multi-word
zle -N history-search-multi-word-pforwards history-search-multi-word
bindkey "^R" history-search-multi-word
```

to your `~/zshrc`.

## IRC Channel

Channel `#zplugin@freenode` is a support place for all author's projects. Connect to:
[chat.freenode.net:6697](ircs://chat.freenode.net:6697/%23zplugin) (SSL) or [chat.freenode.net:6667](irc://chat.freenode.net:6667/%23zplugin)
 and join #zplugin.

Following is a quick access via Webchat [![IRC](https://kiwiirc.com/buttons/chat.freenode.net/zplugin.png)](https://kiwiirc.com/client/chat.freenode.net:+6697/#zplugin)
-												First working version

											
										
										
											2016-05-22 06:58:00 +00:00
+								## Introduction
 								Binds `Ctrl-R` to a widget that searches for multiple keywords in `AND` fashion.
 								In other words, you can enter multiple words, and history entries that match
-												Updated README.md

											
										
										
											2016-07-03 04:21:15 +00:00
+								all of them will be found.
-												First working version

											
										
										
											2016-05-22 06:58:00 +00:00
-												Updated REAMDE.md

											
										
										
											2016-06-09 07:39:23 +00:00
+								Video – view on [asciinema](https://asciinema.org/a/46371). You can resize the video by pressing `Ctrl-+` or `Cmd-+`.
-												First working version

											
										
										
											2016-05-22 06:58:00 +00:00
-												Updated README.md

											
										
										
											2016-05-22 18:12:25 +00:00
+								[![asciicast](https://asciinema.org/a/46371.png)](https://asciinema.org/a/46371)
-												Updated README.md

											
										
										
											2016-05-22 07:07:34 +00:00
-												Updated README.md (News section)

											
										
										
											2016-05-25 06:05:24 +00:00
+								## News
-												Keys Page Up and Page Down work

											
										
										
											2016-09-20 06:46:46 +00:00
+								* 20-09-2016
-												Updated README.md

											
										
										
											2016-09-20 07:07:48 +00:00
+								  - Keys Page Up and Page Down work and page-wise move along history. Also, `Ctrl-P`, `Ctrl-N`
 								    move to previous and next entries
-												Keys Page Up and Page Down work

											
										
										
											2016-09-20 06:46:46 +00:00
-												Better immunity to z-sy-h and z-au-s – left and right cursor keys

											
										
										
											2016-09-19 14:22:17 +00:00
+								* 19-09-2016
-												Keys Page Up and Page Down work

											
										
										
											2016-09-20 06:46:46 +00:00
+								  - Better immunity to [zsh-autosuggestions](https://github.com/zsh-users/zsh-autosuggestions)
-												z-sy-h and z-au-s immunity also for Home and End keys

											
										
										
											2016-09-19 14:42:44 +00:00
+								    and [zsh-syntax-highlighting](https://github.com/zsh-users/zsh-syntax-highlighting) – home,
 								    end, left and right cursor keys now work smoothly
-												Better immunity to z-sy-h and z-au-s – left and right cursor keys

											
										
										
											2016-09-19 14:22:17 +00:00
-												Updated README.md (News section)

											
										
										
											2016-05-25 06:05:24 +00:00
+								* 25-05-2016
 								  - Cooperation with
 								    [zsh-autosuggestions](https://github.com/zsh-users/zsh-autosuggestions)
 								    plugin
-												"page-size" zstyle (:history-search-multi-word)

											
										
										
											2016-05-25 07:24:03 +00:00
+								  - Configuration option to set page size, example use:
 								    ```zsh
 								    zstyle ":history-search-multi-word" page-size "5"
 								    ```
-												Updated README.md (News section)

											
										
										
											2016-05-25 06:05:24 +00:00
-												Updated README.md

											
										
										
											2016-05-22 07:07:34 +00:00
+								## Installation
-												Updated README.md

											
										
										
											2016-09-13 16:00:18 +00:00
+								**The plugin is "standalone"**, which means that only sourcing it is needed. So to
-												Updated README.md (standalone plugin)

											
										
										
											2016-06-09 07:24:27 +00:00
+								install, unpack `history-search-multi-word` somewhere and add
 								```zsh
 								source {where-hsmw-is}/history-search-multi-word.plugin.zsh
 								```
 								to `zshrc`.
 								If using a plugin manager, then `Zplugin` is recommended, but you can use any
 								other too, and also install with `Oh My Zsh` (by copying directory to
 								`~/.oh-my-zsh/custom/plugins`).
-												Updated README.md

											
										
										
											2016-05-23 15:58:20 +00:00
+								### [Zplugin](https://github.com/psprint/zplugin)
 								Add `zplugin load psprint/history-search-multi-word` to your `.zshrc` file.
 								Zplugin will handle cloning the plugin for you automatically the next time you
 								start zsh.
-												Updated README.md

											
										
										
											2016-06-09 07:26:17 +00:00
+								### Antigen
-												Updated README.md

											
										
										
											2016-05-22 07:07:34 +00:00
-												Updated README.md

											
										
										
											2016-05-23 15:58:20 +00:00
+								Add `antigen bundle psprint/history-search-multi-word` to your `.zshrc` file.
 								Antigen will handle cloning the plugin for you automatically the next time you
 								start zsh. You can also add the plugin to a running zsh with `antigen bundle
 								psprint/history-search-multi-word` for testing before adding it to your
 								`.zshrc`.
-												Add install instructions for zgen, antigen and oh-my-zsh

											
										
										
											2016-05-22 18:58:11 +00:00
-												Updated README.md

											
										
										
											2016-06-09 07:26:17 +00:00
+								### Oh-My-Zsh
-												Add install instructions for zgen, antigen and oh-my-zsh

											
										
										
											2016-05-22 18:58:11 +00:00
 . `cd ~/.oh-my-zsh/custom/plugins`
 . `git clone git@github.com:psprint/history-search-multi-word.git`
-												Updated README.md

											
										
										
											2016-09-13 16:00:18 +00:00
+. Add `history-search-multi-word` to your plugin list
-												Add install instructions for zgen, antigen and oh-my-zsh

											
										
										
											2016-05-22 18:58:11 +00:00
-												Updated README.md

											
										
										
											2016-06-09 07:26:17 +00:00
+								### Zgen
-												Add install instructions for zgen, antigen and oh-my-zsh

											
										
										
											2016-05-22 18:58:11 +00:00
-												Updated README.md

											
										
										
											2016-09-13 16:00:18 +00:00
+								Add `zgen load psprint/history-search-multi-word` to your .zshrc file in the same
 								place you're doing your other `zgen load` calls in.
-												Add install instructions for zgen, antigen and oh-my-zsh

											
										
										
											2016-05-22 18:58:11 +00:00
-												Updated README.md

											
										
										
											2016-05-22 19:27:39 +00:00
+								### Manual installation
 								Copy the file `history-search-multi-word` to your `site-functions` directory and add:
-												Updated README.md

											
										
										
											2016-05-22 07:07:34 +00:00
+								```zsh
-												*process-buffer not used

											
										
										
											2016-05-22 07:13:27 +00:00
+								autoload history-search-multi-word
-												Updated README.md

											
										
										
											2016-05-22 07:07:34 +00:00
+								zle -N history-search-multi-word
 								zle -N history-search-multi-word-backwards history-search-multi-word
-												Keys Page Up and Page Down work

											
										
										
											2016-09-20 06:46:46 +00:00
+								zle -N history-search-multi-word-pbackwards history-search-multi-word
 								zle -N history-search-multi-word-pforwards history-search-multi-word
-												Updated README.md

											
										
										
											2016-05-22 07:07:34 +00:00
+								bindkey "^R" history-search-multi-word
 								```
-												Add install instructions for zgen, antigen and oh-my-zsh

											
										
										
											2016-05-22 18:58:11 +00:00
+								to your `~/zshrc`.
-												Updated README.md

											
										
										
											2016-05-22 07:33:27 +00:00
 								## IRC Channel
 								Channel `#zplugin@freenode` is a support place for all author's projects. Connect to:
 								[chat.freenode.net:6697](ircs://chat.freenode.net:6697/%23zplugin) (SSL) or [chat.freenode.net:6667](irc://chat.freenode.net:6667/%23zplugin)
 								 and join #zplugin.
 								Following is a quick access via Webchat [![IRC](https://kiwiirc.com/buttons/chat.freenode.net/zplugin.png)](https://kiwiirc.com/client/chat.freenode.net:+6697/#zplugin)