Add README, LICENSE, update usage message.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Stephen Merrony
+
+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.

README.md

@@ -0,0 +1,39 @@
+# loada
+
+`loada` loads (restores) legacy Data General AOS/VS DUMP_II, and maybe DUMP_III, files on any modern system supported by Ada (gnat).
+
+It can be used to rescue data from legacy AOS/VS systems if the dumps are accessible on a modern system.  
+
+The current version handles at least versions 15 and 16 of the DUMP format.
+
+This software is a port of the LoadG utility from my https://github.com/SMerrony/aosvs-tools programs.
+As of March 2021 it is believed to be functionally equivalent to that program and shares the same SemVer.
+
+## Build
+
+Use the `gprbuild` command in the directory where you unpacked or cloned this software.
+
+## Usage
+```
+./loada
+Usage of loada:
+  -dumpfile <file>  DUMP_II or DUMP_III file to read/load (required)
+  -extract          extract the files from the DUMP_II/III into the current directory
+  -ignoreErrors     do not exit if a file or link cannot be created
+  -list             list the contents of the DUMP_II/III file
+  -summary          concise summary of the DUMP_II/III file contents (default true)
+  -verbose          be rather wordy about what loada is doing
+  -version          show the version number of loada and exit
+  ```
+
+To list the contents of a dump: `./loada -dumpfile ACK.DMP -summary`
+
+To extract the contents of a dump `./loada -dumpfile ACK.DMP -extract` 
+
+### Notes
+ * All files and directories will be created using upper-case names
+(the AOS/VS file system was case insensitive) 
+ * Subdirectories found in the dump are created as needed
+ * Link files will be created as symbolic links
+ * ACLs (file permissions) are ignored
+ * `loada` will not traverse above the current directory (this was legal in AOS/VS dumps) 

loada.adb

@@ -65,20 +65,13 @@ procedure Loada is
    procedure Print_Help is
    begin
       Ada.Text_IO.Put_Line ("Usage of loada:" );
-      Ada.Text_IO.Put_Line ("  -dumpfile string" );
-      Ada.Text_IO.Put_Line ("   DUMP_II or DUMP_III file to read/load (required)" );
-      Ada.Text_IO.Put_Line ("  -extract" );
-      Ada.Text_IO.Put_Line ("   extract the files from the DUMP_II/III into the current directory" );
-      Ada.Text_IO.Put_Line ("  -ignoreErrors" );
-      Ada.Text_IO.Put_Line ("   do not exit if a file or link cannot be created" );
-      Ada.Text_IO.Put_Line ("  -list" );
-      Ada.Text_IO.Put_Line ("   list the contents of the DUMP_II/III file" );
-      Ada.Text_IO.Put_Line ("  -summary" );
-      Ada.Text_IO.Put_Line ("   concise summary of the DUMP_II/III file contents (default true)" );
-      Ada.Text_IO.Put_Line ("  -verbose" );
-      Ada.Text_IO.Put_Line ("   be rather wordy about what loada is doing" );
-      Ada.Text_IO.Put_Line ("  -version" );
-      Ada.Text_IO.Put_Line ("   show the version number of loada and exit" );
+      Ada.Text_IO.Put_Line ("  -dumpfile <file>  DUMP_II or DUMP_III file to read/load (required)" );
+      Ada.Text_IO.Put_Line ("  -extract          extract the files from the DUMP_II/III into the current directory" );
+      Ada.Text_IO.Put_Line ("  -ignoreErrors     do not exit if a file or link cannot be created" );
+      Ada.Text_IO.Put_Line ("  -list             list the contents of the DUMP_II/III file" );
+      Ada.Text_IO.Put_Line ("  -summary          concise summary of the DUMP_II/III file contents (default true)" );
+      Ada.Text_IO.Put_Line ("  -verbose          be rather wordy about what loada is doing" );
+      Ada.Text_IO.Put_Line ("  -version          show the version number of loada and exit" );
 
       Set_Exit_Status (Failure);
    end Print_Help;