Index: . =================================================================== --- . (revision 537769) +++ . (working copy) @@ -24,43 +24,43 @@ /** - * A Handler put the description of log events into a cycled memory - * buffer. - *

- * Mostly this MemoryHandler just puts the given LogRecord - * into the internal buffer and doesn't perform any formatting or any other process. - * When the buffer is full, the earliest buffered records will be discarded. - *

+ * MemoryHandler is a Handler that 'remembers' a + * finite number of LogRecords at a time and stores them in a + * buffer without formatting them. When the buffer is full this + * Handler overwrites the oldest record as each new record is + * added. + * *

- * Every MemoryHandler has a target handler, and push action can be - * triggered so that all buffered records will be output to the target handler - * and normally the latter will publish the records. After the push action, the - * buffer will be cleared. + * Every MemoryHandler has a target Handler, and + * calling the push() method on the MemoryHandler + * will output all buffered records to the target Handler After + * the push action, the buffer will be cleared. *

+ * *

- * The push action can be triggered in three ways: - *

+ * The push method can be called directly, but will also be called automatically + * if a new LogRecord is added that has a level greater than or + * equal to than the value defined for the property + * java.util.logging.MemoryHandler.push. *

+ * *

- * MemoryHandler will read following LogManager - * properties for initialization, if given properties are not defined or has - * invalid values, default value will be used. + * MemoryHandler defines the following configuration properties, + * which are read by the LogManager on initialization. If the + * properties have not been specified then defaults will be used. The properties + * and defaults are as follows: *

*

*