" meisterluk's .vimrc
" ===================
"
" :date:     09.12.06
" :author:   Lukas Prokop <admin@lukas-prokop.at>
" :license:  BSD
" :created:  using vim ;)
"
" USEFUL REFERENCES
" -----------------
"
" vimtutor
" http://newbiedoc.sourceforge.net/text_editing/vim.html.en
" :help
" :help doc-file-list
" :help www
" :help quickref
"
" ABBREVIATIONS
" -------------
"
" BS = Backspace
" EOL = End of Line
"
"
" GENERAL VIM COMMANDS USAGE
" ^^^^^^^^^^^^^^^^^^^^^^^^^^
"
" Press "<Ctrl V> <key>" to insert representation 
" of key for mapping. eg. [5~
" Or see: :help key-codes
"
" view all settings
"     :set
" set setting
"     :set key=value
" unset setting
"     :set key&
" get value of setting
"     :set key?
"
"
" view all mappings
"     :map
" set mapping
"     :map! key command
"     :map key command
" unset mapping
"     :unmap key
"     :unmap! key
" get value of mapping
"     :map key


" reset
" ^^^^^
"
" reset everything to make everything logical.
" TODO: don't know any command




" scriptencoding
" ^^^^^^^^^^^^^^
"
" set default script encoding.
" not needed when file starts with a BOM.
scriptencoding utf-8

" compatibility
" ^^^^^^^^^^^^^
"
" don't use compatible mode
set nocompatible


" import
" ^^^^^^
"
" import other vimrc files
runtime! ~/.vim/*rc.vim ~/syntax/**/*

" abbreviations
" ^^^^^^^^^^^^^
"
" will be replaced in insert mode.
" this also affects the vim command line
" case-sensitive
"
" eg. abbreviate NSA National Security Agency
abbreviate GvR Guido van Rossum
"ab $py python " TODO: don't know how to escape characters

" digraph
" ^^^^^^^
"
" Writing a character, delete it with backspace and
" inserting an other, will lead to insertion of
" another character
" 
" eg. Typing 1<BS>2 will replace 2 with a 1/2-symbol.
" :help digraphs
set nodigraph

" programming
" ^^^^^^^^^^^
"
" Everything concerning general 
" configuration for programming.
" smartindent = vim thinks about
"    whitespace conventions himself
"
" [1] Keep indentation level, but no smartindent
" [2] I don't like tab. Expand tabs to 4 spaces
" [3] Show line numbers
" [4] Tabstop for smartindent
" [5] jump to other symbol when inserting character
" [6] Ability to handle indentations, EOLs and start like text
"     :help backspace?
" [7] auto-break after 80 characters
" [8] show (partial) command in the last line of the screen
"     (= show information when visualizing)
" [9] display line information in last line
" [10] do not change file permissions
set autoindent " [1]
set nosmartindent " [2]
set expandtab " [2]
set tabstop=4 " [2]
set number " [3]
set shiftwidth=4 " [4]
set showmatch " [5]
set matchtime=4 " [5]
set matchpairs=(:),{:},[:] " [5]
" set matchpairs=(:),{:},[:],<:> " [5] TODO: only for HTML
set backspace=2 " [6] more compatible; equals ":set backspace=indent,eol,start"
"set wrapmargin=80 " [7] TODO: only in python!
"set textwidth=80 " [7] TODO: only in python!
"set formatexpr=<br> " [7] TODO: only in python!
set showcmd " [8]
set ruler " [9]
set backupcopy=yes "[10]


" optimization
" ^^^^^^^^^^^^
"
" [1] limit viminfo buffer to save startup time
set viminfo='20,<50,s10"

" search
" ^^^^^^
set incsearch
set hlsearch 

" lists
" ^^^^^
"
" make whitespaces visible by showing characters
" eol, tab, trail, extends and precedes
set list
set listchars=tab:»·,trail:· ",eol:&

" Maps
" ^^^^
"
" mapping keyboard keys to commands
" TODO: replace <F2> with the Menu Key
map! <F2>a ä
map! <F2>o ö
map! <F2>u ü
map! <F2>s ß
map <C-s> :w<CR> " TODO: does not occur?!


" syntax highlighting
" ^^^^^^^^^^^^^^^^^^^
"
" Highlight regions in text file
"
" eg. highlight Comment ctermfg=green
" TODO
" :set background=[dark|light] "Tell vim about your background color 
" :filetype on " Enable automatic file type detection 
" :syntax on " Enable syntax highlighting. 
" :help html.vim

" color scheme
" ^^^^^^^^^^^^
"
" Color scheme / theme
" TODO