You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@karaf.apache.org by jb...@apache.org on 2013/05/19 11:53:13 UTC
svn commit: r1484249 [13/21] - in /karaf/site/production/manual/latest: ./
commands/ developers-guide/ users-guide/
Modified: karaf/site/production/manual/latest/developers-guide/developer-commands.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/developers-guide/developer-commands.html?rev=1484249&r1=1484248&r2=1484249&view=diff
==============================================================================
--- karaf/site/production/manual/latest/developers-guide/developer-commands.html (original)
+++ karaf/site/production/manual/latest/developers-guide/developer-commands.html Sun May 19 09:53:10 2013
@@ -93,7 +93,7 @@
<div id="wrapper-menu-page-top">
<div id="wrapper-menu-page-bottom">
<div id="menu-page">
- <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="../users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="../users-guide/installation.html">Installing Karaf</a></li><li><a href="../users-guide/directory-structure.html">Directory Structure</a></li><li><a href="../users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="../users-guide/wrapper.html">OS integration</a></li><li><a href="../users-guide/configuration.html">Configuration</a></li><li><a href="../users-guide/using-console.html">Using the console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><li><a href="../users-guide/remote-console.html">Remote console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><
li><a href="../users-guide/deployer.html">Deployer</a></li><li><a href="../users-guide/child-instances.html">Child instances</a></li><li><a href="../users-guide/security.html">Security</a></li><li><a href="../users-guide/failover.html">Failover Deployments</a></li><li><a href="../users-guide/logging-system.html">Logging system</a></li><li><a href="../users-guide/provisioning.html">Provisioning</a></li><li><a href="../users-guide/kar.html">KAR archive</a></li><li><a href="../users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="../users-guide/web-applications.html">Web applications</a></li><li><a href="../users-guide/http.html">HTTP service</a></li><li><a href="../users-guide/jmx.html">JMX for monitoring and administration</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="connect-console.html">Programmatically connect to the Console</a></li><li><a href="shell-syntax.html">
Shell syntax</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developer-command.html">Developer Commands</a></li><li><a href="archetypes.html">Maven Archetypes</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="branding-console.html">Branding the Console</a></li><li><a href="karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li><li><a href="github-contribut
ions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3>
+ <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="../users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="../users-guide/installation.html">Installing Karaf</a></li><li><a href="../users-guide/directory-structure.html">Directory Structure</a></li><li><a href="../users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="../users-guide/wrapper.html">OS integration</a></li><li><a href="../users-guide/configuration.html">Configuration</a></li><li><a href="../users-guide/using-console.html">Using the console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><li><a href="../users-guide/remote-console.html">Remote console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><
li><a href="../users-guide/deployer.html">Deployer</a></li><li><a href="../users-guide/child-instances.html">Child instances</a></li><li><a href="../users-guide/security.html">Security</a></li><li><a href="../users-guide/failover.html">Failover Deployments</a></li><li><a href="../users-guide/logging-system.html">Logging system</a></li><li><a href="../users-guide/provisioning.html">Provisioning</a></li><li><a href="../users-guide/kar.html">KAR archive</a></li><li><a href="../users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="../users-guide/web-applications.html">Web applications</a></li><li><a href="../users-guide/http.html">HTTP service</a></li><li><a href="../users-guide/jmx.html">JMX for monitoring and administration</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="connect-console.html">Programmatically connect to the Console</a></li><li><a href="shell-syntax.html">
Shell syntax</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developer-commands.html">Developer Commands</a></li><li><a href="archetypes.html">Maven Archetypes</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="branding-console.html">Branding the Console</a></li><li><a href="karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li><li><a href="github-contribu
tions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3>
</div>
</div>
</div>
Modified: karaf/site/production/manual/latest/developers-guide/extending-console.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/developers-guide/extending-console.html?rev=1484249&r1=1484248&r2=1484249&view=diff
==============================================================================
--- karaf/site/production/manual/latest/developers-guide/extending-console.html (original)
+++ karaf/site/production/manual/latest/developers-guide/extending-console.html Sun May 19 09:53:10 2013
@@ -93,7 +93,7 @@
<div id="wrapper-menu-page-top">
<div id="wrapper-menu-page-bottom">
<div id="menu-page">
- <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="../users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="../users-guide/installation.html">Installing Karaf</a></li><li><a href="../users-guide/directory-structure.html">Directory Structure</a></li><li><a href="../users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="../users-guide/wrapper.html">OS integration</a></li><li><a href="../users-guide/configuration.html">Configuration</a></li><li><a href="../users-guide/using-console.html">Using the console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><li><a href="../users-guide/remote-console.html">Remote console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><
li><a href="../users-guide/deployer.html">Deployer</a></li><li><a href="../users-guide/child-instances.html">Child instances</a></li><li><a href="../users-guide/security.html">Security</a></li><li><a href="../users-guide/failover.html">Failover Deployments</a></li><li><a href="../users-guide/logging-system.html">Logging system</a></li><li><a href="../users-guide/provisioning.html">Provisioning</a></li><li><a href="../users-guide/kar.html">KAR archive</a></li><li><a href="../users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="../users-guide/web-applications.html">Web applications</a></li><li><a href="../users-guide/http.html">HTTP service</a></li><li><a href="../users-guide/jmx.html">JMX for monitoring and administration</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="connect-console.html">Programmatically connect to the Console</a></li><li><a href="shell-syntax.html">
Shell syntax</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developer-command.html">Developer Commands</a></li><li><a href="archetypes.html">Maven Archetypes</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="branding-console.html">Branding the Console</a></li><li><a href="karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li><li><a href="github-contribut
ions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3>
+ <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="../users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="../users-guide/installation.html">Installing Karaf</a></li><li><a href="../users-guide/directory-structure.html">Directory Structure</a></li><li><a href="../users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="../users-guide/wrapper.html">OS integration</a></li><li><a href="../users-guide/configuration.html">Configuration</a></li><li><a href="../users-guide/using-console.html">Using the console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><li><a href="../users-guide/remote-console.html">Remote console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><
li><a href="../users-guide/deployer.html">Deployer</a></li><li><a href="../users-guide/child-instances.html">Child instances</a></li><li><a href="../users-guide/security.html">Security</a></li><li><a href="../users-guide/failover.html">Failover Deployments</a></li><li><a href="../users-guide/logging-system.html">Logging system</a></li><li><a href="../users-guide/provisioning.html">Provisioning</a></li><li><a href="../users-guide/kar.html">KAR archive</a></li><li><a href="../users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="../users-guide/web-applications.html">Web applications</a></li><li><a href="../users-guide/http.html">HTTP service</a></li><li><a href="../users-guide/jmx.html">JMX for monitoring and administration</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="connect-console.html">Programmatically connect to the Console</a></li><li><a href="shell-syntax.html">
Shell syntax</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developer-commands.html">Developer Commands</a></li><li><a href="archetypes.html">Maven Archetypes</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="branding-console.html">Branding the Console</a></li><li><a href="karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li><li><a href="github-contribu
tions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3>
</div>
</div>
</div>
@@ -115,94 +115,13 @@ Define value for groupId: : org.apache.k
Define value for artifactId: : shell-sample-commands
Define value for version: 1.0-SNAPSHOT: :
Define value for package: : org.apache.karaf.shell.samples
-</pre><h3 id="Manualcreation">Manual creation</h3><p>Alternatively, you can simply create the directory <tt>shell-sample-commands</tt> and create the <tt>pom.xml</tt> file inside it:</p><div class="syntax"><pre name='code' class='brush: xml; gutter: false;'><code>
-<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
-
- <modelVersion>4.0.0</modelVersion>
-
- <groupId>org.apache.karaf.shell.samples</groupId>
- <artifactId>shell-sample-commands<artifactId>
- <packaging>bundle</packaging>
- <version>1.0-SNAPSHOT</version>
- <name>shell-sample-commmands</name>
-
-
- <dependencies>
- <dependency>
- <groupId>org.apache.karaf.shell</groupId>
- <artifactId>org.apache.karaf.shell.console</artifactId>
- <version>3.0.0-SNAPSHOT</version>
- </dependency>
- <dependency>
- <groupId>junit</groupId>
- <artifactId>junit</artifactId>
- <version>3.8.1</version>
- <scope>test</scope>
- </dependency>
- </dependencies>
-
- <build>
- <plugins>
- <plugin>
- <groupId>org.apache.felix</groupId>
- <artifactId>maven-bundle-plugin</artifactId>
- <version>2.3.7</version>
- <configuration>
- <instructions>
- <Import-Package>
- org.apache.felix.service.command,
- org.apache.karaf.shell.commands,
- org.apache.karaf.shell.console,
- *
- </Import-Package>
- </instructions>
- </configuration>
- </plugin>
- </plugins>
- </build>
-
-</project></code></pre></div><h2 id="ConfiguringforJava6">Configuring for Java 6</h2><p>We are using annotations to define commands, so we need to ensure Maven will actually use JDK 1.6 to compile the jar.<br/>Just add the following snippet after the <tt>dependencies</tt> section.</p><div class="syntax"><pre name='code' class='brush: xml; gutter: false;'><code>
-<build>
- <plugins>
- <plugin>
- <groupId>org.apache.maven.plugins</groupId>
- <artifactId>maven-compiler-plugin</artifactId>
- <configuration>
- <target>1.6</target>
- <source>1.6</source>
- </configuration>
- </plugin>
- </plugins>
-</build></code></pre></div><h2 id="LoadingtheprojectinyourIDE">Loading the project in your IDE</h2><p>We can use Maven to generate the needed files for your IDE:</p><p>Inside the project, run the following command</p><pre>
+</pre><h3 id="Manualcreation">Manual creation</h3><p>Alternatively, you can simply create the directory <tt>shell-sample-commands</tt> and create the <tt>pom.xml</tt> file inside it:</p><div class="syntax"><div class="highlight"><pre><span class="nt"><project</span> <span class="na">xmlns=</span><span class="s">"http://maven.apache.org/POM/4.0.0"</span> <span class="na">xmlns:xsi=</span><span class="s">"http://www.w3.org/2001/XMLSchema-instance"</span> <span class="na">xsi:schemaLocation=</span><span class="s">"http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"</span><span class="nt">></span>

 <span class="nt"><modelVersion></span>4.0.0<span class="nt"></modelVersion></span>

 <span class="nt"><groupId></span>org.apache.karaf.shell.samples<span class="nt"></groupId></span>
 <span class="nt"><artifactId></span>shell-sample-commands<span class="n
