[logback-dev] [GIT] Logback: the generic, reliable, fast and flexible logging framework. branch master updated. v_0.9.30-62-gab6c1dd

Gitbot git-noreply at pixie.qos.ch
Sat Oct 29 10:40:55 CEST 2011


This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "Logback: the generic, reliable, fast and flexible logging framework.".

The branch, master has been updated
       via  ab6c1ddb8825e9e37a0250da5465bba5e34565b1 (commit)
      from  cefb859c2c1a93b2a2fcc46e45d8cfaf7b596bd1 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
http://git.qos.ch/gitweb/?p=logback.git;a=commit;h=ab6c1ddb8825e9e37a0250da5465bba5e34565b1
http://github.com/ceki/logback/commit/ab6c1ddb8825e9e37a0250da5465bba5e34565b1

commit ab6c1ddb8825e9e37a0250da5465bba5e34565b1
Author: Ceki Gulcu <ceki at qos.ch>
Date:   Sat Oct 29 10:40:35 2011 +0200

    editing

diff --git a/logback-site/src/site/pages/setup.html b/logback-site/src/site/pages/setup.html
index 899404f..4e63cdd 100644
--- a/logback-site/src/site/pages/setup.html
+++ b/logback-site/src/site/pages/setup.html
@@ -106,44 +106,65 @@
 
    <h3><a name="ide" href="#ide">Building with an IDE</a></h3>
    
-   <p>Certain logback test cases are written in Scala. Moreover,
-   logback offers a Groovy-based configurator. If you wish to hack
-   logback, you will probably want to import it as a project into your
-   favorite IDE.</p>
+   <p>If you wish to contribute to hack to the project or just hack it
+   for your own needs, you will probably want to import logback as a
+   project into your favorite IDE. Logback uses Maven as its build
+   tool. The Scala language is used in certain logback test
+   cases. Moreover, logback offers a Groovy-based configurator so
+   there is a dependency on the Groovy language as well. It follows
+   that your IDE should have plugins for Maven, Scala and Groovy in
+   order to <em>build</em> logback from your within IDE. The
+   Scala+Groovy dependecy just mentioned are <em>build-time</em>
+   dependencies. The only mandatory logback dependency at runrime is
+   the JRE, unless of course you wish to use the Groovy configurator
+   in which case Groovy runtime will be a required dependency as
+   well. Also note that building from the command line is fairly
+   trivial, the command 'mvn install' given from $LOGBACK_HOME folder
+   should suffice. </p>
 
    <h3>Building logback with IntelliJ IDEA</h3>
 
    <p>Assuming you have the latest version of IntelliJ IDEA installed,
-   you need add the Scala plugin. Once you have the Scala plugin
-   installed, you can import logback into IDEA. Select File -> New
-   Project -> Import from external model -> Maven, then select
-   $LOGBACK_HOME as the Root directory. The import should finish
-   successfully in a few seconds.</p>
+   the only required additional plugin is the Scala plugin. IntelliJ
+   IDEA supports Maven as well as Groovy out of the box. Once you have
+   the Scala plugin installed, you can import logback into
+   IDEA. Select File→ New Project → Import from external
+   model→ Maven, then select $LOGBACK_HOME as the Root
+   directory. The import should finish successfully in a few
+   seconds. If you import logback before the scala-plugin is
+   installed, you would need to re-import logback as a project after
+   the Scala plugin is installed.</p>
 
    <h3>Building with Eclipse</h3>
 
-   <p>Building logback is a little trickier. Here are step by step
-   instruction for building logback under Eclipse in 61 easy steps.
+   <p>Building logback under Eclipse is a little trickier. Here are
+   instructions for building logback under Eclipse in 61 easy steps.
    </p>
 
