Change definition of summary/description break

In this commit I have made the following documentation changes:

- Changed short description to summary
- Changed long description to description
- Changed example mail address
- Changed definition when a summary breaks and becomes a description
  to match PSR-5 and actual usage.

See: https://github.com/phpDocumentor/ReflectionDocBlock/issues/34#issuecomment-49510977
Umm, no. I mean what I have written. The "e.g." could benefit from quotes as that makes the distinction between that and the comma more visible but this is an example of a [parenthetical phrase](http://www.dailywritingtips.com/8-types-of-parenthetical-phrases/). The parenthetical phrase 'for example' was intended to indicate that version number was just one of many examples.

I hope I did not interpret your posting in the wrong way