t"><artifactId></span>
 <span class="nt"><packaging></span>bundle<span class="nt"></packaging></span>
 <span class="nt"><version></span>1.0-SNAPSHOT<span class="nt"></version></span>
 <span class="nt"><name></span>shell-sample-commmands<span class="nt"></name></span>


 <span class="nt"><dependencies></span>
 <span class="nt"><dependency></span>
 <span class="nt"><groupId></span>org.apache.karaf.shell<span class="nt"></groupId></span>
 <span class="nt"><artifactId></span>org.apache.karaf.shell.console<span class="nt"></artifactId></span>
 <span class="nt"><version></span>3.0.0-SNAPSHOT<span class="nt"></version></span>
 <span class="nt"></dependency></span>
 <span class="nt"><dependency></span>
 <span class="nt"><groupId></span>junit<span class="n
t"></groupId></span>
 <span class="nt"><artifactId></span>junit<span class="nt"></artifactId></span>
 <span class="nt"><version></span>3.8.1<span class="nt"></version></span>
 <span class="nt"><scope></span>test<span class="nt"></scope></span>
 <span class="nt"></dependency></span>
 <span class="nt"></dependencies></span>

 <span class="nt"><build></span>
 <span class="nt"><plugins></span>
 <span class="nt"><plugin></span>
 <span class="nt"><groupId></span>org.apache.felix<span class="nt"></groupId></span>
 <span class="nt"><artifactId></span>maven-bundle-plugin<span class="nt"></artifactId></span>
 <span class="nt"><version></span>2.3.7<span class="nt"></version></span>
 <span class="nt"><configuration></span>

<span class="nt"><instructions></span>
 <span class="nt"><Import-Package></span>
 org.apache.felix.service.command,
 org.apache.karaf.shell.commands,
 org.apache.karaf.shell.console,
 *
 <span class="nt"></Import-Package></span>
 <span class="nt"></instructions></span>
 <span class="nt"></configuration></span>
 <span class="nt"></plugin></span>
 <span class="nt"></plugins></span>
 <span class="nt"></build></span>

