alohaeditor/Aloha-Editor — pull request #676 by wimleers (2012-08-16 08:37:30+00:00)
Title: Annotate UI Container API methods as @api methods and document them.

Title says it all. It is to the best of my understanding, but I'm sure I'm missing subtleties in the documentation.

Furthermore, what is the point of having `childForeground` if in the `common/ui/tabs.js implementation just calls `foreground`, completely ignoring the `childComponent` argument of the former?

It effectively means the specificity of this call is pointless AFAICT:

```
$ egrep -rn "childForeground\(" .
./ui/lib/component.js:112:	this.container.childForeground(this);
```