summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual/dev-manual-newbie.xml
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/dev-manual/dev-manual-newbie.xml')
-rw-r--r--documentation/dev-manual/dev-manual-newbie.xml43
1 files changed, 28 insertions, 15 deletions
diff --git a/documentation/dev-manual/dev-manual-newbie.xml b/documentation/dev-manual/dev-manual-newbie.xml
index 600c789a6d..d10f629a4a 100644
--- a/documentation/dev-manual/dev-manual-newbie.xml
+++ b/documentation/dev-manual/dev-manual-newbie.xml
@@ -510,27 +510,40 @@
510 The <ulink url='&YOCTO_DOCS_REF_URL;#var-TOPDIR'><filename>TOPDIR</filename></ulink> 510 The <ulink url='&YOCTO_DOCS_REF_URL;#var-TOPDIR'><filename>TOPDIR</filename></ulink>
511 variable points to the Build Directory.</para> 511 variable points to the Build Directory.</para>
512 512
513 <para>You have a lot of flexibility when creating the Build Directory. 513 <para>
514 Following are some examples that show how to create the directory: 514 You have a lot of flexibility when creating the Build
515 Directory.
516 Following are some examples that show how to create the
517 directory.
518 The examples assume your
519 <link linkend='source-directory'>Source Directory</link> is
520 named <filename>poky</filename>:
515 <itemizedlist> 521 <itemizedlist>
516 <listitem><para>Create the Build Directory in your current working directory 522 <listitem><para>Create the Build Directory inside your
517 and name it <filename>build</filename>. 523 Source Directory and let the name of the Build
518 This is the default behavior. 524 Directory default to <filename>build</filename>:
519 <literallayout class='monospaced'> 525 <literallayout class='monospaced'>
520 $ source &OE_INIT_PATH; 526 $ cd $HOME/poky
527 $ source &OE_INIT_FILE;
521 </literallayout></para></listitem> 528 </literallayout></para></listitem>
522 <listitem><para>Provide a directory path and specifically name the build 529 <listitem><para>Create the Build Directory inside your
523 directory. 530 home directory and specifically name it
524 This next example creates a Build Directory named <filename>YP-&POKYVERSION;</filename> 531 <filename>test-builds</filename>:
525 in your home directory within the directory <filename>mybuilds</filename>.
526 If <filename>mybuilds</filename> does not exist, the directory is created for you:
527 <literallayout class='monospaced'> 532 <literallayout class='monospaced'>
528 $ source &OE_INIT_PATH; $HOME/mybuilds/YP-&POKYVERSION; 533 $ cd $HOME
534 $ source poky/&OE_INIT_FILE; test-builds
529 </literallayout></para></listitem> 535 </literallayout></para></listitem>
530 <listitem><para>Provide an existing directory to use as the Build Directory 536 <listitem><para>Provide a directory path and
531 and use the default <filename>build</filename> name. 537 specifically name the build directory.
538 Any intermediate folders in the pathname must
539 exist.
540 This next example creates a Build Directory named
541 <filename>YP-&POKYVERSION;</filename>
542 in your home directory within the existing
543 directory <filename>mybuilds</filename>:
532 <literallayout class='monospaced'> 544 <literallayout class='monospaced'>
533 $ source &OE_INIT_PATH; $HOME/mybuilds/ 545 $cd $HOME
546 $ source $HOME/poky/&OE_INIT_FILE; $HOME/mybuilds/YP-&POKYVERSION;
534 </literallayout></para></listitem> 547 </literallayout></para></listitem>
535 </itemizedlist> 548 </itemizedlist>
536 </para></listitem> 549 </para></listitem>