Apply suggestions from code review

Co-authored-by: Lysandros Nikolaou <[email protected]>
Co-authored-by: Colin Marquardt <[email protected]>

Author: 3 people

Doc/reference/grammar.rst

@@ -15,7 +15,8 @@ except for a few extra complications:
 * ``&e``: a positive lookahead (that is, ``e`` is required to match but
   not consumed)
 * ``!e``: a negative lookahead (that is, ``e`` is required *not* to match)
-* ``~`` ("cut"): commit to the current alternative, even if it fails to parse
+* ``~`` ("cut"): commit to the current alternative and fail the rule
+  even if this fails to parse
 
 .. literalinclude:: ../../Grammar/python.gram
   :language: peg

Doc/reference/introduction.rst

@@ -197,5 +197,5 @@ converted to tokens like :data:`token.INDENT` or :data:`~token.NEWLINE`.
 *Syntactic* definitions then use these tokens, rather than source characters.
 
 This documentation uses the same BNF grammar for both styles of definitions.
-All uses of BNF in the next chapter (“Lexical Analysis”) are lexical definitions;
+All uses of BNF in the next chapter (:ref:`lexical`) are lexical definitions;
 uses in subsequent chapters are syntactic definitions.