jsduck 3.0.pre2 → 3.0.pre3

data/README.md

@@ -49,17 +49,24 @@ single .exe file.  Grab it from the [download page][].
 Usage
 -----
 
-For the simplest test-run just pass in the src/ dir of Ext JS 4:
+For the simplest test-run just use the `--builtin-classes` option to
+automatically produce documentation for JavaScript builtin classes
+like Array, String and Object:
 
-    $ jsduck ext-4.0.2a/src --output your/docs
+    $ jsduck --builtin-classes --output your/docs
+
+You can also use `--verbose` option to see what's actually happening.
+
+To generate docs for Ext JS 4 add path to the corresponding src/ dir:
+
+    $ jsduck --builtin-classes --output your/docs  extjs-4.0.2a/src
 
 Running JSDuck with the current ext-4.0.2a release is expected to
 generate a lot of warnings.  Because of the bugs in doc-comments a
 global class will also get created.  You can disable this by adding
 `--ignore-global` switch.  If you are bothered by the excessive amount
-of warnings, use the `--no-warnings` switch.  Now it might look like
-nothing is happening... check out the `--verbose` flag.  For more
-command line options type `jsduck --help`.
+of warnings, use the `--no-warnings` switch.  For full list of command
+line options type `jsduck --help=full`.
 
 The latest ext-4.0.6 release will produce only few warnings, so use
 that if you can get it.
@@ -79,7 +86,7 @@ source files for these.
 To generate docs for your own project, simply add as many other input
 directories as needed:
 
-    $ jsduck ext-4.0.2a/src project1/js project2/js --output your/docs
+    $ jsduck --builtin-classes ext-4.0.2a/src project1/js project2/js --output your/docs
 
 Of course you don't have to include the whole Ext JS into your
 documentation, but if your project is built on top of it, it makes
@@ -102,7 +109,7 @@ See [Hacking guide](https://github.com/senchalabs/jsduck/wiki/Hacking) in wiki.
 Documenting your code
 ---------------------
 
-All the supported syntax is described in the [Guide][]. 
+All the supported syntax is described in the [Guide][].
 
 
 Copying

data/Rakefile

@@ -27,6 +27,8 @@ def load_sdk_vars
     puts "    OUT_DIR='/path/to/ouput/dir'"
     puts "    # path to SDK (for developers at Sencha)"
     puts "    SDK_DIR='/path/to/SDK'"
+    puts "    # path to Animator (for developers at Sencha)"
+    puts "    ANIMATOR_DIR='/path/to/Animator'"
     exit 1
   end
 end
@@ -93,6 +95,8 @@ def compress
   # Now do everything that follows in template-min/ dir
   dir = "template-min"
 
+  # Create JSB3 file for Docs app
+  system("sencha", "create", "jsb", "-a", "#{dir}/build-js.html", "-p", "#{dir}/app.jsb3")
   # Concatenate files listed in JSB3 file
   system("sencha", "build", "-p", "#{dir}/app.jsb3", "-d", dir)
   # Remove intermediate build files
@@ -143,6 +147,7 @@ class JsDuckRunner
     @sdk_dir = SDK_DIR
     @out_dir = OUT_DIR
     @ext_dir = EXT_DIR
+    @animator_dir = ANIMATOR_DIR
   end
 
   def add_options(options)
@@ -163,22 +168,42 @@ class JsDuckRunner
       "--guides", "#{@sdk_dir}/extjs/docs/guides.json",
       "--videos", "#{@sdk_dir}/extjs/docs/videos.json",
       "--examples", "#{@sdk_dir}/extjs/examples/examples.json",
-      "--inline-examples", "#{@sdk_dir}/extjs/docs/resources",
       "--categories", "#{@sdk_dir}/extjs/docs/categories.json",
       "--output", "#{@out_dir}",
       "--builtin-classes",
+      "--images", "#{@sdk_dir}/extjs/docs/resources",
+      "--images", "#{@sdk_dir}/platform/docs/resources",
       "#{@sdk_dir}/extjs/src",
       "#{@sdk_dir}/platform/src",
       "#{@sdk_dir}/platform/core/src",
     ]
   end
 
