------
 Usage
 ------
 Stephane Nicoll
 <snicoll@apache.org>
 Pete Marvin King
 ------
 2008-07-07
 ------

 ~~ 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.

 ~~ NOTE: For help with the syntax of this file, see:
 ~~ http://maven.apache.org/doxia/references/apt-format.html


Usage

 The EJB Plugin is used to package an EJB module. There are two ways to use the EJB Plugin:

 * If the packaging type defined in the <<<pom.xml>>> is <<<ejb>>>, the <<<package>>> lifecycle phase can be used

+--------------+
  mvn package
+--------------+

 * or using the <<<ejb:ejb>>> goal

+--------------+
  mvn ejb:ejb
+--------------+

 []

 The plugin doesn't do any EJB specific processing during the generation of the jar except for validating the existence
 of an EJB deployment descriptor if the EJB version is 2.0+, but it provides the following customization:

  * The EJB version to use

  * {{{examples/generating-ejb-client.html}Generating and customizing an ejb-client}}

 <<Note:>> The dependencies will not be package with the EJB jar.

* Specifying the EJB version to use

  In EJB3, the <<<ejb-jar.xml>>> deployment descriptor is not mandatory anymore. By default
  the plugin assumes version 2.1. To use another version, configure the plugin as follows:

+--------
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-ejb-plugin</artifactId>
        <version>${project.version}</version>
        <configuration>
          <ejbVersion>3.0</ejbVersion>
        </configuration>
      </plugin>
    </plugins>
  </build>
+---------