Add comments to tests

Author: chrisullyott

tests/FileSizeTest.php

@@ -10,20 +10,29 @@
 
 class FileSizeTest extends \PHPUnit_Framework_TestCase
 {
+    /**
+     * Test a numeric string input.
+     */
     public function testBytes()
     {
         $size = new FileSize('128974848');
 
         $this->assertSame($size->as('B'), 128974848);
     }
 
+    /**
+     * Test that "partial bytes" are rounded up.
+     */
     public function testBytesRounding()
     {
         $size = new FileSize('99.7 bytes');
 
         $this->assertSame($size->as('B'), 100);
     }
 
+    /**
+     * Test #add.
+     */
     public function testAdd()
     {
         $size = new FileSize('123 megabytes');
@@ -32,6 +41,9 @@ public function testAdd()
         $this->assertSame($size->as('B'), 129128448);
     }
 
+    /**
+     * Test #subtract.
+     */
     public function testSubtract()
     {
         $size = new FileSize('123M');
@@ -40,6 +52,9 @@ public function testSubtract()
         $this->assertSame($size->as('B'), 128821248);
     }
 
+    /**
+     * Test #multiplyBy.
+     */
     public function testMultiplyBy()
     {
         $size = new FileSize('425.51 m');
@@ -48,6 +63,9 @@ public function testMultiplyBy()
         $this->assertSame($size->as('GB'), 3.79);
     }
 
+    /**
+     * Test #divideBy.
+     */
     public function testDivideBy()
     {
         $size = new FileSize('300K');
@@ -56,27 +74,39 @@ public function testDivideBy()
         $this->assertSame($size->as('KiB'), (float) 150);
     }
 
+    /**
+     * Test upward unit conversion.
+     */
     public function testConvertUp()
     {
         $size = new FileSize('123456789 TB');
 
         $this->assertSame($size->as('exabytes'), 5.74);
     }
 
+    /**
+     * Test downward unit conversion.
+     */
     public function testConvertDown()
     {
         $size = new FileSize('1 Gigabyte');
 
         $this->assertSame($size->as('B'), 1073741824);
     }
 
+    /**
+     * Test when the unit has not changed.
+     */
     public function testNoConvert()
     {
         $size = new FileSize('525 Gibibytes');
 
         $this->assertSame($size->as('GB'), (float) 525);
     }
 
+    /**
+     * Test auto-formatting for a small value.
+     */
     public function testAutoSmall()
     {
         $size = new FileSize('1.2345 KB');
@@ -85,13 +115,19 @@ public function testAutoSmall()
         $this->assertSame($size->asAuto(), '422 B');
     }
 
+    /**
+     * Test auto-formatting for a large value.
+     */
     public function testAutoLarge()
     {
         $size = new FileSize('1234522678.12 KB');
 
         $this->assertSame($size->asAuto(), '1.15 TB');
     }
 
+    /**
+     * Test the rounding in auto-formatting (should not leave trailing zeros).
+     */
     public function testAutoRounding()
     {
         $size = new FileSize('158.1983 mb');