add a beanshell mojo documentation

git-svn-id: https://svn.apache.org/repos/asf/maven/plugin-tools/trunk@1338357 13f79535-47bb-0310-9956-ffa450edef68

maven-plugin-plugin/src/site/apt/examples/beanshell-mojo.apt.vm

@@ -0,0 +1,71 @@
+ ------
+ Writing an Ant Maven plugin
+ ------
+ Olivier Lamy
+ ------
+ 2012-05-14
+ ------
+
+~~ 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
+
+Writing a Beanshell Maven plugin
+
+  You can write a Maven plugin using {{{http://www.beanshell.org}beanshell}}
+
+* Pom configuration
+
++------------------
+  <dependencies>
+    <dependency>
+      <groupId>bsh</groupId>
+      <artifactId>bsh</artifactId>
+      <version>1.3.0</version>
+    </dependency>
+    <dependency>
+      <groupId>org.apache.maven</groupId>
+      <artifactId>maven-script-beanshell</artifactId>
+      <version>2.2.1</version>
+    </dependency>
+  </dependencies>
+
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-plugin-plugin</artifactId>
+        <version>${project.version}</version>
+        <dependencies>
+          <dependency>
+            <groupId>org.apache.maven.plugin-tools</groupId>
+            <artifactId>maven-plugin-tools-beanshell</artifactId>
+            <version>${project.version}</version>
+          </dependency>
+        </dependencies>
+      </plugin>
+    </plugins>
+  </build>
++------------------
+
+* Beanshell plugin
+
+ Sample of script content. Use same doclet as a Java plugin with doclet
+
+%{snippet|id=beanshell-mojo|url=http://svn.apache.org/repos/asf/maven/plugin-tools/trunk/maven-plugin-plugin/src/it/beanshell-simple/src/main/scripts/touch.bsh}

maven-plugin-plugin/src/site/site.xml

@@ -60,6 +60,8 @@ under the License.
       <item name="Configuring Generation of Plugin Descriptor" href="/examples/generate-descriptor.html"/>
       <item name="Configuring Generation of Plugin Documentation" href="/examples/generate-report.html"/>
       <item name="Configuring Generation of HelpMojo" href="/examples/generate-help.html"/>
+      <item name="Ant Mojo" href="/examples/ant-mojo.html"/>
+      <item name="Beanshell Mojo" href="/examples/beanshell-mojo.html"/>
     </menu>
 
     <menu name="Developers">