Complete file headers.

2025-12-16 19:24:30 +00:00 · 2020-03-11 21:56:46 +00:00
parent 342a779c5c
commit 90ffe6950e
19 changed files with 97 additions and 21 deletions
--- a/Enums/DeviceType.cs
+++ b/Enums/DeviceType.cs
@@ -9,7 +9,7 @@
 //
 // --[ Description ] ----------------------------------------------------------
 //
-//     Defines enumerations of devce types.
+//     Defines enumerations of device types.
 //
 // --[ License ] --------------------------------------------------------------
 //
--- a/Interfaces/IArchive.cs
+++ b/Interfaces/IArchive.cs
@@ -9,7 +9,7 @@
 //
 // --[ Description ] ----------------------------------------------------------
 //
-//     Defines the interface for an Archive.
+//     Defines the interface for implementing archive plugins.
 //
 // --[ License ] --------------------------------------------------------------
 //
--- a/Interfaces/IFloppyImage.cs
+++ b/Interfaces/IFloppyImage.cs
@@ -9,7 +9,7 @@
 //
 // --[ Description ] ----------------------------------------------------------
 //
-//     Defines interface to be implemented by floppy image plugins.
+//     Defines the interface to be implemented by floppy image plugins.
 //
 // --[ License ] --------------------------------------------------------------
 //
--- a/Interfaces/IOpticalMediaImage.cs
+++ b/Interfaces/IOpticalMediaImage.cs
@@ -9,7 +9,7 @@
 //
 // --[ Description ] ----------------------------------------------------------
 //
-//     Defines interface to be implemented by optical disc image plugins.
+//     Defines the interface to be implemented by optical disc image plugins.
 //
 // --[ License ] --------------------------------------------------------------
 //
--- a/Interfaces/IPartitionableMediaImage.cs
+++ b/Interfaces/IPartitionableMediaImage.cs
@@ -9,8 +9,8 @@
 //
 // --[ Description ] ----------------------------------------------------------
 //
-//     Defines interface to be implemented by image plugins that can contain
-//     partitioned medias, usually optical discs and some newer tapes.
+//     Defines the interface to be implemented by image plugins that can
+//     contain partitioned medias, usually optical discs and some newer tapes.
 //
 // --[ License ] --------------------------------------------------------------
 //
--- a/Interfaces/ITapeImage.cs
+++ b/Interfaces/ITapeImage.cs
@@ -9,8 +9,8 @@
 //
 // --[ Description ] ----------------------------------------------------------
 //
-//     Defines interface to be implemented by block addressable sequential tape
-//     image plugins.
+//     Defines the interface to be implemented by block addressable sequential
+//     tape image plugins.
 //
 // --[ License ] --------------------------------------------------------------
 //
--- a/Interfaces/IWritableFloppyImage.cs
+++ b/Interfaces/IWritableFloppyImage.cs
@@ -9,7 +9,7 @@
 //
 // --[ Description ] ----------------------------------------------------------
 //
-//     Defines interface to be implemented by floppy image plugins.
+//     Defines the interface to be implemented by floppy image plugins.
 //
 // --[ License ] --------------------------------------------------------------
 //
--- a/Interfaces/IWritableImage.cs
+++ b/Interfaces/IWritableImage.cs
@@ -9,7 +9,7 @@
 //
 // --[ Description ] ----------------------------------------------------------
 //
-//     Defines interface to be implemented by writable image plugins.
+//     Defines the interface to be implemented by writable image plugins.
 //
 // --[ License ] --------------------------------------------------------------
 //
--- a/Interfaces/IWritableOpticalImage.cs
+++ b/Interfaces/IWritableOpticalImage.cs
@@ -9,7 +9,7 @@
 //
 // --[ Description ] ----------------------------------------------------------
 //
-//     Defines interface to be implemented by writable image plugins.
+//     Defines the interface to be implemented by writable image plugins.
 //
 // --[ License ] --------------------------------------------------------------
 //
--- a/Interfaces/IWritableTapeImage.cs
+++ b/Interfaces/IWritableTapeImage.cs
@@ -9,7 +9,7 @@
 //
 // --[ Description ] ----------------------------------------------------------
 //
-//     Defines interface to be implemented by writable block addressable
+//     Defines the interface to be implemented by writable block addressable
 //     sequential tape image plugins.
 //
 // --[ License ] --------------------------------------------------------------
--- a/MediaTypeFromDevice.cs
+++ b/MediaTypeFromDevice.cs
@@ -2,14 +2,14 @@
 // Aaru Data Preservation Suite
 // ----------------------------------------------------------------------------
 //
-// Filename       : MediaTypeFromSCSI.cs
+// Filename       : MediaTypeFromDevice.cs
 // Author(s)      : Natalia Portillo <claunia@claunia.com>
 //
 // Component      : Aaru common types.
 //
 // --[ Description ] ----------------------------------------------------------
 //
-//     Lookups media type from SCSI informative values.
+//     Lookups media type from SCSI and ATA informative values.
 //
 // --[ License ] --------------------------------------------------------------
 //
