Skip to content

Commit

Permalink
Some Raku<->Perl6 changes, some misco editing also
Browse files Browse the repository at this point in the history
  • Loading branch information
MasterDuke17 authored Dec 7, 2019
1 parent 329bc2d commit ab9df5b
Showing 1 changed file with 19 additions and 19 deletions.
38 changes: 19 additions & 19 deletions doc/Language/faq.pod6
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@
=head1 General
X<|Rakudo, Raku and Raku (FAQ)>
=head2 What's the difference between Raku, Rakudo and Raku?
X<|Rakudo, Raku and Perl 6 (FAQ)>
=head2 What's the difference between Raku, Rakudo and Perl 6?
Properly speaking, L<Rakudo|https://rakudo.org/> is an implementation of Raku.
It's currently the one that's being developed, but there have been other
Expand All @@ -23,7 +23,7 @@ The Rakudo 2015.12 implementation version was released on December 25th 2015.
=head2 Is there a Raku version 6.0.0?
No. The first stable language specification version is v6.c
("Christmas"). Future versions of the spec may have point releases (e.g.
("Christmas"). Future versions of the spec may have point releases (e.g.,
v6.d.2) or major releases (e.g., v6.e).
Running C<perl6 -v> will display the language version your compiler
Expand Down Expand Up @@ -81,8 +81,8 @@ X<|rakudobrew (FAQ)>
An option is to clone L<the repository|https://github.com/rakudo/rakudo> and
build it. This will install work in progress which is minimally-tested and
may contain severe bugs. If you're interested in contributing to Rakudo
Raku compiler, you may find
may contain severe bugs. If you're interested in contributing to the Rakudo
Raku compiler, you may find the
L<Z-Script helper tool|https://github.com/zoffixznet/z> useful.
To install the last official monthly release, check out the tag visible
Expand Down Expand Up @@ -114,8 +114,8 @@ Anything published before December, 2015 likely describes a pre-release
version of Raku.
You can always
L<get help from a live human in our help chat|https://webchat.freenode.net/?channels=#perl6>
or L<search the chat logs|https://colabti.org/irclogger/irclogger_log_search/perl6>
L<get help from a live human in our help chat|https://webchat.freenode.net/?channels=#raku>
or L<search the chat logs|https://colabti.org/irclogger/irclogger_log_search/raku>
to find previous conversations and discussions.
X<|Books>
Expand All @@ -131,17 +131,17 @@ Here are some available books, in alphabetical order:
=item L<Metagenomics|https://www.gitbook.com/book/kyclark/metagenomics/details>,
by Ken Youens-Clark
=item L<Parsing with Raku Regexes and Grammars|https://smile.amazon.com/dp/1484232275/>, by Moritz Lenz
=item L<Parsing with Perl 6 Regexes and Grammars|https://smile.amazon.com/dp/1484232275/>, by Moritz Lenz
=item L<Raku at a Glance|https://deeptext.media/perl6-at-a-glance/>,
=item L<Perl 6 at a Glance|https://deeptext.media/perl6-at-a-glance/>,
by Andrew Shitov
=item L<Raku Fundamentals|https://www.apress.com/us/book/9781484228982>,
=item L<Perl 6 Fundamentals|https://www.apress.com/us/book/9781484228982>,
by Moritz Lenz
=item L<Raku Deep Dive|https://www.packtpub.com/application-development/perl-6-deep-dive">, by Andrew Shitov
=item L<Perl 6 Deep Dive|https://www.packtpub.com/application-development/perl-6-deep-dive>, by Andrew Shitov
=item L<Think Raku: How to Think Like a Computer Scientist|https://greenteapress.com/wp/think-perl-6/>, by Laurent Rosenfeld.
=item L<Think Perl 6: How to Think Like a Computer Scientist|https://greenteapress.com/wp/think-perl-6/>, by Laurent Rosenfeld.
A list of books published or in progress is maintained in
L<C<raku.org>|https://raku.org/resources/>.
Expand Down Expand Up @@ -295,7 +295,7 @@ have to know what B means when we parse A, which is clearly an
infinite loop.
Note that Raku has no “1 file = 1 class” limitation, and circular
dependencies within a single compilation unit (e.g. file) are possible
dependencies within a single compilation unit (e.g., file) are possible
through stubbing. Therefore another possible solution is to move
classes into the same compilation unit.
Expand Down Expand Up @@ -559,7 +559,7 @@ You can force list context with C<@( ... )> or by calling the
C<.list> method on an expression, and item context with
C<$( ... )> or by calling the C<.item> method on an expression.
See the L«I<Raku: Sigils, Variables, and Containers>|https://perl6advent.wordpress.com/2017/12/02/» article to learn more.
See the L«I<Perl 6: Sigils, Variables, and Containers>|https://perl6advent.wordpress.com/2017/12/02/» article to learn more.
X<|Sigils (FAQ)>
=head2 Why sigils? Couldn't you do without them?
Expand Down Expand Up @@ -588,7 +588,7 @@ my $foo = "abc";
say "$foo<html-tag>";
=end code
Raku thinks C<$foo> to be a Hash and C«<html-tag>» to be a string literal
Raku thinks C<$foo> is a Hash and C«<html-tag>» is a string literal
hash key. Use a closure to help it to understand you.
=begin code
Expand Down Expand Up @@ -668,7 +668,7 @@ view is read-only by default, and you can still access it internally with C<$!x>
The most obvious difference is that C<say> and C<put> append
a newline at the end of the output, and C<print> does not.
But there's another difference: C<print> and C<put> convert its
But there's another difference: C<print> and C<put> convert their
arguments to a string by calling the C<Str> method on each item
passed to them while C<say> uses the C<gist> method. The C<gist> method,
which you can also create for your own classes, is intended to create a
Expand All @@ -677,7 +677,7 @@ about the object deemed unimportant to understanding the essence of the object.
Or phrased differently, C<$obj.Str> gives a string representation,
C<$obj.gist> provides a short summary of that object suitable for
fast recognition by a human, and C<$obj.perl> gives a Perlish representation
fast recognition by a human, and C<$obj.perl> gives a Rakuish representation
from which the object could be re-created.
For example, when the C<Str> method is invoked on a type object, also known
Expand Down Expand Up @@ -796,7 +796,7 @@ However, the currently available compilers do not support creating a standalone
executable yet.
If you wish to help out, the I<Rakudo> compiler on I<MoarVM> backend has
L<https://github.com/MoarVM/MoarVM/issues/875> Issue opened as a place to
L<https://github.com/MoarVM/MoarVM/issues/875> issue opened as a place to
discuss this problem.
X<|Raku Distribution (FAQ)>
Expand All @@ -810,7 +810,7 @@ announcements L<posted on rakudo.org|https://rakudo.org/posts>.
=head1 Metaquestions and advocacy
=head2 Why is Raku called Perl?
=head2 Why was Raku originally called Perl 6?
… As opposed to some other name that didn't imply all the things
that the higher number might indicate on other languages.
Expand Down

0 comments on commit ab9df5b

Please sign in to comment.