Add XML comments to public entities.

MediaTypeFromDevice/FromAta.cs

@@ -38,6 +38,16 @@ namespace Aaru.CommonTypes
 {
     public static partial class MediaTypeFromDevice
     {
+        /// <summary>
+        /// Gets the media type from an ATA (not ATAPI) device
+        /// </summary>
+        /// <param name="manufacturer">Manufacturer string</param>
+        /// <param name="model">Model string</param>
+        /// <param name="removable">Is the device removable?</param>
+        /// <param name="compactFlash">Does the device self-identify as CompactFlash?</param>
+        /// <param name="pcmcia">Is the device attached thru PCMCIA or CardBus?</param>
+        /// <param name="blocks">Number of blocks in device</param>
+        /// <returns>The media type</returns>
         public static MediaType GetFromAta(string manufacturer, string model, bool removable, bool compactFlash,
                                            bool pcmcia, ulong blocks)
         {

MediaTypeFromDevice/FromMmc.cs

@@ -37,8 +37,22 @@ using Aaru.Console;
 
 namespace Aaru.CommonTypes
 {
+    /// <summary>
+    /// Gets the media type from a real device
+    /// </summary>
     public static partial class MediaTypeFromDevice
     {
+        /// <summary>
+        /// Gets the media type from an SCSI MultiMedia Commands compliant device
+        /// </summary>
+        /// <param name="model">Model string</param>
+        /// <param name="mediumType">Medium type from MODE SENSE</param>
+        /// <param name="densityCode">Density code from MODE SENSE</param>
+        /// <param name="blocks">Number of blocks in media</param>
+        /// <param name="blockSize">Size of a block in bytes</param>
+        /// <param name="isUsb">Is the device USB attached</param>
+        /// <param name="opticalDisc">Is the media an optical disc</param>
+        /// <returns>Media type</returns>
         static MediaType GetFromMmc(string model, byte mediumType, byte densityCode, ulong blocks, uint blockSize,
                                     bool isUsb, bool opticalDisc)
         {

MediaTypeFromDevice/FromOdc.cs

@@ -38,6 +38,13 @@ namespace Aaru.CommonTypes
 {
     public static partial class MediaTypeFromDevice
     {
+        /// <summary>
+        /// Gets the device type from a SCSI Optical Device
+        /// </summary>
+        /// <param name="mediumType">Medium type from MODE SENSE</param>
+        /// <param name="blocks">Number of blocks in device</param>
+        /// <param name="blockSize">Size in bytes of a block</param>
+        /// <returns>Media type</returns>
         static MediaType GetFromOdc(byte mediumType, ulong blocks, uint blockSize)
         {
             if(mediumType != 0x01 &&

MediaTypeFromDevice/FromSbc.cs

@@ -39,6 +39,15 @@ namespace Aaru.CommonTypes
 {
     public static partial class MediaTypeFromDevice
     {
+        /// <summary>
+        /// Gets the media type from a SCSI Block Commands compliant device
+        /// </summary>
+        /// <param name="vendor">Vendor string</param>
+        /// <param name="model">Model string</param>
+        /// <param name="mediumType">Medium type from MODE SENSE</param>
+        /// <param name="blocks">Number of blocks in device</param>
+        /// <param name="blockSize">Size of a block in bytes</param>
+        /// <returns>Media type</returns>
         static MediaType GetFromSbc(string vendor, string model, byte mediumType, ulong blocks, uint blockSize)
         {
             if(vendor.ToLowerInvariant() == "syquest" &&

MediaTypeFromDevice/FromScsi.cs

@@ -48,8 +48,8 @@ namespace Aaru.CommonTypes
         /// <param name="blocks">How many blocks are on the media</param>
         /// <param name="blockSize">Size in bytes of each block</param>
         /// <param name="isUsb">Device is USB</param>
-        /// <param name="opticalDisc"></param>
-        /// <returns></returns>
+        /// <param name="opticalDisc">Is media an optical disc?</param>
+        /// <returns>The media type</returns>
         public static MediaType GetFromScsi(byte scsiPeripheralType, string vendor, string model, byte mediumType,
                                             byte densityCode, ulong blocks, uint blockSize, bool isUsb,
                                             bool opticalDisc)

MediaTypeFromDevice/FromSsc.cs

@@ -39,6 +39,17 @@ namespace Aaru.CommonTypes
 {
     public static partial class MediaTypeFromDevice
     {
+        /// <summary>
+        /// Gets the media type from an SCSI Streaming Commands compliant device
+        /// </summary>
+        /// <param name="scsiPeripheralType">Peripheral type</param>
+        /// <param name="vendor">Vendor string</param>
+        /// <param name="model">Model string</param>
+        /// <param name="mediumType">Medium type from MODE SENSE</param>
+        /// <param name="densityCode">Density code from MODE SENSE</param>
+        /// <param name="blocks">Number of blocks in media</param>
+        /// <param name="blockSize">Size of a block in bytes</param>
+        /// <returns>Media type</returns>
         public static MediaType GetFromSsc(byte scsiPeripheralType, string vendor, string model, byte mediumType,
                                            byte densityCode, ulong blocks, uint blockSize)
         {