From cdb7b63cbff8217a05f1d3f251de2e2a66192f4e Mon Sep 17 00:00:00 2001
From: Robert Virkus <robert.virkus@open-xchange.com>
Date: Sun, 9 Aug 2020 10:37:51 +0200
Subject: [PATCH] improve documentation

---
 lib/mime_message.dart | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/lib/mime_message.dart b/lib/mime_message.dart
index 74f97025..f564b85b 100644
--- a/lib/mime_message.dart
+++ b/lib/mime_message.dart
@@ -495,7 +495,8 @@ class MimeMessage extends MimePart {
 
   /// Retrieves all content info of parts with the specified [disposition] `Content-Type`.
   /// By default the content info with `ContentDisposition.attachment` are retrieved.
-  /// Note that either the message contents or the BODYSTRUCTURE is required to reliably list all matching content elements.
+  /// Typically this used to list all attachments of a message.
+  /// Note that either the message contents (`BODY[]`) or the `BODYSTRUCTURE` is required to reliably list all matching content elements.
   List<ContentInfo> findContentInfo(
       {ContentDisposition disposition = ContentDisposition.attachment}) {
     var result = <ContentInfo>[];