diff --git a/tasks/rake/manpages.rake b/tasks/rake/manpages.rake index 752a6a7a6..f48e57cc7 100644 --- a/tasks/rake/manpages.rake +++ b/tasks/rake/manpages.rake @@ -1,27 +1,37 @@ # require 'fileutils' desc "Build Puppet manpages" task :gen_manpages do sbins = Dir.glob(%w{sbin/*}) bins = Dir.glob(%w{bin/*}) - + applications = Dir.glob(%w{lib/puppet/application/*}) # Locate ronn ronn = %x{which ronn} ronn.chomp! + # Create puppet.conf.5 man page %x{RUBYLIB=./lib:$RUBYLIB bin/puppetdoc --reference configuration > ./man/man5/puppetconf.5.ronn} %x{#{ronn} --manual="Puppet manual" --organization="Puppet Labs, LLC" -r ./man/man5/puppetconf.5.ronn} File.move("./man/man5/puppetconf.5", "./man/man5/puppet.conf.5") File.unlink("./man/man5/puppetconf.5.ronn") - # Create binary man pages + # Create LEGACY binary man pages (i.e. delete me for 2.8.0) binary = bins + sbins binary.each do |bin| - b = bin.gsub( /(bin|sbin)\//, "") + b = bin.gsub( /^s?bin\//, "") %x{RUBYLIB=./lib:$RUBYLIB #{bin} --help > ./man/man8/#{b}.8.ronn} %x{#{ronn} --manual="Puppet manual" --organization="Puppet Labs, LLC" -r ./man/man8/#{b}.8.ronn} File.unlink("./man/man8/#{b}.8.ronn") end - + + # Create modern binary man pages + applications.each do |app| + app.gsub!( /^lib\/puppet\/application\/(.*?)\.rb/, '\1') + %x{RUBYLIB=./lib:$RUBYLIB bin/puppet #{app} --help > ./man/man8/puppet-#{app}.8.ronn} + %x{#{ronn} --manual="Puppet manual" --organization="Puppet Labs, LLC" -r ./man/man8/puppet-#{app}.8.ronn} + File.unlink("./man/man8/puppet-#{app}.8.ronn") + end + + end \ No newline at end of file