Updated docs about existence of xorriso API in libisoburn

libisoburn/trunk/README

@@ -18,7 +18,9 @@ The price for that is thorough specialization on data files in ISO-9660
 filesystem images. So libisoburn is not suitable for audio (CD-DA) or any
 other CD layout which does not entirely consist of ISO-9660 sessions.
 
-xorriso is a command line application of libisoburn, libisofs, and libburn.
+xorriso is an application of libisoburn, libisofs, and libburn, which reads
+commands from program arguments, files, stdin, or readline.
+Its features are also available via a C language API of libisoburn.
 
 Currently they are fully supported on Linux with kernels >= 2.4,
 on FreeBSD with ATAPI/CAM support enabled in the kernel, see atapicam(4),
@@ -33,7 +35,7 @@ By using this software you agree to the disclaimer at the end of this text:
                    Compilation, First Glimpse, Installation
 
 Dynamic library and compile time header requirements for libisoburn-0.5.6 :
-- libburn.so.4  , version libburn-0.7.8 or higher
+- libburn.so.4  , version libburn-0.8.2 or higher
 - libisofs.so.6 , version libisofs-0.6.32 or higher
 libisoburn and xorriso will not start with libraries which are older than their
 headers seen at compile time.
@@ -101,12 +103,34 @@ if 64 KB rather than 32 KB are transmitted in each write operation.
     --enable-dvd-obs-64k
 
 
+                      xorriso C language API
+
+Actually the dynamically linked xorriso binary is only a small start program
+for the xorriso API that is implemented inside libisoburn.
+There are API calls for command readers and interpreters, and there are
+API calls for each single command of xorriso.
+
+Interested programmers should have a look into the API definition at
+  xorriso/xorriso.h
+and the start program
+  xorriso/xorriso_main.c
+
+The header file  xorriso.h  gets installed suitable for
+  #include <libisoburn/xorriso.h>
+
+So after installation of a binary libisoburn package you may find it e.g. as
+  /usr/local/include/libisoburn/xorriso.h
+
+
+
                        Drives and Disk File Objects 
 
 The user of libisoburn applications needs rw-permission for the CD/DVD/BD
 drives which shall be used, even if only reading is intended.
 A list of rw-accessible drives can be obtained by
     xorriso -devices
+resp. by xorriso API call
+    Xorriso_option_devices()
 resp. by libburn API call
     burn_drive_scan()