change docblocks

Author: tijmenbruggeman

src/class-tiny-settings.php

@@ -359,8 +359,8 @@ public function get_preserve_enabled( $name ) {
 	/**
 	 * Retrieves the preserve options for the original image
 	 *
-	 * @param string - size name
-	 * @return false|array<string> false if size is not original, otherwise array of preserved keys
+	 * @param string $size_name Name of the size
+	 * @return array<string>|false false if size is not original, otherwise array of preserved keys
 	 */
 	public function get_preserve_options( $size_name ) {
 		if ( ! Tiny_Image::is_original( $size_name ) ) {

test/helpers/wordpress.php

@@ -284,7 +284,7 @@ public function createImage($file_size, $path, $name)
 
 	/**
 	 * Creates images on the virtual disk for testing
-	 * @param null|array $sizes Array of size => bytes to create, file will be named $name-$size.png
+	 * @param null|array $sizes Array of size name (array key) => bytes to create; each file will be named "$name-<size name>.png"
 	 * @param int $original_size Bytes of image
 	 * @param string $path Path to image
 	 * @param string $name Name of the image
@@ -322,7 +322,7 @@ public function createImagesFromJSON($virtual_images)
 	 *
 	 * @param string $path directory of the file in UPLOAD_DIR
 	 * @param string $name name of the file without extension
-	 * @return array object containing metadata
+	 * @return array metadata array
 	 */
 	public function getTestMetadata($path = '14/01', $name = 'test')
 	{