Some changes to code documentation:

used @slot tag in class definition
used \linkS4class for links to classes
added a few more @param tags
added a few more code comments
fixed some typos
wrapped some very long comments
Merge branch 'knitr' of https://github.com/gustavdelius/mizer into knitr
Take out code change. This branch is for changes to documentation only