support scoped keyword in method parameters (#655)

* support scoped keyword

* renaming

Author: gangzhang-ms

mdoc/Mono.Documentation/Updater/Formatters/CSharpFullMemberFormatter.cs

@@ -608,6 +608,13 @@ protected override StringBuilder AppendParameter(StringBuilder buf, ParameterDef
             TypeReference parameterType = parameter.ParameterType;
             var refType = new BitArray(3);
 
+            if (parameter.HasCustomAttributes)
+            {
+                var isScoped = parameter.CustomAttributes.Any(ca => ca.AttributeType.Name == "LifetimeAnnotationAttribute");
+                if (isScoped)
+                    buf.AppendFormat("scoped ");
+            }
+
             if (parameterType is RequiredModifierType requiredModifierType)
             {
                 switch(requiredModifierType.ModifierType.FullName)

mdoc/mdoc.Test/FormatterTests.cs

@@ -271,6 +271,15 @@ public void CSharpRefReturnMethodTest(Type type, string methodName, string expec
             Assert.AreEqual(expectedSignature, actualSignature);
         }
 
+        [TestCase(typeof(SomeClass), "TestScopedParams", "public ref T TestScopedParams<T> (scoped in T p1, out T p2, scoped ref T p3);")]
+        public void CSharpScopedParamsTest(Type type, string methodName, string expectedSignature)
+        {
+            var member = GetMethod(type, m => m.Name == methodName);
+            var actualSignature = formatter.GetDeclaration(member);
+            Assert.AreEqual(expectedSignature, actualSignature);
+        }
+
+
         [TestCase(typeof(ReadonlyRefClass), "RefProperty", "public ref int RefProperty { get; }")]
         [TestCase(typeof(ReadonlyRefClass), "Item", "public ref readonly int this[int index] { get; }")]
         [TestCase(typeof(GenericRefClass<>), "RefProperty", "public ref T RefProperty { get; }")]

mdoc/mdoc.Test/SampleClasses/SomeClass.cs

@@ -1,4 +1,5 @@
-using System;
+using Mono.Cecil.Cil;
+using System;
 using Windows.Foundation.Metadata;
 
 namespace mdoc.Test.SampleClasses
@@ -98,6 +99,11 @@ public void get_Method()
         {
         }
 
+        public ref T TestScopedParams<T>(scoped in T p1, scoped out T p2, scoped ref T p3)
+        {
+            throw new PlatformNotSupportedException();
+        }
+
         public event EventHandler<object> AppMemoryUsageIncreased;
         public static event EventHandler<object> StaticEvent;
         private static event EventHandler<object> PrivateEvent;

mdoc/mdoc.Test/mdoc.Test.csproj

@@ -8,11 +8,11 @@
   <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
     <OutputPath>bin\Debug</OutputPath>
     <DefineConstants>DEBUG;</DefineConstants>
-    <LangVersion>latest</LangVersion>
+    <LangVersion>preview</LangVersion>
   </PropertyGroup>
   <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
     <OutputPath>bin\Release</OutputPath>
-    <LangVersion>latest</LangVersion>
+    <LangVersion>preview</LangVersion>
   </PropertyGroup>
   <PropertyGroup>
     <RunPostBuildEvent>Always</RunPostBuildEvent>