+  def add_ext3
+    @options += [
+      "--title", "Sencha Docs - Ext JS 3.4",
+      "--footer", "Ext JS 3.4 Docs - Generated with <a href='https://github.com/senchalabs/jsduck'>JSDuck</a> revison #{revision}",
+      "--categories", "#{@sdk_dir}/../ext-3.4.0/src/categories.json",
+      "--ignore-global",
+      "--output", "#{@out_dir}",
+      "#{@sdk_dir}/../ext-3.4.0/src/core",
+      "#{@sdk_dir}/../ext-3.4.0/src/data",
+      "#{@sdk_dir}/../ext-3.4.0/src/dd",
+      "#{@sdk_dir}/../ext-3.4.0/src/direct",
+      "#{@sdk_dir}/../ext-3.4.0/src/ext-core/src",
+      "#{@sdk_dir}/../ext-3.4.0/src/state",
+      "#{@sdk_dir}/../ext-3.4.0/src/util",
+      "#{@sdk_dir}/../ext-3.4.0/src/widgets"
+    ]
+  end
+
   def add_ext4
     @options += [
       "--title", "Sencha Docs - Ext JS 4.0",
       "--footer", "Ext JS 4.0 Docs - Generated with <a href='https://github.com/senchalabs/jsduck'>JSDuck</a> revison #{revision}",
       "--ignore-global",
       "--no-warnings",
+      "--images", "#{@ext_dir}/docs/doc-resources",
       "--output", "#{@out_dir}",
       "#{@ext_dir}/src",
     ]
@@ -186,24 +211,138 @@ class JsDuckRunner
 
   def add_touch
     head_html = <<-EOHTML
-      <link rel="canonical" href="http://docs.sencha.com/touch/1-0/" />
-      <meta name="description" content="Sencha Touch 1.0 API Documentation from Sencha. Documentation on how to create Javascript applications with Sencha Touch">
+      <link rel="canonical" href="http://docs.sencha.com/touch/1-1/" />
+      <meta name="description" content="Sencha Touch 1.1 API Documentation from Sencha. Documentation on how to create Javascript applications with Sencha Touch">
     EOHTML
 
     @options += [
-      "--title", "Sencha Docs - Touch 1.0",
+      "--title", "Sencha Docs - Touch 1.1",
       "--head-html", head_html,
-      "--footer", "Sencha Touch 1.0 Docs - Generated with <a href='https://github.com/senchalabs/jsduck'>JSDuck</a> revison #{revision}",
+      "--footer", "Sencha Touch 1.1 Docs - Generated with <a href='https://github.com/senchalabs/jsduck'>JSDuck</a> revison #{revision}",
       "--categories", "#{@sdk_dir}/touch/doc-resources/categories.json",
       "--videos", "#{@sdk_dir}/touch/doc-resources/videos.json",
       "--output", "#{@out_dir}",
       "--external=google.maps.Map,google.maps.LatLng",
+      "--images", "#{@sdk_dir}/touch/doc-resources",
       "#{@sdk_dir}/touch/resources/themes/stylesheets/sencha-touch/default",
     ]
 
     @options += extract_jsb_build_files("#{@sdk_dir}/touch/sencha-touch.jsb3")
   end
 
