-
Bug
-
Resolution: Fixed
-
P2
-
6
-
b61
-
generic
-
generic
The {@inheritDoc} algorithm applies "first sentence" recognition
both to the text of this main description, and the text of any
main description inherited via {@inheritDoc}, yielding
a final "first sentence" that is actually the concatenation of the
inherited first sentence plus the first sentence added in the
inheriting doc comment.
Self-explanatory shell transcript follows:
(See the summary for D2.html below)
$ cat D1.java; cat D2.java; javadoc D?.java >/dev/null && grep 'First sentence' D?.html
public class D1 {
/**
* First sentence. Second sentence.
*/
public void m() {}
}
public class D2 extends D1 {
/**
* {@inheritDoc} Third sentence. Fourth sentence.
*/
public void m() {}
}
D1.html: First sentence.</TD>
D1.html:<DD>First sentence. Second sentence.
D2.html: First sentence. Third sentence.</TD>
D2.html:<DD>First sentence. Second sentence. Third sentence. Fourth sentence.
###@###.### 2005-04-11 21:59:24 GMT
both to the text of this main description, and the text of any
main description inherited via {@inheritDoc}, yielding
a final "first sentence" that is actually the concatenation of the
inherited first sentence plus the first sentence added in the
inheriting doc comment.
Self-explanatory shell transcript follows:
(See the summary for D2.html below)
$ cat D1.java; cat D2.java; javadoc D?.java >/dev/null && grep 'First sentence' D?.html
public class D1 {
/**
* First sentence. Second sentence.
*/
public void m() {}
}
public class D2 extends D1 {
/**
* {@inheritDoc} Third sentence. Fourth sentence.
*/
public void m() {}
}
D1.html: First sentence.</TD>
D1.html:<DD>First sentence. Second sentence.
D2.html: First sentence. Third sentence.</TD>
D2.html:<DD>First sentence. Second sentence. Third sentence. Fourth sentence.
###@###.### 2005-04-11 21:59:24 GMT