sisimai 5.0.2-java → 5.1.0-java

data/lib/sisimai/lhost/aol.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::Aol parses a bounce email which created by Aol Mail. Methods in the module are
-  # called from only Sisimai::Message.
+  # Sisimai::Lhost::Aol decodes a bounce email which created by Aol Mail https://mail.aol.com/.
+  # Methods in the module are called from only Sisimai::Message.
   module Aol
     class << self
       require 'sisimai/lhost'
@@ -13,11 +13,11 @@ module Sisimai::Lhost
         'notaccept'   => ['type=MX: Malformed or unexpected name server reply'],
       }.freeze
 
-      # Parse bounce messages from Aol Mail
+      # @abstract Decodes the bounce message from Aol Mail
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         # X-AOL-IP: 192.0.2.135
         # X-AOL-VSS-INFO: 5600.1067/98281

data/lib/sisimai/lhost/apachejames.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::ApacheJames parses a bounce email which created by ApacheJames. Methods in the
-  # module are called from only Sisimai::Message.
+  # Sisimai::Lhost::ApacheJames decodes a bounce email which created by ApacheJames https://james.apache.org/.
+  # Methods in the module are called from only Sisimai::Message.
   module ApacheJames
     class << self
       require 'sisimai/lhost'
@@ -15,11 +15,11 @@ module Sisimai::Lhost
         error:   ['Error message below:'],
       }.freeze
 
-      # Parse bounce messages from Apache James
+      # @abstract decodes the bounce message from Apache James
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         match  = 0
         match += 1 if mhead['subject'] == '[BOUNCE]'

data/lib/sisimai/lhost/barracuda.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::Barracuda parses a bounce email which created by Barracuda. Methods in the module
-  # are called from only Sisimai::Message.
+  # Sisimai::Lhost::Barracuda decodes a bounce email which created by Barracuda https://www.barracuda.com/.
+  # Methods in the module are called from only Sisimai::Message.
   module Barracuda
     class << self
       require 'sisimai/lhost'
@@ -9,11 +9,11 @@ module Sisimai::Lhost
       Boundaries = ['Content-Type: text/rfc822-headers'].freeze
       StartingOf = { message: ['Your message to:'] }.freeze
 
-      # Parse bounce messages from Barracuda
+      # @abstract Decodes the bounce message from Barracuda
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       # @since v4.25.6
       def inquire(mhead, mbody)
         # Subject: **Message you sent blocked by our bulk email filter**

data/lib/sisimai/lhost/bigfoot.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::Bigfoot parses a bounce email which created by Bigfoot. Methods in the module
-  # are called from only Sisimai::Message.
+  # Sisimai::Lhost::Bigfoot decodes a bounce email which created by Bigfoot https://www.bigfoot.com/.
+  # Methods in the module are called from only Sisimai::Message.
   module Bigfoot
     class << self
       require 'sisimai/lhost'
@@ -9,11 +9,11 @@ module Sisimai::Lhost
       Boundaries = ['Content-Type: message/partial'].freeze
       MarkingsOf = { message: '   ----- Transcript of session follows -----' }.freeze
 
-      # Parse bounce messages from Bigfoot
+      # @abstract Decodes the bounce message from Bigfoot
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         # :subject  => %r/\AReturned mail: /,
         match  = 0

data/lib/sisimai/lhost/biglobe.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::Biglobe parses a bounce email which created by BIGLOBE. Methods in the module
-  # are called from only Sisimai::Message.
+  # Sisimai::Lhost::Biglobe decodes a bounce email which created by BIGLOBE https://www.biglobe.ne.jp/.
+  # Methods in the module are called from only Sisimai::Message.
   module Biglobe
     class << self
       require 'sisimai/lhost'
@@ -16,11 +16,11 @@ module Sisimai::Lhost
         'mailboxfull' => ["The number of messages in recipient's mailbox exceeded the local limit."],
       }.freeze
 
