logging-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ihabu...@apache.org
Subject [2/2] git commit: Improvements to phpdoc.
Date Tue, 03 Dec 2013 16:47:24 GMT
Improvements to phpdoc.

- removed html markup
- removed tabs in comments
- misc improvements

Signed-off-by: Ivan Habunek <ivan.habunek@gmail.com>


Project: http://git-wip-us.apache.org/repos/asf/logging-log4php/repo
Commit: http://git-wip-us.apache.org/repos/asf/logging-log4php/commit/2378545f
Tree: http://git-wip-us.apache.org/repos/asf/logging-log4php/tree/2378545f
Diff: http://git-wip-us.apache.org/repos/asf/logging-log4php/diff/2378545f

Branch: refs/heads/v3
Commit: 2378545f51ce335cc7a48d86a1875d4f116e137a
Parents: 75ec90f
Author: Ivan Habunek <ivan.habunek@gmail.com>
Authored: Tue Dec 3 17:46:35 2013 +0100
Committer: Ivan Habunek <ivan.habunek@gmail.com>
Committed: Tue Dec 3 17:46:35 2013 +0100

----------------------------------------------------------------------
 src/AppenderPool.php                            |  6 +-
 src/Appenders/AbstractAppender.php              | 20 +++---
 src/Appenders/ConsoleAppender.php               |  2 +-
 src/Appenders/DailyFileAppender.php             |  2 +-
 src/Appenders/EchoAppender.php                  |  2 +-
 src/Appenders/FileAppender.php                  |  2 +-
 src/Appenders/MailAppender.php                  |  2 +-
 src/Appenders/MailEventAppender.php             |  2 +-
 src/Appenders/MongoDBAppender.php               |  6 +-
 src/Appenders/NullAppender.php                  |  2 +-
 src/Appenders/PdoAppender.php                   |  2 +-
 src/Appenders/PhpAppender.php                   |  8 +--
 src/Appenders/RollingFileAppender.php           |  2 +-
 src/Appenders/SocketAppender.php                |  2 +-
 src/Appenders/SyslogAppender.php                | 22 +++----
 src/Autoloader.php                              |  2 +-
 src/Configurable.php                            |  2 +-
 src/Configuration/ConfiguratorInterface.php     | 10 +--
 src/Configuration/DefaultConfigurator.php       | 44 ++++++-------
 src/Configuration/adapters/AdapterInterface.php |  2 +-
 src/Configuration/adapters/IniAdapter.php       | 28 ++++----
 src/Configuration/adapters/PhpAdapter.php       |  6 +-
 src/Configuration/adapters/XmlAdapter.php       |  2 +-
 src/Filters/AbstractFilter.php                  | 43 +++++++------
 src/Filters/DenyAllFilter.php                   |  2 +-
 src/Filters/LevelMatchFilter.php                | 41 +++++-------
 src/Filters/LevelRangeFilter.php                | 48 ++++++--------
 src/Filters/StringMatchFilter.php               | 12 ++--
 src/Helpers/FormattingInfo.php                  |  2 +-
 src/Helpers/OptionConverter.php                 |  4 +-
 src/Helpers/PatternParser.php                   |  6 +-
 src/Helpers/Utils.php                           |  2 +-
 src/Hierarchy.php                               | 24 +++----
 src/Layouts/AbstractLayout.php                  |  2 +-
 src/Layouts/HtmlLayout.php                      | 22 +++----
 src/Layouts/PatternLayout.php                   |  2 +-
 src/Layouts/SerializedLayout.php                |  2 +-
 src/Layouts/SimpleLayout.php                    |  8 +--
 src/Layouts/XmlLayout.php                       |  6 +-
 src/Level.php                                   | 22 ++++---
 src/LocationInfo.php                            |  2 +-
 src/Logger.php                                  | 18 +++---
 src/LoggerException.php                         |  2 +-
 src/LoggingEvent.php                            | 43 +++++++------
 src/MDC.php                                     |  6 +-
 src/NDC.php                                     | 67 ++++++++++----------
 src/Pattern/AbstractConverter.php               |  6 +-
 src/Pattern/ClassConverter.php                  |  2 +-
 src/Pattern/CookieConverter.php                 |  2 +-
 src/Pattern/DateConverter.php                   |  2 +-
 src/Pattern/EnvironmentConverter.php            |  2 +-
 src/Pattern/FileConverter.php                   |  2 +-
 src/Pattern/LevelConverter.php                  |  2 +-
 src/Pattern/LineConverter.php                   |  2 +-
 src/Pattern/LiteralConverter.php                |  2 +-
 src/Pattern/LocationConverter.php               |  2 +-
 src/Pattern/LoggerConverter.php                 |  2 +-
 src/Pattern/MdcConverter.php                    |  2 +-
 src/Pattern/MessageConverter.php                |  2 +-
 src/Pattern/MethodConverter.php                 |  2 +-
 src/Pattern/NdcConverter.php                    |  2 +-
 src/Pattern/NewLineConverter.php                |  2 +-
 src/Pattern/ProcessConverter.php                |  2 +-
 src/Pattern/RelativeConverter.php               |  2 +-
 src/Pattern/RequestConverter.php                |  2 +-
 src/Pattern/ServerConverter.php                 |  2 +-
 src/Pattern/SessionConverter.php                |  2 +-
 src/Pattern/SessionIdConverter.php              |  2 +-
 src/Pattern/SuperglobalConverter.php            |  2 +-
 src/Pattern/ThrowableConverter.php              |  2 +-
 src/ReflectionUtils.php                         |  4 +-
 src/Renderers/DefaultRenderer.php               |  2 +-
 src/Renderers/ExceptionRenderer.php             |  2 +-
 src/Renderers/RendererInterface.php             |  2 +-
 src/Renderers/RendererMap.php                   |  6 +-
 src/RootLogger.php                              |  2 +-
 src/ThrowableInformation.php                    |  2 +-
 tests/bootstrap.php                             |  2 +-
 .../configs/adapters/php/config_empty.php       |  2 +-
 .../adapters/php/config_invalid_syntax.php      |  2 +-
 .../adapters/php/config_not_an_array.php        |  2 +-
 .../configs/adapters/php/config_valid.php       |  2 +-
 tests/src/AppenderPoolTest.php                  |  2 +-
 tests/src/AppenderTest.php                      |  2 +-
 tests/src/Appenders/ConsoleAppenderTest.php     |  2 +-
 tests/src/Appenders/DailyFileAppenderTest.php   |  2 +-
 tests/src/Appenders/EchoAppenderTest.php        |  2 +-
 tests/src/Appenders/FileAppenderTest.php        |  2 +-
 tests/src/Appenders/MailAppenderTest.php        |  2 +-
 tests/src/Appenders/MailEventAppenderTest.php   |  2 +-
 tests/src/Appenders/MongoDBAppenderTest.php     |  2 +-
 tests/src/Appenders/NullAppenderTest.php        |  2 +-
 tests/src/Appenders/PDOAppenderTest.php         |  2 +-
 tests/src/Appenders/PhpAppenderTest.php         |  2 +-
 tests/src/Appenders/RollingFileAppenderTest.php |  2 +-
 tests/src/Appenders/SocketAppenderTest.php      |  2 +-
 tests/src/Appenders/SyslogAppenderTest.php      |  2 +-
 tests/src/Appenders/socketServer.php            |  2 +-
 tests/src/ConfiguratorTest.php                  |  2 +-
 tests/src/Configurators/INIAdapterTest.php      |  2 +-
 tests/src/Configurators/PHPAdapterTest.php      |  2 +-
 tests/src/Configurators/XMLAdapterTest.php      |  2 +-
 tests/src/ExceptionTest.php                     |  4 +-
 tests/src/FilterTest.php                        |  2 +-
 tests/src/Filters/FilterDenyAllTest.php         |  2 +-
 tests/src/Filters/FilterLevelMatchTest.php      |  2 +-
 tests/src/Filters/FilterLevelRangeTest.php      |  2 +-
 tests/src/Filters/FilterStringMatchTest.php     |  2 +-
 tests/src/Helpers/OptionConverterTest.php       |  2 +-
 tests/src/Helpers/PatternParserTest.php         |  2 +-
 tests/src/Helpers/UtilsTest.php                 |  2 +-
 tests/src/HierarchyTest.php                     |  2 +-
 tests/src/Layouts/HtmlLayoutTest.php            |  2 +-
 tests/src/Layouts/PatternLayoutTest.php         |  2 +-
 tests/src/Layouts/SerializedLayoutTest.php      |  2 +-
 tests/src/Layouts/SimpleLayoutTest.php          |  2 +-
 tests/src/Layouts/XmlLayoutTest.php             |  2 +-
 tests/src/LevelTest.php                         |  2 +-
 tests/src/LoggerTest.php                        |  2 +-
 tests/src/LoggingEventTest.php                  |  2 +-
 tests/src/MDCTest.php                           |  2 +-
 tests/src/NDCTest.php                           |  2 +-
 tests/src/Pattern/PatternConverterTest.php      |  2 +-
 tests/src/ReflectionUtilsTest.php               |  2 +-
 tests/src/Renderers/RendererMapTest.php         |  2 +-
 tests/src/RootLoggerTest.php                    |  2 +-
 tests/src/TestHelper.php                        |  2 +-
 tests/src/ThrowableInformationTest.php          |  4 +-
 128 files changed, 365 insertions(+), 377 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/AppenderPool.php