--- a/Structs/Devices/ATA/Identify.cs
+++ b/Structs/Devices/ATA/Identify.cs
@@ -1,3 +1,41 @@
+// /***************************************************************************
+// Aaru Data Preservation Suite
+// ----------------------------------------------------------------------------
+//
+// Filename       : Identify.cs
+// Author(s)      : Natalia Portillo <claunia@claunia.com>
+//
+// Component      : Common structures for ATA devices.
+//
+// --[ Description ] ----------------------------------------------------------
+//
+//     Defines a high level interpretation of the ATA IDENTIFY response.
+//
+// --[ License ] --------------------------------------------------------------
+//
+//     Permission is hereby granted, free of charge, to any person obtaining a
+//     copy of this software and associated documentation files (the
+//     "Software"), to deal in the Software without restriction, including
+//     without limitation the rights to use, copy, modify, merge, publish,
+//     distribute, sublicense, and/or sell copies of the Software, and to
+//     permit persons to whom the Software is furnished to do so, subject to
+//     the following conditions:
+//
+//     The above copyright notice and this permission notice shall be included
+//     in all copies or substantial portions of the Software.
+//
+//     THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+//     OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+//     MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+//     IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+//     CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+//     TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+//     SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+//
+// ----------------------------------------------------------------------------
+// Copyright © 2011-2020 Natalia Portillo
+// ****************************************************************************/
+
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
--- a/Structs/Devices/SCSI/Enums.cs
+++ b/Structs/Devices/SCSI/Enums.cs
@@ -5,7 +5,7 @@
 // Filename       : Enums.cs
 // Author(s)      : Natalia Portillo <claunia@claunia.com>
 //
-// Component      : Device structures decoders.
+// Component      : Common structures for SCSI devices.
 //
 // --[ Description ] ----------------------------------------------------------
 //
--- a/Structs/Devices/SCSI/Inquiry.cs
+++ b/Structs/Devices/SCSI/Inquiry.cs
@@ -1,3 +1,41 @@
+// /***************************************************************************
+// Aaru Data Preservation Suite
+// ----------------------------------------------------------------------------
+//
+// Filename       : Inquiry.cs
+// Author(s)      : Natalia Portillo <claunia@claunia.com>
+//
+// Component      : Common structures for SCSI devices.
+//
+// --[ Description ] ----------------------------------------------------------
+//
+//     Defines a high level interpretation of the SCSI INQUIRY response.
+//
+// --[ License ] --------------------------------------------------------------
+//
+//     Permission is hereby granted, free of charge, to any person obtaining a
+//     copy of this software and associated documentation files (the
+//     "Software"), to deal in the Software without restriction, including
+//     without limitation the rights to use, copy, modify, merge, publish,
+//     distribute, sublicense, and/or sell copies of the Software, and to
+//     permit persons to whom the Software is furnished to do so, subject to
+//     the following conditions:
+//
+//     The above copyright notice and this permission notice shall be included
+//     in all copies or substantial portions of the Software.
+//
+//     THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+//     OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+//     MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+//     IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+//     CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+//     TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+//     SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+//
+// ----------------------------------------------------------------------------
+// Copyright © 2011-2020 Natalia Portillo
+// ****************************************************************************/
+
 using System;
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
--- a/Structs/Devices/SCSI/Modes/2A.cs
+++ b/Structs/Devices/SCSI/Modes/2A.cs
@@ -5,7 +5,7 @@
 // Filename       : 2A.cs
 // Author(s)      : Natalia Portillo <claunia@claunia.com>
 //
-// Component      : Device structures decoders.
+// Component      : Common structures for SCSI devices.
 //
 // --[ Description ] ----------------------------------------------------------
 //
--- a/Structs/Filesystems.cs
+++ b/Structs/Filesystems.cs
@@ -5,7 +5,7 @@
 // Filename       : Structs.cs
 // Author(s)      : Natalia Portillo <claunia@claunia.com>
 //
-// Component      : Aaru filesystem plugins.
+// Component      : Common structures.
 //
 // --[ Description ] ----------------------------------------------------------
 //
--- a/Structs/Images.cs
+++ b/Structs/Images.cs
@@ -5,11 +5,11 @@
 // Filename       : IMediaImage.cs
 // Author(s)      : Natalia Portillo <claunia@claunia.com>
 //
-// Component      : Disc image plugins.
+// Component      : Common structures.
 //
 // --[ Description ] ----------------------------------------------------------
 //
-//     Defines structures to be used by disc image plugins.
+//     Defines structures to be used by media image plugins.
 //
 // --[ License ] --------------------------------------------------------------
 //
--- a/Structs/TapeFile.cs
+++ b/Structs/TapeFile.cs
@@ -5,7 +5,7 @@
 // Filename       : TapeFile.cs
 // Author(s)      : Natalia Portillo <claunia@claunia.com>
 //
-// Component      : Disc image plugins.
+// Component      : Common structures.
 //
 // --[ Description ] ----------------------------------------------------------
 //
--- a/Structs/TapePartition.cs
+++ b/Structs/TapePartition.cs
@@ -5,7 +5,7 @@
 // Filename       : TapeFile.cs
 // Author(s)      : Natalia Portillo <claunia@claunia.com>
 //
-// Component      : Disc image plugins.
+// Component      : Common structures.
 //
 // --[ Description ] ----------------------------------------------------------
 //