Upstream/WordPress
1
0
Fork 0
mirror of https://github.com/WordPress/WordPress.git synced 2024-12-22 17:18:32 +01:00
Code Issues Projects Releases Wiki Activity

After [33843], update the location of some files in This filter is documented in docs

Browse Source 
Props dimadin.
See #33413.

Built from https://develop.svn.wordpress.org/trunk@33954


git-svn-id: http://core.svn.wordpress.org/trunk@33923 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Scott Taylor 2015-09-08 22:17:26 +00:00
parent 3d8199c4eb
commit c1bb5b5ce3
23 changed files with 61 additions and 61 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
wp-includes/bookmark.php
View File

@ -378,7 +378,7 @@ function sanitize_bookmark_field($field, $value, $bookmark_id, $context) {
return $value;
if ( 'edit' == $context ) {
/** This filter is documented in wp-includes/post.php */
/** This filter is documented in wp-includes/post-functions.php */
$value = apply_filters( "edit_$field", $value, $bookmark_id );
if ( 'link_notes' == $field ) {
@ -387,10 +387,10 @@ function sanitize_bookmark_field($field, $value, $bookmark_id, $context) {
$value = esc_attr($value);
}
} elseif ( 'db' == $context ) {
/** This filter is documented in wp-includes/post.php */
/** This filter is documented in wp-includes/post-functions.php */
$value = apply_filters( "pre_$field", $value );
} else {
/** This filter is documented in wp-includes/post.php */
/** This filter is documented in wp-includes/post-functions.php */
$value = apply_filters( $field, $value, $bookmark_id, $context );
if ( 'attribute' == $context ) {

2
wp-includes/class-snoopy.php
View File

@ -1,7 +1,7 @@
<?php
/**
* Deprecated. Use WP_HTTP (http.php, class-http.php) instead.
* Deprecated. Use WP_HTTP (http.php) instead.
*/
_deprecated_file( basename( __FILE__ ), '3.0', WPINC . '/http.php' );

4
wp-includes/class-wp-http-curl.php
View File

@ -114,10 +114,10 @@ class WP_Http_Curl {
$is_local = isset($r['local']) && $r['local'];
$ssl_verify = isset($r['sslverify']) && $r['sslverify'];
if ( $is_local ) {
/** This filter is documented in wp-includes/class-http.php */
/** This filter is documented in wp-includes/class-wp-http-streams.php */
$ssl_verify = apply_filters( 'https_local_ssl_verify', $ssl_verify );
} elseif ( ! $is_local ) {
/** This filter is documented in wp-includes/class-http.php */
/** This filter is documented in wp-includes/class-wp-http-streams.php */
$ssl_verify = apply_filters( 'https_ssl_verify', $ssl_verify );
}

14
wp-includes/comment-functions.php
View File

@ -1020,7 +1020,7 @@ function wp_delete_comment($comment_id, $force_delete = false) {
clean_comment_cache($comment_id);
/** This action is documented in wp-includes/comment.php */
/** This action is documented in wp-includes/comment-functions.php */
do_action( 'wp_set_comment_status', $comment_id, 'delete' );
wp_transition_comment_status('delete', $comment->comment_approved, $comment);
@ -1452,7 +1452,7 @@ function wp_filter_comment($commentdata) {
*/
$commentdata['user_id'] = apply_filters( 'pre_user_id', $commentdata['user_ID'] );
} elseif ( isset( $commentdata['user_id'] ) ) {
/** This filter is documented in wp-includes/comment.php */
/** This filter is documented in wp-includes/comment-functions.php */
$commentdata['user_id'] = apply_filters( 'pre_user_id', $commentdata['user_id'] );
}
@ -1464,7 +1464,7 @@ function wp_filter_comment($commentdata) {
* @param int $comment_agent The comment author's browser user agent.
*/
$commentdata['comment_agent'] = apply_filters( 'pre_comment_user_agent', ( isset( $commentdata['comment_agent'] ) ? $commentdata['comment_agent'] : '' ) );
/** This filter is documented in wp-includes/comment.php */
/** This filter is documented in wp-includes/comment-functions.php */
$commentdata['comment_author'] = apply_filters( 'pre_comment_author_name', $commentdata['comment_author'] );
/**
* Filter the comment content before it is set.
@ -1482,9 +1482,9 @@ function wp_filter_comment($commentdata) {
* @param int $comment_author_ip The comment author's IP.
*/
$commentdata['comment_author_IP'] = apply_filters( 'pre_comment_user_ip', $commentdata['comment_author_IP'] );
/** This filter is documented in wp-includes/comment.php */
/** This filter is documented in wp-includes/comment-functions.php */
$commentdata['comment_author_url'] = apply_filters( 'pre_comment_author_url', $commentdata['comment_author_url'] );
/** This filter is documented in wp-includes/comment.php */
/** This filter is documented in wp-includes/comment-functions.php */
$commentdata['comment_author_email'] = apply_filters( 'pre_comment_author_email', $commentdata['comment_author_email'] );
$commentdata['filtered'] = true;
return $commentdata;
@ -1899,7 +1899,7 @@ function wp_update_comment_count_now($post_id) {
* @param int $old The old comment count.
*/
do_action( 'wp_update_comment_count', $post_id, $new, $old );
/** This action is documented in wp-includes/post.php */
/** This action is documented in wp-includes/post-functions.php */
do_action( 'edit_post', $post_id, $post );
return true;
@ -2381,7 +2381,7 @@ function _close_comments_for_old_post( $open, $post_id ) {
$post = get_post($post_id);
/** This filter is documented in wp-includes/comment.php */
/** This filter is documented in wp-includes/comment-functions.php */
$post_types = apply_filters( 'close_comments_for_post_types', array( 'post' ) );
if ( ! in_array( $post->post_type, $post_types ) )
return $open;

2
wp-includes/cron.php
View File

@ -316,7 +316,7 @@ function spawn_cron( $gmt_time = 0 ) {
'args' => array(
'timeout' => 0.01,
'blocking' => false,
/** This filter is documented in wp-includes/class-http.php */
/** This filter is documented in wp-includes/class-wp-http-streams.php */
'sslverify' => apply_filters( 'https_local_ssl_verify', false )
)
) );

2
wp-includes/media.php
View File

@ -706,7 +706,7 @@ function wp_get_attachment_image_src( $attachment_id, $size = 'thumbnail', $icon
$src = false;
if ( $icon && $src = wp_mime_type_icon( $attachment_id ) ) {
/** This filter is documented in wp-includes/post.php */
/** This filter is documented in wp-includes/post-functions.php */
$icon_dir = apply_filters( 'icon_dir', ABSPATH . WPINC . '/images/media' );
$src_file = $icon_dir . '/' . wp_basename( $src );

14
wp-includes/meta-functions.php
View File

@ -533,7 +533,7 @@ function metadata_exists( $meta_type, $object_id, $meta_key ) {
return false;
}
/** This filter is documented in wp-includes/meta.php */
/** This filter is documented in wp-includes/meta-functions.php */
$check = apply_filters( "get_{$meta_type}_metadata", null, $object_id, $meta_key, true );
if ( null !== $check )
return (bool) $check;
@ -654,11 +654,11 @@ function update_metadata_by_mid( $meta_type, $meta_id, $meta_value, $meta_key =
$where = array();
$where[$id_column] = $meta_id;
/** This action is documented in wp-includes/meta.php */
/** This action is documented in wp-includes/meta-functions.php */
do_action( "update_{$meta_type}_meta", $meta_id, $object_id, $meta_key, $_meta_value );
if ( 'post' == $meta_type ) {
/** This action is documented in wp-includes/meta.php */
/** This action is documented in wp-includes/meta-functions.php */
do_action( 'update_postmeta', $meta_id, $object_id, $meta_key, $meta_value );
}
@ -670,11 +670,11 @@ function update_metadata_by_mid( $meta_type, $meta_id, $meta_value, $meta_key =
// Clear the caches.
wp_cache_delete($object_id, $meta_type . '_meta');
/** This action is documented in wp-includes/meta.php */
/** This action is documented in wp-includes/meta-functions.php */
do_action( "updated_{$meta_type}_meta", $meta_id, $object_id, $meta_key, $_meta_value );
if ( 'post' == $meta_type ) {
/** This action is documented in wp-includes/meta.php */
/** This action is documented in wp-includes/meta-functions.php */
do_action( 'updated_postmeta', $meta_id, $object_id, $meta_key, $meta_value );
}
@ -722,7 +722,7 @@ function delete_metadata_by_mid( $meta_type, $meta_id ) {
if ( $meta = get_metadata_by_mid( $meta_type, $meta_id ) ) {
$object_id = $meta->{$column};
/** This action is documented in wp-includes/meta.php */
/** This action is documented in wp-includes/meta-functions.php */
do_action( "delete_{$meta_type}_meta", (array) $meta_id, $object_id, $meta->meta_key, $meta->meta_value );
// Old-style action.
@ -746,7 +746,7 @@ function delete_metadata_by_mid( $meta_type, $meta_id ) {
// Clear the caches.
wp_cache_delete($object_id, $meta_type . '_meta');
/** This action is documented in wp-includes/meta.php */
/** This action is documented in wp-includes/meta-functions.php */
do_action( "deleted_{$meta_type}_meta", (array) $meta_id, $object_id, $meta->meta_key, $meta->meta_value );
// Old-style action.

18
wp-includes/post-functions.php
View File

@ -2077,7 +2077,7 @@ function wp_count_posts( $type = 'post', $perm = '' ) {
$counts = wp_cache_get( $cache_key, 'counts' );
if ( false !== $counts ) {
/** This filter is documented in wp-includes/post.php */
/** This filter is documented in wp-includes/post-functions.php */
return apply_filters( 'wp_count_posts', $counts, $type, $perm );
}
@ -3391,16 +3391,16 @@ function wp_publish_post( $post ) {
$post->post_status = 'publish';
wp_transition_post_status( 'publish', $old_status, $post );
/** This action is documented in wp-includes/post.php */
/** This action is documented in wp-includes/post-functions.php */
do_action( 'edit_post', $post->ID, $post );
/** This action is documented in wp-includes/post.php */
/** This action is documented in wp-includes/post-functions.php */
do_action( "save_post_{$post->post_type}", $post->ID, $post, true );
/** This action is documented in wp-includes/post.php */
/** This action is documented in wp-includes/post-functions.php */
do_action( 'save_post', $post->ID, $post, true );
/** This action is documented in wp-includes/post.php */
/** This action is documented in wp-includes/post-functions.php */
do_action( 'wp_insert_post', $post->ID, $post, true );
}
@ -4297,7 +4297,7 @@ function get_pages( $args = array() ) {
if ( $cache = wp_cache_get( $cache_key, 'posts' ) ) {
// Convert to WP_Post instances.
$pages = array_map( 'get_post', $cache );
/** This filter is documented in wp-includes/post.php */
/** This filter is documented in wp-includes/post-functions.php */
$pages = apply_filters( 'get_pages', $pages, $r );
return $pages;
}
@ -4439,7 +4439,7 @@ function get_pages( $args = array() ) {
$pages = $wpdb->get_results($query);
if ( empty($pages) ) {
/** This filter is documented in wp-includes/post.php */
/** This filter is documented in wp-includes/post-functions.php */
$pages = apply_filters( 'get_pages', array(), $r );
return $pages;
}
@ -4624,13 +4624,13 @@ function wp_delete_attachment( $post_id, $force_delete = false ) {
foreach ( $post_meta_ids as $mid )
delete_metadata_by_mid( 'post', $mid );
/** This action is documented in wp-includes/post.php */
/** This action is documented in wp-includes/post-functions.php */
do_action( 'delete_post', $post_id );
$result = $wpdb->delete( $wpdb->posts, array( 'ID' => $post_id ) );
if ( ! $result ) {
return false;
}
/** This action is documented in wp-includes/post.php */
/** This action is documented in wp-includes/post-functions.php */
do_action( 'deleted_post', $post_id );
$uploadpath = wp_upload_dir();

22
wp-includes/taxonomy-functions.php
View File

@ -814,10 +814,10 @@ function get_term_by($field, $value, $taxonomy, $output = OBJECT, $filter = 'raw
wp_cache_add( $term->term_id, $term, $taxonomy );
/** This filter is documented in wp-includes/taxonomy.php */
/** This filter is documented in wp-includes/taxonomy-functions.php */
$term = apply_filters( 'get_term', $term, $taxonomy );
/** This filter is documented in wp-includes/taxonomy.php */
/** This filter is documented in wp-includes/taxonomy-functions.php */
$term = apply_filters( "get_$taxonomy", $term, $taxonomy );
$term = sanitize_term($term, $taxonomy, $filter);
@ -1366,7 +1366,7 @@ function get_terms( $taxonomies, $args = '' ) {
if ( empty($terms) ) {
wp_cache_add( $cache_key, array(), 'terms', DAY_IN_SECONDS );
/** This filter is documented in wp-includes/taxonomy.php */
/** This filter is documented in wp-includes/taxonomy-functions.php */
return apply_filters( 'get_terms', array(), $taxonomies, $args );
}
@ -2336,11 +2336,11 @@ function wp_insert_term( $term, $taxonomy, $args = array() ) {
if ( empty($slug) ) {
$slug = sanitize_title($slug, $term_id);
/** This action is documented in wp-includes/taxonomy.php */
/** This action is documented in wp-includes/taxonomy-functions.php */
do_action( 'edit_terms', $term_id, $taxonomy );
$wpdb->update( $wpdb->terms, compact( 'slug' ), compact( 'term_id' ) );
/** This action is documented in wp-includes/taxonomy.php */
/** This action is documented in wp-includes/taxonomy-functions.php */
do_action( 'edited_terms', $term_id, $taxonomy );
}
@ -2976,7 +2976,7 @@ function wp_update_term( $term_id, $taxonomy, $args = array() ) {
*/
do_action( "edit_$taxonomy", $term_id, $tt_id );
/** This filter is documented in wp-includes/taxonomy.php */
/** This filter is documented in wp-includes/taxonomy-functions.php */
$term_id = apply_filters( 'term_id_filter', $term_id, $tt_id );
clean_term_cache($term_id, $taxonomy);
@ -3528,11 +3528,11 @@ function _update_post_term_count( $terms, $taxonomy ) {
if ( $object_types )
$count += (int) $wpdb->get_var( $wpdb->prepare( "SELECT COUNT(*) FROM $wpdb->term_relationships, $wpdb->posts WHERE $wpdb->posts.ID = $wpdb->term_relationships.object_id AND post_status = 'publish' AND post_type IN ('" . implode("', '", $object_types ) . "') AND term_taxonomy_id = %d", $term ) );
/** This action is documented in wp-includes/taxonomy.php */
/** This action is documented in wp-includes/taxonomy-functions.php */
do_action( 'edit_term_taxonomy', $term, $taxonomy->name );
$wpdb->update( $wpdb->term_taxonomy, compact( 'count' ), array( 'term_taxonomy_id' => $term ) );
/** This action is documented in wp-includes/taxonomy.php */
/** This action is documented in wp-includes/taxonomy-functions.php */
do_action( 'edited_term_taxonomy', $term, $taxonomy->name );
}
}
@ -3555,11 +3555,11 @@ function _update_generic_term_count( $terms, $taxonomy ) {
foreach ( (array) $terms as $term ) {
$count = $wpdb->get_var( $wpdb->prepare( "SELECT COUNT(*) FROM $wpdb->term_relationships WHERE term_taxonomy_id = %d", $term ) );
/** This action is documented in wp-includes/taxonomy.php */
/** This action is documented in wp-includes/taxonomy-functions.php */
do_action( 'edit_term_taxonomy', $term, $taxonomy->name );
$wpdb->update( $wpdb->term_taxonomy, compact( 'count' ), array( 'term_taxonomy_id' => $term ) );
/** This action is documented in wp-includes/taxonomy.php */
/** This action is documented in wp-includes/taxonomy-functions.php */
do_action( 'edited_term_taxonomy', $term, $taxonomy->name );
}
}
@ -4230,7 +4230,7 @@ function get_ancestors( $object_id = 0, $object_type = '', $resource_type = '' )
if ( empty( $object_id ) ) {
/** This filter is documented in wp-includes/taxonomy.php */
/** This filter is documented in wp-includes/taxonomy-functions.php */
return apply_filters( 'get_ancestors', $ancestors, $object_id, $object_type, $resource_type );
}

6
wp-includes/user-functions.php
View File

@ -997,7 +997,7 @@ function sanitize_user_field($field, $value, $user_id, $context) {
if ( 'edit' == $context ) {
if ( $prefixed ) {
/** This filter is documented in wp-includes/post.php */
/** This filter is documented in wp-includes/post-functions.php */
$value = apply_filters( "edit_{$field}", $value, $user_id );
} else {
@ -1021,7 +1021,7 @@ function sanitize_user_field($field, $value, $user_id, $context) {
$value = esc_attr($value);
} elseif ( 'db' == $context ) {
if ( $prefixed ) {
/** This filter is documented in wp-includes/post.php */
/** This filter is documented in wp-includes/post-functions.php */
$value = apply_filters( "pre_{$field}", $value );
} else {
@ -1041,7 +1041,7 @@ function sanitize_user_field($field, $value, $user_id, $context) {
// Use display filters by default.
if ( $prefixed ) {
/** This filter is documented in wp-includes/post.php */
/** This filter is documented in wp-includes/post-functions.php */
$value = apply_filters( $field, $value, $user_id, $context );
} else {

2
wp-includes/version.php
View File

@ -4,7 +4,7 @@
*
* @global string $wp_version
*/
$wp_version = '4.4-alpha-33952';
$wp_version = '4.4-alpha-33954';
/**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.

8
wp-includes/widget-functions.php
View File

@ -518,11 +518,11 @@ function dynamic_sidebar($index = 1) {
$sidebars_widgets = wp_get_sidebars_widgets();
if ( empty( $wp_registered_sidebars[ $index ] ) || empty( $sidebars_widgets[ $index ] ) || ! is_array( $sidebars_widgets[ $index ] ) ) {
/** This action is documented in wp-includes/widgets.php */
/** This action is documented in wp-includes/widget-functions.php */
do_action( 'dynamic_sidebar_before', $index, false );
/** This action is documented in wp-includes/widgets.php */
/** This action is documented in wp-includes/widget-functions.php */
do_action( 'dynamic_sidebar_after', $index, false );
/** This filter is documented in wp-includes/widgets.php */
/** This filter is documented in wp-includes/widget-functions.php */
return apply_filters( 'dynamic_sidebar_has_widgets', false, $index );
}
@ -909,7 +909,7 @@ function wp_convert_widget_settings($base_name, $option_name, $settings) {
*
* @global WP_Widget_Factory $wp_widget_factory
*
* @param string $widget The widget's PHP class name (see default-widgets.php).
* @param string $widget The widget's PHP class name (see class-wp-widget.php).
* @param array $instance Optional. The widget's instance settings. Default empty array.
* @param array $args {
* Optional. Array of arguments to configure the display of the widget.

2
wp-includes/widgets/class-wp-nav-menu-widget.php
View File

@ -24,7 +24,7 @@
if ( !$nav_menu )
return;
/** This filter is documented in wp-includes/default-widgets.php */
/** This filter is documented in wp-includes/widgets/class-wp-widget-pages.php */
$instance['title'] = apply_filters( 'widget_title', empty( $instance['title'] ) ? '' : $instance['title'], $instance, $this->id_base );
echo $args['before_widget'];

2
wp-includes/widgets/class-wp-widget-archives.php
View File

@ -21,7 +21,7 @@ class WP_Widget_Archives extends WP_Widget {
$c = ! empty( $instance['count'] ) ? '1' : '0';
$d = ! empty( $instance['dropdown'] ) ? '1' : '0';
/** This filter is documented in wp-includes/default-widgets.php */
/** This filter is documented in wp-includes/widgets/class-wp-widget-pages.php */
$title = apply_filters( 'widget_title', empty( $instance['title'] ) ? __( 'Archives' ) : $instance['title'], $instance, $this->id_base );
echo $args['before_widget'];

2
wp-includes/widgets/class-wp-widget-calendar.php
View File

@ -18,7 +18,7 @@ class WP_Widget_Calendar extends WP_Widget {
* @param array $instance
*/
public function widget( $args, $instance ) {
/** This filter is documented in wp-includes/default-widgets.php */
/** This filter is documented in wp-includes/widgets/class-wp-widget-pages.php */
$title = apply_filters( 'widget_title', empty( $instance['title'] ) ? '' : $instance['title'], $instance, $this->id_base );
echo $args['before_widget'];

2
wp-includes/widgets/class-wp-widget-categories.php
View File

@ -22,7 +22,7 @@ class WP_Widget_Categories extends WP_Widget {
public function widget( $args, $instance ) {
static $first_dropdown = true;
/** This filter is documented in wp-includes/default-widgets.php */
/** This filter is documented in wp-includes/widgets/class-wp-widget-pages.php */
$title = apply_filters( 'widget_title', empty( $instance['title'] ) ? __( 'Categories' ) : $instance['title'], $instance, $this->id_base );
$c = ! empty( $instance['count'] ) ? '1' : '0';

2
wp-includes/widgets/class-wp-widget-meta.php
View File

@ -20,7 +20,7 @@ class WP_Widget_Meta extends WP_Widget {
* @param array $instance
*/
public function widget( $args, $instance ) {
/** This filter is documented in wp-includes/default-widgets.php */
/** This filter is documented in wp-includes/widgets/class-wp-widget-pages.php */
$title = apply_filters( 'widget_title', empty($instance['title']) ? __( 'Meta' ) : $instance['title'], $instance, $this->id_base );
echo $args['before_widget'];

2
wp-includes/widgets/class-wp-widget-recent-comments.php
View File

@ -73,7 +73,7 @@ class WP_Widget_Recent_Comments extends WP_Widget {
$title = ( ! empty( $instance['title'] ) ) ? $instance['title'] : __( 'Recent Comments' );
/** This filter is documented in wp-includes/default-widgets.php */
/** This filter is documented in wp-includes/widgets/class-wp-widget-pages.php */
$title = apply_filters( 'widget_title', $title, $instance, $this->id_base );
$number = ( ! empty( $instance['number'] ) ) ? absint( $instance['number'] ) : 5;

2
wp-includes/widgets/class-wp-widget-recent-posts.php
View File

@ -45,7 +45,7 @@ class WP_Widget_Recent_Posts extends WP_Widget {
$title = ( ! empty( $instance['title'] ) ) ? $instance['title'] : __( 'Recent Posts' );
/** This filter is documented in wp-includes/default-widgets.php */
/** This filter is documented in wp-includes/widgets/class-wp-widget-pages.php */
$title = apply_filters( 'widget_title', $title, $instance, $this->id_base );
$number = ( ! empty( $instance['number'] ) ) ? absint( $instance['number'] ) : 5;

2
wp-includes/widgets/class-wp-widget-rss.php
View File

@ -50,7 +50,7 @@ class WP_Widget_RSS extends WP_Widget {
if ( empty($title) )
$title = empty($desc) ? __('Unknown Feed') : $desc;
/** This filter is documented in wp-includes/default-widgets.php */
/** This filter is documented in wp-includes/widgets/class-wp-widget-pages.php */
$title = apply_filters( 'widget_title', $title, $instance, $this->id_base );
$url = strip_tags( $url );

2
wp-includes/widgets/class-wp-widget-search.php
View File

@ -18,7 +18,7 @@ class WP_Widget_Search extends WP_Widget {
* @param array $instance
*/
public function widget( $args, $instance ) {
/** This filter is documented in wp-includes/default-widgets.php */
/** This filter is documented in wp-includes/widgets/class-wp-widget-pages.php */
$title = apply_filters( 'widget_title', empty( $instance['title'] ) ? '' : $instance['title'], $instance, $this->id_base );
echo $args['before_widget'];

2
wp-includes/widgets/class-wp-widget-tag-cloud.php
View File

@ -30,7 +30,7 @@ class WP_Widget_Tag_Cloud extends WP_Widget {
}
}
/** This filter is documented in wp-includes/default-widgets.php */
/** This filter is documented in wp-includes/widgets/class-wp-widget-pages.php */
$title = apply_filters( 'widget_title', $title, $instance, $this->id_base );
echo $args['before_widget'];

2
wp-includes/widgets/class-wp-widget-text.php
View File

@ -19,7 +19,7 @@ class WP_Widget_Text extends WP_Widget {
* @param array $instance
*/
public function widget( $args, $instance ) {
/** This filter is documented in wp-includes/default-widgets.php */
/** This filter is documented in wp-includes/widgets/class-wp-widget-pages.php */
$title = apply_filters( 'widget_title', empty( $instance['title'] ) ? '' : $instance['title'], $instance, $this->id_base );
/**