README.markdown in binman-3.2.1 vs README.markdown in binman-3.3.0

@@ -45,10 +45,12 @@
 
 ## Usage
 
 ### At the command line
 
+See binman(1) manual:
+
     binman --help
 
 ### Inside a Ruby script
 
     #!/usr/bin/env ruby
@@ -208,15 +210,24 @@
     // OPTION 2: show manual unconditionally
     exec(['>/dev/tty', 'binman', 'show', __filename].join(' '));
 
 ## Packaging
 
-### Pre-building man pages
+### Building man pages
 
-Add the following lines to your gemspec:
+#### At the command line
 
-    s.files += Dir['man/man?/*.?']
-    s.add_development_dependency 'md2man', '~> 1.4'
+See binman-rake(1) manual:
+
+    binman-rake --help
+
+#### Inside a Ruby script
+
+Add this snippet to your gemspec file:
+
+    s.files += Dir['man/man?/*.?']            # UNIX man pages
+    s.files += Dir['man/**/*.{html,css,js}']  # HTML man pages
+    s.add_development_dependency 'md2man', '~> 2.0'
 
 Add the following line to your Rakefile:
 
     require 'binman/rakefile'