Merge branch 'main' into blank_lines

Author: amartini51

Sources/TSPL/TSPL.docc/ReferenceManual/AboutTheLanguageReference.md

@@ -20,40 +20,34 @@ follows a few conventions:
 - An arrow (→) is used to mark grammar productions and can be read as "can consist of."
 - Syntactic categories are indicated by *italic* text and appear on both sides
   of a grammar production rule.
-- Literal words and punctuation are indicated by boldface `constant width` text
+- Literal words and punctuation are indicated by **`boldface constant width`** text
   and appear only on the right-hand side of a grammar production rule.
 - Alternative grammar productions are separated by vertical
   bars (|). When alternative productions are too long to read easily,
   they're broken into multiple grammar production rules on new lines.
 - In a few cases, regular font text is used to describe the right-hand side
   of a grammar production rule.
 - Optional syntactic categories and literals are marked by a trailing
-  subscript, *opt*.
+  question mark, *?*.
 
 As an example, the grammar of a getter-setter block is defined as follows:
 
-```
-Grammar of a getter-setter block
-
-getter-setter-block --> ``{`` getter-clause setter-clause-OPT ``}`` | ``{`` setter-clause getter-clause ``}``
-```
+> Grammar of a getter-setter block:
+>
+> *getter-setter-block* → **`{`** *getter-clause* *setter-clause*_?_ **`}`** | **`{`** *setter-clause* *getter-clause* **`}`**
 
 This definition indicates that a getter-setter block can consist of a getter clause
 followed by an optional setter clause, enclosed in braces,
 *or* a setter clause followed by a getter clause, enclosed in braces.
 The grammar production above is equivalent to the following two productions,
 where the alternatives are spelled out explicitly:
 
-```
-Grammar of a getter-setter block
-
-getter-setter-block --> ``{`` getter-clause setter-clause-OPT ``}``
-getter-setter-block --> ``{`` setter-clause getter-clause ``}``
-```
-
-*getter-setter-block* → `{` *getter-clause* *setter-clause?* `}`
-
-*getter-setter-block* → `{` *setter-clause* *getter-clause* `}`
+> Grammar of a getter-setter block:
+>
+>
+> *getter-setter-block* → **`{`** *getter-clause* *setter-clause*_?_ **`}`**
+>
+> *getter-setter-block* → **`{`** *setter-clause* *getter-clause* **`}`**
 
 <!--
 This source file is part of the Swift.org open source project

Sources/TSPL/TSPL.docc/ReferenceManual/Attributes.md

@@ -2218,21 +2218,30 @@ at the time the code is compiled.
 For an example of how to use the `unknown` attribute,
 see <doc:Statements#Switching-Over-Future-Enumeration-Cases>.
 
-```
-Grammar of an attribute
-
-attribute --> ``@`` attribute-name attribute-argument-clause-OPT
-attribute-name --> identifier
-attribute-argument-clause --> ``(`` balanced-tokens-OPT ``)``
-attributes --> attribute attributes-OPT
-
-balanced-tokens --> balanced-token balanced-tokens-OPT
-balanced-token --> ``(`` balanced-tokens-OPT ``)``
-balanced-token --> ``[`` balanced-tokens-OPT ``]``
-balanced-token --> ``{`` balanced-tokens-OPT ``}``
-balanced-token --> Any identifier, keyword, literal, or operator
-balanced-token --> Any punctuation except ``(``, ``)``, ``[``, ``]``, ``{``, or ``}``
-```
+> Grammar of an attribute:
+>
+> *attribute* → **`@`** *attribute-name* *attribute-argument-clause*_?_
+>
+> *attribute-name* → *identifier*
+>
+> *attribute-argument-clause* → **`(`** *balanced-tokens*_?_ **`)`**
+>
+> *attributes* → *attribute* *attributes*_?_
+>
+>
+>
+> *balanced-tokens* → *balanced-token* *balanced-tokens*_?_
+>
+> *balanced-token* → **`(`** *balanced-tokens*_?_ **`)`**
+>
+> *balanced-token* → **`[`** *balanced-tokens*_?_ **`]`**
+>
+> *balanced-token* → **`{`** *balanced-tokens*_?_ **`}`**
+>
+> *balanced-token* → Any identifier, keyword, literal, or operator
+>
+> *balanced-token* → Any punctuation except  **`(`**,  **`)`**,  **`[`**,  **`]`**,  **`{`**, or  **`}`**
+
 
 <!--
 This source file is part of the Swift.org open source project