distil 0.11.6 → 0.11.8

data/VERSION

@@ -1 +1 @@
-0.11.6
+0.11.8

data/assets/distil.js

@@ -103,7 +103,8 @@
     tag.onload= complete;
     tag.type= "text/javascript";
     tag.src= url;
-    root.insertBefore(tag, root.firstChild);
+    // root.insertBefore(tag, root.firstChild);
+    head.appendChild(tag);
   };
 
   var injectStylesheet= distil.injectStylesheet= function(url, callback, scope, userData)

data/bin/distil

@@ -56,6 +56,8 @@ if !project_file
   exit
 end
 
+Dir.chdir(File.dirname(project_file))
+
 project= Distil::DistilProject.new(project_file, arg_settings)
 
 if 0==args.length

data/distil.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{distil}
-  s.version = "0.11.6"
+  s.version = "0.11.8"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Jeff Watkins"]
-  s.date = %q{2010-06-18}
+  s.date = %q{2010-06-24}
   s.default_executable = %q{distil}
   s.description = %q{A build tool for Javascript and CSS that takes advantage of best-of-breed helper applications Javascript Lint and JSDoc Toolkit}
   s.executables = ["distil"]
@@ -40,6 +40,7 @@ Gem::Specification.new do |s|
      "lib/distil/project.rb",
      "lib/distil/project/distil-project.rb",
      "lib/distil/project/external-project.rb",
+     "lib/distil/project/remote-project.rb",
      "lib/distil/source-file.rb",
      "lib/distil/source-file/css-file.rb",
      "lib/distil/source-file/html-file.rb",
@@ -585,6 +586,155 @@ Gem::Specification.new do |s|
      "vendor/jsl-0.3.0/tests/warnings/useless_void.js",
      "vendor/jsl-0.3.0/tests/warnings/var_hides_arg.js",
      "vendor/jsl-0.3.0/tests/warnings/with_statement.js",