<span class="nt"></project></span>
</pre></div>
</div><h2 id="ConfiguringforJava6">Configuring for Java 6</h2><p>We are using annotations to define commands, so we need to ensure Maven will actually use JDK 1.6 to compile the jar.<br/>Just add the following snippet after the <tt>dependencies</tt> secti
on.</p><div class="syntax"><div class="highlight"><pre><span class="nt"><build></span>
 <span class="nt"><plugins></span>
 <span class="nt"><plugin></span>
 <span class="nt"><groupId></span>org.apache.maven.plugins<span class="nt"></groupId></span>
 <span class="nt"><artifactId></span>maven-compiler-plugin<span class="nt"></artifactId></span>
 <span class="nt"><configuration></span>
 <span class="nt"><target></span>1.6<span class="nt"></target></span>
 <span class="nt"><source></span>1.6<span class="nt"></source></span>
 <span class="nt"></configuration></span>
 <span class="nt"></plugin></span>
 <span class="nt"></plugins></span>
<span class="nt"></build></span>
</pre></div>
</div><h2 id="LoadingtheprojectinyourIDE">Loading the project in your IDE</
h2><p>We can use Maven to generate the needed files for your IDE:</p><p>Inside the project, run the following command</p><pre>
mvn eclipse:eclipse
</pre><p>or</p><pre>
mvn idea:idea
-</pre><p>The project files for your IDE should now be created. Just open the IDE and load the project.</p><h2 id="Creatingabasiccommandclass">Creating a basic command class</h2><p>We can now create the command class <tt>HelloShellCommand.java</tt></p><div class="syntax"><pre name='code' class='brush: java; gutter: false;'><code>
-package org.apache.karaf.shell.samples;
-
-import Command;
-import org.apache.karaf.shell.console.OsgiCommandSupport;
-
-@Command(scope = "test", name = "hello", description="Says hello")
-public class HelloShellCommand extends OsgiCommandSupport {
-
- @Override
- protected Object doExecute() throws Exception {
- System.out.println("Executing Hello command");
- return null;
- }
-}</code></pre></div><h2 id="Creatingtheassociatedblueprintconfigurationfiles">Creating the associated blueprint configuration files</h2><p>The blueprint configuration file will be used to create the command and register it in the OSGi registry, which is the way to make the command available to Karaf console. This blueprint file must be located in the <tt>OSGI-INF/blueprint/</tt> directory inside the bundle.</p><p>If you don't have the <tt>src/main/resources</tt> directory yet, create it.</p><pre>
+</pre><p>The project files for your IDE should now be created. Just open the IDE and load the project.</p><h2 id="Creatingabasiccommandclass">Creating a basic command class</h2><p>We can now create the command class <tt>HelloShellCommand.java</tt></p><div class="syntax"><div class="highlight"><pre><span class="kn">package</span> <span class="n">org</span><span class="o">.</span><span class="na">apache</span><span class="o">.</span><span class="na">karaf</span><span class="o">.</span><span class="na">shell</span><span class="o">.</span><span class="na">samples</span><span class="o">;</span>

<span class="kn">import</span> <span class="nn">Command</span><span class="o">;</span>
<span class="kn">import</span> <span class="nn">org.apache.karaf.shell.console.OsgiCommandSupport</span><span class="o">;</span>

<span class="nd">@Command</span><span class="o">(</span><span class="n">scope</span> <span class="o">=</span> <span class="s">"test&q
uot;</span><span class="o">,</span> <span class="n">name</span> <span class="o">=</span> <span class="s">"hello"</span><span class="o">,</span> <span class="n">description</span><span class="o">=</span><span class="s">"Says hello"</span><span class="o">)</span>
<span class="kd">public</span> <span class="kd">class</span> <span class="nc">HelloShellCommand</span> <span class="kd">extends</span> <span class="n">OsgiCommandSupport</span> <span class="o">{</span>

 <span class="nd">@Override</span>
 <span class="kd">protected</span> <span class="n">Object</span> <span class="nf">doExecute</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">Exception</span> <span class="o">{</span>
 <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Executing Hello command&qu
ot;</span><span class="o">);</span>
 <span class="k">return</span> <span class="kc">null</span><span class="o">;</span>
 <span class="o">}</span>
<span class="o">}</span>
</pre></div>
</div><h2 id="Creatingtheassociatedblueprintconfigurationfiles">Creating the associated blueprint configuration files</h2><p>The blueprint configuration file will be used to create the command and register it in the OSGi registry, which is the way to make the command available to Karaf console. This blueprint file must be located in the <tt>OSGI-INF/blueprint/</tt> directory inside the bundle.</p><p>If you don't have the <tt>src/main/resources</tt> directory yet, create it.</p><pre>
mkdir src/main/resources
-</pre><p>Then, re-generate the IDE project files and reload it so that this folder is now recognized as a source folder.</p><p>Inside this directory, create the <tt>OSGI-INF/blueprint/</tt> directory and put the following file inside (the name of this file has no impact at all):</p><div class="syntax"><pre name='code' class='brush: xml; gutter: false;'><code>
-<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0">
-
- <command-bundle xmlns="http://karaf.apache.org/xmlns/shell/v1.1.0">
- <command>
- <action class="org.apache.karaf.shell.samples.HelloShellCommand"/>
- </command>
- </command-bundle>
-
-</blueprint></code></pre></div><h2 id="Compilingthejar">Compiling the jar</h2><p>Let's try to build the jar. Remove the test classes and sample classes if you used the artifact, then from the command line, run:</p><pre>
+</pre><p>Then, re-generate the IDE project files and reload it so that this folder is now recognized as a source folder.</p><p>Inside this directory, create the <tt>OSGI-INF/blueprint/</tt> directory and put the following file inside (the name of this file has no impact at all):</p><div class="syntax"><div class="highlight"><pre><span class="nt"><blueprint</span> <span class="na">xmlns=</span><span class="s">"http://www.osgi.org/xmlns/blueprint/v1.0.0"</span><span class="nt">></span>

 <span class="nt"><command-bundle</span> <span class="na">xmlns=</span><span class="s">"http://karaf.apache.org/xmlns/shell/v1.1.0"</span><span class="nt">></span>
 <span class="nt"><command></span>
 <span class="nt"><action</span> <span class="na">class=</span><span class="s">"org.apache.karaf.shell.samples.HelloShellCommand"</span><span class="nt">/></span>
 <span class="nt">&l
t;/command></span>
 <span class="nt"></command-bundle></span>

