apple / swift-book

The Swift Programming Language book

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Update The Swift Programming Language for SE-0386 (2 of 5)

tadbyt opened this issue · comments

Location

https://docs.swift.org/swift-book/documentation/the-swift-programming-language/accesscontrol#Access-Levels

Description

Update The Swift Programming Language to match the language changes implemented by SE-0386. Five subsections in the document were identified as being impacted by the implementation of SE-0386. This is the second impacted subsection.

Correction

Replace the first paragraph with:
Swift provides six different access levels for entities within your code. These access levels are relative to the source file in which an entity is defined, to the module that source file belongs to and to the package that the module belongs to.
Add the following as the second bullet in the subsequent list:
• Package access enables entities to be used within any source file from their defining package, but not in any source file outside of that package. You typically use internal access when defining an app’s or a framework’s internal structure that spans multiple modules.
Append the following to the end of the next bullet: contained within a single module

Thanks for this detailed write-up! No need to track each change separately — I'm copying this content all into the first issue.

As a note, in the future, you're welcome to open a PR to implement these changes in source, instead of describing them in an issue. It might actually be faster for you. But either approach is appreciated.

Tracking all of this work under #215 (Adding the link here to make a back-reference show up on that bug.)