openadk/docs/make-tips.txt

// -*- mode:doc; -*-
// vim: set syntax=asciidoc:

[[make-tips]]
'make' tips
-----------

This is a collection of tips that help you make the most of OpenADK.

.Configuration searches:

The +make menuconfig+ command offer a search tool. 
The search tool is called by pressing +/+;
The result of the search shows the help message of the matching items.

.Display all commands executed by make:

--------------------
 $ make v
--------------------

or

--------------------
 $ make VERBOSE=1 <target>
--------------------

.Display all available targets:

--------------------
 $ make help
--------------------

.Cleaning:

There are different cleaning targets available. If a full clean is
necessary, you normally will get a message from OpenADK.
To delete all build products (including build directories, target, host
and pkg trees, the firmware and the toolchain for all targets):

--------------------
 $ make cleandir
--------------------

If you even want to clean any downloaded source and your 
configuration +.config+:

--------------------
 $ make distclean
--------------------

If you only want to clean the kernel build, because you added or
removed some patch, just do:

--------------------
 $ make cleankernel
--------------------

This is automatically triggered if you change the kernel version in 
your configuration.

If you just want to clean all packages and wants to rebuild the firmware,
(the toolchain is not deleted) just use:

--------------------
 $ make clean
--------------------

.Resetting OpenADK for a new target:

You can either delete the configuration and start from scratch:

--------------------
 $ rm .config*
 $ make menuconfig
--------------------

Or you can save your existing configuration and switch to a new
one with:

--------------------
 $ make switch
--------------------

Afterwards you can switch back to your old configuration, you just
need to remember, which architecture and system you had configured:

--------------------
 $ make switch ARCH=<arch> SYSTEM=<system>
--------------------

OpenADK is designed to have multiple architectures and embedded system
combinations configured and build without a need to rebuild everything
from scratch. There is no limit, you just need to have enough disk space.