<feed xmlns='http://www.w3.org/2005/Atom'>
<title>buildroot/docs/manual, branch 2016.11</title>
<subtitle>OpenPOWER buildroot sources</subtitle>
<id>https://git.raptorcs.com/git/buildroot/atom?h=2016.11</id>
<link rel='self' href='https://git.raptorcs.com/git/buildroot/atom?h=2016.11'/>
<link rel='alternate' type='text/html' href='https://git.raptorcs.com/git/buildroot/'/>
<updated>2016-11-29T22:28:25+00:00</updated>
<entry>
<title>docs/manual: fix typo</title>
<updated>2016-11-29T22:28:25+00:00</updated>
<author>
<name>Lucile Quirion</name>
<email>lucile.quirion@savoirfairelinux.com</email>
</author>
<published>2016-11-29T17:17:03+00:00</published>
<link rel='alternate' type='text/html' href='https://git.raptorcs.com/git/buildroot/commit/?id=bf116466d2deb6c9f8f661c08142b43b0f4667e4'/>
<id>urn:sha1:bf116466d2deb6c9f8f661c08142b43b0f4667e4</id>
<content type='text'>
Also remove dangling reference to virtual package lists.

Signed-off-by: Lucile Quirion &lt;lucile.quirion@savoirfairelinux.com&gt;
Signed-off-by: Peter Korsgaard &lt;peter@korsgaard.com&gt;
</content>
</entry>
<entry>
<title>docs/manual: fix documentation about BR2_EXTERNAL_&lt;name&gt;_PATH variable</title>
<updated>2016-11-20T14:55:22+00:00</updated>
<author>
<name>Jerry Evans</name>
<email>g4@novadsp.com</email>
</author>
<published>2016-11-20T13:28:36+00:00</published>
<link rel='alternate' type='text/html' href='https://git.raptorcs.com/git/buildroot/commit/?id=d082d20a8ae3afd0638627fba662aaba7319ec69'/>
<id>urn:sha1:d082d20a8ae3afd0638627fba662aaba7319ec69</id>
<content type='text'>
The BR2_EXTERNAL documentation improperly tells to use the
BR2_EXTERNAL_&lt;name&gt;_DIR variable to reference the location of the
BR2_EXTERNAL directory. But in fact the variable is named
BR2_EXTERNAL_&lt;name&gt;_PATH.

In addition, some closing double quotes were missing.

This commit fixes both of those issues.

Signed-off-by: Jerry Evans &lt;g4@novadsp.com&gt;
Signed-off-by: Thomas Petazzoni &lt;thomas.petazzoni@free-electrons.com&gt;
</content>
</entry>
<entry>
<title>docs/manual: fix scanpypi path typos</title>
<updated>2016-10-19T21:39:42+00:00</updated>
<author>
<name>Danomi Manchego</name>
<email>danomimanchego123@gmail.com</email>
</author>
<published>2016-10-16T17:15:05+00:00</published>
<link rel='alternate' type='text/html' href='https://git.raptorcs.com/git/buildroot/commit/?id=556e9f327893eab613f13952a0adc861513889e9'/>
<id>urn:sha1:556e9f327893eab613f13952a0adc861513889e9</id>
<content type='text'>
Signed-off-by: Danomi Manchego &lt;danomimanchego123@gmail.com&gt;
Reviewed-by: Yegor Yefremov &lt;yegorslists@googlemail.com&gt;
Acked-by: Arnout Vandecappelle (Essensium/Mind) &lt;arnout@mind.be&gt;
Signed-off-by: Thomas Petazzoni &lt;thomas.petazzoni@free-electrons.com&gt;
</content>
</entry>
<entry>
<title>docs/manual: document both user-facing br2-external variables</title>
<updated>2016-10-19T21:20:43+00:00</updated>
<author>
<name>Yann E. MORIN</name>
<email>yann.morin.1998@free.fr</email>
</author>
<published>2016-10-19T20:56:05+00:00</published>
<link rel='alternate' type='text/html' href='https://git.raptorcs.com/git/buildroot/commit/?id=29673c8b1e5d5764fce58b2dcef839d412286552'/>
<id>urn:sha1:29673c8b1e5d5764fce58b2dcef839d412286552</id>
<content type='text'>
While BR2_EXTERNAL_&lt;NAME&gt;_PATH was already documented, it was not
made obvious that it could be reused in post-biuld, post-image and
in-fakeroot scripts.

The BR2_EXTERNAL_&lt;NAME&gt;_DESC variable was not documented at all.

Update the manual to fix this.

Note: a2x chokes on this:

    .Note:
    Both +BR2_EXTERNAL_$(NAME)_PATH+ and +BR2_EXTERNAL_$(NAME)_DESC+ are
      available [...]

