Docblock fixes.
Added tests, documentation for limitations.