Those are different comment blocks, just like is done in other places. Rdoc
(4.1.0.preview) is covering both methods.
On Nov 8, 2013 2:04 AM, "windwiny" <notifications@github.com> wrote:

> In ext/openssl/ossl_asn1.c:
>
> > @@ -1371,6 +1381,14 @@ static VALUE ossl_asn1_decode0(unsigned char **pp, long length, long *offset,
> >      return Qtrue;
> >  }
> >
> > +/* Document-method: OpenSSL::ASN1::ObjectId.sn
> > + *
> > + * The short name of the ObjectId, as defined in <openssl/objects.h>.
> > + */
> > +/* Document-method: OpenSSL::ASN1::ObjectId.short_name
> > + *
> > + * +short_name+ is an alias to +sn+
> > + */
> >  static VALUE
>
> /* Document-method: XXX
> *
>
>    - xxx *
>    - Document-method: YYY *
>    - yyy */
>
> rdoc html can see message "yyy", not "xxx"
>
> —
> Reply to this email directly or view it on GitHub<https://github.com/ruby/ruby/pull/436/files#r7520418>
> .
>