and spits out a totally useless error message:

    a2x: ERROR: "xsltproc" --stringparam toc.section.depth 1 --stringparam
    callout.graphics 0 --stringparam navig.graphics 0 --stringparam
    admon.textlabel 1 --stringparam admon.graphic 0 --stringparam
    chunk.section.depth 0 --output "/home/ymorin/dev/buildroot/O/docs/manual/manual.html"
    "/etc/asciidoc/docbook-xsl/xhtml.xsl"
    "/home/ymorin/dev/buildroot/O/docs/manual/manual.xml" returned
    non-zero exit status 6

So, we had to resort to using different quoting styles for each
variables. They are not semantically equivalent, but the rendering
is the same with the default CSS (which we are using). That's gonna
be good-enough for now...

Reported-by: Thomas Petazzoni &lt;thomas.petazzoni@free-electrons.com&gt;
Signed-off-by: "Yann E. MORIN" &lt;yann.morin.1998@free.fr&gt;
Cc: Thomas Petazzoni &lt;thomas.petazzoni@free-electrons.com&gt;
Cc: Benoît Allard &lt;benoit.allard@greenbone.net&gt;
Signed-off-by: Thomas Petazzoni &lt;thomas.petazzoni@free-electrons.com&gt;
</content>
</entry>
<entry>
<title>docs/manual: document the br2-external desc: field</title>
<updated>2016-10-16T11:01:02+00:00</updated>
<author>
<name>Yann E. MORIN</name>
<email>yann.morin.1998@free.fr</email>
</author>
<published>2016-10-14T14:39:24+00:00</published>
<link rel='alternate' type='text/html' href='https://git.raptorcs.com/git/buildroot/commit/?id=4c75c3b80744bd67cf76dd54613d5be71b2af702'/>
<id>urn:sha1:4c75c3b80744bd67cf76dd54613d5be71b2af702</id>
<content type='text'>
Docuement the new, optional desc: field for an external.desc file.

That part of the manual was starting to be a bit of a mess, so
reorganise it. Provide a complete br2-external tree example.

Signed-off-by: "Yann E. MORIN" &lt;yann.morin.1998@free.fr&gt;
Signed-off-by: Peter Korsgaard &lt;peter@korsgaard.com&gt;
</content>
</entry>
<entry>
<title>core: allow a br2-external tree to override a defconfig</title>
<updated>2016-10-16T11:01:02+00:00</updated>
<author>
<name>Yann E. MORIN</name>
<email>yann.morin.1998@free.fr</email>
</author>
<published>2016-10-14T14:39:22+00:00</published>
<link rel='alternate' type='text/html' href='https://git.raptorcs.com/git/buildroot/commit/?id=339e1c9500cd1057118576c51be4953c23bc7a40'/>
<id>urn:sha1:339e1c9500cd1057118576c51be4953c23bc7a40</id>
<content type='text'>
Currently, it is not possible for a br2-external tree to override a
defconfig bundled in Buildroot, nor is it possible to override one from
a previous br2-external tree in the stack.

However, it is interesting that a latter br2-external tree be able to
override a defconfig:

  - the ones bundled in Buildroot are minimalist, and almost always
    build a toolchain, so a br2-external tree may want to provide a
    "better" defconfig (better, in the sense "suited for the project");

  - similarly for a defconfig from a previous br2-external tree.

But we can't do that, as the rules for the defconfigs are generated in
the order the br2-external trees are specified, all after the bundled
defconfigs. Those rule are patten-matching rules, which means that the
first one to match is used, and the following ones are ignored.

Add a new utility macro, 'reverse', inspired from GMSL, that does what
it says: reverse a list of words.

Use that macro to reverse the list of br2-external trees, so that the
latters win over the formers, and even over bundled ones.

