[erlang-bugs 3] Bug in -spec/@doc ordering in new edoc

[Andrew Thompson]

Hi, I just noticed an odd behaviour where the order in which a @doc and
a -spec appear affects whether the @doc appears in the edoc output. If I
put the -spec first, the only documentation for that function is the
spec, if I put the @doc first, they both show up.

Here's the workaround commit I had to make:

https://github.com/Vagabond/gen_smtp/commit/accfd881e92ae59946444987568217ba4bfa80c4

For some reason, the other two functions exported from that file work
fine with the 'spec before doc' style, just not this for this particular
function.

Andrew