package io.quarkus.arc.processor;

import java.util.Map;
import java.util.Set;
import javax.inject.Qualifier;
import org.jboss.jandex.DotName;

/**
 * Makes it possible to turn an annotation into a qualifier without adding a {@link Qualifier} annotation to it.
 */
public interface QualifierRegistrar extends BuildExtension {

    /**
     * Returns a map of additional qualifers where the key represents the annotation type and the value is an optional set of
     * non-binding members.
     */
    Map<DotName, Set<String>> getAdditionalQualifiers();
}

@@ -481,16 +481,242 @@
 members.
+ Here, %22non-binding%22 is meant in the sense of %7B@code javax.enterprise.util.Nonbinding%7D. I.e. members%0A     * named in the set will be ignored when the CDI container is selecting a bean instance for a particular injection point.
 %0A     */

Improve the JavaDoc in io.quarkus.arc.processor.QualifierRegistrar