Skip to content

Commit 9b33936

Browse files
committed
Restore the beta banner, for 5.9.2 betas.
This reverts commit 8c644d4, and adds the beta banner to the macros chapter.
1 parent 07f97a6 commit 9b33936

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

43 files changed

+258
-0
lines changed

TSPL.docc/GuidedTour/AboutSwift.md

+6
Original file line numberDiff line numberDiff line change
@@ -48,6 +48,12 @@ and it continues to evolve with new features and capabilities.
4848
Our goals for Swift are ambitious.
4949
We can’t wait to see what you create with it.
5050

51+
> Beta Software:
52+
>
53+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
54+
>
55+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
56+
5157
<!--
5258
This source file is part of the Swift.org open source project
5359

TSPL.docc/GuidedTour/Compatibility.md

+6
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,12 @@ that's divided into multiple frameworks,
4949
you can migrate your code from Swift 4 to 5.9.2
5050
one framework at a time.
5151

52+
> Beta Software:
53+
>
54+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
55+
>
56+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
57+
5258
<!--
5359
This source file is part of the Swift.org open source project
5460

TSPL.docc/GuidedTour/GuidedTour.md

+6
Original file line numberDiff line numberDiff line change
@@ -2450,6 +2450,12 @@ anyCommonElements([1, 2, 3], [3])
24502450
Writing `<T: Equatable>`
24512451
is the same as writing `<T> ... where T: Equatable`.
24522452

2453+
> Beta Software:
2454+
>
2455+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
2456+
>
2457+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
2458+
24532459
<!--
24542460
This source file is part of the Swift.org open source project
24552461

TSPL.docc/LanguageGuide/AccessControl.md

