sisimai 5.0.3 → 5.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0eec943ed278f831725b0284faaee55afd03e0a9c1c843ff6ea5b293e557fe9b
-  data.tar.gz: 2491ec5afc09217998fad153605ccabf5fbe6ae66fceecc70b5798f17c0120f7
+  metadata.gz: 5b60a0c3953cb8512fed6e5e71e63780f8b6b681576f3a2b25787e7a98b42c36
+  data.tar.gz: 722e000aa41aa57e4efced1cf9ce3fb1c9658a725a8a027b26b58a07b31b7408
 SHA512:
-  metadata.gz: 35d9e9b9360bd120b9ba66d3a316536796834eb260f29ab0d0054466ea71c998eb315051fc820cbecd5676d212d410ae28c2402ed7457609d3211b425798898d
-  data.tar.gz: '09e8845d7dd05b8d1b3931438e755411427c720e0e25f31c70c37d4bb460659fdf74110096cfda7a6a968d1f1af7423fc262f88f159952ff7637cc72bdc8f3dc'
+  metadata.gz: 7ff66c2010a0eb055c34a2827f9d5824641a463c574264594d422f54e484cbe002eef9500ae1cff2878906f15e694b77f0a74e70f2cd14cf89dfd16517b4d256
+  data.tar.gz: 87a333ddb94b2f0a37c8921858e6f9be775e8f7d85a4c220fcf4a827748d230de0992049ee8e58f81e449525274290a51e7b6b7aadc93dde988e12baf654e3d3

data/.github/workflows/codecovio.yml

@@ -3,13 +3,15 @@ on:
   push:
     branches: ["5-stable"]
   pull_request:
-    branches: ["5-stable"]
+    branches: ["*"]
 jobs:
   codecov:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout the repository(CRuby)
         uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.pull_request.head.ref }}
       - name: Setup CRuby
         uses: ruby/setup-ruby@v1
         with:

data/.github/workflows/rake-test.yml

@@ -3,7 +3,7 @@ on:
   push:
     branches: ["5-stable"]
   pull_request:
-    branches: ["5-stable"]
+    branches: ["*"]
 jobs:
   test-cruby:
     name: rake test with CRuby ${{ matrix.cruby }}
@@ -15,6 +15,8 @@ jobs:
     steps:
       - name: Checkout the repository(CRuby)
         uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.pull_request.head.ref }}
       - name: Setup CRuby
         uses: ruby/setup-ruby@v1
         with:
@@ -38,7 +40,9 @@ jobs:
         jruby: ["jruby-9.2", "jruby-9.4"]
     steps:
       - name: Checkout the repository(JRuby)
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.pull_request.head.ref }}
       - name: Setup JRuby 
         uses: ruby/setup-ruby@v1
         with:

data/ChangeLog.md

@@ -3,6 +3,40 @@ RELEASE NOTES for Ruby version of Sisimai
 - releases: "https://github.com/sisimai/rb-sisimai/releases"
 - download: "https://rubygems.org/gems/sisimai"
 
+v5.1.0
+---------------------------------------------------------------------------------------------------
+- release: "Mon,  1 Jul 2024 12:02:22 +0900 (JST)"
+- version: "5.1.0"
+- changes:
+  - #297 #300 Remove v4 compatible features
+    - `Sisimai.make()`
+    - `Sisimai::Fact.softbounce()`
+  - #292 #293 Implement `Sisimai::Lhost::DragonFly`
+    - Add 30 sample emails generated by DMA: DrangonFly Mail Agent (lhost-dragonfly-*.eml)
+  - #288 Consolidate error messages scattered under `Sisimai::Reason::*` into `Sisimai::Rhost::*`
+    classes for each email service #289
+    - `Sisimai::Rhost::YahooInc` for https://senders.yahooinc.com/smtp-error-codes/
+    - `Sisimai::Rhost::Apple` for iCloud Mail
+    - The following sample emails in `set-of-emails/maildir/bsd`:
+      - 3 sample emails (rhost-yahooinc-0[1-3].eml)
+      - 4 sample emails (rhost-apple-0[1-4].eml)
+  - #290 #291 #295 Sisimai::Rhost improvements
+    - Update the error code list and error message patterns in the following classes:
+        - `Sisimai::Rhost::Cox`
+        - `Sisimai::Rhost::FrancePTT`
+        - `Sisimai::Rhost::GoDaddy`
+        - `Sisimai::Rhost::Mimecast`
+        - `Sisimai::Rhost::Spectrum`
+        - `Sisimai::Rhost::Tencent`
+    - Each error message should be compared with the lowercased string 
+    - Follow any updates of the SMTP error code and message list in each email services related to
+      `AuthFailure`, `BadReputation`, `RequirePTR`, and other error reasons added at v5
+    - No longer needed method `Sisimai::Rhost.match` method has been removed
+  - #296 Add 8 sample emails (lhost-opensmtpd-1[0-7].eml)generated by OpenSMTPD 6.8.0p2
+  - #298 Add 9 sample emails (lhost-qmail-1[1-9].eml) generated by notqmail 1.08
+  - #299 Add 6 sample emails (lhost-qmail-2[0-5].eml) generated by indimail 3.0.7
+  - Sisimai works on Ruby 3.3.3
+
 v5.0.3
 ---------------------------------------------------------------------------------------------------
 - release: "Wed, 22 May 2024 14:12:22 +0900 (JST)"

