From 2491fc7833ede1ce3cf06d2f3f80b0b2bf1131d9 Mon Sep 17 00:00:00 2001 From: Tom Henderson Date: Tue, 4 Nov 2014 09:30:54 -0800 Subject: [PATCH] bug 1326: document the -- operator to build.py --- doc/tutorial/source/getting-started.rst | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/doc/tutorial/source/getting-started.rst b/doc/tutorial/source/getting-started.rst index cff67fb0b..601b874e9 100644 --- a/doc/tutorial/source/getting-started.rst +++ b/doc/tutorial/source/getting-started.rst @@ -478,6 +478,29 @@ the |ns3| programs by simply typing Okay, sorry, I made you build the |ns3| part of the system twice, but now you know how to change the configuration and build optimized code. +The build.py script discussed above supports also the ``--enable-examples`` +and ``enable-tests`` arguments, but in general, does not directly support +other waf options; for example, this will not work: + +:: + + $ ./build.py --disable-python + +will result in + +:: + + build.py: error: no such option: --disable-python + +However, the special operator ``--`` can be used to pass additional +options through to waf, so instead of the above, the following will work: + +:: + + $ ./build.py -- --disable-python + +as it generates the underlying command ``./waf configure --disable-python``. + Here are a few more introductory tips about Waf. Configure vs. Build