Class: YARD::Tags::EndGroupDirective

Inherits:

Directive

• Object
• Directive
• YARD::Tags::EndGroupDirective

Defined in:

lib/yard/tags/directives.rb

Overview

Ends a group listing definition. Group definition automatically end when class or module blocks are closed, and defining a new group overrides the last group definition, but occasionally you need to end the current group to return to the default listing. Use @!group to begin a group listing.

Examples:

class Controller
  # @!group Callbacks

  def before_filter; end
  def after_filter; end

  # @!endgroup

  def index; end
end

See Also:

• @!group

Since:

• 0.6.0

Instance Attribute Summary

• #expanded_text ⇒ String^? inherited from Directive

  Set this field to replace the directive definition inside of a docstring with arbitrary text.

• #handler ⇒ Handlers::Base^? inherited from Directive readonly

  The handler object the docstring parser might be attached to.

• #object ⇒ CodeObjects::Base^? inherited from Directive readonly

  The object the parent docstring is attached to.

• #parser ⇒ DocstringParser inherited from Directive protected

  The parser that is parsing all tag information out of the docstring.

• #tag ⇒ Tag inherited from Directive

  The meta-data tag containing data input to the directive.

Parser callbacks

• #call ⇒ Object

Constructor Details

This class inherits a constructor from YARD::Tags::Directive

Instance Attribute Details

#expanded_text ⇒ String^? Originally defined in class Directive

Set this field to replace the directive definition inside of a docstring with arbitrary text. For instance, the MacroDirective uses this field to expand its macro data in place of the call to a @!macro.

Returns:

• (String) —

  the text to expand in the original docstring in place of this directive definition.

• (nil) —

  if no expansion should take place for this directive

Since:

• 0.8.0

#handler ⇒ Handlers::Base^? (readonly) Originally defined in class Directive

Returns the handler object the docstring parser might be attached to. May be nil. Only available when parsing through Parser::SourceParser.

Returns:

• (Handlers::Base, nil) —

  the handler object the docstring parser might be attached to. May be nil. Only available when parsing through Parser::SourceParser.

Since:

• 0.8.0

#object ⇒ CodeObjects::Base^? (readonly) Originally defined in class Directive

Returns the object the parent docstring is attached to. May be nil.

Returns:

• (CodeObjects::Base, nil) —

  the object the parent docstring is attached to. May be nil.

Since:

• 0.8.0

#parser ⇒ DocstringParser (protected) Originally defined in class Directive

Returns the parser that is parsing all tag information out of the docstring

Returns:

• (DocstringParser) —

  the parser that is parsing all tag information out of the docstring

Since:

• 0.8.0

#tag ⇒ Tag Originally defined in class Directive

Returns the meta-data tag containing data input to the directive

Returns:

• (Tag) —

  the meta-data tag containing data input to the directive

Since:

• 0.8.0

Instance Method Details

#call ⇒ Object

Since:

• 0.6.0

# File 'lib/yard/tags/directives.rb', line 98

def call
  return unless handler
  handler.extra_state.group = nil
end