data/README-JA.md

@@ -78,7 +78,7 @@ The key features of Sisimai
     * `gem install`
     * `git clone && make`
   * __高い解析精度__
-    * [70種類のMTAs/MDAs/ESPs](https://libsisimai.org/en/engine/)に対応
+    * [73種類のMTAs/MDAs/ESPs](https://libsisimai.org/en/engine/)に対応
     * Feedback Loop(ARF)にも対応
     * [34種類のバウンス理由](https://libsisimai.org/en/reason/)を検出
 
@@ -110,10 +110,10 @@ Install
 ### From RubyGems.org
 ```shell
 $ sudo gem install sisimai
-Fetching: sisimai-5.0.3.gem (100%)
-Successfully installed sisimai-5.0.3
-Parsing documentation for sisimai-5.0.3
-Installing ri documentation for sisimai-5.0.3
+Fetching: sisimai-5.1.0.gem (100%)
+Successfully installed sisimai-5.1.0
+Parsing documentation for sisimai-5.1.0
+Installing ri documentation for sisimai-5.1.0
 Done installing documentation for sisimai after 6 seconds
 1 gem installed
 ```
@@ -141,13 +141,13 @@ if [ -d "/usr/local/jr" ]; then \
 ...
 3 gems installed
 /opt/local/bin/rake install
-sisimai 5.0.3 built to pkg/sisimai-5.0.3.gem.
-sisimai (5.0.3) installed.
+sisimai 5.1.0 built to pkg/sisimai-5.1.0.gem.
+sisimai (5.1.0) installed.
 if [ -d "/usr/local/jr" ]; then \
 		PATH="/usr/local/jr/bin:$PATH" /usr/local/jr/bin/rake install; \
 	fi
-sisimai 5.0.3 built to pkg/sisimai-5.0.3-java.gem.
-sisimai (5.0.3) installed.
+sisimai 5.1.0 built to pkg/sisimai-5.1.0-java.gem.
+sisimai (5.1.0) installed.
 ```
 
 Usage
@@ -351,12 +351,12 @@ Sisimai 5.0.0から**Ruby 2.4以上**が必要になります。
 | 動作環境(CRuby)                                      | 2.1 -              | **2.4** or later    |
 | 動作環境(JRuby)                                      | 9.0.4.0 - 9.1.17.0 | **9.2** or later    |
 | 元メールファイルを操作可能なコールバック機能         | なし               | あり[^3]            |
-| 解析エンジン(MTA/ESPモジュール)の数                  | 68                 | 70                  |
+| 解析エンジン(MTA/ESPモジュール)の数                  | 68                 | 73                  |
 | 検出可能なバウンス理由の数                           | 29                 | 34                  |
 | 依存Gem数(Ruby Standard Gemsを除く)                  | 1 Gem              | 1 Gem               |
-| ソースコードの行数                                   | 10,800 行          | 11,370 行           |
+| ソースコードの行数                                   | 10,800 行          | 11,660 行           |
 | テストフレームワーク                                 | rspec              | minitest            |
-| テスト件数(spec/またはtest/ディレクトリ)             | 311,000 件         | 338,000 件          |
+| テスト件数(spec/またはtest/ディレクトリ)             | 311,000 件         | 414,000 件          |
 | 1秒間に解析できるバウンスメール数[^4]                | 231 通             | 305 通              |
 | ライセンス                                           | 2条項BSD           | 2条項BSD            |
 | 開発会社による商用サポート                           | 提供中             | 提供中              |
@@ -389,11 +389,14 @@ MTA/ESP Module Names
 Sisimai 5で3個のESPモジュール名(解析エンジン)が変更になりました。詳細はMTA/ESPモジュールの一覧/
 [LIBSISIMAI.ORG/JA/ENGINE](https://libsisimai.org/ja/engine/)を参照してください。
 
-| `Sisimai::Rhost::`                                   | Sisimai 4          | Sisimai 5           |
-|------------------------------------------------------|--------------------|---------------------|
-| Microsoft Exchange Online                            | `ExchangeOnline`   | `Microsoft`         |
-| Google Workspace                                     | `GoogleApps`       | `Google`            |
-| Tencent                                              | `TencentQQ`        | `Tencent`           |
+| `Sisimai::`                                     | Sisimai 4               | Sisimai 5           |
+|-------------------------------------------------|-------------------------|---------------------|
+| Apple iCloud Mail (added at v5.1.0)             | なし                    | `Rhost::Apple`      |
+| Microsoft Exchange Online                       | `Rhost::ExchangeOnline` | `Rhost::Microsoft`  |
+| Google Workspace                                | `Rhost::GoogleApps`     | `Rhost::Google`     |
+| Tencent                                         | `Rhost::TencentQQ`      | `Rhost::Tencent`    |
+| Yahoo Mail (added at v5.1.0)                    | なし                    | `Rhost::YahooInc`   |
+| DragonFly Mail Agent (added at v5.1.0)          | なし                    | `Lhost::DragonFly`  |
 
 Bounce Reasons
 ---------------------------------------------------------------------------------------------------

data/README.md

@@ -80,7 +80,7 @@ The key features of Sisimai
     * `gem install`
     * `git clone && make`
   * __High Precision of Analysis__
-    * Support [70 MTAs/MDAs/ESPs](https://libsisimai.org/en/engine/)
+    * Support [73 MTAs/MDAs/ESPs](https://libsisimai.org/en/engine/)
     * Support Feedback Loop Message(ARF)
     * Can detect [34 bounce reasons](https://libsisimai.org/en/reason/)
 
@@ -109,10 +109,10 @@ Install
 ### From RubyGems
 ```shell
 $ sudo gem install sisimai
-Fetching: sisimai-5.0.3.gem (100%)
-Successfully installed sisimai-5.0.3
-Parsing documentation for sisimai-5.0.3
-Installing ri documentation for sisimai-5.0.3
+Fetching: sisimai-5.1.0.gem (100%)
+Successfully installed sisimai-5.1.0
+Parsing documentation for sisimai-5.1.0
+Installing ri documentation for sisimai-5.1.0
 Done installing documentation for sisimai after 6 seconds
 1 gem installed
 ```
@@ -140,13 +140,13 @@ if [ -d "/usr/local/jr" ]; then \
 ...
 3 gems installed
 /opt/local/bin/rake install
-sisimai 5.0.3 built to pkg/sisimai-5.0.3.gem.
-sisimai (5.0.3) installed.
+sisimai 5.1.0 built to pkg/sisimai-5.1.0.gem.
+sisimai (5.1.0) installed.
 if [ -d "/usr/local/jr" ]; then \
 		PATH="/usr/local/jr/bin:$PATH" /usr/local/jr/bin/rake install; \
 	fi
-sisimai 5.0.3 built to pkg/sisimai-5.0.3-java.gem.
-sisimai (5.0.3) installed.
+sisimai 5.1.0 built to pkg/sisimai-5.1.0-java.gem.
+sisimai (5.1.0) installed.
 ```
 
 Usage
@@ -350,12 +350,12 @@ Beginning with v5.0.0, Sisimai requires **Ruby 2.4.0 or later.**
 | System requirements (CRuby)                          | 2.1 - 3.3.0        | **2.4** or later    |
 | System requirements (JRuby)                          | 9.0.4.0 - 9.1.17.0 | **9.2** or later    |
 | Callback feature for the original email file         | N/A                | Available[^3]       |
-| The number of MTA/ESP modules                        | 68                 | 70                  |
+| The number of MTA/ESP modules                        | 68                 | 73                  |
 | The number of detectable bounce reasons              | 29                 | 34                  |
 | Dependencies (Except Ruby Standard Gems)             | 1 gem              | 1 gem               |
-| Source lines of code                                 | 10,300 lines       | 11,370 lines        |
+| Source lines of code                                 | 10,300 lines       | 11,660 lines        |
 | Test frameworks                                      | rspec              | minitest            |
-| The number of tests in spec/ or test/ directory      | 311,000 tests      | 338,000 tests       | 
+| The number of tests in spec/ or test/ directory      | 311,000 tests      | 414,000 tests       | 
 | The number of bounce emails decoded/sec (CRuby)[^4]  | 231 emails         | 305 emails          |
 | License                                              | 2 Clause BSD       | 2 Caluse BSD        |
 | Commercial support                                   | Available          | Available           |
@@ -390,11 +390,14 @@ MTA/ESP Module Names
 Three ESP module names have been changed at Sisimai 5. The list of the all MTA/ESP modules is
 available at [LIBSISIMAI.ORG/EN/ENGINE](https://libsisimai.org/en/engine/)
 
-| `Sisimai::Rhost::`                                   | Sisimai 4          | Sisimai 5           |
-|------------------------------------------------------|--------------------|---------------------|
-| Microsoft Exchange Online                            | `ExchangeOnline`   | `Microsoft`         |
-| Google Workspace                                     | `GoogleApps`       | `Google`            |
-| Tencent                                              | `TencentQQ`        | `Tencent`           |
+| `Sisimai::`                                     | Sisimai 4               | Sisimai 5           |
+|-------------------------------------------------|-------------------------|---------------------|
+| Apple iCloud Mail (added at v5.1.0)             | None                    | `Rhost::Apple`      |
+| Microsoft Exchange Online                       | `Rhost::ExchangeOnline` | `Rhost::Microsoft`  |
+| Google Workspace                                | `Rhost::GoogleApps`     | `Rhost::Google`     |
+| Tencent                                         | `Rhost::TencentQQ`      | `Rhost::Tencent`    |
+| Yahoo Mail (added at v5.1.0)                    | None                    | `Rhost::YahooInc`   |
+| DragonFly Mail Agent (added at v5.1.0)          | None                    | `Lhost::DragonFly`  |
 
 Bounce Reasons
 ---------------------------------------------------------------------------------------------------

data/lib/sisimai/arf.rb

@@ -1,5 +1,5 @@
 module Sisimai
-  # Sisimai::ARF is a parser for email returned as a FeedBack Loop report message.
+  # Sisimai::ARF is a decoder for the email returned as a FeedBack Loop report message.
   module ARF
     class << self
       require 'sisimai/lhost'
@@ -58,11 +58,11 @@ module Sisimai
         return match
       end
 
-      # Detect an error for Feedback Loop
+      # @abstract Detect an error for Feedback Loop
       # @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 self.is_arf(mhead)
 

data/lib/sisimai/fact/json.rb

@@ -1,7 +1,7 @@
 module Sisimai
   class Fact
-    # Sisimai::Fact::JSON dumps parsed data object as a JSON format. This class and method should be
-    # called from the parent object "Sisimai::Fact".
+    # Sisimai::Fact::JSON dumps decoded data object as a JSON format. This class and method should
+    # be called from the parent object "Sisimai::Fact".
     module JSON
       class << self
         # Serializer (JSON)

data/lib/sisimai/fact/yaml.rb

@@ -1,7 +1,7 @@
 module Sisimai
   class Fact
-    # Sisimai::Fact::YAML dumps parsed data object as a YAML format. This class and method should be
-    # called from the parent object "Sisimai::Fact".
+    # Sisimai::Fact::YAML dumps decoded data object as a YAML format. This class and method should
+    # be called from the parent object "Sisimai::Fact".
     module YAML
       class << self
         require 'yaml'

data/lib/sisimai/fact.rb

@@ -1,5 +1,5 @@
 module Sisimai
-  # Sisimai::Fact generate parsed data
+  # Sisimai::Fact generate the list of decoded bounce data
   class Fact
     require 'sisimai/message'
     require 'sisimai/rfc1894'
@@ -383,15 +383,9 @@ module Sisimai
         # REASON: Decide the reason of email bounce
         if o['reason'].empty? || RetryIndex[o['reason']]
           # The value of "reason" is empty or is needed to check with other values again
-          re = ''; de = o['destination']
-          re = Sisimai::Rhost.get(o) if Sisimai::Rhost.match(o['rhost'])
-          if re.empty?
-            # Failed to detect a bounce reason by the value of "rhost"
-            re = Sisimai::Rhost.get(o, de) if Sisimai::Rhost.match(de)
-            re = Sisimai::Reason.get(o)    if re.empty?
-            re = 'undefined'               if re.empty?
-          end
-          o['reason'] = re
+          re = o['reason'].empty? ? 'undefined' : o['reason']
+          o['reason'] = Sisimai::Rhost.get(o) || Sisimai::Reason.get(o)
+          o['reason'] = re if o['reason'].empty?
         end
 
         # HARDBOUNCE: Set the value of "hardbounce", default value of "bouncebounce" is false
@@ -443,15 +437,6 @@ module Sisimai
       return listoffact
     end
 
-    # Emulate "softbounce" accessor for the backward compatible
-    # @return   [Integer]
-    def softbounce
-      warn ' ***warning: Sisimai::Fact.softbounce will be removed at v5.1.0. Use Sisimai::Fact.hardbounce instead'
-      return  0 if self.hardbounce
-      return -1 if self.reason == 'delivered' || self.reason == 'feedback' || self.reason == 'vacation'
-      return  1
-    end
-
     # Convert from Sisimai::Fact object to a Hash
     # @return   [Hash] Hashed data
     def damn

data/lib/sisimai/lhost/activehunter.rb

@@ -1,5 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::Activehunter parses a bounce email which created by TransWARE Active!hunter.
+  # Sisimai::Lhost::Activehunter decodes a bounce email which created by QUALITIA Active!hunter
+  # https://www.qualitia.com/jp/product/ah/function.html.
   # Methods in the module are called from only Sisimai::Message.
   module Activehunter
     class << self
@@ -9,11 +10,11 @@ module Sisimai::Lhost
       Boundaries = ['Content-Type: message/rfc822'].freeze
       StartingOf = { message: ['  ----- The following addresses had permanent fatal errors -----'] }.freeze
 
-      # Parse bounce messages from TransWARE Active!hunter
+      # @abstract decodes the bounce message from QUALITIA Active!hunter
       # @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    => %r/\A"MAILER-DAEMON"/,
         # :subject => %r/FAILURE NOTICE :/,

data/lib/sisimai/lhost/amavis.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::Amavis parses a bounce email which created by amavsid-new. Methods in the module
-  # are called from only Sisimai::Message.
+  # Sisimai::Lhost::Amavis decodes a bounce email which created by amavsid-new.
+  # Methods in the module are called from only Sisimai::Message.
   module Amavis
     class << self
       require 'sisimai/lhost'
@@ -68,11 +68,11 @@ module Sisimai::Lhost
         ],
       }.freeze
 
-      # Parse bounce messages from amavisd-new
+      # @abstract Decodes the bounce message from amavisd-new
       # @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.0
       def inquire(mhead, mbody)
         # From: "Content-filter at neko1.example.jp" <postmaster@neko1.example.jp>

data/lib/sisimai/lhost/amazonses.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::AmazonSES parses a bounce email which created by Amazon Simple Email Service.
-  # Methods in the module are called from only Sisimai::Message.
+  # Sisimai::Lhost::AmazonSES decodes a bounce email which created by Amazon Simple Email Service
+  # https://aws.amazon.com/ses/. Methods in the module are called from only Sisimai::Message.
   module AmazonSES
     class << self
       require 'sisimai/lhost'
@@ -13,11 +13,11 @@ module Sisimai::Lhost
       }.freeze
       MessagesOf = { 'expired' => ['Delivery expired'] }.freeze
 
-      # Parse bounce messages from Amazon SES
+      # @abstract Decodes the bounce message from Amazon SES
       # @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)
         dscontents = [Sisimai::Lhost.DELIVERYSTATUS]
         recipients = 0  # (Integer) The number of 'Final-Recipient' header
@@ -292,7 +292,7 @@ module Sisimai::Lhost
           end
 
           if recipients == 0 && mbody =~ /notificationType/
-            # Try to parse with Sisimai::Lhost::AmazonSES module
+            # Try to decode with Sisimai::Lhost::AmazonSES module
             j = Sisimai::Lhost::AmazonSES.json(mhead, mbody)
 
             if j['ds'].is_a? Array
@@ -328,7 +328,7 @@ module Sisimai::Lhost
           end
 
           return { 'ds' => dscontents, 'rfc822' => emailparts[1] }
-        end # END of a parser for email message
+        end # END of the decoder for the email message
 
       end
       def description; return 'Amazon SES(Sending): https://aws.amazon.com/ses/'; end

data/lib/sisimai/lhost/amazonworkmail.rb

@@ -1,6 +1,6 @@
 module Sisimai::Lhost
-  # Sisimai::Lhost::AmazonWorkMail parses a bounce email which created by Amazon WorkMail. Methods
-  # in the module are called from only Sisimai::Message.
+  # Sisimai::Lhost::AmazonWorkMail decodes a bounce email which created by Amazon WorkMail https://aws.amazon.com/workmail/.
+  # Methods in the module are called from only Sisimai::Message.
   module AmazonWorkMail
     class << self
       require 'sisimai/lhost'
@@ -10,11 +10,11 @@ module Sisimai::Lhost
       Boundaries = ['Content-Type: message/rfc822'].freeze
       StartingOf = { message: ['Technical report:'] }.freeze
 
-      # Parse bounce messages from Amazon WorkMail
+      # @abstract Decodes the bounce message from Amazon WorkMail
       # @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: Amazon WorkMail
         # X-Original-Mailer: Amazon WorkMail

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:')