docs/make-tips.txt

   1 // -*- mode:doc; -*-
   2 // vim: set syntax=asciidoc:
   3
   4 [[make-tips]]
   5 'make' tips
   6 -----------
   7
   8 This is a collection of tips that help you make the most of OpenADK.
   9
  10 .Configuration searches:
  11
  12 The +make menuconfig+ command offer a search tool.
  13 The search tool is called by pressing +/+;
  14 The result of the search shows the help message of the matching items.
  15
  16 .Display all commands executed by make:
  17
  18 --------------------
  19  $ make v
  20 --------------------
  21
  22 or
  23
  24 --------------------
  25  $ make ADK_VERBOSE=1 <target>
  26 --------------------
  27
  28 .Display all available targets:
  29
  30 --------------------
  31  $ make help
  32 --------------------
  33
  34 .Cleaning:
  35
  36 There are different cleaning targets available. If a full clean is
  37 necessary, you normally will get a message from OpenADK.
  38 To delete all build products (including build directories, target, host
  39 and pkg trees, the firmware and the toolchain for all targets):
  40
  41 --------------------
  42  $ make cleandir
  43 --------------------
  44
  45 If you even want to clean any downloaded source and your
  46 configuration +.config+:
  47
  48 --------------------
  49  $ make distclean
  50 --------------------
  51
  52 If you only want to clean the kernel build, because you added or
  53 removed some patch, just do:
  54
  55 --------------------
  56  $ make cleankernel
  57 --------------------
  58
  59 If you just want to clean all packages and wants to rebuild the firmware,
  60 (the toolchain is not deleted) just use:
  61
  62 --------------------
  63  $ make clean
  64 --------------------
  65
  66 .Resetting OpenADK for a new target:
  67
  68 Delete the configuration and start from scratch:
  69
  70 --------------------
  71  $ rm .config*
  72  $ make menuconfig
  73 --------------------
  74
  75 OpenADK is designed to have multiple architectures and embedded system
  76 combinations configured and build without a need to rebuild everything
  77 from scratch. There is no limit, you just need to have enough disk space.