bumped version to 0.0.11, documented changes

README.md

@@ -1,6 +1,6 @@
 [![Maintainer Status](http://stillmaintained.com/akhikhl/gretty.png)](http://stillmaintained.com/akhikhl/gretty) [![Build Status](https://travis-ci.org/akhikhl/gretty.png?branch=master)](https://travis-ci.org/akhikhl/gretty) [![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/akhikhl/gretty/trend.png)](https://bitdeli.com/free "Bitdeli Badge") [![endorse](https://api.coderwall.com/akhikhl/endorsecount.png)](https://coderwall.com/akhikhl)
 
-# Gretty Version 0.0.10 
+# Gretty Version 0.0.11
 
 **Gretty** is a [feature-rich](#main-features) gradle plugin for running web-applications under jetty.
 
@@ -475,11 +475,12 @@ Author of gretty plugin tested debugging only under netbeans IDE. It should also
 
 ## Logging
 
-Gretty appends logback-classic to the project's classpath.
-Gretty Plugin supports configuring slf4j/logback logging in three forms:
+When gretty runs it's tasks, it appends logback-classic to the project's classpath.
+
+Gretty supports configuring slf4j/logback logging in three forms:
 
 1. If you place "logback.groovy" or "logback.xml" to "src/main/resources", it is compiled (copied) to "build/resources/main" folder
-  before running any jetty tasks. Gretty recognizes logback configuration file in that folder and applies it to jetty process.
+  before running any jetty tasks. Gretty auto-discovers logback configuration file in that folder and applies it to jetty process.
 
 2. If you place "logback.groovy" or "logback.xml" to arbitrary folder and then reference it by "logbackConfigFile" property,
   gretty applies the specified configuration to jetty process.
@@ -494,11 +495,17 @@ Gretty Plugin supports configuring slf4j/logback logging in three forms:
 
 **Attention**: gretty logging is only effective in gretty tasks. Gretty does not reconfigure logging (or libraries) of the compiled WAR-file.
 
-1. It appends logback-classic to the project's classpath.
+You can fine-tune gretty logging by adjusting the following properties [of gretty plugin extension]:
 
-You can fine-tune gretty logging by adjusting the following parameters [of gretty plugin extension]:
+<a name="logbackconfigfile"></a>
+"logbackConfigFile" defines the absolute or relative path to logback configuration file (.groovy or .xml).
+If "logbackConfigFile" is relative, it is first combined with projectDir. If the resulting path points to an existing file,
+it is used for logback configuration. If not, gretty tries to combine "logbackConfigFile" with each output folder
+(typically "${projectDir}/build/classes/main" and "${projectDir}/build/resources/main"). If any resulting path points to an existing file,
+it is used for logback configuration.
 
-"logbackConfigFile" defines the absolute or relative path to logback configuration file (.groovy or .xml). See more information in chapter [Logging](#logging).
+  - **Attention**: when logback configuration file is used (either auto-discovered or specified via "logbackConfigFile" property),
+  other logging properties ("loggingLevel", "consoleLogEnabled", "fileLogEnabled", "logFileName", "logDir") have no effect.
 
 "loggingLevel" defines slf4j logging-level for jetty process. It is a string, having one of the values: 'ALL', 'DEBUG', 'ERROR', 'INFO', 'OFF', 'TRACE', 'WARN'. The default value is 'INFO'.
 

build.gradle

@@ -1,6 +1,6 @@
 ext {
   group = 'org.akhikhl.gretty'
-  version = '0.0.10'
+  version = '0.0.11'
   jetty7_version = '7.6.14.v20131031'
   jetty7_servlet_api_version = '2.5'
   jetty8_version = '8.1.8.v20121106'

examples/build.gradle

@@ -7,10 +7,10 @@ buildscript {
   }
 
   dependencies {
-    classpath 'org.akhikhl.gretty:gretty7-plugin:0.0.10'
-    classpath 'org.akhikhl.gretty:gretty8-plugin:0.0.10'
-    classpath 'org.akhikhl.gretty:gretty9-plugin:0.0.10'
-    classpath 'org.akhikhl.gretty:gretty-plugin:0.0.10'
+    classpath 'org.akhikhl.gretty:gretty7-plugin:0.0.11'
+    classpath 'org.akhikhl.gretty:gretty8-plugin:0.0.11'
+    classpath 'org.akhikhl.gretty:gretty9-plugin:0.0.11'
+    classpath 'org.akhikhl.gretty:gretty-plugin:0.0.11'
   }
 }
 

libs/gretty7-plugin/src/main/groovy/org/akhikhl/gretty7/GrettyPlugin.groovy

@@ -22,7 +22,7 @@ final class GrettyPlugin extends GrettyPluginBase {
   void injectDependencies(Project project) {
     project.dependencies {
       providedCompile 'javax.servlet:servlet-api:2.5'
-      grettyHelperConfig 'org.akhikhl.gretty:gretty7-helper:0.0.10'
+      grettyHelperConfig 'org.akhikhl.gretty:gretty7-helper:0.0.11'
     }
   }
 }

libs/gretty8-plugin/src/main/groovy/org/akhikhl/gretty8/GrettyPlugin.groovy

@@ -22,7 +22,7 @@ final class GrettyPlugin extends GrettyPluginBase {
   void injectDependencies(Project project) {
     project.dependencies {
       providedCompile 'javax.servlet:javax.servlet-api:3.0.1'
-      grettyHelperConfig 'org.akhikhl.gretty:gretty8-helper:0.0.10'
+      grettyHelperConfig 'org.akhikhl.gretty:gretty8-helper:0.0.11'
     }
   }
 }

libs/gretty9-plugin/src/main/groovy/org/akhikhl/gretty9/GrettyPlugin.groovy

@@ -22,7 +22,7 @@ class GrettyPlugin extends GrettyPluginBase {
   void injectDependencies(Project project) {
     project.dependencies {
       providedCompile 'javax.servlet:javax.servlet-api:3.1.0'
-      grettyHelperConfig 'org.akhikhl.gretty:gretty9-helper:0.0.10'
+      grettyHelperConfig 'org.akhikhl.gretty:gretty9-helper:0.0.11'
     }
   }
 }

pluginScripts/gretty7-0.0.11.plugin

@@ -0,0 +1,26 @@
+buildscript {
+
+  repositories {
+    mavenLocal()
+    mavenCentral()
+  }
+
+  apply plugin: 'maven'
+
+  dependencies {
+    classpath 'org.akhikhl.gretty:gretty7-plugin:0.0.11'
+  }
+}
+
+repositories {
+  mavenLocal()
+  mavenCentral()
+}
+
+apply plugin: 'java'
+apply plugin: 'war'
+
+if (!project.plugins.findPlugin(org.akhikhl.gretty7.GrettyPlugin))
+  project.apply(plugin: org.akhikhl.gretty7.GrettyPlugin)
+
+

pluginScripts/gretty8-0.0.11.plugin

@@ -0,0 +1,26 @@
+buildscript {
+
+  repositories {
+    mavenLocal()
+    mavenCentral()
+  }
+
+  apply plugin: 'maven'
+
+  dependencies {
+    classpath 'org.akhikhl.gretty:gretty8-plugin:0.0.11'
+  }
+}
+
+repositories {
+  mavenLocal()
+  mavenCentral()
+}
+
+apply plugin: 'java'
+apply plugin: 'war'
+
+if (!project.plugins.findPlugin(org.akhikhl.gretty8.GrettyPlugin))
+  project.apply(plugin: org.akhikhl.gretty8.GrettyPlugin)
+
+

pluginScripts/gretty9-0.0.11.plugin

@@ -0,0 +1,25 @@
+buildscript {
+
+  repositories {
+    mavenLocal()
+    mavenCentral()
+  }
+
+  apply plugin: 'maven'
+
+  dependencies {
+    classpath 'org.akhikhl.gretty:gretty9-plugin:0.0.11'
+  }
+}
+
+repositories {
+  mavenLocal()
+  mavenCentral()
+}
+
+apply plugin: 'java'
+apply plugin: 'war'
+
+if (!project.plugins.findPlugin(org.akhikhl.gretty9.GrettyPlugin))
+  project.apply(plugin: org.akhikhl.gretty9.GrettyPlugin)
+

whatsnew.md

@@ -2,7 +2,8 @@
 
 ### Version 0.0.11
 
-- Introduced plugin extension parameter "logbackConfigFile" (in response to [issue #6](https://github.com/akhikhl/gretty/issues/6) "Possibility to provide custom logback.xml or logback.groovy configuration")
+- Introduced plugin extension property ["logbackConfigFile"](README.md#logbackconfigfile)
+  (in response to [issue #6](https://github.com/akhikhl/gretty/issues/6) "Possibility to provide custom logback.xml or logback.groovy configuration")
 
 ### Version 0.0.10