summaryrefslogtreecommitdiffstats
path: root/doc/ft-ruby-omni.txt
blob: dc78493bb2f9e4f6cdd090ae45a268e54863f94c (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
if !exists('g:polyglot_disabled') || index(g:polyglot_disabled, 'ruby') == -1

RUBY							*ft-ruby-omni*
							*vim-ruby-omni*

Completion of Ruby code requires that Vim be built with |+ruby|.

Ruby completion will parse your buffer on demand in order to provide a list of
completions.  These completions will be drawn from modules loaded by "require"
and modules defined in the current buffer.

The completions provided by CTRL-X CTRL-O are sensitive to the context:

          CONTEXT                          COMPLETIONS PROVIDED ~

 1. Not inside a class definition    Classes, constants and globals

 2. Inside a class definition        Methods or constants defined in the class

 3. After '.', '::' or ':'           Methods applicable to the object being
                                       dereferenced

 4. After ':' or ':foo'              Symbol name (beginning with "foo")

Notes:
 - Vim will load/evaluate code in order to provide completions.  This may
   cause some code execution, which may be a concern.  This is no longer
   enabled by default, to enable this feature add >
     let g:rubycomplete_buffer_loading = 1
< - In context 1 above, Vim can parse the entire buffer to add a list of
   classes to the completion results.  This feature is turned off by default,
   to enable it add >
     let g:rubycomplete_classes_in_global = 1
<   to your vimrc
 - In context 2 above, anonymous classes are not supported.
 - In context 3 above, Vim will attempt to determine the methods supported by
   the object.
 - Vim can detect and load the Rails environment for files within a rails
   project.  The feature is disabled by default, to enable it add >
     let g:rubycomplete_rails = 1
<   to your vimrc
 - Vim can parse a Gemfile, in case gems are being implicitly required.  To
   activate the feature: >
     let g:rubycomplete_load_gemfile = 1
<   To specify an alternative path, use: >
     let g:rubycomplete_gemfile_path = 'Gemfile.aux'
<   To use Bundler.require instead of parsing the Gemfile, set: >
     let g:rubycomplete_use_bundler = 1
<   To use custom paths that should be added to $LOAD_PATH to correctly
   resolve requires, set: >
     let g:rubycomplete_load_paths = ["/path/to/code", "./lib/example"]


 vim:tw=78:sw=4:ts=8:ft=help:norl:

endif