From dc05696fd40e2b1e391c129715652c5d92d0872e Mon Sep 17 00:00:00 2001
From: gusthoff <gusthoff@gusthoff.net>
Date: Sun, 28 Feb 2016 20:56:05 +0100
Subject: [PATCH] Added description of version 1.0.0

---
 CHANGELOG.md |  9 ++++++
 README.md    | 86 +++++++++++++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 94 insertions(+), 1 deletion(-)
 create mode 100644 CHANGELOG.md

diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..fc37a92
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,9 @@
+# CHANGELOG
+
+This is the changelog of the Wavefiles Package, a Wavefile Reader & Writer
+Package implemented in Ada 2012.
+
+## 1.0.0 --- 2016-02-28
+
+* Initial release.
+
diff --git a/README.md b/README.md
index 459a090..51a9a08 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,85 @@
-# wavefiles
+Wavefiles: Ada Wavefile Reader & Writer Package
+===============================================
+Version 1.0.0
+
+1. Introduction
+---------------
+
+This Package contains a Wavefile Reader & Writer written in Ada 2012.
+
+2. License & Copyright
+----------------------
+
+This Package is available "as is" under MIT License. Unless stated otherwise,
+the copyright is held by Gustavo A. Hoffmann.
+
+2. Supported Platforms
+----------------------
+
+This Package has been tested on the following compilers / platforms:
+
+- GNAT GPL 2015 for Linux
+
+The Package is expected to work on Windows and Mac platforms.
+
+3. Features
+-----------
+
+### Wavefile Features
+
+Reading and writing of wavefiles supporting following features:
+
+- Stereo and multichannel audio
+- Audio samples with following bit depths:
+    - 16-bit PCM
+    - 24-bit PCM
+    - 32-bit PCM
+- Wave-Format-Extensible (WAVEFORMATEXTENSIBLE)
+- Conversion between PCM buffer data type and wavefile data type.
+     - Adaptations for different precisions are performed automatically.
+
+### PCM Buffer Features
+
+- Built-in handling of PCM buffers
+    - The Wavefiles Package is a generic package that can be instantiated for
+      different formats of PCM buffers.
+    - When instantiating the generic package, the user must specify:
+        - The maximum number of samples that the buffer can contain
+        - The numerical data type for storing the PCM samples
+    - The numerical data type of the PCM samples can be:
+        - A floating-point type of arbitrary precision
+        - A fixed-point type of arbitrary precision
+    - When declaring an instance of the PCM buffer, the user must specify:
+        - The number of channels
+
+- Support for operations on PCM buffers:
+    - "=", "*", "+", "-"
+    - Custom operations (using function Wavefiles.PCM_Buffers.Perform)
+
+4. Known Issues and Limitations
+-------------------------------
+
+### Wavefile Features
+
+Following features are not currently supported:
+
+- Reading and writing of 8-bit PCM wavefiles
+- Reading and writing of wavefiles in floating-point format
+
+### PCM Buffer Features
+
+- Data type conversion to be investigated and improved.
+    - Conversion of small negative values might be improved.
+
+### Documentation
+
+- Extensive documentation and tutorials are missing.
+    - Please refer to the test folder for an example on how to use the Package.
+
+### Testing
+
+- Unit test for the Package is missing.
+    - Just a test module for manual checks is currently available.
+
+- Testing of wavefiles in various formats is missing.
+- Testing of erroneous wavefiles is missing.