docs/buildroot.html: document Makefile wrapper in output dir
authorPeter Korsgaard <jacmet@sunsite.dk>
Mon, 27 Sep 2010 20:26:15 +0000 (22:26 +0200)
committerPeter Korsgaard <jacmet@sunsite.dk>
Mon, 27 Sep 2010 20:34:11 +0000 (22:34 +0200)
For out-of-tree builds.

Signed-off-by: Peter Korsgaard <jacmet@sunsite.dk>
docs/buildroot.html

index edb75b134ed2bcf8f3fa4742cf45346bfa4b30d4..b7a8641e9176fdd6d6bbf79af28265f85d560806 100644 (file)
@@ -278,15 +278,30 @@ or
  $ make O=/tmp/build
 </pre>
 
+    <p>Or:</p>
+
+<pre>
+ $ cd /tmp/build; make O=$PWD -C path/to/buildroot
+</pre>
+
     <p>All the output files will be located under
     <code>/tmp/build</code>.</p>
 
     <p>When using out-of-tree builds, the Buildroot
-    <code>.config</code> and  temporary files are also stored in the
+    <code>.config</code> and temporary files are also stored in the
     output directory. This means that you can safely run multiple
     builds in parallel using the same source tree as long as they use
     unique output directories.</p>
 
+    <p>For ease of use, Buildroot generates a Makefile wrapper in the
+    output directory - So after the first run, you no longer need to
+    pass <code>O=..</code> and <code>-C ..</code>, simply run (in the
+    output directory):</p>
+
+<pre>
+ $ make &lt;target&gt;
+</pre>
+
     <h3><a name="environment_variables" id="environment_variables"></a>
     Environment variables</h3>