Friday, January 30, 2009

Vim advanced topics

As I am using vim frequently, gradually I find it necessary to grasp some advanced vim topics. Sometimes, search engines don't return the useful posts/resources in the first page.

Vim built-in functions, internal variables, data structures, etc. http://vimdoc.sourceforge.net/htmldoc/eval.html
Filetype http://www.vim.org/htmldoc/filetype.html
Command line mode http://vimdoc.sourceforge.net/htmldoc/cmdline.html
Options and commands:
http://vimdoc.sourceforge.net/htmldoc/options.html
http://vimdoc.sourceforge.net/htmldoc/various.html
Configuration: http://peox.net/articles/vimconfig.html
Other topics (FAQs): http://www.cs.utah.edu/~kad/vim/vimnotes.shtml#17
Vim Buffer Resources
http://www.vim.org/htmldoc/windows.html
http://vim.wikia.com/wiki/Vim_buffer_FAQ

File manipulation commands:
Information getting
Ctrl+g, :f, :file print some info of current file in command line
:ls, :buffers, :files list
{count}Ctrl+g 1Ctrl+g: print current file name with full path
2Ctrl+g: currentbuffer number is printed also
g Ctrl+g

print cursor position in 5 ways:     Column, Line, Word, Character and Byte.

{Visual} g Ctrl+g

print Word, Character, Line, and Byte counts of selected text

Editing switch
:view {file} same as :edit, except the file is opened in readonly mode.
:file name set current file name to name. The old name becomes alternate file name.
:0file Remove the name of the current buffer.
:edit[!] Re-load current file. Useful when the file is modified outside of vim.
:edit[!] {file} Edit a new file.
Ctrl + ^ Edit alternate file(equivalent to ":e #").By default, the alternate file is the previously edited file
:{count} Ctrl + ^ go to a specific buffer
:edit #[count] Edit the [count]th buffer
:b[uffer] [count] Edit the [count]th buffer
:enew[!] edit a new unnamed buffer
Find and Edit
:find[!] {file} Find {file} in path and then edit
:{count}find[!] {file} Find {count}-th {file} in path and then edit
[count] gf Edit the [count]-th file in path whose name is under the cursor. If [count] is omitted, just get the first match. The file in opened in current window.
[count] Ctrl-w gf Edit the [count]-th file in path whose name is under the cursor. It is opened in a new tab.
[count] Ctrl-w f Edit the [count]-th file in path whose name is under the cursor. It is opened in a newly split window in current tab.
{Visual}[count]gf selected text is used as filename to search
[count]gF Similar to the commands above. If a number follows the filename, after opening the file, cursor would be moved to the specified position.
{Visual}[count]gF  
Writing
:w[rite][!] write current buffer to current file.
:{range}w[rite][!] write specified lines to current file
:{range}w[rite][!] {file} write specified lines (or whole buffer) to {file}
:{range}w[rite][!] >> append specified lines to current file
:{range}w[rite][!] >> {file} append specified lines to {file}
:[range]w[rite] !{cmd} feed specified lines into {cmd} as standard input
Insert a file
:r[ead] [file] insert file {file} after the cursor
:{range}r[ead] {name} insert file {file} below the specified line
:[range]r[ead] !{cmd} Execute {cmd} and insert its standard output after the cursor or below the specified line. E.g. :read !ls

Window manipulation

Command Explanation
Ctrl-w s, Ctrl-w Ctrl-s
:[N]sp[lit] [file]
Split current window into two horizontally.Option splitbelow controls where to put newly created window.
Ctrl-w v, Ctrl-w Ctrl-v
:[N]vsp[lit] [file]
Split current window into two vertically. Option splitright controls where to put newly created window.
Ctrl-w n, Ctrl-w Ctrl-n
:[N]new [file]
Create a new window with an empty file in it or with the specified file. split horizontally
:[N]vnew [file] Create a new window with an empty file in it or with the specified file. split vertically.
:[N]sv[iew] {file} same as :split, but set 'readonly' option
:[N]sf[find] {file} same as :split, search for {file} in path.
Ctrl-w Ctrl-^, Ctrl-w ^ Does ":split #". Split window into two and edit alternate file.
When a count is given, it is equivalent to ":split #N". Split and edit buffer N
Explictly set position of window
:vertical {cmd} Explicitly set position of a newly created window which is generated by invoking {cmd}
:leftabove {cmd}
:aboveleft {cmd}
:rightbelow {cmd}
:belowright {cmd}
:topleft
:botright
Cursor movement and window movement
Ctrl-w k
Ctrl-w j
Ctrl-w h
Ctrl-w l
Move cursor to Nth window above current one.
Move cursor to Nth window below current one
Move cursor to Nth window left of current one
Move cursor to Nth window right of current one
Ctrl-w w
Ctrl-w W
Ctrl-w t
Ctrl-w b
Ctrl-w p
move cursor to window below/right of current one.
move cursor to window above/left of current one.
move cursor to top-left window
move cursor to bottom-right window
move cursor to previous window
Ctrl-w K
Ctrl-w J
Ctrl-w H
Ctrl-w L
move window to be at the very top, with full width of screen
at the very bottom, with full width of screen
at the far left, with full height of screen
at the far right, with full height of screen
Ctrl-w r
Ctrl-w R
rotate windows downwards/rightwards
upwards, leftwards
Ctrl-w x exchange current window with next one or with Nth window if count is given. The two exchanged windows must be located in the same row or column.
Ctrl-w T Move current window to a new tab

