Periods in docblock summaries

Hello, What is the reason for making the first sentence of class/method docblocks not end with a period? The PEAR documentation [1] states: The first line of any docblock is the summary. Make them one short sentence, without a period at the end. Summaries for classes, properties and constants should omit the subject and simply state the object, because they are describing things rather than actions or behaviors. This is different from Javadoc where the first sentence is considered the summary, and it breaks documentation generators based on Javadoc syntax. Mike [1] http://pear.php.net/manual/en/standards.sample.php