+  def add_touch2
+    head_html = <<-EOHTML
+      <link rel="canonical" href="http://docs.sencha.com/touch/2-0/" />
+      <meta name="description" content="Sencha Touch 2.0 API Documentation from Sencha. Documentation on how to create Javascript applications with Sencha Touch">
+    EOHTML
+
+    @options += [
+      "--title", "Sencha Docs - Touch 2.0",
+      "--head-html", head_html,
+      "--footer", "Sencha Touch 2.0 Docs - Generated with <a href='https://github.com/senchalabs/jsduck'>JSDuck</a> revison #{revision}",
+      "--categories", "#{@sdk_dir}/touch/docs/categories.json",
+      "--welcome", "template/touch-welcome.html",
+      "--videos", "#{@sdk_dir}/touch/docs/videos.json",
+      "--guides", "#{@sdk_dir}/touch/docs/guides.json",
+      "--examples", "#{@sdk_dir}/touch/docs/examples.json",
+      "--touch-examples-ui",
+      "--output", "#{@out_dir}",
+      "--external=google.maps.Map,google.maps.LatLng",
+      "--builtin-classes",
+      "--img", "<p class='screenshot'><img src='%u' alt='%a'><span>%a</span></p>",
+      "#{@sdk_dir}/touch/resources/themes/stylesheets/sencha-touch/default",
+    ]
+
+    @options += extract_jsb_build_files("#{@sdk_dir}/touch/touch.jsb3")
+  end
+
+  def add_touch_export
+    @options += [
+      "--json",
+      "--output", "#{@out_dir}/../export/touch1",
+      "--external=google.maps.Map,google.maps.LatLng",
+    ]
+    @options += extract_jsb_build_files("#{@sdk_dir}/touch/sencha-touch.jsb3")
+  end
+
+  def add_touch2_export
+    @options += [
+      "--json",
+      "--output", "#{@out_dir}/../export/touch2",
+      "--external=google.maps.Map,google.maps.LatLng",
+    ]
+    @options += extract_jsb_build_files("#{@sdk_dir}/touch/touch.jsb3")
+  end
+
+  def set_touch2_src
+    relative_touch_path = "../"
+    touch_iframe = "template-min/touchIframe.html";
+
+    ["template-min/touchIframe.html", "template-min/touch-welcome.html"].each do |file|
+      html = IO.read(file);
+
+      touch_src_re = /((src|href)="touch)/m
+      out = []
+
+      html.each_line do |line|
+        out << line.sub(/((src|href)="touch\/)/, '\2="' + relative_touch_path)
+      end
+
+      File.open(file, 'w') {|f| f.write(out) }
+    end
+
+    head_html = <<-EOHTML
+      <script type="text/javascript">
+        Docs.exampleBaseUrl = "#{relative_touch_path}examples/";
+        if (Ext.is.Phone) { window.location = "#{relative_touch_path}examples/"; }
+      </script>
+      <div id="notice-text" style="display: none">
+        Use <a href="http://docs.sencha.com/touch/2-0">http://docs.sencha.com/touch/2-0</a> for up to date documentation and features
+      </div>
+    EOHTML
+
+    @options += [
+      "--welcome", "template-min/touch-welcome.html",
+      "--body-html", head_html
+    ]
+  end
+
+  def add_touch_charts
+    head_html = <<-EOHTML
+      <link rel="canonical" href="http://docs.sencha.com/touch-charts/1-0/" />
+      <meta name="description" content="Sencha Touch Charts 1.0 API Documentation. Documentation on how to create Charts with Sencha Touch">
+    EOHTML
+
+    @options += [
+      "--title", "Sencha Docs - Touch Charts 1.0",
+      "--head-html", head_html,
+      "--footer", "Sencha Touch Charts 1.0 Docs - Generated with <a href='https://github.com/senchalabs/jsduck'>JSDuck</a>",
+      "--categories", "#{@sdk_dir}/charts/docs/categories.json",
+      "--guides", "#{@sdk_dir}/charts/docs/guides.json",
+      "--images", "#{@sdk_dir}/charts/docs/resources",
+      "--output", "#{@out_dir}"
+    ]
+
+    @options += extract_jsb_build_files("#{@sdk_dir}/charts/touch-charts.jsb3")
+  end
+
+  def add_animator
+    head_html = <<-EOHTML
+      <link rel="canonical" href="http://docs.sencha.com/animator/1-0/" />
+      <meta name="description" content="Sencha Animator 1.0 API Documentation from Sencha. Documentation on how to create Javascript applications with Sencha Touch">
+    EOHTML
+
+    @options += [
+      "--title", "Sencha Docs - Animator 1.0",
+      "--head-html", head_html,
+      "--footer", "Sencha Animator 1.0 Docs - Generated with <a href='https://github.com/senchalabs/jsduck'>JSDuck</a> revison #{revision}",
+      # "--videos", "#{@animator_dir}/docs/videos.json",
+      "--guides", "#{@animator_dir}/docs/guides.json",
+      # "--examples", "#{@animator_dir}/docs/examples/examples.json",
+      "--output", "#{@out_dir}",
+    ]
+  end
+
   # Extracts files of first build in jsb file
   def extract_jsb_build_files(jsb_file)
     json = JSON.parse(IO.read(jsb_file))
@@ -246,6 +385,16 @@ class JsDuckRunner
     ]
   end
 
+  def add_touch2_export_notice
+    @options += [
+      "--body-html", <<-EOHTML
+      <div id="notice-text" style="display: none">
+        Use <a href="http://docs.sencha.com/touch/2-0">http://docs.sencha.com/touch/2-0</a> for up to date documentation and features
+      </div>
+      EOHTML
+    ]
+  end
+
   def add_google_analytics
     @options += [
       "--body-html", <<-EOHTML
@@ -287,25 +436,37 @@ class JsDuckRunner
                 }
             });
         }
