File 1462-Improve-documentation-of-sets-ordsets-gb_sets-subtra.patch of Package erlang

From 9dbb20868e42ad72f48b57cc27bdb3a143f16496 Mon Sep 17 00:00:00 2001
From: Maria Scott <maria-12648430@hnc-agency.org>
Date: Thu, 20 Nov 2025 15:36:45 +0100
Subject: [PATCH] Improve documentation of sets/ordsets/gb_sets:subtract/2

---
 lib/stdlib/src/gb_sets.erl | 3 ++-
 lib/stdlib/src/ordsets.erl | 3 ++-
 lib/stdlib/src/sets.erl    | 3 ++-
 3 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/lib/stdlib/src/gb_sets.erl b/lib/stdlib/src/gb_sets.erl
index 296c9ed878..70c88d34c2 100644
--- a/lib/stdlib/src/gb_sets.erl
+++ b/lib/stdlib/src/gb_sets.erl
@@ -1267,7 +1267,8 @@ is_disjoint_1(_, nil) ->
 %% traverse the whole element list of the left operand.
 
 -doc """
-Returns the elements of `Set1` that are not elements in `Set2`.
+Returns a new set containing the elements of `Set1`
+that are not elements in `Set2`.
 
 ## Examples
 
diff --git a/lib/stdlib/src/ordsets.erl b/lib/stdlib/src/ordsets.erl
index 9ca0573415..561221d794 100644
--- a/lib/stdlib/src/ordsets.erl
+++ b/lib/stdlib/src/ordsets.erl
@@ -422,7 +422,8 @@ is_disjoint(_, []) ->
     true.
 
 -doc """
-Returns the elements of `Ordset1` that are not elements in `Ordset2`.
+Returns a new ordered set containing the elements of `Ordset1`
+that are not elements in `Ordset2`.
 
 ## Examples
 
diff --git a/lib/stdlib/src/sets.erl b/lib/stdlib/src/sets.erl
index 56c22a370f..7621a5b008 100644
--- a/lib/stdlib/src/sets.erl
+++ b/lib/stdlib/src/sets.erl
@@ -697,7 +697,8 @@ is_disjoint_1(Set, Iter) ->
     end.
 
 -doc """
-Returns the elements of `Set1` that are not elements in `Set2`.
+Returns a new set containing the elements of `Set1`
+that are not elements in `Set2`.
 
 ## Examples
 
-- 
2.51.0