Update docs for the new v4l-utils as a separate project situation

Signed-off-by: Hans de Goede <hdegoede@redhat.com>

COPYING

 
-   NOTE! This copyright does *not* cover user programs that use kernel
- services by normal system calls - this is merely considered normal use
- of the kernel, and does *not* fall under the heading of "derived work".
- Also note that the GPL below is copyrighted by the Free Software
- Foundation, but the instance of code that it refers to (the Linux
- kernel) is copyrighted by me and others who actually wrote it.
-
- Also note that the only valid version of the GPL as far as the kernel
- is concerned is _this_ particular version of the license (ie v2, not
- v2.2 or v3.x or whatever), unless explicitly otherwise stated.
-
-			Linus Torvalds
-
-----------------------------------------
-
 		    GNU GENERAL PUBLIC LICENSE
 		       Version 2, June 1991
 

ChangeLog

+v4l-utils-0.7.90
+----------------
+* This is the first release of v4l-utils, v4l-utils is the combination
+  of various v4l and dvb utilities which used to be part of v4l-dvb
+  mercurial kernel tree and libv4l.
+* This first version is 0.7.90, as the version numbers continue were libv4l
+  as a standalone source archive stops.
+
+Note all history below this line only applies to libv4l and not to the utils
+----------------------------------------------------------------------------
+
 libv4l-0.6.5
 ------------
 * Add more laptop models to the upside down devices table

INSTALL

+Requirements:
+-------------
+* make and a c and c++ compiler
+* optionally qt3 ot qt4 for building qv4l2
+* optionally libsysfs for building v4l2-sysfs-path
+
+
 Building:
+---------
+
+Before building decide under which PREFIX you wish to install
+(the default is /usr/local), and if you want the libraries to be installed
+under a different directory then $PREFIX/lib for example $PREFIX/lib64.
+
+To build execute "make" specifying the desired installation prefix
+and (optionally) the desired libdir, for example:
+make PREFIX=/usr LIBDIR=/usr/lib64
 
-simply type
-$ make
 
 Installing:
+-----------
 
-$ make install
-installs libraries and utils to /usr/[bin,include,lib]
+To install do "make install", and again specify the desired PREFIX and
+LIBDIR, note that it is important to specify the same PREFIX and LIBDIR
+as used when building, for example:
+make install PREFIX=/usr LIBDIR=/usr/lib64
 
-$ make install prefix=<path>
-installs libraries and utils to <path>/[bin,include,lib]
+Note that v4l-utils' "make install" supports DESTDIR for installing into
+a build root for example:
+make install PREFIX=/usr LIBDIR=/usr/lib64 DESTDIR=/mnt/sysimage

KNOWN_ISSUES

-There are some known issues when compiling the V4L2 Applications.
-
-	- It doesn't check/warn if you don't have all the dependencies:
-	  qv4l2 requires qt3 development packages;
-	  v4l2-sysfs-path requires libsysfs development packages;
-
-	- qv4l2 doesn't compile with qt4 libraries;
-
-	- make only works fine if called first from /v4l2-apps, since
-	  several subdirs require that /v4l2-apps/include to be created,
-	  and only the main Makefile forces its creation before building
-	  the other files;
-
-	- libv4l doesn't use the in-tree videodev2.h. So, in order to
-	  compile, it needs to be installed at /usr/include/linux.
-
-Patches are welcome to improve the building system.

README

-linuxtv-v4l2-apps-0.0.1
-=======================
+v4l-utils
+---------
 
-Linux V4L2 API test/demo applications, utilities and library.
+Linux V4L2 and DVB API utilities and v4l libraries (libv4l).
 
-You find a README in each subdirectory explaining what the code there does.
 
-The v4l2 library uses the GNU Lesser General Public License, all other code is
+v4l libraries (libv4l)
+----------------------
+
+See README.lib for more information on libv4l, libv4l is released
+under the GNU Lesser General Public License.
+
+
+v4l-utils
+---------
+The (for now for v4l-utils private use only) libv4l2util library is
+released under the GNU Lesser General Public License, all other code is
 released under the GNU General Public License.
 
-This code is still in its infancy and is not yet suitable for general
-use. However, it is a start.
+v4l-utils includes the following utilities:
+
+decode_tm6000:
+Decodes tm6000 proprietary format streams.
+Installed by make install under <prefix>/bin.
+
+v4l-keytable:
+Dump, Load or Modify ir receiver input tables.
+The ir tables for remotes which are known by the kernel
+(and loaded by default depending on dvb card type) can be found
+under utils/keytable/keycodes.
+v4l-keytable does not get installed by make install.
+
+qv4l2:
+QT v4l2 control panel application.
+Installed by make install under <prefix>/bin.
+
+rds-saa6588:
+Poll i2c RDS receiver [Philips saa6588].
+rds-saa6588 does not get installed by make install.
+
+v4l2-compliance:
+Tool to test v4l2 API compliance of drivers.
+Installed by make install under <prefix>/bin.
+
+v4l2-ctl:
+Tool to control v4l2 controls from the cmdline.
+Installed by make install under <prefix>/bin.
+
+v4l2-dbg:
+Tool to directly get and set registers of v4l2 devices,
+this requires a kernel >= 2.6.29 with the ADV_DEBUG option
+enabled. This tool can only be used by root and is meant
+for development purposes only!
+Installed by make install under <prefix>/sbin.
+
+v4l2-sysfs-path:
+FIXME add description.
+Installed by make install under <prefix>/bin.
 
-Hans Verkuil <hverkuil@xs4all.nl>
+xc3028-firmware:
+Xceive XC2028/3028 tuner module firmware manipulation tool.
+xc3028-firmware does not get installed by make install.

TODO

+libv4l todo:
+------------
+
 -add support for setting / getting the number of read buffers
 
 -add code to v4l2_read to not return frames more then say 5 seconds old
@@ -13,3 +16,7 @@
  frames
 
 -get standardized CID for AUTOGAIN_TARGET upstream and switch to that
+
+
+utils todo:
+-----------