Signed-off-by: "Yann E. MORIN" &lt;yann.morin.1998@free.fr&gt;
Cc: Thomas Petazzoni &lt;thomas.petazzoni@free-electrons.com&gt;
Cc: Arnout Vandecappelle &lt;arnout@mind.be&gt;
Cc: Samuel Martin &lt;s.martin49@gmail.com&gt;
Cc: Romain Naour &lt;romain.naour@openwide.fr&gt;
Cc: Julien CORJON &lt;corjon.j@ecagroup.com&gt;
Signed-off-by: Peter Korsgaard &lt;peter@korsgaard.com&gt;
</content>
</entry>
<entry>
<title>docs/manual: document multi br2-external</title>
<updated>2016-10-16T11:01:02+00:00</updated>
<author>
<name>Yann E. MORIN</name>
<email>yann.morin.1998@free.fr</email>
</author>
<published>2016-10-14T14:39:21+00:00</published>
<link rel='alternate' type='text/html' href='https://git.raptorcs.com/git/buildroot/commit/?id=1b496d40e3457e42fcf35004c677af4dc91dd935'/>
<id>urn:sha1:1b496d40e3457e42fcf35004c677af4dc91dd935</id>
<content type='text'>
Signed-off-by: "Yann E. MORIN" &lt;yann.morin.1998@free.fr&gt;
Cc: Thomas Petazzoni &lt;thomas.petazzoni@free-electrons.com&gt;
Cc: Arnout Vandecappelle &lt;arnout@mind.be&gt;
Cc: Samuel Martin &lt;s.martin49@gmail.com&gt;
Cc: Romain Naour &lt;romain.naour@openwide.fr&gt;
Cc: Julien CORJON &lt;corjon.j@ecagroup.com&gt;
Signed-off-by: Peter Korsgaard &lt;peter@korsgaard.com&gt;
</content>
</entry>
<entry>
<title>docs/manual: add appendix to convert old br2-external trees</title>
<updated>2016-10-16T11:01:02+00:00</updated>
<author>
<name>Yann E. MORIN</name>
<email>yann.morin.1998@free.fr</email>
</author>
<published>2016-10-14T14:39:19+00:00</published>
<link rel='alternate' type='text/html' href='https://git.raptorcs.com/git/buildroot/commit/?id=a71e311df62505bf69b74e9f16b43a5f91bb4623'/>
<id>urn:sha1:a71e311df62505bf69b74e9f16b43a5f91bb4623</id>
<content type='text'>
Signed-off-by: "Yann E. MORIN" &lt;yann.morin.1998@free.fr&gt;
Cc: Thomas Petazzoni &lt;thomas.petazzoni@free-electrons.com&gt;
Cc: Arnout Vandecappelle &lt;arnout@mind.be&gt;
Cc: Samuel Martin &lt;s.martin49@gmail.com&gt;
Cc: Romain Naour &lt;romain.naour@openwide.fr&gt;
Cc: Julien CORJON &lt;corjon.j@ecagroup.com&gt;
[Peter: slightly reword]
Signed-off-by: Peter Korsgaard &lt;peter@korsgaard.com&gt;
</content>
</entry>
<entry>
<title>docs/manual: document the br2-external NAME</title>
<updated>2016-10-16T11:01:02+00:00</updated>
<author>
<name>Yann E. MORIN</name>
<email>yann.morin.1998@free.fr</email>
</author>
<published>2016-10-14T14:39:18+00:00</published>
<link rel='alternate' type='text/html' href='https://git.raptorcs.com/git/buildroot/commit/?id=a88718a952762a6a14bb1e4c87739b17a657746a'/>
<id>urn:sha1:a88718a952762a6a14bb1e4c87739b17a657746a</id>
<content type='text'>
Update the manual with the new external.desc mandatory file.

Take the opportunity to add a section listing all mandatory files,
Config.in, external.mk and the new external.desc, instead of just
hinting about them in the external package recipes section.

Change the examples to use the NAME-suffixed variable instead of the
raw BR2_EXTERNAL variable.

Change all references to BR2_EXTERNAL elsewhere in the manual to now
use the 'br2-external tree' terminology.

Signed-off-by: "Yann E. MORIN" &lt;yann.morin.1998@free.fr&gt;
Cc: Thomas Petazzoni &lt;thomas.petazzoni@free-electrons.com&gt;
Cc: Arnout Vandecappelle &lt;arnout@mind.be&gt;
Cc: Samuel Martin &lt;s.martin49@gmail.com&gt;
Cc: Romain Naour &lt;romain.naour@openwide.fr&gt;
Cc: Julien CORJON &lt;corjon.j@ecagroup.com&gt;
Signed-off-by: Peter Korsgaard &lt;peter@korsgaard.com&gt;
</content>
</entry>
<entry>
<title>docs: update URL to uClibc-ng homepage</title>
<updated>2016-10-14T14:49:35+00:00</updated>
<author>
<name>Waldemar Brodkorb</name>
<email>wbx@openadk.org</email>
</author>
<published>2016-10-14T09:29:04+00:00</published>
<link rel='alternate' type='text/html' href='https://git.raptorcs.com/git/buildroot/commit/?id=3aa01695eabb9183ffb804337924a7bd649be9ec'/>
<id>urn:sha1:3aa01695eabb9183ffb804337924a7bd649be9ec</id>
<content type='text'>
It is not necessary to update all mentioning of uClibc, but
at least we should point to the right homepage of the used
project.

Signed-off-by: Waldemar Brodkorb &lt;wbx@openadk.org&gt;
Reviewed-by: Arnout Vandecappelle (Essensium/Mind) &lt;arnout@mind.be&gt;
Signed-off-by: Peter Korsgaard &lt;peter@korsgaard.com&gt;
</content>
</entry>
</feed>
