Puppet Documentation

Hi,

Following the instructions in the README.markdown (and github http://github.com/reductivelabs/puppet-docs) I received the following errors.

On Fed11, ruby 1.8.6 I had to install nokogiri as a gem before I could run rake install.

$ sudo rake install
gem install maruku --no-rdoc --no-ri
Successfully installed maruku-0.6.0
1 gem installed
gem install nokogiri --no-rdoc --no-ri
Building native extensions.  This could take a while...
Successfully installed nokogiri-1.4.3.1
1 gem installed
gem install erubis --no-rdoc --no-ri
Successfully installed erubis-2.6.6
1 gem installed
gem install rack --no-rdoc --no-ri
Successfully installed rack-1.2.1
1 gem installed
gem install blockenspiel --no-rdoc --no-ri
ERROR:  Error installing blockenspiel:
    blockenspiel requires Ruby version >= 1.8.7.
rake aborted!
Command failed with status (1): [gem install blockenspiel --no-rdoc --no-ri...]
/home/dennis/workspace/puppet-docs/Rakefile:23
(See full trace by running task with --trace)

I installed version 0.3.3 of blockenspiel as a gem and removed it from the Rakefile:

diff --git a/Rakefile b/Rakefile
index 117c936..74692a3 100644
--- a/Rakefile
+++ b/Rakefile
@@ -13,7 +13,7 @@ end
 
 $LOAD_PATH.unshift File.expand_path('lib')
 
-dependencies = %w(maruku nokogiri erubis rack blockenspiel versionomy)
+dependencies = %w(maruku nokogiri erubis rack versionomy)
 references = %w(configuration function indirection metaparameter network report type)
 
 namespace :install do

It then installed everything fine. I then had the following issue:

$ rake generate --trace
(in /home/dennis/workspace/puppet-docs)
** Invoke generate (first_time)
** Execute generate
bin/generate
./bin/../lib/puppet_docs/generator.rb:15:in `initialize': uninitialized constant PuppetDocs::Generator::FileUtils (NameError)
    from bin/generate:7:in `new'
    from bin/generate:7
rake aborted!
Command failed with status (1): [bin/generate...]
/usr/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:994:in `sh'
/usr/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:1009:in `call'
/usr/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:1009:in `sh'
/usr/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:1093:in `sh'
/home/dennis/workspace/puppet-docs/Rakefile:34
/usr/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:635:in `call'
/usr/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:635:in `execute'
/usr/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:630:in `each'
/usr/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:630:in `execute'
/usr/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:596:in `invoke_with_call_chain'
/usr/lib/ruby/1.8/monitor.rb:242:in `synchronize'
/usr/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:589:in `invoke_with_call_chain'
/usr/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:582:in `invoke'
/usr/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:2050:in `invoke_task'
/usr/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:2028:in `top_level'
/usr/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:2028:in `each'
/usr/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:2028:in `top_level'
/usr/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:2067:in `standard_exception_handling'
/usr/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:2022:in `top_level'
/usr/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:2000:in `run'
/usr/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:2067:in `standard_exception_handling'
/usr/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:1997:in `run'
/usr/lib/ruby/gems/1.8/gems/rake-0.8.7/bin/rake:31
/usr/bin/rake:19:in `load'
/usr/bin/rake:19

Doing the following fixed this:

diff --git a/lib/puppet_docs/generator.rb b/lib/puppet_docs/generator.rb
index 9dd4f35..900f5e0 100644
--- a/lib/puppet_docs/generator.rb
+++ b/lib/puppet_docs/generator.rb
@@ -2,6 +2,8 @@ module PuppetDocs
   class Generator
     attr_reader :output, :view_path, :view, :source_dir
 
+    require 'fileutils'
+
     class MissingPrologueError < ::ArgumentError; end
 
     def initialize(output = nil)

However it may not be your preferred solution.

I made the following changes in the README.markdown to explain.

diff --git a/README.markdown b/README.markdown
index 5d169b3..68b4c68 100644
--- a/README.markdown
+++ b/README.markdown
@@ -13,7 +13,8 @@ Steps for installing the documentation-generating code:
     $ git clone git://github.com/reductivelabs/puppet-docs.git
 
 2.  Use your package manager to install rake, libxml2-dev, and
-    libxslt-dev.  Package names may vary by platform.
+    libxslt-dev.  Package names may vary by platform. If you are using version < 1.8.7 of ruby
+    you will need to install version 0.3.3 of blockenspiel and remove it from the Rakefile.
 
 3.  Install the ruby dependencies