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

Unpublish feature specs #34904

Merged
merged 6 commits into from
Apr 7, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
26 changes: 25 additions & 1 deletion .openpublishing.redirection.csharp.json
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,10 @@
"source_path_from_root": "/redirections/proposals/csharp-7.0/throw-expression.md",
"redirect_url": "/dotnet/csharp/language-reference/language-specification/expressions.md#1115-the-throw-expression-operator"
},
{
"source_path_from_root": "/redirections/proposals/csharp-7.0/out-var.md",
"redirect_url": "/dotnet/csharp/language-reference/language-specification/expressions.md#1117-declaration-expressions"
},
{
"source_path_from_root": "/redirections/proposals/csharp-7.1/async-main.md",
"redirect_url": "/dotnet/csharp/language-reference/language-specification/basic-concepts#71-application-startup"
Expand All @@ -24,6 +28,10 @@
"source_path_from_root": "/redirections/proposals/csharp-7.1/target-typed-default.md",
"redirect_url": "/dotnet/csharp/language-reference/language-specification/expressions#11719-default-value-expressions"
},
{
"source_path_from_root": "/redirections/proposals/csharp-7.1/infer-tuple-names.md",
"redirect_url": "/dotnet/csharp/language-reference/language-specification/types.md#8311-tuple-types"
},
{
"source_path_from_root": "/redirections/proposals/csharp-7.2/private-protected.md",
"redirect_url": "/dotnet/csharp/language-reference/language-specification/classes.md#1436-access-modifiers"
Expand Down Expand Up @@ -52,6 +60,22 @@
"source_path_from_root": "/redirections/proposals/csharp-7.3/blittable.md",
"redirect_url": "/dotnet/csharp/language-reference/language-specification/classes#1425-type-parameter-constraints"
},
{
"source_path_from_root": "/redirections/proposals/csharp-7.3/indexing-movable-fixed-fields.md",
"redirect_url": "/dotnet/csharp/language-reference/language-specification/unsafe-code#2283-fixed-size-buffers-in-expressions"
},
{
"source_path_from_root": "/redirections/proposals/csharp-7.3/pattern-based-fixed.md",
"redirect_url": "/dotnet/csharp/language-reference/language-specification/unsafe-code#227-the-fixed-statement"
},
{
"source_path_from_root": "/redirections/proposals/csharp-7.3/expression-variables-in-initializers.md",
"redirect_url": "/dotnet/csharp/language-reference/language-specification/expressions.md#1117-declaration-expressions"
},
{
"source_path_from_root": "/redirections/proposals/csharp-7.3/tuple-equality.md",
"redirect_url": "/dotnet/csharp/language-reference/language-specification/expressions.md#111211-tuple-equality-operators"
},
{
"source_path_from_root": "/redirections/proposals/csharp-10.0/generic-attributes.md",
"redirect_url": "/dotnet/csharp/language-reference/proposals/csharp-11.0/generic-attributes"
Expand Down Expand Up @@ -1098,7 +1122,7 @@
},
{
"source_path_from_root": "/docs/csharp/language-reference/proposals/csharp-7.3/index.md",
"redirect_url": "/dotnet/csharp/language-reference/proposals/csharp-7.3/blittable"
"redirect_url": "/dotnet/csharp/language-reference/proposals/csharp-7.3/ref-local-reassignment"
},
{
"source_path_from_root": "/docs/csharp/language-reference/proposals/csharp-8.0/index.md",
Expand Down
47 changes: 14 additions & 33 deletions docfx.json
Original file line number Diff line number Diff line change
Expand Up @@ -71,8 +71,10 @@
"csharp-7.0/throw-expression.md",
"csharp-7.0/tuples.md",
"csharp-7.0/value-task.md",
"csharp-7.0/out-var.md",
"csharp-7.1/async-main.md",
"csharp-7.1/target-typed-default.md",
"csharp-7.1/infer-tuple-names.md",
"csharp-7.2/leading-separator.md",
"csharp-7.2/readonly-struct.md",
"csharp-7.2/ref-struct-and-span.md",
Expand All @@ -85,6 +87,10 @@
"csharp-7.3/improved-overload-candidates.md",
"csharp-7.3/ref-loops.md",
"csharp-7.3/blittable.md",
"csharp-7.3/indexing-movable-fixed-fields.md",
"csharp-7.3/pattern-based-fixed.md",
"csharp-7.3/expression-variables-in-initializers.md",
"csharp-7.3/tuple-equality.md",
"csharp-8.0/alternative-interpolated-verbatim.md",
"csharp-8.0/async-using.md",
"csharp-8.0/constraints-in-overrides.md",
Expand Down Expand Up @@ -142,7 +148,6 @@
"exclude": [
"_csharplang/proposals/csharp-7.0/local-functions.md",
"_csharplang/proposals/csharp-7.0/throw-expression.md",
"_csharplang/proposals/csharp-7.0/throw-expression.md",
"_csharplang/proposals/csharp-7.1/target-typed-default.md",
"_csharplang/proposals/csharp-7.2/readonly-struct.md",
"_csharplang/proposals/csharp-7.2/non-trailing-named-arguments.md"
Expand Down Expand Up @@ -647,25 +652,13 @@
"_csharpstandard/standard/documentation-comments.md": "Documentation comments",
"_csharpstandard/standard/Bibliography.md": "Bibliography",
"_csharplang/proposals/csharp-7.0/pattern-matching.md": "Pattern matching",
"_csharplang/proposals/csharp-7.0/out-var.md": "Out variable declarations",
"_csharplang/proposals/csharp-7.0/binary-literals.md": "Binary literals",
"_csharplang/proposals/csharp-7.0/digit-separators.md": "Digit separators",
"_csharplang/proposals/csharp-7.0/task-types.md": "Async task types",
"_csharplang/proposals/csharp-7.1/target-typed-default.md": "Default expressions",
"_csharplang/proposals/csharp-7.1/infer-tuple-names.md": "Infer tuple member names",
"_csharplang/proposals/csharp-7.1/generics-pattern-match.md": "Pattern matching with generics",
"_csharplang/proposals/csharp-7.2/readonly-ref.md": "Readonly references",
"_csharplang/proposals/csharp-7.2/span-safety.md": "Compile time safety for ref-like types",
"_csharplang/proposals/csharp-7.2/non-trailing-named-arguments.md": "Non-trailing named arguments",
"_csharplang/proposals/csharp-7.2/private-protected.md": "Private protected",
"_csharplang/proposals/csharp-7.2/conditional-ref.md": "Conditional ref",
"_csharplang/proposals/csharp-7.2/leading-separator.md": "Leading digit separator",
"_csharplang/proposals/csharp-7.3/indexing-movable-fixed-fields.md": "Indexing fixed fields without pinning regardless of context",
"_csharplang/proposals/csharp-7.3/pattern-based-fixed.md": "Pattern-based fixed statement",
"_csharplang/proposals/csharp-7.3/ref-local-reassignment.md": "Ref local reassignment",
"_csharplang/proposals/csharp-7.3/stackalloc-array-initializers.md": "Stackalloc array initializers",
"_csharplang/proposals/csharp-7.3/expression-variables-in-initializers.md": "Expression variables in initializers",
"_csharplang/proposals/csharp-7.3/tuple-equality.md": "Tuple equality (==) and inequality (!=)",
"_csharplang/proposals/csharp-8.0/nullable-reference-types.md": "Null reference types - proposal",
"_csharplang/proposals/csharp-8.0/patterns.md": "Recursive pattern matching",
"_csharplang/proposals/csharp-8.0/default-interface-methods.md": "Default interface methods",
Expand Down Expand Up @@ -771,25 +764,13 @@
"_csharpstandard/standard/documentation-comments.md": "This appendix describes XML comments that are used to document your program.",
"_csharpstandard/standard/Bibliography.md": "This appendix lists external standards referenced in this specification.",
"_csharplang/proposals/csharp-7.0/pattern-matching.md": "This feature specification describes the pattern matching featues added in C# 7.0. Note that future releases built on this initial set of features.",
"_csharplang/proposals/csharp-7.0/out-var.md": "This feature specification describes syntax enhancements that enable declaring 'out' variables in the expression where they are used.",
"_csharplang/proposals/csharp-7.0/binary-literals.md": "This feature specification describes the syntax to declare binary literals for integral constants.",
"_csharplang/proposals/csharp-7.0/digit-separators.md": "This feature specification describes the syntax to allow separators between groups of digits in numeric literals.",
"_csharplang/proposals/csharp-7.0/task-types.md": "This feature specification describes the syntax to support async return types that match a pattern, rather than restricting them to Task.",
"_csharplang/proposals/csharp-7.1/target-typed-default.md": "This feature specification describes the syntax to use the default keyword where the type of the expression can be inferred by the compiler.",
"_csharplang/proposals/csharp-7.1/infer-tuple-names.md": "This feature specification describes how the compiler interprets and infers the members names in a tuple.",
"_csharplang/proposals/csharp-7.1/generics-pattern-match.md": "This feature specification describes syntax enhancements to enable pattern matching with generic types.",
"_csharplang/proposals/csharp-7.2/readonly-ref.md": "This feature specification describes how to create readonly references to variables. This includes the 'readonly' modifier on variables, and the 'in' modifier on parameters and arguments.",
"_csharplang/proposals/csharp-7.2/span-safety.md": "This feature specification describes the rules that govern 'ref struct' declarations and their use.",
"_csharplang/proposals/csharp-7.2/non-trailing-named-arguments.md": "This feature specification describes syntax enhancements that enable named arguments followed by positional arguments in a method call.",
"_csharplang/proposals/csharp-7.2/private-protected.md": "This feature specification describes the 'private protected' access modifier.",
"_csharplang/proposals/csharp-7.2/conditional-ref.md": "This feature specification describes the syntax enhancements for using 'ref' with '?:' expressions",
"_csharplang/proposals/csharp-7.2/leading-separator.md": "This feature specification describes syntax enhancements to support a leading digit separator in numeric literals.",
"_csharplang/proposals/csharp-7.3/indexing-movable-fixed-fields.md": "This feature specification describes syntax enhancement to support indexing fixed fields without pinning the memory, regardless of context.",
"_csharplang/proposals/csharp-7.3/pattern-based-fixed.md": "This feature specification describes syntax enhancements to enable more types to be the target of a fixed statement.",
"_csharplang/proposals/csharp-7.3/ref-local-reassignment.md": "This feature specification describes syntax enhancements that enable ref local variables to be assigned to refer to different storage after being initialized.",
"_csharplang/proposals/csharp-7.3/stackalloc-array-initializers.md": "This feature specification describes the syntax that enables arrays to be declared using the 'stackalloc' keyword.",
"_csharplang/proposals/csharp-7.3/expression-variables-in-initializers.md": "This feature specification enables declarations of 'out' variables in more locations.",
"_csharplang/proposals/csharp-7.3/tuple-equality.md": "This feature specification describes the rules governing tuple equality (==) and inequality (!=).",
"_csharplang/proposals/csharp-8.0/nullable-reference-types.md": "This feature specification describes nullable reference types.",
"_csharplang/proposals/csharp-8.0/patterns.md": "This feature specification describes recursive pattern matching, where patterns can nest inside other patterns.",
"_csharplang/proposals/csharp-8.0/default-interface-methods.md": "This feature specification describe the syntax updates necessary to support default interface methods. This includes declaring bodies in interface declarations, and supporting modifiers on declarations.",
Expand Down Expand Up @@ -864,14 +845,14 @@
},
"titleSuffix": {
"_csharpstandard/standard/*.md": "C# language specification",
"_csharplang/proposals/csharp-7.0/*.md": "C# 7.0 draft specifications",
"_csharplang/proposals/csharp-7.1/*.md": "C# 7.1 draft specifications",
"_csharplang/proposals/csharp-7.2/*.md": "C# 7.2 draft specifications",
"_csharplang/proposals/csharp-7.3/*.md": "C# 7.3 draft specifications",
"_csharplang/proposals/csharp-8.0/*.md": "C# 8.0 draft specifications",
"_csharplang/proposals/csharp-9.0/*.md": "C# 9.0 draft specifications",
"_csharplang/proposals/csharp-10.0/*.md": "C# 10.0 draft specifications",
"_csharplang/proposals/csharp-11.0/*.md": "C# 11.0 draft specifications",
"_csharplang/proposals/csharp-7.0/*.md": "C# 7.0 draft feature specifications",
"_csharplang/proposals/csharp-7.1/*.md": "C# 7.1 draft feature specifications",
"_csharplang/proposals/csharp-7.2/*.md": "C# 7.2 draft feature specifications",
"_csharplang/proposals/csharp-7.3/*.md": "C# 7.3 draft feature specifications",
"_csharplang/proposals/csharp-8.0/*.md": "C# 8.0 draft feature specifications",
"_csharplang/proposals/csharp-9.0/*.md": "C# 9.0 draft feature specifications",
"_csharplang/proposals/csharp-10.0/*.md": "C# 10.0 draft feature specifications",
"_csharplang/proposals/csharp-11.0/*.md": "C# 11.0 draft feature specifications",
"docs/framework/**/**.md": ".NET Framework",
"docs/framework/data/adonet/**/**.md": "ADO.NET",
"docs/framework/wcf/**/**.md": "WCF",
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -75,7 +75,7 @@ The following example shows the behavior of an async event handler. In the examp

An async method can return any type that has an accessible `GetAwaiter` method that returns an instance of an *awaiter type*. In addition, the type returned from the `GetAwaiter` method must have the <xref:System.Runtime.CompilerServices.AsyncMethodBuilderAttribute?displayProperty=nameWithType> attribute. You can learn more in the article on [Attributes read by the compiler](../language-reference/attributes/general.md#asyncmethodbuilder-attribute) or the feature spec for [Task like return types](~/_csharplang/proposals/csharp-7.0/task-types.md).

This feature is the complement to [awaitable expressions](~/_csharpstandard/standard/expressions.md#11882-awaitable-expressions), which describes the requirements for the operand of `await`. Generalized async return types enable the compiler to generate `async` methods that return different types. Generalized async return types enabled performance improvements in the .NET libraries. Because <xref:System.Threading.Tasks.Task> and <xref:System.Threading.Tasks.Task%601> are reference types, memory allocation in performance-critical paths, particularly when allocations occur in tight loops, can adversely affect performance. Support for generalized return types means that you can return a lightweight value type instead of a reference type to avoid additional memory allocations.
This feature is the complement to [awaitable expressions](~/_csharpstandard/standard/expressions.md#11982-awaitable-expressions), which describes the requirements for the operand of `await`. Generalized async return types enable the compiler to generate `async` methods that return different types. Generalized async return types enabled performance improvements in the .NET libraries. Because <xref:System.Threading.Tasks.Task> and <xref:System.Threading.Tasks.Task%601> are reference types, memory allocation in performance-critical paths, particularly when allocations occur in tight loops, can adversely affect performance. Support for generalized return types means that you can return a lightweight value type instead of a reference type to avoid additional memory allocations.

.NET provides the <xref:System.Threading.Tasks.ValueTask%601?displayProperty=nameWithType> structure as a lightweight implementation of a generalized task-returning value. To use the <xref:System.Threading.Tasks.ValueTask%601?displayProperty=nameWithType> type, you must add the `System.Threading.Tasks.Extensions` NuGet package to your project. The following example uses the <xref:System.Threading.Tasks.ValueTask%601> structure to retrieve the value of two dice rolls.

Expand Down
4 changes: 2 additions & 2 deletions docs/csharp/language-reference/builtin-types/enum.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,8 +74,8 @@ For more information, see the following sections of the [C# language specificati

- [Enums](~/_csharpstandard/standard/enums.md)
- [Enum values and operations](~/_csharpstandard/standard/enums.md#186-enum-values-and-operations)
- [Enumeration logical operators](~/_csharpstandard/standard/expressions.md#11123-enumeration-logical-operators)
- [Enumeration comparison operators](~/_csharpstandard/standard/expressions.md#11116-enumeration-comparison-operators)
- [Enumeration logical operators](~/_csharpstandard/standard/expressions.md#11133-enumeration-logical-operators)
- [Enumeration comparison operators](~/_csharpstandard/standard/expressions.md#11126-enumeration-comparison-operators)
- [Explicit enumeration conversions](~/_csharpstandard/standard/conversions.md#1033-explicit-enumeration-conversions)
- [Implicit enumeration conversions](~/_csharpstandard/standard/conversions.md#1024-implicit-enumeration-conversions)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -115,7 +115,7 @@ Instead use the <xref:System.Nullable.GetUnderlyingType%2A?displayProperty=nameW

For more information, see the following sections of the [C# language specification](~/_csharpstandard/standard/README.md):

- [Nullable types](~/_csharpstandard/standard/types.md#8311-nullable-value-types)
- [Nullable types](~/_csharpstandard/standard/types.md#8312-nullable-value-types)
- [Lifted operators](~/_csharpstandard/standard/expressions.md#1148-lifted-operators)
- [Implicit nullable conversions](~/_csharpstandard/standard/conversions.md#1026-implicit-nullable-conversions)
- [Explicit nullable conversions](~/_csharpstandard/standard/conversions.md#1034-explicit-nullable-conversions)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ A user-defined type can [overload](operator-overloading.md) the `+` operator. Wh

## C# language specification

For more information, see the [Unary plus operator](~/_csharpstandard/standard/expressions.md#1182-unary-plus-operator) and [Addition operator](~/_csharpstandard/standard/expressions.md#1195-addition-operator) sections of the [C# language specification](~/_csharpstandard/standard/README.md).
For more information, see the [Unary plus operator](~/_csharpstandard/standard/expressions.md#1192-unary-plus-operator) and [Addition operator](~/_csharpstandard/standard/expressions.md#11105-addition-operator) sections of the [C# language specification](~/_csharpstandard/standard/README.md).

## See also

Expand Down
Loading