From 4e7aa45ee5ce4130cb2559662847009b0b3830ee Mon Sep 17 00:00:00 2001
From: Brion Vibber <brion@users.mediawiki.org>
Date: Sun, 6 Feb 2011 21:47:58 +0000
Subject: [PATCH] Fixed an incorrect doc comment bit on Database::sourceStream,
 then added some more doc comments around the file just cause

---
 includes/db/Database.php | 21 +++++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

diff --git a/includes/db/Database.php b/includes/db/Database.php
index 5adf5dac5e..4337cede5f 100644
--- a/includes/db/Database.php
+++ b/includes/db/Database.php
@@ -2494,7 +2494,7 @@ abstract class DatabaseBase implements DatabaseType {
 	/**
 	 * Read and execute commands from an open file handle
 	 * Returns true on success, error string or exception on failure (depending on object's error ignore settings)
-	 * @param $fp String: File handle
+	 * @param $fp Resource: File handle
 	 * @param $lineCallback Callback: Optional function called before reading each line
 	 * @param $resultCallback Callback: Optional function called for each MySQL result
 	 * @param $fname String: Calling function name
@@ -3124,6 +3124,9 @@ class ResultWrapper implements Iterator {
 
 	/**
 	 * Create a new result object from a result resource and a Database object
+	 *
+	 * @param Database $database
+	 * @param resource $result
 	 */
 	function __construct( $database, $result ) {
 		$this->db = $database;
@@ -3137,6 +3140,8 @@ class ResultWrapper implements Iterator {
 
 	/**
 	 * Get the number of rows in a result object
+	 *
+	 * @return integer
 	 */
 	function numRows() {
 		return $this->db->numRows( $this );
@@ -3175,8 +3180,10 @@ class ResultWrapper implements Iterator {
 	}
 
 	/**
-	 * Change the position of the cursor in a result object
+	 * Change the position of the cursor in a result object.
 	 * See mysql_data_seek()
+	 *
+	 * @param $row integer
 	 */
 	function seek( $row ) {
 		$this->db->dataSeek( $this, $row );
@@ -3266,10 +3273,20 @@ class FakeResultWrapper extends ResultWrapper {
 class LikeMatch {
 	private $str;
 
+	/**
+	 * Store a string into a LikeMatch marker object.
+	 *
+	 * @param String $s
+	 */
 	public function __construct( $s ) {
 		$this->str = $s;
 	}
 
+	/**
+	 * Return the original stored string.
+	 *
+	 * @return String
+	 */
 	public function toString() {
 		return $this->str;
 	}
-- 
2.20.1