Skip to content

Commit b097bb5

Browse files
authored
Add docs for SYSLIB5003 (#43288)
1 parent f72b02b commit b097bb5

File tree

3 files changed

+29
-1
lines changed

3 files changed

+29
-1
lines changed

docs/fundamentals/syslib-diagnostics/experimental-overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ The following table provides an index to the `SYSLIB5XXX` experimental APIs in .
2121
| - | - | - |
2222
| SYSLIB5001 | .NET 9 | <xref:System.Numerics.Tensors.Tensor%601> and related APIs in <xref:System.Numerics.Tensors> are experimental |
2323
| SYSLIB5002 | .NET 9 | <xref:System.Drawing.SystemColors> alternate colors are experimental |
24-
| SYSLIB5003 | .NET 9 | <xref:System.Runtime.Intrinsics.Arm.Sve> is experimental |
24+
| [SYSLIB5003](./syslib5003.md) | .NET 9 | <xref:System.Runtime.Intrinsics.Arm.Sve> is experimental |
2525
| SYSLIB5004 | .NET 9 | <xref:System.Runtime.Intrinsics.X86.X86Base.DivRem(System.UInt32,System.Int32,System.Int32)> is experimental since performance is not as optimized as `T.DivRem` |
2626
| SYSLIB5005 | .NET 9 | <xref:System.Formats.Nrbf> is experimental |
2727

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
---
2+
title: SYSLIB5003 warning
3+
description: Learn about the diagnostic that generates compile-time warning SYSLIB5003.
4+
ms.date: 11/01/2024
5+
f1_keywords:
6+
- syslib5003
7+
---
8+
9+
# SYSLIB5003: SVE is a preview feature can be used by enabling EnablePreviewFeatures flag
10+
11+
In .NET 9, the first set of non-streaming SVE APIs were introduced and annotated with the <xref:System.Diagnostics.CodeAnalysis.ExperimentalAttribute>. 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.
12+
13+
To suppress the warnings in a project file:
14+
15+
```xml
16+
<PropertyGroup>
17+
<!-- SYSLIB50003: System.Runtime.Intrinsics.Arm.Sve is experimental -->
18+
<NoWarn>$(NoWarn);SYSLIB5003</NoWarn>
19+
</PropertyGroup>
20+
```
21+
22+
## See also
23+
24+
- [Experimental features](experimental-overview.md)
25+
- [Future work](https://devblogs.microsoft.com/dotnet/engineering-sve-in-dotnet/#8.-future)

docs/navigate/tools-diagnostics/toc.yml

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1813,6 +1813,9 @@ items:
18131813
- name: Overview
18141814
displayName: syslib, experimental
18151815
href: ../../fundamentals/syslib-diagnostics/experimental-overview.md
1816+
- name: SYSLIB5003
1817+
href: ../../fundamentals/syslib-diagnostics/syslib5003.md
1818+
displayProperty: syslib5003
18161819
- name: Source-generated code
18171820
items:
18181821
- name: Overview

0 commit comments

Comments
 (0)