From 189916d381acaa7b56aa96fdf8dd079cfbdfa7c9 Mon Sep 17 00:00:00 2001
From: Mitchell Hashimoto <mitchell.hashimoto@gmail.com>
Date: Thu, 20 Jun 2013 14:24:30 -0700
Subject: [PATCH] website: build command documentation

---
 .../docs/command-line/build.html.markdown     | 26 +++++++++++++++++++
 website/source/layouts/docs.erb               |  2 +-
 2 files changed, 27 insertions(+), 1 deletion(-)
 create mode 100644 website/source/docs/command-line/build.html.markdown

diff --git a/website/source/docs/command-line/build.html.markdown b/website/source/docs/command-line/build.html.markdown
new file mode 100644
index 000000000..e6ae28c24
--- /dev/null
+++ b/website/source/docs/command-line/build.html.markdown
@@ -0,0 +1,26 @@
+---
+layout: "docs"
+---
+
+# Command-Line: Build
+
+The `packer build` command takes a template and runs all the builds within
+it in order to generate a set of artifacts. The various builds specified within
+a template are executed in parallel, unless otherwise specified. And the
+artifacts that are created will be outputted at the end of the build.
+
+## Options
+
+* `-debug` - Disables parallelization and enables debug mode. Debug mode flags
+  the builders that they should output debugging information. The exact behavior
+  of debug mode is left to the builder. In general, builders usually will stop
+  between each step, waiting keyboard input before continuing. This will allow
+  the user to inspect state and so on.
+
+* `-except=foo,bar,baz` - Builds all the builds except those with the given
+  comma-separated names. Build names by default are the names of their builders,
+  unless a specific `name` attribute is specified within the configuration.
+
+* `-only=foo,bar,baz` - Only build the builds with the given comma-separated
+  names. Build names by default are the names of their builders, unless a
+  specific `name` attribute is specified within the configuration.
diff --git a/website/source/layouts/docs.erb b/website/source/layouts/docs.erb
index 22ace5071..15ea6add5 100644
--- a/website/source/layouts/docs.erb
+++ b/website/source/layouts/docs.erb
@@ -32,7 +32,7 @@
 
 							<li class="nav-header">Command-Line</li>
 							<li><a href="/docs/command-line/introduction.html">Introduction</a></li>
-							<li><a href="#">Build</a></li>
+							<li><a href="/docs/command-line/build.html">Build</a></li>
 							<li><a href="/docs/command-line/validate.html">Validate</a></li>
 
 							<li class="nav-header">Templates</li>