From 4db8f4cdc3bc5e2fdfe3281c275b5298669234b3 Mon Sep 17 00:00:00 2001
From: "Jesse N. Glick" <jglick@apache.org>
Date: Wed, 22 Feb 2012 15:42:23 +0000
Subject: [PATCH] Finally documented SimpleBigProjectLogger properly.

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@1292354 13f79535-47bb-0310-9956-ffa450edef68
---
 manual/listeners.html | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/manual/listeners.html b/manual/listeners.html
index 2f5e5750b..4f04724f1 100644
--- a/manual/listeners.html
+++ b/manual/listeners.html
@@ -115,6 +115,11 @@ listeners and loggers.</p>
     <td width="33%">Prints the project name every target</td>
     <td width="34%">BuildLogger</td>
   </tr>
+  <tr>
+    <td width="33%"><code><a href="#SimpleBigProjectLogger">org.apache.tools.ant.listener.SimpleBigProjectLogger</a></code></td>
+    <td width="33%">Prints the project name for subprojects only, otherwise like NoBannerLogger <em>Since Ant 1.8.1</em></td>
+    <td width="34%">BuildLogger</td>
+  </tr>
   <tr>
     <td width="33%"><code><a href="#ProfileLogger">org.apache.tools.ant.listener.ProfileLogger</a></code></td>
     <td width="33%">The default logger, with start times, end times and
@@ -482,7 +487,35 @@ Exiting project "junit"
 <code>ant  -logger org.apache.tools.ant.listener.BigProjectLogger</code>
 </blockquote>
 
+<h3><a name="SimpleBigProjectLogger">SimpleBigProjectLogger</a></h3>
+<p>Like <code>BigProjectLogger</code>, project-qualified target names are printed,
+useful for big builds with subprojects.
+Otherwise it is as quiet as <code>NoBannerLogger</code>:</p>
+<pre>
+Buildfile: /sources/myapp/build.xml
+
+myapp-lib.compile:
+Created dir: /sources/myapp/lib/build/classes
+Compiling 1 source file to /sources/myapp/lib/build/classes
+
+myapp-lib.jar:
+Building jar: /sources/myapp/lib/build/lib.jar
+
+myapp.compile:
+Created dir: /sources/myapp/build/classes
+Compiling 2 source files to /sources/myapp/build/classes
 
+myapp.jar:
+Building jar: /sources/myapp/build/myapp.jar
+
+BUILD SUCCESSFUL
+Total time: 1 second
+</pre>
+<p><b>since Ant 1.8.1</b></p>
+<p>To use this listener, use the command:</p>
+<blockquote>
+<code>ant -logger org.apache.tools.ant.listener.SimpleBigProjectLogger</code>
+</blockquote>
 
 <h3><a name="ProfileLogger">ProfileLogger</a></h3>
 <p>This logger stores the time needed for executing a task, target and the whole build and prints