-      # Parse bounce messages from Biglobe
+      # @asbtract Decodes the bounce message from Biglobe
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         return nil unless mhead['from'].include?('postmaster@')
         return nil unless %w[biglobe inacatv tmtv ttv].any? { |a| mhead['from'].include?('@' + a + '.ne.jp') }

data/lib/sisimai/lhost/courier.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::Courier parses a bounce email which created by Courier MTA. Methods in the module
-  # are called from only Sisimai::Message.
+  # Sisimai::Lhost::Courier decodes a bounce email which created by Courier MTA https://www.courier-mta.org/.
+  # Methods in the module are called from only Sisimai::Message.
   module Courier
     class << self
       require 'sisimai/lhost'
@@ -23,11 +23,11 @@ module Sisimai::Lhost
         'networkerror' => ['DNS lookup failed.'],
       }.freeze
 
-      # Parse bounce messages from Courier MTA
+      # @abstract Decodes the bounce message from Courier MTA
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         match  = 0
         match += 1 if mhead['from'].include?('Courier mail server at ')

data/lib/sisimai/lhost/domino.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::Domino parses a bounce email which created by IBM Domino Server. Methods in the
-  # module are called from only Sisimai::Message.
+  # Sisimai::Lhost::Domino decodes a bounce email which created by HCL Domino https://www.hcl-software.com/domino.
+  # Methods in the module are called from only Sisimai::Message.
   module Domino
     class << self
       require 'sisimai/lhost'
@@ -20,11 +20,11 @@ module Sisimai::Lhost
         'systemerror' => ['Several matches found in Domino Directory'],
       }.freeze
 
-      # Parse bounce messages from IBM Domino Server
+      # @abstract Decodes the bounce message from HCL Domino (formerly IBM Domino Server (formerly Lotus Domino))
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         return nil unless mhead['subject'].start_with?('DELIVERY FAILURE:', 'DELIVERY_FAILURE:')
 

data/lib/sisimai/lhost/dragonfly.rb

