lsegal/yard — Issue #417: Arbitrary @method tag handling
Author: dchelimsky
Created: 2011-11-27 18:09:21+00:00
State: open

Given this code from rspec-mocks:

```ruby
[ :with, :and_return, :and_raise, :and_yield,
:once, :twice, :any_number_of_times,
:exactly, :times, :never,
:at_least, :at_most
].each do |method_name|
class_eval(<<-EOM, __FILE__, __LINE__)
def #{method_name}(*args, &block)
record(:#{method_name}, *args, &block)
end
EOM
end
```

I'd like to document each of these methods using the @method tag. I tried doing it like this:

```
# @method with
# @method and_return
# etc
```

... and it only doc'd the first method. Then I tried it like this:

```
# @method with
#
# @method and_return
#
# ...
#
# @method at_most
```

... and it doc'd the first and last methods, but none in between.