Skip to content

Commit d41ea22

Browse files
committed
Changes occurrences of "Perl 6" to Raku
This is just a *naming* change, which only affects when we refer at the language itself, refs #3054. Will be closed when revised. Please note that from now on this will only be released to the new raku-named domains. Also adds mini-script to perform the change.
1 parent da962d2 commit d41ea22

File tree

141 files changed

+1638
-1615
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

141 files changed

+1638
-1615
lines changed

CONTRIBUTING.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ in the [#perl6 IRC channel](https://perl6.org/community/irc).
4343
* Please use the present tense unless writing about history or upcoming events or planned features
4444
* Prefer [active voice](https://en.wikipedia.org/wiki/Active_voice) to the [passive voice](https://en.wikipedia.org/Passive_voice#In_English) with "by": "this is used by crafty programmers" → "crafty programmers use this"
4545
* Link to external resources (like Wikipedia) for topics that are not
46-
directly related to Perl 6 (like the math that our routines implement).
46+
directly related to Raku (like the math that our routines implement).
4747
* Duplicate small pieces of information rather than rely on linking.
4848
* Be explicit about routine signatures. If a method accepts an `*%args`,
4949
but treats some of them specially, list them separately.
@@ -201,7 +201,7 @@ among which these are probably the most common:
201201
incorrect documentation;
202202
use [`NOTSPECCED`](https://github.com/perl6/doc/labels/NOTSPECCED)
203203
instead, if this is for a feature present in a compiler, but not in
204-
the Perl 6 test suite.
204+
the Raku test suite.
205205
* [`search`](https://github.com/perl6/doc/labels/search) - the search
206206
component, either for items that are on the site but not searchable,
207207
or for the search functionality itself.
@@ -216,9 +216,9 @@ Assuming that you have already forked and cloned the
216216
you probably want to do is to build the documentation on your local
217217
computer. To do this you will need:
218218

219-
- Perl 6 (e.g., the Rakudo Perl 6 implementation)
220-
- zef (the installer for third party Perl 6 modules)
221-
- `Pod::To::HTML` (Perl 6 module for converting Pod 6 objects to HTML)
219+
- Raku (e.g., the Rakudo Raku implementation)
220+
- zef (the installer for third party Raku modules)
221+
- `Pod::To::HTML` (Raku module for converting Pod 6 objects to HTML)
222222
- [graphviz](http://www.graphviz.org/) (`sudo apt-get install graphviz` on Debian/Ubuntu)
223223
- [Mojolicious](https://metacpan.org/pod/Mojolicious)
224224
(optional; a Perl 5 web framework; it allows you to run a web
@@ -235,15 +235,15 @@ computer. To do this you will need:
235235

236236
#### Rakudo
237237

238-
You need Perl 6 installed. You can install the Rakudo Perl 6 compiler by
238+
You need Raku installed. You can install the Rakudo Raku compiler by
239239
downloading the latest Rakudo Star release from
240240
[rakudo.org/downloads/star/](http://rakudo.org/downloads/star/).
241241

242242
> For best results, you will need to install one of the latest versions, > 2018.11 if possible. It's not guaranteed to work with other versions, and in any case the produced documentation will not look the same.
243243
244244
#### Zef
245245

246-
[Zef](https://modules.perl6.org/repo/zef) is a Perl 6 module installer. If you
246+
[Zef](https://modules.perl6.org/repo/zef) is a Raku module installer. If you
247247
installed Rakudo Star package, it should already be there. Feel free to
248248
use any other module installer for the modules needed (see below).
249249

README.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Official Documentation of Perl 6
1+
# Official Documentation of Raku
22

33
[![Build Status](https://travis-ci.org/perl6/doc.svg?branch=master)](https://travis-ci.org/perl6/doc) [![artistic](https://img.shields.io/badge/license-Artistic%202.0-blue.svg?style=flat)](https://opensource.org/licenses/Artistic-2.0) [![Run Status](https://api.shippable.com/projects/591e99923f2f790700098a30/badge?branch=master)](https://app.shippable.com/github/perl6/doc) [![CircleCI](https://circleci.com/gh/perl6/doc.svg?style=shield)](https://circleci.com/gh/perl6/doc/tree/master)
44

@@ -46,15 +46,15 @@ browser to http://localhost:3000 (or 31415, as the case may be).
4646

4747
## Install p6doc
4848

49-
This module is available via the Perl 6 module ecosystem. Use:
49+
This module is available via the Raku module ecosystem. Use:
5050

5151
$ zef install p6doc
5252

5353
to install the "binaries" and make them available in your binaries
5454
execution path.
5555

5656
**Note**: Please note that, due to changes in the parsing of Pod6,
57-
this will fail in versions of Perl 6 older than 2018.06. Please upgrade to that
57+
this will fail in versions of Raku older than 2018.06. Please upgrade to that
5858
version, or install using `--force`.
5959

6060
## Use p6doc
@@ -157,7 +157,7 @@ made in other servers.
157157

158158
## Help Wanted!
159159

160-
Perl 6 is not a small language, and documenting it takes a lot of effort.
160+
Raku is not a small language, and documenting it takes a lot of effort.
161161
Any help is appreciated.
162162

163163
Here are some ways to help us:
@@ -183,7 +183,7 @@ explains briefly how to get started contributing documentation.
183183

184184
1. This documentation is intended to be universal with
185185
respect to a given version of the specification,
186-
and not necessarily tied to any specific Perl 6
186+
and not necessarily tied to any specific Raku
187187
implementation.
188188
2. Implementations' handling of embedded Pod is still
189189
a bit uneven; this avoids potential runtime impacts.
@@ -199,9 +199,9 @@ explains briefly how to get started contributing documentation.
199199
## Vision
200200

201201
> I want p6doc and docs.perl6.org to become the No. 1 resource to consult
202-
> when you want to know something about a Perl 6 feature, be it from the
202+
> when you want to know something about a Raku feature, be it from the
203203
> language, or built-in types and routines. I want it to be useful to every
204-
> Perl 6 programmer.
204+
> Raku programmer.
205205
>
206206
> -- moritz
207207

doc/HomePage.pod6

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
=begin Html
22
<img style="float: right; margin: 0 0 1em 1em; width:261px" src="/images/Camelia.svg" alt="" id="home_logo"/>
3-
Welcome to the official documentation of the <a href="https://perl6.org">Perl 6</a>
3+
Welcome to the official documentation of the <a href="https://perl6.org">Raku</a>
44
programming language!
55
Besides online browsing and searching, you can also
66
<a href="/perl6.html">view everything in one file</a> or
@@ -16,7 +16,7 @@ by reporting issues or sending patches.
1616
A collection of documents describing, in detail, the various
1717
conceptual parts of the language.
1818
<!--
19-
If you're new to Perl 6,
19+
If you're new to Raku,
2020
language>intro is a good place to start.
2121
-->
2222
@@ -32,10 +32,10 @@ by reporting issues or sending patches.
3232
Index of built-in subroutines and methods.
3333
</dd>
3434
35-
<dt><a href="/programs.html">Perl 6 Programs</a></dt>
35+
<dt><a href="/programs.html">Raku Programs</a></dt>
3636
<dd>
37-
A collection of documents describing the variables that affect the the Perl 6 executable, how to run the p6doc documentation front-end,
38-
how to debug Perl 6 programs, and how to hack on Perl 6
37+
A collection of documents describing the variables that affect the the Raku executable, how to run the p6doc documentation front-end,
38+
how to debug Raku programs, and how to hack on Raku
3939
source code.
4040
</dd>
4141
@@ -47,11 +47,11 @@ by reporting issues or sending patches.
4747
<hr/>
4848
4949
50-
<p>The Perl 6 homepage offers <a href="https://perl6.org/resources/">a
51-
comprehensive list of Perl 6 resources</a>, including tutorials, and how-tos.</p>
50+
<p>The Raku homepage offers <a href="https://perl6.org/resources/">a
51+
comprehensive list of Raku resources</a>, including tutorials, and how-tos.</p>
5252
5353
<p>You may be interested in the <a href="https://perl6.org/community/">Community</a> page on the
54-
main perl6 website. You can find how to get in touch with Perl 6 developers and users through instant
54+
main perl6 website. You can find how to get in touch with Raku developers and users through instant
5555
chat or mailing lists.</p>
5656
5757
<p>

doc/Language/101-basics.pod6

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
=begin pod :kind("Language") :subkind("Language") :category("beginning")
22
3-
=TITLE Perl 6 by example P6-101
3+
=TITLE Raku by example P6-101
44
5-
=SUBTITLE A basic introductory example of a Perl 6 program
5+
=SUBTITLE A basic introductory example of a Raku program
66
77
Suppose that you host a table tennis tournament. The referees tell you
88
the results of each game in the format C<Player1 Player2 | 3:2>, which
@@ -24,7 +24,7 @@ Beth Dave | 0:3
2424
The first line is the list of players. Every subsequent line records a result
2525
of a match.
2626
27-
Here's one way to solve that problem in Perl 6:
27+
Here's one way to solve that problem in Raku:
2828
2929
=begin code :solo
3030
use v6;
@@ -82,14 +82,14 @@ Beth has won 1 match and 4 sets
8282
8383
=head3 X<C<v6>|v6 (Basics)>
8484
85-
Every Perl 6 program should begin with a line similar to C<use v6;>. This line
86-
tells the compiler which version of Perl 6 the program expects. For instance,
87-
6.c is an example of a Perl 6 version. Should you accidentally run the file
85+
Every Raku program should begin with a line similar to C<use v6;>. This line
86+
tells the compiler which version of Raku the program expects. For instance,
87+
6.c is an example of a Raku version. Should you accidentally run the file
8888
with Perl 5, you'll get a helpful error message.
8989
9090
=head3 X<C<statement>|statement (Basics)>
9191
92-
A Perl 6 program consists of zero or more statements. A I<statement> ends with
92+
A Raku program consists of zero or more statements. A I<statement> ends with
9393
a semicolon or a curly brace at the end of a line:
9494
9595
=begin code
@@ -304,7 +304,7 @@ are passed in through the I<topic variable> C<$_>.
304304
305305
You have seen blocks before: both the C<for> loop C<< -> $line { ... } >> and
306306
the C<if> statement worked on blocks. A block is a self-contained piece of
307-
Perl 6 code with an optional signature (the C<< -> $line >> part).
307+
Raku code with an optional signature (the C<< -> $line >> part).
308308
309309
The simplest way to sort the players by score would be C<@names.sort({
310310
%matches{$_} })>, which sorts by number of matches won. However Ana and Dave
@@ -316,7 +316,7 @@ tournament.
316316
317317
When two array items have the same value, C<sort> leaves them in the same order
318318
as it found them. Computer scientists call this a I<stable sort>. The program
319-
takes advantage of this property of Perl 6's C<sort> to achieve the goal by
319+
takes advantage of this property of Raku's C<sort> to achieve the goal by
320320
sorting twice: first by the number of sets won (the secondary criterion), then
321321
by the number of matches won.
322322
@@ -374,7 +374,7 @@ say 'Do not call me $names'; # OUTPUT: «Do not call me $names␤»
374374
say "Do not call me $names"; # OUTPUT: «Do not call me things␤»
375375
=end code
376376
377-
Double quoted strings in Perl 6 can interpolate variables with the C<$>
377+
Double quoted strings in Raku can interpolate variables with the C<$>
378378
sigil as well as blocks of code in curly braces. Since any arbitrary
379379
Perl code can appear within curly braces, C<Array>s and C<Hash>es may be
380380
interpolated by placing them within curly braces.

0 commit comments

Comments
 (0)