<span class="nt"></blueprint></span>
</pre></div>
</div><h2 id="Compilingthejar">Compiling the jar</h2><p>Let's try to build the jar. Remove the test classes and sample classes if you used the artifact, then from the command line, run:</p><pre>
mvn install
</pre><p>The end of the maven output should look like:</p><pre>
[INFO] ------------------------------------------------------------------------
Modified: karaf/site/production/manual/latest/developers-guide/github-contributions.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/developers-guide/github-contributions.html?rev=1484249&r1=1484248&r2=1484249&view=diff
==============================================================================
--- karaf/site/production/manual/latest/developers-guide/github-contributions.html (original)
+++ karaf/site/production/manual/latest/developers-guide/github-contributions.html Sun May 19 09:53:10 2013
@@ -93,7 +93,7 @@
<div id="wrapper-menu-page-top">
<div id="wrapper-menu-page-bottom">
<div id="menu-page">
- <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="../users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="../users-guide/installation.html">Installing Karaf</a></li><li><a href="../users-guide/directory-structure.html">Directory Structure</a></li><li><a href="../users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="../users-guide/wrapper.html">OS integration</a></li><li><a href="../users-guide/configuration.html">Configuration</a></li><li><a href="../users-guide/using-console.html">Using the console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><li><a href="../users-guide/remote-console.html">Remote console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><
li><a href="../users-guide/deployer.html">Deployer</a></li><li><a href="../users-guide/child-instances.html">Child instances</a></li><li><a href="../users-guide/security.html">Security</a></li><li><a href="../users-guide/failover.html">Failover Deployments</a></li><li><a href="../users-guide/logging-system.html">Logging system</a></li><li><a href="../users-guide/provisioning.html">Provisioning</a></li><li><a href="../users-guide/kar.html">KAR archive</a></li><li><a href="../users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="../users-guide/web-applications.html">Web applications</a></li><li><a href="../users-guide/http.html">HTTP service</a></li><li><a href="../users-guide/jmx.html">JMX for monitoring and administration</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="connect-console.html">Programmatically connect to the Console</a></li><li><a href="shell-syntax.html">
Shell syntax</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developer-command.html">Developer Commands</a></li><li><a href="archetypes.html">Maven Archetypes</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="branding-console.html">Branding the Console</a></li><li><a href="karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li><li><a href="github-contribut
ions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3>
+ <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="../users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="../users-guide/installation.html">Installing Karaf</a></li><li><a href="../users-guide/directory-structure.html">Directory Structure</a></li><li><a href="../users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="../users-guide/wrapper.html">OS integration</a></li><li><a href="../users-guide/configuration.html">Configuration</a></li><li><a href="../users-guide/using-console.html">Using the console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><li><a href="../users-guide/remote-console.html">Remote console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><
li><a href="../users-guide/deployer.html">Deployer</a></li><li><a href="../users-guide/child-instances.html">Child instances</a></li><li><a href="../users-guide/security.html">Security</a></li><li><a href="../users-guide/failover.html">Failover Deployments</a></li><li><a href="../users-guide/logging-system.html">Logging system</a></li><li><a href="../users-guide/provisioning.html">Provisioning</a></li><li><a href="../users-guide/kar.html">KAR archive</a></li><li><a href="../users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="../users-guide/web-applications.html">Web applications</a></li><li><a href="../users-guide/http.html">HTTP service</a></li><li><a href="../users-guide/jmx.html">JMX for monitoring and administration</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="connect-console.html">Programmatically connect to the Console</a></li><li><a href="shell-syntax.html">
Shell syntax</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developer-commands.html">Developer Commands</a></li><li><a href="archetypes.html">Maven Archetypes</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="branding-console.html">Branding the Console</a></li><li><a href="karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li><li><a href="github-contribu
tions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3>
</div>
</div>
</div>
Modified: karaf/site/production/manual/latest/developers-guide/index.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/developers-guide/index.html?rev=1484249&r1=1484248&r2=1484249&view=diff
==============================================================================
--- karaf/site/production/manual/latest/developers-guide/index.html (original)
+++ karaf/site/production/manual/latest/developers-guide/index.html Sun May 19 09:53:10 2013
@@ -93,7 +93,7 @@
<div id="wrapper-menu-page-top">
<div id="wrapper-menu-page-bottom">
<div id="menu-page">
- <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="../users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="../users-guide/installation.html">Installing Karaf</a></li><li><a href="../users-guide/directory-structure.html">Directory Structure</a></li><li><a href="../users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="../users-guide/wrapper.html">OS integration</a></li><li><a href="../users-guide/configuration.html">Configuration</a></li><li><a href="../users-guide/using-console.html">Using the console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><li><a href="../users-guide/remote-console.html">Remote console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><
li><a href="../users-guide/deployer.html">Deployer</a></li><li><a href="../users-guide/child-instances.html">Child instances</a></li><li><a href="../users-guide/security.html">Security</a></li><li><a href="../users-guide/failover.html">Failover Deployments</a></li><li><a href="../users-guide/logging-system.html">Logging system</a></li><li><a href="../users-guide/provisioning.html">Provisioning</a></li><li><a href="../users-guide/kar.html">KAR archive</a></li><li><a href="../users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="../users-guide/web-applications.html">Web applications</a></li><li><a href="../users-guide/http.html">HTTP service</a></li><li><a href="../users-guide/jmx.html">JMX for monitoring and administration</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="connect-console.html">Programmatically connect to the Console</a></li><li><a href="shell-syntax.html">
Shell syntax</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developer-command.html">Developer Commands</a></li><li><a href="archetypes.html">Maven Archetypes</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="branding-console.html">Branding the Console</a></li><li><a href="karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li><li><a href="github-contribut
ions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3>
+ <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="../users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="../users-guide/installation.html">Installing Karaf</a></li><li><a href="../users-guide/directory-structure.html">Directory Structure</a></li><li><a href="../users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="../users-guide/wrapper.html">OS integration</a></li><li><a href="../users-guide/configuration.html">Configuration</a></li><li><a href="../users-guide/using-console.html">Using the console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><li><a href="../users-guide/remote-console.html">Remote console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><
li><a href="../users-guide/deployer.html">Deployer</a></li><li><a href="../users-guide/child-instances.html">Child instances</a></li><li><a href="../users-guide/security.html">Security</a></li><li><a href="../users-guide/failover.html">Failover Deployments</a></li><li><a href="../users-guide/logging-system.html">Logging system</a></li><li><a href="../users-guide/provisioning.html">Provisioning</a></li><li><a href="../users-guide/kar.html">KAR archive</a></li><li><a href="../users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="../users-guide/web-applications.html">Web applications</a></li><li><a href="../users-guide/http.html">HTTP service</a></li><li><a href="../users-guide/jmx.html">JMX for monitoring and administration</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="connect-console.html">Programmatically connect to the Console</a></li><li><a href="shell-syntax.html">
Shell syntax</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developer-commands.html">Developer Commands</a></li><li><a href="archetypes.html">Maven Archetypes</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="branding-console.html">Branding the Console</a></li><li><a href="karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li><li><a href="github-contribu
tions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3>
</div>
</div>
</div>
Modified: karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-commands-generate-help.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-commands-generate-help.html?rev=1484249&r1=1484248&r2=1484249&view=diff
==============================================================================
--- karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-commands-generate-help.html (original)
+++ karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-commands-generate-help.html Sun May 19 09:53:10 2013
@@ -93,7 +93,7 @@
<div id="wrapper-menu-page-top">
<div id="wrapper-menu-page-bottom">
<div id="menu-page">
- <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="../users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="../users-guide/installation.html">Installing Karaf</a></li><li><a href="../users-guide/directory-structure.html">Directory Structure</a></li><li><a href="../users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="../users-guide/wrapper.html">OS integration</a></li><li><a href="../users-guide/configuration.html">Configuration</a></li><li><a href="../users-guide/using-console.html">Using the console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><li><a href="../users-guide/remote-console.html">Remote console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><
li><a href="../users-guide/deployer.html">Deployer</a></li><li><a href="../users-guide/child-instances.html">Child instances</a></li><li><a href="../users-guide/security.html">Security</a></li><li><a href="../users-guide/failover.html">Failover Deployments</a></li><li><a href="../users-guide/logging-system.html">Logging system</a></li><li><a href="../users-guide/provisioning.html">Provisioning</a></li><li><a href="../users-guide/kar.html">KAR archive</a></li><li><a href="../users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="../users-guide/web-applications.html">Web applications</a></li><li><a href="../users-guide/http.html">HTTP service</a></li><li><a href="../users-guide/jmx.html">JMX for monitoring and administration</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="connect-console.html">Programmatically connect to the Console</a></li><li><a href="shell-syntax.html">
Shell syntax</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developer-command.html">Developer Commands</a></li><li><a href="archetypes.html">Maven Archetypes</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="branding-console.html">Branding the Console</a></li><li><a href="karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li><li><a href="github-contribut
ions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3>
+ <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="../users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="../users-guide/installation.html">Installing Karaf</a></li><li><a href="../users-guide/directory-structure.html">Directory Structure</a></li><li><a href="../users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="../users-guide/wrapper.html">OS integration</a></li><li><a href="../users-guide/configuration.html">Configuration</a></li><li><a href="../users-guide/using-console.html">Using the console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><li><a href="../users-guide/remote-console.html">Remote console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><
li><a href="../users-guide/deployer.html">Deployer</a></li><li><a href="../users-guide/child-instances.html">Child instances</a></li><li><a href="../users-guide/security.html">Security</a></li><li><a href="../users-guide/failover.html">Failover Deployments</a></li><li><a href="../users-guide/logging-system.html">Logging system</a></li><li><a href="../users-guide/provisioning.html">Provisioning</a></li><li><a href="../users-guide/kar.html">KAR archive</a></li><li><a href="../users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="../users-guide/web-applications.html">Web applications</a></li><li><a href="../users-guide/http.html">HTTP service</a></li><li><a href="../users-guide/jmx.html">JMX for monitoring and administration</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="connect-console.html">Programmatically connect to the Console</a></li><li><a href="shell-syntax.html">
Shell syntax</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developer-commands.html">Developer Commands</a></li><li><a href="archetypes.html">Maven Archetypes</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="branding-console.html">Branding the Console</a></li><li><a href="karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li><li><a href="github-contribu
tions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3>
</div>
</div>
</div>
@@ -101,31 +101,7 @@
</td>
<td height="100%" width="100%">
<div class="wiki-content">
-<h2 id="Goalkarafcommandsgeneratehelp">Goal <tt>karaf:commands-generate-help</tt></h2><p>The <tt>karaf:commands-generate-help</tt> goal generates documentation containing Karaf commands help.</p><p>It looks for Karaf commands in the current project class loader and generates the help as displayed with the --help<br/>option in the Karaf shell console.</p><h3 id="Example">Example</h3><p>The example below generates help for the commands in the current project:</p><div class="syntax"><pre name='code' class='brush: xml; gutter: false;'><code>
-<project>
- <build>
- <plugins>
- <plugin>
- <groupId>org.apache.karaf.tooling</groupId>
- <artifactId>karaf-maven-plugin</artifactId>
- <version>3.0.0-SNAPSHOT</version>
-
- <executions>
- <execution>
- <id>document-commands</id>
- <phase>generate-resources</phase>
- <goals>
- <goal>commands-generate-help</goal>
- </goals>
- <configuration>
- <targetFolder>/home/jbonofre/workspace/karaf/karaf/manual/target/docbook/sources</targetFolder>
- </configuration>
- </execution>
- </executions>
- </plugin>
- </plugins>
- </build>
-</project></code></pre></div><h3 id="Parameters">Parameters</h3><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Name </th><th class="confluenceTh"> Type </th><th class="confluenceTh"> Description </th></tr><tr><td class="confluenceTd"> <tt>targetFolder</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> The directory where the documentation output files are to be generated <br/> Default value: /home/jbonofre/workspace/karaf/karaf/manual/target/docbkx/sources </td></tr><tr><td class="confluenceTd"> <tt>format</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> The output format (docbx or conf) of the commands documentation. <br/> Default value: docbx </td></tr><tr><td class="confluenceTd"> <tt>classLoader</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> The class loader to use in loading the commands. <br/> Default value: $ </td></tr></table
></div>
+<h2 id="Goalkarafcommandsgeneratehelp">Goal <tt>karaf:commands-generate-help</tt></h2><p>The <tt>karaf:commands-generate-help</tt> goal generates documentation containing Karaf commands help.</p><p>It looks for Karaf commands in the current project class loader and generates the help as displayed with the --help<br/>option in the Karaf shell console.</p><h3 id="Example">Example</h3><p>The example below generates help for the commands in the current project:</p><div class="syntax"><div class="highlight"><pre><span class="nt"><project></span>
 <span class="nt"><build></span>
 <span class="nt"><plugins></span>
 <span class="nt"><plugin></span>
 <span class="nt"><groupId></span>org.apache.karaf.tooling<span class="nt"></groupId></span>
 <span class="nt"><artifactId></span>karaf-maven-plugin<span class="nt"></artifactId></span>
 <span class="nt"><version><
