Skip to content

Commit afea52f

Browse files
Remove "experimental API" warnings from members in the .NET protobuf runtime.
PiperOrigin-RevId: 736777274
1 parent 91d87ba commit afea52f

File tree

4 files changed

+17
-11
lines changed

4 files changed

+17
-11
lines changed

csharp/src/Google.Protobuf/Extension.cs

+7-5
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
#region Copyright notice and license
1+
#region Copyright notice and license
22
// Protocol Buffers - Google's data interchange format
33
// Copyright 2008 Google Inc. All rights reserved.
44
//
@@ -12,8 +12,12 @@
1212
namespace Google.Protobuf
1313
{
1414
/// <summary>
15-
/// Represents a non-generic extension definition. This API is experimental and subject to change.
15+
/// Represents a non-generic extension definition.
1616
/// </summary>
17+
/// <remarks>
18+
/// Most users will not use this abstract class directly, instead using the generated instances
19+
/// of the concrete subclasses.
20+
/// </remarks>
1721
public abstract class Extension
1822
{
1923
internal abstract Type TargetType { get; }
@@ -37,8 +41,7 @@ protected Extension(int fieldNumber)
3741
}
3842

3943
/// <summary>
40-
/// Represents a type-safe extension identifier used for getting and setting single extension values in <see cref="IExtendableMessage{T}"/> instances.
41-
/// This API is experimental and subject to change.
44+
/// Represents a type-safe extension identifier used for getting and setting single extension values in <see cref="IExtendableMessage{T}"/> instances.
4245
/// </summary>
4346
/// <typeparam name="TTarget">The message type this field applies to</typeparam>
4447
/// <typeparam name="TValue">The field value type of this extension</typeparam>
@@ -68,7 +71,6 @@ internal override IExtensionValue CreateValue()
6871

6972
/// <summary>
7073
/// Represents a type-safe extension identifier used for getting repeated extension values in <see cref="IExtendableMessage{T}"/> instances.
71-
/// This API is experimental and subject to change.
7274
/// </summary>
7375
/// <typeparam name="TTarget">The message type this field applies to</typeparam>
7476
/// <typeparam name="TValue">The repeated field value type of this extension</typeparam>

csharp/src/Google.Protobuf/ExtensionRegistry.cs

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
#region Copyright notice and license
1+
#region Copyright notice and license
22
// Protocol Buffers - Google's data interchange format
33
// Copyright 2008 Google Inc. All rights reserved.
44
//
@@ -15,7 +15,7 @@
1515
namespace Google.Protobuf
1616
{
1717
/// <summary>
18-
/// Provides extensions to messages while parsing. This API is experimental and subject to change.
18+
/// Provides extensions to messages while parsing.
1919
/// </summary>
2020
public sealed class ExtensionRegistry : ICollection<Extension>, IDeepCloneable<ExtensionRegistry>
2121
{

csharp/src/Google.Protobuf/ExtensionSet.cs

+7-2
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,14 @@ namespace Google.Protobuf
1818
{
1919
/// <summary>
2020
/// Methods for managing <see cref="ExtensionSet{TTarget}"/>s with null checking.
21-
///
22-
/// Most users will not use this class directly and its API is experimental and subject to change.
2321
/// </summary>
22+
/// <remarks>
23+
/// Most users will not use this class directly. Accessing extensions for a given message
24+
/// is usually performed by obtaining the generated instance of
25+
/// <see cref="Extension{TTarget,TValue}"/> or <see cref="RepeatedExtension{TTarget,TValue}"/>
26+
/// and then calling methods on <see cref="IExtendableMessage{T}"/> (which is implemented by
27+
/// all generated messages).
28+
/// </remarks>
2429
public static class ExtensionSet
2530
{
2631
private static bool TryGetValue<TTarget>(ref ExtensionSet<TTarget> set, Extension extension, out IExtensionValue value) where TTarget : IExtendableMessage<TTarget>

csharp/src/Google.Protobuf/UnsafeByteOperations.cs

+1-2
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
#region Copyright notice and license
1+
#region Copyright notice and license
22
// Protocol Buffers - Google's data interchange format
33
// Copyright 2008 Google Inc. All rights reserved.
44
//
@@ -48,7 +48,6 @@ public static class UnsafeByteOperations
4848
/// <summary>
4949
/// Constructs a new <see cref="ByteString" /> from the given bytes. The bytes are not copied,
5050
/// and must not be modified while the <see cref="ByteString" /> is in use.
51-
/// This API is experimental and subject to change.
5251
/// </summary>
5352
public static ByteString UnsafeWrap(ReadOnlyMemory<byte> bytes)
5453
{

0 commit comments

Comments
 (0)