lsegal/yard — Issue #482: `@option options (see #other)`  doesn't work
Author: myronmarston
Created: 2012-02-01 07:04:12+00:00
State: open

Here's what I'm trying to do:

``` ruby
# @param name [#to_s] The name of the cassette. VCR will sanitize
# this to ensure it is a valid file name.
# @param options [Hash] The cassette options. The given options will
# be merged with the configured default_cassette_options.
# @option options :record [:all, :none, :new_episodes, :once] The record mode.
# @option options :erb [Boolean, Hash] Whether or not to evaluate the
# cassette as an ERB template. Defaults to false. A hash can be used
# to provide the ERB template with local variables.
def insert_cassette(name, options = {})
end

# @param (see #insert_cassette)
# @option options (see #insert_cassette)
def use_cassette(*args, &block)
cassette = insert_cassette(*args)

begin
call_block(block, cassette)
ensure
eject_cassette
end
end
```

There's a lot more doc comments in [the file](https://github.com/myronmarston/vcr/blob/master/lib/vcr.rb), but those are the pertinent ones. I want the use the `see #insert_cassette` reference tag to have it copy all the option docs over, but it's not working. Is the `see` syntax supposed to work for copying option hash docs?