/span>3.0.0-SNAPSHOT<span class="nt"></version></span>

 <span class="nt"><executions></span>
 <span class="nt"><execution></span>
 <span class="nt"><id></span>document-commands<span class="nt"></id></span>
 <span class="nt"><phase></span>generate-resources<span class="nt"></phase></span>
 <span class="nt"><goals></span>
 <span class="nt"><goal></span>commands-generate-help<span class="nt"></goal></span>
 <span class="nt"></goals></span>
 <span class="nt"><configuration></span>
 <span class="nt"><targetFolder></span>/home/jbonofre/workspace/karaf/karaf/manual/target/docbook/sources<span class="nt"></targetFolder></span>
 <span class="nt"></configuration></span>
 <span class="nt"></execu
tion></span>
 <span class="nt"></executions></span>
 <span class="nt"></plugin></span>
 <span class="nt"></plugins></span>
 <span class="nt"></build></span>
<span class="nt"></project></span>
</pre></div>
</div><h3 id="Parameters">Parameters</h3><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Name </th><th class="confluenceTh"> Type </th><th class="confluenceTh"> Description </th></tr><tr><td class="confluenceTd"> <tt>targetFolder</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> The directory where the documentation output files are to be generated <br/> Default value: /home/jbonofre/workspace/karaf/karaf/manual/target/docbkx/sources </td></tr><tr><td class="confluenceTd"> <tt>format</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> The output format (docbx or conf) of the comma
nds documentation. <br/> Default value: docbx </td></tr><tr><td class="confluenceTd"> <tt>classLoader</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> The class loader to use in loading the commands. <br/> Default value: $ </td></tr></table></div>
</div>
</td>
</tr>
Modified: karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-features-add-to-repository.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-features-add-to-repository.html?rev=1484249&r1=1484248&r2=1484249&view=diff
==============================================================================
--- karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-features-add-to-repository.html (original)
+++ karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-features-add-to-repository.html Sun May 19 09:53:10 2013
@@ -93,7 +93,7 @@
<div id="wrapper-menu-page-top">
<div id="wrapper-menu-page-bottom">
<div id="menu-page">
- <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="../users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="../users-guide/installation.html">Installing Karaf</a></li><li><a href="../users-guide/directory-structure.html">Directory Structure</a></li><li><a href="../users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="../users-guide/wrapper.html">OS integration</a></li><li><a href="../users-guide/configuration.html">Configuration</a></li><li><a href="../users-guide/using-console.html">Using the console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><li><a href="../users-guide/remote-console.html">Remote console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><
li><a href="../users-guide/deployer.html">Deployer</a></li><li><a href="../users-guide/child-instances.html">Child instances</a></li><li><a href="../users-guide/security.html">Security</a></li><li><a href="../users-guide/failover.html">Failover Deployments</a></li><li><a href="../users-guide/logging-system.html">Logging system</a></li><li><a href="../users-guide/provisioning.html">Provisioning</a></li><li><a href="../users-guide/kar.html">KAR archive</a></li><li><a href="../users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="../users-guide/web-applications.html">Web applications</a></li><li><a href="../users-guide/http.html">HTTP service</a></li><li><a href="../users-guide/jmx.html">JMX for monitoring and administration</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="connect-console.html">Programmatically connect to the Console</a></li><li><a href="shell-syntax.html">
Shell syntax</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developer-command.html">Developer Commands</a></li><li><a href="archetypes.html">Maven Archetypes</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="branding-console.html">Branding the Console</a></li><li><a href="karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li><li><a href="github-contribut
ions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3>
+ <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="../users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="../users-guide/installation.html">Installing Karaf</a></li><li><a href="../users-guide/directory-structure.html">Directory Structure</a></li><li><a href="../users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="../users-guide/wrapper.html">OS integration</a></li><li><a href="../users-guide/configuration.html">Configuration</a></li><li><a href="../users-guide/using-console.html">Using the console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><li><a href="../users-guide/remote-console.html">Remote console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><
li><a href="../users-guide/deployer.html">Deployer</a></li><li><a href="../users-guide/child-instances.html">Child instances</a></li><li><a href="../users-guide/security.html">Security</a></li><li><a href="../users-guide/failover.html">Failover Deployments</a></li><li><a href="../users-guide/logging-system.html">Logging system</a></li><li><a href="../users-guide/provisioning.html">Provisioning</a></li><li><a href="../users-guide/kar.html">KAR archive</a></li><li><a href="../users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="../users-guide/web-applications.html">Web applications</a></li><li><a href="../users-guide/http.html">HTTP service</a></li><li><a href="../users-guide/jmx.html">JMX for monitoring and administration</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="connect-console.html">Programmatically connect to the Console</a></li><li><a href="shell-syntax.html">
Shell syntax</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developer-commands.html">Developer Commands</a></li><li><a href="archetypes.html">Maven Archetypes</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="branding-console.html">Branding the Console</a></li><li><a href="karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li><li><a href="github-contribu
tions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3>
</div>
</div>
</div>
@@ -101,39 +101,7 @@
</td>
<td height="100%" width="100%">
<div class="wiki-content">
-<h2 id="Goalkaraffeaturesaddtorepository">Goal <tt>karaf:features-add-to-repository</tt></h2><p>Consider using the karaf-assembly packaging which makes it easy to assemble a custom distribution in one step instead of this individual goal.</p><p>The <tt>karaf:features-add-to-repository</tt> goal adds all the required bundles for a given set of features into directory. You can use this goal to create a <tt>/system</tt> directory for building your own Karaf-based distribution.</p><p>By default, the Karaf core features descriptors (standard and enterprise) are automatically included in the descriptors set.</p><h3 id="Example">Example</h3><p>The example below copies the bundles for the <tt>spring</tt> and <tt>war</tt> features defined in the Karaf features XML descriptor into the <tt>target/features-repo</tt> directory.</p><div class="syntax"><pre name='code' class='brush: xml; gutter: false;'><code>
-<project>
- <build>
- <plugins>
- <plugin>
- <groupId>org.apache.karaf.tooling</groupId>
- <artifactId>karaf-maven-plugin</artifactId>
- <version>3.0.0-SNAPSHOT</version>
-
- <executions>
- <execution>
- <id>features-add-to-repo</id>
- <phase>generate-resources</phase>
- <goals>
- <goal>features-add-to-repository</goal>
- </goals>
- <configuration>
- <descriptors>
- <descriptor>mvn:my.groupid/my.artifactid/1.0.0/xml/features</descriptor>
- </descriptors>
- <features>
- <feature>spring</feature>
- <feature>war</feature>
- <feature>my</feature>
- </features>
- <repository>target/features-repo</repository>
- </configuration>
- </execution>
- </executions>
- </plugin>
- </plugins>
- </build>
-</project></code></pre></div><h3 id="Parameters">Parameters</h3><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Name </th><th class="confluenceTh"> Type </th><th class="confluenceTh"> Description </th></tr><tr><td class="confluenceTd"> <tt>descriptors</tt> </td><td class="confluenceTd"> <tt>String[]</tt> </td><td class="confluenceTd"> List of features XML descriptors where the features are defined <br/> NB: Karaf core features descriptors (standard and enteprise) are automatically added in this list </td></tr><tr><td class="confluenceTd"> <tt>features</tt> </td><td class="confluenceTd"> <tt>String[]</tt> </td><td class="confluenceTd"> List of features that bundles should be copied to the repository directory </td></tr><tr><td class="confluenceTd"> <tt>repository</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> The directory where the bundles will be copied by the plugin goal </td></tr><tr><td class="c
onfluenceTd"> <tt>karafVersion</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> Target Karaf version to use to resolve the Karaf core features descriptors (standard and enterprise) <br/> Default value is the Karaf plugin version </td></tr></table></div>
+<h2 id="Goalkaraffeaturesaddtorepository">Goal <tt>karaf:features-add-to-repository</tt></h2><p>Consider using the karaf-assembly packaging which makes it easy to assemble a custom distribution in one step instead of this individual goal.</p><p>The <tt>karaf:features-add-to-repository</tt> goal adds all the required bundles for a given set of features into directory. You can use this goal to create a <tt>/system</tt> directory for building your own Karaf-based distribution.</p><p>By default, the Karaf core features descriptors (standard and enterprise) are automatically included in the descriptors set.</p><h3 id="Example">Example</h3><p>The example below copies the bundles for the <tt>spring</tt> and <tt>war</tt> features defined in the Karaf features XML descriptor into the <tt>target/features-repo</tt> directory.</p><div class="syntax"><div class="highlight"><pre><span class="nt"><project></span>
 <span class="nt"><build></span>
 <span class=
