From 0939c9eea54964c92d4d215ca5f2593fad6eef00 Mon Sep 17 00:00:00 2001
From: priyakohl <114220343+priyakohl@users.noreply.github.com>
Date: Mon, 16 Oct 2023 17:07:35 +0530
Subject: [PATCH] Deprecating Tizen.Messaging.Email APIs (#5596)

* Deprecating Tizen.Messaging.Email APIs

Signed-off-by: Priya Kohli <priya.kohli@samsung.com>

* Added using System

Signed-off-by: Priya Kohli <priya.kohli@samsung.com>

* Modified Note

Signed-off-by: Priya Kohli <priya.kohli@samsung.com>

---------

Signed-off-by: Priya Kohli <priya.kohli@samsung.com>
Co-authored-by: randeepsingh01 <49635973+randeepsingh01@users.noreply.github.com>
---
 src/Tizen.Messaging/Tizen.Messaging.Email/EmailAttachment.cs   |  5 +++++
 src/Tizen.Messaging/Tizen.Messaging.Email/EmailEnumerations.cs |  3 +++
 src/Tizen.Messaging/Tizen.Messaging.Email/EmailMessage.cs      | 10 ++++++++++
 src/Tizen.Messaging/Tizen.Messaging.Email/EmailRecipient.cs    |  5 +++++
 src/Tizen.Messaging/Tizen.Messaging.Email/EmailSender.cs       |  2 ++
 src/Tizen.Messaging/doc/api/Tizen.Messaging.Email.md           |  4 ++++
 6 files changed, 29 insertions(+)

diff --git a/src/Tizen.Messaging/Tizen.Messaging.Email/EmailAttachment.cs b/src/Tizen.Messaging/Tizen.Messaging.Email/EmailAttachment.cs
index b561ddc..9f3a44d 100644
--- a/src/Tizen.Messaging/Tizen.Messaging.Email/EmailAttachment.cs
+++ b/src/Tizen.Messaging/Tizen.Messaging.Email/EmailAttachment.cs
@@ -14,23 +14,28 @@
  * limitations under the License.
  */
 
+using System;
+
 namespace Tizen.Messaging.Email
 {
     /// <summary>
     /// Represents an email attachment.
     /// </summary>
     /// <since_tizen> 3 </since_tizen>
+    [Obsolete("Deprecated since API11. Might be removed in API13")]
     public class EmailAttachment
     {
         /// <summary>
         /// The absolute full path of the file to be attached.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13")]
         public string FilePath { get; set; }
         /// <summary>
         /// The constructor.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13")]
         public EmailAttachment()
         {
 
diff --git a/src/Tizen.Messaging/Tizen.Messaging.Email/EmailEnumerations.cs b/src/Tizen.Messaging/Tizen.Messaging.Email/EmailEnumerations.cs
index 36d3117..13a58b5 100755
--- a/src/Tizen.Messaging/Tizen.Messaging.Email/EmailEnumerations.cs
+++ b/src/Tizen.Messaging/Tizen.Messaging.Email/EmailEnumerations.cs
@@ -14,12 +14,15 @@
 * limitations under the License.
 */
 
+using System;
+
 namespace Tizen.Messaging.Email
 {
     /// <summary>
     /// Result of sending the email.
     /// </summary>
     /// <since_tizen> 3 </since_tizen>
+    [Obsolete("Deprecated since API11. Might be removed in API13")]
     public enum EmailSendResult
     {
         /// <summary>
diff --git a/src/Tizen.Messaging/Tizen.Messaging.Email/EmailMessage.cs b/src/Tizen.Messaging/Tizen.Messaging.Email/EmailMessage.cs
index 65306b0..664d41f 100644
--- a/src/Tizen.Messaging/Tizen.Messaging.Email/EmailMessage.cs
+++ b/src/Tizen.Messaging/Tizen.Messaging.Email/EmailMessage.cs
@@ -24,6 +24,7 @@ namespace Tizen.Messaging.Email
     /// This class contains the Messaging API to support sending email messages.
     /// </summary>
     /// <since_tizen> 3 </since_tizen>
+    [Obsolete("Deprecated since API11. Might be removed in API13")]
     public class EmailMessage : IDisposable
     {
         internal IntPtr _emailHandle = IntPtr.Zero;
@@ -39,6 +40,7 @@ namespace Tizen.Messaging.Email
         /// The constructor.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13")]
         public EmailMessage()
         {
             int ret = Interop.Email.CreateEmail(out _emailHandle);
@@ -53,6 +55,7 @@ namespace Tizen.Messaging.Email
         /// The subject of the email message.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13")]
         public string Subject
         {
             set
@@ -76,6 +79,7 @@ namespace Tizen.Messaging.Email
         /// The body of the email message.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13")]
         public string Body
         {
             set
@@ -98,6 +102,7 @@ namespace Tizen.Messaging.Email
         /// The list of file attachments.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+[Obsolete("Deprecated since API11. Might be removed in API13")]
         public IList<EmailAttachment> Attachments
         {
             get
@@ -113,6 +118,7 @@ namespace Tizen.Messaging.Email
         /// The email address should be in the standard format (as described in the Internet standards RFC 5321 and RFC 5322).
         /// </remarks>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13")]
         public ICollection<EmailRecipient> To
         {
             get
@@ -128,6 +134,7 @@ namespace Tizen.Messaging.Email
         /// The email address should be in the standard format (as described in the Internet standards RFC 5321 and RFC 5322).
         /// </remarks>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13")]
         public ICollection<EmailRecipient> Cc
         {
             get
@@ -143,6 +150,7 @@ namespace Tizen.Messaging.Email
         /// The email address should be in the standard format (as described in the Internet standards RFC 5321 and RFC 5322).
         /// </remarks>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13")]
         public ICollection<EmailRecipient> Bcc
         {
             get
@@ -169,6 +177,7 @@ namespace Tizen.Messaging.Email
         /// Releases all resources used by the EmailMessage.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13")]
         public void Dispose()
         {
             Dispose(true);
@@ -180,6 +189,7 @@ namespace Tizen.Messaging.Email
         /// </summary>
         /// <param name="disposing">Disposing by User</param>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13")]
         protected virtual void Dispose(bool disposing)
         {
             if (_disposed)
diff --git a/src/Tizen.Messaging/Tizen.Messaging.Email/EmailRecipient.cs b/src/Tizen.Messaging/Tizen.Messaging.Email/EmailRecipient.cs
index 69ff503..c5ca528 100644
--- a/src/Tizen.Messaging/Tizen.Messaging.Email/EmailRecipient.cs
+++ b/src/Tizen.Messaging/Tizen.Messaging.Email/EmailRecipient.cs
@@ -14,23 +14,28 @@
  * limitations under the License.
  */
 
+using System;
+
 namespace Tizen.Messaging.Email
 {
     /// <summary>
     /// This class represents recipients of an email.
     /// </summary>
     /// <since_tizen> 3 </since_tizen>
+    [Obsolete("Deprecated since API11. Might be removed in API13")]
     public class EmailRecipient
     {
         /// <summary>
         /// The email address of the recipient.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13")]
         public string Address { get; set; }
         /// <summary>
         /// The constructor.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13")]
         public EmailRecipient()
         {
 
diff --git a/src/Tizen.Messaging/Tizen.Messaging.Email/EmailSender.cs b/src/Tizen.Messaging/Tizen.Messaging.Email/EmailSender.cs
index 3d60634..648c034 100644
--- a/src/Tizen.Messaging/Tizen.Messaging.Email/EmailSender.cs
+++ b/src/Tizen.Messaging/Tizen.Messaging.Email/EmailSender.cs
@@ -24,6 +24,7 @@ namespace Tizen.Messaging.Email
     /// This class is used to send email messages.
     /// </summary>
     /// <since_tizen> 3 </since_tizen>
+    [Obsolete("Deprecated since API11. Might be removed in API13")]
     public static class EmailSender
     {
         static private Dictionary<int, Interop.Email.EmailSentCallback> _sendCbMap = new Dictionary<int, Interop.Email.EmailSentCallback>();
@@ -35,6 +36,7 @@ namespace Tizen.Messaging.Email
         /// <param name="email">The email message.</param>
         /// <returns> Failure if the email sending activity failed, otherwise Success.</returns>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13")]
         public static async Task<EmailSendResult> SendAsync(EmailMessage email)
         {
             var task = new TaskCompletionSource<EmailSendResult>();
diff --git a/src/Tizen.Messaging/doc/api/Tizen.Messaging.Email.md b/src/Tizen.Messaging/doc/api/Tizen.Messaging.Email.md
index def7ad1..2058551 100644
--- a/src/Tizen.Messaging/doc/api/Tizen.Messaging.Email.md
+++ b/src/Tizen.Messaging/doc/api/Tizen.Messaging.Email.md
@@ -15,4 +15,8 @@
 
 uid: Tizen.Messaging.Email
 summary: The Tizen.Messaging.Email namespace contains classes providing the functionality to send emails.
+
+> [!NOTE]
+> All Email APIs have been deprecated since Tizen 8.0 (API Level 11) which means they are planned to be removed after two releases.
+
 ---
-- 
2.7.4