Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
further link cleanup
  • Loading branch information
lichtkind committed Aug 14, 2014
1 parent 91390db commit a6c9a6a
Show file tree
Hide file tree
Showing 5 changed files with 37 additions and 37 deletions.
14 changes: 7 additions & 7 deletions docs/appendix-d-delta.txt
Expand Up @@ -4,7 +4,7 @@ Trends
======

The more general course of the changes is documented in the
[trends section](tablet-1-language-design.html#trends)
[trends section](tablet-1-language-design#trends)
of the language design tablet.


Expand All @@ -25,16 +25,16 @@ Variable
* `scalar @a` becomes `+@a` (**+** forces numeric context)
* arrays, hashes, formats, directories and filehandles are internal
objects with procedural interfaces and can be saved in scalar variables.
* [special variables](appendix-b-grouped.html#special-variables)
* [special variables](appendix-b-grouped#special-variables)
have their own namespace (`$*VARNAME` and `$?VARNAME`),
also token (`__LINE__`) will now be found there
* no *Data::Dump*, use [`$var.perl.say`](appendix-a-index.html#perl) instead
* no *Data::Dump*, use [`$var.perl.say`](appendix-a-index#perl) instead

Strings
-------

* no *length*, `length(@a)` is now `elems @a` and `length $str` is `chars $str;`
* no *ucfirst* use [**titlecase**](appendix-a-index.html#titlecase)
* no *ucfirst* use [**titlecase**](appendix-a-index#titlecase)


Operator
Expand All @@ -59,9 +59,9 @@ Operator
Flow Control
------------

* no *foreach*, only [**for**](appendix-a-index.html#for)
* no *each*, use [**.pairs**](appendix-a-index.html#pairs) or [**.kv**](appendix-a-index.html#kv) instead
* no C-style *for*, use [**loop**](appendix-a-index.html#loop) instead
* no *foreach*, only [**for**](appendix-a-index#for)
* no *each*, use [**.pairs**](appendix-a-index#pairs) or [**.kv**](appendix-a-index#kv) instead
* no C-style *for*, use [**loop**](appendix-a-index#loop) instead
* `do {...} while (...);` becomes `repeat {...} while ...;`


Expand Down
10 changes: 5 additions & 5 deletions docs/appendix-e-exciting.txt
Expand Up @@ -2,12 +2,12 @@

This is a small tour, showing the best features and improvements of
Perl 6 in short examples, compared to similar working Perl 5 examples.
More examples how to write native Perl 6 are in the [cookbook](appendix-c-cookbook.html).
More examples how to write native Perl 6 are in the [cookbook](appendix-d-delta#code-snippets).

Command Line
============

[Making output](io.html#command-line) will become simpler and easier for newbies.
[Making output](tablet-5-io#command-line) will become simpler and easier for newbies.

Perl 5 Perl 6
print "bananas are good\n"; say "bananas are good";
Expand All @@ -22,7 +22,7 @@ File IO
=======

File::Slurp is in the Perl 6 core language and [file
reading](io.html#file) is simpler then ever (and autochomp included).
reading](table-5-io#file) is simpler then ever (and autochomp included).

Perl 5 Perl 6
$content = do { local $/; $content = slurp "poetry.txt";
Expand Down Expand Up @@ -86,7 +86,7 @@ Case construct
else {...} default {...}
}

[That new construct](blocks.html#given) (backported to 5.10) is clear
[That new construct](tablet-6-blocks#given) (backported to 5.10) is clear
to read, very versatile and when used in combination with junctions,
becomes even clearer.

Expand All @@ -95,7 +95,7 @@ becomes even clearer.
Powerful for loops
==================

[List iteration via `for`](blocks.html#for) is now much more versatile.
[List iteration via `for`](tablet-6-blocks#for) is now much more versatile.

Perl 5 Perl 6
for my $i (0..15) {...} for ^16 -> $i {...}
Expand Down
6 changes: 3 additions & 3 deletions docs/tablet-1-language-design.txt
Expand Up @@ -57,7 +57,7 @@ word of a sentence sets an understandable context for what follows,
the meaning is built up word for word. This is much easier to grasp,
than if the last word of a block resolves the block's entire meaning
(like regex modifiers do in Perl 5). In particular,
[`for`](block.html#) and [`given`](block.html#) are called
[`for`](tablet-6-blocks#for) and [`given`](tablet-6-blocks#given) are called
topicalizers, because they set `$_`, the current topic variable.


Expand Down Expand Up @@ -163,7 +163,7 @@ Ubiquity
--------

As always, [Perl is optimized for freedom and richness of
expression](language-design.html).
expression](tablet-1-language-design).



Expand Down Expand Up @@ -278,7 +278,7 @@ since, because they were much harder to maintain than the Synopses
("abstracts" or "comparisons" (with Perl 5)). The Synopsis documents,
along with the test suite, form the official specification of Perl 6.
More details on that can be found in
[the history section](tablet-0-history.html).
[the history section](tablet-0-history).

The Synopses are continually edited because the more we think about
the syntax and semantics, the more detailed the picture gets. The
Expand Down
42 changes: 21 additions & 21 deletions docs/tablet-3-variables.txt
Expand Up @@ -42,8 +42,8 @@ All special namespaces from Perl 5 (often marked with special syntax), like
tokens (`__PACKAGE__`), formats, file or dir handles, or builtins are
now regular variables or routines.

Because all variables contain [objects](tablet-8-objects.html), they have methods.
In fact, [all operators](tablet-4-operators.html), including square or curly bracket
Because all variables contain [objects](tablet-8-objects), they have methods.
In fact, [all operators](tablet-4-operators), including square or curly bracket
subscripts, are just methods of an object with a fancy name.

The primary sigil can be followed by a secondary sigil, called a
Expand All @@ -57,7 +57,7 @@ Scalar
This type stores one value, usually
a reference to something: a value of a data type,
a code object, an object or a compound of values like a
[pair](#pair), [junction](tablet-4-operators.html#junctions),
[pair](#pair), [junction](tablet-4-operators#junctions),
[array](#array), [hash](#hash) or
[capture](#capture). The scalar context is now called
item context, hence the `scalar` instruction from Perl 5 was renamed to
Expand Down Expand Up @@ -89,14 +89,14 @@ item context, hence the `scalar` instruction from Perl 5 was renamed to
$coderef = sub { do_something_completely_diffenent(@_) };

(For info on some of those terms:
[comment](tablet-2-basic-syntax.html#single-line),
[binary format](tablet-2-basic-syntax.html#radix-prefixes),
[the underscores ease reading](tablet-2-basic-syntax.html#number-literals),
[scientific notation](tablet-2-basic-syntax.html#scientific-notation),
[single-quoted string](tablet-2-basic-syntax.html#single-quotes),
[double-quoted string](tablet-2-basic-syntax.html#double-quotes),
[heredoc string](tablet-2-basic-syntax.html#heredocs),
[file handle](io.html#files), [class](tablet-2-basic-syntax.html), [junction](#junction), [list of
[comment](tablet-2-basic-syntax#single-line),
[binary format](tablet-2-basic-syntax#radix-prefixes),
[the underscores ease reading](tablet-2-basic-syntax#number-literals),
[scientific notation](tablet-2-basic-syntax#scientific-notation),
[single-quoted string](tablet-2-basic-syntax#single-quotes),
[double-quoted string](tablet-2-basic-syntax#double-quotes),
[heredoc string](tablet-2-basic-syntax#heredocs),
[file handle](io#files), [class](tablet-2-basic-syntax), [junction](#junction), [list of
values](#array), [hash](#hash), [callable](#callable).)

Unlike Perl 5, references are automatically dereferenced to a fitting
Expand Down Expand Up @@ -132,10 +132,10 @@ lists that have not been computed yet. The `lazy` command enforces this
and the `eager` command forces all values to be computed.

The list context is forced with a [@() operator or `list()`
command](appendix-b-grouped.html#contextualizers). That's not
command](appendix-b-grouped#contextualizers). That's not
autoflattening like in Perl 5 (automatically convert a List of Lists
into one List). If you still want that, [say flat(). Or say
lol()](appendix-b-grouped.html#contextualizers) to explicitly
lol()](appendix-b-grouped#contextualizers) to explicitly
prevent autoflattening.

@primes = (2,3,5,7,11,13,17,19,23); # an array gets filled like in Perl 5
Expand Down Expand Up @@ -217,7 +217,7 @@ Hash

In Perl 6 a Hash is an unordered list of Pairs. [A Pair](#pair)
is a single key `=>` value association and [appears in many
places](tablet-1-language-design.html#maximum_reusage) of the language syntax.
places](tablet-1-language-design#maximum_reusage) of the language syntax.
A hash allows lookup of values by key using `{}` or `<>` syntax.

%dev = 'pugs'=>'audreyt', 'pct'=>'pm', "STD"=>'larry';
Expand Down Expand Up @@ -266,8 +266,8 @@ A hash allows lookup of values by key using `{}` or `<>` syntax.
Callable
--------

Internally [subroutines](tablet-7-subroutines.html), [methods](tablet-8-objects.html)
and [alike](appendix-b-grouped.html#routine-types) are variables
Internally [subroutines](tablet-7-subroutines), [methods](tablet-8-objects)
and [alike](appendix-b-grouped#routine-types) are variables
with the sigil & and stored in a fourth namespace. Unlike Perl 5, all
subroutines can be overwritten or augmented with user defined routines.
Of course [scalars](#scalar) can
Expand All @@ -286,7 +286,7 @@ Data Types

In contrast to [variable types](#variable-types)
(container types) every [value has a
type](appendix-b-grouped.html#value-types) too. These are
type](appendix-b-grouped#value-types) too. These are
organized internally as classes or roles and can be categorized into 3
piles: the undefined, immutable, and the mutable types.

Expand Down Expand Up @@ -332,7 +332,7 @@ parameters, it is a mixture of a list and array.


One important difference between a capture and a compound structure of
lists and hashes: While [assignments](variables.html#assignment)
lists and hashes: While [assignments](variables#assignment)
with = will copy the complete content of the named variables, this is
not so in the case of a capture. When I change $s in the last example,
the content of $cap changes too, because when parameters to a routine
Expand Down Expand Up @@ -363,8 +363,8 @@ xxx
Scoping
=======

[scope declarator](appendix-b-grouped.html#scope-declarator),
[scopes](appendix-b-grouped.html#scopes)
[scope declarator](appendix-b-grouped#scope-declarator),
[scopes](appendix-b-grouped#scopes)

my $var;
state
Expand Down Expand Up @@ -421,7 +421,7 @@ binding to get 2 variables that point to the same memory location.
Special Variables
=================

are listed in [Index B](appendix-b-grouped.html#special-variables).
are listed in [Index B](appendix-b-grouped#special-variables).
To understand their secondary sigil [click here](#twigils).

***
2 changes: 1 addition & 1 deletion docs/tablet-6-blocks.txt
Expand Up @@ -37,7 +37,7 @@ sub
---


[*more*](tablet-7-subroutines.html)
[*more*](tablet-7-subroutines)



Expand Down

0 comments on commit a6c9a6a

Please sign in to comment.