Project

General

Profile

Actions

Bug #13275

closed

RDoc bug for "Document-method: []"

Added by stomar (Marcus Stollsteimer) about 7 years ago. Updated almost 5 years ago.

Status:
Closed
Assignee:
-
Target version:
-
ruby -v:
ruby 2.4.0p0 (2016-12-24 revision 57164) [x86_64-linux]
[ruby-core:79894]

Description

RDoc doesn't handle Document-method directives for #[] correctly. When multiple directives are given, "Document-method: []" shows up as a code block, at the beginning of the docs for the method of the directive before:

$ cat document-method-test.c 
/*
 * Document-method: foo
 * Document-method: []
 * Document-method: bar
 *
 * Does nothing.
 */
static VALUE
rb_my_method(void)
{

}

rb_cFoo = rb_define_class("Foo", rb_cObject);
rb_define_method(rb_cFoo, "foo", rb_my_method, 0);
rb_define_method(rb_cFoo, "bar", rb_my_method, 0);
rb_define_method(rb_cFoo, "[]", rb_my_method, 0);

The directive affects the docs for #foo:

$ rdoc --ri document-method-test.c -o mydoc
$ ri Foo.foo -d mydoc

Foo.foo

(from /.../.../mydoc)
------------------------------------------------------------------------------
  foo()

------------------------------------------------------------------------------

  Document-method: []

Does nothing.

When the order of the Document-method directives is changed, with Document-method: [] as the first one, everything is rendered correctly.

Real life example: https://docs.ruby-lang.org/en/2.3.0/Proc.html#method-i-call


Related issues 1 (0 open1 closed)

Related to Ruby master - Bug #13273: [DOC] Proc#call docs show "Document-method: []" directiveClosedstomar (Marcus Stollsteimer)Actions
Actions

Also available in: Atom PDF

Like0
Like0Like0Like0