Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
Rewriting some sentences in glossary for better flow
Sometimes the text didn't make sense, or there was a term or word missing,
thus I've collected here the "higher risk" edits, which could *potentially*
change the meaning of the text, however I have tried my utmost *not* to do
so.  Please accept my apologies in advance if my edits have changed the
original intent.
  • Loading branch information
Paul Cochrane committed Jan 22, 2015
1 parent d8d34bb commit 0fa840a
Showing 1 changed file with 16 additions and 16 deletions.
32 changes: 16 additions & 16 deletions S99-glossary.pod
Expand Up @@ -561,7 +561,7 @@ yet in the end pleasing nobody, because nobody is catered for enough.

=head2 empty list

A list which contains no value. Noted C<()>.
A list which contains no value. Denoted C<()>.

=head2 EPIC FAIL

Expand Down Expand Up @@ -792,7 +792,7 @@ Also, a given language may provide many flavors of them.
Perl 6 provides common L</concrete syntax> to access them.
C<MVMHLLConfig> is the L</MoarVM> C level structure that hooks
to the underlying language specific representations.
The L</metamodel> allows expression of specific semantics proper to a given L</OO> language.
The L</metamodel> allows one to express specific semantics proper to a given L</OO> language.
L</Zavolaj> provides interoperabiity with languages which compilers
follow C language linking conventions.

Expand Down Expand Up @@ -882,7 +882,7 @@ A built-in arbitrary-sized integer type. See L<http://doc.perl6.org/type/Int>.
In a compiler, Intermediate data structures that are generated from
the L</source code> to generate L</object code> or L</bytecode>.
In L</Rakudo> : L</parse tree>, and L<Abstract Syntax Tree|/AST>.
The L</parser> generates a that is transformeed to an L</AST>s
The L</parser> generates an IR that is transformed to an L</AST>.
Sometimes the information can be regenerated from the bytecode.
In Rakudo the Single Static Assignment form is inferred from the bytecode.

Expand Down Expand Up @@ -1196,7 +1196,7 @@ An implementation of Perl 6 targeting the .NET platform.

=head2 Nil

Means there is no value there which is different from C<()>, the L</empty list>.
Means there is no value. This is different from C<()>, the L</empty list>.

=head2 NST

Expand Down Expand Up @@ -1268,17 +1268,17 @@ An expression is made of operators and operands. More precisely it is made of an
operands that can be subexpressions or L</values>.
Operators are an alternative syntax for a L<multi method>. With that syntax, what would be the L</argument>s of the function
are named operands instead. Operators are classified into L<categories|http://design.perl6.org/S02.html#Grammatical_Categories> of categories.
A category has a precedence, an arity, can be L</fidly>, L</iffy>, L</diffy>.
Perl 6 is very creative as to what is an operator so they are many categories which operators are amde
of many tokens, possibly with a subexpression. For example, L<@a[0]> belongs to the
postcircumfix category is broken in the operand C<@a> and the
postcircumfix operator L<[0]> where C<0> is postcircumfixed subexpression.
A category has a precedence, an arity, and can be L</fidly>, L</iffy>, L</diffy>.
Perl 6 is very creative as to what is an operator, so there are many categories. Operators are made
of many tokens, possibly with a subexpression. For example, L<@a[0]> belongs to the
postcircumfix category, is broken into the operand C<@a> and the
postcircumfix operator L<[0]> where C<0> is the postcircumfixed subexpression.

The C<< <O(I<...>)> >> construction gives information about an operator that completes the
information provided by its category.
Below C<%conditional> is the category, C<< :reducecheck<ternary> >> specifies to call C<.ternary> to
posprocess the L<parse subtree|parse tree> and C<< :pasttype<if> >> specify the nqp L</opcode> generated in the
L</AST> from the parse subtree
Below C<%conditional> is the category, C<< :reducecheck<ternary> >>, which specifies calling C<.ternary> to
posprocess the L<parse subtree|parse tree> and C<< :pasttype<if> >> specifies the nqp L</opcode> generated in the
L</AST> from the parse subtree.

<O('%conditional, :reducecheck<ternary>, :pasttype<if>')>

Expand Down Expand Up @@ -1686,7 +1686,7 @@ fact that it doesn't work goes unnoticed.
=head2 SC

A L</serialization context> groups together things, usually from the same
L</compilation unit>.
L</compilation Unit>.

=head2 scalar

Expand Down Expand Up @@ -1750,7 +1750,7 @@ If planeteria.org is down, a replacement can be found on L<http://pl6anet.org/>.
Short for sublanguage. A slang is a L</grammar> derived from the Perl 6 grammar, and its associated L</actions>.
Alternatively the Perl 6 syntax
can be seen as the combination of many slangs (the regex slang, the quotation slang...)
Defining a slang has a cost because it usually involves generating new L</NFA> tables but except for
Defining a slang has a cost because it usually involves generating new L</NFA> tables; except for
the space taken by the said tables, it is compilation time cost.
Slang is a principled way to create Domain Specific Languages (DSLs).

Expand Down Expand Up @@ -2163,12 +2163,12 @@ See L<https://github.com/dpk/yoleaux> and L<http://dpk.io/yoleaux>.
=head2 Zavolaj

L</Zavolaj|https://github.com/jnthn/zavolaj> is a module to support C<native call>s
into L<libraries|/library>
into L<libraries|/library>.

=head2 Zen slice

A Zen slice is a slice of an object without specification of the elements.
A such it is empty, yet it is supposed to return the object in its entirety.
As such it is empty, yet it is supposed to return the object in its entirety.
Usually used as a way of interpolating entire hashes / arrays in strings.

=head1 *
Expand Down

0 comments on commit 0fa840a

Please sign in to comment.