document finally. closes #2795
Merge branch 'master' of github.com:JuliaLang/julia