puppetlabs/puppet · error · ArgumentError

author must be a string; use multiple statements for multipl

Error message

author must be a string; use multiple statements for multiple authors

What it means

Error "author must be a string; use multiple statements for multiple authors" thrown in puppetlabs/puppet.

Source

Thrown at lib/puppet/interface/documentation.rb:207

      @short_description
    end

    # @overload author(value)
    #   Adds an author to the documentation for this object. To set
    #   multiple authors, call this once for each author.
    #   @param value [String] the name of the author
    #   @api public
    #   @dsl Faces
    # @overload author
    #   Returns a list of authors
    #   @return [String, nil] The names of all authors separated by
    #     newlines, or `nil` if no authors have been set.
    #   @api private
    def author(value = nil)
      unless value.nil? then
        unless value.is_a? String
          # TRANSLATORS 'author' is an attribute name and should not be translated
          raise ArgumentError, _('author must be a string; use multiple statements for multiple authors')
        end

        if value =~ /\n/ then
          # TRANSLATORS 'author' is an attribute name and should not be translated
          raise ArgumentError, _('author should be a single line; use multiple statements for multiple authors')
        end

        @authors.push(Puppet::Interface::DocGen.strip_whitespace(value))
      end
      @authors.empty? ? nil : @authors.join("\n")
    end

    # Returns a list of authors. See {author}.
    # @return [String] The list of authors, separated by newlines.
    # @api private
    def authors
      @authors
    end

View on GitHub (pinned to e227c27540)

When it happens

Trigger: Thrown at lib/puppet/interface/documentation.rb:207 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of puppetlabs/puppet@e227c27540 (2026-08-21). Data as JSON: /api/errors/fc382e02e36076c0. Report an issue: GitHub.