[ticket/15342] Fix docblock

PHPBB3-15342

phpBB/phpbb/storage/adapter/adapter_interface.php

@@ -99,7 +99,7 @@ interface adapter_interface
 	/*
 	 * Get space available in bytes.
 	 *
-	 * @throws \phpbb\storage\exception\exception		When can't get available space
+	 * @throws \phpbb\storage\exception\exception		When unable to retrieve available storage spac
 	 *
 	 * @return int	Returns available space
 	 */

phpBB/phpbb/storage/adapter/local.php

@@ -425,12 +425,8 @@ class local implements adapter_interface, stream_interface
 		return generate_board_url() . $this->path . $path;
 	}
 
-	/*
-	 * Get space available in bytes.
-	 *
-	 * @throws \phpbb\storage\exception\exception		When can't get available space
-	 *
-	 * @return int	Returns available space
+	/**
+	 * {@inheritdoc}
 	 */
 	public function free_space()
 	{

phpBB/phpbb/storage/storage.php

@@ -235,6 +235,12 @@ class storage
 		}
 	}
 
+	/**
+	 * Track file into database.
+	 *
+	 * @param string	$path		The target file
+	 * @param bool		$update		Update file size when already tracked
+	 */
 	public function track_file($path, $update = false)
 	{
 		$sql_ary = array(
@@ -270,6 +276,11 @@ class storage
 		$this->cache->destroy('_storage_' . $this->get_name() . '_numfiles');
 	}
 
+	/**
+	 * Untrack file.
+	 *
+	 * @param string	$path		The target file
+	 */
 	public function untrack_file($path)
 	{
 		$sql_ary = array(