Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Discuss @backDeployed attribute [SE-0376] #202

Closed
tshortli opened this issue Oct 26, 2023 · 0 comments · Fixed by #204
Closed

Discuss @backDeployed attribute [SE-0376] #202

tshortli opened this issue Oct 26, 2023 · 0 comments · Fixed by #204
Labels
Content issue A problem in with the book's prose, code, or figures

Comments

@tshortli
Copy link

tshortli commented Oct 26, 2023

Description

A section on the @backDeployed attribute (SE-0376) is missing from the book. The attribute's intended use is very narrow; it's intended primarily for use in ABI stable libraries that ship in OSes. Because of the narrow applicability I wouldn't normally consider the attribute a high priority for documentation in TSPL. However, it's been brought to my attention on the Swift forums that many developers have misconceptions about what @backDeployed is designed to accomplish and as a result they're trying to use it in their apps (to create poyfills for system APIs) and getting frustrated. It would be nice to have a section of TSPL that spells out the intended uses of @backDeployed and specifically addresses this misconception.

rdar://117591533

@amartini51 amartini51 added the Content issue A problem in with the book's prose, code, or figures label Oct 31, 2023
amartini51 added a commit that referenced this issue Nov 9, 2023
Fixes: #202
Fixes: rdar://117591533
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Content issue A problem in with the book's prose, code, or figures
Projects
None yet
2 participants