+
+        Docs.otherProducts = [
+          {
+              text: 'Ext JS 4',
+              href: 'http://docs.sencha.com/ext-js/4-0'
+          },
+          {
+              text: 'Ext JS 3',
+              href: 'http://docs.sencha.com/ext-js/3-4'
+          },
+          {
+              text: 'Sencha Touch 2',
+              href: 'http://docs.sencha.com/touch/2-0'
+          },
+          {
+              text: 'Sencha Touch 1',
+              href: 'http://docs.sencha.com/touch/1-1'
+          },
+          {
+              text: 'Touch Charts',
+              href: 'http://docs.sencha.com/touch-charts/1-0'
+          },
+          {
+              text: 'Sencha Animator',
+              href: 'http://docs.sencha.com/animator/1-0'
+          }
+        ];
       </script>
     EOHTML
     ]
-  end
-
-  # Copy over the images that SDK documentation links to
-  def copy_sdk_images
-    system "cp -r #{@sdk_dir}/extjs/docs/resources #{@out_dir}/doc-resources"
-    system "cp -r #{@sdk_dir}/platform/docs/resources/* #{@out_dir}/doc-resources"
-  end
-
-  # Copy over the images that Ext4 documentation links to
-  def copy_ext4_images
-    system "cp -r #{@ext_dir}/docs/doc-resources #{@out_dir}/doc-resources"
-  end
 
-  # Copy over the images that Sencha Touch documentation links to.
-  def copy_touch_images
-    system "cp -r #{@sdk_dir}/touch/doc-resources #{@out_dir}/doc-resources"
   end
 
   # Copy over SDK examples
@@ -317,6 +478,16 @@ class JsDuckRunner
     system "cp -r #{@ext_dir}/welcome #{@out_dir}/extjs"
   end
 
+  def copy_animator_examples
+    system "mkdir -p #{@out_dir}/extjs"
+    system "cp -r #{@animator_dir}/docs/examples #{@out_dir}/extjs"
+  end
+
+  # Copy over Sencha Touch
+  def copy_touch2_build
+    system "cp -r #{@sdk_dir}/touch/build #{@out_dir}/touch"
+  end
+
   def run
     # Pass multiple arguments to system, so we'll take advantage of the built-in escaping
     system(*["ruby", "bin/jsduck"].concat(@options))
@@ -351,8 +522,6 @@ task :sdk, [:mode] => :sass do |t, args|
   runner.add_google_analytics if mode == "live"
   runner.run
 
-  runner.copy_sdk_images
-
   runner.copy_sdk_examples if mode == "export" || mode == "live"
 end
 
@@ -369,8 +538,23 @@ task :ext4, [:mode] => :sass do |t, args|
   runner.add_debug if mode == "debug"
   runner.add_seo
   runner.run
+end
+
+desc "Run JSDuck on official Ext JS 3.4 build\n" +
+     "ext3             - creates debug/development version\n" +
+     "ext3[export]     - creates export/deployable version\n"
+     "ext3[live]       - creates live version for deployment\n"
+task :ext3, [:mode] => :sass do |t, args|
+  mode = args[:mode] || "debug"
+  throw "Unknown mode #{mode}" unless ["debug", "export", "live"].include?(mode)
+  compress if mode == "export"
 
-  runner.copy_ext4_images
+  runner = JsDuckRunner.new
+  runner.add_ext3
+  runner.add_debug if mode == "debug"
+  runner.add_seo if mode == "live"
+  runner.add_google_analytics if mode == "live"
+  runner.run
 end
 
 desc "Run JSDuck on Sencha Touch (for internal use at Sencha)\n" +
@@ -385,9 +569,78 @@ task :touch, [:mode] => :sass do |t, args|
   runner.add_touch
   runner.add_debug if mode == "debug"
   runner.add_seo if mode == "debug" || mode == "live"
