#RText VIM plugin

This is the RText plugin for VIM.

Learn more about RText.

##Prerequisites

You must have a version of VIM with Ruby support enabled. You also have to install the rtext Ruby gem:

> gem install rtext

If you don't have the latest version, you might have problems. So in this case just update:

> gem update rtext

##Installation

Make sure the syntax folder will be found by your VIM installation. Either copy it directly or use pathogen or vundle.

In order to associate a file type with the RText plugin you could add the following to your vimrc file:

autocmd BufNewFile,BufReadPost *.myext set filetype=rtext

##Usage

The plugin starts the backend service when you first invoke one of the RText commands. It will find the backend by searching for a .rtext file in the filesystem, going upwards from the location of the file being edited.

The .rtext file should have at least two lines:

*.myext:
command line of rtext service to start

When inside buffer with filetype set to "rtext", you can do the following:

• Folding: should work as expected
• Auto Completion: use omni complete
• Follow References: CTRL-]
• Find Elements: use the command RTextFind with a search string as parameter
• Error Annotations: in the quickfix list

Any output from the backend service will be written to your system's temp folder in a file named rtext.temp.<sequence number>. Check these files if the backend doesn't startup, there may be an exception thrown by the backend. You may also run your backend once directly from the command line, just to make sure that it starts at all.

##License

The RText VIM plugin is released under the MIT license.