add description and file encoding
remove RewriteRule type alias
fix for HTML samples in scaladoc comments as (contrary to scaladoc's documentation) they are not encoded automatically