fixes #997

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

correct creation of new Sort object if none is there

I'm not sure if echo should be mentioned, but without the echo before the LinkPager::widget() the user would see nothing.