📚 Fix deprecated constants rdoc

Also, revert to default section after flags are read

Author: nevans

lib/net/imap/flags.rb

@@ -257,5 +257,6 @@ class IMAP < Protocol
     # special use is likely not to be supported.
     TRASH = :Trash
 
+    # :section:
   end
 end

lib/net/imap/sasl/cram_md5_authenticator.rb

@@ -60,7 +60,7 @@ def hmac_md5(text, key)
       end
     end
 
-    CramMD5Authenticator = SASL::CramMD5Authenticator
+    CramMD5Authenticator = SASL::CramMD5Authenticator # :nodoc:
     deprecate_constant :CramMD5Authenticator
 
   end

lib/net/imap/sasl/digest_md5_authenticator.rb

@@ -340,7 +340,7 @@ def qdval(k, v)
       end
     end
 
-    DigestMD5Authenticator = SASL::DigestMD5Authenticator
+    DigestMD5Authenticator = SASL::DigestMD5Authenticator # :nodoc:
     deprecate_constant :DigestMD5Authenticator
 
   end

lib/net/imap/sasl/login_authenticator.rb

@@ -56,7 +56,7 @@ def initialize(user, password, warn_deprecation: true, **_ignored)
       end
     end
 
-    LoginAuthenticator = SASL::LoginAuthenticator
+    LoginAuthenticator = SASL::LoginAuthenticator # :nodoc:
     deprecate_constant :LoginAuthenticator
 
   end

lib/net/imap/sasl/plain_authenticator.rb

@@ -118,7 +118,7 @@ def propset(name, value)
       end
     end
 
-    PlainAuthenticator = SASL::PlainAuthenticator
+    PlainAuthenticator = SASL::PlainAuthenticator # :nodoc:
     deprecate_constant :PlainAuthenticator
 
   end

lib/net/imap/sasl/xoauth2_authenticator.rb

@@ -105,7 +105,7 @@ def process(data)
       end
     end
 
-    XOauth2Authenticator = SASL::XOAuth2Authenticator
+    XOauth2Authenticator = SASL::XOAuth2Authenticator # :nodoc:
     deprecate_constant :XOauth2Authenticator
 
   end