Merge branch 'master' into doc-tags

[vjetteam](https://github.com/vjetteam),

[Chris Westbrook](https://github.com/cnstaging),

[Scott Whittaker](https://github.com/scottrobertwhittaker),

[Timo Tijhof](https://github.com/Krinkle),

and many-many others who reported bugs, submitted patches, and

provided a lot of useful input.

  s.required_rubygems_version = ">= 1.3.5"

  s.name = 'jsduck'

  s.version = '4.5.1'

  s.date = '2012-12-07'

  s.version = '4.6.0'

  s.date = '2013-01-09'

  s.summary = "Simple JavaScript Duckumentation generator"

  s.description = "Documentation generator for Sencha JS frameworks"

  s.homepage = "https://github.com/senchalabs/jsduck"

  s.add_dependency 'rdiscount'

  s.add_dependency 'json'

  s.add_dependency 'parallel'

  s.add_dependency 'therubyracer', '<= 0.11.0beta8'

  s.add_dependency 'therubyracer', '>= 0.10.0', '< 0.11.0'

  s.add_development_dependency 'rspec'

  s.add_development_dependency 'rake'

require 'jsduck/importer'

require 'jsduck/return_values'

require 'jsduck/lint'

require 'jsduck/circular_deps'

module JsDuck

    # Do all kinds of post-processing on relations.

    def apply_extra_processing

      CircularDeps.new(@relations).check_all

      InheritDoc.new(@relations).resolve_all

      Importer.import(@opts.imports, @relations, @opts.new_since)

      ReturnValues.auto_detect(@relations)

require 'jsduck/logger'

module JsDuck

  # Checks for circular dependencies

  class CircularDeps

    def initialize(classes)

      @classes = classes

    end

    # Checks all classes for circular dependencies.

    #

    # When found, exits with a fatal error message.

    def check_all

      @classes.each do |cls|

        if chain = check(cls)

          Logger.fatal("Class #{cls[:name]} has a circular dependency: #{chain}")

          exit 1

        end

      end

    end

    # Checks class for circular dependencies.

    #

    end

    def detect_return(doc_map)

      has_return_tag = !!extract(doc_map, :return)

      ret = extract(doc_map, :return) || {}

      return {

        :type => ret[:type] || "undefined",

        :type => ret[:type] || (has_return_tag ? "Object" : "undefined"),

        :name => ret[:name] || "return",

        :doc => ret[:doc] || "",

        :properties => doc_map[:return] ? detect_subproperties(:return, doc_map[:return]) : []