From 07d1453e93efe2f8098c662a574025a37b2dde61 Mon Sep 17 00:00:00 2001 From: Kaz Kylheku Date: Mon, 3 Oct 2016 06:39:10 -0700 Subject: doc: missing documentation on less over ranges. * txr.1: Document how the less function operates on ranges, and that ranges rank between numbers and strings on the comparison precedence for dissimilar types. --- txr.1 | 24 ++++++++++++++++++++++-- 1 file changed, 22 insertions(+), 2 deletions(-) diff --git a/txr.1 b/txr.1 index 3c8fb136..37c5a4a8 100644 --- a/txr.1 +++ b/txr.1 @@ -15385,12 +15385,32 @@ is the outcome of comparing those differing elements themselves with .codn less . +Two ranges are compared by +.code less +using lexicographic logic similar to conses and vectors. +The +.code from +fields of the ranges are first compared. If they are not +.codn equal , +equal then +.code less +is applied to those fields and the result is returned. +If the +.code from +fields are +.codn equal , +then +.code less +is applied to the +.code to +fields and that result is returned. + If the two arguments are of the above types, but of mutually different types, then .code less resolves the situation based on the following precedence: numbers and -characters are less than strings, which are less than symbols, -which are less than conses, which are less than vectors. +characters are less than ranges, which are less than strings, which are less +than symbols, which are less than conses, which are less than vectors. Note that since .code nil -- cgit v1.2.3