Buffer
A buffer is a file loaded into memory for editing.
Unlisted buffer: It means it exists, but it is not listed in buffer list.
active buffer:  (1) displayed in a window (2) loaded
hidden buffer:  (1) is not displayed in a window, (2) loaded into memory
inactive buffer:(1) is not displayed (2) not loaded (3) Options are remembered.
unlisted buffer: some buffers are not listed in buffer list. when you apply :bdelete or :bwipeout to a buffer, it would be deleted from buffer list.
hidden buffer -> unhidden buffer: start to edit it with any command or delete it with :bdelete command.

:q[uit] [!]  quit current window. The buffer becomes inactive.
For following three commands, modified buffers are never abandoned (never becomes inactive).
:close [!]   close current window. (1) if 'hidden' is set, the buffer becomes hidden  (2) else abandon it (becomes inactive).
:hid[e]      Quite current window and state of the buffer depends on option bufhidden.
:only[!]     Make the current window the only one in current tab. All other windows are closed.

Direct buffer editing command

# Remove association between a buffer and a file. The buffer is now just a buffer without any content.
:bd[elete][!] [N] Unload buffer [N] (default: current buffer) and delete it from buffer list. :bdelete[!] {bufname} Unload and delete buffer corresponding to {bufname} :bdelete[!] N1 N2 ... Unload and delete buffer N1, N2, ... :N,Mbdelete[!] Unload and delete all buffers in range N to M
# The buffer is removed thoroughly which means the buffer does not exist any more.

:[N]bwipout[!] Like :bdelete, but really delete the buffer. :bw[ipeout][!] {bufname} Everything releated to the buffer is lost. :N,Mbw[ipeout][!] :bw[ipeout][!] N1 N2 ...
# memory is freed. When you switch to that buffer later, the content would be read from the file.
:[N]bun[load][!] The memory allocated for those specified :bun[load][!] [N] buffers is freed. But the buffers remain in the :bunload[!]{bufname} buffer list. :N,Mbunload[!] :bunload[!] N1 N2 ...

Important options:
hidden: off - a buffer is unloaded when it is abandoned.
                   When (1) the buffer is modified and
                            (2) 'autowrite' is off or writing is not possible
                            (3) the '!' flag was used.
                   a buffer becomes hidden even if hidden option is off.
            on  - a buffer becomes hidden when it is abandoned.
bufhidden: what happens when a buffer becomes hidden.
    <empty> - follow hidden option
    hide  - the buffer becomes hidden (not unloaded)
    unload  - unload the buffer
    delete -  delete the buffer from buffer list (like using :bdelete)
    wipe - wipe out buffer from buffer list (like using :bwipeout)
When "unload", "delete" or "wipe" is used, changes in a buffer are load without any warning.

Usually, if option hidden is on, the operations of buffer manipulation commands depend on option bufhidden.
If option hidden is off, buffer is unloaded


A list of buffer/arg switch command from vim help doc:

args list		       buffer list	   meaning ~
1. :[N]argument [N]	11. :[N]buffer [N]	to arg/buf N
2. :[N]next [file ..]	12. :[N]bnext [N]	to Nth next arg/buf
3. :[N]Next [N]		13. :[N]bNext [N]	to Nth previous arg/buf
4. :[N]previous	[N]	14. :[N]bprevious [N]	to Nth previous arg/buf
5. :rewind / :first	15. :brewind / :bfirst	to first arg/buf
6. :last		16. :blast		to last arg/buf
7. :all			17. :ball		edit all args/buffers
			18. :unhide		edit all loaded buffers
			19. :[N]bmod [N]	to Nth modified buf

  split & args list	  split & buffer list	   meaning ~
21. :[N]sargument [N]   31. :[N]sbuffer [N]	split + to arg/buf N
22. :[N]snext [file ..] 32. :[N]sbnext [N]      split + to Nth next arg/buf
23. :[N]sNext [N]       33. :[N]sbNext [N]      split + to Nth previous arg/buf
24. :[N]sprevious [N]   34. :[N]sbprevious [N]  split + to Nth previous arg/buf
25. :srewind / :sfirst	35. :sbrewind / :sbfirst split + to first arg/buf
26. :slast		36. :sblast		split + to last arg/buf
27. :sall		37. :sball		edit all args/buffers
			38. :sunhide		edit all loaded buffers
			39. :[N]sbmod [N]	split + to Nth modified buf

40. :args		list of arguments
41. :buffers		list of buffers

More Misc. commands
:scriptnames    a list of sourced script files in the order they were first sourced.
:verbose set [option]
:verbose map
:echo g:colors_name
:Ctrl-w T
:read !{cmd}
:tab {cmd}    execute the external command and open the result file in a new tab. E.g. :tab split
:tab split filename
:tabedit filename
:tab ball    open all buffers, each in a separate tab page.
:tabnew |r !dir    execute command dir and redirect its output to a file opened in a new tab page.
:tabnew |:E
:echo functionname(argument)  call an internal function and returns the output
:call functionname(argument)    call an internal function and returned value is discarded.
:exe string_expr    execute the commands contained in the string in Ex mode.

Windows file association
For example, if you want to associate .txt files with vim, use following commands:

	ftype VIM="e:\program files\vim\vim72\gvim.exe" --remote-tab-silent "%1"
	assoc .txt=VIM
Replace the path with your own vim installation directory..
If you want to maximize the window, use
               ftype VIM="e:\program files\vim\vim72\gvim.exe" -c "simalt ~x" --remote-tab-silent "%1"

1 comment:

Finances said...

Here is pretty good article about advanced VIM: https://timetocode.wordpress.com/2017/03/23/level-up-vim-skills/