Any list clarity

[MorayJ]

The problem

The "1-item list" in Any docs is inaccurate #2176

Solution provided

I have standardised the language based on other language in the document, though will need checking by someone with a greater understanding of what's actually being said.

Looking at the Cool type document, I have changed all descriptions which say 'coerce' to 'coerces' as there were both in the document.

I have added 'the invocant' in many places and hope this is correct to fit in with the language I was using in this update. Again, this was something used sporadically and I had to choose what to follow. It is now more consistent.

I have referred to C<List> meaning a class, rather than just 'a list'. Again, this seems more consistent to me with the rest of the document.

[zoffixznet]

Looks good except for the:

I have referred to C<List> meaning a class, rather than just 'a list'.

There's a deliberate difference there. Note there are both .List and .list methods. Only .List specifically coerces to a List type; .list is allowed to coerce to any Positional type:

[].List.^name.say; # List
[].list.^name.say  # Array

---

(the same thing exists for .Hash vs .hash; the latter is allowed to return any Associative)

[MorayJ]

Ok, will have another go...see it's failed a test as well.

[MorayJ]

Having doubts about methods pairs, anti-pairs and kv. Based the re-wording on method pairs and not sure that it's correct in List v list..? Bit out of my depth there. Should I revert that part?

But otherwise, I think this is ok as far as fixing the related bug?

[zoffixznet]

Having doubts about methods

The only thing I see is the use of word undefined. Should be changed to something like …if the invocant is a type object. The non-definite objects (i.e. type objects rather than instances) are slightly different from "undefined" objects. An object can override the .defined value (and some things like Failures do) and can be false even for instances:

say Failure.new.DEFINITE; # True
say Failure.new.defined;      # False

[zoffixznet]

👍 Thanks!

(gonna fix up the defined thing myself; need to do some other edits in the same area and don't want to introduce merge conflicts).