[Fix #1090] Correct handling of documentation vs annotation comment

Regard comment as valid documentation comment if at least one line
is not an annotation comment.
Merge pull request #1127 from jonas054/1090_doc_with_annotation

[Fix #1090] Correct handling of documentation vs annotation comment