X-Git-Url: https://git.heureux-cyclage.org/?a=blobdiff_plain;f=includes%2Flibs%2Frdbms%2Floadbalancer%2FILoadBalancer.php;h=fc50961f4627c325f642d22ce83441e740689fe9;hb=64b83bdb3afd0ee4f8fc1893a865409c198e601e;hp=ceb8d077ac14fecf0753fb84e834161939b6743b;hpb=6c81cf528d442d0cb10d0339440e8b104450df41;p=lhc%2Fweb%2Fwiklou.git

diff --git a/includes/libs/rdbms/loadbalancer/ILoadBalancer.php b/includes/libs/rdbms/loadbalancer/ILoadBalancer.php
index ceb8d077ac..fc50961f46 100644
--- a/includes/libs/rdbms/loadbalancer/ILoadBalancer.php
+++ b/includes/libs/rdbms/loadbalancer/ILoadBalancer.php
@@ -19,7 +19,6 @@
  *
  * @file
  * @ingroup Database
- * @author Aaron Schulz
  */
 namespace Wikimedia\Rdbms;
 
@@ -234,12 +233,13 @@ interface ILoadBalancer {
 
 	/**
 	 * Open a connection to the server given by the specified index
-	 * Index must be an actual index into the array.
-	 * If the server is already open, returns it.
+	 *
+	 * The index must be an actual index into the array. If a connection to the server is
+	 * already open and not considered an "in use" foreign connection, this simply returns it.
 	 *
 	 * @note If disable() was called on this LoadBalancer, this method will throw a DBAccessError.
 	 *
-	 * @param int $i Server index or DB_MASTER/DB_REPLICA
+	 * @param int $i Server index (does not support DB_MASTER/DB_REPLICA)
 	 * @param string|bool $domain Domain ID, or false for the current domain
 	 * @return Database|bool Returns false on errors
 	 * @throws DBAccessError
@@ -286,6 +286,8 @@ interface ILoadBalancer {
 	 * Return the server info structure for a given index, or false if the index is invalid.
 	 * @param int $i
 	 * @return array|bool
+	 *
+	 * @deprecated Since 1.30, no alternative
 	 */
 	public function getServerInfo( $i );
 
@@ -294,6 +296,8 @@ interface ILoadBalancer {
 	 * is created if it doesn't exist
 	 * @param int $i
 	 * @param array $serverInfo
+	 *
+	 * @deprecated Since 1.30, construct new object
 	 */
 	public function setServerInfo( $i, array $serverInfo );