Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Browse files

Rewrite installation instructions

Closes #40
  • Loading branch information...
commit da638344de15734c57df37fd35880a3276b18ce6 1 parent 3992690
@tpope tpope authored
Showing with 36 additions and 81 deletions.
  1. +0 −81 INSTALL
  2. +36 −0 INSTALL.markdown
@@ -1,81 +0,0 @@
-= Installing vim-ruby
-The vim-ruby runtime files may be installed via the vim-ruby gem or by
-downloading an archive file from
-NOTE: the installer vim-ruby-install.rb currently only supports Unix and
-Windows systems; other platforms may require a manual install. This installer
-is new and users with significant local modifications to their vim-ruby files
-are encouraged to make a manual backup prior to installation.
-== Prerequisites
-1. Vim 6.x (7.0 recommended; 7.0 compiled with the Ruby interface is required
- for omni completion)
-2. Ruby 1.8.x
-== Gem Installation
-Install the gem and run the installer which will automatically determine the
-two recommended installation locations and prompt you to select one, or allow
-you to specify a directory of your own choosing.
-$ gem install vim-ruby --remote
-$ vim-ruby-install.rb
-== Archive File Installation
-Unpack the archive file and run the installer which will automatically
-determine the two recommended installation locations or allow you to specify
-$ tar -xzf vim-ruby.YYYY.MM.DD.tgz
-$ ./vim-ruby.YYY.MM.DD/bin/vim-ruby-install.rb
-C:\tmp> [unzip] vim-ruby.YYYY.MM.DD.tgz
-C:\tmp> ruby vim-ruby.YYY.MM.DD\bin\vim-ruby-install.rb
-== Manual Installation
-Alternatively, you can simply copy the desired files to an appropriate
-directory in your runtime path. For single user use this would typically be
-$HOME/.vim on Unix systems and $HOME/vimfiles on Windows and for system-wide
-use these would be installed in $VIM/vimfiles.
-== Vim Version Dependencies
-Some features of the vim-ruby package depend on specific versions and features
-of Vim, as follows.
-=== Versions >= 7.0 compiled without the Ruby interface
-The omni completion script (autoload/rubycomplete.vim) will be installed but
-the 'omnifunc' option will not be set to use this if Vim was not compiled with
-the Ruby interface (+ruby).
-=== Versions < 7.0
-While omni completion is a Vim 7.x series feature the supplied completion
-script will still be installed to facilitate an easier upgrade. It will simply
-be ignored by versions of Vim less than 7.0.
-=== Versions < 6.3
-The supplied filetype detection script (ftdetect/ruby.vim file) will be
-installed but ignored. In order for the filetype detection to operate
-correctly the autocommands specified in ftdetect/ruby.vim need to be executed.
-See :help new-filetype, in Vim, for a mechanism to achieve this which is
-appropriate for your version of Vim.
-== Problems
-If you have any problems installing the vim-ruby configuration files please
-send a message to the mailing list ( or
-post an item to the tracker (
36 INSTALL.markdown
@@ -0,0 +1,36 @@
+In general, your favorite method work. Here are some options.
+With pathogen.vim
+Install [pathogen.vim](,
+then copy and paste:
+ git clone git:// ~/.vim/bundle/vim-ruby
+With Vundle
+Install [Vundle](, then add the
+following to your vimrc:
+ Bundle 'vim-ruby/vim-ruby'
+With patience
+Wait for an upgrade to Vim and install it. Vim ships with the latest
+version of vim-ruby at the time of its release. (Remember this when
+choosing another installation method. The version you download will
+supersede the version that ships with Vim, so you will now be
+responsible for keeping it up-to-date.)
+[Download]( and
+extract an archive, and run `bin/vim-ruby-install.rb` to copy the
+relevant files to `~/.vim`.
Please sign in to comment.
Something went wrong with that request. Please try again.