* Documentation/topdocs/INSTALL.texi: give even more detailed orders.

[lilypond.git] / Documentation / topdocs / INSTALL.texi

diff --git a/Documentation/topdocs/INSTALL.texi b/Documentation/topdocs/INSTALL.texi
index 1ad727d8dec4683feb405b0d8e189921dd7d95bd..7c34d3c6a3bc14f5a0c8776ff4057adc5e7141bd 100644 (file)
--- a/Documentation/topdocs/INSTALL.texi
+++ b/Documentation/topdocs/INSTALL.texi
@@ -238,14 +238,30 @@ to your @var{load-path}. Append the following line (modified) to your
 
 @section Vim mode
 
-@c lilypond.words.el for vim auto-completion?
-A Vim mode for entering music and running LilyPond is contained in
-the source archive. Copy recursively the file structure in @file{vim/} as 
-your @file{~/.vim/} to get shortcuts. Install (generated) files
-@file{lilypond.words.el} and @file{lilypond.words.vim} to 
-@file{~/.vim/syntax/} in order to get auto-completion and syntax 
-highlighting.
-
+A Vim mode for entering music and running LilyPond is contained in the 
+source archive. For version 6.2 and newer, Vim-mode works directly after 
+installing LilyPond. Otherwise, complete the following two steps.
+
+For earlier versions (and if @code{$VIM} environment variable does not
+fall-back to @file{/usr/local/share/vim}, see @code{:version} in vim), 
+the LilyPond file type is detected if your file @file{~/.vim/filetype.vim} @c
+has the following content:
+@example
+       if exists("did_load_filetypes")
+         finish
+       endif
+       augroup filetypedetect
+         au! BufNewFile,BufRead *.ly           setf lilypond
+       augroup END
+@end example
+If Vim has been (pre-)installed to @file{/usr/...} (or any other place) 
+instead of @file{/usr/local/...}, then @file{/usr/local/share/vim} may not 
+be specified in your @code{$VIMRUNTIME} environment variable and you have to 
+include this path explicitly by appending the following line to your 
+@file{~/.vimrc}:
+@example
+       set runtimepath+=/usr/local/share/vim/
+@end example
 
 @section Problems