Advanced filtering utilities in Vim
Substitution
Substitution uses much the same options as Vim's built-in substitute
command, which you can read about with the command :help:substitute
. The command structure is either of the following:
:%Abolish -substitute -flags SEARCH_TERM REPLACEMENT :%S/SEARCH-TERM/REPLACEMENT/FLAG
The substitution options include I
, v
, and w
, just like searches. Additionally, substitution uses the g
option to find and replace all instances of the search string (which is also the default behavior). The e
option suppresses error messages, and n
finds the number of instances but does not replace them.
The most useful flag is c
. Ordinarily, vim-abolish replaces all instances without confirmation, but when the c
flag is set, each replacement needs to be confirmed. Table 1 shows the c
flag confirmation options. The last two might not be available, depending on how your copy of Vim was compiled.
Table 1
c Flag Confirmation Options
y |
Make the change. |
n |
Do not make the change. |
a |
Change the current instance and exit. |
q |
Exit making no other changes. |
l |
Exit, changing the current instance and returning to the first instance. |
Ctrl+E |
Scroll up the file. |
Ctrl+Y |
Scroll down the file. |
Coercion
Vim-abolish uses the unusual term "coercion" for changing the letter case of a selected word. Search for a word, and, with the cursor still in the word, enter one of the abbreviations in Table 2 to change the word to the desired case.
Table 2
Letter Cases for Coercion
crc |
CamelCase (the first letter of each syllable is capitalized) |
crm |
Mixed case (the word combines uppercase and lowercase, in no special order) |
crs or cr_ |
Snake case (syllables are separated by an underscore) |
cru |
Lowercase Snake case |
cr- |
Dash case (syllables are separated by dashes; cannot be changed again) |
If you regularly have multiple instances of words needing case changes, you might follow the advice in the README.markdown
file, and install the command repeat.vim
[3] to make your letter case editing easier.
Learning vim-abolish
There is no denying that vim-abolish is eccentric. Its name, as well as the names of some of its utilities, has no clear relation to its function. Nor does there seem to be a reason, other than user choice, for the support of two – three, actually – different command structures. Moreover, its four utilities have little more in common than the fact that they are all efficient ways of searching files.
Still, the eccentricity is not nearly as great as it first appears. Abbreviation is a more powerful version of Vim's substitution, and the vim-abolish search
is an enhancement of Vim's version. You can also increase the consistency of vim-abolish by using Subvert
rather than Abolish
to structure your commands.
Undoubtedly, the biggest obstacle to using vim-abolish is writing advanced search patterns. Although the options are straightforward, thinking out the permutations of different word variations can be challenging. You can expect some trial and error, both to eliminate false positives and to ensure that every instance of a string is found.
Yet despite these obstacles, vim-abolish can save you time and customize Vim to your liking. These advantages make vim-abolish one of the essential plugins for many users, regardless of whether they use Vim for programming or as a general text editor.
Infos
- GitHub page: https://github.com/tpope/tpope-vim-abolish
- Help text: https://github.com/tpope/tpope-vim-abolish/blob/master/doc/abolish.txt
- Instructions for
repeat.vim
: https://github.com/tpope/vim-repeat
« Previous 1 2
Buy Linux Magazine
Direct Download
Read full article as PDF:
Subscribe to our Linux Newsletters
Find Linux and Open Source Jobs
Subscribe to our ADMIN Newsletters
Find SysAdmin Jobs
News
-
Escuelas Linux 8.0 is Now Available
Just in time for its 25th anniversary, the developers of Escuelas Linux have released the latest version.
-
LibreOffice 7.5 has Arrived Loaded with New Features and Improvements
The favorite office suite of the Linux community has a new release that includes some visual refreshing and new features across all modules.
-
The Next Major Release of Elementary OS Has Arrived
It's been over a year since the developers of elementary OS released version 6.1 (Jólnir) but they've finally made their latest release (Horus) available with a renewed focus on the user.
-
KDE Plasma 5.27 Beta Is Ready for Testing
The latest beta iteration of the KDE Plasma desktop is now available and includes some important additions and fixes.
-
Netrunner OS 23 Is Now Available
The latest version of this Linux distribution is now based on Debian Bullseye and is ready for installation and finally hits the KDE 5.20 branch of the desktop.
-
New Linux Distribution Built for Gamers
With a Gnome desktop that offers different layouts and a custom kernel, PikaOS is a great option for gamers of all types.
-
System76 Beefs Up Popular Pangolin Laptop
The darling of open-source-powered laptops and desktops will soon drop a new AMD Ryzen 7-powered version of their popular Pangolin laptop.
-
Nobara Project Is a Modified Version of Fedora with User-Friendly Fixes
If you're looking for a version of Fedora that includes third-party and proprietary packages, look no further than the Nobara Project.
-
Gnome 44 Now Has a Release Date
Gnome 44 will be officially released on March 22, 2023.
-
Nitrux 2.6 Available with Kernel 6.1 and a Major Change
The developers of Nitrux have officially released version 2.6 of their Linux distribution with plenty of new features to excite users.