/**
 *  Licensed to the Apache Software Foundation (ASF) under one or more
 *  contributor license agreements.  See the NOTICE file distributed with
 *  this work for additional information regarding copyright ownership.
 *  The ASF licenses this file to You under the Apache License, Version 2.0
 *  (the "License"); you may not use this file except in compliance with
 *  the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 */
==================================
J2G-Migration Package
==================================
Note: Please visit http://cwiki.apache.org/confluence/display/GMOxDOC11/J2G+Migration+Tool for more thorough documentation

JBoss to Geronimo (J2G) is a tool set built as command line Eclipse SDK plug-ins 
designed to assist in migrating the sources of an application written for the JBoss 
application server or written for Java 2 Enterprise Edition (J2EE) to the Apache 
Geronimo platform.

==================================
Dependencies
==================================
The J2G tool set requires at least the following application versions
(these are the versions J2G is known to work on)

    * Sun JDK 5.0+ (J2SE 1.5)
    * Eclipse SDK 3.3 with JDT Core Plug-in
    * Apache Geronimo 1.1.1 or 2.0.x
    * Application written for JBoss 3.2 and up or J2EE 1.2 and up.

==================================
Environment Variables
==================================
The tools in J2G require that the following environment variables be set to the proper 
locations:

    * JAVA_HOME (Location of the JDK)
    * ECLIPSE_HOME (Location of the Eclipse SDK)
    * WORKSPACE (Location for a temporary eclipse workspace)

==================================
1. Configurator
==================================
To run this component, navigate to bin, and run j2g-configure

This will automatically copy the contents of the ./plugins directory to ECLIPSE_HOME/plugins, 
as well as make changes (or create, if necessary) to ECLIPSE_HOME/configuration/config.ini.

==================================
2. Source Identification Tool
==================================
This tool parses through source code (.java and .jsp files) recursively in directories 
passed to it as command line arguments. While doing this, it replaces any JBoss classes 
and dependencies for which there are Geronimo equivalents. If there is no equivalent, it 
will alert the user of this issue which must be resolved either through manual creation 
of a replacement class or rewriting the segment of code dependent on the JBoss class.

 - Usage: jsrc2g -src <APPLICATION>\src -web <APPLICATION>\web -geronimo <GERONIMO_HOME>

==================================
3. Descriptors Conversion Tool
==================================
This tool converts JBoss specific deployment descriptors and J2EE standard deployment 
descriptors (if necessary) to their Geronimo equivalents.

 - Usage: jdesc2g <APPLICATION>

==================================
4. Resource Conversion Tool
==================================
This tool converts JBoss specific resources, such as Java Messaging Services (JMS) Queues, 
JMS Topics, Java Database Connectivity (JDBC) data sources to their Geronimo equivalents.

 - Usage: jres2g <APPLICATION>