- cleanup API and usage, add documetation link
- introduced @property feature in getter or setter which has precedence
  over @return or @param tag if present

fixes #822

to avoid producing different results on different file systems
-> better diffs