"nt"><plugins></span>
 <span class="nt"><plugin></span>
 <span class="nt"><groupId></span>org.apache.karaf.tooling<span class="nt"></groupId></span>
 <span class="nt"><artifactId></span>karaf-maven-plugin<span class="nt"></artifactId></span>
 <span class="nt"><version></span>3.0.0-SNAPSHOT<span class="nt"></version></span>

 <span class="nt"><executions></span>
 <span class="nt"><execution></span>
 <span class="nt"><id></span>features-add-to-repo<span class="nt"></id></span>
 <span class="nt"><phase></span>generate-resources<span class="nt"></phase></span>
 <span class="nt"><goals></span>
 <span class="nt"><goal></span>features-add-to-repository<span class="nt"></goal></span>
 <span class="nt">&
lt;/goals></span>
 <span class="nt"><configuration></span>
 <span class="nt"><descriptors></span>
 <span class="nt"><descriptor></span>mvn:my.groupid/my.artifactid/1.0.0/xml/features<span class="nt"></descriptor></span>
 <span class="nt"></descriptors></span>
 <span class="nt"><features></span>
 <span class="nt"><feature></span>spring<span class="nt"></feature></span>
 <span class="nt"><feature></span>war<span class="nt"></feature></span>
 <span class="nt"><feature></span>my<span class="nt"></feature></span>
 <span class="nt"></features></span>
 <span class="nt"><repository></span>target/features-repo<span class="nt"></repository></span>
 <span class="nt"></con
