From db9daf1deac3a9aadef1afd76ca0c72b94dccd04 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rub=C3=A9n=20Calvo?= <rubencm@gmail.com>
Date: Mon, 25 Jun 2018 17:35:01 +0200
Subject: [PATCH] [ticket/15342] Fix docblock

PHPBB3-15342
---
 phpBB/phpbb/storage/adapter/adapter_interface.php |  2 +-
 phpBB/phpbb/storage/adapter/local.php             |  8 ++------
 phpBB/phpbb/storage/storage.php                   | 11 +++++++++++
 3 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/phpBB/phpbb/storage/adapter/adapter_interface.php b/phpBB/phpbb/storage/adapter/adapter_interface.php
index 96617c8e6a..6584a7255f 100644
--- a/phpBB/phpbb/storage/adapter/adapter_interface.php
+++ b/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
 	 */
diff --git a/phpBB/phpbb/storage/adapter/local.php b/phpBB/phpbb/storage/adapter/local.php
index fd0fbe84d8..b23d251ee7 100644
--- a/phpBB/phpbb/storage/adapter/local.php
+++ b/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()
 	{
diff --git a/phpBB/phpbb/storage/storage.php b/phpBB/phpbb/storage/storage.php
index 63369af7e8..71d3ea5ed2 100644
--- a/phpBB/phpbb/storage/storage.php
+++ b/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(