logging-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ihabu...@apache.org
Subject svn commit: r1231061 - in /logging/log4php/trunk/src/site/apt: contributingpatches.apt index.apt
Date Fri, 13 Jan 2012 13:39:17 GMT
Author: ihabunek
Date: Fri Jan 13 13:39:17 2012
New Revision: 1231061

URL: http://svn.apache.org/viewvc?rev=1231061&view=rev
Log:
Added several projects to "who uses log4php" section. Improved guidelines for submitting patches.

Modified:
    logging/log4php/trunk/src/site/apt/contributingpatches.apt
    logging/log4php/trunk/src/site/apt/index.apt

Modified: logging/log4php/trunk/src/site/apt/contributingpatches.apt
URL: http://svn.apache.org/viewvc/logging/log4php/trunk/src/site/apt/contributingpatches.apt?rev=1231061&r1=1231060&r2=1231061&view=diff
==============================================================================
--- logging/log4php/trunk/src/site/apt/contributingpatches.apt (original)
+++ logging/log4php/trunk/src/site/apt/contributingpatches.apt Fri Jan 13 13:39:17 2012
@@ -44,13 +44,17 @@ Contributing patches
 
     * don't use vertical alignement
     
-    * brackets are on the same line as the method signature
+    * keep brackets on the same line as the method signature
     
-    * brackets are on the same line as control statements
+    * keep brackets on the same line as control statements
     
-    * always brackets for control statements
+    * always use brackets for control statements
     
-    * don't use _ in variablenames
+    * use lowerCamelCase for naming methods and variables
+    
+    * don't use underscores (_)
+    
+    []
 
 * Tabs not spaces
 
@@ -65,8 +69,9 @@ Contributing patches
 
 * Test cases
 
-  Classes needs to be tested with PHPUnit. If you are not familiar with the principles
-  of regression testing, then the JUnit or even the PHPUnit site has some good articles.
+  Classes needs to be tested with {{{https://github.com/sebastianbergmann/phpunit/}PHPUnit}}.
If 
+  you are not familiar with the principles of regression testing, then the 
+  {{{http://www.phpunit.de/manual/3.6/en/}PHPUnit manual}} is a good place to start.
 
   Before you submit your patch, please do a clean build of the full distribution and 
   run the unit tests (this can be done with <<<maven test>>>. This ensures
that 
@@ -78,7 +83,7 @@ Contributing patches
 
 * Creating a patch
 
-  The Apache log4php source code repository holds the current source. Currently SVN is beeing
used.
+  The Apache log4php {{{./source-repository.html}source code repository}} holds the current
source.
 
   Please create your patch against the latest revision of the files in the source code 
   repository since this makes the job of applying the patch much easier. 
@@ -95,13 +100,13 @@ Contributing patches
   Try to give your patch files meaningful names. This makes it easier for 
   developers who need to apply a number of different patches.
 
-* S	ubmitting a patch
+* Submitting a patch
 
-  There are two ways to go to submit a patch:
-
-  * Add the patch as an attachment to a bug report. log4php uses JIRA. Create a new bug
-    report if necessary.
+  The preffered way of submitting a patch is by attaching it to a bug report in the project's
+  {{{http://logging.apache.org/log4php/issue-tracking.html} issue tracker}}. Create a new
bug
+  report if necessary.
     
-  * Mail the JIRA issue number to the dev mailing list. The email subject should describe
-    what the patch does and should be prefixed by [PATCH]. Make sure that it's clear 
-    which component the patch is for. 
+  Please make sure to mark "Grant license to ASF for inclusion in ASF works" when attaching
+  the patch. This means you agree with providing us with the code contained in the patch
+  under the {{{http://www.apache.org/licenses/LICENSE-2.0}Apache licence}}.    
+

Modified: logging/log4php/trunk/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/logging/log4php/trunk/src/site/apt/index.apt?rev=1231061&r1=1231060&r2=1231061&view=diff
==============================================================================
--- logging/log4php/trunk/src/site/apt/index.apt (original)
+++ logging/log4php/trunk/src/site/apt/index.apt Fri Jan 13 13:39:17 2012
@@ -59,7 +59,9 @@ What is Apache log4php?
 
 The Apache log4php project
 	
-	Apache log4php\u2122 is an open source project at the {{{http://www.apache.org}Apache Software
Foundation}}, a part the {{{http://logging.apache.org}Apache Logging Services}} project.
+	Apache log4php\u2122 is an open source project at the 
+	{{{http://www.apache.org}Apache Software Foundation}}, a part the 
+	{{{http://logging.apache.org}Apache Logging Services}} project.
 
 	Apache log4php\u2122 graduated in March 2010.
 
@@ -71,23 +73,32 @@ Who uses Apache log4php?
 	
 	* {{{http://cmsmadesimple.org}CMS Made Simple}} - an open source (GPL) CMS
 	
+	* {{{http://marcelog.github.com/Ding/}Ding}} - a dependency injection, AOP, and MVC container,
with features 
+	    similar to the Spring Framework
+	
 	* {{{http://sourceforge.net/projects/helpzilla/}Helpzilla}} - interactive solutions for
customer care
 	
-	* {{{http://www.imento.dk}Imento}} - A danish company which uses log4php in their commercial
+	* {{{http://www.imento.dk}Imento}} - a danish company which uses log4php in their commercial
 		MVC framework
 	
 	* {{{http://www.paloose.org}Paloose}} - a simplified version of Cocoon using PHP
 	
-	* {{{http://piwi.googlecode.com/}PIWI Framework}} - A framework for quick website building
and
+	* {{{http://marcelog.github.com/PAMI/}PAMI}} / {{{http://marcelog.github.com/PAGI/}PAGI}}
- OOP clients for the 
+	    Asterisk Manager Protocol and the Asterisk Gateway Protocol, implemented in PHP.
+	
+	* {{{http://piwi.googlecode.com/}PIWI Framework}} - a framework for quick website building
and
 		PHP Dependency Injection similar to Apache Cocoon and Apache Forrest.
 	
-	* {{{http://code.google.com/p/scalr/}Scalr}} - a fully redundant, self-curing and self-scaling
hosting environment using Amazon's EC2
+	* {{{http://code.google.com/p/scalr/}Scalr}} - a fully redundant, self-curing and self-scaling
hosting environment
+	    using Amazon's EC2
 	
-	* {{{http://www.sitesupra.com/}SiteSupra}} - enterprise PHP platform
+	* {{{http://www.sitesupra.com/}SiteSupra}} - an enterprise PHP platform
 	
 	* {{{http://www.sugarcrm.com}SugarCRM}} - low-cost customer relationship management solutions
 	
 	* {{{http://www.vtiger.com}vtiger}} - an open source CRM
 	
+	[]
+	
 	If you think that you should be on this list, please let us know by sending a 
 	message to the {{{./mail-lists.html}log4php user lists}}.



Mime
View raw message