sake 1.0.10 → 1.0.11

data/Rakefile

@@ -21,3 +21,14 @@ rescue LoadError => boom
   puts "You are missing a dependency required for meta-operations on this gem."
   puts "#{boom.to_s.capitalize}."
 end
+
+desc 'Generate RDoc documentation for Sake.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  files = ['README', 'LICENSE', 'lib/**/*.rb']
+  rdoc.rdoc_files.add(files)
+  rdoc.main = "README" # page to start on
+  rdoc.title = "sake"
+  rdoc.template = File.exists?(t="/Users/chris/ruby/projects/err/rock/template.rb") ? t : "/var/www/rock/template.rb"
+  rdoc.rdoc_dir = 'doc' # rdoc output folder
+  rdoc.options << '--inline-source' 
+end

data/lib/help.rb

@@ -1,5 +1,5 @@
 class Sake
-  module Help
+  module Help #:nodoc:
     extend self
 
     def display

data/lib/pastie.rb

@@ -1,6 +1,6 @@
 require 'tempfile'
 
-class Pastie
+class Pastie #:nodoc: all
   PASTE_URL = ENV['SAKE_PASTIE_URL'] || ENV['PASTIE_URL'] || 'http://pastie.caboo.se/pastes/create'
 
   def self.paste(text)

data/lib/sake.rb

@@ -11,7 +11,8 @@ require 'open-uri'
 begin
   require 'ruby2ruby'
 rescue LoadError
-  die "# Sake requires the ruby2ruby gem and Ruby 1.8.6."
+  puts "# Sake requires the ruby2ruby gem and Ruby 1.8.6."
+  exit
 end
 require File.dirname(__FILE__) + '/help'
 require File.dirname(__FILE__) + '/pastie'
@@ -70,10 +71,10 @@ require File.dirname(__FILE__) + '/pastie'
 #   $ sake -S -d
 #
 class Sake
-  module Version
+  module Version #:nodoc:
     Major  = '1'
     Minor  = '0'
-    Tweak  = '10'
+    Tweak  = '11'
     String = [ Major, Minor, Tweak ].join('.')
   end
 
@@ -267,6 +268,8 @@ class Sake
   #   tasks = TasksFile.parse('Rakefile').tasks
   #   task  = tasks['db:remigrate']
   class TasksArray < Array
+    ##
+    # Accepts a task name or index.
     def [](name_or_index)
       if name_or_index.is_a? String
         detect { |task| task.name == name_or_index }
@@ -432,12 +435,17 @@ class Sake
     end
 
     ##
-    # String-ish duck typing
+    # String-ish duck typing, sorting based on Task names
     def <=>(other)
       to_s <=> other.to_s
     end
 
+    ##
+    # The task name
     def to_s; @name end
+
+    ##
+    # Basically to_s.inspect
     def inspect; @name.inspect end
   end
 
@@ -455,10 +463,14 @@ class Sake
       tasks_file.send(*args, &block)
     end
 
+    ##
+    # A TaskFile object of our Store
     def tasks_file
       @tasks_file ||= TasksFile.parse(path)
     end
 
+    ##
+    # The platform-aware path to the Store
     def path
       path = if PLATFORM =~ /win32/
         win32_path
@@ -469,7 +481,7 @@ class Sake
       path
     end
 
-    def win32_path
+    def win32_path #:nodoc:
       unless File.exists?(win32home = ENV['HOMEDRIVE'] + ENV['HOMEPATH'])
         puts "# No HOMEDRIVE or HOMEPATH environment variable.",  
              "# Sake needs to know where it should save Rake tasks!"
@@ -478,6 +490,8 @@ class Sake
       end
     end
 
+    ##
+    # Wrote our current tasks_file to disk, overwriting the current Store.
     def save!
       File.open(path, 'w') do |file|
         file.puts tasks_file.to_ruby

data/lib/server.rb

@@ -2,7 +2,7 @@ require 'sake' unless defined? Sake
 require 'mongrel'
 
 class Sake
-  module Server
+  module Server #:nodoc:all
     extend self
 
     def start(args)

data/sake.gemspec

@@ -1,11 +1,11 @@
 
-# Gem::Specification for Sake-1.0.10
+# Gem::Specification for Sake-1.0.11
 # Originally generated by Echoe
 
 Gem::Specification.new do |s|
   s.name = %q{sake}
-  s.version = "1.0.10"
-  s.date = %q{2007-08-21}
+  s.version = "1.0.11"
+  s.date = %q{2007-09-09}
   s.summary = %q{Sake tastes great and helps maintain system-level Rake files.}
   s.email = %q{chris@ozmm.org}
   s.homepage = %q{http://errtheblog.com/}
@@ -44,3 +44,14 @@ end
 #   puts "You are missing a dependency required for meta-operations on this gem."
 #   puts "#{boom.to_s.capitalize}."
 # end
+# 
+# desc 'Generate RDoc documentation for Sake.'
+# Rake::RDocTask.new(:rdoc) do |rdoc|
+#   files = ['README', 'LICENSE', 'lib/**/*.rb']
+#   rdoc.rdoc_files.add(files)
+#   rdoc.main = "README" # page to start on
+#   rdoc.title = "sake"
+#   rdoc.template = File.exists?(t="/Users/chris/ruby/projects/err/rock/template.rb") ? t : "/var/www/rock/template.rb"
+#   rdoc.rdoc_dir = 'doc' # rdoc output folder
+#   rdoc.options << '--inline-source' 
+# end

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.9.0
 specification_version: 1
 name: sake
 version: !ruby/object:Gem::Version 
-  version: 1.0.10
-date: 2007-08-21 00:00:00 -07:00
+  version: 1.0.11
+date: 2007-09-09 00:00:00 -05:00
 summary: Sake tastes great and helps maintain system-level Rake files.
 require_paths: 
 - lib