figuration></span>
 <span class="nt"></execution></span>
 <span class="nt"></executions></span>
 <span class="nt"></plugin></span>
 <span class="nt"></plugins></span>
 <span class="nt"></build></span>
<span class="nt"></project></span>
</pre></div>
</div><h3 id="Parameters">Parameters</h3><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Name </th><th class="confluenceTh"> Type </th><th class="confluenceTh"> Description </th></tr><tr><td class="confluenceTd"> <tt>descriptors</tt> </td><td class="confluenceTd"> <tt>String[]</tt> </td><td class="confluenceTd"> List of features XML descriptors where the features are defined <br/> NB: Karaf core features descriptors (standard and enteprise) are automatically added in this list </td></tr><tr><td class="confluenceTd"> <tt>features</tt> </td><td class="confluenceTd"> <tt>String[]
</tt> </td><td class="confluenceTd"> List of features that bundles should be copied to the repository directory </td></tr><tr><td class="confluenceTd"> <tt>repository</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> The directory where the bundles will be copied by the plugin goal </td></tr><tr><td class="confluenceTd"> <tt>karafVersion</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> Target Karaf version to use to resolve the Karaf core features descriptors (standard and enterprise) <br/> Default value is the Karaf plugin version </td></tr></table></div>
</div>
</td>
</tr>
Modified: karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-features-create-kar.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-features-create-kar.html?rev=1484249&r1=1484248&r2=1484249&view=diff
==============================================================================
--- karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-features-create-kar.html (original)
+++ karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-features-create-kar.html Sun May 19 09:53:10 2013
@@ -93,7 +93,7 @@
<div id="wrapper-menu-page-top">
<div id="wrapper-menu-page-bottom">
<div id="menu-page">
- <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="../users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="../users-guide/installation.html">Installing Karaf</a></li><li><a href="../users-guide/directory-structure.html">Directory Structure</a></li><li><a href="../users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="../users-guide/wrapper.html">OS integration</a></li><li><a href="../users-guide/configuration.html">Configuration</a></li><li><a href="../users-guide/using-console.html">Using the console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><li><a href="../users-guide/remote-console.html">Remote console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><
li><a href="../users-guide/deployer.html">Deployer</a></li><li><a href="../users-guide/child-instances.html">Child instances</a></li><li><a href="../users-guide/security.html">Security</a></li><li><a href="../users-guide/failover.html">Failover Deployments</a></li><li><a href="../users-guide/logging-system.html">Logging system</a></li><li><a href="../users-guide/provisioning.html">Provisioning</a></li><li><a href="../users-guide/kar.html">KAR archive</a></li><li><a href="../users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="../users-guide/web-applications.html">Web applications</a></li><li><a href="../users-guide/http.html">HTTP service</a></li><li><a href="../users-guide/jmx.html">JMX for monitoring and administration</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="connect-console.html">Programmatically connect to the Console</a></li><li><a href="shell-syntax.html">
Shell syntax</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developer-command.html">Developer Commands</a></li><li><a href="archetypes.html">Maven Archetypes</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="branding-console.html">Branding the Console</a></li><li><a href="karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li><li><a href="github-contribut
ions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3>
+ <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="../users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="../users-guide/installation.html">Installing Karaf</a></li><li><a href="../users-guide/directory-structure.html">Directory Structure</a></li><li><a href="../users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="../users-guide/wrapper.html">OS integration</a></li><li><a href="../users-guide/configuration.html">Configuration</a></li><li><a href="../users-guide/using-console.html">Using the console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><li><a href="../users-guide/remote-console.html">Remote console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><
li><a href="../users-guide/deployer.html">Deployer</a></li><li><a href="../users-guide/child-instances.html">Child instances</a></li><li><a href="../users-guide/security.html">Security</a></li><li><a href="../users-guide/failover.html">Failover Deployments</a></li><li><a href="../users-guide/logging-system.html">Logging system</a></li><li><a href="../users-guide/provisioning.html">Provisioning</a></li><li><a href="../users-guide/kar.html">KAR archive</a></li><li><a href="../users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="../users-guide/web-applications.html">Web applications</a></li><li><a href="../users-guide/http.html">HTTP service</a></li><li><a href="../users-guide/jmx.html">JMX for monitoring and administration</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="connect-console.html">Programmatically connect to the Console</a></li><li><a href="shell-syntax.html">
Shell syntax</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developer-commands.html">Developer Commands</a></li><li><a href="archetypes.html">Maven Archetypes</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="branding-console.html">Branding the Console</a></li><li><a href="karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li><li><a href="github-contribu
tions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3>
</div>
</div>
</div>
@@ -101,22 +101,7 @@
</td>
<td height="100%" width="100%">
<div class="wiki-content">
-<h2 id="Goalkaraffeaturescreatekar">Goal <tt>karaf:features-create-kar</tt></h2><p>Except in unusual circumstances, use the <packaging>kar</packaging> to run this goal.</p><p>The <tt>karaf:features-create-kar</tt> goal assembles a KAR archive from a features XML descriptor file, normally generated in the same project with the <tt>karaf:features-generate-descriptor</tt> mojo.</p><h2 id="karlayout">kar layout</h2><p>There are two important directories in a kar:<br/>repository/ contains a Maven structured repository of artifacts to be copied into the Karaf repository. The features descriptor and all the bundles mentioned in it are installed in this directory.<br/>resources/ contains other resources to be copied over the Karaf installation.</p><p>Everything in target/classes is copied into the kar. Therefore resources you want installed into Karaf need to be in e.g. src/main/resources/resources. This choice is so other resources such as legal files from the maven-remote
-resources-plugin can be included under META-INF in the kar, without getting installed into Karaf.</p><h3 id="Example">Example</h3><div class="syntax"><pre name='code' class='brush: xml; gutter: false;'><code>
-<project>
-...
- <packaging>kar</packaging>
- <build>
- <plugins>
- <plugin>
- <groupId>org.apache.karaf.tooling</groupId>
- <artifactId>karaf-maven-plugin</artifactId>
- <version>3.0.0-SNAPSHOT</version>
- <extensions>true</extensions>
- <!-- There is no useful configuration for the kar mojo. The features-generate-descriptor mojo configuration may be useful -->
- </plugin>
- </plugins>
- </build>
-</project></code></pre></div>
+<h2 id="Goalkaraffeaturescreatekar">Goal <tt>karaf:features-create-kar</tt></h2><p>Except in unusual circumstances, use the <packaging>kar</packaging> to run this goal.</p><p>The <tt>karaf:features-create-kar</tt> goal assembles a KAR archive from a features XML descriptor file, normally generated in the same project with the <tt>karaf:features-generate-descriptor</tt> mojo.</p><h2 id="karlayout">kar layout</h2><p>There are two important directories in a kar:<br/>repository/ contains a Maven structured repository of artifacts to be copied into the Karaf repository. The features descriptor and all the bundles mentioned in it are installed in this directory.<br/>resources/ contains other resources to be copied over the Karaf installation.</p><p>Everything in target/classes is copied into the kar. Therefore resources you want installed into Karaf need to be in e.g. src/main/resources/resources. This choice is so other resources such as legal files from the maven-remote
-resources-plugin can be included under META-INF in the kar, without getting installed into Karaf.</p><h3 id="Example">Example</h3><div class="syntax"><div class="highlight"><pre><span class="nt"><project></span>
...
 <span class="nt"><packaging></span>kar<span class="nt"></packaging></span>
 <span class="nt"><build></span>
 <span class="nt"><plugins></span>
 <span class="nt"><plugin></span>
 <span class="nt"><groupId></span>org.apache.karaf.tooling<span class="nt"></groupId></span>
 <span class="nt"><artifactId></span>karaf-maven-plugin<span class="nt"></artifactId></span>
 <span class="nt"><version></span>3.0.0-SNAPSHOT<span class="nt"></version></span>
 <span class="nt"><extensions></span>true<span class="nt"></extensions></span>
 <span class="c"><!-- There is no useful con
figuration for the kar mojo. The features-generate-descriptor mojo configuration may be useful --></span>
 <span class="nt"></plugin></span>
 <span class="nt"></plugins></span>
 <span class="nt"></build></span>
<span class="nt"></project></span>
</pre></div>
</div>
</div>
</td>
</tr>