Bug 1511 - Rephrase "Modules not built"
Rephrase "Modules not built"
Status: RESOLVED FIXED
Product: ns-3
Classification: Unclassified
Component: build system
pre-release
All All
: P5 normal
Assigned To: Tom Henderson
:
Depends on:
Blocks:
  Show dependency treegraph
 
Reported: 2012-10-11 01:06 UTC by John Abraham
Modified: 2012-12-05 23:46 UTC (History)
2 users (show)

See Also:


Attachments
patch to fix (1.60 KB, patch)
2012-11-30 17:44 UTC, Tom Henderson
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description John Abraham 2012-10-11 01:06:00 UTC
Currently we display 
Modules built:
antenna                   aodv                      applications             
bridge                    buildings                 config-store             
core                      csma                      csma-layout              
dsdv                      dsr                       energy                   
flow-monitor              internet                  lte                      
mesh                      mobility                  mpi                      
netanim (no Python)       network                   nix-vector-routing       
olsr                      point-to-point            point-to-point-layout    
propagation               spectrum                  stats                    
test (no Python)          tools                     topology-read            
uan                       virtual-net-device        wifi                     
wimax                    

Modules not built:
click                     emu                       openflow                 
tap-bridge                visualizer           

Several users since perhaps ns-3.11 have panicked when they see "Modules not built", needing email exchanges to explain this.

It will help greatly if we re-phrase "Modules not built" or print an additional line pointing the user to some README explaining this. 
In the README we could mention , that some modules are built only on explicit request and their absence will not impact normal functioning of the simulator
Comment 1 Tom Henderson 2012-10-11 10:38:09 UTC
(In reply to comment #0)
> Currently we display 
> Modules built:
> antenna                   aodv                      applications             
> bridge                    buildings                 config-store             
> core                      csma                      csma-layout              
> dsdv                      dsr                       energy                   
> flow-monitor              internet                  lte                      
> mesh                      mobility                  mpi                      
> netanim (no Python)       network                   nix-vector-routing       
> olsr                      point-to-point            point-to-point-layout    
> propagation               spectrum                  stats                    
> test (no Python)          tools                     topology-read            
> uan                       virtual-net-device        wifi                     
> wimax                    
> 
> Modules not built:
> click                     emu                       openflow                 
> tap-bridge                visualizer           
> 
> Several users since perhaps ns-3.11 have panicked when they see "Modules not
> built", needing email exchanges to explain this.
> 
> It will help greatly if we re-phrase "Modules not built" or print an additional
> line pointing the user to some README explaining this. 
> In the README we could mention , that some modules are built only on explicit
> request and their absence will not impact normal functioning of the simulator

How about putting this into the tutorial here, instead of the README?
http://www.nsnam.org/docs/tutorial/html/getting-started.html#building-ns-3
Comment 2 John Abraham 2012-10-11 11:24:32 UTC
Sure , a pointer to the tutorial is also good.
Hopefully we can dedicate a small section related to explaining "Modules not built" in the tutorial.

Like:

Modules not built:
(Refer http://www.nsnam.org/.....)
emu  openflow 

This can potentially reduce the number of users who consider "Modules not built" as an ERROR and avoid needing to send email to ns-3-users.




(In reply to comment #0)
> Currently we display 
> Modules built:
> antenna                   aodv                      applications             
> bridge                    buildings                 config-store             
> core                      csma                      csma-layout              
> dsdv                      dsr                       energy                   
> flow-monitor              internet                  lte                      
> mesh                      mobility                  mpi                      
> netanim (no Python)       network                   nix-vector-routing       
> olsr                      point-to-point            point-to-point-layout    
> propagation               spectrum                  stats                    
> test (no Python)          tools                     topology-read            
> uan                       virtual-net-device        wifi                     
> wimax                    
> 
> Modules not built:
> click                     emu                       openflow                 
> tap-bridge                visualizer           
> 
> Several users since perhaps ns-3.11 have panicked when they see "Modules not
> built", needing email exchanges to explain this.
> 
> It will help greatly if we re-phrase "Modules not built" or print an additional
> line pointing the user to some README explaining this. 
> In the README we could mention , that some modules are built only on explicit
> request and their absence will not impact normal functioning of the simulator

(In reply to comment #1)
> (In reply to comment #0)
> > Currently we display 
> > Modules built:
> > antenna                   aodv                      applications             
> > bridge                    buildings                 config-store             
> > core                      csma                      csma-layout              
> > dsdv                      dsr                       energy                   
> > flow-monitor              internet                  lte                      
> > mesh                      mobility                  mpi                      
> > netanim (no Python)       network                   nix-vector-routing       
> > olsr                      point-to-point            point-to-point-layout    
> > propagation               spectrum                  stats                    
> > test (no Python)          tools                     topology-read            
> > uan                       virtual-net-device        wifi                     
> > wimax                    
> > 
> > Modules not built:
> > click                     emu                       openflow                 
> > tap-bridge                visualizer           
> > 
> > Several users since perhaps ns-3.11 have panicked when they see "Modules not
> > built", needing email exchanges to explain this.
> > 
> > It will help greatly if we re-phrase "Modules not built" or print an additional
> > line pointing the user to some README explaining this. 
> > In the README we could mention , that some modules are built only on explicit
> > request and their absence will not impact normal functioning of the simulator
> 
> How about putting this into the tutorial here, instead of the README?
> http://www.nsnam.org/docs/tutorial/html/getting-started.html#building-ns-3
Comment 3 Tom Henderson 2012-11-30 17:44:36 UTC
Created attachment 1479 [details]
patch to fix

planning to apply for ns-3.16 if no further comments
Comment 4 Tom Henderson 2012-12-05 23:46:20 UTC
pushed in changeset: f8bff624db3c