Made a better check for empty comments

If an empty comment is made than there is a warning added to that
documentation object.

Also a trim method was added which takes into account the <br> element
as being trimmable