Modified main API docs page

This commit is contained in:
Mario Danic 2006-09-02 09:50:22 +00:00
parent c775ab390e
commit e685c72399
2 changed files with 34 additions and 4 deletions

View File

@ -114,7 +114,37 @@ To make the libraries accessible for running resp. developing applications
<li> Destroy the library instance. (If you're done working with the library.)
</ol>
Here's a minimal demo application for the libburn library
@section libburner Libburner
libburner is a minimal demo application for the library libburn as provided
on http://libburn.pykix.org . It can list the available devices, can
blank a CD-RW and can burn to CD-R or CD-RW.
It's main purpose, nevertheless, is to show you how to use libburn and also
to serve the libburn team as reference application. libburner.c does indeed
define the standard way how above three gestures can be implemented and
stay upward compatible for a good while.
@subsection libburner-help Libburner --help
Usage: test/libburner
[--drive <address>|<driveno>|"-"]
[--verbose <level>] [--blank_fast|--blank_full]
[--burn_for_real|--try_to_simulate] [--stdin_size <bytes>]
[<imagefile>|"-"]
Examples
A bus scan (needs rw-permissions to see a drive):
test/libburner --drive -
Burn a file to drive chosen by number:
test/libburner --drive 0 --burn_for_real my_image_file
Burn a file to drive chosen by persistent address:
test/libburner --drive /dev/hdc --burn_for_real my_image_file
Blank a used CD-RW (is combinable with burning in one run):
test/libburner --drive 0 --blank_fast
Burn a compressed afio archive on-the-fly, pad up to 700 MB:
( cd my_directory ; find . -print | afio -oZ - ) | \
test/libburner --drive /dev/hdc --burn_for_real --stdin_size 734003200 -
To be read from *not mounted* CD via:
afio -tvZ /dev/hdc
Program tar would need a clean EOF which our padded CD cannot deliver.
@include libburner.c
*/

View File

@ -56,8 +56,8 @@ WARN_LOGFILE =
#---------------------------------------------------------------------------
# configuration options related to the input files
#---------------------------------------------------------------------------
INPUT = libburn libisofs doc
FILE_PATTERNS = libburn.h libisofs.h comments
INPUT = libburn libisofs doc test
FILE_PATTERNS = libburn.h libisofs.h comments libburner.c
RECURSIVE = NO
EXCLUDE =
EXCLUDE_SYMLINKS = NO