More documentation
Make more clear where methods were added for compatibility to 'Toolkit for Dart'

Change 'pixel' to 'stage coordinates'
Other corrections
Remove custom event example
Merge pull request #151 from marcojakob/documentation-display-library

Display library documentation
Merge pull request #152 from marcojakob/remove-mouseevent-example

Remove custom event example
Minor DisplayObject comment updates