docs/manual/br2-external-converting.txt

   1 // -*- mode:doc; -*-
   2 // vim: set syntax=asciidoc:
   3
   4 [[br2-external-converting]]
   5 == Converting old br2-external trees
   6
   7 Before Buildroot 2016.11, it was possible to use only one br2-external
   8 tree at once. With Buildroot 2016.11 came the possibility to use more
   9 than one simultaneously (for details, see xref:outside-br-custom[]).
  10
  11 This however means that older br2-external trees are not usable as-is.
  12 A minor change has to be made: adding a name to your br2-external tree.
  13
  14 This can be done very easily in just a few steps:
  15
  16  * First, create a new file named +external.desc+, at the root of your
  17    br2-external tree, with a single line defining the name of your
  18    br2-external tree:
  19 +
  20 ----
  21 $ echo 'name: NAME_OF_YOUR_TREE' >external.desc
  22 ----
  23 +
  24 .Note
  25 Be careful when choosing a name: It has to be unique and be made
  26 with only ASCII characters from the set +[A-Za-z0-9_]+.
  27
  28  * Then, change every occurence of +BR2_EXTERNAL+ in your br2-external
  29    tree with the new variable:
  30 +
  31 ----
  32 $ find . -type f | xargs sed -i 's/BR2_EXTERNAL/BR2_EXTERNAL_NAME_OF_YOUR_TREE_PATH/g'
  33 ----
  34
  35 Now, your br2-external tree can be used with Buildroot 2016.11 onward.
  36
  37 .Note:
  38 This change makes your br2-external tree incompatible with Buildroot
  39 before 2016.11.