Test case (compile it with dmd -D):

/**
---
foo;

foo;
---
 */
void test(); // 2x test.d(8): Error: function test.test unmatched --- in DDoc comment

/**
---

foo;
---
 */
void test2(); // 2x test.d(16): Error: function test.test2 unmatched --- in DDoc comment

/**
foo

---

foo;
---
 */
void test3(); // OK

void main() {}

I think I tracked this bug down to line 1119 in doc.c:

if (*p == '\n' && !summary && !namelen)

If I change it to this:

if (*p == '\n' && !summary && !namelen && !inCode)

It compiles the codes above and generates fine HTML. I honestly find the doc.c code impenetrable, so I don't know if this is the right fix. The line is for the D2 dmd, but this bug happens in D1 as well.