+  runner.add_google_analytics if mode == "live"
+  runner.run
+end
+
+desc "Run JSDuck on Sencha Touch 2 (for internal use at Sencha)\n" +
+     "touch2         - creates debug/development version\n" +
+     "touch2[export] - creates export version\n" +
+     "touch2[live]   - create live version for deployment\n"
+task :touch2, [:mode] => :sass do |t, args|
+  mode = args[:mode] || "debug"
+  throw "Unknown mode #{mode}" unless ["debug", "export", "live"].include?(mode)
+  compress if mode == "live" || mode == "export"
+
+  runner = JsDuckRunner.new
+  runner.add_touch2
+  runner.add_debug if mode == "debug"
+  runner.add_touch2_export_notice if mode == "export"
+  runner.set_touch2_src if mode == "export"
+  runner.add_seo if mode == "debug" || mode == "live"
+  runner.add_google_analytics if mode == "live"
+  runner.run
+
+  runner.copy_touch2_build if mode != "export"
+end
+
+desc "Run JSDuck on Sencha Touch Charts (for internal use at Sencha)\n" +
+     "charts         - creates debug/development version\n" +
+     "charts[export] - create live version for deployment\n"
+     "charts[live]   - create live version for deployment\n"
+task :charts, [:mode] => :sass do |t, args|
+  mode = args[:mode] || "debug"
+  throw "Unknown mode #{mode}" unless ["debug", "export", "live"].include?(mode)
+  compress if mode == "live"
+
+  runner = JsDuckRunner.new
+  runner.add_touch_charts
+  runner.add_debug if mode == "debug"
+  runner.add_seo if mode == "debug" || mode == "live"
+  runner.add_google_analytics if mode == "live"
+  runner.run
+end
+
+desc "Run JSDuck JSON Export (for internal use at Sencha)\n" +
+     "export[touch]  - creates export for Touch 1\n" +
+     "export[touch2] - creates export for Touch 2"
+task :export, [:mode] do |t, args|
+  mode = args[:mode]
+  throw "Unknown mode #{mode}" unless ["touch", "touch2"].include?(mode)
+
+  runner = JsDuckRunner.new
+  runner.add_touch_export if mode == "touch"
+  runner.add_touch2_export if mode == "touch2"
+  runner.run
+end
+
+desc "Run JSDuck on Sencha Animator (for internal use at Sencha)\n" +
+     "animator         - creates debug/development version\n" +
+     "animator[export] - create live version for deployment\n"
+     "animator[live]   - create live version for deployment\n"
+task :animator, [:mode] => :sass do |t, args|
+  mode = args[:mode] || "debug"
+  throw "Unknown mode #{mode}" unless ["debug", "live", "export"].include?(mode)
+  compress if mode == "live"
+
+  runner = JsDuckRunner.new
+  runner.add_animator
+  runner.add_debug if mode == "debug"
+  runner.add_seo if mode == "debug" || mode == "live"
+  runner.add_google_analytics if mode == "live"
   runner.run
 
-  runner.copy_touch_images
+  runner.copy_animator_examples
 end
 
 desc "Build JSDuck gem"

data/bin/compare

