diff options
Diffstat (limited to 'docs/manual/br2-external-converting.txt')
| -rw-r--r-- | docs/manual/br2-external-converting.txt | 36 |
1 files changed, 36 insertions, 0 deletions
diff --git a/docs/manual/br2-external-converting.txt b/docs/manual/br2-external-converting.txt new file mode 100644 index 0000000000..73bd878ce5 --- /dev/null +++ b/docs/manual/br2-external-converting.txt @@ -0,0 +1,36 @@ +// -*- mode:doc; -*- +// vim: set syntax=asciidoc: + +[[br2-external-converting]] +== Converting old br2-external trees + +Buildroot 2016.11 introduced a backward-incompatible change in the way +br2-external trees are handled. A minor change has to be made: adding +a name to your br2-external tree, see xref:outside-br-custom[]. + +This can be done very easily in just a few steps: + + * First, create a new file named +external.desc+, at the root of your + br2-external tree, with a single line defining the name of your + br2-external tree: ++ +---- +$ echo 'name: NAME_OF_YOUR_TREE' >external.desc +---- ++ +.Note +Be careful when choosing a name: It has to be unique and be made +with only ASCII characters from the set +[A-Za-z0-9_]+. + + * Then, change every occurence of +BR2_EXTERNAL+ in your br2-external + tree with the new variable: ++ +---- +$ find . -type f | xargs sed -i 's/BR2_EXTERNAL/BR2_EXTERNAL_NAME_OF_YOUR_TREE_PATH/g' +---- + +Now, your br2-external tree can be used with Buildroot 2016.11 onward. + +.Note: +This change makes your br2-external tree incompatible with Buildroot +before 2016.11. |
