1<documentation title="Doc Comment Alignment"> 2 <standard> 3 <![CDATA[ 4 The asterisks in a doc comment should align, and there should be one space between the asterisk and tags. 5 ]]> 6 </standard> 7 <code_comparison> 8 <code title="Valid: Asterisks are aligned."> 9 <![CDATA[ 10/** 11<em> </em>* @see foo() 12<em> </em>*/ 13]]> 14 </code> 15 <code title="Invalid: Asterisks are not aligned."> 16 <![CDATA[ 17/** 18<em> </em>* @see foo() 19<em></em>*/ 20]]> 21 </code> 22 </code_comparison> 23 <code_comparison> 24 <code title="Valid: One space between asterisk and tag."> 25 <![CDATA[ 26/** 27 *<em> </em>@see foo() 28 */ 29]]> 30 </code> 31 <code title="Invalid: Incorrect spacing used."> 32 <![CDATA[ 33/** 34 *<em> </em>@see foo() 35 */ 36]]> 37 </code> 38 </code_comparison> 39</documentation> 40