diff --git a/lib/imap/imap_client.dart b/lib/imap/imap_client.dart
index 793b24e7..fa48020c 100644
--- a/lib/imap/imap_client.dart
+++ b/lib/imap/imap_client.dart
@@ -1690,7 +1690,7 @@ class ImapClient extends ClientBase {
   }
 
   /// Closes the connection. Deprecated: use `disconnect()` instead.
-  @deprecated
+  @Deprecated('Use disconnect() instead.')
   Future<dynamic> closeConnection() {
     log('Closing socket for host ${serverInfo.host}',
         initial: ClientBase.initialApp);
diff --git a/lib/mail/mail_client.dart b/lib/mail/mail_client.dart
index fe73ff51..665fec25 100644
--- a/lib/mail/mail_client.dart
+++ b/lib/mail/mail_client.dart
@@ -775,7 +775,7 @@ class MailClient {
     bool? isAnswered,
     bool? isForwarded,
     bool? isDeleted,
-    @deprecated bool? isMdnSent,
+    @Deprecated('use isReadRecieptSent instead') bool? isMdnSent,
     bool? isReadReceiptSent,
   }) {
     if (isSeen != null) {
diff --git a/lib/mime_message.dart b/lib/mime_message.dart
index 7d218938..e1292a6b 100644
--- a/lib/mime_message.dart
+++ b/lib/mime_message.dart
@@ -479,15 +479,11 @@ class MimeMessage extends MimePart {
   set isDeleted(bool value) => setFlag(MessageFlags.deleted, value);
 
   /// Checks if a read receipt has been sent for this message
-  ///
-  /// Compare [isReadReceiptSent]
-  @deprecated
+  @Deprecated('Use isReadReceiptSent instead')
   bool get isMdnSent => hasFlag(MessageFlags.keywordMdnSent);
 
   /// Sets the `$MDNSent` keyword flag for this message
-  ///
-  /// Use [isReadReceiptSent] instead
-  @deprecated
+  @Deprecated('Use isReadReceiptSent instead')
   set isMdnSent(bool value) => setFlag(MessageFlags.keywordMdnSent, value);
 
   /// Checks if a read receipt has been sent for this message
diff --git a/lib/pop/pop_client.dart b/lib/pop/pop_client.dart
index 8d71363d..a77f0c7a 100644
--- a/lib/pop/pop_client.dart
+++ b/lib/pop/pop_client.dart
@@ -202,7 +202,7 @@ class PopClient extends ClientBase {
   }
 
   /// Closes the connection. Deprecated: use `disconnect()` instead.
-  @deprecated
+  @Deprecated('Use disconnect() instead')
   Future<dynamic> closeConnection() {
     return disconnect();
   }
diff --git a/lib/smtp/smtp_client.dart b/lib/smtp/smtp_client.dart
index 00094e6a..a5adf291 100644
--- a/lib/smtp/smtp_client.dart
+++ b/lib/smtp/smtp_client.dart
@@ -285,8 +285,8 @@ class SmtpClient extends ClientBase {
         text, use8BitEncoding, from, recipients.map((r) => r.email).toList()));
   }
 
-  /// Signs in the user with the given [name] and [password]. Deprecated: Please use authenticate() instead.
-  @deprecated
+  /// Signs in the user with the given [name] and [password].
+  @Deprecated('Please use authenticate() instead.')
   Future<SmtpResponse> login(String name, String password,
       {AuthMechanism authMechanism = AuthMechanism.plain}) {
     return authenticate(name, password, authMechanism);
@@ -360,8 +360,8 @@ class SmtpClient extends ClientBase {
     }
   }
 
-  /// Closes the connection to the remote SMTP server. Deprectated: Please use `disconnect()` instead.
-  @deprecated
+  /// Closes the connection to the remote SMTP server.
+  @Deprecated('Please use `disconnect()` instead.')
   Future<dynamic> closeConnection() {
     return disconnect();
   }