4.1 Docs Audit: Improve inline documentation for various wpdb methods.

#30469.

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


git-svn-id: http://core.svn.wordpress.org/trunk@30614 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Drew Jaynes 2014-11-28 12:34:25 +00:00
parent e11c0a9d3e
commit 9d1a4afda8
2 changed files with 9 additions and 10 deletions

View File

@ -4,7 +4,7 @@
*
* @global string $wp_version
*/
$wp_version = '4.1-beta2-30623';
$wp_version = '4.1-beta2-30624';
/**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.

View File

@ -1964,13 +1964,13 @@ class wpdb {
}
/**
* Adds field charsets to field/value/format arrays
* generated by the process_field_formats() method.
* Adds field charsets to field/value/format arrays generated by
* the {@see wpdb::process_field_formats()} method.
*
* @since 4.1.0
* @access protected
*
* @param array $data As it comes from the process_field_formats() method.
* @param array $data As it comes from the {@see wpdb::process_field_formats()} method.
* @param string $table Table name.
* @return The same array as $data with additional 'charset' keys.
*/
@ -2161,7 +2161,7 @@ class wpdb {
* @access protected
*
* @param string $table Table name.
* @return string|WP_Error Table character set, `WP_Error` object if it couldn't be found.
* @return string|WP_Error Table character set, {@see WP_Error} object if it couldn't be found.
*/
protected function get_table_charset( $table ) {
$table = strtolower( $table );
@ -2254,9 +2254,8 @@ class wpdb {
*
* @param string $table Table name.
* @param string $column Column name.
* @return mixed Column character set as a string.
* False if the column has no character set.
* `WP_Error` object if there was an error.
* @return mixed Column character set as a string. False if the column has no
* character set. {@see WP_Error} object if there was an error.
*/
protected function get_col_charset( $table, $column ) {
$table = strtolower( $table );
@ -2347,7 +2346,7 @@ class wpdb {
* @return array|WP_Error The $data parameter, with invalid characters removed from
* each value. This works as a passthrough: any additional keys
* such as 'field' are retained in each value array. If we cannot
* remove invalid characters, a `WP_Error` object is returned.
* remove invalid characters, a {@see WP_Error} object is returned.
*/
protected function strip_invalid_text( $data ) {
// Some multibyte character sets that we can check in PHP.
@ -2469,7 +2468,7 @@ class wpdb {
* @access protected
*
* @param string $query Query to convert.
* @return string|WP_Error The converted query, or a `WP_Error` object if the conversion fails.
* @return string|WP_Error The converted query, or a {@see WP_Error} object if the conversion fails.
*/
protected function strip_invalid_text_from_query( $query ) {
$table = $this->get_table_from_query( $query );