You should declare your parameters using :call-seq:
, and not include your parameter list in the :method:
line. The following works for me, and all the links work:
module Adapter
##
# :method: avatar
##
# :method: avatar=
#
# :call-seq: avatar=(value)
end
# See Adapter#avatar
# See Adapter#avatar=
#
class Linked
end
:method:
declares the name of the method, and :call-seq:
declares the parameter signature it accepts.
(And BTW, I found some very helpful documentation on RDoc syntax here).