From 98c8a014b2643e3ba07f4d878cfe0e3612b5af79 Mon Sep 17 00:00:00 2001 From: Mikael Djurfeldt Date: Mon, 9 Dec 2024 23:46:20 +0100 Subject: [PATCH] Add clarification about the less predicate passed to merge and sort --- doc/ref/api-utility.texi | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/doc/ref/api-utility.texi b/doc/ref/api-utility.texi index 5f2e67fa4..7ffed2d81 100644 --- a/doc/ref/api-utility.texi +++ b/doc/ref/api-utility.texi @@ -273,7 +273,10 @@ to @var{value}. Sorting is very important in computer programs. Therefore, Guile comes with several sorting procedures built-in. As always, procedures with names ending in @code{!} are side-effecting, that means that they may -modify their parameters in order to produce their results. +modify their parameters in order to produce their results. The predicate +@var{less} passed as second or third argument to the procedures below is +assumed to define a strict weak order on the elements to be merged or +sorted. The first group of procedures can be used to merge two lists (which must be already sorted on their own) and produce sorted lists containing