Refine type-annotations of curried functions

[RaoulSchaffranek]

Most of the factory-functions are curried and are annotated with return-type callable. This type is not very precise.

Phan provides refined types for callable and closure, that let's us type the argument and return-types of the function under question. These types are not defined in phpDocumentor-standard though.

Refine type-annoations for curried functions and check integration with phpDocumentor.