----------------------------------------------------------------------
diff --git a/src/AppenderPool.php b/src/AppenderPool.php
index 98034bb..28d0752 100644
--- a/src/AppenderPool.php
+++ b/src/AppenderPool.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * *     http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -39,7 +39,7 @@ class AppenderPool
     /**
      * Adds an appender to the pool.
      * The appender must be named for this operation.
-     * @param Appender $appender
+     * @param AbstractAppender $appender
      */
     public static function add(AbstractAppender $appender)
     {
@@ -64,7 +64,7 @@ class AppenderPool
     /**
      * Retrieves an appender from the pool by name.
      * @param  string   $name Name of the appender to retrieve.
-     * @return Appender The named appender or NULL if no such appender
+     * @return AbstractAppender The named appender or NULL if no such appender
      *  exists in the pool.
      */
     public static function get($name)

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Appenders/AbstractAppender.php
----------------------------------------------------------------------
diff --git a/src/Appenders/AbstractAppender.php b/src/Appenders/AbstractAppender.php
index 8a76d64..e2128b8 100644
--- a/src/Appenders/AbstractAppender.php
+++ b/src/Appenders/AbstractAppender.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *		http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -126,7 +126,7 @@ abstract class AbstractAppender extends Configurable
 
     /**
      * Returns the first filter in the filter chain.
-     * The return value may be <i>null</i> if no is filter is set.
+     * The return value may be *null* if no is filter is set.
      * @return AbstractFilter
      */
     public function getFilter()
@@ -136,7 +136,7 @@ abstract class AbstractAppender extends Configurable
 
     /**
      * Returns the first filter in the filter chain.
-     * The return value may be <i>null</i> if no is filter is set.
+     * The return value may be *null* if no is filter is set.
      * @return AbstractFilter
      */
     public function getFirstFilter()
@@ -146,7 +146,7 @@ abstract class AbstractAppender extends Configurable
 
     /**
      * Performs threshold checks and invokes filters before delegating logging
-     * to the subclass' specific <i>append()</i> method.
+     * to the subclass' specific *append*i> method.
      * @see Appender::append()
      * @param LoggingEvent $event
      */
@@ -198,16 +198,16 @@ abstract class AbstractAppender extends Configurable
      * Configurators call this method to determine if the appender
      * requires a layout.
      *
-     * <p>If this method returns <i>true</i>, meaning that layout is required,
+     * If this method returns *true*, meaning that layout is required,
      * then the configurator will configure a layout using the configuration
-     * information at its disposal.	 If this method returns <i>false</i>,
+     * information at its disposal. If this method returns *false*,
      * meaning that a layout is not required, then layout configuration will be
      * skipped even if there is available layout configuration
-     * information at the disposal of the configurator.</p>
+     * information at the disposal of the configurator.
      *
-     * <p>In the rather exceptional case, where the appender
+     * In the rather exceptional case, where the appender
      * implementation admits a layout but can also work without it, then
-     * the appender should return <i>true</i>.</p>
+     * the appender should return *true*.
      *
      * @return boolean
      */
@@ -258,7 +258,7 @@ abstract class AbstractAppender extends Configurable
     /**
      * Checks whether the message level is below the appender's threshold.
      *
-     * If there is no threshold set, then the return value is always <i>true</i>.
+     * If there is no threshold set, then the return value is always *true*.
      *
      * @param  Level   $level
      * @return boolean Returns true if level is greater or equal than

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Appenders/ConsoleAppender.php
----------------------------------------------------------------------
diff --git a/src/Appenders/ConsoleAppender.php b/src/Appenders/ConsoleAppender.php
index 13e89af..427e495 100644
--- a/src/Appenders/ConsoleAppender.php
+++ b/src/Appenders/ConsoleAppender.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Appenders/DailyFileAppender.php
----------------------------------------------------------------------
diff --git a/src/Appenders/DailyFileAppender.php b/src/Appenders/DailyFileAppender.php
index 81541b0..d300b24 100644
--- a/src/Appenders/DailyFileAppender.php
+++ b/src/Appenders/DailyFileAppender.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Appenders/EchoAppender.php
----------------------------------------------------------------------
diff --git a/src/Appenders/EchoAppender.php b/src/Appenders/EchoAppender.php
index 58d21b4..ce9adcb 100644
--- a/src/Appenders/EchoAppender.php
+++ b/src/Appenders/EchoAppender.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Appenders/FileAppender.php
----------------------------------------------------------------------
diff --git a/src/Appenders/FileAppender.php b/src/Appenders/FileAppender.php
index 4d67f2d..f84f96a 100644
--- a/src/Appenders/FileAppender.php
+++ b/src/Appenders/FileAppender.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Appenders/MailAppender.php
----------------------------------------------------------------------
diff --git a/src/Appenders/MailAppender.php b/src/Appenders/MailAppender.php
index 916ba45..4262ca3 100644
--- a/src/Appenders/MailAppender.php
+++ b/src/Appenders/MailAppender.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Appenders/MailEventAppender.php
----------------------------------------------------------------------
diff --git a/src/Appenders/MailEventAppender.php b/src/Appenders/MailEventAppender.php
index 291642c..1265bbe 100644
--- a/src/Appenders/MailEventAppender.php
+++ b/src/Appenders/MailEventAppender.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Appenders/MongoDBAppender.php
----------------------------------------------------------------------
diff --git a/src/Appenders/MongoDBAppender.php b/src/Appenders/MongoDBAppender.php
index 6123f83..b6d1230 100644
--- a/src/Appenders/MongoDBAppender.php
+++ b/src/Appenders/MongoDBAppender.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
  *
- *     http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -132,7 +132,7 @@ class MongoDBAppender extends AbstractAppender
                 sprintf('%s:%d', $this->host, $this->port),
                 array('timeout' => $this->timeout)
             );
-            $db	= $this->connection->selectDB($this->databaseName);
+            $db = $this->connection->selectDB($this->databaseName);
             if ($this->userName !== null && $this->password !== null) {
                 $authResult = $db->authenticate($this->userName, $this->password);
                 if ($authResult['ok'] == floatval(0)) {
@@ -212,7 +212,7 @@ class MongoDBAppender extends AbstractAppender
      * @param  Exception $ex
      * @return array
      */
-    protected function formatThrowable(Exception $ex)
+    protected function formatThrowable(\Exception $ex)
     {
         $array = array(
             'message' => $ex->getMessage(),

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Appenders/NullAppender.php
----------------------------------------------------------------------
diff --git a/src/Appenders/NullAppender.php b/src/Appenders/NullAppender.php
index dd41040..5918d23 100644
--- a/src/Appenders/NullAppender.php
+++ b/src/Appenders/NullAppender.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Appenders/PdoAppender.php
----------------------------------------------------------------------
diff --git a/src/Appenders/PdoAppender.php b/src/Appenders/PdoAppender.php
index 81ef3ad..f536184 100644
--- a/src/Appenders/PdoAppender.php
+++ b/src/Appenders/PdoAppender.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
  *
- *     http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Appenders/PhpAppender.php
----------------------------------------------------------------------
diff --git a/src/Appenders/PhpAppender.php b/src/Appenders/PhpAppender.php
index 6d6c6c9..2f1bb69 100644
--- a/src/Appenders/PhpAppender.php
+++ b/src/Appenders/PhpAppender.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -29,9 +29,9 @@ use Apache\Log4php\LoggingEvent;
  *
  * Levels are mapped as follows:
  *
- * - <b>level < WARN</b> mapped to E_USER_NOTICE
- * - <b>WARN <= level < ERROR</b> mapped to E_USER_WARNING
- * - <b>level >= ERROR</b> mapped to E_USER_ERROR
+ * - **level < WARN** mapped to E_USER_NOTICE
+ * - **WARN <= level < ERROR** mapped to E_USER_WARNING
+ * - **level >= ERROR** mapped to E_USER_ERROR
  * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0
  * @link http://logging.apache.org/log4php/docs/appenders/php.html Appender documentation
  */

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Appenders/RollingFileAppender.php
----------------------------------------------------------------------
diff --git a/src/Appenders/RollingFileAppender.php b/src/Appenders/RollingFileAppender.php
index a85c6aa..f6ee08c 100644
--- a/src/Appenders/RollingFileAppender.php
+++ b/src/Appenders/RollingFileAppender.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Appenders/SocketAppender.php
----------------------------------------------------------------------
diff --git a/src/Appenders/SocketAppender.php b/src/Appenders/SocketAppender.php
index 4f8325b..2e8392a 100644
--- a/src/Appenders/SocketAppender.php
+++ b/src/Appenders/SocketAppender.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Appenders/SyslogAppender.php
----------------------------------------------------------------------
diff --git a/src/Appenders/SyslogAppender.php b/src/Appenders/SyslogAppender.php
index 8bb8904..82dabff 100644
--- a/src/Appenders/SyslogAppender.php
+++ b/src/Appenders/SyslogAppender.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -26,7 +26,7 @@ use Apache\Log4php\LoggingEvent;
  *
  * This appenders requires a layout.
  *
- * ## Configurable parameters: ##
+ * **Configurable parameters:**
  *
  * - **ident** - The ident of the syslog message.
  * - **priority** - The priority for the syslog message (used when overriding
@@ -39,17 +39,16 @@ use Apache\Log4php\LoggingEvent;
  *
  * Recognised syslog options are:
  *
- * - CONS 	 - if there is an error while sending data to the system logger, write directly to the system console
+ * - CONS - if there is an error while sending data to the system logger, write directly to the system console
  * - NDELAY - open the connection to the logger immediately
  * - ODELAY - delay opening the connection until the first message is logged (default)
  * - PERROR - print log message also to standard error
- * - PID    - include PID with each message
+ * - PID - include PID with each message
  *
  * Multiple options can be set by delimiting them with a pipe character,
  * e.g.: "CONS|PID|PERROR".
  *
  * Recognised syslog priorities are:
- *
  * - EMERG
  * - ALERT
  * - CRIT
@@ -61,12 +60,13 @@ use Apache\Log4php\LoggingEvent;
  *
  * Levels are mapped as follows:
  *
- * - <b>FATAL</b> to LOG_ALERT
- * - <b>ERROR</b> to LOG_ERR
- * - <b>WARN</b> to LOG_WARNING
- * - <b>INFO</b> to LOG_INFO
- * - <b>DEBUG</b> to LOG_DEBUG
- * - <b>TRACE</b> to LOG_DEBUG
+ * - **FATAL** to LOG_ALERT
+ * - **ERROR** to LOG_ERR
+ * - **WARN** to LOG_WARNING
+ * - **INFO** to LOG_INFO
+ * - **DEBUG** to LOG_DEBUG
+ * - **TRACE** to LOG_DEBUG
+ *
  * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0
  * @link http://logging.apache.org/log4php/docs/appenders/syslog.html Appender documentation
  */

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Autoloader.php
----------------------------------------------------------------------
diff --git a/src/Autoloader.php b/src/Autoloader.php
index b193c71..4cbd46c 100644
--- a/src/Autoloader.php
+++ b/src/Autoloader.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *		http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Configurable.php
----------------------------------------------------------------------
diff --git a/src/Configurable.php b/src/Configurable.php
index 246b105..fe4be86 100644
--- a/src/Configurable.php
+++ b/src/Configurable.php
@@ -7,7 +7,7 @@
 * (the "License"); you may not use this file except in compliance with
 * the License. You may obtain a copy of the License at
 *
-*	   http://www.apache.org/licenses/LICENSE-2.0
+* http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Configuration/ConfiguratorInterface.php
----------------------------------------------------------------------
diff --git a/src/Configuration/ConfiguratorInterface.php b/src/Configuration/ConfiguratorInterface.php
index f58fc41..5d9fda6 100644
--- a/src/Configuration/ConfiguratorInterface.php
+++ b/src/Configuration/ConfiguratorInterface.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -32,10 +32,10 @@ interface ConfiguratorInterface
      *
      * All configurators implementations must implement this interface.
      *
-     * @param Hierarchy $hierarchy The hierarchy on which to perform
-     * 		the configuration.
-     * @param mixed $input Either path to the config file or the
-     * 		configuration as an array.
+     * @param Hierarchy $hierarchy The hierarchy on which to perform the
+     *     configuration.
+     * @param mixed $input Either path to the config file or the configuration
+     *     as an array.
      */
     public function configure(Hierarchy $hierarchy, $input = null);
 }

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Configuration/DefaultConfigurator.php
----------------------------------------------------------------------
diff --git a/src/Configuration/DefaultConfigurator.php b/src/Configuration/DefaultConfigurator.php
index 7dd8dde..8fa9d84 100644
--- a/src/Configuration/DefaultConfigurator.php
+++ b/src/Configuration/DefaultConfigurator.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -70,20 +70,19 @@ class DefaultConfigurator implements ConfiguratorInterface
     private $appenders = array();
 
     /**
-     * Configures log4php based on the given configuration. The input can
-     * either be a path to the config file, or a PHP array holding the
-     * configuration.
+     * Configures log4php based on the given configuration. The input can either
+     * be a path to the config file, or a PHP array holding the configuration.
      *
      * If no configuration is given, or if the given configuration cannot be
-     * parsed for whatever reason, a warning will be issued, and log4php
-     * will use the default configuration contained in
-     * {@link $defaultConfiguration}.
+     * parsed for whatever reason, a warning will be issued, and log4php will
+     * use the default configuration contained in {@link $defaultConfiguration}.
+     *
+     * @param Hierarchy $hierarchy The hierarchy on which to perform the
+     * configuration.
      *
-     * @param Hierarchy $hierarchy The hierarchy on which to perform
-     * 		the configuration.
      * @param string|array $input Either path to the config file or the
-     * 		configuration as an array. If not set, default configuration
-     * 		will be used.
+     * configuration as an array. If not set, default configuration will be
+     * used.
      */
     public function configure(Hierarchy $hierarchy, $input = null)
     {
@@ -92,16 +91,17 @@ class DefaultConfigurator implements ConfiguratorInterface
     }
 
     /**
-     * Parses the given configuration and returns the parsed configuration
-     * as a PHP array. Does not perform any configuration.
+     * Parses the given configuration and returns the parsed configuration as a
+     * PHP array. Does not perform any configuration.
      *
      * If no configuration is given, or if the given configuration cannot be
      * parsed for whatever reason, a warning will be issued, and the default
      * configuration will be returned ({@link $defaultConfiguration}).
      *
      * @param string|array $input Either path to the config file or the
-     * 		configuration as an array. If not set, default configuration
-     * 		will be used.
+     * configuration as an array. If not set, default configuration will be
+     * used.
+     *
      * @return array The parsed configuration.
      */
     public function parse($input)
@@ -143,10 +143,10 @@ class DefaultConfigurator implements ConfiguratorInterface
      * adapter to use, converts the configuration to a PHP array and
      * returns it.
      *
-     * @param  string          $url Path to the config file.
-     * @return The             configuration from the config file, as a PHP array.
+     * @param  string $url Path to the config file.
+     * @return The configuration from the config file, as a PHP array.
      * @throws LoggerException If the configuration file cannot be loaded, or
-     * 		if the parsing fails.
+     * if the parsing fails.
      */
     private function parseFile($url)
     {
@@ -519,8 +519,8 @@ class DefaultConfigurator implements ConfiguratorInterface
      * For example, if options are:
      * <code>
      * array(
-     * 	'file' => '/tmp/myfile.log',
-     * 	'append' => true
+     *   'file' => '/tmp/myfile.log',
+     *   'append' => true
      * )
      * </code>
      *
@@ -532,8 +532,8 @@ class DefaultConfigurator implements ConfiguratorInterface
      *
      * If required setters do not exist, it will produce a warning.
      *
-     * @param mixed        $object  The object to configure.
-     * @param unknown_type $options
+     * @param mixed $object  The object to configure.
+     * @param array $options
      */
     private function setOptions($object, $options)
     {

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Configuration/adapters/AdapterInterface.php
----------------------------------------------------------------------
diff --git a/src/Configuration/adapters/AdapterInterface.php b/src/Configuration/adapters/AdapterInterface.php
index 871bb9d..f4b0a0d 100644
--- a/src/Configuration/adapters/AdapterInterface.php
+++ b/src/Configuration/adapters/AdapterInterface.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *     http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Configuration/adapters/IniAdapter.php
----------------------------------------------------------------------
diff --git a/src/Configuration/adapters/IniAdapter.php b/src/Configuration/adapters/IniAdapter.php
index 6110a10..7ff8a4c 100644
--- a/src/Configuration/adapters/IniAdapter.php
+++ b/src/Configuration/adapters/IniAdapter.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *     http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -176,12 +176,12 @@ class IniAdapter implements AdapterInterface
      * log4php.appender.<name>.<param> = <value>
      * </pre>
      *
-      * Appender threshold:
+     * Appender threshold:
      * <pre>
      * log4php.appender.<name>.threshold = <level>
      * </pre>
      *
-      * Appender layout:
+     * Appender layout:
      * <pre>
      * log4php.appender.<name>.layout = <layoutClass>
      * </pre>
@@ -204,17 +204,17 @@ class IniAdapter implements AdapterInterface
      * found under $this->config['appenders']['myAppender']:
      * <pre>
      * array(
-     * 	'class' => ConsoleAppender,
-     * 	'threshold' => info,
-     * 	'params' => array(
-     * 		'target' => 'stdout'
-     * 	),
-     * 	'layout' => array(
-     * 		'class' => 'ConsoleAppender',
-     * 		'params' => array(
-     * 			'conversionPattern' => '%d %c: %m%n'
-     * 		)
-     * 	)
+     *     'class' => ConsoleAppender,
+     *     'threshold' => info,
+     *     'params' => array(
+     *         'target' => 'stdout'
+     *     ),
+     *     'layout' => array(
+     *         'class' => 'ConsoleAppender',
+     *         'params' => array(
+     *             'conversionPattern' => '%d %c: %m%n'
+     *         )
+     *     )
      * )
      * </pre>
      *

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Configuration/adapters/PhpAdapter.php
----------------------------------------------------------------------
diff --git a/src/Configuration/adapters/PhpAdapter.php b/src/Configuration/adapters/PhpAdapter.php
index 6e22c1d..abbea0c 100644
--- a/src/Configuration/adapters/PhpAdapter.php
+++ b/src/Configuration/adapters/PhpAdapter.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -37,8 +37,8 @@ use Apache\Log4php\LoggerException;
  *     'default' => array(
  *       'class' => 'EchoAppender',
  *       'layout' => array(
- *       	'class' => 'SimpleLayout'
- *        )
+ *         'class' => 'SimpleLayout'
+ *       )
  *     )
  *   )
  * )

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Configuration/adapters/XmlAdapter.php
----------------------------------------------------------------------
diff --git a/src/Configuration/adapters/XmlAdapter.php b/src/Configuration/adapters/XmlAdapter.php
index 829b6d9..61f2dc3 100644
--- a/src/Configuration/adapters/XmlAdapter.php
+++ b/src/Configuration/adapters/XmlAdapter.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *     http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Filters/AbstractFilter.php
----------------------------------------------------------------------
diff --git a/src/Filters/AbstractFilter.php b/src/Filters/AbstractFilter.php
index 7f15e34..ffe557e 100644
--- a/src/Filters/AbstractFilter.php
+++ b/src/Filters/AbstractFilter.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -29,28 +29,28 @@ use Apache\Log4php\LoggingEvent;
  * first use and understand the built-in rules before rushing to write
  * your own custom filters.
  *
- * <p>This abstract class assumes and also imposes that filters be
+ * This abstract class assumes and also imposes that filters be
  * organized in a linear chain. The {@link #decide
  * decide(LoggingEvent)} method of each filter is called sequentially,
  * in the order of their addition to the chain.
  *
- * <p>The {@link decide()} method must return one
+ * The {@link decide()} method must return one
  * of the integer constants {@link AbstractFilter::DENY},
  * {@link AbstractFilter::NEUTRAL} or {@link AbstractFilter::ACCEPT}.
  *
- * <p>If the value {@link AbstractFilter::DENY} is returned, then the log event is
+ * If the value {@link AbstractFilter::DENY} is returned, then the log event is
  * dropped immediately without consulting with the remaining
  * filters.
  *
- * <p>If the value {@link AbstractFilter::NEUTRAL} is returned, then the next filter
+ * If the value {@link AbstractFilter::NEUTRAL} is returned, then the next filter
  * in the chain is consulted. If there are no more filters in the
  * chain, then the log event is logged. Thus, in the presence of no
  * filters, the default behaviour is to log all logging events.
  *
- * <p>If the value {@link AbstractFilter::ACCEPT} is returned, then the log
+ * If the value {@link AbstractFilter::ACCEPT} is returned, then the log
  * event is logged without consulting the remaining filters.
  *
- * <p>The philosophy of log4php filters is largely inspired from the
+ * The philosophy of log4php filters is largely inspired from the
  * Linux ipchains.
  *
  * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0
@@ -76,7 +76,8 @@ abstract class AbstractFilter extends Configurable
     const DENY = -1;
 
     /**
-     * @var AbstractFilter Points to the next {@link AbstractFilter} in the filter chain.
+     * Points to the next filter in the filter chain.
+     * @var AbstractFilter
      */
     protected $next;
 
@@ -90,14 +91,19 @@ abstract class AbstractFilter extends Configurable
 
     /**
      * Decide what to do.
-     * <p>If the decision is {@link AbstractFilter::DENY}, then the event will be
-     * dropped. If the decision is {@link AbstractFilter::NEUTRAL}, then the next
-     * filter, if any, will be invoked. If the decision is {@link AbstractFilter::ACCEPT} then
-     * the event will be logged without consulting with other filters in
-     * the chain.
      *
-     * @param  LoggingEvent $event The {@link LoggingEvent} to decide upon.
-     * @return integer {@link AbstractFilter::NEUTRAL} or {@link AbstractFilter::DENY} or {@link AbstractFilter::ACCEPT}
+     * Returns one of:
+     * - {@link AbstractFilter::DENY}
+     * - {@link AbstractFilter::NEUTRAL}
+     * - {@link AbstractFilter::ACCEPT}
+     *
+     * If the decision is <var>DENY</var>, then the event will be dropped. If
+     * the decision is <var>NEUTRAL</var>, then the next filter, if any, will be
+     * invoked. If the decision is <var>ACCEPT</var> then the event will be
+     * logged without consulting with other filters in the chain.
+     *
+     * @param LoggingEvent $event The logging event to decide upon.
+     * @return integer
      */
     public function decide(LoggingEvent $event)
     {
@@ -109,7 +115,7 @@ abstract class AbstractFilter extends Configurable
      * If this filter has already and follow up filter, the param filter
      * is passed on until it is the last filter in chain.
      *
-     * @param $filter - the filter to add to this chain
+     * @param AbstractFilter $filter The filter to add to the chain.
      */
     public function addNext($filter)
     {
@@ -121,8 +127,9 @@ abstract class AbstractFilter extends Configurable
     }
 
     /**
-     * Returns the next filter in this chain
-     * @return the next filter
+     * Returns the next filter in the chain.
+     *
+     * @return AbstractFilter The next filter in the chain.
      */
     public function getNext()
     {

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Filters/DenyAllFilter.php
----------------------------------------------------------------------
diff --git a/src/Filters/DenyAllFilter.php b/src/Filters/DenyAllFilter.php
index 4822988..c42d778 100644
--- a/src/Filters/DenyAllFilter.php
+++ b/src/Filters/DenyAllFilter.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Filters/LevelMatchFilter.php
----------------------------------------------------------------------
diff --git a/src/Filters/LevelMatchFilter.php b/src/Filters/LevelMatchFilter.php
index 69aa6e5..fab2b32 100644
--- a/src/Filters/LevelMatchFilter.php
+++ b/src/Filters/LevelMatchFilter.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -23,24 +23,13 @@ use Apache\Log4php\LoggingEvent;
 /**
  * This is a very simple filter based on level matching.
  *
- * <p>The filter admits two options <b><var>LevelToMatch</var></b> and
- * <b><var>AcceptOnMatch</var></b>. If there is an exact match between the value
- * of the <b><var>LevelToMatch</var></b> option and the level of the
- * {@link LoggingEvent}, then the {@link decide()} method returns
- * {@link AbstractFilter::ACCEPT} in case the <b><var>AcceptOnMatch</var></b>
- * option value is set to <i>true</i>, if it is <i>false</i> then
- * {@link AbstractFilter::DENY} is returned. If there is no match,
- * {@link AbstractFilter::NEUTRAL} is returned.</p>
- *
- * <p>
- * An example for this filter:
- *
- * {@example ../../examples/php/filter_levelmatch.php 19}
- *
- * <p>
- * The corresponding XML file:
- *
- * {@example ../../examples/resources/filter_levelmatch.xml 18}
+ * The filter admits two options <var>LevelToMatch</var> and
+ * <var>AcceptOnMatch</var>. If there is an exact match between the value of the
+ * <var>LevelToMatch</var> option and the level of the {@link LoggingEvent},
+ * then the {@link decide()} method returns {@link AbstractFilter::ACCEPT} in
+ * case the <var>AcceptOnMatch</var> option value is set to *true*, if it is
+ * *false* then {@link AbstractFilter::DENY} is returned. If there is no match,
+ * {@link AbstractFilter::NEUTRAL} is returned.
  *
  * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0
  * @since 0.6
@@ -78,14 +67,14 @@ class LevelMatchFilter extends AbstractFilter
     /**
      * Return the decision of this filter.
      *
-     * Returns {@link AbstractFilter::NEUTRAL} if the <b><var>LevelToMatch</var></b>
-     * option is not set or if there is not match.	Otherwise, if there is a
-     * match, then the returned decision is {@link AbstractFilter::ACCEPT} if the
-     * <b><var>AcceptOnMatch</var></b> property is set to <i>true</i>. The
-     * returned decision is {@link AbstractFilter::DENY} if the
-     * <b><var>AcceptOnMatch</var></b> property is set to <i>false</i>.
+     * Returns {@link AbstractFilter::NEUTRAL} if the <var>LevelToMatch</var>
+     * option is not set or if there is not match. Otherwise, if there is a
+     * match, then the returned decision is {@link AbstractFilter::ACCEPT} if
+     * the <var>AcceptOnMatch</var> property is set to *true*. The returned
+     * decision is {@link AbstractFilter::DENY} if the <var>AcceptOnMatch</var>
+     * property is set to *false*.
      *
-     * @param  LoggingEvent $event
+     * @param LoggingEvent $event
      * @return integer
      */
     public function decide(LoggingEvent $event)

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Filters/LevelRangeFilter.php
----------------------------------------------------------------------
diff --git a/src/Filters/LevelRangeFilter.php b/src/Filters/LevelRangeFilter.php
index c457db5..5ac519a 100644
--- a/src/Filters/LevelRangeFilter.php
+++ b/src/Filters/LevelRangeFilter.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -21,40 +21,28 @@ namespace Apache\Log4php\Filters;
 use Apache\Log4php\LoggingEvent;
 
 /**
- * This is a very simple filter based on level matching, which can be
- * used to reject messages with priorities outside a certain range.
+ * This is a very simple filter based on level matching, which can be used to
+ * reject messages with priorities outside a certain range.
  *
- * <p>The filter admits three options <b><var>LevelMin</var></b>, <b><var>LevelMax</var></b>
- * and <b><var>AcceptOnMatch</var></b>.</p>
+ * The filter admits three options <var>levelMin</var>, <var>levelMax</var> and
+ * <var>acceptOnMatch</var>.
  *
- * <p>If the level of the {@link LoggingEvent} is not between Min and Max
- * (inclusive), then {@link AbstractFilter::DENY} is returned.</p>
+ * If the level of the {@link LoggingEvent} is not between Min and Max
+ * (inclusive), then {@link AbstractFilter::DENY} is returned.
  *
- * <p>If the Logging event level is within the specified range, then if
- * <b><var>AcceptOnMatch</var></b> is <i>true</i>,
- * {@link AbstractFilter::ACCEPT} is returned, and if
- * <b><var>AcceptOnMatch</var></b> is <i>false</i>,
- * {@link AbstractFilter::NEUTRAL} is returned.</p>
+ * If the Logging event level is within the specified range, then if
+ * <var>acceptOnMatch</var> is *true*, {@link AbstractFilter::ACCEPT} is
+ * returned, and if <var>acceptOnMatch</var> is *false*, {@link
+ * AbstractFilter::NEUTRAL} is returned.
  *
- * <p>If <b><var>LevelMin</var></b> is not defined, then there is no
- * minimum acceptable level (i.e. a level is never rejected for
- * being too "low"/unimportant).  If <b><var>LevelMax</var></b> is not
- * defined, then there is no maximum acceptable level (ie a
- * level is never rejected for being too "high"/important).</p>
+ * If <var>levelMin</var> is not defined, then there is no minimum acceptable
+ * level (i.e. a level is never rejected for being too "low"/unimportant). If
+ * <var>levelMax</var> is not defined, then there is no maximum acceptable level
+ * (ie a level is never rejected for being too "high"/important).
  *
- * <p>Refer to the {@link Appender::setThreshold()} method
- * available to <b>all</b> appenders extending {@link Appender}
- * for a more convenient way to filter out events by level.</p>
- *
- * <p>
- * An example for this filter:
- *
- * {@example ../../examples/php/filter_levelrange.php 19}
- *
- * <p>
- * The corresponding XML file:
- *
- * {@example ../../examples/resources/filter_levelrange.xml 18}
+ * Refer to the {@link Appender::setThreshold()} method available to **all**
+ * appenders extending {@link Appender} for a more convenient way to filter out
+ * events by level.
  *
  * @author Simon Kitching
  * @author based on the org.apache.log4j.varia.LevelRangeFilte Java code by Ceki G&uuml;lc&uuml;

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Filters/StringMatchFilter.php
----------------------------------------------------------------------
diff --git a/src/Filters/StringMatchFilter.php b/src/Filters/StringMatchFilter.php
index f77976a..f5f2a47 100644
--- a/src/Filters/StringMatchFilter.php
+++ b/src/Filters/StringMatchFilter.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -23,21 +23,21 @@ use Apache\Log4php\LoggingEvent;
 /**
  * This is a very simple filter based on string matching.
  *
- * <p>The filter admits two options {@link $stringToMatch} and
+ * The filter admits two options {@link $stringToMatch} and
  * {@link $acceptOnMatch}. If there is a match (using {@link PHP_MANUAL#strpos}
  * between the value of the {@link $stringToMatch} option and the message
  * of the {@link LoggingEvent},
  * then the {@link decide()} method returns {@link AbstractFilter::ACCEPT} if
- * the <b>AcceptOnMatch</b> option value is true, if it is false then
+ * the **AcceptOnMatch** option value is true, if it is false then
  * {@link AbstractFilter::DENY} is returned. If there is no match, {@link AbstractFilter::NEUTRAL}
- * is returned.</p>
+ * is returned.
+ *
  *
- * <p>
  * An example for this filter:
  *
  * {@example ../../examples/php/filter_stringmatch.php 19}
  *
- * <p>
+ *
  * The corresponding XML file:
  *
  * {@example ../../examples/resources/filter_stringmatch.xml 18}

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Helpers/FormattingInfo.php
----------------------------------------------------------------------
diff --git a/src/Helpers/FormattingInfo.php b/src/Helpers/FormattingInfo.php
index 923d0b6..b838b83 100644
--- a/src/Helpers/FormattingInfo.php
+++ b/src/Helpers/FormattingInfo.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Helpers/OptionConverter.php
----------------------------------------------------------------------
diff --git a/src/Helpers/OptionConverter.php b/src/Helpers/OptionConverter.php
index 2888cb9..a12d8d6 100644
--- a/src/Helpers/OptionConverter.php
+++ b/src/Helpers/OptionConverter.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -52,7 +52,7 @@ class OptionConverter
      * @param  string $key The key to search for.
      * @param  string $def The default value to return.
      * @return string the string value of the system property, or the default
-     *					value if there is no property with that key.
+     *     value if there is no property with that key.
      */
     public static function getSystemProperty($key, $def)
     {

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Helpers/PatternParser.php
----------------------------------------------------------------------
diff --git a/src/Helpers/PatternParser.php b/src/Helpers/PatternParser.php
index 067acd6..a3f17ca 100644
--- a/src/Helpers/PatternParser.php
+++ b/src/Helpers/PatternParser.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -26,8 +26,8 @@ use Apache\Log4php\Pattern\LiteralConverter;
  * Most of the work of the {@link LoggerPatternLayout} class
  * is delegated to the {@link PatternParser} class.
  *
- * <p>It is this class that parses conversion patterns and creates
- * a chained list of {@link AbstractConverter} converters.</p>
+ * It is this class that parses conversion patterns and creates
+ * a chained list of {@link AbstractConverter} converters.
  *
  * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0
  * @since 0.3

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Helpers/Utils.php
----------------------------------------------------------------------
diff --git a/src/Helpers/Utils.php b/src/Helpers/Utils.php
index e55c7ab..9c84da6 100644
--- a/src/Helpers/Utils.php
+++ b/src/Helpers/Utils.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Hierarchy.php
----------------------------------------------------------------------
diff --git a/src/Hierarchy.php b/src/Hierarchy.php
index 0d85889..21c3a47 100644
--- a/src/Hierarchy.php
+++ b/src/Hierarchy.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -33,18 +33,18 @@ use Apache\Log4php\Renderers\RendererMap;
  * 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>
+ * The casual user does not have to deal with this class directly.
  *
- * <p>The structure of the logger hierarchy is maintained by the
+ * The structure of the logger hierarchy is maintained by the
  * getLogger method. The hierarchy is such that children link
  * to their parent but parents do not have any pointers to their
  * children. Moreover, loggers can be instantiated in any order, in
- * particular descendant before ancestor.</p>
+ * particular descendant before ancestor.
  *
- * <p>In case a descendant is created before a particular ancestor,
+ * In case a descendant is created before a particular ancestor,
  * then it creates a provision node for the ancestor and adds itself
  * to the provision node. Other descendants of the same ancestor add
- * themselves to the previously created provision node.</p>
+ * themselves to the previously created provision node.
  *
  * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0
  * @link http://logging.apache.org/log4php
@@ -193,14 +193,14 @@ class Hierarchy
      * default.
      *
      * This removes all appenders from all loggers, sets
-     * the level of all non-root loggers to <i>null</i>,
-     * sets their additivity flag to <i>true</i> and sets the level
+     * the level of all non-root loggers to *null*,
+     * sets their additivity flag to *true* and sets the level
      * of the root logger to {@link LOGGER_LEVEL_DEBUG}.
      *
-     * <p>Existing loggers are not removed. They are just reset.
+     * Existing loggers are not removed. They are just reset.
      *
-     * <p>This method should be used sparingly and with care as it will
-     * block all logging until it is completed.</p>
+     * This method should be used sparingly and with care as it will
+     * block all logging until it is completed.
      */
     public function resetConfiguration()
     {
@@ -230,7 +230,7 @@ class Hierarchy
     }
 
     /**
-     * Shutting down a hierarchy will <i>safely</i> close and remove
+     * Shutting down a hierarchy will *safely* close and remove
      * all appenders in all loggers including the root logger.
      *
      * The shutdown method is careful to close nested

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Layouts/AbstractLayout.php
----------------------------------------------------------------------
diff --git a/src/Layouts/AbstractLayout.php b/src/Layouts/AbstractLayout.php
index bd4dd71..e6614c2 100644
--- a/src/Layouts/AbstractLayout.php
+++ b/src/Layouts/AbstractLayout.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Layouts/HtmlLayout.php
----------------------------------------------------------------------
diff --git a/src/Layouts/HtmlLayout.php b/src/Layouts/HtmlLayout.php
index e14f5ac..3ae7010 100644
--- a/src/Layouts/HtmlLayout.php
+++ b/src/Layouts/HtmlLayout.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
  *
- *     http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -34,21 +34,21 @@ use Apache\Log4php\Level;
 class HtmlLayout extends AbstractLayout
 {
     /**
-     * The <b>LocationInfo</b> option takes a boolean value. By
+     * The **LocationInfo** option takes a boolean value. By
      * default, it is set to false which means there will be no location
      * information output by this layout. If the the option is set to
      * true, then the file name and line number of the statement
      * at the origin of the log statement will be output.
      *
-     * <p>If you are embedding this layout within a {@link MailAppender}
+     * If you are embedding this layout within a {@link MailAppender}
      * or a {@link MailEventAppender} then make sure to set the
-     * <b>LocationInfo</b> option of that appender as well.
+     * **LocationInfo** option of that appender as well.
      * @var boolean
      */
     protected $locationInfo = false;
 
     /**
-     * The <b>Title</b> option takes a String value. This option sets the
+     * The **Title** option takes a String value. This option sets the
      * document title of the generated HTML document.
      * Defaults to 'Log4php Log Messages'.
      * @var string
@@ -56,15 +56,15 @@ class HtmlLayout extends AbstractLayout
     protected $title = "Log4php Log Messages";
 
     /**
-     * The <b>LocationInfo</b> option takes a boolean value. By
+     * The **LocationInfo** option takes a boolean value. By
      * default, it is set to false which means there will be no location
      * information output by this layout. If the the option is set to
      * true, then the file name and line number of the statement
      * at the origin of the log statement will be output.
      *
-     * <p>If you are embedding this layout within a {@link MailAppender}
+     * If you are embedding this layout within a {@link MailAppender}
      * or a {@link MailEventAppender} then make sure to set the
-     * <b>LocationInfo</b> option of that appender as well.
+     * **LocationInfo** option of that appender as well.
      */
     public function setLocationInfo($flag)
     {
@@ -72,7 +72,7 @@ class HtmlLayout extends AbstractLayout
     }
 
     /**
-     * Returns the current value of the <b>LocationInfo</b> option.
+     * Returns the current value of the **LocationInfo** option.
      */
     public function getLocationInfo()
     {
@@ -80,7 +80,7 @@ class HtmlLayout extends AbstractLayout
     }
 
     /**
-     * The <b>Title</b> option takes a String value. This option sets the
+     * The **Title** option takes a String value. This option sets the
      * document title of the generated HTML document.
      * Defaults to 'Log4php Log Messages'.
      */
@@ -90,7 +90,7 @@ class HtmlLayout extends AbstractLayout
     }
 
     /**
-     * @return string Returns the current value of the <b>Title</b> option.
+     * @return string Returns the current value of the **Title** option.
      */
     public function getTitle()
     {

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Layouts/PatternLayout.php
----------------------------------------------------------------------
diff --git a/src/Layouts/PatternLayout.php b/src/Layouts/PatternLayout.php
index 96fda23..393c64c 100644
--- a/src/Layouts/PatternLayout.php
+++ b/src/Layouts/PatternLayout.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
  *
- *     http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Layouts/SerializedLayout.php
----------------------------------------------------------------------
diff --git a/src/Layouts/SerializedLayout.php b/src/Layouts/SerializedLayout.php
index 77af51e..3d14ed9 100644
--- a/src/Layouts/SerializedLayout.php
+++ b/src/Layouts/SerializedLayout.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
  *
- *     http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Layouts/SimpleLayout.php
----------------------------------------------------------------------
diff --git a/src/Layouts/SimpleLayout.php b/src/Layouts/SimpleLayout.php
index 3c02e5e..259aa84 100644
--- a/src/Layouts/SimpleLayout.php
+++ b/src/Layouts/SimpleLayout.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
  *
- *     http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -24,7 +24,7 @@ use Apache\Log4php\LoggingEvent;
  * A simple layout.
  *
  * Returns the log statement in a format consisting of the
- * <b>level</b>, followed by " - " and then the <b>message</b>.
+ * **level**, followed by " - " and then the **message**.
  *
  * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0
  */
@@ -32,8 +32,8 @@ class SimpleLayout extends AbstractLayout
 {
     /**
      * Returns the log statement in a format consisting of the
-     * <b>level</b>, followed by " - " and then the
-     * <b>message</b>. For example,
+     * **level**, followed by " - " and then the
+     * **message**. For example,
      * <samp> INFO - "A message" </samp>
      *
      * @param  LoggingEvent $event

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Layouts/XmlLayout.php
----------------------------------------------------------------------
diff --git a/src/Layouts/XmlLayout.php b/src/Layouts/XmlLayout.php
index 191b9e8..c0c147e 100644
--- a/src/Layouts/XmlLayout.php
+++ b/src/Layouts/XmlLayout.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License.  You may obtain a copy of the License at
  *
- *     http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -30,9 +30,9 @@ use Apache\Log4php\LoggingEvent;
  *   instead of log4php namespace. This can be usefull when using log viewers
  *   which can only parse the log4j namespace such as Apache Chainsaw.
  *
- * <p>It does not output a complete well-formed XML file.
+ * It does not output a complete well-formed XML file.
  * The output is designed to be included as an external entity in a separate file to form
- * a correct XML file.</p>
+ * a correct XML file.
  *
  * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0
  */

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Level.php
----------------------------------------------------------------------
diff --git a/src/Level.php b/src/Level.php
index f13dcf9..1eb2c8a 100644
--- a/src/Level.php
+++ b/src/Level.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -19,13 +19,17 @@
 namespace Apache\Log4php;
 
 /**
- * Defines the minimum set of levels recognized by the system, that is
- * <i>OFF</i>, <i>FATAL</i>, <i>ERROR</i>,
- * <i>WARN</i>, <i>INFO</i>, <i>DEBUG</i> and
- * <i>ALL</i>.
+ * Defines the minimum set of levels recognized by the system, which are:
  *
- * <p>The <i>Level</i> class may be subclassed to define a larger
- * level set.</p>
+ * - <var>OFF</var>
+ * - <var>FATAL</var>
+ * - <var>ERROR</var>
+ * - <var>WARN</var>
+ * - <var>INFO</var>
+ * - <var>DEBUG</var>
+ * - <var>ALL</var>
+ *
+ * The {@link Level} class may be subclassed to define a larger level set.
  *
  * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0
  * @link http://logging.apache.org/log4php
@@ -202,8 +206,8 @@ class Level
     }
 
     /**
-     * Returns <i>true</i> if this level has a higher or equal
-     * level than the level passed as argument, <i>false</i>
+     * Returns *true* if this level has a higher or equal
+     * level than the level passed as argument, *false*
      * otherwise.
      *
      * @param  Level   $other

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/LocationInfo.php
----------------------------------------------------------------------
diff --git a/src/LocationInfo.php b/src/LocationInfo.php
index 0c3becd..63cd3fe 100644
--- a/src/LocationInfo.php
+++ b/src/LocationInfo.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Logger.php
----------------------------------------------------------------------
diff --git a/src/Logger.php b/src/Logger.php
index f23bd08..40cb416 100644
--- a/src/Logger.php
+++ b/src/Logger.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *		http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -23,14 +23,14 @@ namespace Apache\Log4php;
  * are done through this class.
  *
  * The main logging methods are:
- * 	<ul>
- * 		<li>{@link trace()}</li>
- * 		<li>{@link debug()}</li>
- * 		<li>{@link info()}</li>
- * 		<li>{@link warn()}</li>
- * 		<li>{@link error()}</li>
- * 		<li>{@link fatal()}</li>
- * 	</ul>
+ * <ul>
+ *     <li>{@link trace()}</li>
+ *     <li>{@link debug()}</li>
+ *     <li>{@link info()}</li>
+ *     <li>{@link warn()}</li>
+ *     <li>{@link error()}</li>
+ *     <li>{@link fatal()}</li>
+ * </ul>
  *
  * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0
  * @link http://logging.apache.org/log4php

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/LoggerException.php
----------------------------------------------------------------------
diff --git a/src/LoggerException.php b/src/LoggerException.php
index 3b9b411..7442f41 100644
--- a/src/LoggerException.php
+++ b/src/LoggerException.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *     http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/LoggingEvent.php
----------------------------------------------------------------------
diff --git a/src/LoggingEvent.php b/src/LoggingEvent.php
index 8fa5d5f..c5ae5df 100644
--- a/src/LoggingEvent.php
+++ b/src/LoggingEvent.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -29,23 +29,24 @@ class LoggingEvent
     private static $startTime;
 
     /**
-    * @var string Fully Qualified Class Name of the calling category class.
-    */
+     * Fully qualified class name of the calling category class.
+     */
     private $fqcn;
 
     /**
-    * @var Logger reference
-    */
+     * Reference to the logger which generated the event.
+     * @var Logger
+     */
     private $logger;
 
     /**
-     * The category (logger) name.
-     * This field will be marked as private in future
-     * releases. Please do not access it directly.
-     * Use the {@link getLoggerName()} method instead.
+     * The category (logger) name. This field will be marked as private in
+     * future releases. Please do not access it directly. Use the {@link
+     * getLoggerName()} method instead.
+     *
      * @deprecated
      */
-    private $categoryName;
+    private $loggerName;
 
     /**
      * Level of the logging event.
@@ -61,7 +62,7 @@ class LoggingEvent
 
     /**
      * Have we tried to do an NDC lookup? If we did, there is no need
-     * to do it again.	Note that its value is always false when
+     * to do it again. Note that its value is always false when
      * serialized. Thus, a receiving SocketNode will never use it's own
      * (incorrect) NDC. See also writeObject method.
      * @var boolean
@@ -122,9 +123,9 @@ class LoggingEvent
         $this->fqcn = $fqcn;
         if ($logger instanceof Logger) {
             $this->logger = $logger;
-            $this->categoryName = $logger->getName();
+            $this->loggerName = $logger->getName();
         } else {
-            $this->categoryName = strval($logger);
+            $this->loggerName = strval($logger);
         }
         $this->level = $level;
         $this->message = $message;
@@ -152,9 +153,9 @@ class LoggingEvent
      * Set the location information for this logging event. The collected
      * information is cached for future use.
      *
-     * <p>This method uses {@link PHP_MANUAL#debug_backtrace debug_backtrace()} function (if exists)
-     * to collect informations about caller.</p>
-     * <p>It only recognize informations generated by {@link Logger} and its subclasses.</p>
+     * This method uses {@link PHP_MANUAL#debug_backtrace debug_backtrace()} function (if exists)
+     * to collect informations about caller.
+     * It only recognize informations generated by {@link Logger} and its subclasses.
      * @return LocationInfo
      */
     public function getLocationInformation()
@@ -220,12 +221,12 @@ class LoggingEvent
 
     /**
      * Return the name of the logger. Use this form instead of directly
-     * accessing the {@link $categoryName} field.
+     * accessing the {@link $loggerName} field.
      * @return string
      */
     public function getLoggerName()
     {
-        return $this->categoryName;
+        return $this->loggerName;
     }
 
     /**
@@ -241,7 +242,7 @@ class LoggingEvent
      * This method returns the NDC for this event. It will return the
      * correct content even if the event was generated in a different
      * thread or even on a different machine. The {@link NDC::get()} method
-     * should <b>never</b> be called directly.
+     * should **never** be called directly.
      * @return string
      */
     public function getNDC()
@@ -329,7 +330,7 @@ class LoggingEvent
      * to the time the event was constructed.
      *
      * @deprecated This method has been replaced by getRelativeTime which
-     * 		does not perform unneccesary multiplication and formatting.
+     *     does not perform unneccesary multiplication and formatting.
      *
      * @return integer
      */
@@ -377,7 +378,7 @@ class LoggingEvent
     {
         return array(
             'fqcn',
-            'categoryName',
+            'loggerName',
             'level',
             'ndc',
             'ndcLookupRequired',

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/MDC.php
----------------------------------------------------------------------
diff --git a/src/MDC.php b/src/MDC.php
index 096f5af..7923f26 100644
--- a/src/MDC.php
+++ b/src/MDC.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -19,7 +19,7 @@
 namespace Apache\Log4php;
 
 /**
- * The MDC class provides _mapped diagnostic contexts_.
+ * The MDC class provides *mapped diagnostic contexts*.
  *
  * A Mapped Diagnostic Context, or MDC in short, is an instrument for
  * distinguishing interleaved log output from different sources. Log output
@@ -55,7 +55,7 @@ class MDC
      *
      * @param  string $key The key.
      * @return string The context or an empty string if no context found
-     * 	for given key.
+     *     for given key.
      */
     public static function get($key)
     {

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/NDC.php
----------------------------------------------------------------------
diff --git a/src/NDC.php b/src/NDC.php
index f70d9b7..0c77c28 100644
--- a/src/NDC.php
+++ b/src/NDC.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -19,11 +19,11 @@
 namespace Apache\Log4php;
 
 /**
- * The NDC class implements <i>nested diagnostic contexts</i>.
+ * The NDC class implements *nested diagnostic contexts*.
  *
  * NDC was defined by Neil Harrison in the article "Patterns for Logging
- * Diagnostic Messages" part of the book <i>"Pattern Languages of
- * Program Design 3"</i> edited by Martin et al.
+ * Diagnostic Messages" part of the book *"Pattern Languages of
+ * Program Design 3"* edited by Martin et al.
  *
  * A Nested Diagnostic Context, or NDC in short, is an instrument
  * to distinguish interleaved log output from different sources. Log
@@ -37,16 +37,16 @@ namespace Apache\Log4php;
  * from different contexts had a distinctive stamp. This is where NDCs
  * come into play.
  *
- * <b>Note that NDCs are managed on a per thread basis</b>.
+ * **Note that NDCs are managed on a per thread basis**.
  *
  * NDC operations such as {@link push()}, {@link pop()},
  * {@link clear()}, {@link getDepth()} and {@link setMaxDepth()}
- * affect the NDC of the <i>current</i> thread only. NDCs of other
+ * affect the NDC of the *current* thread only. NDCs of other
  * threads remain unaffected.
  *
  * For example, a servlet can build a per client request NDC
  * consisting the clients host name and other information contained in
- * the the request. <i>Cookies</i> are another source of distinctive
+ * the the request. *Cookies* are another source of distinctive
  * information. To build an NDC one uses the {@link push()}
  * operation.
  *
@@ -54,10 +54,10 @@ namespace Apache\Log4php;
  *
  * - Contexts can be nested.
  * - When entering a context, call <kbd>NDC::push()</kbd>
- *	 As a side effect, if there is no nested diagnostic context for the
- *	 current thread, this method will create it.
+ *   As a side effect, if there is no nested diagnostic context for the
+ *   current thread, this method will create it.
  * - When leaving a context, call <kbd>NDC::pop()</kbd>
- * - <b>When exiting a thread make sure to call {@link remove()}</b>
+ * - **When exiting a thread make sure to call {@link remove()}**
  *
  * There is no penalty for forgetting to match each
  * <kbd>push</kbd> operation with a corresponding <kbd>pop</kbd>,
@@ -82,12 +82,12 @@ class NDC
     private static $stack = array();
 
     /**
-     * Clear any nested diagnostic information if any. This method is
-     * useful in cases where the same thread can be potentially used
-     * over and over in different unrelated contexts.
+     * Clear any nested diagnostic information if any. This method is useful in
+     * cases where the same thread can be potentially used over and over in
+     * different unrelated contexts.
      *
-     * <p>This method is equivalent to calling the {@link setMaxDepth()}
-     * method with a zero <var>maxDepth</var> argument.
+     * This method is equivalent to calling the {@link setMaxDepth()} method
+     * with a zero <var>maxDepth</var> argument.
      */
     public static function clear()
     {
@@ -95,7 +95,8 @@ class NDC
     }
 
     /**
-     * Never use this method directly, use the {@link LoggingEvent::getNDC()} method instead.
+     * Never use this method directly, use the {@link LoggingEvent::getNDC()}
+     * method instead.
      * @return array
      */
     public static function get()
@@ -115,11 +116,10 @@ class NDC
     }
 
     /**
-     * Clients should call this method before leaving a diagnostic
-     * context.
+     * Clients should call this method before leaving a diagnostic context.
      *
-     * <p>The returned value is the value that was pushed last. If no
-     * context is available, then the empty string "" is returned.</p>
+     * The returned value is the value that was pushed last. If no context is
+     * available, then the empty string "" is returned.
      *
      * @return string The innermost diagnostic context.
      */
@@ -133,11 +133,12 @@ class NDC
     }
 
     /**
-     * Looks at the last diagnostic context at the top of this NDC
-     * without removing it.
+     * Looks at the last diagnostic context at the top of this NDC without
+     * removing it.
+     *
+     * The returned value is the value that was pushed last. If no context is
+     * available, then the empty string "" is returned.
      *
-     * <p>The returned value is the value that was pushed last. If no
-     * context is available, then the empty string "" is returned.</p>
      * @return string The innermost diagnostic context.
      */
     public static function peek()
@@ -152,8 +153,8 @@ class NDC
     /**
      * Push new diagnostic context information for the current thread.
      *
-     * <p>The contents of the <var>message</var> parameter is
-     * determined solely by the client.
+     * The contents of the <var>message</var> parameter is determined solely by
+     * the client.
      *
      * @param string $message The new diagnostic context information.
      */
@@ -171,15 +172,13 @@ class NDC
     }
 
     /**
-     * Set maximum depth of this diagnostic context. If the current
-     * depth is smaller or equal to <var>maxDepth</var>, then no
-     * action is taken.
+     * Set maximum depth of this diagnostic context. If the current depth is
+     * smaller or equal to <var>maxDepth</var>, then no action is taken.
      *
-     * <p>This method is a convenient alternative to multiple
-     * {@link pop()} calls. Moreover, it is often the case that at
-     * the end of complex call sequences, the depth of the NDC is
-     * unpredictable. The {@link setMaxDepth()} method circumvents
-     * this problem.
+     * This method is a convenient alternative to multiple {@link pop()} calls.
+     * Moreover, it is often the case that at the end of complex call sequences,
+     * the depth of the NDC is unpredictable. The {@link setMaxDepth()} method
+     * circumvents this problem.
      *
      * @param integer $maxDepth
      * @see getDepth()

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Pattern/AbstractConverter.php
----------------------------------------------------------------------
diff --git a/src/Pattern/AbstractConverter.php b/src/Pattern/AbstractConverter.php
index 4f9c46b..fe42931 100644
--- a/src/Pattern/AbstractConverter.php
+++ b/src/Pattern/AbstractConverter.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -25,9 +25,9 @@ use Apache\Log4php\LoggingEvent;
  * AbstractConverter is an abstract class that provides the formatting
  * functionality that derived classes need.
  *
- * <p>Conversion specifiers in a conversion patterns are parsed to
+ * Conversion specifiers in a conversion patterns are parsed to
  * individual PatternConverters. Each of which is responsible for
- * converting a logging event in a converter specific manner.</p>
+ * converting a logging event in a converter specific manner.
  *
  * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0
  * @since 0.3

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Pattern/ClassConverter.php
----------------------------------------------------------------------
diff --git a/src/Pattern/ClassConverter.php b/src/Pattern/ClassConverter.php
index cb8d515..395f50e 100644
--- a/src/Pattern/ClassConverter.php
+++ b/src/Pattern/ClassConverter.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Pattern/CookieConverter.php
----------------------------------------------------------------------
diff --git a/src/Pattern/CookieConverter.php b/src/Pattern/CookieConverter.php
index 5d7b61a..122e4c7 100644
--- a/src/Pattern/CookieConverter.php
+++ b/src/Pattern/CookieConverter.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Pattern/DateConverter.php
----------------------------------------------------------------------
diff --git a/src/Pattern/DateConverter.php b/src/Pattern/DateConverter.php
index 553067e..9e15c6b 100644
--- a/src/Pattern/DateConverter.php
+++ b/src/Pattern/DateConverter.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,

http://git-wip-us.apache.org/repos/asf/logging-log4php/blob/2378545f/src/Pattern/EnvironmentConverter.php
----------------------------------------------------------------------
diff --git a/src/Pattern/EnvironmentConverter.php b/src/Pattern/EnvironmentConverter.php
index 2af9b0e..9601a9a 100644
--- a/src/Pattern/EnvironmentConverter.php
+++ b/src/Pattern/EnvironmentConverter.php
@@ -7,7 +7,7 @@
  * (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  *
- *	   http://www.apache.org/licenses/LICENSE-2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,


Mime
View raw message