@@ -0,0 +1,114 @@
+module Sisimai::Lhost
+  # Sisimai::Lhost::DragonFly decodes a bounce email which created by DMA: DragonFly Mail Agent
+  # https://www.dragonflybsd.org/handbook/mta/.
+  # Methods in the module are called from only Sisimai::Message.
+  module DragonFly
+    class << self
+      require 'sisimai/lhost'
+      require 'sisimai/address'
+      require 'sisimai/smtp/command'
+
+      Indicators = Sisimai::Lhost.INDICATORS
+      Boundaries = ['Original message follows.', 'Message headers follow'].freeze
+      StartingOf = {
+        # https://github.com/corecode/dma/blob/ffad280aa40c242aa9a2cb9ca5b1b6e8efedd17e/mail.c#L84
+        message: ['This is the DragonFly Mail Agent '],
+      }.freeze
+      MessagesOf = {
+        'expired' => [
+          # https://github.com/corecode/dma/blob/master/dma.c#L370C1-L374C19
+          # dma.c:370| if (gettimeofday(&now, NULL) == 0 &&
+          # dma.c:371|     (now.tv_sec - st.st_mtim.tv_sec > MAX_TIMEOUT)) {
+          # dma.c:372|     snprintf(errmsg, sizeof(errmsg),
+          # dma.c:373|          "Could not deliver for the last %d seconds. Giving up.",
+          # dma.c:374|          MAX_TIMEOUT);
+          # dma.c:375|     goto bounce;
+          # dma.c:376| }
+          'Could not deliver for the last ',
+        ],
+        'hostunknown' => [
+          # net.c:663| snprintf(errmsg, sizeof(errmsg), "DNS lookup failure: host %s not found", host);
+          'DNS lookup failure: host ',
+        ],
+      }.freeze
+
+      # @abstract Decodes the bounce message from DMA: DragonFly Mail Agent
+      # @param  [Hash] mhead    Message headers of a bounce email
+      # @param  [String] mbody  Message body of a bounce email
+      # @return [Hash]          Bounce data list and message/rfc822 part
+      # @return [Nil]           it failed to decode or the arguments are missing
+      def inquire(mhead, mbody)
+        return nil unless mhead['subject'].start_with?('Mail delivery failed')
+        return nil unless mhead['received'].any? { |a| a.include?(' (DragonFly Mail Agent') }
+
+        dscontents = [Sisimai::Lhost.DELIVERYSTATUS]
+        emailparts = Sisimai::RFC5322.part(mbody, Boundaries)
+        bodyslices = emailparts[0].split("\n")
+        readcursor = 0      # (Integer) Points the current cursor position
+        recipients = 0      # (Integer) The number of 'Final-Recipient' header
+        v = nil
+
+        while e = bodyslices.shift do
+          # Read error messages and delivery status lines from the head of the email to the previous
+          # line of the beginning of the original message.
+          if readcursor == 0
+            # Beginning of the bounce message or delivery status part
+            readcursor |= Indicators[:deliverystatus] if e.start_with?(StartingOf[:message][0])
+            next
+          end
+          next if (readcursor & Indicators[:deliverystatus]) == 0
+          next if e.empty?
+
+          # This is the DragonFly Mail Agent v0.13 at df.example.jp.
+          #
+          # There was an error delivering your mail to <kijitora@example.com>.
+          #
+          # email.example.jp [192.0.2.25] did not like our RCPT TO:
+          # 552 5.2.2 <kijitora@example.com>: Recipient address rejected: Mailbox full
+          #
+          # Original message follows.
+          v = dscontents[-1]
+
+          if e.start_with?('There was an error delivering your mail to <')
+            # email.example.jp [192.0.2.25] did not like our RCPT TO:
+            # 552 5.2.2 <kijitora@example.com>: Recipient address rejected: Mailbox full
+            if v['recipient']
+              # There are multiple recipient addresses in the message body.
+              dscontents << Sisimai::Lhost.DELIVERYSTATUS
+              v = dscontents[-1]
+            end
+            v['recipient'] = Sisimai::Address.find(e, false)[0][:address]
+            recipients += 1
+          else
+            # Pick the error message
+            v['diagnosis'] ||= ''
+            v['diagnosis'] << ' ' << e
+
+            # Pick the remote hostname, and the SMTP command
+            # net.c:500| snprintf(errmsg, sizeof(errmsg), "%s [%s] did not like our %s:\n%s",
+            next unless e.include?(' did not like our ')
+            next if v['rhost']
+
+            p = e.split(' ', 3)
+            v['rhost']   = if p[0].include?('.') then p[0] else p[1] end
+            v['command'] = Sisimai::SMTP::Command.find(e) || ''
+          end
+        end
+        return nil unless recipients > 0
+
+        dscontents.each do |e|
+          e['diagnosis'] = Sisimai::String.sweep(e['diagnosis'])
+          MessagesOf.each_key do |r|
+            # Verify each regular expression of session errors
+            next unless MessagesOf[r].any? { |a| e['diagnosis'].include?(a) }
+            e['reason'] = r
+            break
+          end
+        end
+        return { 'ds' => dscontents, 'rfc822' => emailparts[1] }
+      end
+      def description; return 'DragonFly'; end
+    end
+  end
+end
+

data/lib/sisimai/lhost/einsundeins.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::EinsUndEins parses a bounce email which created by 1&1. Methods in the module are
-  # called from only Sisimai::Message.
+  # Sisimai::Lhost::EinsUndEins decodes a bounce email which created by 1&1 https://www.1und1.de/.
+  # Methods in the module are called from only Sisimai::Message.
   module EinsUndEins
     class << self
       require 'sisimai/lhost'
@@ -13,11 +13,11 @@ module Sisimai::Lhost
       }.freeze
       MessagesOf = { 'mesgtoobig' => ['Mail size limit exceeded'] }.freeze
 
-      # Parse bounce messages from 1&1
+      # @abstract Decode the bounce message from 1&1
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         return nil unless mhead['from'].start_with?('"Mail Delivery System"')
         return nil unless mhead['subject'] == 'Mail delivery failed: returning message to sender'

