fix doc blocks
minor #93 fix doc blocks (Sorien)

This PR was submitted for the master branch but it was merged into the 1.1 branch instead (closes #93).

Discussion
----------

fix doc blocks

prevent IDE (as PhpStorm) to mark `$app['foo'] = $app->protect(function () ... );` as `Expected object, got callable`

Commits
-------

757e766 fix doc blocks
Merge branch '1.1'

* 1.1:
  fix doc blocks

Conflicts:
	lib/Pimple.php
unified @return and @param tags