Move behavior description from HTML comment to JSDoc. Fixes #117

[web-padawan]

/cc @rictic

---

This change is 

[googlebot]

We found a Contributor License Agreement for you (the sender of this pull request), but were unable to find agreements for the commit author(s). If you authored these, maybe you used a different email address in the git commits than was used to sign the CLA (login here to double check)? If these were authored by someone else, then they will need to sign a CLA as well, and confirm that they're okay with these being contributed to Google.
In order to pass this check, please resolve this problem and have the pull request author add another comment and the bot will run again.

[googlebot]

CLAs look good, thanks!

[web-padawan]

@notwaldorf could you merge this into 1.x please and tag a patch release so we could eliminate that annoying warning about "multiple doc comments" ? 😢