data/lib/sisimai/lhost/exchange2003.rb

@@ -1,5 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::Exchange2003 parses a bounce email which created by Microsoft Exchange Server 2003.
+  # Sisimai::Lhost::Exchange2003 decodes a bounce email which created by Microsoft Exchange Server
+  # 2003 https://www.microsoft.com/microsoft-365/exchange/email.
   # Methods in the module are called from only Sisimai::Message.
   module Exchange2003
     class << self
@@ -39,11 +40,11 @@ module Sisimai::Lhost
         ],
       }.freeze
 
-      # Parse bounce messages from Microsoft Exchange Server 2003
+      # @abstract Decodes the bounce message from Microsoft Exchange Server 2003
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         match = 0
         tryto = []

data/lib/sisimai/lhost/exchange2007.rb

@@ -1,5 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::Exchange2007 parses a bounce email which created by Microsoft Exchange Server 2007.
+  # Sisimai::Lhost::Exchange2007 decodes a bounce email which created by Microsoft Exchange Server
+  # 2007 https://www.microsoft.com/microsoft-365/exchange/email.
   # Methods in the module are called from only Sisimai::Message.
   module Exchange2007
     class << self
@@ -39,11 +40,11 @@ module Sisimai::Lhost
         'QUEUE.Expired'                  => 'expired',       # 550 4.4.7 QUEUE.Expired
       }.freeze
 
-      # Parse bounce messages from Microsoft Exchange Server 2007
+      # @abstract Decodes the bounce message from Microsoft Exchange Server 2007
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         # Content-Language: en-US, fr-FR
         match   = nil

data/lib/sisimai/lhost/exim.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::Exim parses a bounce email which created by Exim. Methods in the module are called
-  # from only Sisimai::Message.
+  # Sisimai::Lhost::Exim decodes a bounce email which created by Exim Internet Mailer https://www.exim.org/.
+  # Methods in the module are called from only Sisimai::Message.
   module Exim
     class << self
       require 'sisimai/lhost'
@@ -117,11 +117,11 @@ module Sisimai::Lhost
         'was frozen on arrival by ',
       ].freeze
 
-      # Parse bounce messages from Exim
+      # @abstract Decodes the bounce message from Exim
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         return nil if mhead['from'].include?('.mail.ru')
 

data/lib/sisimai/lhost/ezweb.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::EZweb parses a bounce email which created by au EZweb. Methods in the module are
-  # called from only Sisimai::Message.
+  # Sisimai::Lhost::EZweb decodes a bounce email which created by au EZweb https://www.au.com/mobile/.
+  # Methods in the module are called from only Sisimai::Message.
   module EZweb
     class << self
       require 'sisimai/lhost'
@@ -25,11 +25,11 @@ module Sisimai::Lhost
         'onhold' => ['Each of the following recipients was rejected by a remote mail server'],
       }.freeze
 
-      # Parse bounce messages from au EZweb
+      # @abstract Decodes the bounce message from au EZweb
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         match  = 0
         match += 1 if mhead['from'].include?('Postmaster@ezweb.ne.jp')

data/lib/sisimai/lhost/facebook.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::Facebook parses a bounce email which created by Facebook. Methods in the module
-  # are called from only Sisimai::Message.
+  # Sisimai::Lhost::Facebook decodes a bounce email which created by Facebook https://www.facebook.com.
+  # Methods in the module are called from only Sisimai::Message.
   module Facebook
     class << self
       require 'sisimai/lhost'
@@ -68,11 +68,11 @@ module Sisimai::Lhost
         ],
       }.freeze
 
-      # Parse bounce messages from Facebook
+      # @abstract Decodes the bounce message from Facebook
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         return nil unless mhead['from'] == 'Facebook <mailer-daemon@mx.facebook.com>'
         return nil unless mhead['subject'] == 'Sorry, your message could not be delivered'

