├── LICENSE
├── README.md
├── autoload
    └── vimbits
    │   ├── highlightonyank.vim
    │   ├── jump.vim
    │   └── vim9cmdline.vim
├── doc
    ├── easyjump.txt
    ├── fFtT.txt
    ├── tags
    └── vimtips.txt
├── plugin
    ├── easyjump.vim
    ├── fFtT.vim
    └── vimbits.vim
└── test
    ├── highlight.vim
    ├── runtests.sh
    ├── setup.vim
    ├── visual.vim
    └── yank.vim


/LICENSE:
--------------------------------------------------------------------------------
 1 | MIT License
 2 | 
 3 | Copyright (c) 2024 girishji
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy
 6 | of this software and associated documentation files (the "Software"), to deal
 7 | in the Software without restriction, including without limitation the rights
 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 | 
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 | 
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | # VimBits
  2 | 
  3 | Suite of lightweight Vim plugins.
  4 | 
  5 | 1. [**HighlightOnYank**](#plugin-highlightonyank) - Confirm yank operation by temporarily highlighting the region.
  6 | 
  7 | 2. [**EasyJump**](#plugin-easyjump) - Jump to any location on screen by typing two characters.
  8 | 
  9 | 3. [**fFtT**](#plugin-fFtT) - Highlight characters reachable in one jump using `f`, `t`, `F`, and `T` commands. 
 10 | 
 11 | 4. [**Vim9Cmdline**](#plugin-vim9cmdline) - Use *vim9script* in command-line seamlessley.
 12 | 
 13 | 5. **vimtips** from [zzapper](https://web.archive.org/web/20121104092340/http://zzapper.co.uk/vimtips.html) - `:h vimtips.txt`
 14 | 
 15 | 
 16 | ## Requirements
 17 | 
 18 | - Vim 9.0 or higher
 19 | 
 20 | ## Installation
 21 | 
 22 | Install it via [vim-plug](https://github.com/junegunn/vim-plug).
 23 | 
 24 | <details><summary><b>Show instructions</b></summary>
 25 | <br>
 26 | 
 27 | Using vim9 script:
 28 | 
 29 | ```vim
 30 | vim9script
 31 | plug#begin()
 32 | Plug 'girishji/vimbits'
 33 | plug#end()
 34 | ```
 35 | 
 36 | Using legacy script:
 37 | 
 38 | ```vim
 39 | call plug#begin()
 40 | Plug 'girishji/vimbits'
 41 | call plug#end()
 42 | ```
 43 | 
 44 | </details>
 45 | 
 46 | Install using Vim's built-in package manager.
 47 | 
 48 | <details><summary><b>Show instructions</b></summary>
 49 | <br>
 50 | 
 51 | ```bash
 52 | $ mkdir -p $HOME/.vim/pack/downloads/opt
 53 | $ cd $HOME/.vim/pack/downloads/opt
 54 | $ git clone https://github.com/girishji/vimbits.git
 55 | ```
 56 | 
 57 | Add the following to your $HOME/.vimrc file.
 58 | 
 59 | ```vim
 60 | packadd vimbits
 61 | ```
 62 | 
 63 | </details>
 64 | 
 65 | ## Configuration
 66 | 
 67 | By default, all plugins are enabled except for Vim9Cmdline. To disable a specific plugin, set its corresponding global variable to `false`. To enable a plugin, set its corresponding global variable to `true`.
 68 | 
 69 | ```
 70 | vim9script
 71 | g:vimbits_highlightonyank = true
 72 | g:vimbits_easyjump = true
 73 | g:vimbits_fFtT = true
 74 | g:vimbits_vim9cmdline = false
 75 | ```
 76 | 
 77 | More configurable options pertaining to individual plugins are described below.
 78 | 
 79 | # Plugin: HighlightOnYank
 80 | 
 81 | Ensure the text you intended to yank is correctly selected. This feature helps avoid surprises when pasting, especially if you accidentally hit the wrong keys.
 82 | 
 83 | The yanked region is temporarily highlighted (using `:h hl-IncSearch`) for 300 milliseconds by default. The duration and highlight group are configurable, and there's an option to disable highlighting in visual mode.
 84 | 
 85 | To customize the default settings, add the following to your `.vimrc` file:
 86 | 
 87 | ```vim
 88 | vim9script
 89 | g:vimbits_highlightonyank = false  # Disables the default autocmd
 90 | import autoload 'vimbits/highlightonyank.vim' as hy
 91 | augroup HighlightOnYank
 92 |     autocmd!
 93 |     autocmd TextYankPost * hy.HighlightOnYank('IncSearch', 300, true)
 94 | augroup END
 95 | ```
 96 | 
 97 | `HighlightOnYank()` accepts three arguments:
 98 | 
 99 | - `hlgroup`: The highlight group for the yanked region.
100 | - `duration`: The duration of the highlight in milliseconds.
101 | - `in_visual`: Whether to highlight the region when yanked in visual mode.
102 | 
103 | This mini plugin is inspired by [this issue](https://github.com/vim/vim/issues/14848).
104 | 
105 | # Plugin: EasyJump
106 | 
107 | Jump to any location on screen by typing two characters.
108 | 
109 | ## TL;DR
110 | 
111 | - `s` + _\<character>_ + _\<tag_character>_ to jump
112 | - `ds` + _\<character>_ + _\<tag_character>_ to delete (similarly, `vs` for visual selection, `cs` for change, etc.)
113 | - `<Tab>` and `<S-Tab>` (or `;` and `,`) after _\<character>_ to view additional tag characters
114 | - `2s` + _\<character_1>_ + _\<character_2>_ + _\<tag_character>_ to jump
115 | 
116 | ## Features
117 | 
118 | - Initially bound to `s`, but it can be reassigned to any desired trigger (e.g., `,`).
119 | - Supports essential Vim idioms such as `ds` for deletion, `cs` for change, `vs` for visual selection, and more. Here `s` is the trigger character.
120 | - Updates the jump list (`:jumps`) for easy back-navigation using `<c-o>`.
121 | - Optional two-character mode, for users accustomed to targeting with two characters instead of one.
122 | - Non-disruptive: Does not modify the buffer. Crafted in vim9 script.
123 | 
124 | 
125 | 🚀 **Jump (`s`)**: Type `s` followed by a character (say `c`). Witness
126 | new tag characters replacing the character `c`. Typing next
127 | character initiates the jump. For instance, typing `e`
128 | navigates the cursor to the `c` under `e`.
129 | 
130 | <img src='https://gist.githubusercontent.com/girishji/40e35cd669626212a9691140de4bd6e7/raw/6041405e45072a7fbc4e352cbd461e450a7af90e/easyjump-img1.jpeg' width='700'>
131 | 
132 | 🚀 **Jump back**: Type `<c-o>` (control-O) to jump back. Type `<tab>` or `<c-i>` to jump forward.
133 | 
134 | 🚀 **Visual Select (`vs`)**: For visually selecting a block of text from the
135 | cursor position up to an instance of `c`, enter `vsc`, then the highlighted
136 | character (e.g., `e`).
137 | 
138 | <img src='https://gist.githubusercontent.com/girishji/40e35cd669626212a9691140de4bd6e7/raw/6041405e45072a7fbc4e352cbd461e450a7af90e/easyjump-img2.jpeg' width='700'>
139 | 
140 | Likewise, use `ds` for deletion or `cs` for text alteration.
141 | 
142 | Press `<esc>` to cancel the ongoing jump.
143 | 
144 | Pictures above are based on `:colorscheme quiet`.
145 | 
146 | 🔎 **What if the intended jump location is not showing a tag letter?**
147 | 
148 | This scenario occurs when there aren't enough unique letters available for
149 | tagging. Simply press `<Tab>` (or `;`), and new tag labels will fill the
150 | remaining spots. To cycle backwards, press `<S-Tab>` (or `,`).
151 | 
152 | 🚀 **Two-Character Mode (New)**: Activated with `2s` or simply `s` if `g:easyjump_two_chars` is configured as `true`.
153 | 
154 | - Use `2s` + _\<character>_ + _\<tag_character>_ to leap to your destination (when a tag character marks the spot).
155 | - If no tag label is present, type the adjacent character as well, forming `2s` + _\<character_1>_ + _\<character_2>_ + _\<tag_character>_ to execute the jump.
156 | 
157 | > [!TIP]
158 | > A lazy way to navigate is by leveraging the space character as a guide. Experiment with typing `s` followed by `<space>`. The algorithm strives to allocate one label per line. Once you're near your desired location within a line, you can [effectively employ](https://github.com/girishji/fFtT.vim) Vim's built-in `f/F, t/T` commands to reach it precisely. This is an alternative to using relative line numbers to jump.
159 | 
160 | ## Trigger Key
161 | 
162 | By default, `s` serves as the trigger key. To unmap `s` and restore it to the default (:h s),
163 | include the following line in your .vimrc file:
164 | 
165 | ```
166 | g:easyjump_default_keymap = false
167 | ```
168 | 
169 | To assign `,` as the trigger for jumping, add the following lines to your `.vimrc`
170 | file. You can choose any other key beside `,`.
171 | 
172 | ```
173 | nmap , <Plug>EasyjumpJump;
174 | omap , <Plug>EasyjumpJump;
175 | vmap , <Plug>EasyjumpJump;
176 | ```
177 | 
178 | ## Case Sensitivity
179 | 
180 | Options include 'case' (case sensitive), 'icase' (ignore case), or 'smart'
181 | (smart case). Add the following line to your .vimrc:
182 | 
183 | ```
184 | g:easyjump_case = 'smart' # Can be 'case', 'icase', or 'smart' (default).
185 | ```
186 | 
187 | ## Highlight Group
188 | 
189 | The tag letters displayed alongside destination locations utilize the
190 | highlighted group `EasyJump`. By default, this group is linked to `IncSearch`. Modify its
191 | appearance using the `:highlight` command to change colors.
192 | 
193 | ## Tag Letters
194 | 
195 | Jump locations prioritize placement based on distance from cursor and
196 | preference for having at least one placement per line.
197 | Letters are picked in the following sequence. Modify the sequence (say, for
198 | Dvorak) as needed. Set the following global variable:
199 | 
200 | ```
201 | g:easyjump_letters = 'asdfgwercvhjkluiopynmbtqxzASDFGWERCVHJKLUIOPYNMBTQXZ0123456789'
202 | ```
203 | 
204 | # Plugin: fFtT
205 | 
206 | Characters that are reachable with a single jump are highlighted, while others are dimmed. This enhancement enhances the accuracy of navigation using `f`, `F`, `t`, and `T` commands. Moreover, you can prefix the command with a numerical `[count]` (e.g., `3f`), which will exclusively highlight the `[count]`'th occurrence (third in this instance) of a character to the right of the cursor, while dimming the others.
207 | 
208 | This plugin does not alter Vim operators or commands. It solely focuses on highlighting relevant characters without making any changes to the default key mappings. The code consists of less than 100 lines, with explanatory comments.
209 | 
210 | ![](https://gist.githubusercontent.com/girishji/40e35cd669626212a9691140de4bd6e7/raw/6041405e45072a7fbc4e352cbd461e450a7af90e/fFtT-img.jpeg)
211 | 
212 | The appearance of characters that are unreachable within one jump is determined by the highlight group `FfTtSubtle`, which is linked to the `Comment` group by default.
213 | 
214 | # Plugin: Vim9Cmdline
215 | 
216 | *vim9script* offers significant improvements over the legacy script. Although there isn't a direct way to switch the command line to parse *vim9script*, you can execute *vim9script* commands by prepending each command with `vim9`. This plugin automates that process for you.
217 | 
218 | <img src='https://gist.githubusercontent.com/girishji/40e35cd669626212a9691140de4bd6e7/raw/74e521e25364bdc01a94ce8668e8d8ef92308a59/vim9cmdline.jpeg' width='700'>
219 | 
220 | Some things to keep in mind:
221 | 
222 | - Remember that execution occurs in the global context, not the script-local context. This means you need to declare variables with the `g:` prefix, like `g:foo = 'bar'`.
223 | 
224 | - Common commands, such as visual range (`'<,'>`), other types of ranges, shell commands (`!`), substitution (`s//`), and global (`g//`), work as expected even when `vim9` is prepended.
225 | 
226 | - Ranges to Ex commands should be prefixed with a colon. For example, `:vim9 :%s/foo/bar` (notice the `:` before `%s`).
227 |   From `:h [range]`:
228 | 
229 |   > In Vim9 script a range needs to be prefixed with a colon to avoid ambiguity
230 |   > with continuation lines.
231 | 
232 | - Related to the above, if your keymap's right-hand side (rhs) starts with a range, it may throw an error. To avoid this, use `:h <Cmd>` or ensure the {rhs} of your keymap begins with `silent` or `:`. For example, `nnoremap your_key :% !your_cmd<cr>` throws an error, while `nnoremap your_key <cmd>% !your_cmd<cr>`, `nnoremap your_key :silent % !your_cmd<cr>` and `nnoremap your_key ::% !your_cmd<cr>` are OK.
233 | 
234 | - Colorschemes may not load if they are written in legacy script. `:vim9 colorscheme foo` will not work unless `foo` is written in vim9script.
235 | 
236 | - If you have defined a custom command with a completion function (`command -complete=custom,Foo() ...`), be aware that this function may not work as expected if it is designed to complete the n-th word. This is because there are now n+1 words, including the word `vim9`. You many need to adapt this function.
237 | 
238 | - If you work with multi-byte UTF-8 characters, you'll appreciate the *vim9* command line. When slicing a UTF-8 string using the `[from : to]` operator, *vim9* is more predictable because it uses character-based addressing, unlike the byte-based addressing of the legacy script.
239 | 
240 | - Legacy mode of addressing autoloaded functions and variables still work, even without legacy keywords like `call` and `let`. For instance, both `:vim9 g:foo#bar#baz()` and `:vim9 call g:foo#bar#baz()` work.
241 | 
242 | You can keep the command line in *vim9script* mode by default and switch back to the legacy script at any time using the `:ToggleVim9Cmdline` command.
243 | 
244 | ## Other Plugins to Enhance Your Workflow
245 | 
246 | 1. [**vimcomplete**](https://github.com/girishji/vimcomplete) - enhances autocompletion in Vim.
247 | 
248 | 2. [**devdocs.vim**](https://github.com/girishji/devdocs.vim) - browse documentation from [devdocs.io](https://devdocs.io).
249 | 
250 | 3. [**scope.vim**](https://github.com/girishji/scope.vim) - fuzzy find anything.
251 | 
252 | 4. [**VimSuggest**](https://github.com/girishji/vimsuggest) - autocompletion for Vim's command-line.
253 | 


--------------------------------------------------------------------------------
/autoload/vimbits/highlightonyank.vim:
--------------------------------------------------------------------------------
 1 | vim9script
 2 | 
 3 | # hlgroup: Highlight group used for highlighting yanked region.
 4 | # duration: Duration of highlight in milliseconds.
 5 | # in_visual: Whether to highlight the region if selected from visual mode.
 6 | export def HighlightOnYank(hlgroup = 'IncSearch', duration = 300, in_visual = true)
 7 |     if v:event.operator ==? 'y'
 8 |         if !in_visual && visualmode() != null_string
 9 |             visualmode(1)
10 |             return
11 |         endif
12 |         var [beg, end] = [getpos("'["), getpos("']")]
13 |         var type = v:event.regtype ?? 'v'
14 |         var pos = getregionpos(beg, end, {type: type})
15 |         var end_offset = (type == 'V' || v:event.inclusive) ? 1 : 0
16 |         var m = matchaddpos(hlgroup, pos->mapnew((_, v) => {
17 |             var col_beg = v[0][2] + v[0][3]
18 |             var col_end = v[1][2] + v[1][3] + end_offset
19 |             return [v[0][1], col_beg, col_end - col_beg]
20 |         }))
21 |         var winid = win_getid()
22 |         timer_start(duration, (_) => {
23 |             # keymap like `:vmap // y/<C-R>"<CR>` (search for visually selected text) throws E803
24 |             try
25 |                 m->matchdelete(winid)
26 |             catch
27 |             endtry
28 |         })
29 |     endif
30 | enddef
31 | 
32 | export def HighlightOnYankLegacy(hlgroup = 'IncSearch', duration = 300, in_visual = true)
33 |     if v:event.operator ==? 'y'
34 |         if !in_visual && visualmode() != null_string
35 |             visualmode(1)
36 |             return
37 |         endif
38 |         var [lnum_beg, col_beg, off_beg] = getpos("'[")[1 : 3]
39 |         var [lnum_end, col_end, off_end] = getpos("']")[1 : 3]
40 |         col_end += !v:event.inclusive ? 1 : 0
41 |         var maxcol = v:maxcol - 1
42 |         var visualblock = v:event.regtype[0] ==# "\<C-V>"
43 |         var pos = []
44 |         for lnum in range(lnum_beg, lnum_end, lnum_beg < lnum_end ? 1 : -1)
45 |             var col_b = (lnum == lnum_beg || visualblock) ? (col_beg + off_beg) : 1
46 |             var col_e = (lnum == lnum_end || visualblock) ? (col_end + off_end) : maxcol
47 |             pos->add([lnum, col_b, min([col_e - col_b + 1, maxcol])])
48 |         endfor
49 |         var m = matchaddpos(hlgroup, pos)
50 |         var winid = win_getid()
51 |         timer_start(duration, (_) => {
52 |             try
53 |                 m->matchdelete(winid)
54 |             catch
55 |             endtry
56 |         })
57 |     endif
58 | enddef
59 | 


--------------------------------------------------------------------------------
/autoload/vimbits/jump.vim:
--------------------------------------------------------------------------------
  1 | vim9script
  2 | 
  3 | var locations: list<list<number>> = [] # A list of {line nr, column nr} to jump to
  4 | var letters: string
  5 | var labels: string
  6 | var easyjump_case: string
  7 | 
  8 | export def Setup()
  9 |     easyjump_case = get(g:, 'easyjump_case', 'smart') # case/icase/smart
 10 |     letters = get(g:, 'easyjump_letters', '')
 11 |     if letters->empty()
 12 |         var alpha = 'asdfgwercvhjkluiopynmbtqxz'
 13 |         letters = $'{alpha}{alpha->toupper()}0123456789'
 14 |     endif
 15 |     if letters->split('\zs')->sort()->uniq()->len() != letters->len()
 16 |         echoe 'EasyJump: Letters list has duplicates'
 17 |     endif
 18 |     # if get(g:, 'easyjump_default_keymap', true) && !hasmapto('<Plug>EasyjumpJump;', 'n') && mapcheck('s', 'n') ==# ''
 19 |     if get(g:, 'easyjump_default_keymap', true)
 20 |         :nmap s <Plug>EasyjumpJump;
 21 |         :omap s <Plug>EasyjumpJump;
 22 |         :vmap s <Plug>EasyjumpJump;
 23 |     endif
 24 | enddef
 25 | 
 26 | # get all line numbers in the visible area of the window ordered by distance from cursor
 27 | def WindowLineNrs(): list<any>
 28 |     # line('w$') does not include a long line (broken into many lines) that is only partly visible
 29 |     var [lstart, lend] = [max([1, line('w0')]), min([line('w$') + 1, line('$')])] # lines on screen
 30 |     var [curline, curcol] = getcurpos()[1 : 2]
 31 |     var lnums = [curline]
 32 |     for dist in range(1, (lend - lstart))
 33 |         if curline + dist <= lend
 34 |             lnums->add(curline + dist)
 35 |         endif
 36 |         if curline - dist >= lstart
 37 |             lnums->add(curline - dist)
 38 |         endif
 39 |     endfor
 40 |     return lnums
 41 | enddef
 42 | 
 43 | # search for locations to jump to, starting from cursor position and searching outwards
 44 | def GatherLocations(ctx: string, filter_label: bool = false)
 45 |     var ignorecase = (easyjump_case ==? 'icase' || (easyjump_case ==? 'smart' && ctx =~ '\U')) ? true : false
 46 |     var Ignorecase = (s) => ignorecase ? s->tolower() : s
 47 |     labels = letters->copy()
 48 |     locations = []
 49 | 
 50 |     var [curline, curcol] = getcurpos()[1 : 2]
 51 |     var lnums = WindowLineNrs()
 52 |     for lnum in lnums
 53 |         if foldclosed(lnum) != -1
 54 |             continue # ignore folded lines
 55 |         endif
 56 |         var line = Ignorecase(getline(lnum))
 57 |         var col = line->stridx(ctx)
 58 |         while col != -1
 59 |             col += 1 # column numbers start from 1
 60 |             if ctx == ' ' && !locations->empty() && locations[-1] == [lnum, col - 1]
 61 |                 locations[-1][1] = col # one target per cluster of adjacent spaces
 62 |             elseif [lnum, col] != [curline, curcol] # no target on cursor position
 63 |                 locations->add([lnum, col])
 64 |                 if filter_label && col < line->len()
 65 |                     # remove character next to ctx from label chars
 66 |                     var idx = labels->stridx(line[col])
 67 |                     if idx != -1
 68 |                         labels = $'{labels->slice(0, idx)}{labels->slice(idx + 1)}'
 69 |                     endif
 70 |                 endif
 71 |             endif
 72 |             col = line->stridx(ctx, col)
 73 |         endwhile
 74 |         if lnum == curline # prioritize based on distance from cursor
 75 |             locations->sort((x, y) => abs(x[1] - curcol) - abs(y[1] - curcol))
 76 |         endif
 77 |     endfor
 78 | enddef
 79 | 
 80 | # order locations list by keeping more locations near cursor, and at least one per line
 81 | def Prioritize()
 82 |     var [lstart, lend] = [line('w0'), line('w$')] # lines on screen start/end
 83 |     var highpri = []
 84 |     var lowpri = []
 85 |     var expected = locations->len()
 86 |     var curline = line('.')
 87 |     def FilterLocations(tlinenr: number, tmax: number)
 88 |         if tlinenr < lstart || tlinenr > lend
 89 |             return
 90 |         endif
 91 |         var curlocations = locations->copy()->filter((_, v) => v[0] == tlinenr)
 92 |         locations->filter((_, v) => v[0] != tlinenr)
 93 |         highpri->extend(curlocations->slice(0, tmax))
 94 |         lowpri->extend(curlocations->slice(tmax))
 95 |     enddef
 96 | 
 97 |     FilterLocations(curline, 10) # 10 locations max
 98 |     if locations->len() > (lend - lstart)
 99 |         var excess = locations->len() - (lend - lstart)
100 |         FilterLocations(curline + 1, excess / 3)
101 |         FilterLocations(curline - 1, excess / 3)
102 |     endif
103 |     # at least one target per line
104 |     for p in range(locations->len())
105 |         if locations[p][0] != locations[p - 1][0]
106 |             highpri->add(locations[p])
107 |         else
108 |             lowpri->add(locations[p])
109 |         endif
110 |     endfor
111 |     # shuffle the remaining low priority locations
112 |     lowpri = lowpri->mapnew((_, v) => [v, rand()])->sort((a, b) => a[1] < b[1] ? 0 : 1)->mapnew((_, v) => v[0])
113 |     locations = highpri + lowpri
114 |     # error check
115 |     if expected != locations->len()
116 |         echoe 'EasyJump: Locations list filter error'
117 |     endif
118 |     if locations->copy()->sort()->uniq()->len() != locations->len()
119 |         echoe 'EasyJump: Locations list has duplicates'
120 |     endif
121 | enddef
122 | 
123 | def ShowTag(tag: string, lnum: number, col: number)
124 |     if lnum != -1
125 |         popup_create(tag, {
126 |             line: lnum,
127 |             col: col,
128 |             highlight: 'EasyJump',
129 |             wrap: false,
130 |             zindex: 50 - 1,
131 |         })
132 |     endif
133 | enddef
134 | 
135 | # NOTE: column number (byte based) is different from screen column when tab or
136 | # utf-8 chars are present. chars like ぬ, і, etc. are 3-byte and double wide.
137 | # popup_create() expects screen column while what we have is byte column. Use
138 | # screenpos() with synconcealed(), or wincol() which requires :redraw and is slow.
139 | # Vim bug: https://github.com/vim/vim/issues/14640
140 | # concealed characters, set by matchadd() are not accounted for.
141 | # https://github.com/vim/vim/issues/14643
142 | 
143 | def ScreenPos(lnum: number, col: number): list<number>
144 |     var is_invisible = {row: 0, col: 0, endcol: 0, curscol: 0}
145 |     var scrpos = win_getid()->screenpos(lnum, col)
146 |     if scrpos != is_invisible
147 |         # screenpos has no knowledge of concealed or substituted chars
148 |         var concealed_len = 0
149 |         var idx = 1
150 |         while idx < col
151 |             var status = synconcealed(lnum, idx)
152 |             if status[0] == 1  # concealed
153 |                 var spos = win_getid()->screenpos(lnum, idx)
154 |                 var clen = spos.endcol - spos.col + 1
155 |                 if status[1] != null_string  # substitute char present
156 |                     echom status[1]
157 |                     # Vim does not allow/show <tab> as substitute char
158 |                     # utf-8 chars are either 1 cell or 2 cell wide
159 |                     clen -= status[1]->strwidth()  # display width in cells
160 |                 endif
161 |                 concealed_len += clen
162 |                 var line = getline(lnum)
163 |                 idx += line->strcharpart(line->charidx(idx - 1), 1)->len()  # skip by byte width of char
164 |             else
165 |                 idx += 1
166 |             endif
167 |         endwhile
168 |         return [scrpos.row, scrpos.col - concealed_len]
169 |     endif
170 |     return [-1, -1]
171 | enddef
172 | 
173 | def ShowLocations(group: number)
174 |     try
175 |         popup_clear()
176 |         var ntags = labels->len()
177 |         for idx in range(min([ntags, locations->len() - group * ntags]))
178 |             var [lnum, col] = locations[idx + group * ntags]
179 |             var [scrlnum, scrcol] = ScreenPos(lnum, col)
180 |             if scrlnum != -1
181 |                 ShowTag(labels[idx], scrlnum, scrcol)
182 |             endif
183 |         endfor
184 |     finally
185 |         :redraw
186 |     endtry
187 | enddef
188 | 
189 | def JumpTo(tgt: string, group: number)
190 |     var tagidx = labels->stridx(tgt)
191 |     var locidx = tagidx + group * labels->len()
192 |     if tagidx != -1 && locidx < locations->len()
193 |         var loc = locations[locidx]
194 |         :normal! m'
195 |         cursor(loc)
196 |     endif
197 |     popup_clear()
198 | enddef
199 | 
200 | def GroupCount(): number
201 |     var ngroups = locations->len() / labels->len() + 1
202 |     ngroups -= (locations->len() % labels->len() == 0) ? 1 : 0
203 |     if ngroups > 1
204 |         Prioritize()
205 |     endif
206 |     return ngroups
207 | enddef
208 | 
209 | # main entry point
210 | export def Jump(two_chars: bool = false)
211 |     var two_chars_mode = two_chars || get(g:, 'easyjump_two_chars', false)
212 |     var ch = (easyjump_case ==? 'icase') ? getcharstr()->tolower() : getcharstr()
213 |     GatherLocations(ch, two_chars_mode)
214 |     if locations->empty()
215 |         return
216 |     endif
217 |     var ngroups = GroupCount()
218 |     var group = 0
219 |     try
220 |         ShowLocations(group)
221 |         var ctx = ch
222 |         ch = getcharstr()
223 |         if two_chars_mode
224 |             if labels->stridx(ch) != -1
225 |                 JumpTo(ch, group)
226 |                 return
227 |             elseif [';', ',', "\<tab>", "\<s-tab>"]->index(ch) != -1 # switch to 1-char mode
228 |                 labels = letters->copy()
229 |                 ngroups = GroupCount()
230 |                 if ngroups == 1
231 |                     ShowLocations(group)
232 |                 endif
233 |             else
234 |                 ctx ..= (easyjump_case ==? 'icase') ? ch->tolower() : ch
235 |                 GatherLocations(ctx)
236 |                 ngroups = GroupCount()
237 |                 ShowLocations(group)
238 |                 ch = getcharstr()
239 |             endif
240 |         endif
241 |         while true
242 |             if [';', ',', "\<tab>", "\<s-tab>"]->index(ch) != -1
243 |                 if ngroups > 1
244 |                     if ch == ';' || ch == "\<tab>"
245 |                         group = (group + 1) % ngroups
246 |                     else
247 |                         group = (group + ngroups - 1) % ngroups
248 |                     endif
249 |                     ShowLocations(group)
250 |                 endif
251 |             else
252 |                 JumpTo(ch, group)
253 |                 break
254 |             endif
255 |             ch = getcharstr()
256 |         endwhile
257 |     finally
258 |         popup_clear()
259 |     endtry
260 | enddef
261 | 


--------------------------------------------------------------------------------
/autoload/vimbits/vim9cmdline.vim:
--------------------------------------------------------------------------------
 1 | vim9script
 2 | 
 3 | export def Vim9cmdlineSet()
 4 |     if get(g:, 'vimbits_vim9cmdline', false)
 5 |         if visualmode() == null_string
 6 |             setcmdline('vim9 ')
 7 |         else
 8 |             setcmdline('vim9 :')
 9 |             visualmode(1)
10 |         endif
11 |         cnoremap        <c-u>    <c-u>vim9<space>
12 |         cnoremap        <c-b>    <c-b><c-right><right>
13 |         cnoremap <expr> <c-w>    getcmdpos() > 6 ? "\<c-w>" : ""
14 |         cnoremap <expr> <c-left> getcmdpos() > 6 ? "\<c-left>" : ""
15 |         cnoremap <expr> <bs>     getcmdpos() > 6 ? "\<bs>" : ""
16 |         cnoremap <expr> <left>   getcmdpos() > 6 ? "\<left>" : ""
17 |     endif
18 | enddef
19 | 
20 | export def Vim9cmdlineUnset()
21 |     if get(g:, 'vimbits_vim9cmdline', false)
22 |         silent! cunmap <c-u>
23 |         silent! cunmap <c-w>
24 |         silent! cunmap <c-b>
25 |         silent! cunmap <c-left>
26 |         silent! cunmap <bs>
27 |         silent! cunmap <left>
28 |     endif
29 | enddef
30 | 


--------------------------------------------------------------------------------
/doc/easyjump.txt:
--------------------------------------------------------------------------------
  1 | *easyjump.txt*		Vim motion on steroids
  2 | 
  3 | Author: Girish (girishji AT gmail DOT com)
  4 | For Vim version 9.0 and above
  5 | 
  6 | ==============================================================================
  7 | CONTENTS                                            *easyjump-contents*
  8 | 
  9 |      1. Overview ................................. |easyjump-overview|
 10 |      2. Features ................................. |easyjump-features|
 11 |      3. Requirements ............................. |easyjump-requirements|
 12 |      4. Installation ............................. |easyjump-installation|
 13 |      5. Configuration ............................ |easyjump-configuration|
 14 | 
 15 | ==============================================================================
 16 | 1. Overview					*easyjump-overview*
 17 | 
 18 | Jump to any location by typing 2 characters.
 19 | 
 20 | Jump: Type `s` and `c` (say) and you'll see new letters (virtual text) appear
 21 | next to all the occurrences of `c`. Type `d` (for instance) and cursor jumps to
 22 | `c` next to `d`.
 23 | 
 24 | Visual Select: To visually select a block of text starting from cursor position
 25 | to some occurrence of `c` type `vsc` and then type the highlighted character
 26 | (say `d`).
 27 | 
 28 | What if there is no letter next to where you want to jump to?~
 29 | 
 30 | This scenario occurs when there aren't enough unique letters available for
 31 | tagging. Simply press `<Tab>` (or `;`), and new tag labels will fill the
 32 | remaining spots. To cycle backwards, press `<S-Tab>` (or `,`).
 33 | 
 34 | Two-Character Mode (New): Activated with `2s` or simply `s` if
 35 | `g:easyjump_two_chars` is configured as `true`.
 36 | - Use `2s` + <character> + <tag_character> to leap to your destination (when a
 37 |   tag character marks the spot).
 38 | - If no tag label is present, type the adjacent character as well, forming
 39 |   `2s` + <character_1> + <character_2> + _tag_character_ to execute the jump.
 40 | 
 41 | ==============================================================================
 42 | 2. Features					*easyjump-features*
 43 | 
 44 | - Mapped to `s` but any other trigger (like `,`) would work.
 45 | - Vim idioms supported. Use `dsxy` to delete, `csxy` to change, `vsxy` to select visually, etc.
 46 | - Jump list (`:jumps`) updated so that you can jump back using `<c-o>`.
 47 | - Does not alter the buffer.
 48 | 
 49 | ==============================================================================
 50 | 3. Requirements					*easyjump-requirements*
 51 | 
 52 | - Vim >= 9.0
 53 | 
 54 | ==============================================================================
 55 | 4. Installation					*easyjump-installation*
 56 | 
 57 | Install using vim-plug (https://github.com/junegunn/vim-plug).
 58 | >
 59 | 	vim9script
 60 | 	plug#begin()
 61 | 	Plug 'girishji/easyjump.vim'
 62 | 	plug#end()
 63 | 
 64 | Alternately,
 65 | >
 66 | 	call plug#begin()
 67 | 	Plug 'girishji/easyjump.vim'
 68 | 	call plug#end()
 69 | 
 70 | Or use Vim's builtin package manager.
 71 | >
 72 | 	$ mkdir -p $HOME/.vim/pack/downloads/opt
 73 | 	$ cd $HOME/.vim/pack/downloads/opt
 74 | 	$ git clone https://github.com/girishji/easyjump.git
 75 | 
 76 | If using builtin package manager, add the following line to your $HOME/.vimrc
 77 | file:
 78 | >
 79 | 	packadd easyjump
 80 | 
 81 | ==============================================================================
 82 | 5. Configuration				*easyjump-configuration*
 83 | 
 84 | Trigger Key~
 85 | 
 86 | By default `s` is the trigger key. To disable it put the following in `.vimrc`
 87 | file. `s` will be restored to Vim original keybinding (`:h s`).
 88 | >
 89 | 	g:easyjump_default_keymap = false
 90 | 
 91 | To make `,` (for example) trigger the jump put the following in `.vimrc` file.
 92 | >
 93 | 	nmap , <Plug>EasyjumpJump;
 94 | 	omap , <Plug>EasyjumpJump;
 95 | 	vmap , <Plug>EasyjumpJump;
 96 | 
 97 | Case~
 98 | 
 99 | The destination character you type is compared against visible buffer text. To
100 | make the search case sensitive (case), insensitive (icase), or smart case
101 | (smart) put the following in `.vimrc`.
102 | >
103 | 	g:easyjump_case = 'smart' # Can be 'case', 'icase', or 'smart'
104 | 
105 | Highlight~
106 | 
107 | The tag letters that appear next to destination locations utilize highlight
108 | group `EasyJump`. It is linked to `MatchParen` by default. Set this group using
109 | `:highlight` command to change colors.
110 | 
111 | Letters~
112 | 
113 | The virtual text letters that appear next to the destination you want to jump
114 | to are prioritized based on distance from the cursor, with at least one letter
115 | per line. The letters appear in the following order of decreasing priority. The
116 | letters and order can be changed by assigning to the following variable.
117 | >
118 | 	g:easyjump_letters =
119 | 		'asdfgwercvhjkluiopynmbtqxzASDFGWERCVHJKLUIOPYNMBTQXZ0123456789'
120 | 
121 | ==============================================================================
122 | 
123 | vim:tw=78:ts=8:noet:ft=help:norl:
124 | 


--------------------------------------------------------------------------------
/doc/fFtT.txt:
--------------------------------------------------------------------------------
 1 | fFtT.txt*	Accurate left-right navigation in Vim
 2 | 
 3 | Author: Girish (girishji AT gmail DOT com)
 4 | For Vim version 9.0 and above
 5 | 
 6 | ==============================================================================
 7 | CONTENTS                                            *fFtT-contents*
 8 | 
 9 |      1. Overview ................................. |fFtT-overview|
10 |      2. Requirements ............................. |fFtT-requirements|
11 |      3. Installation ............................. |fFtT-installation|
12 |      4. Configuration............................. |fFtT-configuration|
13 | 
14 | ==============================================================================
15 | 1. Overview					*fFtT-overview*
16 | 
17 | Characters that are reachable with a single jump are highlighted, while others
18 | are dimmed. This enhancement improves the accuracy of navigation using `f`,
19 | `F`, `t`, and `T` commands. Additionally, you can provide a numerical prefix
20 | (e.g., `3f`), which will only highlight characters that occur the third time
21 | to the right of the cursor, while others are dimmed.
22 | 
23 | This plugin does not remap keys or alter the behavior of commands. It solely
24 | focuses on highlighting relevant characters without making any changes to the
25 | default key mappings. The code consists of less than 100 lines, with
26 | explanatory comments.
27 | 
28 | ==============================================================================
29 | 2. Requirements					*fFtT-requirements*
30 | 
31 | - Vim >= 9.1
32 | 
33 | ==============================================================================
34 | 3. Installation					*fFtT-installation*
35 | 
36 | Install using vim-plug (https://github.com/junegunn/vim-plug)
37 | >
38 | 	vim9script
39 | 	plug#begin()
40 | 	Plug 'girishji/fFtT.vim'
41 | 	plug#end()
42 | 
43 | Legacy script:
44 | >
45 | 	call plug#begin()
46 | 	Plug 'girishji/fFtT.vim'
47 | 	call plug#end()
48 | 
49 | Or use Vim's builtin package manager.
50 | 
51 | ==============================================================================
52 | 4. Configuration				*fFtT-configuration*
53 | 
54 | The appearance of characters that are unreachable within one jump is
55 | determined by the highlight group `FfTtSubtle`, which is linked to the
56 | `Comment` group by default.
57 | 
58 | ==============================================================================
59 | 
60 | vim:tw=78:ts=8:noet:ft=help:norl:
61 | 


--------------------------------------------------------------------------------
/doc/tags:
--------------------------------------------------------------------------------
 1 | /Content.IE?/	vimtips.txt	/*\/Content.IE?\/*
 2 | easyjump-configuration	easyjump.txt	/*easyjump-configuration*
 3 | easyjump-contents	easyjump.txt	/*easyjump-contents*
 4 | easyjump-features	easyjump.txt	/*easyjump-features*
 5 | easyjump-installation	easyjump.txt	/*easyjump-installation*
 6 | easyjump-overview	easyjump.txt	/*easyjump-overview*
 7 | easyjump-requirements	easyjump.txt	/*easyjump-requirements*
 8 | easyjump.txt	easyjump.txt	/*easyjump.txt*
 9 | fFtT-configuration	fFtT.txt	/*fFtT-configuration*
10 | fFtT-contents	fFtT.txt	/*fFtT-contents*
11 | fFtT-installation	fFtT.txt	/*fFtT-installation*
12 | fFtT-overview	fFtT.txt	/*fFtT-overview*
13 | fFtT-requirements	fFtT.txt	/*fFtT-requirements*
14 | vimtips-absolutely-essential	vimtips.txt	/*vimtips-absolutely-essential*
15 | vimtips-global	vimtips.txt	/*vimtips-global*
16 | vimtips-global-combined-with-substitute	vimtips.txt	/*vimtips-global-combined-with-substitute*
17 | vimtips-searching	vimtips.txt	/*vimtips-searching*
18 | vimtips-substitution	vimtips.txt	/*vimtips-substitution*
19 | vimtips.txt	vimtips.txt	/*vimtips.txt*
20 | 


--------------------------------------------------------------------------------
/doc/vimtips.txt:
--------------------------------------------------------------------------------
   1 | *vimtips.txt*   For Vim version 8.0.
   2 | David Rayner (zzapper) 15 Years of Vi + 7 years of Vim and still learning
   3 | ------------------------------------------------------------------------------
   4 | " new items marked [N] , corrected items marked [C]
   5 | " *vimtips-searching*
   6 | /joe/e                      : cursor set to End of match
   7 | 3/joe/e+1                   : find 3rd joe cursor set to End of match plus 1 [C]
   8 | /joe/s-2                    : cursor set to Start of match minus 2
   9 | /joe/+3                     : find joe move cursor 3 lines down
  10 | /^joe.*fred.*bill/          : find joe AND fred AND Bill (Joe at start of line)
  11 | /^[A-J]/                    : search for lines beginning with one or more A-J
  12 | /begin\_.*end               : search over possible multiple lines
  13 | /fred\_s*joe/               : any whitespace including newline [C]
  14 | /fred\|joe                  : Search for FRED OR JOE
  15 | /.*fred\&.*joe              : Search for FRED AND JOE in any ORDER!
  16 | /\<fred\>/                  : search for fred but not alfred or frederick [C]
  17 | /\<\d\d\d\d\>               : Search for exactly 4 digit numbers
  18 | /\D\d\d\d\d\D               : Search for exactly 4 digit numbers
  19 | /\<\d\{4}\>                 : same thing
  20 | /\([^0-9]\|^\)%.*%          : Search for absence of a digit or beginning of line
  21 | " finding empty lines
  22 | /^\n\{3}                    : find 3 empty lines
  23 | /^str.*\nstr                : find 2 successive lines starting with str
  24 | /\(^str.*\n\)\{2}           : find 2 successive lines starting with str
  25 | " using regexp memory in a search find fred.*joe.*joe.*fred 
  26 | /\(fred\).*\(joe\).*\2.*\1
  27 | " Repeating the Regexp (rather than what the Regexp finds)
  28 | /^\([^,]*,\)\{8}
  29 | " visual searching
  30 | :vmap // y/<C-R>"<CR>       : search for visually highlighted text
  31 | :vmap <silent> //    y/<C-R>=escape(@", '\\/.*$^~[]')<CR><CR> : with spec chars
  32 | " \zs and \ze regex delimiters :h /\zs
  33 | /<\zs[^>]*\ze>              : search for tag contents, ignoring chevrons
  34 | " zero-width :h /\@=
  35 | /<\@<=[^>]*>\@=             : search for tag contents, ignoring chevrons
  36 | /<\@<=\_[^>]*>\@=           : search for tags across possible multiple lines
  37 | " searching over multiple lines \_ means including newline
  38 | /<!--\_p\{-}-->                   : search for multiple line comments
  39 | /fred\_s*joe/                     : any whitespace including newline
  40 | /bugs\(\_.\)*bunny                : bugs followed by bunny anywhere in file
  41 | :h \_                             : help
  42 | " search for declaration of subroutine/function under cursor
  43 | :nmap gx yiw/^\(sub\<bar>function\)\s\+<C-R>"<CR>
  44 | " multiple file search/operations
  45 | :bufdo /searchstr/                : use :rewind to recommence search
  46 | " multiple file search better but cheating
  47 | :bufdo %s/searchstr/&/gic   : say n and then a to stop
  48 | :bufdo execute "normal! @a" | w   : execute macro a over all buffers [N]
  49 | :bufdo exe ":normal Gp" | update : Paste to the end of each buffer [N]
  50 | :argdo exe '%!sort' | w [N]
  51 | " How to search for a URL without backslashing
  52 | ?http://www.vim.org/        : (first) search BACKWARDS!!! clever huh!
  53 | " Specify what you are NOT searching for (vowels)
  54 | /\c\v([^aeiou]&\a){4}       : search for 4 consecutive consonants
  55 | /\%>20l\%<30lgoat           : Search for goat between lines 20 and 30 [N]
  56 | /^.\{-}home.\{-}\zshome/e   : match only the 2nd occurence in a line of "home" [
  57 | N]
  58 | :%s/home.\{-}\zshome/alone  : Substitute only the 2nd occurrence of home in any
  59 | line [U]
  60 | :%s/.*\zsone/two/           : Substitute only the LAST occurrence of one [N]
  61 | " find str but not on lines containing tongue
  62 | ^\(.*tongue.*\)\@!.*nose.*$
  63 | \v^((tongue)@!.)*nose((tongue)@!.)*$
  64 | .*nose.*\&^\%(\%(tongue\)\@!.\)*$
  65 | :v/tongue/s/nose/&/gic
  66 | 'a,'bs/extrascost//gc       : trick: restrict search to between markers (answer
  67 | n) [N]
  68 | /integ<C-L>                 : Control-L to complete search term [N]
  69 | "----------------------------------------
  70 | " *vimtips-substitution*
  71 | :s/foo/\rfoo/g              : \r will substitute a newline
  72 | :%s/fred/joe/igc            : general substitute command
  73 | :%s//joe/igc                : Substitute what you last searched for [N]
  74 | :%s/~/sue/igc               : Substitute your last replacement string [N]
  75 | :%s/\r//g                   : Delete DOS returns ^M
  76 | " Is your Text File jumbled onto one line? use following
  77 | :%s/\r/\r/g                 : Turn DOS returns ^M into real returns
  78 | :%s=  *$==                  : delete end of line blanks
  79 | :%s= \+$==                  : Same thing
  80 | :%s#\s*\r\?$##              : Clean both trailing spaces AND DOS returns
  81 | :%s#\s*\r*$##               : same thing
  82 | " deleting empty lines
  83 | :%s/^\n\{3}//               : delete blocks of 3 empty lines
  84 | :%s/^\n\+/\r/               : compressing empty lines
  85 | :%s#<[^>]\+>##g             : delete html tags, leave text (non-greedy)
  86 | :%s#<\_.\{-1,}>##g          : delete html tags possibly multi-line (non-greedy)
  87 | :%s#.*\(\d\+hours\).*#\1#   : Delete all but memorised string (\1) [N]
  88 | " parse xml/soap
  89 | %s#><\([^/]\)#>\r<\1#g      : split jumbled up XML file into one tag per line [N
  90 | ]
  91 | %s/</\r&/g                  : simple split of html/xml/soap  [N]
  92 | :%s#<[^/]#\r&#gic           : simple split of html/xml/soap  but not closing tag
  93 |  [N]
  94 | :%s#<[^/]#\r&#gi            : parse on open xml tag [N]
  95 | :%s#\[\d\+\]#\r&#g          : parse on numbered array elements [1] [N]
  96 | ggVGgJ                      : rejoin XML without extra spaces (gJ) [N]
  97 | %s=\\n#\d=\r&=g             : parse PHP error stack [N]
  98 | :%s#^[^\t]\+\t##            : Delete up to and including first tab [N]
  99 | " VIM Power Substitute
 100 | :'a,'bg/fred/s/dick/joe/igc : VERY USEFUL
 101 | " duplicating columns
 102 | :%s= [^ ]\+$=&&=            : duplicate end column
 103 | :%s= \f\+$=&&=              : Dupicate filename
 104 | :%s= \S\+$=&&               : usually the same
 105 | " memory
 106 | :%s#example#& = &#gic        : duplicate entire matched string [N]
 107 | :%s#.*\(tbl_\w\+\).*#\1#    : extract list of all strings tbl_* from text  [NC]
 108 | :s/\(.*\):\(.*\)/\2 : \1/   : reverse fields separated by :
 109 | :%s/^\(.*\)\n\1$/\1/        : delete duplicate lines
 110 | :%s/^\(.*\)\(\n\1\)\+$/\1/  : delete multiple duplicate lines [N]
 111 | " non-greedy matching \{-}
 112 | :%s/^.\{-}pdf/new.pdf/      : delete to 1st occurence of pdf only (non-greedy)
 113 | %s#^.\{-}\([0-9]\{3,4\}serial\)#\1#gic : delete up to 123serial or 1234serial [N
 114 | ]
 115 | " use of optional atom \?
 116 | :%s#\<[zy]\?tbl_[a-z_]\+\>#\L&#gc : lowercase with optional leading characters
 117 | " over possibly many lines
 118 | :%s/<!--\_.\{-}-->//        : delete possibly multi-line comments
 119 | :help /\{-}                 : help non-greedy
 120 | " substitute using a register
 121 | :s/fred/<c-r>a/g            : sub "fred" with contents of register "a"
 122 | :s/fred/<c-r>asome_text<c-r>s/g
 123 | :s/fred/\=@a/g              : better alternative as register not displayed (not
 124 | *) [C]
 125 | :s/fred/\=@*/g              : replace string with contents of paste register [N]
 126 | " multiple commands on one line
 127 | :%s/\f\+\.gif\>/\r&\r/g | v/\.gif$/d | %s/gif/jpg/
 128 | :%s/a/but/gie|:update|:next : then use @: to repeat
 129 | " ORing
 130 | :%s/goat\|cow/sheep/gc      : ORing (must break pipe)
 131 | :'a,'bs#\[\|\]##g           : remove [] from lines between markers a and b [N]
 132 | :%s/\v(.*\n){5}/&\r         : insert a blank line every 5 lines [N]
 133 | " Calling a VIM function
 134 | :s/__date__/\=strftime("%c")/ : insert datestring
 135 | :inoremap \zd <C-R>=strftime("%d%b%y")<CR>    : insert date eg 31Jan11 [N]
 136 | " Working with Columns sub any str1 in col3
 137 | :%s:\(\(\w\+\s\+\)\{2}\)str1:\1str2:
 138 | " Swapping first & last column (4 columns)
 139 | :%s:\(\w\+\)\(.*\s\+\)\(\w\+\)$:\3\2\1:
 140 | " format a mysql query
 141 | :%s#\<from\>\|\<where\>\|\<left join\>\|\<\inner join\>#\r&#g
 142 | " filter all form elements into paste register
 143 | :redir @*|sil exec 'g#<\(input\|select\|textarea\|/\=form\)\>#p'|redir END
 144 | :nmap ,z :redir @*<Bar>sil exec 'g@<\(input\<Bar>select\<Bar>textarea\<Bar>/\=fo
 145 | rm\)\>@p'<Bar>redir END<CR>
 146 | " substitute string in column 30 [N]
 147 | :%s/^\(.\{30\}\)xx/\1yy/
 148 | " decrement numbers by 3
 149 | :%s/\d\+/\=(submatch(0)-3)/
 150 | " increment numbers by 6 on certain lines only
 151 | :g/loc\|function/s/\d/\=submatch(0)+6/
 152 | " better
 153 | :%s#txtdev\zs\d#\=submatch(0)+1#g
 154 | :h /\zs
 155 | " increment only numbers gg\d\d  by 6 (another way)
 156 | :%s/\(gg\)\@<=\d\+/\=submatch(0)+6/
 157 | :h zero-width
 158 | " rename a string with an incrementing number
 159 | :let i=10 | 'a,'bg/Abc/s/yy/\=i/ |let i=i+1 # convert yy to 10,11,12 etc
 160 | " as above but more precise
 161 | :let i=10 | 'a,'bg/Abc/s/xx\zsyy\ze/\=i/ |let i=i+1 # convert xxyy to xx11,xx12,
 162 | xx13
 163 | " find replacement text, put in memory, then use \zs to simplify substitute
 164 | :%s/"\([^.]\+\).*\zsxx/\1/
 165 | " Pull word under cursor into LHS of a substitute
 166 | :nmap <leader>z :%s#\<<c-r>=expand("<cword>")<cr>\>#
 167 | " Pull Visually Highlighted text into LHS of a substitute
 168 | :vmap <leader>z :<C-U>%s/\<<c-r>*\>/
 169 | " substitute singular or plural
 170 | :'a,'bs/bucket\(s\)*/bowl\1/gic   [N]
 171 | ----------------------------------------
 172 | " all following performing similar task, substitute within substitution
 173 | " Multiple single character substitution in a portion of line only
 174 | :%s,\(all/.*\)\@<=/,_,g     : replace all / with _ AFTER "all/"
 175 | " Same thing
 176 | :s#all/\zs.*#\=substitute(submatch(0), '/', '_', 'g')#
 177 | " Substitute by splitting line, then re-joining
 178 | :s#all/#&^M#|s#/#_#g|-j!
 179 | " Substitute inside substitute
 180 | :%s/.*/\='cp '.submatch(0).' all/'.substitute(submatch(0),'/','_','g')/
 181 | ----------------------------------------
 182 | " *vimtips-global* command
 183 | :g/gladiolli/#              : display with line numbers (YOU WANT THIS!)
 184 | :g/fred.*joe.*dick/         : display all lines fred,joe & dick
 185 | :g/\<fred\>/                : display all lines fred but not freddy
 186 | :g/^\s*$/d                  : delete all blank lines
 187 | :g!/^dd/d                   : delete lines not containing string
 188 | :v/^dd/d                    : delete lines not containing string
 189 | :g/joe/,/fred/d             : not line based (very powerfull)
 190 | :g/fred/,/joe/j             : Join Lines [N]
 191 | :g/-------/.-10,.d          : Delete string & 10 previous lines
 192 | :g/{/ ,/}/- s/\n\+/\r/g     : Delete empty lines but only between {...}
 193 | :v/\S/d                     : Delete empty lines (and blank lines ie whitespace)
 194 | :v/./,/./-j                 : compress empty lines
 195 | :g/^$/,/./-j                : compress empty lines
 196 | :g/<input\|<form/p          : ORing
 197 | :g/^/put_                   : double space file (pu = put)
 198 | :g/^/m0                     : Reverse file (m = move)
 199 | :g/^/m$                     : No effect! [N]
 200 | :'a,'bg/^/m'b               : Reverse a section a to b
 201 | :g/^/t.                     : duplicate every line
 202 | :g/fred/t$                  : copy (transfer) lines matching fred to EOF
 203 | :g/stage/t'a                : copy (transfer) lines matching stage to marker a (
 204 | cannot use .) [C]
 205 | :g/^Chapter/t.|s/./-/g      : Automatically underline selecting headings [N]
 206 | :g/\(^I[^^I]*\)\{80}/d      : delete all lines containing at least 80 tabs
 207 | " perform a substitute on every other line
 208 | :g/^/ if line('.')%2|s/^/zz /
 209 | " match all lines containing "somestr" between markers a & b
 210 | " copy after line containing "otherstr"
 211 | :'a,'bg/somestr/co/otherstr/ : co(py) or mo(ve)
 212 | " as above but also do a substitution
 213 | :'a,'bg/str1/s/str1/&&&/|mo/str2/
 214 | :%norm jdd                  : delete every other line
 215 | " incrementing numbers (type <c-a> as 5 characters)
 216 | :.,$g/^\d/exe "norm! \<c-a>": increment numbers
 217 | :'a,'bg/\d\+/norm! ^A       : increment numbers
 218 | " storing glob results (note must use APPEND) you need to empty reg a first with
 219 |  qaq.
 220 | "save results to a register/paste buffer
 221 | :g/fred/y A                 : append all lines fred to register a
 222 | :g/fred/y A | :let @*=@a    : put into paste buffer
 223 | :g//y A | :let @*=@a    : put into paste buffer # better reuses last g// [N]
 224 | :g//y A | :let @*=@a    : put last glob into paste buffer [N]
 225 | :let @a=''|g/Barratt/y A |:let @*=@a
 226 | " filter lines to a file (file must already exist)
 227 | :'a,'bg/^Error/ . w >> errors.txt
 228 | " duplicate every line in a file wrap a print '' around each duplicate
 229 | :g/./yank|put|-1s/'/"/g|s/.*/Print '&'/
 230 | " replace string with contents of a file, -d deletes the "mark"
 231 | :g/^MARK$/r tmp.txt | -d
 232 | " display prettily
 233 | :g/<pattern>/z#.5           : display with context
 234 | :g/<pattern>/z#.5|echo "=========="  : display beautifully
 235 | " Combining g// with normal mode commands
 236 | :g/|/norm 2f|r*                      : replace 2nd | with a star
 237 | "send output of previous global command to a new window
 238 | :nmap <F3>  :redir @a<CR>:g//<CR>:redir END<CR>:new<CR>:put! a<CR><CR>
 239 | ----------------------------------------
 240 | " *vimtips-global-combined-with-substitute* (*power-editing*)
 241 | :'a,'bg/fred/s/joe/susan/gic :  can use memory to extend matching
 242 | :/fred/,/joe/s/fred/joe/gic :  non-line based (ultra)
 243 | :/biz/,/any/g/article/s/wheel/bucket/gic:  non-line based [N]
 244 | ----------------------------------------
 245 | " Find fred before beginning search for joe [N]
 246 | /fred/;/joe/
 247 | " Find fred before beginning search for joe then substitute [N]
 248 | :/fred/;/joe/-2,/sid/+3s/sally/alley/gIC
 249 | ----------------------------------------
 250 | " create a new file for each line of file eg 1.txt,2.txt,3,txt etc
 251 | :g/^/exe ".w ".line(".").".txt"
 252 | ----------------------------------------
 253 | " chain an external command
 254 | :.g/^/ exe ".!sed 's/N/X/'" | s/I/Q/    [N]
 255 | ----------------------------------------
 256 | " Operate until string found [N]
 257 | d/fred/                                :delete until fred
 258 | y/fred/                                :yank until fred
 259 | c/fred/e                               :change until fred end
 260 | v12|                                   : visualise/change/delete to column 12 [N
 261 | ]
 262 | ----------------------------------------
 263 | " Summary of editing repeats [N]
 264 | .      last edit (magic dot)
 265 | :&     last substitute
 266 | :%&    last substitute every line
 267 | :%&gic last substitute every line confirm
 268 | g%     normal mode repeat last substitute
 269 | g&     last substitute on all lines
 270 | @@     last recording
 271 | @:     last command-mode command
 272 | :!!    last :! command
 273 | :~     last substitute
 274 | :help repeating
 275 | ----------------------------------------
 276 | " Summary of repeated searches
 277 | ;      last f, t, F or T
 278 | ,      last f, t, F or T in opposite direction
 279 | n      last / or ? search
 280 | N      last / or ? search in opposite direction
 281 | ----------------------------------------
 282 | " *vimtips-absolutely-essential*
 283 | ----------------------------------------
 284 | * # g* g#           : find word under cursor (<cword>) (forwards/backwards)
 285 | %                   : match brackets {}[]()
 286 | .                   : repeat last modification
 287 | @:                  : repeat last : command (then @@)
 288 | matchit.vim         : % now matches tags <tr><td><script> <?php etc
 289 | <C-N><C-P>          : word completion in insert mode
 290 | <C-X><C-L>          : Line complete SUPER USEFUL
 291 | /<C-R><C-W>         : Pull <cword> onto search/command line
 292 | /<C-R><C-A>         : Pull <CWORD> onto search/command line
 293 | :set ignorecase     : you nearly always want this
 294 | :set smartcase      : overrides ignorecase if uppercase used in search string (c
 295 | ool)
 296 | :syntax on          : colour syntax in Perl,HTML,PHP etc
 297 | :set syntax=perl    : force syntax (usually taken from file extension)
 298 | :syntax sync fromstart  : Fix syntax highlighting [N]
 299 | :h regexp<C-D>      : type control-D and get a list all help topics containing
 300 |                       regexp (plus use TAB to Step thru list)
 301 | ----------------------------------------
 302 | " MAKE IT EASY TO UPDATE/RELOAD _vimrc
 303 | :nmap ,s :source $VIM/_vimrc
 304 | :nmap ,v :e $VIM/_vimrc
 305 | :e $MYVIMRC         : edits your _vimrc whereever it might be  [N]
 306 | " How to have a variant in your .vimrc for different PCs [N]
 307 | if $COMPUTERNAME == "NEWPC"
 308 | ab mypc vista
 309 | else
 310 | ab mypc dell25
 311 | endif
 312 | ----------------------------------------
 313 | " splitting windows
 314 | :vsplit other.php       # vertically split current file with other.php [N]
 315 | ----------------------------------------
 316 | "VISUAL MODE (easy to add other HTML Tags)
 317 | :vmap sb "zdi<b><C-R>z</b><ESC>  : wrap <b></b> around VISUALLY selected Text
 318 | :vmap st "zdi<?= <C-R>z ?><ESC>  : wrap <?=   ?> around VISUALLY selected Text
 319 | ----------------------------------------
 320 | "vim 7 tabs
 321 | vim -p fred.php joe.php             : open files in tabs
 322 | :tabe fred.php                      : open fred.php in a new tab
 323 | :tab ball                           : tab open files
 324 | :close                              : close a tab but leave the buffer
 325 | " vim 7 forcing use of tabs from .vimrc
 326 | :nnoremap gf <C-W>gf
 327 | :cab      e  tabe
 328 | :tab sball                           : retab all files in buffer (repair) [N]
 329 | ----------------------------------------
 330 | " Exploring
 331 | :e .                            : file explorer
 332 | :Exp(lore)                      : file explorer note capital Ex
 333 | :Sex(plore)                     : file explorer in split window
 334 | :browse e                       : windows style browser
 335 | :ls                             : list of buffers
 336 | :cd ..                          : move to parent directory
 337 | :args                           : list of files
 338 | :pwd                            : Print Working Directory (current directory) [N
 339 | ]
 340 | :args *.php                     : open list of files (you need this!)
 341 | :lcd %:p:h                      : change to directory of current file
 342 | :cd  %:p:h                      : change to directory of current file [N]
 343 | :autocmd BufEnter * lcd %:p:h   : change to directory of current file automatica
 344 | lly (put in _vimrc)
 345 | ----------------------------------------
 346 | " Changing Case
 347 | guu                             : lowercase line
 348 | gUU                             : uppercase line
 349 | Vu                              : lowercase line
 350 | VU                              : uppercase line
 351 | g~~                             : flip case line
 352 | vEU                             : Upper Case Word
 353 | vE~                             : Flip Case Word
 354 | ggguG                           : lowercase entire file
 355 | " Titlise Visually Selected Text (map for .vimrc)
 356 | vmap ,c :s/\<\(.\)\(\k*\)\>/\u\1\L\2/g<CR>
 357 | " Title Case A Line Or Selection (better)
 358 | vnoremap <F6> :s/\%V\<\(\w\)\(\w*\)\>/\u\1\L\2/ge<cr> [N]
 359 | " titlise a line
 360 | nmap ,t :s/.*/\L&/<bar>:s/\<./\u&/g<cr>  [N]
 361 | " Uppercase first letter of sentences
 362 | :%s/[.!?]\_s\+\a/\U&\E/g
 363 | ----------------------------------------
 364 | gf                              : open file name under cursor (SUPER)
 365 | :nnoremap gF :view <cfile><cr>  : open file under cursor, create if necessary
 366 | ga                              : display hex,ascii value of char under cursor
 367 | ggVGg?                          : rot13 whole file
 368 | ggg?G                           : rot13 whole file (quicker for large file)
 369 | :8 | normal VGg?                : rot13 from line 8
 370 | :normal 10GVGg?                 : rot13 from line 8
 371 | <C-A>,<C-X>                     : increment,decrement number under cursor
 372 |                                   win32 users must remap CNTRL-A
 373 | <C-R>=5*5                       : insert 25 into text (mini-calculator)
 374 | ----------------------------------------
 375 | " Make all other tips superfluous
 376 | :h 42            : also http://www.google.com/search?q=42
 377 | :h holy-grail
 378 | :h!
 379 | ----------------------------------------
 380 | " disguise text (watch out) [N]
 381 | ggVGg?                          : rot13 whole file (toggles)
 382 | :set rl!                        : reverse lines right to left (toggles)
 383 | :g/^/m0                         : reverse lines top to bottom (toggles)
 384 | :%s/\(\<.\{-}\>\)/\=join(reverse(split(submatch(1), '.\zs')), '')/g   : reverse
 385 | all text
 386 | ----------------------------------------
 387 | " History, Markers & moving about (what Vim Remembers) [C]
 388 | '.               : jump to last modification line (SUPER)
 389 | `.               : jump to exact spot in last modification line
 390 | g;               : cycle thru recent changes (oldest first)
 391 | g,               : reverse direction
 392 | :changes
 393 | :h changelist    : help for above
 394 | <C-O>            : retrace your movements in file (starting from most recent)
 395 | <C-I>            : retrace your movements in file (reverse direction)
 396 | :ju(mps)         : list of your movements
 397 | :help jump-motions
 398 | :history         : list of all your commands
 399 | :his c           : commandline history
 400 | :his s           : search history
 401 | q/               : Search history Window (puts you in full edit mode) (exit CTRL
 402 | -C)
 403 | q:               : commandline history Window (puts you in full edit mode) (exit
 404 |  CTRL-C)
 405 | :<C-F>           : history Window (exit CTRL-C)
 406 | ----------------------------------------
 407 | " Abbreviations & Maps
 408 | " Maps are commands put onto keys, abbreviations expand typed text [N]
 409 | " Following 4 maps enable text transfer between VIM sessions
 410 | :map   <f7>   :'a,'bw! c:/aaa/x       : save text to file x
 411 | :map   <f8>   :r c:/aaa/x             : retrieve text
 412 | :map   <f11>  :.w! c:/aaa/xr<CR>      : store current line
 413 | :map   <f12>  :r c:/aaa/xr<CR>        : retrieve current line
 414 | :ab php          : list of abbreviations beginning php
 415 | :map ,           : list of maps beginning ,
 416 | " allow use of F10 for mapping (win32)
 417 | set wak=no       : :h winaltkeys
 418 | " For use in Maps
 419 | <CR>             : carriage Return for maps
 420 | <ESC>            : Escape
 421 | <LEADER>         : normally \
 422 | <BAR>            : | pipe
 423 | <BACKSPACE>      : backspace
 424 | <SILENT>         : No hanging shell window
 425 | "display RGB colour under the cursor eg #445588
 426 | :nmap <leader>c :hi Normal guibg=#<c-r>=expand("<cword>")<cr><cr>
 427 | map <f2> /price only\\|versus/ :in a map need to backslash the \
 428 | " type table,,, to get <table></table>       ### Cool ###
 429 | imap ,,, <esc>bdwa<<esc>pa><cr></<esc>pa><esc>kA
 430 | " list current mappings of all your function keys
 431 | :for i in range(1, 12) | execute("map <F".i.">") | endfor   [N]
 432 | " for your .vimrc
 433 | :cab ,f :for i in range(1, 12) \| execute("map <F".i.">") \| endfor
 434 | "chain commands in abbreviation
 435 | cabbrev vrep tabe class.inc \| tabe report.php   ## chain commands [N]
 436 | ----------------------------------------
 437 | " Simple PHP debugging display all variables yanked into register a
 438 | iab phpdb exit("<hr>Debug <C-R>a  ");
 439 | ----------------------------------------
 440 | " Using a register as a map (preload registers in .vimrc)
 441 | :let @m=":'a,'bs/"
 442 | :let @s=":%!sort -u"
 443 | ----------------------------------------
 444 | " Useful tricks
 445 | "ayy@a           : execute "Vim command" in a text file
 446 | yy@"             : same thing using unnamed register
 447 | u@.              : execute command JUST typed in
 448 | "ddw             : store what you delete in register d [N]
 449 | "ccaw            : store what you change in register c [N]
 450 | ----------------------------------------
 451 | " Get output from other commands (requires external programs)
 452 | :r!ls -R         : reads in output of ls
 453 | :put=glob('**')  : same as above                 [N]
 454 | :r !grep "^ebay" file.txt  : grepping in content   [N]
 455 | :0r!sed -n 2,8p test.txt : sed in some text  [N]
 456 | :20,25 !rot13    : rot13 lines 20 to 25   [N]
 457 | !!date           : same thing (but replaces/filters current line)
 458 | " Sorting with external sort
 459 | :%!sort -u       : use an external program to filter content
 460 | :'a,'b!sort -u   : use an external program to filter content
 461 | !1} sort -u      : sorts paragraph (note normal mode!!)
 462 | :g/^$/;/^$/-1!sort : Sort each block (note the crucial ;)
 463 | " Sorting with internal sort
 464 | :sort /.*\%2v/   : sort all lines on second column [N]
 465 | " number lines  (linux or cygwin only)
 466 | :new | r!nl #                  [N]
 467 | ----------------------------------------
 468 | " Multiple Files Management (Essential)
 469 | :bn              : goto next buffer
 470 | :bp              : goto previous buffer
 471 | :wn              : save file and move to next (super)
 472 | :wp              : save file and move to previous
 473 | :bd              : remove file from buffer list (super)
 474 | :bun             : Buffer unload (remove window but not from list)
 475 | :badd file.c     : file from buffer list
 476 | :b3              : go to buffer 3 [C]
 477 | :b main          : go to buffer with main in name eg main.c (ultra)
 478 | :sav php.html    : Save current file as php.html and "move" to php.html
 479 | :sav! %<.bak     : Save Current file to alternative extension (old way)
 480 | :sav! %:r.cfm    : Save Current file to alternative extension
 481 | :sav %:s/fred/joe/           : do a substitute on file name
 482 | :sav %:s/fred/joe/:r.bak2    : do a substitute on file name & ext.
 483 | :!mv % %:r.bak   : rename current file (DOS use Rename or DEL)
 484 | :help filename-modifiers
 485 | :e!              : return to unmodified file
 486 | :w c:/aaa/%      : save file elsewhere
 487 | :e #             : edit alternative file (also cntrl-^)
 488 | :rew             : return to beginning of edited files list (:args)
 489 | :brew            : buffer rewind
 490 | :sp fred.txt     : open fred.txt into a split
 491 | :sball,:sb       : Split all buffers (super)
 492 | :scrollbind      : in each split window
 493 | :map   <F5> :ls<CR>:e # : Pressing F5 lists all buffer, just type number
 494 | :set hidden      : Allows to change buffer w/o saving current buffer
 495 | :w !sudo tee %   : Write to read only file on linux (trick) will ask for passwor
 496 | d [N]
 497 | ----------------------------------------
 498 | " Quick jumping between splits
 499 | map <C-J> <C-W>j<C-W>_
 500 | map <C-K> <C-W>k<C-W>_
 501 | ----------------------------------------
 502 | " Recording (BEST Feature of ALL)
 503 | qq  # record to q
 504 | your complex series of commands
 505 | q   # end recording
 506 | @q to execute
 507 | @@ to Repeat
 508 | 5@@ to Repeat 5 times
 509 | qQ@qq                             : Make an existing recording q recursive [N]
 510 | " editing a register/recording
 511 | "qp                               :display contents of register q (normal mode)
 512 | <ctrl-R>q                         :display contents of register q (insert mode)
 513 | " you can now see recording contents, edit as required
 514 | "qdd                              :put changed contacts back into q
 515 | @q                                :execute recording/register q
 516 | " Operating a Recording on a Visual BLOCK (blockwise)
 517 | 1) define recording/register
 518 | qq:s/ to/ from/g^Mq
 519 | 2) Define Visual BLOCK
 520 | V}
 521 | 3) hit : and the following appears
 522 | :'<,'>
 523 | 4)Complete as follows
 524 | :'<,'>norm @q
 525 | ----------------------------------------
 526 | "combining a recording with a map (to end up in command mode)
 527 | "here we operate on a file with a recording, then move to the next file [N]
 528 | :nnoremap ] @q:update<bar>bd
 529 | ----------------------------------------
 530 | " Visual is the newest and usually the most intuitive editing mode
 531 | " Visual basics
 532 | v                               : enter visual mode
 533 | V                               : visual mode whole line
 534 | <C-V>                           : enter VISUAL BLOCKWISE mode (remap on Windows to say C-Q 
 535 | gv                              : reselect last visual area (ultra)
 536 | o                               : navigate visual area
 537 | "*y or "+y                      : yank visual area into paste buffer  [C]
 538 | V%                              : visualise what you match
 539 | V}J                             : Join Visual block (great)
 540 | V}gJ                            : Join Visual block w/o adding spaces
 541 | `[v`]                           : Highlight last insert
 542 | :%s/\%Vold/new/g                : Do a substitute on last visual area [N]
 543 | ----------------------------------------
 544 | " Delete 8th and 9th characters of 10 successive lines [C]
 545 | 08l<c-v>10j2ld  (use Control Q on win32) [C]
 546 | ----------------------------------------
 547 | " how to copy a set of columns using VISUAL BLOCK
 548 | " visual block (AKA columnwise selection) (NOT BY ordinary v command)
 549 | <C-V> then select "column(s)" with motion commands (win32 <C-Q>)
 550 | then c,d,y,r etc
 551 | ----------------------------------------
 552 | " how to overwrite a visual-block of text with another such block [C]
 553 | " move with hjkl etc
 554 | Pick the first block: ctrl-v move y
 555 | Pick the second block: ctrl-v move P <esc>
 556 | ----------------------------------------
 557 | " text objects :h text-objects                                     [C]
 558 | daW                                   : delete contiguous non whitespace
 559 | di<   yi<  ci<                        : Delete/Yank/Change HTML tag contents
 560 | da<   ya<  ca<                        : Delete/Yank/Change whole HTML tag
 561 | dat   dit                             : Delete HTML tag pair
 562 | diB   daB                             : Empty a function {}
 563 | das                                   : delete a sentence
 564 | ----------------------------------------
 565 | " _vimrc essentials
 566 | :imap <TAB> <C-N>                     : set tab to complete [N]
 567 | :set incsearch : jumps to search word as you type (annoying but excellent)
 568 | :set wildignore=*.o,*.obj,*.bak,*.exe : tab complete now ignores these
 569 | :set shiftwidth=3                     : for shift/tabbing
 570 | :set vb t_vb=".                       : set silent (no beep)
 571 | :set browsedir=buffer                 : Maki GUI File Open use current directory
 572 | ----------------------------------------
 573 | set iminsert=0  (or toggle CTRL-shift-^)    : reset "stuck" caps lock/capslock k
 574 | ey [N]
 575 | ----------------------------------------
 576 | " launching Win IE
 577 | :nmap ,f :update<CR>:silent !start c:\progra~1\intern~1\iexplore.exe file://%:p<
 578 | CR>
 579 | :nmap ,i :update<CR>: !start c:\progra~1\intern~1\iexplore.exe <cWORD><CR>
 580 | ----------------------------------------
 581 | " FTPing from VIM
 582 | cmap ,r  :Nread ftp://209.51.134.122/public_html/index.html
 583 | cmap ,w  :Nwrite ftp://209.51.134.122/public_html/index.html
 584 | gvim ftp://www.somedomain.com/index.html # uses netrw.vim
 585 | ----------------------------------------
 586 | " appending to registers (use CAPITAL)
 587 | " yank 5 lines into "a" then add a further 5
 588 | "a5yy
 589 | 10j
 590 | "A5yy
 591 | ----------------------------------------
 592 | [I     : show lines matching word under cursor <cword> (super)
 593 | ----------------------------------------
 594 | " Conventional Shifting/Indenting
 595 | :'a,'b>>
 596 | " visual shifting (builtin-repeat)
 597 | :vnoremap < <gv
 598 | :vnoremap > >gv
 599 | " Block shifting (magic)
 600 | >i{
 601 | >a{
 602 | " also
 603 | >% and <%
 604 | ==                            : index current line same as line above [N]
 605 | ----------------------------------------
 606 | " Redirection & Paste register *
 607 | :redir @*                    : redirect commands to paste buffer
 608 | :redir END                   : end redirect
 609 | :redir >> out.txt            : redirect to a file
 610 | " Working with Paste buffer
 611 | "*yy                         : yank current line to paste
 612 | "*p                          : insert from paste buffer
 613 | " yank to paste buffer (ex mode)
 614 | :'a,'by*                     : Yank range into paste
 615 | :%y*                         : Yank whole buffer into paste
 616 | :.y*                         : Yank Current line to paster
 617 | " filter non-printable characters from the paste buffer
 618 | " useful when pasting from some gui application
 619 | :nmap <leader>p :let @* = substitute(@*,'[^[:print:]]','','g')<cr>"*p
 620 | :set paste                    : prevent vim from formatting pasted in text
 621 | ----------------------------------------
 622 | " Re-Formatting text
 623 | gq}                          : Format a paragraph
 624 | gqap                         : Format a paragraph
 625 | ggVGgq                       : Reformat entire file
 626 | Vgq                          : current line
 627 | " break lines at 70 chars, if possible after a ;
 628 | :s/.\{,69\};\s*\|.\{,69\}\s\+/&\r/g
 629 | :set columns=132
 630 | :set textwidth=132
 631 | ----------------------------------------
 632 | " Operate command over multiple files
 633 | :argdo %s/foo/bar/gec        : operate on all files in :args
 634 | :bufdo %s/foo/bar/gec
 635 | :windo %s/foo/bar/gec
 636 | :argdo exe '%!sort'|w!       : include an external command
 637 | :bufdo exe "normal @q" | w   : perform a recording on open files
 638 | :silent bufdo !zip proj.zip %:p   : zip all current files
 639 | ----------------------------------------
 640 | " Command line tricks
 641 | gvim -h                    : help
 642 | ls | gvim -                : edit a stream!!
 643 | cat xx | gvim - -c "v/^\d\d\|^[3-9]/d " : filter a stream
 644 | gvim -o file1 file2        : open into a horizontal split (file1 on top, file2 o
 645 | n bottom) [C]
 646 | gvim -O file1 file2        : open into a vertical split (side by side,for compar
 647 | ing code) [N]
 648 | " execute one command after opening file
 649 | gvim.exe -c "/main" joe.c  : Open joe.c & jump to "main"
 650 | " execute multiple command on a single file
 651 | vim -c "%s/ABC/DEF/ge | update" file1.c
 652 | " execute multiple command on a group of files
 653 | vim -c "argdo %s/ABC/DEF/ge | update" *.c
 654 | " remove blocks of text from a series of files
 655 | vim -c "argdo /begin/+1,/end/-1g/^/d | update" *.c
 656 | " Automate editing of a file (Ex commands in convert.vim)
 657 | vim -s "convert.vim" file.c
 658 | "load VIM without .vimrc and plugins (clean VIM) e.g. for HUGE files
 659 | gvim -u NONE -U NONE -N hugefile.txt
 660 | " Access paste buffer contents (put in a script/batch file)
 661 | gvim -c 'normal ggdG"*p' c:/aaa/xp
 662 | " print paste contents to default printer
 663 | gvim -c 's/^/\=@*/|hardcopy!|q!'
 664 | " gvim's use of external grep (win32 or *nix)
 665 | :!grep somestring *.php     : creates a list of all matching files [C]
 666 | " use :cn(ext) :cp(rev) to navigate list
 667 | :h grep
 668 | " Using vimgrep with copen                              [N]
 669 | :vimgrep /keywords/ *.php
 670 | :copen
 671 | ----------------------------------------
 672 | " GVIM Difference Function (Brilliant)
 673 | gvim -d file1 file2        : vimdiff (compare differences)
 674 | dp                         : "put" difference under cursor to other file
 675 | do                         : "get" difference under cursor from other file
 676 | [c                         : jump backwards to change
 677 | ]c                         : jump forwards to change
 678 | :set diffopt+=icase        : switch case sensitivity on and off
 679 | " complex diff parts of same file [N]
 680 | :1,2yank a | 7,8yank b
 681 | :tabedit | put a | vnew | put b
 682 | :windo diffthis
 683 | ----------------------------------------
 684 | " Vim traps
 685 | In regular expressions you must backslash + (match 1 or more)
 686 | In regular expressions you must backslash | (or)
 687 | In regular expressions you must backslash ( (group)
 688 | In regular expressions you must backslash { (count)
 689 | /fred\+/                   : matches fred/freddy but not free
 690 | /\(fred\)\{2,3}/           : note what you have to break
 691 | ----------------------------------------
 692 | " \v or very magic (usually) reduces backslashing
 693 | /codes\(\n\|\s\)*where  : normal regexp
 694 | /\vcodes(\n|\s)*where   : very magic
 695 | ----------------------------------------
 696 | " pulling objects onto command/search line (SUPER)
 697 | <C-R><C-W> : pull word under the cursor into a command line or search
 698 | <C-R><C-A> : pull WORD under the cursor into a command line or search
 699 | <C-R>-                  : pull small register (also insert mode)
 700 | <C-R>[0-9a-z]           : pull named registers (also insert mode)
 701 | <C-R>%                  : pull file name (also #) (also insert mode)
 702 | <C-R>=somevar           : pull contents of a variable (eg :let sray="ray[0-9]")
 703 | ----------------------------------------
 704 | " List your Registers
 705 | :reg             : display contents of all registers
 706 | :reg a           : display content of register a
 707 | :reg 12a         : display content of registers 1,2 & a [N]
 708 | "5p              : retrieve 5th "ring"
 709 | "1p....          : retrieve numeric registers one by one
 710 | :let @y='yy@"'   : pre-loading registers (put in .vimrc)
 711 | qqq              : empty register "q"
 712 | qaq              : empty register "a"
 713 | :reg .-/%:*"     : the seven special registers [N]
 714 | :reg 0           : what you last yanked, not affected by a delete [N]
 715 | "_dd             : Delete to blackhole register "_ , don't affect any register [
 716 | N]
 717 | ----------------------------------------
 718 | " manipulating registers
 719 | :let @a=@_              : clear register a
 720 | :let @a=""              : clear register a
 721 | :let @a=@"              : Save unnamed register [N]
 722 | :let @*=@a              : copy register a to paste buffer
 723 | :let @*=@:              : copy last command to paste buffer
 724 | :let @*=@/              : copy last search to paste buffer
 725 | :let @*=@%              : copy current filename to paste buffer
 726 | ----------------------------------------
 727 | " help for help (USE TAB)
 728 | :h quickref             : VIM Quick Reference Sheet (ultra)
 729 | :h tips                 : Vim's own Tips Help
 730 | :h visual<C-D><tab>     : obtain  list of all visual help topics
 731 |                         : Then use tab to step thru them
 732 | :h ctrl<C-D>            : list help of all control keys
 733 | :helpg uganda           : grep HELP Files use :cn, :cp to find next
 734 | :helpgrep edit.*director: grep help using regexp
 735 | :h :r                   : help for :ex command
 736 | :h CTRL-R               : normal mode
 737 | :h /\r                  : what's \r in a regexp (matches a <CR>)
 738 | :h \\zs                 : double up backslash to find \zs in help
 739 | :h i_CTRL-R             : help for say <C-R> in insert mode
 740 | :h c_CTRL-R             : help for say <C-R> in command mode
 741 | :h v_CTRL-V             : visual mode
 742 | :h tutor                : VIM Tutor
 743 | <C-]>                   : jump to {keyword} under  cursor in help file [C]
 744 | <C-[>, <C-T>            : Move back & Forth in HELP History
 745 | gvim -h                 : VIM Command Line Help
 746 | :cabbrev h tab help     : open help in a tab [N]
 747 | ----------------------------------------
 748 | " where was an option set
 749 | :scriptnames            : list all plugins, _vimrcs loaded (super)
 750 | :verbose set history?   : reveals value of history and where set
 751 | :function               : list functions
 752 | :func SearchCompl       : List particular function
 753 | ----------------------------------------
 754 | " install a plugin (windows) [N]
 755 | extract plugin hierarchy to c:/vim/vim80/
 756 | :helptags $VIMRUNTIME/doc    : regenerate doc
 757 | ----------------------------------------
 758 | " making your own VIM help
 759 | :helptags /vim/vim64/doc  : rebuild all *.txt help files in /doc
 760 | :help add-local-help
 761 | " save this page as a VIM Help File [N]
 762 | :sav! $VIMRUNTIME/doc/vimtips.txt|:1,/^__BEGIN__/d|:/^__END__/,$d|:w!|:helptags
 763 | $VIMRUNTIME/doc
 764 | ----------------------------------------
 765 | " running file thru an external program (eg php)
 766 | map   <f9>   :update<CR>:!c:/php/php.exe %<CR>
 767 | map   <f2>   :update<CR>:!perl -c %<CR>
 768 | ----------------------------------------
 769 | " capturing output of current script in a separate buffer
 770 | :new | r!perl #                   : opens new buffer,read other buffer
 771 | :new! x.out | r!perl #            : same with named file
 772 | :new+read!ls
 773 | ----------------------------------------
 774 | " create a new buffer, paste a register "q" into it, then sort new buffer
 775 | :new +put q|%!sort
 776 | ----------------------------------------
 777 | " Inserting DOS Carriage Returns
 778 | :%s/$/\<C-V><C-M>&/g          :  that's what you type
 779 | :%s/$/\<C-Q><C-M>&/g          :  for Win32
 780 | :%s/$/\^M&/g                  :  what you'll see where ^M is ONE character
 781 | ----------------------------------------
 782 | " automatically delete trailing Dos-returns,whitespace
 783 | autocmd BufRead * silent! %s/[\r \t]\+$//
 784 | autocmd BufEnter *.php :%s/[ \t\r]\+$//e
 785 | ----------------------------------------
 786 | " perform an action on a particular file or file type
 787 | autocmd VimEnter c:/intranet/note011.txt normal! ggVGg?
 788 | autocmd FileType *.pl exec('set fileformats=unix')
 789 | ----------------------------------------
 790 | " Retrieving last command line command for copy & pasting into text
 791 | i<c-r>:
 792 | " Retrieving last Search Command for copy & pasting into text
 793 | i<c-r>/
 794 | ----------------------------------------
 795 | " more completions
 796 | <C-X><C-F>                        :insert name of a file in current directory
 797 | ----------------------------------------
 798 | " Substituting a Visual area
 799 | " select visual area as usual (:h visual) then type :s/Emacs/Vim/ etc
 800 | :'<,'>s/Emacs/Vim/g               : REMEMBER you dont type the '<.'>
 801 | gv                                : Re-select the previous visual area (ULTRA)
 802 | ----------------------------------------
 803 | " inserting line number into file
 804 | :g/^/exec "s/^/".strpart(line(".")."    ", 0, 4)
 805 | :%s/^/\=strpart(line(".")."     ", 0, 5)
 806 | :%s/^/\=line('.'). ' '
 807 | ----------------------------------------
 808 | " *numbering lines VIM way*
 809 | :set number                       : show line numbers
 810 | :map <F12> :set number!<CR>       : Show linenumbers flip-flop
 811 | :%s/^/\=strpart(line('.')."        ",0,&ts)
 812 | " numbering lines (need Perl on PC) starting from arbitrary number
 813 | :'a,'b!perl -pne 'BEGIN{$a=223} substr($_,2,0)=$a++'
 814 | " Produce a list of numbers
 815 | " Type in number on line say 223 in an empty file
 816 | qqmnYP`n^Aq                       : in recording q repeat with @q
 817 | " increment existing numbers to end of file (type <c-a> as 5 characters)
 818 | :.,$g/^\d/exe "normal! \<c-a>"
 819 | " advanced incrementing
 820 | http://vim.sourceforge.net/tip_view.php?tip_id=150
 821 | ----------------------------------------
 822 | " *advanced incrementing* (really useful)
 823 | " put following in _vimrc
 824 | let g:I=0
 825 | function! INC(increment)
 826 | let g:I =g:I + a:increment
 827 | return g:I
 828 | endfunction
 829 | " eg create list starting from 223 incrementing by 5 between markers a,b
 830 | :let I=223
 831 | :'a,'bs/^/\=INC(5)/
 832 | " create a map for INC
 833 | cab viminc :let I=223 \| 'a,'bs/$/\=INC(5)/
 834 | ----------------------------------------
 835 | " *generate a list of numbers*  23-64
 836 | o23<ESC>qqYp<C-A>q40@q
 837 | unmap =                           : get the original vim command on a mapped key
 838 |  [N]
 839 | ----------------------------------------
 840 | " editing/moving within current insert (Really useful)
 841 | <C-U>                             : delete all entered
 842 | <C-W>                             : delete last word
 843 | <HOME><END>                       : beginning/end of line
 844 | <C-LEFTARROW><C-RIGHTARROW>       : jump one word backwards/forwards
 845 | <C-X><C-E>,<C-X><C-Y>             : scroll while staying put in insert
 846 | ----------------------------------------
 847 | #encryption (use with care: DON'T FORGET your KEY)
 848 | :X                                : you will be prompted for a key
 849 | :h :X
 850 | ----------------------------------------
 851 | " modeline (make a file readonly etc) must be in first/last 5 lines
 852 | // vim:noai:ts=2:sw=4:readonly:
 853 | " vim:ft=html:                    : says use HTML Syntax highlighting
 854 | :h modeline
 855 | ----------------------------------------
 856 | " Creating your own GUI Toolbar entry
 857 | amenu  Modeline.Insert\ a\ VIM\ modeline <Esc><Esc>ggOvim:ff=unix ts=4 ss=4<CR>v
 858 | im60:fdm=marker<esc>gg
 859 | ----------------------------------------
 860 | " A function to save word under cursor to a file
 861 | function! SaveWord()
 862 |    normal yiw
 863 |    exe ':!echo '.@0.' >> word.txt'
 864 | endfunction
 865 | map ,p :call SaveWord()
 866 | ----------------------------------------
 867 | " function to delete duplicate lines
 868 | function! Del()
 869 |  if getline(".") == getline(line(".") - 1)
 870 |    norm dd
 871 |  endif
 872 | endfunction
 873 | 
 874 | :g/^/ call Del()
 875 | ----------------------------------------
 876 | " Digraphs (non alpha-numerics)
 877 | :digraphs                         : display table
 878 | :h dig                            : help
 879 | i<C-K>e'                          : enters é
 880 | i<C-V>233                         : enters é (Unix)
 881 | i<C-Q>233                         : enters é (Win32)
 882 | ga                                : View hex value of any character
 883 | #Deleting non-ascii characters (some invisible)
 884 | :%s/[\x00-\x1f\x80-\xff]/ /g      : type this as you see it
 885 | :%s/[<C-V>128-<C-V>255]//gi       : where you have to type the Control-V
 886 | :%s/[-ÿ]//gi                     : Should see a black square & a dotted y
 887 | :%s/[<C-V>128-<C-V>255<C-V>01-<C-V>31]//gi : All pesky non-asciis
 888 | :exec "norm /[\x00-\x1f\x80-\xff]/"        : same thing
 889 | #Pull a non-ascii character onto search bar
 890 | yl/<C-R>"                         :
 891 | /[^a-zA-Z0-9_[:space:][:punct:]]  : search for all non-ascii
 892 | ----------------------------------------
 893 | " All file completions grouped (for example main_c.c)
 894 | :e main_<tab>                     : tab completes
 895 | gf                                : open file under cursor  (normal)
 896 | main_<C-X><C-F>                   : include NAME of file in text (insert mode)
 897 | ----------------------------------------
 898 | " Complex Vim
 899 | " swap two words
 900 | :%s/\<\(on\|off\)\>/\=strpart("offon", 3 * ("off" == submatch(0)), 3)/g
 901 | " swap two words
 902 | :vnoremap <C-X> <Esc>`.``gvP``P
 903 | " Swap word with next word
 904 | nmap <silent> gw    "_yiw:s/\(\%#\w\+\)\(\_W\+\)\(\w\+\)/\3\2\1/<cr><c-o><c-l> [
 905 | N]
 906 | ----------------------------------------
 907 | " Convert Text File to HTML
 908 | :runtime! syntax/2html.vim        : convert txt to html
 909 | :h 2html
 910 | :%TOhtml                          : convert current file to html [N]
 911 | ----------------------------------------
 912 | " VIM has internal grep
 913 | :grep some_keyword *.c            : get list of all c-files containing keyword
 914 | :cn                               : go to next occurrence
 915 | ----------------------------------------
 916 | " Force Syntax coloring for a file that has no extension .pl
 917 | :set syntax=perl
 918 | " Remove syntax coloring (useful for all sorts of reasons)
 919 | :set syntax off
 920 | " change coloring scheme (any file in ~vim/vim??/colors)
 921 | :colorscheme blue
 922 | :colorscheme morning     : good fallback colorscheme 
 923 | " Force HTML Syntax highlighting by using a modeline
 924 | # vim:ft=html:
 925 | " Force syntax automatically (for a file with non-standard extension)
 926 | au BufRead,BufNewFile */Content.IE?/* setfiletype html
 927 | " make cursor standout against highlighted text for vim terminal (linux) [N]
 928 | :highlight search term=reverse ctermbg=5
 929 | :highlight Normal guibg=white     : restore white background [N]
 930 | ----------------------------------------
 931 | :set noma (non modifiable)        : Prevents modifications
 932 | :set ro (Read Only)               : Protect a file from unintentional writes
 933 | ----------------------------------------
 934 | " Sessions (Open a set of files)
 935 | gvim file1.c file2.c lib/lib.h lib/lib2.h : load files for "session"
 936 | :mksession                        : Make a Session file (default Session.vim)
 937 | :mksession MySession.vim          : Make a Session file named file [C]
 938 | :q
 939 | gvim -S                           : Reload all files (loads Session.vim) [C]
 940 | gvim -S MySession.vim             : Reload all files from named session [C]
 941 | ----------------------------------------
 942 | #tags (jumping to subroutines/functions)
 943 | taglist.vim                       : popular plugin
 944 | :Tlist                            : display Tags (list of functions)
 945 | <C-]>                             : jump to function under cursor
 946 | ----------------------------------------
 947 | " columnise a csv file for display only as may crop wide columns
 948 | :let width = 20
 949 | :let fill=' ' | while strlen(fill) < width | let fill=fill.fill | endwhile
 950 | :%s/\([^;]*\);\=/\=strpart(submatch(1).fill, 0, width)/ge
 951 | :%s/\s\+$//ge
 952 | " Highlight a particular csv column (put in .vimrc)
 953 | function! CSVH(x)
 954 |     execute 'match Keyword /^\([^,]*,\)\{'.a:x.'}\zs[^,]*/'
 955 |     execute 'normal ^'.a:x.'f,'
 956 | endfunction
 957 | command! -nargs=1 Csv :call CSVH(<args>)
 958 | " call with
 959 | :Csv 5                             : highlight fifth column
 960 | ----------------------------------------
 961 | zf1G      : fold everything before this line [N]
 962 | " folding : hide sections to allow easier comparisons
 963 | zf}                               : fold paragraph using motion
 964 | v}zf                              : fold paragraph using visual
 965 | zf'a                              : fold to mark
 966 | zo                                : open fold
 967 | zc                                : re-close fold
 968 | " also visualise a section of code then type zf [N]
 969 | :help folding
 970 | zfG      : fold everything after this line [N]
 971 | ----------------------------------------
 972 | " displaying "non-asciis"
 973 | :set list
 974 | :h listchars
 975 | ----------------------------------------
 976 | " How to paste "normal vim commands" w/o entering insert mode
 977 | :norm qqy$jq
 978 | ----------------------------------------
 979 | " manipulating file names
 980 | :h filename-modifiers             : help
 981 | :w %                              : write to current file name
 982 | :w %:r.cfm                        : change file extention to .cfm
 983 | :!echo %:p                        : full path & file name
 984 | :!echo %:p:h                      : full path only
 985 | :!echo %:t                        : filename only
 986 | :reg %                            : display filename
 987 | <C-R>%                            : insert filename (insert mode)
 988 | "%p                               : insert filename (normal mode)
 989 | /<C-R>%                           : Search for file name in text
 990 | ----------------------------------------
 991 | " delete without destroying default buffer contents
 992 | "_d                               : what you've ALWAYS wanted
 993 | "_dw                              : eg delete word (use blackhole)
 994 | ----------------------------------------
 995 | " pull full path name into paste buffer for attachment to email etc
 996 | nnoremap <F2> :let @*=expand("%:p")<cr> :unix
 997 | nnoremap <F2> :let @*=substitute(expand("%:p"), "/", "\\", "g")<cr> :win32
 998 | ----------------------------------------
 999 | " Simple Shell script to rename files w/o leaving vim
1000 | $ vim
1001 | :r! ls *.c
1002 | :%s/\(.*\).c/mv & \1.bla
1003 | :w !sh
1004 | :q!
1005 | ----------------------------------------
1006 | " count words/lines in a text file
1007 | g<C-G>                                 # counts words/characters/lines text and
1008 | visualised text
1009 | :echo line("'b")-line("'a")            # count lines between markers a and b [N]
1010 | :'a,'bs/^//n                           # count lines between markers a and b
1011 | :'a,'bs/somestring//gn                 # count occurences of a string
1012 | :s/,/,/gn                              # count commas in a line (csv/parameters)
1013 | ----------------------------------------
1014 | " example of setting your own highlighting
1015 | :syn match DoubleSpace "  "
1016 | :hi def DoubleSpace guibg=#e0e0e0
1017 | ----------------------------------------
1018 | " reproduce previous line word by word
1019 | imap ]  @@@<ESC>hhkyWjl?@@@<CR>P/@@@<CR>3s
1020 | nmap ] i@@@<ESC>hhkyWjl?@@@<CR>P/@@@<CR>3s
1021 | " Programming keys depending on file type
1022 | :autocmd bufenter *.tex map <F1> :!latex %<CR>
1023 | :autocmd bufenter *.tex map <F2> :!xdvi -hush %<.dvi&<CR>
1024 | " allow yanking of php variables with their dollar [N]
1025 | :autocmd bufenter *.php :set iskeyword+=\$
1026 | ----------------------------------------
1027 | " reading Ms-Word documents, requires antiword (not docx)
1028 | :autocmd BufReadPre *.doc set ro
1029 | :autocmd BufReadPre *.doc set hlsearch!
1030 | :autocmd BufReadPost *.doc %!antiword "%"
1031 | ----------------------------------------
1032 | " a folding method
1033 | vim: filetype=help foldmethod=marker foldmarker=<<<,>>>
1034 | A really big section closed with a tag <<<
1035 | --- remember folds can be nested ---
1036 | Closing tag >>>
1037 | ----------------------------------------
1038 | " Return to last edit position (You want this!) [N]
1039 | autocmd BufReadPost *
1040 |      \ if line("'\"") > 0 && line("'\"") <= line("$") |
1041 |      \   exe "normal! g`\"" |
1042 |      \ endif
1043 | ----------------------------------------
1044 | " store text that is to be changed or deleted in register a
1045 | "act<                                 :  Change Till < [N]
1046 | ----------------------------------------
1047 | "installing/getting latest version of vim on Linux (replace tiny-vim) [N]
1048 | yum install vim-common vim-enhanced vim-minimal
1049 | ----------------------------------------
1050 | # using gVIM with Cygwin on a Windows PC
1051 | if has('win32')
1052 | source $VIMRUNTIME/mswin.vim
1053 | behave mswin
1054 | set shell=c:\\cygwin\\bin\\bash.exe shellcmdflag=-c shellxquote=\"
1055 | endif
1056 | ----------------------------------------
1057 | " trick *Just Another Vim Hacker JAVH*
1058 | vim -c ":%s%s*%Cyrnfr)fcbafbe[Oenz(Zbbyranne%|:%s)[[()])-)Ig|norm Vg?"
1059 | ----------------------------------------
1060 | vim:tw=78:ts=8:ft=help:norl:set modifiable noreadonly:
1061 | 


--------------------------------------------------------------------------------
/plugin/easyjump.vim:
--------------------------------------------------------------------------------
 1 | if !has('vim9script') ||  v:version < 900
 2 |     echoe "Needs Vim version 9.0 and above"
 3 |     finish
 4 | endif
 5 | vim9script
 6 | 
 7 | # Jump to any character on screen using 2 characters.
 8 | 
 9 | :highlight default link EasyJump MatchParen
10 | 
11 | import autoload '../autoload/vimbits/jump.vim'
12 | 
13 | def Jump(count: number = 1)
14 |     jump.Jump(count == 2)
15 | enddef
16 | 
17 | def VJump(count: number = 1)
18 |     jump.Jump(count == 2)
19 |     :normal! m'gv``
20 | enddef
21 | 
22 | if get(g:, 'vimbits_easyjump', true)
23 |     :nnoremap <silent> <Plug>EasyjumpJump; :<c-u>call <SID>Jump(v:count1)<cr>
24 |     :onoremap <silent> <Plug>EasyjumpJump; :<c-u>call <SID>Jump(v:count1)<cr>
25 |     :vnoremap <silent> <Plug>EasyjumpJump; :<c-u>call <SID>VJump(v:count1)<cr>
26 | 
27 |     augroup VimbitsEasyJump | autocmd!
28 |         autocmd VimEnter * jump.Setup()
29 |     augroup END
30 | else
31 |     :nnoremap <silent> <Plug>EasyjumpJump; :echo 'EasyJump not enabled'<cr>
32 |     :onoremap <silent> <Plug>EasyjumpJump; :echo 'EasyJump not enabled'<cr>
33 |     :vnoremap <silent> <Plug>EasyjumpJump; :echo 'EasyJump not enabled'<cr>
34 | endif
35 | 
36 | def EasyJumpJump()
37 |     if mode() == "\<C-V>" || mode() =~ '\v(v|V)'
38 |         VJump()
39 |     elseif mode() =~ '\v(n|no)'
40 |         Jump()
41 |     endif
42 | enddef
43 | 
44 | if get(g:, 'easyjump_command', false) && !exists(':EasyJump')
45 |     command EasyJump EasyJumpJump()
46 | endif
47 | 


--------------------------------------------------------------------------------
/plugin/fFtT.vim:
--------------------------------------------------------------------------------
 1 | if !has('vim9script') ||  v:version < 900
 2 |     echoe "Needs Vim version 9.0 and above"
 3 |     finish
 4 | endif
 5 | vim9script
 6 | 
 7 | var id: number
 8 | var winid: number
 9 | 
10 | hi def link FfTtSubtle Comment
11 | 
12 | def HighligtClear(): string
13 |     if id > 0
14 |         id->matchdelete(winid)
15 |         :redraw
16 |         id = 0
17 |     endif
18 |     return ''
19 | enddef
20 | 
21 | augroup fFtTHighlight | autocmd!
22 |     autocmd CursorMoved,ModeChanged,TextChanged,WinEnter,WinLeave,CmdWinLeave,SafeState * HighligtClear()
23 | augroup END
24 | 
25 | # Gather locations of characters to be dimmed.
26 | def HighligtChars(s: string): string
27 |     var [_, lnum, col, _] = getpos('.')
28 |     var line = getline('.')
29 |     # Extended ASCII characters can pose a challenge if we simply iterate over
30 |     # bytes. It is preferable to let Vim split the line by characters for more
31 |     # accurate handling.
32 |     var found = {}
33 |     for ch in line->split('\zs')
34 |         if !found->has_key(ch)
35 |             found[ch] = 1
36 |         endif
37 |     endfor
38 | 
39 |     var [start, reverse] = (s =~ '\C[ft]') ? [col, false] : [col - 2, true]
40 |     var locations = []
41 |     var freq = {}
42 |     var maxloc = max([100, &lines * &columns])
43 |     for ch in found->keys()
44 |         var loc = reverse ? line->strridx(ch, start) : line->stridx(ch, start)
45 |         while loc != -1
46 |             freq[ch] = freq->get(ch, 0) + 1
47 |             if freq[ch] != v:count1
48 |                 if freq[ch] > maxloc
49 |                     # If we encounter a super long line, there's no need to
50 |                     # search for locations that are off screen.
51 |                     break
52 |                 endif
53 |                 locations->add([lnum, loc + 1])
54 |             endif
55 |             loc = reverse ? line->strridx(ch, loc - 1) : line->stridx(ch, loc + 1)
56 |         endwhile
57 |     endfor
58 | 
59 |     if !locations->empty()
60 |         if id > 0
61 |             id->matchdelete(winid)
62 |         endif
63 |         winid = win_getid()
64 |         id = matchaddpos('FfTtSubtle', locations, 1001)
65 |         :redraw
66 |     endif
67 |     return ''
68 | enddef
69 | 
70 | if get(g:, 'vimbits_fFtT', true)
71 |     noremap <silent><expr> <Plug>(fFtT-f) HighligtChars('f')
72 |     noremap <silent><expr> <Plug>(fFtT-F) HighligtChars('F')
73 |     noremap <silent><expr> <Plug>(fFtT-t) HighligtChars('t')
74 |     noremap <silent><expr> <Plug>(fFtT-T) HighligtChars('T')
75 |     noremap <silent><expr> <Plug>(fFtT-esc) HighligtClear()
76 | 
77 |     nnoremap f <Plug>(fFtT-f)f
78 |     xnoremap f <Plug>(fFtT-f)f
79 |     onoremap f <Plug>(fFtT-f)f
80 |     nnoremap F <Plug>(fFtT-F)F
81 |     xnoremap F <Plug>(fFtT-F)F
82 |     onoremap F <Plug>(fFtT-F)F
83 |     nnoremap t <Plug>(fFtT-t)t
84 |     xnoremap t <Plug>(fFtT-t)t
85 |     onoremap t <Plug>(fFtT-t)t
86 |     nnoremap T <Plug>(fFtT-T)T
87 |     xnoremap T <Plug>(fFtT-T)T
88 |     onoremap T <Plug>(fFtT-T)T
89 | endif
90 | 


--------------------------------------------------------------------------------
/plugin/vimbits.vim:
--------------------------------------------------------------------------------
 1 | if !has('vim9script') ||  v:version < 900
 2 |     finish
 3 | endif
 4 | vim9script
 5 | g:loaded_vimbits = true
 6 | 
 7 | import '../autoload/vimbits/highlightonyank.vim' as hy
 8 | import '../autoload/vimbits/vim9cmdline.vim' as v9
 9 | 
10 | if get(g:, 'vimbits_vim9cmdline', false) && !exists(':ToggleVim9Cmdline')
11 |     command ToggleVim9Cmdline {
12 |         g:vimbits_vim9cmdline = !get(g:, 'vimbits_vim9cmdline', false)
13 |     }
14 | endif
15 | 
16 | augroup Vimbits | autocmd!
17 |     if get(g:, 'vimbits_highlightonyank', true)
18 |         if has('patch-9.1.0443')  # has getregionpos() and bug fixes
19 |             autocmd TextYankPost * hy.HighlightOnYank()
20 |         else
21 |             autocmd TextYankPost * hy.HighlightOnYankLegacy()
22 |         endif
23 |     endif
24 |     if get(g:, 'vimbits_vim9cmdline', false)
25 |         autocmd CmdlineEnter : v9.Vim9cmdlineSet()
26 |         autocmd CmdlineLeave : v9.Vim9cmdlineUnset()
27 |     endif
28 | augroup END
29 | 


--------------------------------------------------------------------------------
/test/highlight.vim:
--------------------------------------------------------------------------------
 1 | vim9script
 2 | 
 3 | so ./setup.vim
 4 | 
 5 | def Verify(cmd: string, not_hi: list<number>)
 6 |     exe $'normal {cmd}'
 7 |     if assert_notequal([], getmatches()) == 1
 8 |         verbose echoerr v:errors
 9 |     endif
10 |     for v in getmatches()[0]->values()
11 |         if v->type() == v:t_list && v->len() == 3
12 |             if  v[0] != 1 || not_hi->index(v[1]) != -1
13 |                 verbose echoerr 'error at' v
14 |             endif
15 |         endif
16 |     endfor
17 | enddef
18 | 
19 | # Lorem ipsum doloćrż sit amęt, cąnsęctetuer adipiscing elit.
20 | 
21 | cursor(1, 1)
22 | var nhi = range(1, 10)->extend([13, 15, 17, 20, 25, 27, 29, 32, 34, 37, 58, 64])
23 | Verify('f', nhi)
24 | if assert_notequal([], getmatches()) == 1
25 |     verbose echoerr v:errors
26 | endif
27 | exe "normal \<esc>"
28 | if assert_equal([], getmatches()) == 1
29 |     verbose echoerr v:errors
30 | endif
31 | 
32 | cursor(1, 1)
33 | nhi = [16, 28, 38, 42, 46, 47, 51, 55]
34 | Verify('3f', nhi)
35 | normal "\<esc>"
36 | 
37 | cursor(1, 19)
38 | nhi = range(1, 19)
39 | Verify('f', nhi)
40 | normal "\<esc>"
41 | 
42 | cursor(1, 24)
43 | nhi = range(15, 64)->extend([1, 4, 7, 8, 10, 11, 13])
44 | Verify('F', nhi)
45 | normal "\<esc>"
46 | 
47 | cursor(1, 24)
48 | nhi = range(24, 64)
49 | Verify('4F', nhi)
50 | normal "\<esc>"
51 | 
52 | cursor(1, 24)
53 | nhi = range(24, 64)->extend([2])
54 | Verify('3F', nhi)
55 | normal "\<esc>"
56 | 
57 | cursor(1, 24)
58 | nhi = range(1, 30)->extend([32, 34, 35, 36, 37, 38, 43, 45, 47, 50, 51, 52, 58, 64])
59 | Verify('t', nhi)
60 | 
61 | cursor(1, 24)
62 | nhi = range(1, 24)->extend([42, 55, 56, 60])
63 | Verify('3t', nhi)
64 | 
65 | cursor(1, 24)
66 | nhi = range(15, 64)->extend([1, 4, 7, 8, 10, 11, 13])
67 | Verify('T', nhi)
68 | if assert_notequal([], getmatches()) == 1
69 |     verbose echoerr v:errors
70 | endif
71 | exe "normal \<esc>"
72 | if assert_equal([], getmatches()) == 1
73 |     verbose echoerr v:errors
74 | endif
75 | 
76 | cursor(1, 24)
77 | nhi = range(24, 64)->extend([2])
78 | Verify('3T', nhi)
79 | 
80 | qa!
81 | 


--------------------------------------------------------------------------------
/test/runtests.sh:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | # put vim in ex mode so that error messages appear in stderr/stdout. otherwise
 4 | # vim clears stdout/stderr on exit. use `verbose` to direct messages to stderr.
 5 | # syntax errors can make the test hang.
 6 | 
 7 | for test_file in highlight.vim yank.vim visual.vim; do
 8 |     vim -nEs -u DEFAULTS -i NONE -S <(cat <<EOF
 9 |         vim9script
10 |         set shortmess=I
11 |         so ../plugin/fFtT.vim
12 |         so ./${test_file}
13 |         qa!
14 |     EOF
15 |     )
16 | done
17 | 


--------------------------------------------------------------------------------
/test/setup.vim:
--------------------------------------------------------------------------------
 1 | vim9script
 2 | 
 3 | enew
 4 | setl buftype=nofile noswapfile nonu nornu
 5 | var line = 'Lorem ipsum doloćrż sit amęt, cąnsęctetuer adipiscing elit.'
 6 | line->setline(1)
 7 | if assert_equal(line, getline(1)) == 1
 8 |     verbose echoerr v:errors
 9 | endif
10 | if assert_equal([], getmatches()) == 1
11 |     verbose echoerr v:errors
12 | endif
13 | 
14 | 


--------------------------------------------------------------------------------
/test/visual.vim:
--------------------------------------------------------------------------------
 1 | vim9script
 2 | 
 3 | so ./setup.vim
 4 | 
 5 | # Lorem ipsum doloćrż sit amęt, cąnsęctetuer adipiscing elit.
 6 | 
 7 | cursor(1, 24)
 8 | norm vfc"ay
 9 | 'a'->getreg()
10 | if assert_notequal('it amęt, c', 'a'->getreg()) == 0
11 |     verbose echoerr v:errors
12 | endif
13 | 
14 | cursor(1, 24)
15 | norm vtn"ay
16 | 'a'->getreg()
17 | if assert_notequal('it amęt, cą', 'a'->getreg()) == 0
18 |     verbose echoerr v:errors
19 | endif
20 | 
21 | cursor(1, 24)
22 | norm vTp"ay
23 | if assert_notequal('sum doloćrż si', 'a'->getreg()) == 0
24 |     verbose echoerr v:errors
25 | endif
26 | 
27 | cursor(1, 24)
28 | norm vFi"ay
29 | if assert_notequal('ipsum doloćrż si', 'a'->getreg()) == 0
30 |     verbose echoerr v:errors
31 | endif
32 | 
33 | qa!
34 | 


--------------------------------------------------------------------------------
/test/yank.vim:
--------------------------------------------------------------------------------
 1 | vim9script
 2 | 
 3 | so ./setup.vim
 4 | 
 5 | # Lorem ipsum doloćrż sit amęt, cąnsęctetuer adipiscing elit.
 6 | 
 7 | cursor(1, 24)
 8 | norm "ayfc
 9 | 'a'->getreg()
10 | if assert_notequal('it amęt, c', 'a'->getreg()) == 0
11 |     verbose echoerr v:errors
12 | endif
13 | 
14 | cursor(1, 24)
15 | norm "aytn
16 | 'a'->getreg()
17 | if assert_notequal('it amęt, cą', 'a'->getreg()) == 0
18 |     verbose echoerr v:errors
19 | endif
20 | 
21 | cursor(1, 24)
22 | norm "ayTp
23 | if assert_notequal('sum doloćrż s', 'a'->getreg()) == 0
24 |     verbose echoerr v:errors
25 | endif
26 | 
27 | cursor(1, 24)
28 | norm "ayFi
29 | if assert_notequal('ipsum doloćrż s', 'a'->getreg()) == 0
30 |     verbose echoerr v:errors
31 | endif
32 | 
33 | qa!
34 | 


--------------------------------------------------------------------------------