@@ -0,0 +1,163 @@
+#!/usr/bin/env ruby
+# Compare .json files of different ExtJS versions
+
+# For running when gem not installed
+$:.unshift File.dirname(File.dirname(__FILE__)) + "/lib"
+
+require "rubygems"
+require "jsduck/json_duck"
+
+def read_class(filename)
+  JsDuck::JsonDuck.read(filename)
+end
+
+def read_all_classes(dir, ignore_private=false)
+  map = {}
+  Dir[dir+"/*.json"].each do |filename|
+    print "."
+    STDOUT.flush
+    cls = read_class(filename)
+    unless ignore_private && cls["private"]
+      map[cls["name"]] = cls
+      cls["alternateClassNames"].each do |name|
+        map[name] = cls
+      end
+    end
+  end
+  puts "OK"
+  map
+end
+
+# Gathers class members that are in cls1, but are missing in cls2
+def compare_classes(cls1, cls2)
+  diff = []
+  cls1["members"].each_pair do |group_name, group_items|
+    group_items.find_all {|m1| !m1["private"] && !m1["protected"] && m1["owner"] == cls1["name"] }.each do |m1|
+      match = cls2["members"][group_name].find do |m2|
+        m2["name"] == m1["name"] && !m2["protected"] && !m2["private"]
+      end
+      if !match && m1["name"] != "constructor" && m1["name"] != ""
+        other = nil
+        ["cfg", "property", "method", "event"].each do |g|
+          other = other || cls2["members"][g].find {|m2| m2["name"] == m1["name"] }
+          other = other || cls2["statics"][g].find {|m2| m2["name"] == m1["name"] }
+        end
+        diff << {
+          :type => group_name,
+          :name => m1["name"],
+          :other => other ? {
+            :type => other["tagname"],
+            :static => other["static"],
+            :private => other["private"],
+            :protected => other["protected"],
+          } : nil
+        }
+      end
+    end
+  end
+  diff
+end
+
+
+
+old_classes = read_all_classes(ARGV[0], :ignore_private)
+new_classes = read_all_classes(ARGV[1])
+out_file = ARGV[2]
+
+diff_data = []
+old_classes.each_pair do |name, cls|
+  if name == cls["name"]
+    new_cls = new_classes[cls["name"]]
+    # Remap classes like Array to Ext.Array
+    new_cls = new_classes["Ext."+cls["name"]] unless new_cls
+
+    diff_data << {
+      :name => cls["name"],
+      :found => !!new_cls,
+      :new_name => new_cls && new_cls["name"],
+      :diff => new_cls ? compare_classes(cls, new_cls) : [],
+    }
+  end
+end
+
+# Choose title based on filename
+if out_file =~ /touch/
+  title = "Comparison of Touch 1.1.1 and Touch 2.0.0"
+else
+  title = "Comparison of Ext 4.0.7 and Ext 4.1.0"
+end
+
+# do HTML output
+html = []
+html << <<-EOHTML
+<!DOCTYPE html>
+<html>
+<head>
+<title>#{title}</title>
+<style type="text/css">
+body { font-family: Georgia, serif; }
+li h2 { font-size: medium; font-weight: normal; }
+li ul { display: none; }
+</style>
+<script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.3/jquery.min.js"></script>
+<script>
+$(function() {
+    $("h2 > a").live("click", function() {
+        $("ul", $(this).parent().parent()).toggle();
+        return false;
+    });
+});
+</script>
+</head>
+<body>
+<h1>#{title}</h1>
+EOHTML
+
+html << "<ul>"
+diff_data.sort! {|a, b| a[:name] <=> b[:name] }
+diff_data.each do |cls|
+  if !cls[:found] || cls[:diff].length > 0
+    html << "<li>"
+    if cls[:found]
+      new_name = (cls[:new_name] == cls[:name] ? "" : " --> " + cls[:new_name])
+      diff_count = cls[:diff].length > 0 ? "(#{cls[:diff].length} missing members)" : ""
+      link = cls[:diff].length > 0 ? "<a href='#expand'>#{cls[:name]}</a>" : cls[:name]
+      html << "<h2>#{link} #{new_name} #{diff_count}</h2>"
+      if cls[:diff].length > 0
+        html << "<ul>"
+        cls[:diff].each do |m|
+          html << "<li>"
+          html << m[:type] + " " + m[:name]
+          if m[:other]
+            o = m[:other]
+            stat = o[:static] ? 'static' : ''
+            priv = o[:private] ? 'private' : ''
+            prot = o[:protected] ? 'protected' : ''
+            html << " (found #{stat} #{priv} #{prot} #{o[:type]} with the same name)"
+          end
+          html << "</li>"
+        end
+        html << "</ul>"
+      end
+    else
+      html << "<h2>" + cls[:name] + " <b>not found</b></h2>"
+    end
+    html << "</li>"
+  end
+end
+html << "</ul>"
+
+html << "<h2>Summary</h2>"
+dd = diff_data
+html << "<p>" + dd.find_all {|c| !c[:found] }.length.to_s + " classes not found</p>"
+html << "<p>" + dd.find_all {|c| c[:found] && c[:name] == c[:new_name] }.length.to_s + " classes with same name</p>"
+html << "<p>" + dd.find_all {|c| c[:found] && c[:name] != c[:new_name] }.length.to_s + " renamed classes</p>"
+html << "<p>" + dd.find_all {|c| c[:diff].length > 0 }.length.to_s + " classes with missing members</p>"
+html << "<p>" + dd.map {|c| c[:diff].length }.inject {|sum,x| sum + x }.to_s + " missing members</p>"
+html << "<p>" + dd.map {|c| c[:diff].find_all {|m| !m[:other]}.length }.inject {|sum,x| sum + x }.to_s + " completely missing members</p>"
+
+
+html << "</body>"
+html << "</html>"
+
+File.open(out_file, 'w') {|f| f.write(html.join("\n")) }