From 4fc6b96f406b688e994ce9922b39f24d3276c069 Mon Sep 17 00:00:00 2001
From: Uwe Klotz <uwe.klotz@gmail.com>
Date: Wed, 3 Jul 2024 12:06:21 +0200
Subject: [PATCH] Add comments

---
 lofty/src/tag/mod.rs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/lofty/src/tag/mod.rs b/lofty/src/tag/mod.rs
index 1ac58693..bd685820 100644
--- a/lofty/src/tag/mod.rs
+++ b/lofty/src/tag/mod.rs
@@ -404,6 +404,8 @@ impl Tag {
 	}
 
 	/// Removes all items with the specified [`ItemKey`], and returns them
+	///
+	/// See also: [take_filter()](Self::take_filter)
 	pub fn take(&mut self, key: &ItemKey) -> impl Iterator<Item = TagItem> + '_ {
 		self.take_filter(key, |_| true)
 	}
@@ -412,6 +414,8 @@ impl Tag {
 	///
 	/// Only takes items for which `filter()` returns `true`. All other items are retained.
 	///
+	/// Returns the selected items in order and preserves the ordering of the remaining items.
+	///
 	/// # Examples
 	///
 	/// ```