+6
Original file line numberDiff line numberDiff line change
@@ -1487,6 +1487,12 @@ but a public type alias can't alias an internal, file-private, or private type.
14871487
```
14881488
-->
14891489

1490+
> Beta Software:
1491+
>
1492+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
1493+
>
1494+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
1495+
14901496
<!--
14911497
This source file is part of the Swift.org open source project
14921498

TSPL.docc/LanguageGuide/AdvancedOperators.md

+6
Original file line numberDiff line numberDiff line change
@@ -1561,6 +1561,12 @@ see <doc:Attributes#resultBuilder>.
15611561
TODO: generic operators
15621562
-->
15631563

1564+
> Beta Software:
1565+
>
1566+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
1567+
>
1568+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
1569+
15641570
<!--
15651571
This source file is part of the Swift.org open source project
15661572

TSPL.docc/LanguageGuide/AutomaticReferenceCounting.md

+6
Original file line numberDiff line numberDiff line change
@@ -1512,6 +1512,12 @@ paragraph = nil
15121512
For more information about capture lists,
15131513
see <doc:Expressions#Capture-Lists>.
15141514

1515+
> Beta Software:
1516+
>
1517+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
1518+
>
1519+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
1520+
15151521
<!--
15161522
This source file is part of the Swift.org open source project
15171523

TSPL.docc/LanguageGuide/BasicOperators.md

+6
Original file line numberDiff line numberDiff line change
@@ -1231,6 +1231,12 @@ but the overall intention is clearer to the reader.
12311231
Readability is always preferred over brevity;
12321232
use parentheses where they help to make your intentions clear.
12331233

1234+
> Beta Software:
1235+
>
1236+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
1237+
>
1238+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
1239+
12341240
<!--
12351241
This source file is part of the Swift.org open source project
12361242

TSPL.docc/LanguageGuide/ClassesAndStructures.md

+6
Original file line numberDiff line numberDiff line change
@@ -710,6 +710,12 @@ see [Manual Memory Management](https://developer.apple.com/documentation/swift/s
710710
QUESTION: what's the deal with tuples and reference types / value types?
711711
-->
712712

713+
> Beta Software:
714+
>
715+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
716+
>
717+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
718+
713719
<!--
714720
This source file is part of the Swift.org open source project
715721

TSPL.docc/LanguageGuide/Closures.md

+6
Original file line numberDiff line numberDiff line change
@@ -1332,6 +1332,12 @@ As a result,
13321332
the value of the `customerProvider` argument
13331333
must be allowed to escape the function's scope.
13341334

1335+
> Beta Software:
1336+
>
1337+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
1338+
>
1339+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
1340+
13351341
<!--
13361342
This source file is part of the Swift.org open source project
13371343

TSPL.docc/LanguageGuide/CollectionTypes.md

+6
Original file line numberDiff line numberDiff line change
@@ -1469,6 +1469,12 @@ Swift's `Dictionary` type doesn't have a defined ordering.
14691469
To iterate over the keys or values of a dictionary in a specific order,
14701470
use the `sorted()` method on its `keys` or `values` property.
14711471

1472+
> Beta Software:
1473+
>
1474+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
1475+
>
1476+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
1477+
14721478
<!--
14731479
This source file is part of the Swift.org open source project
14741480

TSPL.docc/LanguageGuide/Concurrency.md

+6
Original file line numberDiff line numberDiff line change
@@ -1221,6 +1221,12 @@ preventing the type from being sendable.
12211221
but maybe link to them?
12221222
-->
12231223

1224+
> Beta Software:
1225+
>
1226+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
1227+
>
1228+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
1229+
12241230
<!--
12251231
This source file is part of the Swift.org open source project
12261232

TSPL.docc/LanguageGuide/ControlFlow.md

+6
Original file line numberDiff line numberDiff line change
@@ -2259,6 +2259,12 @@ when the check contains only fallback code.
22592259
You can use it with if-let, and other Boolean conditions, using a comma
22602260
-->
22612261

2262+
> Beta Software:
2263+
>
2264+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
2265+
>
2266+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
2267+
22622268
<!--
22632269
This source file is part of the Swift.org open source project
22642270

TSPL.docc/LanguageGuide/Deinitialization.md

+6
Original file line numberDiff line numberDiff line change
@@ -242,6 +242,12 @@ and so it's deallocated in order to free up its memory.
242242
Just before this happens, its deinitializer is called automatically,
243243
and its coins are returned to the bank.
244244

245+
> Beta Software:
246+
>
247+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
248+
>
249+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
250+
245251
<!--
246252
This source file is part of the Swift.org open source project
247253

TSPL.docc/LanguageGuide/Enumerations.md

+6
Original file line numberDiff line numberDiff line change
@@ -830,6 +830,12 @@ by evaluating the expression on the left-hand side,
830830
evaluating the expression on the right-hand side,
831831
and then adding them or multiplying them.
832832

833+
> Beta Software:
834+
>
835+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
836+
>
837+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
838+
833839
<!--
834840
This source file is part of the Swift.org open source project
835841

TSPL.docc/LanguageGuide/ErrorHandling.md

+6
Original file line numberDiff line numberDiff line change
@@ -775,6 +775,12 @@ even when no error handling code is involved.
775775
For more information,
776776
see <doc:ControlFlow#Deferred-Actions>.
777777

778+
> Beta Software:
779+
>
780+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
781+
>
782+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
783+
778784
<!--
779785
This source file is part of the Swift.org open source project
780786

TSPL.docc/LanguageGuide/Extensions.md

+6
Original file line numberDiff line numberDiff line change
@@ -682,6 +682,12 @@ and prints an appropriate description.
682682
> can be written in shorthand form inside the `switch` statement,
683683
> such as `.negative` rather than `Int.Kind.negative`.
684684
685+
> Beta Software:
686+
>
687+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
688+
>
689+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
690+
685691
<!--
686692
This source file is part of the Swift.org open source project
687693

TSPL.docc/LanguageGuide/Functions.md

+6
Original file line numberDiff line numberDiff line change
@@ -1304,6 +1304,12 @@ print("zero!")
13041304
```
13051305
-->
13061306

1307+
> Beta Software:
1308+
>
1309+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
1310+
>
1311+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
1312+
13071313
<!--
13081314
This source file is part of the Swift.org open source project
13091315

TSPL.docc/LanguageGuide/Generics.md

+6
Original file line numberDiff line numberDiff line change
@@ -1964,6 +1964,12 @@ is a sequence of integers.
19641964
TODO: Describe how Optional<Wrapped> works
19651965
-->
19661966

1967+
> Beta Software:
1968+
>
1969+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
1970+
>
1971+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
1972+
19671973
<!--
19681974
This source file is part of the Swift.org open source project
19691975

TSPL.docc/LanguageGuide/Inheritance.md

+6
Original file line numberDiff line numberDiff line change
@@ -607,6 +607,12 @@ Any attempt to subclass a final class is reported as a compile-time error.
607607
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
608608
-->
609609

610+
> Beta Software:
611+
>
612+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
613+
>
614+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
615+
610616
<!--
611617
This source file is part of the Swift.org open source project
612618

TSPL.docc/LanguageGuide/Initialization.md

