Improve core-icon API docs.

Addresses #19.