From 18972f4b92ed1dea2df41aa151017f3cb997e3c4 Mon Sep 17 00:00:00 2001 From: Karl Williamson Date: Sun, 28 Aug 2011 12:52:49 -0600 Subject: [PATCH] Unicode::UCD: clarify pod Add a note, and reflow, that the data structure returned by this function is unnecessarily complex, but is for compatibility with other returns that need the complexity. --- lib/Unicode/UCD.pm | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/lib/Unicode/UCD.pm b/lib/Unicode/UCD.pm index fb0d3cd..7e43704 100644 --- a/lib/Unicode/UCD.pm +++ b/lib/Unicode/UCD.pm @@ -506,12 +506,16 @@ it were assigned (which it may in future versions of the Unicode Standard). See also L. -If supplied with an argument that can't be a code point, charblock() tries -to do the opposite and interpret the argument as a code point block. The -return value is a I: an anonymous list of lists that contain -I, I code point pairs. You can test whether -a code point is in a range using the L function. If the -argument is not a known code point block, B is returned. +If supplied with an argument that can't be a code point, charblock() tries to +do the opposite and interpret the argument as a code point block. The return +value is a I: an anonymous list that consists of another anonymous list +whose first element is the first code point in the block, and whose second +(and final) element is the final code point in the block. (The extra layer of +indirection is so that the same program logic can be used to handle both this +return, and the return from L which can have multiple ranges.) +You can test whether a code point is in a range using the L +function. +If the argument is not a known code point block, B is returned. =cut -- 2.7.4