From 9861a3bec43934120d5500db193f0feb27a32e91 Mon Sep 17 00:00:00 2001
From: "G.raud" <graud@gmx.com>
Date: Sun, 7 Jul 2013 08:49:29 +0200
Subject: [PATCH] version/1.0

NEWS: document the major changes since the fork

README: link to NEWS

Makefile: build and distribute NEWS.html
---
 Makefile |  4 +++-
 NEWS     | 44 ++++++++++++++++++++++++++++++++++++++++++++
 README   |  3 +++
 3 files changed, 50 insertions(+), 1 deletion(-)
 create mode 100644 NEWS

diff --git a/Makefile b/Makefile
index be436e4..a5d5984 100644
--- a/Makefile
+++ b/Makefile
@@ -71,7 +71,7 @@ QMAKE_MAKEFILE = Makefile.qmake
 MANDOC = ng-jackspa.1
 MANLINKS = njackspa.1 gjackspa.1 qjackspa.1 jackspa-cli.1
 MANTARGET = ng-jackspa.1
-HTMLDOC = README.html INSTALL.html ng-jackspa.1.html
+HTMLDOC = README.html INSTALL.html NEWS.html ng-jackspa.1.html
 RELEASEDOC = $(MANDOC) $(HTMLDOC)
 
 TARNAME	= $(PACKAGE_TARNAME)-$(RPM_VERSION)
@@ -187,6 +187,8 @@ README.html : README BUGS asciidoc.conf
 INSTALL.html : INSTALL asciidoc.conf
 README.html INSTALL.html :
 	$(ASCIIDOC) $(ASCIIDOC_FLAGS) -b xhtml11 -d article -a readme $<
+NEWS.html : NEWS asciidoc.conf
+	$(ASCIIDOC) $(ASCIIDOC_FLAGS) -b xhtml11 -d article $<
 %.html : %.txt asciidoc.conf
 	$(ASCIIDOC) $(ASCIIDOC_FLAGS) -b xhtml11 -d manpage $<
 %.xml : %.txt asciidoc.conf
diff --git a/NEWS b/NEWS
new file mode 100644
index 0000000..0cffa95
--- /dev/null
+++ b/NEWS
@@ -0,0 +1,44 @@
+Release Notes for ng-jackspa version/1.0
+----------------------------------------
+
+This is the first release of ng-jackspa, a forked continuation of
+link:http://code.google.com/p/jackspa/[jackspa].
+
+Updates since the original jackspa
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* New
+
+  - New interfaces were added: ncurses, Qt and command line.
+  - The interfaces are more elaborate, allowing one to easily switch between
+    two sets of control values and to reset the controls to their default
+    values, which is convenient for testing LADSPA plugins.
+  - A UNIX manual page ng-jackspa(1) was added.
+  - The LADSPA plugin can be specified by its label in addition to its UID.
+  - Several command line switches are now implemented, notably to set the
+    initial values or to override the default values given by the plugin.
+  - Automatically start a JACK server (if it is not already running).
+  - Several jackspa instances of the same plugin can be run simultaneously by
+    letting JACK generate a new client name if the default one is already used.
+  - The control inputs/outputs can be exported as control voltages on JACK
+    audio ports and connected to each other using standard JACK connection
+    managers; JACK peak meters can be used to visualize the control port
+    values.  (In jackspa only the control outputs were exported to JACK.)
+
+* New documentation files: README, BUGS, INSTALL, NEWS.
+
+
+Fixes since the original jackspa
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+jackspa was found to be fully functional, although a lot of code cleanup and
+many fixes could be made.  For a complete list of fixes see the VCS' history.
+
+* Most notable fixes
+
+  - Do not export output control ports as JACK audio ports by default.
+  - Accept a client name modified by JACK (if the one provided is already in
+    use).
+  - Search the `$LADSPA_PATH` for plugin libraries.
+  - The graphical interfaces have scrollbars if the window size becomes too
+    small.
diff --git a/README b/README
index 85af5df..701288f 100644
--- a/README
+++ b/README
@@ -31,6 +31,9 @@ Resources
 * The link:https://gna.org/projects/ngjackspa[official homepage] is at Gna!.
   There you might find up-to-date information and releases.
 
+* Release notes listing important user-visible changes are available in a
+  separate file link:NEWS.html['NEWS'].
+
 
 Installation instructions
 -------------------------
-- 
2.11.4.GIT