It's a very good read. :) On Tue, 11 Sep 2018 at 16:19 Laurent Rosenfeld via perl6-users < perl6-users@perl.org> wrote:
> Hi Todd, > > I fully agree with Tom B.'s message that you should really set out to read > a Perl 6 book. Many of the things you asked are covered in most of the > available books. And the available books are easier than the official > documentation for a beginner to start understand the basic underlying > concepts. > > I should add that you don't even have to *buy* one book, since my own *Think > Perl 6* book is freely available on the Internet (Creative Commons > license): https://greenteapress.com/wp/think-perl-6/. Well, if you are > interested in reading it, I'd suggest you look for the PDF on my Github > repository (https://github.com/LaurentRosenfeld/thinkperl6/tree/master/PDF), > because it is more up-to-date (number of small corrections made following > comments from readers). > > So it would take you just a few minutes (at no cost) to download it and > start enjoying it. > > Cheers, > Laurent. > > Le mar. 11 sept. 2018 à 13:26, ToddAndMargo <toddandma...@zoho.com> a > écrit : > >> Hi All, >> >> Not to beat a dead horse, but Perl 6's docs are >> miserably hard to understand. >> >> Here is a comparison of Perl 5's perldocs and Perl 6's >> docs: >> >> Perl 5: >> >> $ perldoc -f index >> index STR,SUBSTR,POSITION >> index STR,SUBSTR >> The index function searches for one string within another, >> but without the wildcard-like behavior of a full regular- >> expression pattern match. It returns the position of >> the first occurrence of SUBSTR in STR at or after POSITION. >> If POSITION is omitted, starts searching from the beginning >> of the string. POSITION before the beginning of the string >> or after its end is treated as if it were the beginning >> or the end, respectively. POSITION and the return value >> are based at zero. If the substring is not found, "index" >> returns -1. >> >> Perl 6: >> >> https://docs.perl6.org/routine/index >> >> Documentation for sub index assembled from the following types: >> class Cool >> >> From Cool >> (Cool) routine index >> >> Defined as: >> >> multi sub index(Str(Cool) $s, Str:D $needle, Int(Cool) $startpos >> = 0 --> Int) >> multi method index(Str(Cool) $needle, Int(Cool) $startpos = 0 --> >> Int) >> >> Coerces the first two arguments (in method form, also counting >> the invocant) to Str, and searches for $needle in the string >> starting from $startpos. It returns the offset into the string >> where $needle was found, and an undefined value if it was not >> found. >> >> See the documentation in type Str for examples. >> >> >> "Cources"??? Seriously: >> >> https://www.merriam-webster.com/dictionary/coerce >> Definition of coerce coerced; coercing >> transitive verb >> 1 : to compel to an act or choice >> was coerced into agreeing >> abusers who coerce their victims into silence >> >> 2 : to achieve by force or threat >> coerce compliance >> coerce obedience >> >> 3 : to restrain or dominate by force >> >> And what the heck is a "multi sub" and a "multi method" anyway? >> AND WHY DO I EVEN CARE? I just what to know how to use the >> stinking thing! Geepers Creapers !!! (I am trying to avoid >> swearing.) >> >> Perl 5's perldoc just tells you what you need to know to use the >> stinker. It is concise and to the point. Perl 6 is a nightmare >> to understand. >> >> Thank for putting up with my frustration. >> >> -T >> > -- Simon Proctor Cognoscite aliquid novum cotidie
