clarify 'Modules not built' waf report
authorTom Henderson <tomh@tomh.org>
Wed, 05 Dec 2012 20:45:38 -0800
changeset 9169 f8bff624db3c
parent 9168 2ff57d50b827
child 9170 0c6d395e5db2
clarify 'Modules not built' waf report
doc/tutorial/source/getting-started.rst
wscript
--- a/doc/tutorial/source/getting-started.rst	Wed Dec 05 20:35:21 2012 -0800
+++ b/doc/tutorial/source/getting-started.rst	Wed Dec 05 20:45:38 2012 -0800
@@ -299,6 +299,22 @@
   topology-read             uan                       virtual-net-device
   visualizer                wifi                      wimax
 
+  Waf: Leaving directory `/home/craigdo/repos/ns-3-allinone/ns-3.13/build'
+  'build' finished successfully (2m30.586s)
+  
+You may also see something like:
+
+::
+
+  Modules not built (see ns-3 tutorial for explanation):
+  click                     openflow                  visualizer     
+
+This just means that some ns-3 modules that have dependencies on
+outside libraries may not have been built, or that the configuration
+specifically asked not to build them.  It does not mean that the 
+simulator did not build successfully or that it will provide wrong 
+results for the modules listed as being built.
+
 Once the project has built, you can stop working with the
 ``ns-3-allinone`` scripts.  You got what you needed from them and will now 
 interact directly with Waf and we do it in the |ns3| directory,
--- a/wscript	Wed Dec 05 20:35:21 2012 -0800
+++ b/wscript	Wed Dec 05 20:45:38 2012 -0800
@@ -876,7 +876,7 @@
 
         # Print the list of enabled modules that were not built.
         if env['MODULES_NOT_BUILT']:
-            print 'Modules not built:'
+            print 'Modules not built (see ns-3 tutorial for explanation):'
             print_module_names(env['MODULES_NOT_BUILT'])
             print