svn commit: r777888 - /incubator/log4php/trunk/src/main/php/LoggerHierarchy.php

[gr...@apache.org]

Author: grobmeier
Date: Sat May 23 10:50:00 2009
New Revision: 777888

URL: http://svn.apache.org/viewvc?rev=777888&view=rev
Log:
added phpdoc

Modified:
    incubator/log4php/trunk/src/main/php/LoggerHierarchy.php

Modified: incubator/log4php/trunk/src/main/php/LoggerHierarchy.php
URL: http://svn.apache.org/viewvc/incubator/log4php/trunk/src/main/php/LoggerHierarchy.php?rev=777888&r1=777887&r2=777888&view=diff
==============================================================================
--- incubator/log4php/trunk/src/main/php/LoggerHierarchy.php (original)
+++ incubator/log4php/trunk/src/main/php/LoggerHierarchy.php Sat May 23 10:50:00 2009
@@ -1,5 +1,5 @@
 <?php
-/**
+/*
  * Licensed to the Apache Software Foundation (ASF) under one or more
  * contributor license agreements. See the NOTICE file distributed with
  * this work for additional information regarding copyright ownership.
@@ -21,8 +21,17 @@
 
 /**
  * This class is specialized in retrieving loggers by name and also maintaining 
- * the logger hierarchy.
- *
+ * the logger hierarchy. The logger hierarchy is dealing with the several Log-Levels
+ * Logger can have. From log4j website:
+ * 
+ * "A logger is said to be an ancestor of another logger if its name followed 
+ * by a dot is a prefix of the descendant logger name. A logger is said to be
+ * a parent of a child logger if there are no ancestors between itself and the 
+ * descendant logger."
+ * 
+ * Child Loggers do inherit their Log-Levels from their Ancestors. They can
+ * increase their Log-Level compared to their Ancestors, but they cannot decrease it.
+ * 
  * <p>The casual user does not have to deal with this class directly.</p>
  *
  * <p>The structure of the logger hierarchy is maintained by the