[karaf] branch master updated: updated-boot-features-documentation (#908)

[jb...@apache.org]

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

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


The following commit(s) were added to refs/heads/master by this push:
     new e3f5d90  updated-boot-features-documentation (#908)
e3f5d90 is described below

commit e3f5d90db3a02da8efd140836487c07450b6ba98
Author: Alex <50...@users.noreply.github.com>
AuthorDate: Mon Sep 16 14:39:43 2019 +0100

    updated-boot-features-documentation (#908)
    
    Update boot features documentation
---
 manual/src/main/asciidoc/user-guide/provisioning.adoc | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/manual/src/main/asciidoc/user-guide/provisioning.adoc b/manual/src/main/asciidoc/user-guide/provisioning.adoc
index 96bc426..255e755 100644
--- a/manual/src/main/asciidoc/user-guide/provisioning.adoc
+++ b/manual/src/main/asciidoc/user-guide/provisioning.adoc
@@ -123,16 +123,27 @@ To prevent this behaviour, you can specify features as boot features.
 
 ==== Boot features
 
-You can describe some features as boot features. A boot feature will be automatically install by Apache Karaf, even if it has
-not been previously installed using `feature:install` or FeatureMBean.
+A boot feature is automatically installed by Apache Karaf, even if it has not been previously installed using `feature:install` or FeatureMBean.
 
-Apache Karaf features configuration is located in the `etc/org.apache.karaf.features.cfg` configuration file.
+The Apache Karaf features configuration is located in the `etc/org.apache.karaf.features.cfg` configuration file.
 
 This configuration file contains the two properties to use to define boot features:
 
 * `featuresRepositories` contains a list (comma-separated) of features repositories (features XML) URLs.
 * `featuresBoot` contains a list (comma-separated) of features to install at boot.
 
+========
+To remove features from the `featuresBoot` list in the `etc/org.apache.karaf.features.cfg` configuration file:
+
+. Navigate to `etc/org.apache.karaf.features.cfg`.
+. Remove the undesired feature.
+. Restart your container.
+
+NOTE: After the restart, the features will be present in the `etc/org.apache.karaf.features.cfg` configuration file, but they will not be installed and the undesired feature or behavior will no longer be present or active.
+
+NOTE: Another way to clean up the `featuresBoot` is to stop Karaf, update `featuresBoot`, and remove the *data* folder.
+========
+
 ==== Features upgrade
 
 You can update a release by installing the same feature (with the same SNAPSHOT version or a different version).