docs(group): clarify group listing API docs

apps/user_ldap/lib/Group_LDAP.php

@@ -1072,18 +1072,13 @@
 	}
 
 	/**
-	 * get a list of all groups using a paged search
+	 * Get groups via LDAP search.
 	 *
-	 * @param string $search
-	 * @param int $limit
-	 * @param int $offset
-	 * @return array with group names
+	 * Uses a paged search when available to override server-side search limits.
+	 * Active Directory has a default limit of 1000 results.
 	 *
-	 * Returns a list with all groups
-	 * Uses a paged search if available to override a
-	 * server side search limit.
-	 * (active directory has a limit of 1000 by default)
 	 * @throws Exception
+	 * @throws ServerNotAvailableException
 	 */
 	#[\Override]
 	public function getGroups($search = '', $limit = -1, $offset = 0) {
@@ -1115,7 +1110,7 @@
 		$ldap_groups = $this->access->nextcloudGroupNames($ldap_groups);
 
 		$this->access->connection->writeToCache($cacheKey, $ldap_groups);
 		return $ldap_groups;
 	}
 
 	/**

lib/private/Group/Database.php

@@ -240,13 +240,7 @@ public function getUserGroups($uid) {
 	}
 
 	/**
-	 * get a list of all groups
-	 * @param string $search
-	 * @param int $limit
-	 * @param int $offset
-	 * @return array an array of group names
-	 *
-	 * Returns a list with all groups
+	 * Search for groups by gid or display name.
 	 */
 	#[\Override]
 	public function getGroups(string $search = '', int $limit = -1, int $offset = 0) {

lib/public/GroupInterface.php

@@ -95,15 +95,15 @@ public function inGroup($uid, $gid);
 	public function getUserGroups($uid);
 
 	/**
-	 * @brief Get a list of all groups
+	 * Get a list of groups matching the search criteria.
 	 *
-	 * @param string $search
-	 * @param int $limit
-	 * @param int $offset
-	 * @return array an array of group names
-	 * @since 4.5.0
+	 * An empty search returns all groups.
 	 *
-	 * Returns a list with all groups
+	 * @param string $search Search term used to filter group names
+	 * @param int $limit Maximum number of results to return, or -1 for no limit
+	 * @param int $offset Offset for paginated results
+	 * @return list<string> An array of group names
+	 * @since 4.5.0
 	 */
 	public function getGroups(string $search = '', int $limit = -1, int $offset = 0);