data/lib/sisimai/lhost/fml.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::FML parses a bounce email which created by fml. Methods in the module are called
-  # from only Sisimai::Message.
+  # Sisimai::Lhost::FML decodes a bounce email which created by fml mailing list server/manager
+  # https://www.fml.org/. Methods in the module are called from only Sisimai::Message.
   module FML
     class << self
       require 'sisimai/lhost'
@@ -38,11 +38,11 @@ module Sisimai::Lhost
         'securityerror' => ['Security alert:'],
       }.freeze
 
-      # Parse bounce messages from fml mailling list server/manager
+      # @abstract Decodes the bounce message from fml mailling list server/manager
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       # @since v4.22.3
       def inquire(mhead, mbody)
         return nil unless mhead['x-mlserver']

data/lib/sisimai/lhost/gmail.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::Gmail parses a bounce email which created by Gmail. Methods in the module are
-  # called from only Sisimai::Message.
+  # Sisimai::Lhost::Gmail decodes a bounce email which created by Gmail https://mail.google.com/.
+  # Methods in the module are called from only Sisimai::Message.
   module Gmail
     class << self
       require 'sisimai/lhost'
@@ -96,11 +96,11 @@ module Sisimai::Lhost
         '18' => { 'command' => 'DATA', 'reason' => 'filtered' },
       }.freeze
 
-      # Parse bounce messages from Gmail
+      # @abstract Decodes the bounce message from Gmail
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         # From: Mail Delivery Subsystem <mailer-daemon@googlemail.com>
         # Received: from vw-in-f109.1e100.net [74.125.113.109] by ...

data/lib/sisimai/lhost/gmx.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::GMX parses a bounce email which created by GMX. Methods in the module are called
-  # from only Sisimai::Message.
+  # Sisimai::Lhost::GMX decodes a bounce email which created by GMX https://gmx.net/.
+  # Methods in the module are called from only Sisimai::Message.
   module GMX
     class << self
       require 'sisimai/lhost'
@@ -10,11 +10,11 @@ module Sisimai::Lhost
       StartingOf = { message: ['This message was created automatically by mail delivery software'] }.freeze
       MessagesOf = { 'expired' => ['delivery retry timeout exceeded'] }.freeze
 
-      # Parse bounce messages from GMX
+      # @abstract Decodes the bounce message from GMX
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         # Envelope-To: <kijitora@mail.example.com>
         # X-GMX-Antispam: 0 (Mail was not recognized as spam); Detail=V3;

data/lib/sisimai/lhost/googlegroups.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::GoogleGroups parses a bounce email which created by Google Groups. Methods in the
-  # module are called from only Sisimai::Message.
+  # Sisimai::Lhost::GoogleGroups decodes a bounce email which created by Google Groups https://groups.google.com.
+  # Methods in the module are called from only Sisimai::Message.
   module GoogleGroups
     class << self
       require 'sisimai/lhost'
@@ -8,11 +8,11 @@ module Sisimai::Lhost
       Indicators = Sisimai::Lhost.INDICATORS
       Boundaries = ['----- Original message -----'].freeze
 
-      # Parse bounce messages from Google Groups
+      # @abstract Decodes the bounce message from Google Groups
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       # @since v4.25.6
       def inquire(mhead, mbody)
         return nil unless mhead['from'].end_with?('<mailer-daemon@googlemail.com>')

data/lib/sisimai/lhost/gsuite.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::GSuite parses a bounce email which created by G Suite. Methods in the module are
-  # called from only Sisimai::Message.
+  # Sisimai::Lhost::GSuite decodes a bounce email which created by Google Workspace https://workspace.google.com/.
+  # Methods in the module are called from only Sisimai::Message.
   module GSuite
     class << self
       require 'sisimai/lhost'
@@ -17,11 +17,11 @@ module Sisimai::Lhost
         'networkerror' => [' had no relevant answers.', ' responded with code NXDOMAIN'],
       }.freeze
 
