port and update documentation w.r.t. deprecated functionality

renndered version available at http://boegel-eb.readthedocs.org/en/deprecated/Deprecated-functionality.html
maybe better
```
That is, EasyBuild version X.Y should correctly build packages that worked with EasyBuild version X.(Y-1)
```