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 ADK_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
--------------------

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:

Delete the configuration and start from scratch:

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

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.