Uncommited documentation from my working copy

diff --git a/includes/Export.php b/includes/Export.php
index 0dbba91..8a3d7df 100644 (file)
--- a/includes/Export.php
+++ b/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 = "      " . 

diff --git a/includes/filerepo/File.php b/includes/filerepo/File.php
index 5859cc9..e1f89b8 100644 (file)
--- a/includes/filerepo/File.php
+++ b/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
         *