using git with vim

vim fugitive installation

vim surround

blog

Delete surroundings

To delete we use ds, the next character determines the target to delete. Some examples:

"Hello world!"
  [] <--- cursor

ds"

Hello world!
[] <--- cursor now

<p>Start here</p>
       [] <--- cursor

dst

Start here
[] <--- cursor now

(var1, var2)

ds(

var1, var2

The cursor can be anywhere within the surrounding text object we’re operating on, when the command is complete the cursor moves to the start of the object we operated on. Also, unlike other text objects there’s no i or a option for changing how it selects the area.

Change surrounding

To change a surrounding we use cs, this deletes the supplied text-object and replaces it with the second argument. When used in this way the cursor does not enter Insert mode at the end of the command. There are two ways to use it:

Change one surround to another: cs Change one surround to another, putting the new ones on separate new lines: cS Examples of how to use it are:

| Objective | Original text | Command | Edited text | | ———————————————————– | —————————————————- | ——- | ————————————————– | | Change surrounding quotes from double to single quote marks | “My kingdom for a horse” [] <— cursor here | cs”’ | ‘My kingdom for a horse’ [] <— cursor here now | | Change to HTML paragraph with tags on separate lines | ‘Look, to the East’ | cS’<p> | <p> Look, to the East </p> |

"My kingdom for a horse"
      [] <--- cursor here

cs"'

'My kingdom for a horse'
[] <--- cursor here now

'Look, to the East'

cS'<p>

<p>
Look, to the East
</p>

Add surrounding

Often, rather than altering some existing mark-up or brackets, we want to add some additional surroundings. Add a surrounding uses ys, the following item is the additional mark-up, brackets or text that will placed either side. The ways it can be used are:

Wrap the vim motion or text object in the second argument: ys<motion|text-object> Change the current line and wrap it with the second argument: yss Change the specified motion, putting the new addition on new lines and indenting the text: yS Whole line and do the above: ySS Some examples of using these methods:

| Objective | Original text | Command | Edited text | | ———————————————————————————————————————– | ————————————————- | ——- | —————————————————- | | Put some quotes around some text at the end of a line. | he said, Boo! scary huh [] <— cursor | ys$” | he said, “Boo! scary huh” | | Put some square brackets around some variables. Note use of repetition in the motion. | print var1, var2 [] <— cursor | ys3w) | print (var1, var2) [] <— cursor | | Put some squiggly brackets around some code. This acts on the whole line with the cursor anywhere on the line | 34, 21, 7 [] <– cursor | yssB | { 34, 21, 7 } [] <– cursor moves | | Convert some speech into a HTML blockquote. Uses Vims search motion and surrounds ability to then put tags around that. | Jack said, “Done it!” [] <— cursor | ySf”t | Jack said, <blockquote> “Done it!” </blockquote> | | Put some brackets around a procedure and indent the text | defn -proc1 [] <— cursor | ySSb | ( defn -proc1 ) |

he said, Boo! scary huh
         [] <--- cursor

ys$"

he said, "Boo! scary huh"

print var1, var2
      [] <--- cursor

ys3w)

print (var1, var2)
      [] <--- cursor

34, 21, 7
  [] <-- cursor

yssB

{ 34, 21, 7 }
[] <-- cursor moves

Jack said, "Done it!"
           [] <--- cursor

ySf"t

Jack said, <blockquote>
    "Done it!"
</blockquote>

defn -proc1
    [] <--- cursor

ySSb

(
     defn -proc1
)

Visual surround

In visual mode, the surround object is called with S, and then an argument that wraps the visual selection. The keyboard usage is something like this:

v                         # Enter visual mode
<visually select>         # Use the keyboard to select the section of text
S                         # Press upper case S
"                         # Specify what you want to surround the visual selection with

In linewise visual mode the surrounding are placed on separate lines and indented: vS In block wise visual mode (Ctrl-v) each line is surrounded: vS

Uses linewise visual mode | Consider this, when we create an object we take more memory. | Shift-v,

Add two eggs
   [] <--- cursor

viwS*

Add *two* eggs
[] <--- cursor now

Consider this, when
we create an object
we take more memory.

Shift-v,
<highlight the text>
S<p>

<p>
Consider this, when
we create an object
we take more memory.
</p>

6 eggs
4 apples
2 pints of milk

Ctrl-v
<highlight the text>
S<li>

<li>6 eggs</li>
<li>4 apples</li>
<li>2 pints of milk</li>