Update api.md

fix a slight copy/cut error that misled me for 10 minutes ;)
Merge pull request #282 from Offirmo/patch-1

Update api.md : fix slight copy/paste error
move decorators into separate folder in lib
Merge pull request #287 from jenius/categorize-decorators

Categorize decorators
Skip cycle checking in resolve() when not needed
Remove when.race from api docs. Fix #291
Remove when3 branch from travis. Temporarily disable saucelabs testing because of timeout issues between travis and saucelabs.
Changed defaultStackFilter to match windows paths
Make PromiseMonitor call reporter.configurePromiseMonitor if available. See #270
Merge branch 'master' into dev
Update file header comment
Update docs. PrettyMonitor compatibility ftw
Flatten more cases in all, isolate non-promise value case
Move some logic from makePromise to PromiseMonitor
Simplify monitor handling, save some bytes
Use continuation object to thread context though handlers.

This replaces the argument list approach, which was verbose
and confusing, especially when looping and unpacking the
arguments, with an object with named properties.  It makes
the code much more readable and compact.

There seems to be little to no performance impact AS LONG
AS CONTINUATIONS ARE MONOMORPHIC.  Forgetting to set a
property on a continuation can lead to a major perf hit
on v8.  We may want to create an actual Continuation
constructor to help, but I don't feel the need just yet.

This change also has the nice side benefit of saving about
50 bytes from the min+gzip build.
Fix doc typos
Move id generation to PromiseMonitor
Simplify monitoring. reduce reporting delay, can get away with almost no delay at all now.
add promise.fold