You are viewing a plain text version of this content. The canonical link for it is here.
Posted to log4php-dev@logging.apache.org by ih...@apache.org on 2011/06/03 00:00:08 UTC
svn commit: r1130840 - in /logging/log4php/trunk/src/site: apt/download.apt
apt/install.apt apt/quickstart.apt apt/upgrading.apt site.xml
Author: ihabunek
Date: Thu Jun 2 22:00:08 2011
New Revision: 1130840
URL: http://svn.apache.org/viewvc?rev=1130840&view=rev
Log:
Site improvements:
* removed the "Install" page - the information contained there has been split between "Download" and "Quickstart" pages
* removed the Roadmap page since it does not contain any useful information
* renamed "PHPDoc" page to "API docs"
* minor improvements to "Upgrading" and "Quickstart" pages.
Removed:
logging/log4php/trunk/src/site/apt/install.apt
Modified:
logging/log4php/trunk/src/site/apt/download.apt
logging/log4php/trunk/src/site/apt/quickstart.apt
logging/log4php/trunk/src/site/apt/upgrading.apt
logging/log4php/trunk/src/site/site.xml
Modified: logging/log4php/trunk/src/site/apt/download.apt
URL: http://svn.apache.org/viewvc/logging/log4php/trunk/src/site/apt/download.apt?rev=1130840&r1=1130839&r2=1130840&view=diff
==============================================================================
--- logging/log4php/trunk/src/site/apt/download.apt (original)
+++ logging/log4php/trunk/src/site/apt/download.apt Thu Jun 2 22:00:08 2011
@@ -18,31 +18,66 @@ Download
------
------
-Download log4php
+Download
- Apache log4php is distributed under the {{{http://www.apache.org/licenses/LICENSE-2.0.html} Apache License, version 2.0}}.
+ Apache log4php is distributed under the {{{http://www.apache.org/licenses/LICENSE-2.0.html} Apache License, version 2.0}}.
-* Version 2.0.0
+ Version 2.0.0 is the latest stable version, available since 12.12.2009.
- Version 2.0.0 is available since 12.12.2009.
+* Source package
- The following artifacts contain the complete sourcecode and API docs. It is recommended for most users:
+ The source package contains the complete source code and API docs. This is recommended for most users.
- * {{{http://www.apache.org/dyn/closer.cgi/logging/log4php/2.0.0/apache-log4php-2.0.0-incubating-src.tar.gz}apache-log4php-2.0.0-incubating-src.tar.gz}} {{{http://www.apache.org/dist/logging/log4php/2.0.0/apache-log4php-2.0.0-incubating-src.tar.gz.md5}MD5}} {{{http://www.apache.org/dist/logging/log4php/2.0.0/apache-log4php-2.0.0-incubating-src.tar.gz.asc}ASC}}
+*----------+-----------+------------+
+|| Mirrors || Checksum || Signature |
+*----------+-----------+------------+
+| {{{http://www.apache.org/dyn/closer.cgi/logging/log4php/2.0.0/apache-log4php-2.0.0-incubating-src.tar.gz}apache-log4php-2.0.0-incubating-src.tar.gz}} | {{{http://www.apache.org/dist/logging/log4php/2.0.0/apache-log4php-2.0.0-incubating-src.tar.gz.md5}MD5}} | {{{http://www.apache.org/dist/logging/log4php/2.0.0/apache-log4php-2.0.0-incubating-src.tar.gz.asc}ASC}} |
+*----------+-----------+------------+
+| {{{http://www.apache.org/dyn/closer.cgi/logging/log4php/2.0.0/apache-log4php-2.0.0-incubating-src.zip}apache-log4php-2.0.0-incubating-src.zip}} | {{{http://www.apache.org/dist/logging/log4php/2.0.0/apache-log4php-2.0.0-incubating-src.zip.md5}MD5}} | {{{http://www.apache.org/dist/logging/log4php/2.0.0/apache-log4php-2.0.0-incubating-src.zip.asc}ASC}} |
+*----------+-----------+------------+
- * {{{http://www.apache.org/dyn/closer.cgi/logging/log4php/2.0.0/apache-log4php-2.0.0-incubating-src.zip}apache-log4php-2.0.0-incubating-src.zip}} {{{http://www.apache.org/dist/logging/log4php/2.0.0/apache-log4php-2.0.0-incubating-src.zip.md5}MD5}} {{{http://www.apache.org/dist/logging/log4php/2.0.0/apache-log4php-2.0.0-incubating-src.zip.asc}ASC}}
+* Pear package
+ The pear package is prepared for a {{{http://pear.php.net}pear}} channel and is recommended for users who want to make log4php available in their own channels.
- The following artifact is prepared for a pear channel and is recommended to users who want to make log4php available in their own channels:
+*----------+-----------+------------+
+|| Mirrors || Checksum || Signature |
+*----------+-----------+------------+
+| {{{http://www.apache.org/dyn/closer.cgi/logging/log4php/2.0.0/Apache_log4php-2.0.0-incubating-pear.tgz}Apache_log4php-2.0.0-incubating-pear.tgz}} | {{{http://www.apache.org/dist/logging/log4php/2.0.0/Apache_log4php-2.0.0-incubating-pear.tgz.md5}MD5}} | {{{http://www.apache.org/dist/logging/log4php/2.0.0/Apache_log4php-2.0.0-incubating-pear.tgz.asc}ASC}} |
+*----------+-----------+------------+
- * {{{http://www.apache.org/dyn/closer.cgi/logging/log4php/2.0.0/Apache_log4php-2.0.0-incubating-pear.tgz}Apache_log4php-2.0.0-incubating-pear.tgz}} {{{http://www.apache.org/dist/logging/log4php/2.0.0/Apache_log4php-2.0.0-incubating-pear.tgz.md5}MD5}} {{{http://www.apache.org/dist/logging/log4php/2.0.0/Apache_log4php-2.0.0-incubating-pear.tgz.asc}ASC}}
+* From repository
+ The latest development version can be checked out from the {{{./source-repository.html}project repository}}. This will provide access to all the latest features, but may be unstable and should not be used in production systems.
+
+* Previous Releases
+
+ All previous releases of Apache log4php can be found in the {{{http://archive.apache.org/dist/logging/log4php}archive repository}}.
+
* Please mind the signatures
- <<Note:>> when downloading from a mirror please check the {{{http://www.apache.org/dev/release-signing#md5}md5sum}}
- and verify the {{{http://www.apache.org/dev/release-signing#openpgp}OpenPGP}} compatible signature from the main {{{http://www.apache.org}Apache site}}.
- Links are provided above (next to the release download link).
- This {{{http://www.apache.org/dist/incubator/log4php/KEYS}KEYS}} file contains the public keys used for signing release.
- It is recommended that (when possible) a {{{http://www.apache.org/dev/release-signing#web-of-trust}web of trust}}
- is used to confirm the identity of these keys.
- For more information, please see the {{{http://www.apache.org/dev/release.html}Apache Release FAQ}}.
\ No newline at end of file
+ It is important that you verify the integrity of the downloaded files using the PGP or MD5 signatures.
+ Please read {{{http://httpd.apache.org/dev/verification.html}Verifying Apache HTTP Server Releases}} for more
+ information on why you should verify our releases.
+
+ The PGP signatures can be verified using PGP or GPG. First download the {{{http://www.apache.org/dist/logging/log4php/KEYS}KEYS}}
+ as well as the asc signature file for the relevant distribution. Make sure you get these files from the
+ {{{http://www.apache.org/dist/logging/log4php}main distribution directory}}, rather than from a mirror.
+
+ Then verify the signatures using:
+
+---
+# gpg --import KEYS
+# gpg --verify apache-log4php-2.0.0-incubating-src.tar.gz.asc
+---
+
+ This should result in a confirmation message:
+
+---
+gpg: Signature made Fri 27 Nov 2009 07:47:28 AM CET using DSA key ID 42196CA8
+gpg: Good signature from "Christian Grobmeier (Apache Codesigning) <gr...@apache.org>"
+---
+
+ Apache log4php 2.0.0 is signed by Christian Grobmeier (key 42196CA8).
+
+ Alternatively, you can verify the MD5 signature on the files.
\ No newline at end of file
Modified: logging/log4php/trunk/src/site/apt/quickstart.apt
URL: http://svn.apache.org/viewvc/logging/log4php/trunk/src/site/apt/quickstart.apt?rev=1130840&r1=1130839&r2=1130840&view=diff
==============================================================================
--- logging/log4php/trunk/src/site/apt/quickstart.apt (original)
+++ logging/log4php/trunk/src/site/apt/quickstart.apt Thu Jun 2 22:00:08 2011
@@ -20,16 +20,18 @@ Quickstart
Quickstart
- First, please {{{./install.html}install log4php}}.
+ First, please {{{./download.html}download log4php}} and unpack it.
+
+ Optionally, you may copy the folder <<src/main/php>>, which contains the source code, to a location of your choosing. For example, a folder within your project.
- It would also be wise to read the {{{./docs/introduction.html}introduction to log4php}} to familiarise yoursef with the basic concepts used throughout the documentation and examples.
+ Please read the {{{./docs/introduction.html}introduction}} to familiarise yoursef with the basic concepts used throughout the documentation and examples.
* A trivial example
You just want logging to stdout?
+--
-require_once('log4php/Logger.php');
+include('log4php/Logger.php');
$logger = Logger::getLogger("main");
$logger->info("foo");
@@ -77,8 +79,8 @@ Sun Jul 26 01:40:23 2009,030 [10093] WAR
To try it out, run the following code:
+--
-// Replace the path with where you installed log4php
-require_once('/path/to/log4php/Logger.php');
+// Insert the path where you unpacked log4php
+include('log4php/Logger.php');
// Tell log4php to use our configuration file.
Logger::configure('log4php.xml');
@@ -105,7 +107,15 @@ FATAL - My sixth message.
* An advanced example
- Named loggers; layouts; best practices in object-oriented programming.
+ This example covers:
+
+ * named loggers
+
+ * using layouts
+
+ * best practices in object-oriented programming
+
+ []
Create the following configuration file:
@@ -144,7 +154,7 @@ FATAL - My sixth message.
The code:
+--
-require 'D:\Projects\apache\log4php\src\main\php\Logger.php';
+include('log4php/Logger.php');
Logger::configure('D:\Projects\apache\_playground\log4php.xml');
Modified: logging/log4php/trunk/src/site/apt/upgrading.apt
URL: http://svn.apache.org/viewvc/logging/log4php/trunk/src/site/apt/upgrading.apt?rev=1130840&r1=1130839&r2=1130840&view=diff
==============================================================================
--- logging/log4php/trunk/src/site/apt/upgrading.apt (original)
+++ logging/log4php/trunk/src/site/apt/upgrading.apt Thu Jun 2 22:00:08 2011
@@ -18,18 +18,18 @@ Upgrading
------
------
-Upgrading from previous versions to 2.0
+Upgrading
- log4php 2.0 is not compatible with the previous versions. Please have the following in mind when
+ Apache log4php 2.0 is not compatible with the previous versions. Please have the following in mind when
upgrading to log4php 2.0 in your project:
- * PHP5 is required instead of PHP4
+ * PHP 5.2+ is required
- * The LoggerManager class has been removed. Use Logger instead.
+ * LoggerManager class has been removed. Use Logger instead.
* LoggerHierarchy is not a singleton anymore by default.
- * log4php logs to std out by default
+ * Apache log4php logs to STDOUT by default
- * The old constants LOG4PHP_CONFIGURATION and similar are not longer valid. Please use Logger::configure for configuring log4php
+ * LOG4PHP_CONFIGURATION constant is no longer used. Please use Logger::configure() to configure log4php.
\ No newline at end of file
Modified: logging/log4php/trunk/src/site/site.xml
URL: http://svn.apache.org/viewvc/logging/log4php/trunk/src/site/site.xml?rev=1130840&r1=1130839&r2=1130840&view=diff
==============================================================================
--- logging/log4php/trunk/src/site/site.xml (original)
+++ logging/log4php/trunk/src/site/site.xml Thu Jun 2 22:00:08 2011
@@ -45,7 +45,6 @@
<menu name="Get log4php">
<item name="Download" href="/download.html"/>
- <item name="Install" href="/install.html"/>
<item name="Upgrading" href="/upgrading.html"/>
</menu>
@@ -63,7 +62,7 @@
<item name="Renderer" href="/docs/renderer.html"/>
<item name="Performance" href="/docs/performance.html"/>
</item>
- <item name="PHPDoc" href="/apidocs/index.html"/>
+ <item name="API docs" href="/apidocs/index.html"/>
</menu>
<menu name="Community">
@@ -76,7 +75,6 @@
<menu name="Developers">
<item name="Volunteering" href="/volunteering.html"/>
<item name="Contributing Patches" href="/contributingpatches.html"/>
- <item name="Roadmap" href="/roadmap.html"/>
<item name="Code Coverage" href="/coverage-report/index.html"/>
<item name="Buildbot" href="http://ci.apache.org/projects/log4php"/>
</menu>