This is an automated email from the ASF dual-hosted git repository. kwin pushed a commit to branch feature/document-start-level in repository https://gitbox.apache.org/repos/asf/sling-org-apache-sling-feature-cpconverter.git
commit 8b8863bd9a38498fb3daae771dc33c6ebc1871b7 Author: Konrad Windszus <[email protected]> AuthorDate: Fri Jun 21 11:22:57 2024 +0200 Clarify support for start levels Document how run mode and start level is determined --- README.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index f64e0b0..c546619 100644 --- a/README.md +++ b/README.md @@ -258,7 +258,14 @@ During the conversion process, all these formats will be parsed and then added i ### Run Modes As shown above, run modes in the path lead the tool to create a dedicated _Apache Sling Feature_ model file containing all interested OSGi configurations/bundles. Run modes are determined according to the RunModePolicy which by default for backwards compatiblity reasons is DIRECT_ONLY. -For DIRECT_ONLY only the direct path leading up to the artifact, while PREPEND_INHERITED makes sure that run modes are inherited downwards and deduplicated (only new ones added) +For DIRECT_ONLY only the direct path leading up to the artifact, while PREPEND_INHERITED makes sure that run modes are inherited downwards and deduplicated (only new ones added). +Run modes are supported for both OSGi configurations and OSGi bundles. +The run mode is extracted from the group named `runmode` from the bundles path applied to the regular expression `/jcr_root/(?:apps|libs)/.+/(?<foldername>install|config)(?:\\.(?<runmode>[^/]+))?/(?:(?<startlevel>[0-9]+)/)?.+\\.jar`. For OSGi configuration the following regular expression is used: `/jcr_root/(?:apps|libs)/.+/(?<foldername>config|install)(\\.(?<runmode>[^/]+))?(.*)/(?<pid>[^\\/]*)\\." + extension + ("(?<dir>.dir(/\\.content\\.xml)?)?$`. + +### Start Level + +For bundles the start level can also be configured. +The start level is extracted from the group named `startlevel` from the bundles path applied to the regular expression `/jcr_root/(?:apps|libs)/.+/(?<foldername>install|config)(?:\\.(?<runmode>[^/]+))?/(?:(?<startlevel>[0-9]+)/)?.+\\.jar`. If there is no start level specific in the path name, the default start level is used. ### Known limitations
