Skip to content

Commit 50e1adf

Browse files
committed
Link from to the issue being worked around.
1 parent 4a6f51d commit 50e1adf

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

Sources/TSPL/TSPL.docc/ReferenceManual/LexicalStructure.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -126,6 +126,14 @@ but `` `class` `` is valid.
126126
The backticks aren't considered part of the identifier;
127127
`` `x` `` and `x` have the same meaning.
128128

129+
<!--
130+
The paragraph above produces a link-resolution warning
131+
because of a known issue with ` in code voice.
132+
133+
https://github.com/apple/swift-book/issues/71
134+
https://github.com/apple/swift-markdown/issues/93
135+
-->
136+
129137
Inside a closure with no explicit parameter names,
130138
the parameters are implicitly named `$0`, `$1`, `$2`, and so on.
131139
These names are valid identifiers within the scope of the closure.
@@ -143,6 +151,15 @@ of the <doc:Attributes> chapter.
143151
the section name isn't title case so it doesn't necessarily look like a title.
144152
-->
145153

154+
<!--
155+
The formal grammar below for 'identifier'
156+
produces a link-resolution warning
157+
because of a known issue with ` in code voice.
158+
159+
https://github.com/apple/swift-book/issues/71
160+
https://github.com/apple/swift-markdown/issues/93
161+
-->
162+
146163
> Grammar of an identifier:
147164
>
148165
> *identifier**identifier-head* *identifier-characters*_?_

0 commit comments

Comments
 (0)