manual: add explanations on limitations about using O=...
authorYann E. MORIN <yann.morin.1998@free.fr>
Fri, 21 Feb 2014 22:17:54 +0000 (23:17 +0100)
committerPeter Korsgaard <peter@korsgaard.com>
Sat, 22 Feb 2014 20:56:57 +0000 (21:56 +0100)
commita524731012280dbb52fd0051a5c7c94a4562b265
tree1ac2685f5890bd920b096568324a8b94700845d6
parent1de64ec8c08f6e954f1f1b616ebb3be7f9cef3e7
manual: add explanations on limitations about using O=...

Using a relative path for O=... has limitations, since it is interpreted
relative to the Buildroot tree, and thus may lead to unexpected results.

For example, running this:
    make -C buildroot O=my-O

will not create my-O in the current working directory, but as a
sub-directory of the Buildroot tree, here in buildroot/my-O

Explain this in the manual (as is similarly done for BR2_EXTERNAL).
Also add a note that $(O) will be created if missing.

Also change O=.. and -C .. to O=<...> and -C <...> to make it explicit
this is an ellipse, not a relative path.

Reported-by: Jérémy Rosen <jeremy.rosen@openwide.fr>
Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr>
Cc: Samuel Martin <s.martin49@gmail.com>
Reviewed-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
Acked-by: Samuel Martin <s.martin49@gmail.com>
Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
docs/manual/common-usage.txt