From 9eaf85691e6e2cda25ce9c2946bef31576c417c6 Mon Sep 17 00:00:00 2001 From: Mario Danic Date: Tue, 31 Jul 2007 07:40:59 +0000 Subject: [PATCH] Transfered more up-to-date readme from libburn tree --- README | 53 +++++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 39 insertions(+), 14 deletions(-) diff --git a/README b/README index f23bbf4..55c4a28 100644 --- a/README +++ b/README @@ -6,7 +6,7 @@ This all is under GPL. ------------------------------------------------------------------------------ libburnia.pykix.org By Mario Danic and Thomas Schmitt -Copyright (C) 2006 Mario Danic, Thomas Schmitt +Copyright (C) 2006-2007 Mario Danic, Thomas Schmitt Still containing parts of Libburn. By Derek Foreman and @@ -19,7 +19,7 @@ commitment as written at the end of this text. The rights and merits of the Libburn-copyright holders Derek Foreman and Ben Jansens will be duely respected. -This libburnia.pykix.org toplevel README (C) 2006 Thomas Schmitt +This libburnia.pykix.org toplevel README (C) 2006-2007 Thomas Schmitt ------------------------------------------------------------------------------ Build and Installation @@ -54,7 +54,8 @@ See README file there. Overview of libburnia.pykix.org libburnia.pykix.org is an open-source software project for reading, mastering -and writing optical discs. For now this means only CD-R and CD-RW. +and writing optical discs. +For now this means only CD media and all single layer DVD media except DVD+R. The project comprises of several more or less interdependent parts which together strive to be a usable foundation for application development. @@ -66,10 +67,10 @@ we would need : login on a development machine resp. a live OS on CD or DVD, advise from a system person about the equivalent of Linux sg or FreeBSD CAM, volunteers for testing of realistic use cases. -We do have a workable code base for burning data CDs, though. The burn API is -quite comprehensively documented and can be used to build a presentable -application. -We do have a functional binary which emulates parts of cdrecord in order to +We have a workable code base for burning CD and most single layer DVD. +The burn API is quite comprehensively documented and can be used to build a +presentable application. +We have a functional binary which emulates parts of cdrecord in order to prove that usability, and in order to allow you to explore libburnia's scope by help of existing cdrecord frontends. @@ -78,20 +79,25 @@ The project components (list subject to growth, hopefully): - libburn is the library by which preformatted data get onto optical media. It uses either /dev/sgN (e.g. on kernel 2.4 with ide-scsi) or /dev/hdX (e.g. on kernel 2.6). - libburn is the foundation of our cdrecord emulation. + libburn is the foundation of our cdrecord emulation. Its code is + independent of cdrecord. Its DVD capabilities are learned from + studying the code of dvd+rw-tools and MMC-5 specs. No code but only + the pure SCSI knowledge has been taken from dvd+rw-tools, though. - libisofs is the library to pack up hard disk files and directories into a - ISO 9660 disk image. This may then be brought to CD via libburn. + ISO 9660 disk image. This may then be brought to media via libburn. libisofs is to be the foundation of our upcoming mkisofs emulation. - cdrskin is a limited cdrecord compatibility wrapper for libburn. Cdrecord is a powerful GPL'ed burn program included in Joerg Schilling's cdrtools. cdrskin strives to be a second source for - the services traditionally provided by cdrecord. + the services traditionally provided by cdrecord. Additionally it + provides libburn's DVD capabilities, where only -sao is compatible + with cdrecord. cdrskin does not contain any bytes copied from cdrecord's sources. Many bytes have been copied from the message output of cdrecord runs, though. - See cdrskin/README for more. + See cdrskin/README and man cdrskin/cdrskin.1 for more. - test is a collection of application gestures and examples given by the authors of the library features. The main API example for libburn @@ -121,7 +127,7 @@ Project history as far as known to me: It has meanwhile moved to use vanilla libburn.pykix.org , though. Version 0.1.4 constitutes the first release of this kind. -- In Juli 2006 our team mate Mario Danic announced a revival of libburn +- In July 2006 our team mate Mario Danic announced a revival of libburn which by about nearly everybody else was perceived as unfriendly fork. Derek Foreman four days later posted a message which expressed his discontent. @@ -178,13 +184,32 @@ Project history as far as known to me: libburn, is now called libburnia. For the origin of this name, see http://en.wikipedia.org/wiki/Liburnians . +- 16th January 2007 release of libburn-0.3.0 and cdrskin-0.3.0 . Now the scope + is widened to a first class of DVD media: overwriteable single layer types + DVD-RAM, DVD+RW, DVD-RW. This is not a cdrecord emulation but rather inspired + by dvd+rw-tools' "poor man" writing facility for this class of media. + Taking a bow towards Andy Polyakov. + +- 11th February 2007 version 0.3.2 covers sequential DVD-RW and DVD-R with + multi-session and with DAO. + +- 12th March 2007 version 0.3.4 supports DVD+R and thus covers all single layer + DVD media. Code for double layer DVD+/-R is implemented but awaits a tester + yet. + +- 23th April 2007 version 0.3.6 follows the unanimous opinion of Linux kernel + people that one should not use /dev/sg on kernel 2.6. + +- 31st July 2007 version 0.3.8 marks the first anniversary of libburn revival. + We look back on improved stability, a substantially extended list of media + and write modes, and better protection against typical user mishaps. + ------------------------------------------------------------------------------ This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by - the Free Software Foundation; either version 2 of the License, or - (at your option) any later version. + the Free Software Foundation. To be exact: version 2 of that License. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of