Merge pull request #10393 from Maria-12648430/improve_sets_subtract_docs

Improve documentation of `sets`/`ordsets`/`gb_sets:subtract/2`

Author: bjorng

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
 

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
 

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