src/share/vm/logging/logTagSet.hpp

rev 8933 : 8046148.01
rev 8934 : 8046148.02

@@ -45,10 +45,13 @@
   LogOutputList     _output_list;
   LogDecorators     _decorators;
 
   // Keep constructor private to prevent incorrect instantiations of this class.
   // Only LogTagSetMappings can create/contain instances of this class.
+  // The constructor links all tagsets together in a global list of tagsets.
+  // This list is used during configuration to be able to update all tagsets
+  // and their configurations to reflect the new global log configuration.
   LogTagSet(LogTagType t0, LogTagType t1, LogTagType t2, LogTagType t3, LogTagType t4);
 
   template <LogTagType T0, LogTagType T1, LogTagType T2, LogTagType T3, LogTagType T4>
   friend class LogTagSetMapping;
 

@@ -100,9 +103,12 @@
   }
 };
 
 // Instantiate the static field _tagset for all tagsets that are used for logging somewhere.
 // (This must be done here rather than the .cpp file because it's a template.)
+// Each combination of tags used as template arguments to the Log class somewhere (via macro or not)
+// will instantiate the LogTagSetMapping template, which in turn creates the static field for that
+// tagset. This _tagset contains the configuration for those tags.
 template <LogTagType T0, LogTagType T1, LogTagType T2, LogTagType T3, LogTagType T4>
 LogTagSet LogTagSetMapping<T0, T1, T2, T3, T4>::_tagset(T0, T1, T2, T3, T4);
 
 #endif // SHARE_VM_LOGGING_LOGTAGSET_HPP