From b11794ceacc1f1a30f5c2cf64feba4892eb33b07 Mon Sep 17 00:00:00 2001
From: Mike Jolley <mike.jolley@me.com>
Date: Wed, 29 Jun 2016 12:58:38 +0100
Subject: [PATCH] @Since changes

---
 includes/abstracts/abstract-wc-legacy-order.php | 7 -------
 includes/class-wc-order.php                     | 9 +--------
 includes/wc-order-functions.php                 | 8 ++++----
 includes/wc-template-functions.php              | 2 ++
 4 files changed, 7 insertions(+), 19 deletions(-)

diff --git a/includes/abstracts/abstract-wc-legacy-order.php b/includes/abstracts/abstract-wc-legacy-order.php
index 8f4076373e3..d9baa87f5b6 100644
--- a/includes/abstracts/abstract-wc-legacy-order.php
+++ b/includes/abstracts/abstract-wc-legacy-order.php
@@ -21,7 +21,6 @@ abstract class WC_Abstract_Legacy_Order extends WC_Data {
 	 *
 	 * Note this does not update order totals.
 	 *
-	 * @since 2.2
 	 * @param object|int $item order item ID or item object.
 	 * @param WC_Product $product
 	 * @param array $args data to update.
@@ -71,7 +70,6 @@ abstract class WC_Abstract_Legacy_Order extends WC_Data {
 
 	/**
 	 * Update coupon for order. Note this does not update order totals.
-	 * @since 2.2
 	 * @param object|int $item
 	 * @param array $args
 	 * @return int updated order item ID
@@ -110,7 +108,6 @@ abstract class WC_Abstract_Legacy_Order extends WC_Data {
 	 *
 	 * Note this does not update the order total.
 	 *
-	 * @since 2.2
 	 * @param object|int $item
 	 * @param array $args
 	 * @return int updated order item ID
@@ -147,7 +144,6 @@ abstract class WC_Abstract_Legacy_Order extends WC_Data {
 	 *
 	 * Note this does not update order totals.
 	 *
-	 * @since 2.2
 	 * @param object|int $item
 	 * @param array $args
 	 * @return int updated order item ID
@@ -220,7 +216,6 @@ abstract class WC_Abstract_Legacy_Order extends WC_Data {
 
 	/**
 	 * Set the customer address.
-	 * @since 2.2.0
 	 * @param array $address Address data.
 	 * @param string $type billing or shipping.
 	 */
@@ -235,7 +230,6 @@ abstract class WC_Abstract_Legacy_Order extends WC_Data {
 
 	/**
 	 * Set an order total.
-	 * @since 2.2.0
 	 * @param float $amount
 	 * @param string $total_type
 	 * @return bool
@@ -499,7 +493,6 @@ abstract class WC_Abstract_Legacy_Order extends WC_Data {
 	 * Expand item meta into the $item array.
 	 * @deprecated 2.7.0 Item meta no longer expanded due to new order item
 	 *		classes. This function now does nothing to avoid data breakage.
-	 * @since 2.4.0
 	 * @param array $item before expansion.
 	 * @return array
 	 */
diff --git a/includes/class-wc-order.php b/includes/class-wc-order.php
index 5ba261a7bf4..e6a7fbd51c2 100644
--- a/includes/class-wc-order.php
+++ b/includes/class-wc-order.php
@@ -508,7 +508,7 @@ class WC_Order extends WC_Abstract_Order {
 	 * @return string
 	 */
 	public function get_billing_email() {
-		return sanitize_email( $this->_data['billing']['email'] );
+		return $this->_data['billing']['email'];
 	}
 
 	/**
@@ -685,9 +685,6 @@ class WC_Order extends WC_Abstract_Order {
 
 	/**
 	 * Get a formatted billing full name.
-	 *
-	 * @since 2.4.0
-	 *
 	 * @return string
 	 */
 	public function get_formatted_billing_full_name() {
@@ -696,9 +693,6 @@ class WC_Order extends WC_Abstract_Order {
 
 	/**
 	 * Get a formatted shipping full name.
-	 *
-	 * @since 2.4.0
-	 *
 	 * @return string
 	 */
 	public function get_formatted_shipping_full_name() {
@@ -908,7 +902,6 @@ class WC_Order extends WC_Abstract_Order {
 
 	/**
 	 * Set the payment method.
-	 * @since 2.2.0
 	 * @param string $payment_method Supports WC_Payment_Gateway for bw compatibility with < 2.7
 	 */
 	public function set_payment_method( $payment_method = '' ) {
diff --git a/includes/wc-order-functions.php b/includes/wc-order-functions.php
index c8e004dc471..f98f722f130 100644
--- a/includes/wc-order-functions.php
+++ b/includes/wc-order-functions.php
@@ -1059,7 +1059,7 @@ function wc_order_search( $term ) {
 /**
  * Update total sales amount for each product within a paid order.
  *
- * @since 2.6.0
+ * @since 2.7.0
  * @param int $order_id
  */
 function wc_update_total_sales_counts( $order_id ) {
@@ -1093,7 +1093,7 @@ add_action( 'woocommerce_order_status_on-hold', 'wc_update_total_sales_counts' )
 /**
  * Update used coupon amount for each coupon within an order.
  *
- * @since 2.6.0
+ * @since 2.7.0
  * @param int $order_id
  */
 function wc_update_coupon_usage_counts( $order_id ) {
@@ -1144,7 +1144,7 @@ add_action( 'woocommerce_order_status_cancelled', 'wc_update_total_sales_counts'
 
 /**
  * When a payment is complete, we can reduce stock levels for items within an order.
- * @since 2.6.0
+ * @since 2.7.0
  * @param int $order_id
  */
 function wc_maybe_reduce_stock_levels( $order_id ) {
@@ -1157,7 +1157,7 @@ add_action( 'woocommerce_payment_complete', 'wc_maybe_reduce_stock_levels' );
 
 /**
  * Reduce stock levels for items within an order.
- * @since 2.6.0
+ * @since 2.7.0
  * @param int $order_id
  */
 function wc_reduce_stock_levels( $order_id ) {
diff --git a/includes/wc-template-functions.php b/includes/wc-template-functions.php
index 80202307ce3..30b0efed763 100644
--- a/includes/wc-template-functions.php
+++ b/includes/wc-template-functions.php
@@ -2255,6 +2255,7 @@ if ( ! function_exists( 'wc_get_email_order_items' ) ) {
 if ( ! function_exists( 'wc_display_item_meta' ) ) {
 	/**
 	 * Display item meta data.
+	 * @since  2.7.0
 	 * @param  WC_Item $item
 	 * @param  array   $args
 	 * @return string|void
@@ -2295,6 +2296,7 @@ if ( ! function_exists( 'wc_display_item_meta' ) ) {
 if ( ! function_exists( 'wc_display_item_downloads' ) ) {
 	/**
 	 * Display item download links.
+	 * @since  2.7.0
 	 * @param  WC_Item $item
 	 * @param  array   $args
 	 * @return string|void