I guess that depends on the doc statement. Based on Javadocs's manual:

>When writing a phrase followed by a sentence, do not capitalize the phrase, but end it with a period to distinguish it from the start of the next sentence

I think we can safely ignore this one for now and leave it to the discretion of the author to ensure the syntax.