Doc-O-Matic associates comments with the preceding symbol:
int Foo(int i, int k);
// This is the text for Foo.
// This is more documentation for Foo.
// And even more documentation for Foo.
void Bar();
// This is the text for Bar.
The documentation in this example is:
This is the text for Foo. This more documentation
for Foo. And even more documentation for Foo.
