Document issues with multiple decorators

[rkern]

The @profile decorator needs to be the most proximate decorator to the function since it registers the function object itself with the profiler. Also, since it replaces the function with a wrapper, subsequent decorators may not work since it necessarily mucks with the signature.