# New Ticket Created by Colin Kuskie # Please include the string: [perl #44489] # in the subject line of all future correspondence about this issue. # <URL: http://rt.perl.org/rt3/Ticket/Display.html?id=44489 >
A -> an before vowels. Apostrophes missing in possessives.
Index: docs/optable.pod =================================================================== --- docs/optable.pod (revision 20535) +++ docs/optable.pod (working copy) @@ -53,13 +53,13 @@ =head2 "expression" -A expression is a combination of operators, operands(terms such as variables +An expression is a combination of operators, operands(terms such as variables and values) and grouping symbols that describe a computation. Expressions return a result. =head2 "term" -A term is the atomic unit which a operator operates on. Operand is the more +A term is the atomic unit which an operator operates on. Operand is the more formal mathematical term for term. :) In OPTable parsed expressions a term is a variable or primitive value. @@ -73,7 +73,7 @@ Computer languages usually have a table of operator precedences. Operators at the top of the table have higher precedence than those below. Operators at the same vertical level in the table have equivalent or equal precedence. An -operators level in the table is called its precedence level. OPTable uses +operator's level in the table is called its precedence level. OPTable uses integers to signify precedence. The greater the OPTable precedence integer the higher the precedence level of the operator. An operator with precedence level 22 has higher precedence that an operator with precedence level 5 and @@ -93,11 +93,11 @@ will be generated. Written in Perl6 style the C<grammar> statement is translated by PGE into valid Parrot namespace syntax. -The C<proto> statement declares a operator to be added to the precedence table +The C<proto> statement declares an operator to be added to the precedence table and parser. All operator attributes are defined using the Perl6 adverbial style of C<is ADVERB()>. Adverbial clauses are separated by white space. Adverbs can have 0-arity in which case they can be written without -parenthesis. Adverbial arguments are written comma separated in parenthesis. +parentheses. Adverbial arguments are written comma separated in parentheses. =head2 "Adverbial Precedence Clauses" @@ -152,17 +152,17 @@ =item - is parsed() PGE::OPTable normally generates the parsing code for an operator based on the -operator name which usually consists of the operators orientation followed by +operator name which usually consists of the operator's orientation followed by a colon and then the operator symbol. In Perl6 'infix:*' is an example operator name of the infix multiplication operator. 'infix:x' likewise represents the Perl6 repeat operator. The C<is parsed> adverb declares that this particular operator is parsed using the Perl6 match conforming method specified as the adverbs argument instead of auto-generated code based off of -the operators name. +the operator's name. =item - is pastrule() -The C<is pastrule> adverb defines the pastrule attribute of a operator. +The C<is pastrule> adverb defines the pastrule attribute of an operator. During later processing by the Tree Grammar Engine(TGE) compiler tool, the pastrule attribute can be used to specify custom TGE processing.