[sling-org-apache-sling-serviceusermapper] 05/07: SLING-4312 : update javadocs

[ro...@apache.org]

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

rombert pushed a commit to annotated tag org.apache.sling.serviceusermapper-1.2.0
in repository https://gitbox.apache.org/repos/asf/sling-org-apache-sling-serviceusermapper.git

commit ff10f6ae74059730c67a22d8444b1411fbc32e21
Author: Carsten Ziegeler <cz...@apache.org>
AuthorDate: Fri Mar 13 10:10:10 2015 +0000

    SLING-4312 : update javadocs
    
    git-svn-id: https://svn.apache.org/repos/asf/sling/trunk/bundles/extensions/serviceusermapper@1666388 13f79535-47bb-0310-9956-ffa450edef68
---
 .../java/org/apache/sling/serviceusermapping/ServiceUserMapped.java    | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/main/java/org/apache/sling/serviceusermapping/ServiceUserMapped.java b/src/main/java/org/apache/sling/serviceusermapping/ServiceUserMapped.java
index 1e116b1..01b7ba5 100644
--- a/src/main/java/org/apache/sling/serviceusermapping/ServiceUserMapped.java
+++ b/src/main/java/org/apache/sling/serviceusermapping/ServiceUserMapped.java
@@ -9,6 +9,9 @@ import aQute.bnd.annotation.ProviderType;
  * For example setting the reference target to "(subServiceName=mySubService)" ensures that your component only starts when the subService is available.
  * The subServiceName will not be set for mappings that do not have one, and those can be referenced with a negating target "(!(subServiceName=*))".
  * Trying to reference a sub service from a bundle for which it was not registered for will not work.
+ *
+ * As the service user mapper implementation is using a fallback, it is usually best to use a reference target that includes both
+ * options, the sub service name and the fallback, therefore a target like "(|((subServiceName=mySubService)(!(subServiceName=*))))" should be used.
  */
 @ProviderType
 public interface ServiceUserMapped {

-- 
To stop receiving notification emails like this one, please contact
"commits@sling.apache.org" <co...@sling.apache.org>.