Add NamespaceDoc

Author: wherewhere

AdvancedSharpAdbClient.WinRT/AdbClient.cs

@@ -54,6 +54,12 @@ public sealed class AdbClient : IAdbClient, IAdbClientAsync, IDeviceExtensions,
         /// </summary>
         public static int DefaultAdbServerPort { get; } = AdvancedSharpAdbClient.AdbClient.DefaultAdbServerPort;
 
+        /// <summary>
+        /// Gets a new instance of the <see cref="AdbClient"/> class.
+        /// </summary>
+        [Deprecated("This function has been removed since SharpAdbClient. Here is a placeholder which function is gets a new instance instead of gets or sets the default instance.", DeprecationType.Deprecate, 65536)]
+        public static AdbClient Instance => new();
+
         /// <summary>
         /// Initializes a new instance of the <see cref="AdbClient"/> class.
         /// </summary>

AdvancedSharpAdbClient.WinRT/AdbServer.cs

@@ -1,6 +1,5 @@
 using AdvancedSharpAdbClient.WinRT.Extensions;
 using System.Runtime.InteropServices.WindowsRuntime;
-using System.Threading;
 using Windows.ApplicationModel;
 using Windows.Foundation;
 

AdvancedSharpAdbClient.WinRT/AdbSocket.cs

@@ -126,7 +126,7 @@ public static int WriteBufferSize
 
         /// <inheritdoc/>
         public IAsyncAction SendAdbRequestAsync(string request) => AsyncInfo.Run((cancellationToken) => adbSocket.SendAdbRequestAsync(request, cancellationToken));
-        
+
         /// <inheritdoc/>
         public int Read([WriteOnlyArray] byte[] data) => adbSocket.Read(data);
 

AdvancedSharpAdbClient.WinRT/AdvancedSharpAdbClient.WinRT.csproj

@@ -26,7 +26,7 @@
   <PropertyGroup Condition="'$(TargetFramework)' == 'net6.0-windows10.0.17763.0'">
     <CsWinRTComponent>true</CsWinRTComponent>
     <CsWinRTWindowsMetadata>10.0.22621.0</CsWinRTWindowsMetadata>
-    <NoWarn>CS1591</NoWarn>
+    <NoWarn>CS0618;CS1591</NoWarn>
     <Platforms>x64;x86;ARM64;ARM</Platforms>
   </PropertyGroup>
 

AdvancedSharpAdbClient.WinRT/DeviceCommands/NamespaceDoc.cs

@@ -0,0 +1,15 @@
+// <copyright file="NamespaceDoc.cs" company="The Android Open Source Project, Ryan Conrad, Quamotion, yungd1plomat, wherewhere">
+// Copyright (c) The Android Open Source Project, Ryan Conrad, Quamotion, yungd1plomat, wherewhere. All rights reserved.
+// </copyright>
+
+using System.Runtime.CompilerServices;
+
+namespace AdvancedSharpAdbClient.WinRT.DeviceCommands
+{
+    /// <summary>
+    /// The classes in this namespace provide Device Commands of adb.
+    /// </summary>
+    /// <remarks><c>Copyright (c) The Android Open Source Project, Ryan Conrad, Quamotion, yungd1plomat, wherewhere. All rights reserved.</c></remarks>
+    [CompilerGenerated]
+    internal class NamespaceDoc { }
+}

AdvancedSharpAdbClient.WinRT/Interfaces/IAdbCommandLineClient.cs

@@ -2,7 +2,6 @@
 // Copyright (c) The Android Open Source Project, Ryan Conrad, Quamotion, yungd1plomat, wherewhere. All rights reserved.
 // </copyright>
 
-using System;
 using Windows.ApplicationModel;
 
 namespace AdvancedSharpAdbClient.WinRT

AdvancedSharpAdbClient.WinRT/Models/DeviceDataEventArgs.cs

@@ -2,7 +2,6 @@
 // Copyright (c) The Android Open Source Project, Ryan Conrad, Quamotion, yungd1plomat, wherewhere. All rights reserved.
 // </copyright>
 
-using System;
 using System.Collections.Generic;
 using System.Linq;
 

AdvancedSharpAdbClient.WinRT/Models/Element.cs

@@ -6,8 +6,6 @@
 using System.Collections.Generic;
 using System.Linq;
 using System.Runtime.InteropServices.WindowsRuntime;
-using System.Xml;
-using System.Xml.Linq;
 using Windows.Data.Xml.Dom;
 using Windows.Foundation;
 using XmlDocument = Windows.Data.Xml.Dom.XmlDocument;

AdvancedSharpAdbClient.WinRT/NamespaceDoc.cs

@@ -0,0 +1,60 @@
+// <copyright file="NamespaceDoc.cs" company="The Android Open Source Project, Ryan Conrad, Quamotion, yungd1plomat, wherewhere">
+// Copyright (c) The Android Open Source Project, Ryan Conrad, Quamotion, yungd1plomat, wherewhere. All rights reserved.
+// </copyright>
+
+using System.Runtime.CompilerServices;
+
+namespace AdvancedSharpAdbClient.WinRT
+{
+    /// <summary>
+    /// 
+    /// <para>
+    /// AdvancedSharpAdbClient is a .NET library that allows.NET applications to communicate with Android devices.
+    /// It provides a.NET implementation of the <c>adb</c> protocol, giving more flexibility to the developer than launching an
+    /// <c>adb.exe</c> process and parsing the console output.
+    /// </para>
+    ///
+    /// <para>
+    /// Most of the adb functionality is exposed through the <see cref="AdbClient"/> class.
+    /// You can create your own instance of that class, or just use the instance we provide for you at
+    /// <see cref="AdbClient.Instance"/>
+    /// </para>
+    ///
+    /// <para>
+    /// To send and receive files to and from Android devices, you can use the <see cref="SyncService"/> class.
+    /// </para>
+    ///
+    /// <para>
+    /// To be notified when Android devices connect to or disconnect from your PC, you can use the <see cref="DeviceMonitor"/>
+    /// class.
+    /// </para>
+    /// 
+    /// </summary>
+    ///
+    /// <example>
+    /// 
+    /// <para>
+    /// To list all Android devices that are connected to your PC, you can use the following code:
+    /// </para>
+    ///
+    /// <code>
+    /// var devices = devices = new AdbClient().GetDevices();
+    ///
+    /// foreach(var device in devices)
+    /// {
+    ///     Console.WriteLine(device.Name);
+    /// }
+    /// </code>
+    /// 
+    /// </example>
+    /// 
+    /// <remarks>
+    /// 
+    /// <c>
+    /// Copyright (c) The Android Open Source Project, Ryan Conrad, Quamotion, yungd1plomat, wherewhere. All rights reserved.
+    /// </c>
+    /// 
+    /// </remarks>
+    [CompilerGenerated]
+    internal class NamespaceDoc { }
+}