--- a/src/mobility/examples/ns2-mobility-trace.cc	Tue Sep 25 06:52:39 2012 -0700
+++ b/src/mobility/examples/ns2-mobility-trace.cc	Tue Sep 25 06:52:57 2012 -0700
@@ -25,12 +25,10 @@
  *
  *  - intended usage: this should be used in order to load ns2 movement trace files into ns3.
  *  - behavior:
- *      - Ns2MobilityHelperTrace object is created, whith the specified trace file. At this moment, only
- *      specify the file, and no movements are scheduled.
+ *      - Ns2MobilityHelper object is created, associated to the specified trace file. 
  *      - A log file is created, using the log file name argument.
- *      - A node container is created with the correct node number specified in the command line.
- *      - Use Install method of Ns2MobilityHelperTrace to set mobility to nodes. At this moment, file is
- *      read line by line, and the movement is scheduled in the simulator.
+ *      - A node container is created with the number of nodes specified in the command line.  For the default ns-2 trace, specify the value 2 for this argument.
+ *      - the program calls the Install() method of Ns2MobilityHelper to set mobility to nodes. At this moment, the file is read line by line, and the movement is scheduled in the simulator.
  *      - A callback is configured, so each time a node changes its course a log message is printed.
  *  - expected output: example prints out messages generated by each read line from the ns2 movement trace file.
  *                     For each line, it shows if the line is correct, or of it has errors and in this case it will
@@ -43,10 +41,10 @@
  *        --nodeNum=2  --duration=100.0 --logFile=ns2-mobility-trace.log"
  *
  *  NOTE: ns2-traces-file could be an absolute or relative path. You could use the file default.ns_movements
- *        included in the same directory that the present file.
+ *        included in the same directory as the example file.
  *  NOTE 2: Number of nodes present in the trace file must match with the command line argument.
  *          Note that you must know it before to be able to load it.
- *  NOTE 3: Duration must be a positive number. Note that you must know it before to be able to load it.
+ *  NOTE 3: Duration must be a positive number and should match the trace file. Note that you must know it before to be able to load it.
  */