docs: update comments

Signed-off-by: Salvatore Martire <4652631+salmart-dev@users.noreply.github.com>

Author: salmart-dev

lib/private/Files/Config/MountProviderCollection.php

@@ -81,6 +81,9 @@ public function getMountsForUser(IUser $user): array {
 	}
 
 	/**
+	 * Returns the mounts for the user from the specified provider classes.
+	 * Providers not registered in the MountProviderCollection will be skipped.
+	 *
 	 * @return list<IMountPoint>
 	 */
 	public function getUserMountsForProviderClasses(IUser $user, array $mountProviderClasses): array {

lib/private/Files/SetupManager.php

@@ -60,7 +60,11 @@ class SetupManager {
 	private array $setupUsers = [];
 	// List of users for which all mounts are setup
 	private array $setupUsersComplete = [];
-	/** @var array<string, string[]> */
+	/**
+	 * An array of provider classes that have been set up, indexed by UserUID.
+	 *
+	 * @var array<string, class-string<IMountProvider>[]>
+	 */
 	private array $setupUserMountProviders = [];
 	private ICache $cache;
 	private bool $listeningForProviders;
@@ -213,7 +217,7 @@ public function setupForUser(IUser $user): void {
 	}
 
 	/**
-	 * part of the user setup that is run only once per user
+	 * Part of the user setup that is run only once per user.
 	 */
 	private function oneTimeUserSetup(IUser $user) {
 		if ($this->isSetupStarted($user)) {
@@ -303,11 +307,16 @@ private function afterUserFullySetup(IUser $user, array $previouslySetupProvider
 	}
 
 	/**
+	 * Executes the one-time user setup and, if the user can access the
+	 * filesystem, executes $mountCallback.
+	 *
 	 * @param IUser $user
 	 * @param IMountPoint $mounts
 	 * @return void
 	 * @throws \OCP\HintException
 	 * @throws \OC\ServerNotAvailableException
+	 * @see self::oneTimeUserSetup()
+	 *
 	 */
 	private function setupForUserWith(IUser $user, callable $mountCallback): void {
 		$this->oneTimeUserSetup($user);