+     "vendor/pdoc/LICENSE",
+     "vendor/pdoc/PDoc.tmbundle/Commands/Continue PDoc Comment.tmCommand",
+     "vendor/pdoc/PDoc.tmbundle/Macros/Collapse PDoc Blocks.tmMacro",
+     "vendor/pdoc/PDoc.tmbundle/Macros/Expand PDoc Blocks.tmMacro",
+     "vendor/pdoc/PDoc.tmbundle/Preferences/PDoc.tmPreferences",
+     "vendor/pdoc/PDoc.tmbundle/Snippets/class.tmSnippet",
+     "vendor/pdoc/PDoc.tmbundle/Snippets/constant.tmSnippet",
+     "vendor/pdoc/PDoc.tmbundle/Snippets/event.tmSnippet",
+     "vendor/pdoc/PDoc.tmbundle/Snippets/method.tmSnippet",
+     "vendor/pdoc/PDoc.tmbundle/Snippets/mixin.tmSnippet",
+     "vendor/pdoc/PDoc.tmbundle/Snippets/namespace.tmSnippet",
+     "vendor/pdoc/PDoc.tmbundle/Snippets/param.tmSnippet",
+     "vendor/pdoc/PDoc.tmbundle/Snippets/property.tmSnippet",
+     "vendor/pdoc/PDoc.tmbundle/Snippets/section.tmSnippet",
+     "vendor/pdoc/PDoc.tmbundle/Syntaxes/PDoc.tmLanguage",
+     "vendor/pdoc/PDoc.tmbundle/info.plist",
+     "vendor/pdoc/README.markdown",
+     "vendor/pdoc/Rakefile",
+     "vendor/pdoc/bin/pdoc",
+     "vendor/pdoc/lib/pdoc.rb",
+     "vendor/pdoc/lib/pdoc/error.rb",
+     "vendor/pdoc/lib/pdoc/generators.rb",
+     "vendor/pdoc/lib/pdoc/generators/abstract_generator.rb",
+     "vendor/pdoc/lib/pdoc/generators/html.rb",
+     "vendor/pdoc/lib/pdoc/generators/html/helpers.rb",
+     "vendor/pdoc/lib/pdoc/generators/html/page.rb",
+     "vendor/pdoc/lib/pdoc/generators/html/syntax_highlighter.rb",
+     "vendor/pdoc/lib/pdoc/generators/html/template.rb",
+     "vendor/pdoc/lib/pdoc/generators/html/website.rb",
+     "vendor/pdoc/lib/pdoc/generators/json.rb",
+     "vendor/pdoc/lib/pdoc/generators/pythonesque.rb",
+     "vendor/pdoc/lib/pdoc/models.rb",
+     "vendor/pdoc/lib/pdoc/models/argument.rb",
+     "vendor/pdoc/lib/pdoc/models/base.rb",
+     "vendor/pdoc/lib/pdoc/models/callable.rb",
+     "vendor/pdoc/lib/pdoc/models/class.rb",
+     "vendor/pdoc/lib/pdoc/models/class_method.rb",
+     "vendor/pdoc/lib/pdoc/models/class_property.rb",
+     "vendor/pdoc/lib/pdoc/models/constant.rb",
+     "vendor/pdoc/lib/pdoc/models/constructor.rb",
+     "vendor/pdoc/lib/pdoc/models/container.rb",
+     "vendor/pdoc/lib/pdoc/models/entity.rb",
+     "vendor/pdoc/lib/pdoc/models/instance_method.rb",
+     "vendor/pdoc/lib/pdoc/models/instance_property.rb",
+     "vendor/pdoc/lib/pdoc/models/mixin.rb",
+     "vendor/pdoc/lib/pdoc/models/namespace.rb",
+     "vendor/pdoc/lib/pdoc/models/root.rb",
+     "vendor/pdoc/lib/pdoc/models/section.rb",
+     "vendor/pdoc/lib/pdoc/models/signature.rb",
+     "vendor/pdoc/lib/pdoc/models/utility.rb",
+     "vendor/pdoc/lib/pdoc/parser.rb",
+     "vendor/pdoc/lib/pdoc/parser/argument_description_nodes.rb",
+     "vendor/pdoc/lib/pdoc/parser/basic_nodes.rb",
+     "vendor/pdoc/lib/pdoc/parser/description_nodes.rb",
+     "vendor/pdoc/lib/pdoc/parser/documentation_nodes.rb",
+     "vendor/pdoc/lib/pdoc/parser/ebnf_arguments_nodes.rb",
+     "vendor/pdoc/lib/pdoc/parser/ebnf_expression_nodes.rb",
+     "vendor/pdoc/lib/pdoc/parser/fragment.rb",
+     "vendor/pdoc/lib/pdoc/parser/section_content_nodes.rb",
+     "vendor/pdoc/lib/pdoc/parser/tags_nodes.rb",
+     "vendor/pdoc/lib/pdoc/parser/treetop_files/argument_description.treetop",
+     "vendor/pdoc/lib/pdoc/parser/treetop_files/basic.treetop",
+     "vendor/pdoc/lib/pdoc/parser/treetop_files/description.treetop",
+     "vendor/pdoc/lib/pdoc/parser/treetop_files/documentation.treetop",
+     "vendor/pdoc/lib/pdoc/parser/treetop_files/ebnf_arguments.treetop",
+     "vendor/pdoc/lib/pdoc/parser/treetop_files/ebnf_expression.treetop",
+     "vendor/pdoc/lib/pdoc/parser/treetop_files/ebnf_javascript.treetop",
+     "vendor/pdoc/lib/pdoc/parser/treetop_files/events.treetop",
+     "vendor/pdoc/lib/pdoc/parser/treetop_files/section_content.treetop",
+     "vendor/pdoc/lib/pdoc/parser/treetop_files/tags.treetop",
+     "vendor/pdoc/lib/pdoc/runner.rb",
+     "vendor/pdoc/lib/pdoc/treemaker.rb",
+     "vendor/pdoc/pdoc-0.2.0.gem",
+     "vendor/pdoc/pdoc.gemspec",
+     "vendor/pdoc/templates/html/assets/images/pdoc/alias.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/class.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/class_deprecated.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/class_method.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/class_property.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/constant.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/constructor.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/deprecated.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/description.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/information.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/instance_method.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/instance_property.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/method.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/method_deprecated.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/mixin.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/namespace.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/property.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/related_to.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/search-background.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/section-background.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/section.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/selected-section-background.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/subclass.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/superclass.png",
+     "vendor/pdoc/templates/html/assets/images/pdoc/utility.png",
+     "vendor/pdoc/templates/html/assets/javascripts/pdoc/application.js",
+     "vendor/pdoc/templates/html/assets/javascripts/pdoc/prototype.js",
+     "vendor/pdoc/templates/html/assets/javascripts/pdoc/tabs.js",
+     "vendor/pdoc/templates/html/assets/stylesheets/pdoc/api.css",
+     "vendor/pdoc/templates/html/assets/stylesheets/pdoc/pygments.css",
+     "vendor/pdoc/templates/html/helpers.rb",
+     "vendor/pdoc/templates/html/index.erb",
+     "vendor/pdoc/templates/html/item_index.js.erb",
+     "vendor/pdoc/templates/html/layout.erb",
+     "vendor/pdoc/templates/html/leaf.erb",
+     "vendor/pdoc/templates/html/node.erb",
+     "vendor/pdoc/templates/html/partials/class_relationships.erb",
+     "vendor/pdoc/templates/html/partials/classes.erb",
+     "vendor/pdoc/templates/html/partials/constructor.erb",
+     "vendor/pdoc/templates/html/partials/description.erb",
+     "vendor/pdoc/templates/html/partials/link_list.erb",
+     "vendor/pdoc/templates/html/partials/method_signatures.erb",
+     "vendor/pdoc/templates/html/partials/methodized_note.erb",
+     "vendor/pdoc/templates/html/partials/mixins.erb",
+     "vendor/pdoc/templates/html/partials/namespaces.erb",
+     "vendor/pdoc/templates/html/partials/related_utilities.erb",
+     "vendor/pdoc/templates/html/partials/relationships.erb",
+     "vendor/pdoc/templates/html/partials/short_description_list.erb",
+     "vendor/pdoc/templates/html/partials/title.erb",
+     "vendor/pdoc/templates/html/section.erb",
+     "vendor/pdoc/test/fixtures/ajax.js",
+     "vendor/pdoc/test/fixtures/prototype.js",
+     "vendor/pdoc/test/fixtures/test.txt",
+     "vendor/pdoc/test/fixtures/text.txt",
+     "vendor/pdoc/test/unit/parser/argument_description_test.rb",
+     "vendor/pdoc/test/unit/parser/basic_test.rb",
+     "vendor/pdoc/test/unit/parser/description_test.rb",
+     "vendor/pdoc/test/unit/parser/documentation_test.rb",
+     "vendor/pdoc/test/unit/parser/ebnf_arguments_test.rb",
+     "vendor/pdoc/test/unit/parser/ebnf_expression_test.rb",
+     "vendor/pdoc/test/unit/parser/ebnf_javascript_test.rb",
+     "vendor/pdoc/test/unit/parser/events_test.rb",
+     "vendor/pdoc/test/unit/parser/section_content_test.rb",
+     "vendor/pdoc/test/unit/parser/tags_test.rb",
+     "vendor/pdoc/test/unit/parser/test_fragment.rb",
+     "vendor/pdoc/test/unit/parser_test_helper.rb",
+     "vendor/pdoc/test/unit/runner/basic_test.rb",
+     "vendor/pdoc/test/unit/templates/html_helpers_test.rb",
+     "vendor/pdoc/vendor/albino.rb",
+     "vendor/pdoc/website/html/documentation.html",
+     "vendor/pdoc/website/html/images/pdoc.jpg",
+     "vendor/pdoc/website/html/index.html",
+     "vendor/pdoc/website/html/stylesheets/main.css",
+     "vendor/pdoc/website/html/stylesheets/reset.css",
+     "vendor/pdoc/website/markdown/syntax.markdown",
      "vendor/yuicompressor-2.4.2.jar"
   ]
   s.homepage = %q{http://code.google.com/p/distil-js/}

data/lib/distil/configurable.rb

@@ -75,7 +75,7 @@ class Configurable
 
     arg= rest.shift
 
-    if (arg.is_a?(Class))
+    if (arg.is_a?(Class) || arg==URI)
       info[:type]= arg
       info[:value]= nil
       arg= rest.shift
@@ -148,6 +148,8 @@ class Configurable
       value ? value.to_s : nil;
     when value.nil?
       value
+    when URI==type
+      URI.parse(value)
     else
       if type.respond_to?(:from_options)
         type.from_options(value, self)

data/lib/distil/error-reporter.rb

@@ -54,6 +54,8 @@ module Distil
     def report
       puts "\n" if (@@error_count>0 || @@warning_count>0)
       puts "#{@@error_count} error(s), #{@@warning_count} warning(s)#{ignore_warnings ? " ignored" : ""}"
+      @@error_count=0
+      @@warning_count=0
     end
     
   end

data/lib/distil/product/concatenated.rb

@@ -33,9 +33,7 @@ module Distil
       return @external_files if @external_files
       @external_files= []
       
-      target.project.external_projects.each { |ext|
-        next if STRONG_LINKAGE!=ext.linkage
-        
+      target.include_projects.each { |ext|
         @external_files << ext.product_name(:concatenated, File.extname(filename)[1..-1])
       }
       @external_files

data/lib/distil/product/debug.rb

@@ -21,9 +21,7 @@ module Distil
       return @external_files if @external_files
       @external_files= []
       
-      target.project.external_projects.each { |ext|
-        next if STRONG_LINKAGE!=ext.linkage
-        
+      target.include_projects.each { |ext|
         @external_files << ext.product_name(:debug, File.extname(filename)[1..-1])
       }
       @external_files

data/lib/distil/product/javascript-product.rb

@@ -7,12 +7,6 @@ module Distil
     
     option :global_export
     option :additional_globals, [], :aliases=>['globals']
-    
-    # def initialize(settings, target)
-    #   super(settings, target)
-    #   
-    #   @options.global_export=target.name if true==global_export
-    # end
 
     def before_externals(f)
       f.puts("/*#nocode+*/")
@@ -64,7 +58,7 @@ EOS
     
     def after_files(f)
       if global_export
-        exports= ["window.#{global_export}={}", *additional_globals].join(", ")
+        exports= ["window.#{global_export}=window.#{global_export}||{}", *additional_globals].join(", ")
         f.puts "})(#{exports});"
       end
 
@@ -112,7 +106,7 @@ EOS
         f.write("#{bootstrap_source}\n\n") if bootstrap
         
         if global_export
-          f.write("window.#{global_export}={};");
+          f.write("window.#{global_export}=window.#{global_export}||{};");
           f.write("\n\n");
         end
         

data/lib/distil/product.rb

@@ -30,6 +30,10 @@ module Distil
       @files
     end
     
+    def external_files
+      []
+    end
+    
     def files=(fileset)
       fileset.each { |f|
         next if !handles_file?(f)
@@ -54,17 +58,13 @@ module Distil
         max_asset_modified= f.last_modified if f.last_modified > max_asset_modified
       }
 
-      return @up_to_date=false if (output_modified < max_asset_modified)
-      
       external_files.each { |f|
         next if !File.exist?(f)
         last_modified= File.stat(f).mtime
         max_asset_modified= last_modified if last_modified > max_asset_modified
       }
 
-      return @up_to_date=false if (output_modified < max_asset_modified)
-
-      @up_to_date= true
+      return @up_to_date=(output_modified > max_asset_modified)
     end
 
     def filename

data/lib/distil/project/distil-project.rb

@@ -85,6 +85,7 @@ module Distil
     def build
       FileUtils.mkdir_p(output_folder)
       load_distileries
+      targets
       build_external_projects
       build_targets
     end
@@ -120,8 +121,24 @@ module Distil
       targets.each { |target|
         target.build
       }
-      report
     end
+
+    def find_file(file, source_file=nil)
+      return nil if external_projects.nil?
+      
+      parts= file.split(File::SEPARATOR)
+      project_name= parts[0]
+
+      external_project= external_project_with_name(project_name)
+      return nil if !external_project
+
+      if 1==parts.length
+        return SourceFile::from_path(external_project.product_name(:import, source_file.extension))
+      else
+        return SourceFile::from_path(File.join(external_project.output_folder, *parts[1..-1]))
+      end
+    end
+    
   end
   
 end  

data/lib/distil/project/external-project.rb

@@ -39,7 +39,7 @@ module Distil
       return if WEAK_LINKAGE==linkage
           
       FileUtils.rm_r(output_folder) if File.directory?(output_folder)
-      FileUtils.unlink(output_folder) if File.symlink?(output_folder)
+      FileUtils.rm(output_folder) if File.symlink?(output_folder)
       
       if DEBUG_MODE==mode
         FileUtils.symlink(File.expand_path(source_folder), output_folder)

data/lib/distil/project/remote-project.rb

@@ -0,0 +1,39 @@
+module Distil
+  
+  class RemoteProject < Project
+
+    option :name, String
+    option :href, URI
+    option :linkage, WEAK_LINKAGE, :valid_values=> [WEAK_LINKAGE, STRONG_LINKAGE, LAZY_LINKAGE]
+
+    def initialize(config, parent=nil)
+
+      super(config, parent)
+
+      if !href.respond_to?(:read)
+        raise ValidationError, "Cannot read from project source url: #{source}"
+      end
+      
+      @source_path= File.join(parent.output_folder, href.host, href.path)
+      self.source_folder=  File.dirname(@source_path)
+      
+      if !File.exist?(@source_path)
+        FileUtils.mkdir_p(source_folder)
+        text= href.read
+        File.open(@source_path, "w") { |output|
+          output.write text
+        }
+      end
+      
+    end
+
+    def product_name(product_type, extension)
+      File.join(File.dirname(@source_path), "#{File.basename(@source_path, ".*")}.#{extension}")
+    end
+    
+    def build
+    end
+    
+  end
+  
+end

data/lib/distil/project.rb

@@ -38,7 +38,7 @@ module Distil
         base_cmd = "git pull #{uri}"
         base_cmd+= " -q"
         # base_cmd += " -q" if options[:quiet] and not $verbose
-        base_cmd += " #{options[:version]}" if options[:version]
+        base_cmd += " #{options["version"]}" if options["version"]
         # puts base_cmd if $verbose
         if system(base_cmd)
           # puts "removing: .git .gitignore" if $verbose
@@ -56,18 +56,22 @@ module Distil
         uri= URI.parse(string)
         
         config= { "name" => File.basename(config, ".*") }
-        if uri.scheme
+        
+        case
+        when ['.js', '.css'].include?(File.extname(uri.path))
+          config["href"]= uri.to_s
+        when uri.scheme
           config["repository"]= uri.to_s
         else
           config["path"]= uri.to_s
-        end
         
-        full_path= File.expand_path(config["path"])
+          full_path= File.expand_path(config["path"])
         
-        if File.exist?(full_path) && File.file?(full_path)
-          config["path"]= File.dirname(full_path)
-        else
-          config["path"]= full_path
+          if File.exist?(full_path) && File.file?(full_path)
+            config["path"]= File.dirname(full_path)
+          else
+            config["path"]= full_path
+          end
         end
       end
 
@@ -81,6 +85,10 @@ module Distil
           raise ValidationError.new("External project has neither name, path nor repository")
         end
       end
+
+      if config["href"]
+        return RemoteProject.new(config, parent)
+      end
       
       config["path"]||= "ext/#{config["name"]}"
 
@@ -135,5 +143,6 @@ module Distil
   
 end
 
+require 'distil/project/remote-project'
 require 'distil/project/external-project'
-require 'distil/project/distil-project'
+require 'distil/project/distil-project'

data/lib/distil/target.rb

@@ -43,16 +43,13 @@ module Distil
 
       @options.global_export=name if true==global_export
 
-      include_projects.each { |p|
-        external_project= project.external_project_with_name(p)
-        if !external_project
-          raise ValidationError.new("No such external project: #{p}")
-        end
-        
-        if (WEAK_LINKAGE==external_project.linkage)
-          external_project.linkage= STRONG_LINKAGE
-        end
+      projects= []
+      include_projects.each { |name|
+        ext= project.external_project_with_name(name)
+        ext.linkage= STRONG_LINKAGE
+        projects << ext
       }
+      self.include_projects= projects
     end
 
     def source_folder
@@ -206,12 +203,16 @@ module Distil
     
     def build
       puts "\n#{name}:\n\n"
+
+      if !up_to_date
+        tasks.each { |t| t.process_files(files) }
       
-      tasks.each { |t| t.process_files(files) }
+        products.each { |p| p.write_output }
       
-      products.each { |p| p.write_output }
+        build_assets
+      end
       
-      build_assets
+      report
     end
     
     def find_file(file, source_file=nil)

data/lib/distil/task/css-dependency-task.rb

@@ -2,7 +2,7 @@ module Distil
 
   CSS_IMPORT_REGEX = /@import\s+url\("?(.*\.css)"?\)/
   
-  class CssDependencyFilter < Task
+  class CssDependencyTask < Task
   
     def handles_file(file)
       return ["css"].include?(file.content_type)

data/lib/distil/task/validate-js-task.rb

@@ -9,6 +9,7 @@ module Distil
     
     option :jsl_conf, "#{LIB_DIR}/jsl.conf"
     option :global_export
+    option :additional_globals
     
     def handles_file(file)
       return ["js"].include?(file.content_type)
@@ -32,9 +33,13 @@ module Distil
       tmp << "+define distil\n"
       
       if (global_export)
-        tmp << "+define #{global_export}"
+        tmp << "+define #{global_export}\n"
       end
       
+      # additional_globals.each { |g|
+      #   tmp << "+define #{g}\n"
+      # }
+      
       # add aliases
       target.project.external_projects.each { |project|
         import_file= project.product_name(:import, 'js')

data/lib/distil.rb

@@ -5,6 +5,7 @@ require 'fileutils'
 require 'zlib'
 require "open3"
 require 'uri'
+require 'open-uri'
 
 def class_attr(*rest)
   rest.each { |name|

data/vendor/pdoc/LICENSE

@@ -0,0 +1,16 @@
+Copyright (c) 2008 - 2010 Tobie Langel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/vendor/pdoc/PDoc.tmbundle/Commands/Continue PDoc Comment.tmCommand

@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>beforeRunningCommand</key>
+	<string>nop</string>
+	<key>command</key>
+	<string>#!/usr/bin/env ruby
+
+# Input:  Entire Document
+# Output: Insert as Snippet
+# Key Equivalent: &lt;Return&gt;
+# Scope: comment.block
+
+line     = ENV['TM_CURRENT_LINE']
+index    = ENV['TM_LINE_NUMBER'].to_i
+nextline = $stdin.readlines[index + 1]
+
+puts
+print " " if line =~ /\/\*\*/
+print "*  $0"
+if line.match(/\/\*\*/) &amp;&amp; !nextline.match(/^\s*\*/)
+  puts
+  print "**/"
+end</string>
+	<key>input</key>
+	<string>document</string>
+	<key>keyEquivalent</key>
+	<string>
+	<key>name</key>
+	<string>Continue PDoc Comment</string>
+	<key>output</key>
+	<string>insertAsSnippet</string>
+	<key>scope</key>
+	<string>comment.block</string>
+	<key>uuid</key>
+	<string>58E0442A-7A56-4D19-A063-19C1616C5B6E</string>
+</dict>
+</plist>