commit e0fd932a377af001d16c62e7a86694d358c800d7 Author: Thomas Schmitt Date: Tue Jul 7 13:04:19 2020 +0000 diff --git a/Home.md b/Home.md new file mode 100644 index 0000000..dc4bc1b --- /dev/null +++ b/Home.md @@ -0,0 +1,145 @@ +# Welcome to libburnia project + +### NEWS + +* **Mon Nov 25 2019** Bug fix release 1.5.2.pl01 of +[libburn](http://files.libburnia-project.org/releases/libburn-1.5.2.pl01.tar.gz) +is ready on [release page](Releases). cdrskin did not properly burn multiple +tracks. Track 1 was slow and burning stalled before track 2. Regression +introduced by 1.5.0. + +* **Sat Oct 27 2019** Release 1.5.2 is ready on [release page](Releases). +The libraries are now ready for building out-of-source. +[libisofs](http://files.libburnia-project.org/releases/libisofs-1.5.2.tar.gz) +got minor API extensions. +[libburn](http://files.libburnia-project.org/releases/libburn-1.5.2.pl01.tar.gz) +got a bug fixed which spoiled burn runs on some MATSHITA laptop drives. It +is now able to list all features which the drive announces. +[xorriso and libisoburn](http://files.libburnia-project.org/releases/libisoburn-1.5.2.tar.gz) +xorriso can now set GPT type GUIDs with appended partitions and the ISO +partition. +All three libraries got some rarely triggered bugs fixed. + +* **Thu Aug 1 2019** we celebrate 13 years of libburnia project. + +* **Fri Oct 28 2016** We moved from `Trac/svn/bzr` to `GitLab/git`. + +* **Sun Mar 20 2016** The wiki article +[about problems with concurrent burns](Concurrentlinuxsr) +describes two workarounds for the poor throughput which can be observed +on Linux if libburn operates more than one drive at a time. + + +### ABOUT + +libburnia is a project for [reading](Reading), [mastering](Mastering) +and [writing](Writing) optical discs. Currently it is +comprised of libraries named [libisofs](Libisofs), [libburn](Libburn), +[libisoburn](Libisoburn), a cdrecord emulator named [cdrskin](Cdrskin), +and an integrated multi-session tool named [xorriso](Xorriso). +The software runs on GNU/Linux, FreeBSD, Solaris, NetBSD, OpenBSD. +It is base of the +[GNU xorriso](http://www.gnu.org/software/xorriso/xorriso_eng.html) package. + + +### LICENCE + +The source code for the libburnia project is distributed under the terms +of the +[GNU General Public License version 2 or later (GPLv2+)](https://www.gnu.org/licenses/gpl-2.0.html). + +Be aware that linking libisoburn with GPLv3+ library `libreadline-6` +will automatically change the license of the resulting `libisoburn.so` +and `xorriso` binary to GPLv3+. + + +### SOURCE CODE + +The current release tarballs are available at [Releases Page](Releases). + +The project lives in a [git](https://git-scm.com/) repository hosted on +[https://dev.lovelyhq.com/libburnia](https://dev.lovelyhq.com/groups/libburnia). +You can check-out the latest unstable versions using: + +``` +git clone https://dev.lovelyhq.com/libburnia/libburn.git +git clone https://dev.lovelyhq.com/libburnia/libisofs.git +git clone https://dev.lovelyhq.com/libburnia/libisoburn.git +``` +### [Browse git online](https://dev.lovelyhq.com/groups/libburnia). + +For building the libraries and binaries from git you will need `autotools` +of at least version 1.7. + + +### DOCUMENTATION + +Wiki page with [Frequently Asked Questions](Faq). + +**Current development version:** + +Manual pages of command line programs: +* [man 1 cdrskin](http://scdbackup.sourceforge.net/man_1_cdrskin_devel.html) +* [man 1 xorriso](http://www.gnu.org/software/xorriso/man_1_xorriso_devel.html) +* [man 1 xorrisofs](http://www.gnu.org/software/xorriso/man_1_xorrisofs_devel.html) +* [man 1 xorrecord](http://www.gnu.org/software/xorriso/man_1_xorrecord_devel.html) + +The APIs of the libraries are documented in their C header files: +* [libburn/libburn.h](https://dev.lovelyhq.com/libburnia/libburn/raw/HEAD/libburn/libburn.h) +* [libisofs/libisofs.h](https://dev.lovelyhq.com/libburnia/libisofs/raw/HEAD/libisofs/libisofs.h) +* [libisoburn/libisoburn.h](https://dev.lovelyhq.com/libburnia/libisoburn/raw/HEAD/libisoburn/libisoburn.h) +* [libisoburn/xorriso.h](https://dev.lovelyhq.com/libburnia/libisoburn/raw/HEAD/xorriso/xorriso.h) + +Example programs: +* [libburn/test/libburner](https://dev.lovelyhq.com/libburnia/libburn/raw/HEAD/test/libburner.c) +demonstrates fundamental API gestures for burning, blanking and formatting +optical media. +* [libburn/test/telltoc](https://dev.lovelyhq.com/libburnia/libburn/raw/HEAD/test/telltoc.c) +demonstrates fundamental API gestures for inquiring the state of optical media. +* [libisofs/demo/demo](https://dev.lovelyhq.com/libburnia/libisofs/raw/HEAD/demo/demo.c) +demonstrates fundamental API gestures of libisofs. +* [libisoburn/frontend/frontend_pipes_xorriso](https://dev.lovelyhq.com/libburnia/libisoburn/raw/HEAD/frontend/frontend_pipes_xorriso.c) +demonstrates `xorriso` as dialog slave under control of a C program. +* [libisoburn/frontend/sh_on_named_pipes.sh](https://dev.lovelyhq.com/libburnia/libisoburn/raw/HEAD/frontend/sh_on_named_pipes.sh) +demonstrates `xorriso` as dialog slave under control of a bash script. +* [libisoburn/frontend/xorriso-tcltk](https://dev.lovelyhq.com/libburnia/libisoburn/raw/HEAD/frontend/xorriso-tcltk) +demonstrates `xorriso` as dialog slave under GUI control of a Tcl/Tk script. +See also [mini introduction](https://dev.lovelyhq.com/libburnia/libisoburn/blob/master/frontend/README-tcltk). + +`README` files: +* [libburn](https://dev.lovelyhq.com/libburnia/libburn/raw/HEAD/README) +* [libisofs](https://dev.lovelyhq.com/libburnia/libisofs/raw/HEAD/README) +* [libisoburn](https://dev.lovelyhq.com/libburnia/libisoburn/raw/HEAD/README) +* [GNU xorriso](https://dev.lovelyhq.com/libburnia/libisoburn/raw/HEAD/xorriso/README_gnu_xorriso) + +### CONTRIBUTION + +We welcome and consider any sorts of contribution although not all can +be accepted, of course. If you want to contribute to libburnia project +development, then report experiences, propose new features, or post patches +for discussion on +[bug-xorriso at gnu dot org](https://lists.gnu.org/mailman/listinfo/bug-xorriso). + + +### MAILING LISTS + +Please send support requests and proposals to + +[bug-xorriso at gnu dot org](https://lists.gnu.org/mailman/listinfo/bug-xorriso) - Public mailing list of GNU xorriso. + + +### DONATIONS + +Any donations made to the libburnia project would greatly assist +its progress by helping us to acquire drives and media. If you would +like to donate, please mail us: +* mario.danic [at] gmail [dot] com, Cc: scdbackup [at] gmx [dot] net. + + +### DEVELOPERS + +Thomas Schmitt - scdbackup [at] gmx [dot] net - Current main developer + + +Mario Đanić - mario [at] libburnia-project [dot] org - Founder, webmaster, developer +