Changeset 47122 for trunk/tests/phpunit/tests/file.php

Timestamp:

01/29/2020 12:43:23 AM (5 years ago)

Author:

SergeyBiryukov

Message:

Docs: Improve inline comments per the documentation standards.

Includes minor code layout fixes for better readability.

See #48303.

File:

• trunk/tests/phpunit/tests/file.php (modified) (7 diffs)

trunk/tests/phpunit/tests/file.php

@@ -72 +72 @@
 
         $fp = fopen( $fullpath, 'x' );
-        // file already exists?
+        // File already exists?
         if ( ! $fp ) {
             return false;
         }
 
-        // write some random contents
+        // Write some random contents.
         $c = rand_str();
         fwrite( $fp, $c );
@@ -92 +92 @@
 
     function test_unique_filename_is_valid() {
-        // make sure it produces a valid, writable, unique filename
+        // Make sure it produces a valid, writable, unique filename.
         $filename = wp_unique_filename( $this->dir, __FUNCTION__ . '.txt' );
 
@@ -101 +101 @@
 
     function test_unique_filename_is_unique() {
-        // make sure it produces two unique filenames
+        // Make sure it produces two unique filenames.
         $name = __FUNCTION__;
 
@@ -109 +109 @@
         $this->assertTrue( $this->is_unique_writable_file( $this->dir, $filename2 ) );
 
-        // the two should be different
+        // The two should be different.
         $this->assertNotEquals( $filename1, $filename2 );
 
@@ -120 +120 @@
         $filename = wp_unique_filename( $this->dir, $name . $this->badchars . '.txt' );
 
-        // make sure the bad characters were all stripped out
+        // Make sure the bad characters were all stripped out.
         $this->assertEquals( $name . '.txt', $filename );
 
@@ -133 +133 @@
         $filename = wp_unique_filename( $this->dir, $name . '/' . $name . '.txt' );
 
-        // the slash should be removed, i.e. "foofoo.txt"
+        // The slash should be removed, i.e. "foofoo.txt".
         $this->assertEquals( $name . $name . '.txt', $filename );
 
@@ -145 +145 @@
         $filename = wp_unique_filename( $this->dir, $name . '.php.txt' );
 
-        // "foo.php.txt" becomes "foo.php_.txt"
+        // "foo.php.txt" becomes "foo.php_.txt".
         $this->assertEquals( $name . '.php_.txt', $filename );