This is an automated email from the ASF dual-hosted git repository.

jbonofre pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/karaf.git


The following commit(s) were added to refs/heads/main by this push:
     new b653dd080e Document KAR META-INF/MANIFEST.MF attributes in the user 
guide (#3025)
b653dd080e is described below

commit b653dd080ea13b970499a3fbfddf1a37e70f5694
Author: akashchamp <[email protected]>
AuthorDate: Fri Oct 30 10:01:12 2026 +0530

    Document KAR META-INF/MANIFEST.MF attributes in the user guide (#3025)
    
    Signed-off-by: Akash Kumar <[email protected]>
---
 manual/src/main/asciidoc/user-guide/kar.adoc | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/manual/src/main/asciidoc/user-guide/kar.adoc 
b/manual/src/main/asciidoc/user-guide/kar.adoc
index e2418cfc77..5bfae39dca 100644
--- a/manual/src/main/asciidoc/user-guide/kar.adoc
+++ b/manual/src/main/asciidoc/user-guide/kar.adoc
@@ -35,6 +35,13 @@ A KAR file contains:
 
 NB: as kar is a zip file, it doesn't require a `META-INF/MANIFEST.MF` file. 
However, as the `karaf-maven-plugin` plugin uses Jar archive to create kar, it 
includes a `META-INF/MANIFEST.MF` (even if useless).
 
+When a KAR is installed, Apache Karaf reads the following optional main 
attributes of the `META-INF/MANIFEST.MF`, if there is one:
+
+* `Karaf-Feature-Start`: when set to `false`, the features repositories of the 
KAR are registered but the features are not installed. Any other value, a 
missing attribute, or a missing `META-INF/MANIFEST.MF` means the features are 
installed (the default).
+* `Karaf-Feature-Repos`: the URI of the features repository to register. When 
present, only this repository is registered. When missing, Apache Karaf scans 
the `repository` folder of the KAR for features repositories.
+
+The `kar:create` command writes a `META-INF/MANIFEST.MF` containing 
`Karaf-Feature-Start: false` and a `Karaf-Feature-Repos` attribute (see below).
+
 For instance, the `spring-4.0.0.kar` contains:
 
 ----

Reply via email to