If the comment block does not begin on the same line, it will not be associated with that symbol. If you write your comments as follows, you need to select the Associate comments with previous symbol check box.
int Foo(int i, int k);
// This is the text for Foo.
void Bar(); // This is the text for Bar.
The text This is the text for Foo. will not be associated with the symbol Foo because it does not begin on the same line.
