method documentation for r108364
authorAntoine Musso <hashar@users.mediawiki.org>
Mon, 9 Jan 2012 14:10:13 +0000 (14:10 +0000)
committerAntoine Musso <hashar@users.mediawiki.org>
Mon, 9 Jan 2012 14:10:13 +0000 (14:10 +0000)
The function are badly named and could use something better :D

languages/Language.php

index 749d1b5..7fcce65 100644 (file)
@@ -3812,6 +3812,9 @@ class Language {
         * Format a bitrate for output, using an appropriate
         * unit (bps, kbps, Mbps, Gbps, Tbps, Pbps, Ebps, Zbps or Ybps) according to the magnitude in question
         *
+        * This use base 1000. For base 1024 use formatSize(), for another base
+        * see formatComputingNumbers()
+        *
         * @param $bps int
         * @return string
         */
@@ -3857,6 +3860,9 @@ class Language {
         * Format a size in bytes for output, using an appropriate
         * unit (B, KB, MB, GB, TB, PB, EB, ZB or YB) according to the magnitude in question
         *
+        * This method use base 1024. For base 1000 use formatBitrate(), for
+        * another base see formatComputingNumbers()
+        *
         * @param $size int Size to format
         * @return string Plain text (not HTML)
         */