0
@@ -116,6 +116,19 @@ You can work in an irb-based console:
0
   waves-console # or bin/waves-console
0
 
0
 
0
+== Freeze it.  Freeze it real good.
0
+
0
+When deploying an application or when running off a copy of Waves source, you may need to freeze the app to a specific version of Waves.  Applications look for framework source in ./waves before falling back on the gem. You can freeze the framework to this location using the rake tasks <tt>waves:freeze</tt> and <tt>waves:freeze:current</tt>.
0
+
0
+  # copy the specified framework source to killer_app/waves
0
+  rake waves:freeze src=/path/to/waves
0
+  
0
+  # figure out whatever framework source your app happens to be using and copy it to killer_app/waves
0
+  rake waves:freeze:current
0
+
0
+Unfreeze using <tt>rake waves:unfreeze</tt>, or just delete the ./waves directory if you're feeling obvious.
0
+
0
+
0
 == Where the Wavy Things Are
0
 
0
 A Waves application consists of a Ruby module structured with internal namespaces.  Thus:

0
@@ -66,7 +66,7 @@ end
0
 Rake::RDocTask.new do |rdoc|
0
   rdoc.rdoc_dir = 'doc/rdoc'
0
   rdoc.options << '--line-numbers' << '--inline-source' << '--main' << 'README.rdoc'
0
-  rdoc.rdoc_files.add [ 'lib/**/*.rb', 'README.rdoc', 'doc/HISTORY' ]
0
+  rdoc.rdoc_files.add [ 'lib/**/*.rb', 'README.rdoc', 'doc/HISTORY', 'bin/waves' ]
0
 end
0
 
0
 # based on a blog post by Assaf Arkin

0
@@ -1,8 +1,26 @@
0
 #!/usr/bin/env ruby
0
+
0
+# = Generate or update a Waves application
0
+# 
0
+# The +waves+ script generates a new Waves application or updates an existing one.  The script uses RakeGen for file copies and template processing, and the current version of RakeGen requires you to affirm that you want to clobber each and every file when doing an update.
0
+#
0
+# == Usage
0
+# 
0
+#   # Generate a Waves app using the default ORM layer, which is currently Sequel
0
+#   waves /path/to/app  
0
+#
0
+#   # Generate an app using the default ORM layer, which is currently Sequel
0
+#   waves /path/to/app --orm=active_record
0
+#
0
+#   # Generate an app that does not include an ORM layer
0
+#   waves /path/to/app -o none 
0
+
0
 require 'rubygems'
0
 require 'choice'
0
 require 'rakegen'
0
 
0
+
0
+
0
 # if we're in the waves source, prepend it to the load path
0
 waves_lib = File.expand_path( "#{File.dirname(__FILE__)}/../../waves/lib" )
0
 $:.unshift waves_lib if File.exist?(waves_lib)