-   <p>It appears that the key to building logback under Eclipse is to
-   avoid using m2eclipse. If you have m2eclipse installed, you can
-   disable it by removing the Maven Nature for a given project.
+   <p>The author does not wish to unduly disparage
+   <code>m2eclipse</code>. However, as of this writing that is October
+   2011, it appears that the key to building logback under Eclipse is
+   to avoid using <code>m2eclipse</code>. If you have
+   <code>m2eclipse</code> installed, you can disable it by removing
+   the Maven Nature for a given project. And without further ado here
+   are the steps:
    </p>
+   
 
    <ol>
      <li>Install Eclipse Indigo, aka Eclipse 3.7</li>
      <li>in <em>eclipse.ini</em> file modify the parameter "mx",
      i.e. change -Xmx384m to -Xmx1384m</li>
 
-     <li>Select Help -> Intall new Software -> Work with <a
+     <li>In Eclipse, select Help → Intall new Software →
+     Work with <a
      href="http://dist.springsource.org/release/GRECLIPSE/e3.7/">http://dist.springsource.org/release/GRECLIPSE/e3.7/</a>
      and then Select "Groovy-Eclipse Feature". Installation of other
      plugins in particular "m2e Configurator for Groovy-Eclipse" is
      <b>not</b> necessary</li>
 
-     <li>Similar to the previous steps install Scala IDE for Eclipse
-     from <a
+     <li>Similar to the previous step, install Scala IDE for Eclipse
+     plugin from <a
      href="http://download.scala-ide.org/releases-29/2.0.0-beta">http://download.scala-ide.org/releases-29/2.0.0-beta</a>. Installation
      of "JDT Weaving" or "Scala IDE for Eclipse Source feature" are
      not necessary.</li>
@@ -154,34 +175,37 @@
      logback project from github </li>
 
      <li>In case they exist, remove <em>.settings</em>,
-     <em>.classpath</em>, <em>.project</em> directories (again if any)
+     <em>.classpath</em>, <em>.project</em> folders (again if any)
      under $LOGBACK_HOME and its sub-folders. Somehow, this step seems
      to be crucial.</li>
      
-     <li>Run 'mvn eclipse:eclipse' in $LOGBACK_HOME </li>
+     <li>From the command line, run <code>mvn eclipse:eclipse</code>
+     in $LOGBACK_HOME</li>
 
-     <li>In eclipse import the logback project: Import -> General ->
-     Existing Prokects into Workspace, select $LOGBACK_HOME folder for
-     the import
+     <li>In Eclipse, import the logback project: Import→
+     General→ Existing Prokects into Workspace, select
+     $LOGBACK_HOME folder for the import
      </li>   
 
-     
-     <li>add the scala nature to logback-core project: (right click on
-     logback-core project -> Configure -> Add Scala Nature) 
+    
+     <li>In Eclipse, add the scala nature to logback-core project:
+     (right click on logback-core project→ Configure→ Add
+     Scala Nature)
      </li>   
      
-     <li>remove the
+     <li>In Eclipse, remove the
      logback-classic/target/generated-sources/groovy-sttubs/main
-     directory from the list of source folders (logback-classic ->
-     project properties -> Java Build Path)
+     directory from the list of source folders (logback-classic→
+     project properties → Java Build Path)
      </li>   
 
-     <li>clean all projects in Eclipse (Project -> Clean) 
+     <li>In Eclipse, clean all projects in Eclipse (Project →
+     Clean)
      </li>   
 
-     <li>Select logback-classic project and convert it to "Groovy
-     project" (right click on logback-classic project -> Configure ->
-     Convert Groovy to Project)
+     <li>In Eclipse, select logback-classic project and convert it to
+     "Groovy project" (right click on logback-classic project →
+     Configure → Convert Groovy to Project)
      </li>   
      
    </ol>

-----------------------------------------------------------------------

Summary of changes:
 logback-site/src/site/pages/setup.html |   88 ++++++++++++++++++++------------
 1 files changed, 56 insertions(+), 32 deletions(-)


hooks/post-receive
-- 
Logback: the generic, reliable, fast and flexible logging framework.


More information about the logback-dev mailing list