-      # Parse bounce messages from G Suite (Transfer from G Suite to a destinaion host)
+      # @abstract Decodes the bounce message from G Suite (Transfer from G Suite to a destinaion host)
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         return nil unless mhead['from'].end_with?('<mailer-daemon@googlemail.com>')
         return nil unless mhead['subject'].start_with?('Delivery Status Notification')

data/lib/sisimai/lhost/imailserver.rb

@@ -1,5 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::IMailServer parses a bounce email which created by Ipswitch IMail Server.
+  # Sisimai::Lhost::IMailServer decodes a bounce email which created by Progress iMail Server
+  # https://community.progress.com/s/products/imailserver.
   # Methods in the module are called from only Sisimai::Message.
   module IMailServer
     class << self
@@ -16,11 +17,11 @@ module Sisimai::Lhost
         'expired'       => ['Delivery failed '],
       }.freeze
 
-      # Parse bounce messages from IMailServer
+      # @abstract Decodes the bounce message from Progress iMail Server
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         # X-Mailer: <SMTP32 v8.22>
         match  = 0

data/lib/sisimai/lhost/interscanmss.rb

@@ -1,16 +1,17 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::InterScanMSS parses a bounce email which created by Trend Micro InterScan Messaging
-  # Security Suite. Methods in the module are called from only Sisimai::Message.
+  # Sisimai::Lhost::InterScanMSS decodes a bounce email which created by Trend Micro InterScan
+  # Messaging Security Suite https://www.trendmicro.com/en_us/business/products/user-protection/sps/email-and-collaboration/interscan-messaging.html.
+  # Methods in the module are called from only Sisimai::Message.
   module InterScanMSS
     class << self
       require 'sisimai/lhost'
       Boundaries = ['Content-Type: message/rfc822'].freeze
 
-      # Parse bounce messages from InterScanMSS
+        # @abstract Decodes the bounce message from Trend Micro InterScanMSS Messaging Secutiry Suie
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         # :received => %r/[ ][(]InterScanMSS[)][ ]with[ ]/,
         match = 0

data/lib/sisimai/lhost/kddi.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::KDDI parses a bounce email which created by au by KDDI. Methods in the module are
-  # called from only Sisimai::Message.
+  # Sisimai::Lhost::KDDI decodes a bounce email which created by au by KDDI https://www.au.com/.
+  # Methods in the module are called from only Sisimai::Message.
   module KDDI
     class << self
       require 'sisimai/lhost'
@@ -14,11 +14,11 @@ module Sisimai::Lhost
         'hostunknown' => ['As the remote domain doesnt exist'],
       }.freeze
 
-      # Parse bounce messages from au by KDDI
+      # @abstract Decodes the bounce message from au by KDDI
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         # :'message-id' => %r/[@].+[.]ezweb[.]ne[.]jp[>]\z/,
         match  = 0

data/lib/sisimai/lhost/mailfoundry.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::MailFoundry parses a bounce email which created by MailFoundry. Methods in the
-  # module are called from only Sisimai::Message.
+  # Sisimai::Lhost::MailFoundry decodes a bounce email which created by MailFoundry https://www.barracuda.com/.
+  # Methods in the module are called from only Sisimai::Message.
   module MailFoundry
     class << self
       require 'sisimai/lhost'
@@ -12,11 +12,11 @@ module Sisimai::Lhost
         error:   ['Delivery failed for the following reason:'],
       }.freeze
 
-      # Parse bounce messages from MailFoundry
+      # @abstract Decodes the bounce message from MailFoundry
       # @param  [Hash] mhead    Message headers of a bounce email
       # @param  [String] mbody  Message body of a bounce email
       # @return [Hash]          Bounce data list and message/rfc822 part
-      # @return [Nil]           it failed to parse or the arguments are missing
+      # @return [Nil]           it failed to decode or the arguments are missing
       def inquire(mhead, mbody)
         return nil unless mhead['subject'] == 'Message delivery has failed'
         return nil unless mhead['received'].any? { |a| a.include?('(MAILFOUNDRY) id ') }