xref: /vim-8.2.3635/runtime/ftplugin/ruby.vim (revision d5cdbeb8)
1" Vim filetype plugin
2" Language:	Ruby
3" Maintainer:	Gavin Sinclair <gsinclair at soyabean.com.au>
4" Info:		$Id$
5" URL:		http://vim-ruby.sourceforge.net
6" Anon CVS:	See above site
7" Licence:	GPL (http://www.gnu.org)
8" Disclaimer:
9"    This program is distributed in the hope that it will be useful,
10"    but WITHOUT ANY WARRANTY; without even the implied warranty of
11"    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12"    GNU General Public License for more details.
13" ----------------------------------------------------------------------------
14"
15" Original matchit support thanks to Ned Konz.	See his ftplugin/ruby.vim at
16"   http://bike-nomad.com/vim/ruby.vim.
17" ----------------------------------------------------------------------------
18
19" Only do this when not done yet for this buffer
20if (exists("b:did_ftplugin"))
21  finish
22endif
23let b:did_ftplugin = 1
24
25let s:cpo_save = &cpo
26set cpo&vim
27
28" Matchit support
29if exists("loaded_matchit") && !exists("b:match_words")
30  let b:match_ignorecase = 0
31
32 " TODO: improve optional do loops
33 let b:match_words =
34    \ '\%(' .
35    \	  '\%(\%(\.\|\:\:\)\s*\|\:\)\@<!\<\%(class\|module\|begin\|def\|case\|for\|do\)\>' .
36    \	'\|' .
37    \	  '\%(\%(^\|\.\.\.\=\|[\,;=([<>~\*/%!&^|+-]\)\s*\)\@<=\%(if\|unless\|until\|while\)\>' .
38    \ '\)' .
39    \ ':' .
40    \ '\%(' .
41    \	  '\%(\%(\.\|\:\:\)\s*\|\:\)\@<!\<\%(else\|elsif\|ensure\|when\)\>' .
42    \	'\|' .
43    \	  '\%(\%(^\|;\)\s*\)\@<=\<rescue\>' .
44    \ '\)' .
45    \ ':' .
46    \ '\%(\%(\.\|\:\:\)\s*\|\:\)\@<!\<end\>'
47
48  let b:match_skip =
49     \ "synIDattr(synID(line('.'),col('.'),0),'name') =~ '" .
50     \ "\\<ruby\\%(String\\|StringDelimiter\\|ASCIICode\\|Interpolation\\|" .
51     \ "NoInterpolation\\|Escape\\|Comment\\|Documentation\\)\\>'"
52
53endif
54
55setlocal formatoptions-=t formatoptions+=croql
56
57setlocal include=^\\s*\\<\\(load\\\|\w*require\\)\\>
58setlocal includeexpr=substitute(substitute(v:fname,'::','/','g'),'$','.rb','')
59setlocal suffixesadd=.rb
60
61" TODO:
62"setlocal define=^\\s*def
63
64setlocal comments=:#
65setlocal commentstring=#\ %s
66
67if !exists("s:rubypath")
68  if executable("ruby")
69    let s:code = "print ($: + begin; require %q{rubygems}; Gem.all_load_paths.sort.uniq; rescue LoadError; []; end).join(%q{,})"
70    if &shellxquote == "'"
71      let s:rubypath = system('ruby -e "' . s:code . '"')
72    else
73      let s:rubypath = system("ruby -e '" . s:code . "'")
74    endif
75    let s:rubypath = '.,' . substitute(s:rubypath, '\%(^\|,\)\.\%(,\|$\)', ',,', '')
76  else
77    " If we can't call ruby to get its path, just default to using the
78    " current directory and the directory of the current file.
79    let s:rubypath = ".,,"
80  endif
81endif
82
83let &l:path = s:rubypath
84
85if has("gui_win32") && !exists("b:browsefilter")
86  let b:browsefilter = "Ruby Source Files (*.rb)\t*.rb\n" .
87		     \ "All Files (*.*)\t*.*\n"
88endif
89
90let b:undo_ftplugin = "setl fo< inc< inex< sua< def< com< cms< path< "
91      \ "| unlet! b:browsefilter b:match_ignorecase b:match_words b:match_skip"
92
93let &cpo = s:cpo_save
94unlet s:cpo_save
95
96"
97" Instructions for enabling "matchit" support:
98"
99" 1. Look for the latest "matchit" plugin at
100"
101"	  http://www.vim.org/scripts/script.php?script_id=39
102"
103"    It is also packaged with Vim, in the $VIMRUNTIME/macros directory.
104"
105" 2. Copy "matchit.txt" into a "doc" directory (e.g. $HOME/.vim/doc).
106"
107" 3. Copy "matchit.vim" into a "plugin" directory (e.g. $HOME/.vim/plugin).
108"
109" 4. Ensure this file (ftplugin/ruby.vim) is installed.
110"
111" 5. Ensure you have this line in your $HOME/.vimrc:
112"	  filetype plugin on
113"
114" 6. Restart Vim and create the matchit documentation:
115"
116"	  :helptags ~/.vim/doc
117"
118"    Now you can do ":help matchit", and you should be able to use "%" on Ruby
119"    keywords.	Try ":echo b:match_words" to be sure.
120"
121" Thanks to Mark J. Reed for the instructions.	See ":help vimrc" for the
122" locations of plugin directories, etc., as there are several options, and it
123" differs on Windows.  Email [email protected] if you need help.
124"
125
126" vim: nowrap sw=2 sts=2 ts=8 ff=unix:
127