diff --git a/docs/fundamentals/syslib-diagnostics/experimental-overview.md b/docs/fundamentals/syslib-diagnostics/experimental-overview.md index f180077ce23e9..495e2afb4e0f8 100644 --- a/docs/fundamentals/syslib-diagnostics/experimental-overview.md +++ b/docs/fundamentals/syslib-diagnostics/experimental-overview.md @@ -21,7 +21,7 @@ The following table provides an index to the `SYSLIB5XXX` experimental APIs in . | - | - | - | | SYSLIB5001 | .NET 9 | and related APIs in are experimental | | SYSLIB5002 | .NET 9 | alternate colors are experimental | -| SYSLIB5003 | .NET 9 | is experimental | +| [SYSLIB5003](./syslib5003.md) | .NET 9 | is experimental | | SYSLIB5004 | .NET 9 | is experimental since performance is not as optimized as `T.DivRem` | | SYSLIB5005 | .NET 9 | is experimental | diff --git a/docs/fundamentals/syslib-diagnostics/syslib5003.md b/docs/fundamentals/syslib-diagnostics/syslib5003.md new file mode 100644 index 0000000000000..e21b1b330eebc --- /dev/null +++ b/docs/fundamentals/syslib-diagnostics/syslib5003.md @@ -0,0 +1,25 @@ +--- +title: SYSLIB5003 warning +description: Learn about the diagnostic that generates compile-time warning SYSLIB5003. +ms.date: 11/01/2024 +f1_keywords: + - syslib5003 +--- + +# SYSLIB5003: SVE is a preview feature can be used by enabling EnablePreviewFeatures flag + +In .NET 9, the first set of non-streaming SVE APIs were introduced and annotated with the . This attribute indicates that both the internal implementation and the generated code for SVE might undergo changes. These potential changes include modifications to method signatures, parameters, or namespaces in future updates, aimed at ensuring robust support for upcoming SVE technologies and streaming SVE designs. If you're using these APIs in your project, you'll need to suppress the `SYSLIB5003` diagnostic. + +To suppress the warnings in a project file: + +```xml + + + $(NoWarn);SYSLIB5003 + +``` + +## See also + +- [Experimental features](experimental-overview.md) +- [Future work](https://devblogs.microsoft.com/dotnet/engineering-sve-in-dotnet/#8.-future) diff --git a/docs/navigate/tools-diagnostics/toc.yml b/docs/navigate/tools-diagnostics/toc.yml index b499f28ee9f60..0e91f070f6a65 100644 --- a/docs/navigate/tools-diagnostics/toc.yml +++ b/docs/navigate/tools-diagnostics/toc.yml @@ -1809,6 +1809,9 @@ items: - name: Overview displayName: syslib, experimental href: ../../fundamentals/syslib-diagnostics/experimental-overview.md + - name: SYSLIB5003 + href: ../../fundamentals/syslib-diagnostics/syslib5003.md + displayProperty: syslib5003 - name: Source-generated code items: - name: Overview