在 DocBlocks 中,我是否应该在写一行时始终使用单行符号?
In DocBlocks, should I always use a single line notation when writing one line?
假设我有一行 summary
,我必须这样纠正它吗:
/** summary */
或者我可以这样写吗:
/**
* summary
*/
我更喜欢第二个选项,但是使用第一个选项是否需要这样做?
根据 the documentation,"DocComments may be a single line in size but may also span multiple lines"(强调我的。)
因此,您可以采用任何一种方式。
假设我有一行 summary
,我必须这样纠正它吗:
/** summary */
或者我可以这样写吗:
/**
* summary
*/
我更喜欢第二个选项,但是使用第一个选项是否需要这样做?
根据 the documentation,"DocComments may be a single line in size but may also span multiple lines"(强调我的。)
因此,您可以采用任何一种方式。