[Checkins] SVN: keas.build/trunk/src/keas/build/index.txt a bit more documentation

[Paul Carduner]

Log message for revision 103322:
  a bit more documentation

Changed:
  U   keas.build/trunk/src/keas/build/index.txt

-=-
Modified: keas.build/trunk/src/keas/build/index.txt
===================================================================
--- keas.build/trunk/src/keas/build/index.txt	2009-08-27 20:46:38 UTC (rev 103321)
+++ keas.build/trunk/src/keas/build/index.txt	2009-08-27 21:20:53 UTC (rev 103322)
@@ -406,6 +406,38 @@
 
   $ install -u https://build.twollo.com/buildouts/ -p Twollo -V QA --latest
 
+Creating Helper Scripts
+-----------------------
+
+Sometimes it can be a pain to remember what all the command line
+options are that you need to pass for building your project.
+Fortunately, it is really easy to create helper scripts that just set
+some defaults for you.
+
+For example, to create a build-twollo script, you would add the
+following to a buildout configuration file::
+
+  [build-twollo]
+  recipe = zc.recipe.egg
+  eggs = keas.build
+  scripts = build=build-twollo
+  initialization =
+      sys.argv[1:1] = ['-c', 'Twollo.cfg']
+
+As another example, you could create an install-twollo-dev script that
+automatically installs the latest development release::
+
+  [install-twollo-dev]
+  recipe = zc.recipe.egg
+  eggs = keas.build
+  scripts = install=install-twollo-dev
+  initialization =
+      sys.argv[1:1] = ['-u', 'http://build.twollo.com/buildouts/',
+                       ' --username', 'someuser', '--password', 'somepass',
+                       '-p', 'Twollo', '-V', 'Development', '--latest']
+
+The possibilities are endless!
+
 Footnotes
 =========