2012-07-21 2 views
0

Я действительно хочу понять, в чем смысл этого правила. Разве не очевидно, что конструктор «Инициализирует новый экземпляр класса»?Какова точка правила, которое обеспечивает сводку конструктора, чтобы сказать: «Инициализирует новый экземпляр класса <whatever>»?

ощущению как это то же самое принуждать сводку способов сказать «это метод, он будет делать что-то, возвращение и, возможно, возвращают значение»

ответ

1

ИМО, это один в основном о непротиворечивости конструктора резюме, а не формулировку какого-либо конкретного резюме конструктора. Если вам требуется, чтобы конструкторы имели сводки, но не проверяли согласованную формулировку, вы получите множество стилей описаний. Это не совсем конец света, но это то, что может раздражать пользователей API.

Если у вас есть основания для того, чтобы правило позволяло и требовало простого способа генерации стандартных резюме конструктора, вы можете взглянуть на GhostDoc.