[doc] grammar diffing up to python 3.6

docs/grammar.rst

@@ -337,6 +337,88 @@ After:
 
 
 
+Variables annotations
+~~~~~~~~~~~~~~~~~~~~~
+
+Python 3.6
+
+Before:
+
+::
+
+    expr_stmt: testlist_star_expr (augassign (yield_expr|testlist) |
+                         ('=' (yield_expr|testlist_star_expr))*)
+
+After:
+
+::
+
+    expr_stmt: testlist_star_expr (annassign | augassign (yield_expr|testlist) |
+                         ('=' (yield_expr|testlist_star_expr))*)
+    annassign: ':' test ['=' test]
+
+async for loop
+~~~~~~~~~~~~~~
+
+Python 3.6
+
+Before:
+
+::
+
+    comp_for: 'for' exprlist 'in' or_test [comp_iter]
+
+After:
+
+::
+
+    comp_for: [ASYNC] 'for' exprlist 'in' or_test [comp_iter]
+
+
+Refactoring in typedargslist ?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+I think this is for asynchronous generator and comprehension:
+
+* https://docs.python.org/3/whatsnew/3.6.html#whatsnew36-pep525
+* https://docs.python.org/3/whatsnew/3.6.html#whatsnew36-pep530
+
+Before:
+
+::
+
+    typedargslist: (tfpdef ['=' test] (',' tfpdef ['=' test])* [','
+           ['*' [tfpdef] (',' tfpdef ['=' test])* [',' '**' tfpdef] | '**' tfpdef]]
+         |  '*' [tfpdef] (',' tfpdef ['=' test])* [',' '**' tfpdef] | '**' tfpdef)
+    varargslist: (vfpdef ['=' test] (',' vfpdef ['=' test])* [','
+           ['*' [vfpdef] (',' vfpdef ['=' test])* [',' '**' vfpdef] | '**' vfpdef]]
+         |  '*' [vfpdef] (',' vfpdef ['=' test])* [',' '**' vfpdef] | '**' vfpdef)
+
+After:
+
+::
+
+    typedargslist: (tfpdef ['=' test] (',' tfpdef ['=' test])* [','
+           ['*' [tfpdef] (',' tfpdef ['=' test])* [',' ['**' tfpdef [',']]]
+          | '**' tfpdef [',']]]
+      | '*' [tfpdef] (',' tfpdef ['=' test])* [',' ['**' tfpdef [',']]]
+      | '**' tfpdef [','])
+    varargslist: (vfpdef ['=' test] (',' vfpdef ['=' test])* [','
+           ['*' [vfpdef] (',' vfpdef ['=' test])* [',' ['**' vfpdef [',']]]
+         | '**' vfpdef [',']]]
+      | '*' [vfpdef] (',' vfpdef ['=' test])* [',' ['**' vfpdef [',']]]
+      | '**' vfpdef [',']
+    )
+
+
+
+
+
+
+
+
+
+
 
 
 

grammar/reference_grammar_python3.6

@@ -20,15 +20,15 @@ async_funcdef: ASYNC funcdef
 funcdef: 'def' NAME parameters ['->' test] ':' suite
 
 parameters: '(' [typedargslist] ')'
-typedargslist: (tfpdef ['=' test] (',' tfpdef ['=' test])* [',' [
-        '*' [tfpdef] (',' tfpdef ['=' test])* [',' ['**' tfpdef [',']]]
+typedargslist: (tfpdef ['=' test] (',' tfpdef ['=' test])* [','
+       ['*' [tfpdef] (',' tfpdef ['=' test])* [',' ['**' tfpdef [',']]]
       | '**' tfpdef [',']]]
   | '*' [tfpdef] (',' tfpdef ['=' test])* [',' ['**' tfpdef [',']]]
   | '**' tfpdef [','])
 tfpdef: NAME [':' test]
-varargslist: (vfpdef ['=' test] (',' vfpdef ['=' test])* [',' [
-        '*' [vfpdef] (',' vfpdef ['=' test])* [',' ['**' vfpdef [',']]]
-      | '**' vfpdef [',']]]
+varargslist: (vfpdef ['=' test] (',' vfpdef ['=' test])* [','
+       ['*' [vfpdef] (',' vfpdef ['=' test])* [',' ['**' vfpdef [',']]]
+     | '**' vfpdef [',']]]
   | '*' [vfpdef] (',' vfpdef ['=' test])* [',' ['**' vfpdef [',']]]
   | '**' vfpdef [',']
 )
@@ -146,4 +146,4 @@ comp_if: 'if' test_nocond [comp_iter]
 encoding_decl: NAME
 
 yield_expr: 'yield' [yield_arg]
-yield_arg: 'from' test | testlist
+yield_arg: 'from' test | testlist