[ticket/13421] Inherit docs

PHPBB3-13421

phpBB/phpbb/db/tools.php

@@ -371,9 +371,7 @@ class tools implements tools_interface
 	}
 
 	/**
-	* Gets a list of tables in the database.
+	 * {@inheritDoc}
-	*
-	* @return array		Array of table names  (all lower case)
 	 */
 	function sql_list_tables()
 	{
@@ -431,11 +429,7 @@ class tools implements tools_interface
 	}
 
 	/**
-	* Check if table exists
+	 * {@inheritDoc}
-	*
-	*
-	* @param string	$table_name	The table name to check for
-	* @return bool true if table exists, else false
 	 */
 	function sql_table_exists($table_name)
 	{
@@ -453,11 +447,7 @@ class tools implements tools_interface
 	}
 
 	/**
-	* Create SQL Table
+	 * {@inheritDoc}
-	*
-	* @param string	$table_name	The table name to create
-	* @param array	$table_data	Array containing table data.
-	* @return array	Statements if $return_statements is true.
 	 */
 	function sql_create_table($table_name, $table_data)
 	{
@@ -679,26 +669,7 @@ class tools implements tools_interface
 	}
 
 	/**
-	* Handle passed database update array.
+	 * {@inheritDoc}
-	* Expected structure...
-	* Key being one of the following
-	*	drop_tables: Drop tables
-	*	add_tables: Add tables
-	*	change_columns: Column changes (only type, not name)
-	*	add_columns: Add columns to a table
-	*	drop_keys: Dropping keys
-	*	drop_columns: Removing/Dropping columns
-	*	add_primary_keys: adding primary keys
-	*	add_unique_index: adding an unique index
-	*	add_index: adding an index (can be column:index_size if you need to provide size)
-	*
-	* The values are in this format:
-	*		{TABLE NAME}		=> array(
-	*			{COLUMN NAME}		=> array({COLUMN TYPE}, {DEFAULT VALUE}, {OPTIONAL VARIABLES}),
-	*			{KEY/INDEX NAME}	=> array({COLUMN NAMES}),
-	*		)
-	*
-	* For more information have a look at /develop/create_schema_files.php (only available through SVN)
 	 */
 	function perform_schema_changes($schema_changes)
 	{
@@ -1079,11 +1050,7 @@ class tools implements tools_interface
 	}
 
 	/**
-	* Gets a list of columns of a table.
+	 * {@inheritDoc}
-	*
-	* @param string $table_name		Table name
-	*
-	* @return array				Array of column names (all lower case)
 	 */
 	function sql_list_columns($table_name)
 	{
@@ -1173,12 +1140,7 @@ class tools implements tools_interface
 	}
 
 	/**
-	* Check whether a specified column exist in a table
+	 * {@inheritDoc}
-	*
-	* @param string	$table_name		Table to check
-	* @param string	$column_name	Column to check
-	*
-	* @return bool		True if column exists, false otherwise
 	 */
 	function sql_column_exists($table_name, $column_name)
 	{
@@ -1188,12 +1150,7 @@ class tools implements tools_interface
 	}
 
 	/**
-	* Check if a specified index exists in table. Does not return PRIMARY KEY and UNIQUE indexes.
+	 * {@inheritDoc}
-	*
-	* @param string	$table_name		Table to check the index at
-	* @param string	$index_name		The index name to check
-	*
-	* @return bool True if index exists, else false
 	 */
 	function sql_index_exists($table_name, $index_name)
 	{
@@ -1285,12 +1242,7 @@ class tools implements tools_interface
 	}
 
 	/**
-	* Check if a specified index exists in table. Does not return PRIMARY KEY indexes.
+	 * {@inheritDoc}
-	*
-	* @param string	$table_name		Table to check the index at
-	* @param string	$index_name		The index name to check
-	*
-	* @return bool True if index exists, else false
 	 */
 	function sql_unique_index_exists($table_name, $index_name)
 	{
@@ -1684,7 +1636,7 @@ class tools implements tools_interface
 	}
 
 	/**
-	* Add new column
+	 * {@inheritDoc}
 	 */
 	function sql_column_add($table_name, $column_name, $column_data, $inline = false)
 	{
@@ -1802,7 +1754,7 @@ class tools implements tools_interface
 	}
 
 	/**
-	* Drop column
+	 * {@inheritDoc}
 	 */
 	function sql_column_remove($table_name, $column_name, $inline = false)
 	{
@@ -1931,7 +1883,7 @@ class tools implements tools_interface
 	}
 
 	/**
-	* Drop Index
+	 * {@inheritDoc}
 	 */
 	function sql_index_drop($table_name, $index_name)
 	{
@@ -1961,7 +1913,7 @@ class tools implements tools_interface
 	}
 
 	/**
-	* Drop Table
+	 * {@inheritDoc}
 	 */
 	function sql_table_drop($table_name)
 	{
@@ -2014,7 +1966,7 @@ class tools implements tools_interface
 	}
 
 	/**
-	* Add primary key
+	 * {@inheritDoc}
 	 */
 	function sql_create_primary_key($table_name, $column, $inline = false)
 	{
@@ -2098,7 +2050,7 @@ class tools implements tools_interface
 	}
 
 	/**
-	* Add unique index
+	 * {@inheritDoc}
 	 */
 	function sql_create_unique_index($table_name, $index_name, $column)
 	{
@@ -2135,7 +2087,7 @@ class tools implements tools_interface
 	}
 
 	/**
-	* Add index
+	 * {@inheritDoc}
 	 */
 	function sql_create_index($table_name, $index_name, $column)
 	{
@@ -2188,10 +2140,7 @@ class tools implements tools_interface
 	}
 
 	/**
-	* List all of the indices that belong to a table,
+	 * {@inheritDoc}
-	* does not count:
-	* * UNIQUE indices
-	* * PRIMARY keys
 	 */
 	function sql_list_index($table_name)
 	{
@@ -2287,7 +2236,7 @@ class tools implements tools_interface
 	}
 
 	/**
-	* Change column type (not name!)
+	 * {@inheritDoc}
 	 */
 	function sql_column_change($table_name, $column_name, $column_data, $inline = false)
 	{