Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
51 commits
Select commit Hold shift + click to select a range
b9ba04d
Start outlining a new chapter about macros.
amartini51 Mar 18, 2023
61dab9e
Add grammar and facts from the SE proposals.
amartini51 Mar 25, 2023
6de73b7
Expand outline of using macros.
amartini51 Mar 27, 2023
72ad788
Expand outline for macro expansion and declaration.
amartini51 Mar 27, 2023
df5ae1b
Pull from Swift Syntax APIs used in macro examples.
amartini51 Mar 27, 2023
893dd15
Add notes about expansion context.
amartini51 Mar 28, 2023
a2a5da0
Expand macros outline, including authoring macros.
amartini51 Apr 1, 2023
0a4f0f6
Apply TR feedback.
amartini51 Apr 13, 2023
a92ab9a
Add some notes from developmental edit.
amartini51 Apr 15, 2023
1dcf324
Expand the overview section from its outline.
amartini51 Apr 18, 2023
6ddef3e
Expand prose around macro expansion.
amartini51 Apr 21, 2023
665ed73
Show example macros more gradually.
amartini51 Apr 26, 2023
6bd71b7
Add naming convention for attributes & macros.
amartini51 Apr 27, 2023
acca003
Separate freestanding & attached; start on expansion.
amartini51 Apr 27, 2023
b51c24d
Add some more dev edit notes.
amartini51 May 5, 2023
4690a52
Move some detail out of the intro.
amartini51 May 5, 2023
672c5db
Move some details to a better spot.
amartini51 May 8, 2023
2707d02
Re-order sections, for better learning path flow.
amartini51 May 8, 2023
b27bc18
Rough in reference for @attached and @freestanding.
amartini51 May 8, 2023
b5eff3d
Start filling out discussion of declaring macros.
amartini51 May 8, 2023
dff0ee8
Finish drafting the declaring macros section.
amartini51 May 9, 2023
2c71204
Add a note about freestanding declaration macros.
amartini51 May 9, 2023
9e263fa
Try narrowing the guide's discussion of roles.
amartini51 May 9, 2023
66051d8
Build up to the full OptionSet macro declaration.
amartini51 May 9, 2023
52f28be
Expand the discussion of macro expansion.
amartini51 May 10, 2023
1d425df
Tidy up placeholder art.
amartini51 May 10, 2023
a5eba3d
Start a section on debugging.
amartini51 May 10, 2023
9c0768b
Re-order some outline bits.
amartini51 May 10, 2023
a663f76
Add macro-expansion overview diagram.
amartini51 May 10, 2023
7e63286
Expand the macro-implementation section.
amartini51 May 10, 2023
f376b38
Use 4 steps, to match the figure.
amartini51 May 10, 2023
b780046
Cross reference the right section.
amartini51 May 11, 2023
2bfcde0
Promote via a non-optional initializer.
amartini51 May 11, 2023
3033c09
Four character codes must be 4 characters long.
amartini51 May 11, 2023
1b747ea
Fix syntax in a link.
amartini51 May 11, 2023
2e5f0a2
Iterate on AST node names & use some real art.
amartini51 May 16, 2023
11dcc41
Add more macro AST diagrams.
amartini51 May 18, 2023
e3b98d7
Add fixmes about macro roles.
amartini51 May 18, 2023
eed5aa3
Remove syntax that is now a macro.
amartini51 May 20, 2023
c0c9111
Apply edits to the new chapter.
amartini51 May 19, 2023
045ebc0
Iterate on wording in "implementing" & "debugging".
amartini51 May 25, 2023
c4fb3bd
Apply edits to the reference.
amartini51 May 25, 2023
78f48da
Typo fix: camel case.
amartini51 May 26, 2023
f150a87
Additional edits.
amartini51 May 30, 2023
f164d1f
Fill in basic reference for macros.
amartini51 May 31, 2023
dff4478
Clear some fix-me markers.
amartini51 May 31, 2023
286cef7
Fix whitespace in code.
amartini51 May 31, 2023
50316f6
Fix markup in the grammar.
amartini51 Jun 1, 2023
0e862dc
Copy grammar changes into the summary.
amartini51 Jun 1, 2023
efae604
Clear out fix-me markers.
amartini51 Jun 2, 2023
499ede7
Iterate on wording; fix minor errors.
amartini51 Jun 3, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions Style.md
Original file line number Diff line number Diff line change
Expand Up @@ -98,6 +98,11 @@ which means it’s not always suitable for generating a parser for Swift code.

# Terms and Rules

## attribute names

In the guide, write `@` before attribute names;
in the reference, omit it.

## back deploy

Spelled as two words, not closed up or hyphenated.
Expand All @@ -122,6 +127,13 @@ you should generally try to avoid them.
Deeply nested headings often indicate
that there’s a better way to organize the content.

## macro names

In the guide,
write `@` before the name when referring to attached macros
and `#` before the name when referring to freestanding macros.
In the reference, omit it.

## memberwise initializer

Not hyphenated as “member-wise”.
Expand Down
Binary file added TSPL.docc/Assets/[email protected]
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added TSPL.docc/Assets/[email protected]
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added TSPL.docc/Assets/[email protected]
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added TSPL.docc/Assets/[email protected]
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added TSPL.docc/Assets/[email protected]
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added TSPL.docc/Assets/[email protected]
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added TSPL.docc/Assets/[email protected]
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added TSPL.docc/Assets/[email protected]
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added TSPL.docc/Assets/[email protected]
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added TSPL.docc/Assets/[email protected]
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added TSPL.docc/Assets/[email protected]
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added TSPL.docc/Assets/[email protected]
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading