editor/README.pod - Productivity Comes in Pretty Colors
Included in this directory are some add-ins for making working on parrot (or in parrot) easier, for various popular editors. Mostly that means syntax-highlighting and automatic indenting. Read on to see what's available for your favorite editor
There are several files here, all with the .vim extension. imc.vim (generated from imc.vim.in), pasm.vim, and pmc.vim are syntax files; indent_imc.vim is an indent plugin; and filetype_parrot.vim is a filetype script that tells vim to associate the extensions .imc, .imcc, .pasm, and .pmc with the right syntax. The syntax files should be installed to ~/.vim/syntax/; filetype_parrot.vim should be installed to ~/.vim/ftdetect; indent_imc.vim should be called ~/.vim/indent/imc.vim. make in the editor/ dir will do this automatically. If you want indenting, you should also place filetype indent on somewhere in your vimrc.
.vim
imc.vim
imc.vim.in
pasm.vim
pmc.vim
indent_imc.vim
filetype_parrot.vim
~/.vim/syntax/
~/.vim/ftdetect
~/.vim/indent/imc.vim
make
editor/
filetype indent on
There is a syntax file for the KDE editor Kate, but it is not built by default. make imc.kate in editor/ to build it.
TODO: How do we install Kate syntax files?
Included here is an Emacs mode for editing pasm files, in pasm.el.
pasm.el
TODO: How do we install Emacs modes?
There is a script here to automatically generate a TAGS file, which works with Vim and other editors that recognize ctags-format files. The tool "exuberant ctags" is required. Run make tags in the parrot root directory to build the tags file.
To install Ruby, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Ruby
CPAN shell
perl -MCPAN -e shell install Ruby
For more information on module installation, please visit the detailed CPAN module installation guide.