# (see Ruby::MixinHandler) class YARD::Handlers::Ruby::Legacy::MixinHandler < YARD::Handlers::Ruby::Legacy::Base handles /\Ainclude(\s|\()/ namespace_only process do errors = [] statement.tokens[1..-1].to_s.split(/\s*,\s*/).each do |mixin| mixin = mixin.strip begin process_mixin(mixin) rescue YARD::Parser::UndocumentableError => err errors << err.message end end if errors.size > 0 msg = errors.size == 1 ? ": #{errors[0]}" : "s: #{errors.join(", ")}" raise YARD::Parser::UndocumentableError, "mixin#{msg} for class #{namespace.path}" end end private def process_mixin(mixin) unless mixmatch = mixin[/\A(#{NAMESPACEMATCH})/, 1] raise YARD::Parser::UndocumentableError end obj = Proxy.new(namespace, mixmatch) case obj when Proxy obj.type = :module when ConstantObject # If a constant is included, use its value as the real object obj = Proxy.new(namespace, obj.value) end namespace.mixins(scope).unshift(obj) unless namespace.mixins(scope).include?(obj) end end