kumquat-buildroot/docs/manual
Yann E. MORIN a524731012 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>
2014-02-22 21:56:57 +01:00
..
adding-packages-autotools.txt
adding-packages-cmake.txt
adding-packages-conclusion.txt
adding-packages-directory.txt
adding-packages-generic.txt
adding-packages-gettext.txt
adding-packages-hooks.txt
adding-packages-luarocks.txt
adding-packages-python.txt
adding-packages-tips.txt
adding-packages.txt
advanced.txt
appendix.txt
beyond-buildroot.txt
ccache-support.txt
common-usage.txt manual: add explanations on limitations about using O=... 2014-02-22 21:56:57 +01:00
configure.txt
contribute.txt
customize-busybox-config.txt
customize-kernel-config.txt
customize-outside-br.txt
customize-packages.txt
customize-rootfs.txt
customize-store.txt
customize-toolchain.txt
customize-uclibc-config.txt
customize.txt
debugging-buildroot.txt
developer-guide.txt
download-infra.txt
download-location.txt
eclipse-integration.txt
faq-troubleshooting.txt
get-involved.txt
getting.txt
going-further.txt
how-buildroot-works.txt
introduction.txt
known-issues.txt
legal-notice.txt
make-tips.txt
makedev-syntax.txt
makeusers-syntax.txt
manual.mk
manual.txt
package-make-target.txt
patch-policy.txt
prerequisite.txt
rebuilding-packages.txt
starting-up.txt
using-buildroot-toolchain.txt
using.txt
working-with.txt
writing-rules.txt