From ca2db24b3eb3891f85eafad5dec9007c6c922405 Mon Sep 17 00:00:00 2001
From: Paul Spencer <paulspencer@mindspring.com>
Date: Tue, 16 Jul 2024 22:18:06 -0400
Subject: [PATCH] [KARAF-7850] Add karaf-services-maven-plugin doc for command

---
 .../asciidoc/developer-guide/extending.adoc   | 32 +++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/manual/src/main/asciidoc/developer-guide/extending.adoc b/manual/src/main/asciidoc/developer-guide/extending.adoc
index 75b3638188c..d8f832e1246 100644
--- a/manual/src/main/asciidoc/developer-guide/extending.adoc
+++ b/manual/src/main/asciidoc/developer-guide/extending.adoc
@@ -18,6 +18,38 @@ Apache Karaf is a very flexible container that you can extend very easily.
 
 ==== Shell commands
 
+In addition to annotations, like '@Command' and '@Service', in the command
+class, you must add karaf-services-maven-plugin configuration to pom.xml.
+
+----
+    <build>
+        <pluginManagement>
+            <plugins>
+                <plugin>
+                    <groupId>org.apache.karaf.tooling</groupId>
+                    <artifactId>karaf-services-maven-plugin</artifactId>
+                    <version>${project.version}</version>
+                    <executions>
+                        <execution>
+                            <id>service-metadata-generate</id>
+                            <phase>process-classes</phase>
+                            <goals>
+                                <goal>service-metadata-generate</goal>
+                            </goals>
+                        </execution>
+                    </executions>
+                </plugin>
+            </plugins>
+        </pluginManagement>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.karaf.tooling</groupId>
+                <artifactId>karaf-services-maven-plugin</artifactId>
+            </plugin>
+        </plugins>
+   </build>
+----
+        
 See https://github.com/apache/karaf/blob/master/examples/karaf-command-example/README.md to add your own shell commands.
 
 ==== WebConsole