Uncommited documentation from my working copy

includes/Export.php

@@ -438,12 +438,13 @@ class XmlDumpWriter {
 	/**
 	 * Closes the output stream with the closing root element.
 	 * Call when finished dumping things.
+	 *
+	 * @return string
 	 */
 	function closeStream() {
 		return "</mediawiki>\n";
 	}
 
-
 	/**
 	 * Opens a <page> section on the output stream, with data
 	 * from the given database row.
@@ -616,6 +617,11 @@ class XmlDumpWriter {
 		return '';
 	}
 
+	/**
+	 * @param $file File
+	 * @param $dumpContents bool
+	 * @return string
+	 */
 	function writeUpload( $file, $dumpContents = false ) {
 		if ( $file->isOld() ) {
 			$archiveName = "      " . 

includes/filerepo/File.php

@@ -1431,7 +1431,9 @@ abstract class File {
 	 * 160 log 2 / log 36 = 30.95, so the 160-bit hash fills 31 digits in base 36
 	 * fairly neatly.
 	 *
-	 * Returns false on failure
+	 * @param $path string
+	 *
+	 * @return false on failure
 	 *
 	 * @param $path string
 	 *