Skip to content

Commit 1952c4c

Browse files
committed
Some corrections
1 parent e8ed953 commit 1952c4c

File tree

1 file changed

+32
-20
lines changed

1 file changed

+32
-20
lines changed

doc/Language/intro.pod6

Lines changed: 32 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,46 +1,58 @@
11
=begin pod
22
3-
=TITLE Brief Introduction
3+
=TITLE Brief Introduction  
44
5-
=SUBTITLE Using the Perl6 Documentation
5+
=SUBTITLE Using the Perl 6 Documentation
66
7-
Documenting a large language like Perl6 has to balance several contradictory goals, such as being brief
8-
whilst being comprehensive, catering to professional developers with wide experience whilst also being accessible to
9-
newcomers to the language.
7+
Documenting a large language like Perl 6 has to balance several contradictory
8+
goals, such as being brief whilst being comprehensive, catering to professional
9+
developers with wide experience whilst also being accessible to newcomers to the
10+
language.
1011
11-
For a quick hands-on introduction, there is a short L<C<annotated programming example>|/language/101-basics>.
12+
For a quick hands-on introduction, there is a short
13+
L<C<annotated programming example>|/language/101-basics>.
1214
13-
For programmers with experience in other languages, there are a number of B<Migration> guides that compare and
14-
contrast the features of Perl6 with other languages.
15+
For programmers with experience in other languages, there are a number of
16+
B<Migration> guides that compare and contrast the features of Perl6 with other
17+
languages.
1518
16-
A number of B<Tutorials> cover several areas in which Perl6 is particularly innovative. The section headers should help navigate
17-
the remaining documents.
19+
A number of B<Tutorials> cover several areas in which Perl6 is particularly
20+
innovative. The section headers should help navigate the remaining documents.
1821
19-
There are a number of L<C<useful resources>|https://perl6.org/resources> listed elsewhere on the perl6.org site.
20-
These include articles, books, slide presentations, and videos.
22+
There are a number of L<C<useful resources>|https://perl6.org/resources> listed
23+
elsewhere on the perl6.org site. These include articles, books, slide
24+
presentations, and videos.
2125
22-
It has been found that newcommers to Perl6 often ask questions that indicate assumptions carried over from other
23-
programming paradigms. It is suggested that the following sections in the FUNDAMENTAL TOPICS section
24-
should be reviewed first.
26+
It has been found that newcommers to Perl 6 often ask questions that indicate
27+
assumptions carried over from other programming paradigms. It is suggested that
28+
the following sections in the FUNDAMENTAL TOPICS section should be reviewed
29+
first.
2530
26-
=item L<C<Signatures>|/type/Signature> - each routine, which includes subroutines and methods, has a signature.
27-
Understanding the information given in the signature of a C<sub> or C<method> provides a quick way to
31+
=begin item
32+
L<C<Signatures>|/type/Signature> - each routine, which includes subroutines and methods, has a signature. Understanding the information given in the signature of a C<sub> or C<method> provides a quick way to
2833
grasp the operation and effect of the routine.
34+
=end item
2935
30-
=item L<C<Containers>|/language/containers> - variables, which are like the nouns of a computer language, are
36+
=begin item
37+
L<C<Containers>|/language/containers> - variables, which are like the nouns of a computer language, are
3138
containers in which information is stored. The first letter in the formal
3239
name of a container, such as the '$' of $my-variable, or '@' of @an-array-of-things, or '%' of %the-scores-in-the-competition,
3340
conveys information about the container. However, Perl6 is more abstract than other languages about what can be stored
3441
in a container. So, for example, a $scaler container can contain an object that is in fact an array.
42+
=end item
3543
36-
=item L<C<Classes and Roles>|/language/classtut> - Perl6 is fundamentally based on objects, which are described
44+
=begin item
45+
L<C<Classes and Roles>|/language/classtut> - Perl6 is fundamentally based on objects, which are described
3746
in terms of classes and roles. Perl6, unlike some languages, does not
3847
B<impose> object-oriented programming practices, and useful programs can be written as if Perl6 was purely procedural in
3948
nature. However, complex software, such as the Perl6 compiler itself, is made much simpler by writing in object-oriented idioms,
4049
which is why the Perl6 documentation is more easily understood by reviewing what a class is and what a role is. Without understanding
4150
about Classes and Roles, it would be difficult to understand Types, to which a whole section of the documentation is devoted.
51+
=end item
4252
43-
=item L<C<Traps to Avoid>|/language/traps> - Several common assumptions lead to code that does not work
53+
=begin item
54+
L<C<Traps to Avoid>|/language/traps> - Several common assumptions lead to code that does not work
4455
as the programmer intended. This section identifies some. It is worth reviewing when something doesn't quite work out.
56+
=end item
4557
4658
=end pod

0 commit comments

Comments
 (0)