This is an automated email from the ASF dual-hosted git repository.
cziegeler pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/felix-antora-site.git
The following commit(s) were added to refs/heads/main by this push:
new 0d3b5c5d Add note about scr tooling out of life
0d3b5c5d is described below
commit 0d3b5c5d24a1e25d9bc7aa3d3493a549cf25e20a
Author: Carsten Ziegeler <[email protected]>
AuthorDate: Mon Oct 16 15:07:52 2023 +0200
Add note about scr tooling out of life
---
modules/ROOT/pages/faqs/apache-felix-scr-plugin-faq.adoc | 2 +-
modules/ROOT/pages/subprojects.adoc | 2 +-
.../apache-felix-maven-scr-plugin-use.adoc | 2 ++
.../apache-felix-maven-scr-plugin/apache-felix-scr-ant-task-use.adoc | 2 ++
.../apache-felix-maven-scr-plugin/apache-felix-scr-bndtools-use.adoc | 2 ++
.../apache-felix-maven-scr-plugin/extending-scr-annotations.adoc | 2 ++
.../subprojects/apache-felix-maven-scr-plugin/scr-annotations.adoc | 4 +++-
.../subprojects/apache-felix-maven-scr-plugin/scr-javadoc-tags.adoc | 2 ++
8 files changed, 15 insertions(+), 3 deletions(-)
diff --git a/modules/ROOT/pages/faqs/apache-felix-scr-plugin-faq.adoc
b/modules/ROOT/pages/faqs/apache-felix-scr-plugin-faq.adoc
index 35b487e0..131e82d6 100644
--- a/modules/ROOT/pages/faqs/apache-felix-scr-plugin-faq.adoc
+++ b/modules/ROOT/pages/faqs/apache-felix-scr-plugin-faq.adoc
@@ -1,6 +1,6 @@
= Apache Felix SCR Plugin Frequently Asked Questions
-
+IMPORTANT: The Apache Felix SCR Tooling is not supported anymore. Please use
the official OSGi annotations and bnd based tooling instead.
This page provides answers to frequently asked questions using the Maven SCR
Plugin.
See
xref:subprojects/apache-felix-maven-scr-plugin/apache-felix-maven-scr-plugin-use.adoc[]
for documentation on that plugin.
diff --git a/modules/ROOT/pages/subprojects.adoc
b/modules/ROOT/pages/subprojects.adoc
index fbdc1249..af3f27bf 100644
--- a/modules/ROOT/pages/subprojects.adoc
+++ b/modules/ROOT/pages/subprojects.adoc
@@ -109,7 +109,7 @@ The last documentation may be found in the
{site-pub}/tree/last-cms repository.
* {last-cms-subprojects}/apache-felix-manifest-generator-mangen.html[Manifest
Generator (mangen)]
* {last-cms-subprojects}/apache-felix-maven-obr-plugin.html[Maven OBR Plugin]
* {last-cms-subprojects}/apache-felix-maven-osgi-plugin.html[Maven OSGi Plugin]
-* {last-cms-subprojects}/apache-felix-maven-scr-plugin.html[Maven SCR Plugin]
+* xref:subprojects/apache-felix-maven-scr-plugin.adoc[Maven SCR Plugin]
* {last-cms-subprojects}/mosgi-managed-osgi-framework.html[MOSGi Managed OSGi
framework]
* {last-cms-subprojects}/apache-felix-osgi-core.html[OSGi Core]
* xref:subprojects/apache-felix-preferences-service.adoc[Preferences Service]
diff --git
a/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/apache-felix-maven-scr-plugin-use.adoc
b/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/apache-felix-maven-scr-plugin-use.adoc
index c3372958..edfdf8ca 100644
---
a/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/apache-felix-maven-scr-plugin-use.adoc
+++
b/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/apache-felix-maven-scr-plugin-use.adoc
@@ -1,5 +1,7 @@
= Apache Felix Maven SCR Plugin Use
+IMPORTANT: The Apache Felix SCR Tooling is not supported anymore. Please use
the official OSGi annotations and bnd based tooling instead.
+
== Using the Apache Felix Maven SCR Plugin to generate Declarative Services
and Metatype Service descriptors during a Maven Build
Support for automatic generation of the component and metadata descriptors is
embedded in the `org.apache.felix:maven-scr-plugin` plugin.
diff --git
a/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/apache-felix-scr-ant-task-use.adoc
b/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/apache-felix-scr-ant-task-use.adoc
index 72bb59b5..14bd06e1 100644
---
a/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/apache-felix-scr-ant-task-use.adoc
+++
b/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/apache-felix-scr-ant-task-use.adoc
@@ -1,5 +1,7 @@
= Apache Felix SCR Ant Task Use
+IMPORTANT: The Apache Felix SCR Tooling is not supported anymore. Please use
the official OSGi annotations and bnd based tooling instead.
+
== Using the Apache Felix SCR Ant Task to generate Declarative Services and
Metatype Service descriptors during an Ant driven Build.
The SCR Ant Task is implemented in the `org.apache.felix.scr.ant` library
which must be registered as an Ant Task in the build file as follows:
diff --git
a/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/apache-felix-scr-bndtools-use.adoc
b/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/apache-felix-scr-bndtools-use.adoc
index 0c0ec6b9..af552901 100644
---
a/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/apache-felix-scr-bndtools-use.adoc
+++
b/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/apache-felix-scr-bndtools-use.adoc
@@ -1,5 +1,7 @@
= Apache Felix SCR Annotations BndTools Use
+IMPORTANT: The Apache Felix SCR Tooling is not supported anymore. Please use
the official OSGi annotations and bnd based tooling instead.
+
== Using the Apache Felix SCR Annotations Bnd plugin to generate Declarative
Services and Metatype Service descriptors in BndTools.
The org.apache.felix.scrplugin.bnd.SCRDescriptorBndPlugin is a bnd plugin
allowing to generate SCR annotations and metatype descriptors in the Eclipse
BndTools environment.
diff --git
a/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/extending-scr-annotations.adoc
b/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/extending-scr-annotations.adoc
index 2a62fd5c..2b3090f9 100644
---
a/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/extending-scr-annotations.adoc
+++
b/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/extending-scr-annotations.adoc
@@ -1,5 +1,7 @@
= Extending SCR Annotations Excerpt: How add new Annotations extending the
base Annotations
+IMPORTANT: The Apache Felix SCR Tooling is not supported anymore. Please use
the official OSGi annotations and bnd based tooling instead.
+
NOTE: This page documents functionality available with the SCR Generator 1.0.0
release providing the declaration file generation mechanism for the Maven SCR
Plugin 1.6.0 (and newer) and the SCR Ant Task 1.0.0 (and newer).
The SCR Annotations library has been updated in version 1.4.0 to comply with
the rules described here.
diff --git
a/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/scr-annotations.adoc
b/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/scr-annotations.adoc
index 613936fa..b181fe7a 100644
---
a/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/scr-annotations.adoc
+++
b/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/scr-annotations.adoc
@@ -1,5 +1,7 @@
= SCR Annotations Excerpt: Using Java 5 Annotations to describe the component
or service.
+IMPORTANT: The Apache Felix SCR Tooling is not supported anymore. Please use
the official OSGi annotations and bnd based tooling instead.
+
The `maven-scr-plugin` uses the `SCR` annotations from the corresponding
subproject at Apache Felix.
All annotations are in the `org.apache.felix.scr.annotations` package.
If you want to use the annotations in your project, you have to use a
`maven-scr-plugin` version >= 1.24.0 and make sure that you add a dependency to
the annotations to your `POM`:
@@ -256,4 +258,4 @@ The default value is the name created by appending the
reference `name` to the s
The method must be declared `public` or `protected` and take single argument
which is declared with the service interface type
| *`strategy`* | `event` | `reference.strategy` | The strategy used for
this reference, one of `event` or `lookup`.
If the reference is defined on a field with a strategy of `event` and there is
no bind or unbind method, the plugin will create the necessary methods.
-|===
\ No newline at end of file
+|===
diff --git
a/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/scr-javadoc-tags.adoc
b/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/scr-javadoc-tags.adoc
index ff66af5f..dced555d 100644
---
a/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/scr-javadoc-tags.adoc
+++
b/modules/ROOT/pages/subprojects/apache-felix-maven-scr-plugin/scr-javadoc-tags.adoc
@@ -1,5 +1,7 @@
= SCR JavaDoc Tags Excerpt: Using JavaDoc Tags to describe the component or
service.
+IMPORTANT: The Apache Felix SCR Tooling is not supported anymore. Please use
the official OSGi annotations and bnd based tooling instead.
+
JavaDoc tags are not supported since the Maven SCR Plugin 1.8.0 because
annotations are a much more powerful instrument allowing for type safety or
supporting JVM based languages such as Groovy and Scala.
This page exists to define the support for JavaDoc tags upto Maven SCR Plugin
version 1.7.4.
