X-Git-Url: https://git.heureux-cyclage.org/?a=blobdiff_plain;f=includes%2Fauth%2FAuthenticationProvider.php;h=11f3e226ad43b455ef1adb05716bd9310156b716;hb=c2a681ba58c8718242d39450c34a603346126b98;hp=4db0a84be99ff8d480456b912f37da5dd02f3c39;hpb=c9bef3d160724e84b9c876615cceddffadef73bc;p=lhc%2Fweb%2Fwiklou.git

diff --git a/includes/auth/AuthenticationProvider.php b/includes/auth/AuthenticationProvider.php
index 4db0a84be9..11f3e226ad 100644
--- a/includes/auth/AuthenticationProvider.php
+++ b/includes/auth/AuthenticationProvider.php
@@ -28,6 +28,11 @@ use Psr\Log\LoggerAwareInterface;
 
 /**
  * An AuthenticationProvider is used by AuthManager when authenticating users.
+ *
+ * This interface should not be implemented directly; use one of its children.
+ *
+ * Authentication providers can be registered via $wgAuthManagerAutoConfig.
+ *
  * @ingroup Auth
  * @since 1.27
  */
@@ -83,9 +88,9 @@ interface AuthenticationProvider extends LoggerAwareInterface {
 	 *    - ACTION_LINK: The local user being linked to.
 	 *    - ACTION_CHANGE: The user having data changed.
 	 *    - ACTION_REMOVE: The user having data removed.
-	 *    This does not need to be copied into the returned requests, you only
-	 *    need to pay attention to it if the set of requests differs based on
-	 *    the user.
+	 *    If you leave the username property of the returned requests empty, this
+	 *    will automatically be copied there (except for ACTION_CREATE where it
+	 *    wouldn't really make sense).
 	 * @return AuthenticationRequest[]
 	 */
 	public function getAuthenticationRequests( $action, array $options );