+6
Original file line numberDiff line numberDiff line change
@@ -2954,6 +2954,12 @@ print(board.squareIsBlackAt(row: 7, column: 7))
29542954
```
29552955
-->
29562956

2957+
> Beta Software:
2958+
>
2959+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
2960+
>
2961+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
2962+
29572963
<!--
29582964
This source file is part of the Swift.org open source project
29592965

TSPL.docc/LanguageGuide/Macros.md

+6
Original file line numberDiff line numberDiff line change
@@ -742,6 +742,12 @@ in no particular order:
742742
- `TokenSyntax`
743743
-->
744744

745+
> Beta Software:
746+
>
747+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
748+
>
749+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
750+
745751
<!--
746752
This source file is part of the Swift.org open source project
747753

TSPL.docc/LanguageGuide/MemorySafety.md

+6
Original file line numberDiff line numberDiff line change
@@ -742,6 +742,12 @@ it doesn't allow the access.
742742
on performance and memory usage.
743743
-->
744744

745+
> Beta Software:
746+
>
747+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
748+
>
749+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
750+
745751
<!--
746752
This source file is part of the Swift.org open source project
747753

TSPL.docc/LanguageGuide/Methods.md

+6
Original file line numberDiff line numberDiff line change
@@ -650,6 +650,12 @@ if player.tracker.advance(to: 6) {
650650
(see Doug's comments from the 2014-03-12 release notes)
651651
-->
652652

653+
> Beta Software:
654+
>
655+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
656+
>
657+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
658+
653659
<!--
654660
This source file is part of the Swift.org open source project
655661

TSPL.docc/LanguageGuide/NestedTypes.md

+6
Original file line numberDiff line numberDiff line change
@@ -191,6 +191,12 @@ For the example above,
191191
this enables the names of `Suit`, `Rank`, and `Values` to be kept deliberately short,
192192
because their names are naturally qualified by the context in which they're defined.
193193

194+
> Beta Software:
195+
>
196+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
197+
>
198+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
199+
194200
<!--
195201
This source file is part of the Swift.org open source project
196202

TSPL.docc/LanguageGuide/OpaqueTypes.md

+6
Original file line numberDiff line numberDiff line change
@@ -921,6 +921,12 @@ which means that the type of `twelve` is also inferred to be `Int`.
921921
}
922922
-->
923923

924+
> Beta Software:
925+
>
926+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
927+
>
928+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
929+
924930
<!--
925931
This source file is part of the Swift.org open source project
926932

TSPL.docc/LanguageGuide/OptionalChaining.md

+6
Original file line numberDiff line numberDiff line change
@@ -883,6 +883,12 @@ if let beginsWithThe =
883883
the sugar for optional protocol requirements works.
884884
-->
885885

886+
> Beta Software:
887+
>
888+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
889+
>
890+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
891+
886892
<!--
887893
This source file is part of the Swift.org open source project
888894

TSPL.docc/LanguageGuide/Properties.md

+6
Original file line numberDiff line numberDiff line change
@@ -2060,6 +2060,12 @@ print(AudioChannel.maxInputLevelForAllChannels)
20602060
```
20612061
-->
20622062

2063+
> Beta Software:
2064+
>
2065+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
2066+
>
2067+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
2068+
20632069
<!--
20642070
This source file is part of the Swift.org open source project
20652071

TSPL.docc/LanguageGuide/Protocols.md

+6
Original file line numberDiff line numberDiff line change
@@ -2612,6 +2612,12 @@ print(differentNumbers.allEqual())
26122612
Checking for (and calling) optional implementations via optional binding and closures
26132613
-->
26142614

2615+
> Beta Software:
2616+
>
2617+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
2618+
>
2619+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
2620+
26152621
<!--
26162622
This source file is part of the Swift.org open source project
26172623

TSPL.docc/LanguageGuide/StringsAndCharacters.md

+6
Original file line numberDiff line numberDiff line change
@@ -1785,6 +1785,12 @@ for scalar in dogString.unicodeScalars {
17851785
```
17861786
-->
17871787

1788+
> Beta Software:
1789+
>
1790+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
1791+
>
1792+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
1793+
17881794
<!--
17891795
This source file is part of the Swift.org open source project
17901796

TSPL.docc/LanguageGuide/Subscripts.md

+6
Original file line numberDiff line numberDiff line change
@@ -422,6 +422,12 @@ print(mars)
422422
```
423423
-->
424424

425+
> Beta Software:
426+
>
427+
> This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
428+
>
429+
> Learn more about using [Apple's beta software](https://developer.apple.com/support/beta-software/).
430+
425431
<!--
426432
This source file is part of the Swift.org open source project
427433

0 commit comments

Comments
 (0)