S99: more entries, typos, reordering

S99-glossary.pod

@@ -214,6 +214,13 @@ Be Right Back.  Only L</afk> for a little while.
 
 Bounded Serialization.
 
+=head2 Bug report
+
+The way to report problems to the implementors.
+For the interpretors themselves, use L</RT>.
+It is good practice to include the interpreter L</version> in a bug report.
+For the user packages hosted on L</github>, you can report issues.
+
 =head1 C
 
 =head2 caller
@@ -601,7 +608,8 @@ See L<https://gist.github.com> for the last usage.
 =head2 git
 
 The distributed source revision system used by many, if not all Perl 6
-projects.
+projects, generally hosted on L</github>. A good L<glossary|https://www.kernel.org/pub/software/scm/git/docs/gitglossary.html> about git.
+A good L<reference|http://git-scm.com/book>.
 
 =head2 git submodule
 
@@ -750,6 +758,8 @@ A built-in arbitrary-sized integer type. See L<http://doc.perl6.org/type/Int>.
 
 =head2 int
 
+=head2 interface
+
 =head2 Intermediate Representation
 
 In a compiler, Intermediate data structures that are generated from
@@ -759,14 +769,13 @@ The L</parser> generates a  that is transformeed to an </AST>s
 Sometimes the information can be regenerated from the bytecode.
 In rakudo the Single Static Assignment form is inferred from the bytecode.
 
-=head2 interface
-
 =head2 interpreter
 
 =head2 invocant
 
-As a L<parameter>, 
-As a L<argument>, 
+A L</method> has generally one invocant by may have many according to its L</signature>.
+As a L<parameter(s)>, the parameters before the C<;>. 
+As an L<argument>, the left L</operand> of the C<.> L</operator>.
 In the L</expression> C<42.say>, C<42> is the invocant. 
 When missing, like in C<.say>, the invocant is C<$_>.
 
@@ -791,8 +800,18 @@ I Seem To Remember.
 
 =head2 item
 
+=head2 item context
+
 =head2 iteration
 
+A way to go thru all the values of an L</Iterable> object like a L</list> or a L</hash>.
+Generally, iterators L</object>s are invisible from user code because syntactical forms iterate
+for the user and pass the resulting value to the expression or the block acting on the value.
+Example :
+
+   for 1..20 { .say }
+   say for 1..20
+
 =head1 J
 
 =head2 jakudo
@@ -832,7 +851,9 @@ Keep It Simple, Stupid!
 
 =head2 lambda
 
-An anonymous function
+An anonymous function.
+A block with explicit parameters:  C<<  -> $a { say $a }  >>
+The C<< -> >> itself, or C<< <-> >> for writeable parameter.
 
 =head2 lazy
 
@@ -1168,9 +1189,9 @@ A virtual machine designed to run Perl 6 and other L</dynamic language>s.
 =head2 parser
 
 The parser is the L</compiler> part that transforms the L</source code> into a L</parse tree>.
-A parser is specified by a C</grammar>.
+A parser is specified by a L</grammar>.
 The code used by the parser leverages three different engines: the L</expression> parser, a recursive engine,
-a NFA engine. C</LTM> is a feature of the NFA engine. One difference between C<|> and C<||> is that the former
+a L</NFA> based engine. L</LTM> is a feature of the NFA engine. One difference between C<|> and C<||> is that the former
 involves a NFA, while the latter involves the recursive engine. That's why the former is faster than the latter.
 
 =head2 parse tree
@@ -1724,11 +1745,22 @@ Short way to indicate L</version>.
 
 =head2 version
 
+Can be obtained with C<I<perl6 -v>> with I<perl6> depending on your L</implementation>.
+This command gives something like below for L</rakudo> on L</MoarVM>
+
+  This is perl6 version 2014.08-187-gdf2245d built on MoarVM version 2014.08-55-ga5ae111
+
+Strangely the L</nqp> related information is missing.
+
 =head2 Virtual Machine
 
+A virtual machine is the Perl compiler entity that executes the L</bytecode>.
+It can optimize the bytecode or generate L</machine code> L</Just in Time>.
+Such as L</Parrot>, L</JVM> and L</MoarVM>.
+
 =head2 VM
 
-Virtual Machine.  Such as L</Parrot>, L</JVM> and L</MoarVM>.
+See L</Virtual Machine>. 
 
 =head2 v5
 
@@ -1845,7 +1877,7 @@ Way to increase L</karma> on IRC.
 
 =head2 &
 
-Sigil for executable code.  Also used at the end of a line of an L</IRC>
+L</Sigil> of a L</Callable> L</variable>.  Also used at the end of a line in an L</IRC>
 message to indicate the user is away, doing something else in the background.
 For instance: