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:
----