1
0
mirror of https://github.com/phpbb/phpbb.git synced 2025-03-14 04:30:29 +01:00

[ticket/13429] Replace @changed with @change in event docblocks

PHPBB3-13429
This commit is contained in:
Jakub Senko 2016-11-20 17:58:59 +01:00
parent dbd9c1f242
commit c2836725f9
12 changed files with 36 additions and 36 deletions

View File

@ -2636,7 +2636,7 @@ function add_form_key($form_name, $template_variable_suffix = '')
* @var string template_variable_suffix The string that is appended to template variable name
*
* @since 3.1.0-RC3
* @changed 3.1.11-RC1 Added template_variable_suffix
* @change 3.1.11-RC1 Added template_variable_suffix
*/
$vars = array(
'form_name',
@ -2928,7 +2928,7 @@ function login_box($redirect = '', $l_explain = '', $l_success = '', $admin = fa
* @var string redirect Redirect string
* @var bool admin Is admin?
* @since 3.1.0-RC5
* @changed 3.1.9-RC1 Removed undefined return variable
* @change 3.1.9-RC1 Removed undefined return variable
*/
$vars = array('redirect', 'admin');
extract($phpbb_dispatcher->trigger_event('core.login_box_redirect', compact($vars)));
@ -4310,7 +4310,7 @@ function obtain_users_online_string($online_users, $item_id = 0, $item = 'forum'
* session_forum_id
* @var array sql_ary SQL query array to obtain users online data
* @since 3.1.4-RC1
* @changed 3.1.7-RC1 Change sql query into array and adjust var accordingly. Allows extension authors the ability to adjust the sql_ary.
* @change 3.1.7-RC1 Change sql query into array and adjust var accordingly. Allows extension authors the ability to adjust the sql_ary.
*/
$vars = array('online_users', 'item_id', 'item', 'sql_ary');
extract($phpbb_dispatcher->trigger_event('core.obtain_users_online_string_sql', compact($vars)));

View File

@ -2611,7 +2611,7 @@ function prune($forum_id, $prune_mode, $prune_date, $prune_flags = 0, $auto_sync
* @var string sql_and SQL text appended to where clause
* @var int prune_limit The prune limit
* @since 3.1.3-RC1
* @changed 3.1.10-RC1 Added prune_limit
* @change 3.1.10-RC1 Added prune_limit
*/
$vars = array(
'forum_id',

View File

@ -556,7 +556,7 @@ function change_poster(&$post_info, $userdata)
* @var array userdata Information on a post's new poster
* @var array post_info Information on the affected post
* @since 3.1.6-RC1
* @changed 3.1.7-RC1 Change location to prevent post_info from being set to the new post information
* @change 3.1.7-RC1 Change location to prevent post_info from being set to the new post information
*/
$vars = array('userdata', 'post_info');
extract($phpbb_dispatcher->trigger_event('core.mcp_change_poster_after', compact($vars)));

View File

@ -267,7 +267,7 @@ function view_message($id, $mode, $folder_id, $msg_id, $folder, $message_row)
* @var array msg_data Template array with message data
* @var array user_info User data of the sender
* @since 3.1.0-a1
* @changed 3.1.6-RC1 Added user_info into event
* @change 3.1.6-RC1 Added user_info into event
*/
$vars = array(
'id',

View File

@ -69,7 +69,7 @@ class ucp_prefs
* @var array data Array with current ucp options data
* @var array error Array with list of errors
* @since 3.1.0-a1
* @changed 3.1.4-RC1 Added error variable to the event
* @change 3.1.4-RC1 Added error variable to the event
*/
$vars = array('submit', 'data', 'error');
extract($phpbb_dispatcher->trigger_event('core.ucp_prefs_personal_data', compact($vars)));

View File

@ -665,8 +665,8 @@ switch ($mode)
* @var bool foe Is the user foe?
* @var array profile_fields Array with user's profile field data
* @since 3.1.0-a1
* @changed 3.1.0-b2 Added friend and foe status
* @changed 3.1.0-b3 Added profile fields data
* @change 3.1.0-b2 Added friend and foe status
* @change 3.1.0-b3 Added profile fields data
*/
$vars = array(
'member',

View File

@ -186,7 +186,7 @@ class upload extends \phpbb\avatar\driver\driver
* @var array row Array with avatar row data
* @var array error Array of errors, if filled in by this event file will not be moved
* @since 3.1.6-RC1
* @changed 3.1.9-RC1 Added filedata
* @change 3.1.9-RC1 Added filedata
*/
$vars = array(
'filedata',

View File

@ -508,9 +508,9 @@ class php_exporter
}
/**
* Find the "@changed" Information lines
* Find the "@change" Information lines
*
* @param string $tag_name Should be 'changed' or 'change'
* @param string $tag_name Should be 'change', not 'changed'
* @return array Absolute line numbers
* @throws \LogicException
*/
@ -648,7 +648,7 @@ class php_exporter
}
/**
* Validate "@changed" Information
* Validate "@change" Information
*
* @param string $line
* @return string
@ -658,10 +658,10 @@ class php_exporter
{
$match = array();
$line = str_replace("\t", ' ', ltrim($line, "\t "));
preg_match('#^\* @change(d)? (\d+\.\d+\.\d+(?:-(?:a|b|RC|pl)\d+)?)( (?:.*))?$#', $line, $match);
preg_match('#^\* @change (\d+\.\d+\.\d+(?:-(?:a|b|RC|pl)\d+)?)( (?:.*))?$#', $line, $match);
if (!isset($match[2]))
{
throw new \LogicException("Invalid '@changed' information for event "
throw new \LogicException("Invalid '@change' information for event "
. "'{$this->current_event}' in file '{$this->current_file}:{$this->current_event_line}'");
}

View File

@ -373,7 +373,7 @@ switch ($mode)
* @var bool is_authed Does the user have the required permissions?
* @var array post_data All post data from database
* @since 3.1.3-RC1
* @changed 3.1.10-RC1 Added post_data
* @change 3.1.10-RC1 Added post_data
*/
$vars = array(
'post_id',
@ -1385,7 +1385,7 @@ if ($submit || $preview || $refresh)
* @var bool update_subject Boolean if the post subject was changed
* NOTE: Should be actual language strings, NOT language keys.
* @since 3.1.0-RC5
* @changed 3.1.6-RC1 remove submit and error from event Submit and Error are checked previously prior to running event
* @change 3.1.6-RC1 remove submit and error from event Submit and Error are checked previously prior to running event
*/
$vars = array(
'post_data',
@ -1424,7 +1424,7 @@ if ($submit || $preview || $refresh)
* @var string redirect_url URL the user is going to be redirected to
* NOTE: Should be actual language strings, NOT language keys.
* @since 3.1.0-RC5
* @changed 3.1.6-RC1 remove submit and error from event Submit and Error are checked previously prior to running event
* @change 3.1.6-RC1 remove submit and error from event Submit and Error are checked previously prior to running event
*/
$vars = array(
'post_data',

View File

@ -343,7 +343,7 @@ if ($keywords || $author || $author_id || $search_id || $submit)
* @var array id_ary Array of post or topic ids for search result
* @var string show_results 'posts' or 'topics' type of ids
* @since 3.1.3-RC1
* @changed 3.1.10-RC1 Added id_ary, show_results
* @change 3.1.10-RC1 Added id_ary, show_results
*/
$vars = array(
'keywords',
@ -692,8 +692,8 @@ if ($keywords || $author || $author_id || $search_id || $submit)
* @var int total_match_count The total number of search matches
* @var array ex_fid_ary Array of excluded forum ids
* @since 3.1.7-RC1
* @changed 3.1.10-RC1 Added show_results, sql_where, total_match_count
* @changed 3.1.11-RC1 Added ex_fid_ary
* @change 3.1.10-RC1 Added show_results, sql_where, total_match_count
* @change 3.1.11-RC1 Added ex_fid_ary
*/
$vars = array(
'u_search',
@ -830,8 +830,8 @@ if ($keywords || $author || $author_id || $search_id || $submit)
* @var string sort_key The sorting key
* @var string sql_order_by The SQL ORDER BY string used by search to get topic data
* @since 3.1.0-a1
* @changed 3.1.0-RC5 Added total_match_count
* @changed 3.1.7-RC1 Added sort_by_sql, sort_dir, sort_key, sql_order_by
* @change 3.1.0-RC5 Added total_match_count
* @change 3.1.7-RC1 Added sort_by_sql, sort_dir, sort_key, sql_order_by
*/
$vars = array(
'sql_select',
@ -1021,7 +1021,7 @@ if ($keywords || $author || $author_id || $search_id || $submit)
* @var string view Search results view mode
* @var array zebra Array with zebra data for the current user
* @since 3.1.0-b4
* @changed 3.1.0-b5 Added var show_results
* @change 3.1.0-b5 Added var show_results
*/
$vars = array(
'attachments',
@ -1198,7 +1198,7 @@ if ($keywords || $author || $author_id || $search_id || $submit)
* @var array zebra The zebra data of the current user
* @var array attachments All the attachments of the search results
* @since 3.1.0-a1
* @changed 3.1.0-b3 Added vars show_results, topic_title, replies,
* @change 3.1.0-b3 Added vars show_results, topic_title, replies,
* view_topic_url, folder_img, folder_alt, topic_type, unread_topic,
* topic_unapproved, posts_unapproved, topic_deleted, u_mcp_queue,
* zebra, attachments
@ -1302,7 +1302,7 @@ if ($keywords || $author || $author_id || $search_id || $submit)
* @var int total_match_count The count of search results
* @var string keywords The search keywords
* @since 3.1.0-RC4
* @changed 3.1.6-RC1 Added total_match_count and keywords
* @change 3.1.6-RC1 Added total_match_count and keywords
*/
$vars = array(
'author_id',

View File

@ -631,7 +631,7 @@ $sql_ary = array(
*
* @since 3.1.0-RC4
*
* @changed 3.1.3 Added forum_data
* @change 3.1.3 Added forum_data
*/
$vars = array(
'forum_data',
@ -945,7 +945,7 @@ if (sizeof($topic_list))
* @var bool s_type_switch_test Flag indicating if the test topic type is [global] announcement
* @since 3.1.0-a1
*
* @changed 3.1.10-RC1 Added s_type_switch, s_type_switch_test
* @change 3.1.10-RC1 Added s_type_switch, s_type_switch_test
*/
$vars = array('row', 'topic_row', 's_type_switch', 's_type_switch_test');
extract($phpbb_dispatcher->trigger_event('core.viewforum_modify_topicrow', compact($vars)));

View File

@ -552,7 +552,7 @@ class phpbb_event_php_exporter_test extends phpbb_test_case
'* @since 3.1.0-a1',
'/**',
'* @since 3.1.0-a1',
'* @changed 3.1.0-a2',
'* @change 3.1.0-a2',
'*/',
'$phpbb_dispatcher->dispatch(\'test\');',
),
@ -590,9 +590,9 @@ class phpbb_event_php_exporter_test extends phpbb_test_case
array(
array(
'/**',
'* @changed 3.1.0-a1',
'* @changed 3.1.0-a2',
'* @changed 3.1.0-a3',
'* @change 3.1.0-a1',
'* @change 3.1.0-a2',
'* @change 3.1.0-a3',
'*/',
'$phpbb_dispatcher->dispatch(\'test\');',
),
@ -657,7 +657,7 @@ class phpbb_event_php_exporter_test extends phpbb_test_case
' * Hello Bertie!',
' *',
' * @since 3.1.0-a1',
' * @changed 3.1.0-a2',
' * @change 3.1.0-a2',
' */',
' $phpbb_dispatcher->dispatch(\'test\');',
),
@ -691,9 +691,9 @@ class phpbb_event_php_exporter_test extends phpbb_test_case
array(
array(
'/**',
'* @changed 3.1.0-a1',
'* @changed 3.1.0-a2',
'* @changed 3.1.0-a3',
'* @change 3.1.0-a1',
'* @change 3.1.0-a2',
'* @change 3.1.0-a3',
'*/',
'$phpbb_dispatcher->dispatch(\'test\');',
),