From a64b4172d11fb3e0da319a73fcfb4e5412ed18fb Mon Sep 17 00:00:00 2001
From: Craig Dowell <craigdo@ee.washington.edu>
Date: Thu, 28 Jan 2010 17:42:51 -0800
Subject: [PATCH] update CHANGES.html

---
 CHANGES.html | 41 +++++++++++++++++++++++++++++------------
 1 file changed, 29 insertions(+), 12 deletions(-)

diff --git a/CHANGES.html b/CHANGES.html
index 997837b14..35c7da448 100644
--- a/CHANGES.html
+++ b/CHANGES.html
@@ -54,35 +54,52 @@ us a note on ns-developers mailing list.  </p>
 <ul>
 </pre>
 <li><b>Tracing Helpers</b>: The organization of helpers for both pcap and ascii
-tracing has been reworked.  Instead of each device and stack helper 
-re-implementing trace enable methods, classes have been developed to implement
-user-level tracing in a consistent way; and device and stack helpers use those
-classes to provide tracing functionality.<br>
+tracing, in devices and protocols, has been reworked.  Instead of each device 
+and protocol helper re-implementing trace enable methods, classes have been 
+developed to implement user-level tracing in a consistent way; and device and 
+protocol helpers use those classes to provide tracing functionality.<br>
 In addition to consistent operation across all helpers, the object name service
 has been integrated into the trace file naming scheme.<br>
+The internet stack helper has been extensively massaged to make it easier to 
+manage traces originating from protocols.  It used to be the case that there 
+was essentially no opportunity to filter tracing on interfaces, and resulting
+trace file names collided with those created by devices.  File names are now
+disambiguated and one can enable traces on a protocol/interface basis analogously
+to the node/device granularity of device-based helpers.<br>
 The primary user-visible results of this change are that trace-related functions
 have been changed from static functions to method calls; and a new object has
 been developed to hold streams for ascii traces.<br>
+New functionality is present for ascii traces.  It is now possible to create
+multiple ascii trace files automatically just as was possible for pcap trace 
+files.<br>
 The implementation of the helper code has been designed also to provide 
 functionality to make it easier for sophisticated users to hook traces of 
 various kinds and write results to (file) streams.
 Before:
 <pre>
-CsmaHelper::EnablePcapAll ();
+  CsmaHelper::EnablePcapAll ();
 
-std::ofstream ascii;
-ascii.open ("csma-one-subnet.tr", std::ios_base::binary | std::ios_base::out);
-CsmaHelper::EnableAsciiAll (ascii);
+  std::ofstream ascii;
+  ascii.open ("csma-one-subnet.tr", std::ios_base::binary | std::ios_base::out);
+  CsmaHelper::EnableAsciiAll (ascii);
+
+  InternetStackHelper::EnableAsciiAll (ascii);
 </pre>
 After:
 <pre>
-CsmaHelper csmaHelper;
-csmaHelper.EnablePcapAll ();
+  CsmaHelper csmaHelper;
+  InternetStackHelper stack;
+  csmaHelper.EnablePcapAll ();
+
+  AsciiTraceHelper ascii;
+  csma.EnableAsciiAll (ascii.CreateFileStream ("csma-one-subnet.tr"));
+
+  stack.EnableAsciiIpv4All (stream);
 
-AsciiTraceHelper ascii;
-csma.EnableAsciiAll (ascii.CreateFileStream ("csma-one-subnet.tr"));
 </pre>
 
+
+
 <hr>
 <h1>Changes from ns-3.6 to ns-3.7</h1>