From d2d218c5e8b554e0d3de07d28045a8cc25e021de Mon Sep 17 00:00:00 2001 From: Rex Jaeschke Date: Mon, 24 Jun 2024 11:51:50 -0400 Subject: [PATCH 1/4] Add .NET API Docs as a normative reference --- standard/normative-references.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/standard/normative-references.md b/standard/normative-references.md index b7d0b56cf..fbac6a5e2 100644 --- a/standard/normative-references.md +++ b/standard/normative-references.md @@ -10,4 +10,6 @@ ISO/IEC 2382, *Information technology — Vocabulary*. ISO/IEC 60559:2020, *Information technology — Microprocessor Systems — Floating-Point arithmetic* +*.NET API Documentation*, [https://learn.microsoft.com/en-us/dotnet/api](https://learn.microsoft.com/en-us/dotnet/api) + The Unicode Consortium. The Unicode Standard, https://www.unicode.org/standard/standard.html From f28f60ffe46379aa506593cf1750cff71063666b Mon Sep 17 00:00:00 2001 From: Rex Jaeschke Date: Mon, 24 Jun 2024 11:57:30 -0400 Subject: [PATCH 2/4] Add .NET API Docs as a normative reference --- standard/standard-library.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/standard/standard-library.md b/standard/standard-library.md index 65d0bce3f..b36b99b42 100644 --- a/standard/standard-library.md +++ b/standard/standard-library.md @@ -2,7 +2,7 @@ ## C.1 General -A conforming C# implementation shall provide a minimum set of types having specific semantics. These types and their members are listed here, in alphabetical order by namespace and type. For a formal definition of these types and their members, refer to ISO/IEC 23271:2012 *Common Language Infrastructure (CLI), Partition IV; Base Class Library (BCL), Extended Numerics Library, and Extended Array Library*, which are included by reference in this specification. +A conforming C# implementation shall provide a minimum set of types having specific semantics. These types and their members are listed here, in alphabetical order by namespace and type. For a formal definition of these types and their members, refer to ISO/IEC 23271:2012 *Common Language Infrastructure (CLI), Partition IV; Base Class Library (BCL), Extended Numerics Library*, and Extended Array Library*, which is supplemented by the *.NET API Documentation*, both of which are included by reference in this specification. (The .NET API Documentation can be searched using the fully qualified name of a type, as in `System.FormattableString` and the generic type `System.Threading.Tasks.Task<`.) **This text is informative.** @@ -22,7 +22,7 @@ It is expected that a conforming C# implementation will supply a significantly ## C.2 Standard Library Types defined in ISO/IEC 23271 > *Note:* Some `struct` types below have the `readonly` modifier. This modifier was not available -> when ISO/IEC 23271 was released, but is required for conforming implementations of this specification. *end note* +> when ISO/IEC 23271:2012 was released, but is required for conforming implementations of this specification. That modifier is, however, present in the .NET API Documentation for those types. *end note* ```csharp namespace System @@ -457,7 +457,7 @@ namespace System.Threading ## C.3 Standard Library Types not defined in ISO/IEC 23271 -The following types, including the members listed, shall be defined in a conforming standard library. (These types might be defined in a future edition of ISO/IEC 23271.) It is expected that many of these types will have more members available than are listed. +The following types, including the members listed, shall be defined in a conforming standard library. These types are not defined in ISO/IEC 23271:2012, but might be defined in a future edition of that specification. Until that occurs, the definitions of those types can be obtained from the .NET API Documentation. It is expected that many of these types as defined there will have more members available than are required by a conforming C# implementaion. A conforming implementation may provide `Task.GetAwaiter()` and `Task.GetAwaiter()` as extension methods. From ae53b69f856fbe2f3ab5a534e26b832858928afe Mon Sep 17 00:00:00 2001 From: Rex Jaeschke Date: Mon, 24 Jun 2024 12:11:22 -0400 Subject: [PATCH 3/4] fix formatting --- standard/standard-library.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/standard/standard-library.md b/standard/standard-library.md index b36b99b42..5a4e92102 100644 --- a/standard/standard-library.md +++ b/standard/standard-library.md @@ -2,7 +2,7 @@ ## C.1 General -A conforming C# implementation shall provide a minimum set of types having specific semantics. These types and their members are listed here, in alphabetical order by namespace and type. For a formal definition of these types and their members, refer to ISO/IEC 23271:2012 *Common Language Infrastructure (CLI), Partition IV; Base Class Library (BCL), Extended Numerics Library*, and Extended Array Library*, which is supplemented by the *.NET API Documentation*, both of which are included by reference in this specification. (The .NET API Documentation can be searched using the fully qualified name of a type, as in `System.FormattableString` and the generic type `System.Threading.Tasks.Task<`.) +A conforming C# implementation shall provide a minimum set of types having specific semantics. These types and their members are listed here, in alphabetical order by namespace and type. For a formal definition of these types and their members, refer to ISO/IEC 23271:2012 *Common Language Infrastructure (CLI), Partition IV; Base Class Library (BCL), Extended Numerics Library*, and Extended Array Library, which is supplemented by the *.NET API Documentation*, both of which are included by reference in this specification. (The .NET API Documentation can be searched using the fully qualified name of a type, as in `System.FormattableString` and the generic type `System.Threading.Tasks.Task<`.) **This text is informative.** From 913013484fbfb285a2aeaa2b819abef9faf11084 Mon Sep 17 00:00:00 2001 From: Rex Jaeschke Date: Mon, 24 Jun 2024 12:18:39 -0400 Subject: [PATCH 4/4] fix formatting --- standard/normative-references.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/standard/normative-references.md b/standard/normative-references.md index fbac6a5e2..034b71439 100644 --- a/standard/normative-references.md +++ b/standard/normative-references.md @@ -10,6 +10,6 @@ ISO/IEC 2382, *Information technology — Vocabulary*. ISO/IEC 60559:2020, *Information technology — Microprocessor Systems — Floating-Point arithmetic* -*.NET API Documentation*, [https://learn.microsoft.com/en-us/dotnet/api](https://learn.microsoft.com/en-us/dotnet/api) +*.NET API Documentation*, https://learn.microsoft.com/en-us/dotnet/api The Unicode Consortium. The Unicode Standard, https://www.unicode.org/standard/standard.html