dvda-author  version 009.05 (May 2009)
===========================


1. DESCRIPTION
--------------


dvda-author creates high-definition DVD-Audio disc structures from either WAV, 
FLAC/Ogg FLAC, or SoX-14.1-supported audio formats (.au, .aiff, .gsm, etc.)

This version supports multichannel audio up to 5.1.

Switch -x enables extraction of audio content from DVD-Audio structures into .wav files.

It can also create "hybrid" or "universal" DVD-Audio/Video disc structures, 
which contain both DVD-Audio and DVD-Video zones. 

A new navigation feature makes it possible to start playing a video
title from within audio zone or an audio title from within video zone.

fixwav is a companion tool installed with dvda-author as an autonomous executable.
See man page, html page or website for details.


2. WEBSITE
-----------

The latest version of the software is available at the following internet 
address:

  http://dvd-audio.sourceforge.net/


3. BUILD ENVIRONMENT
--------------------

A GNU-style make system is shipped with this package.
Successful builds were obtained on the following platforms:

  - Cygwin/Windows XP
  - FreeBSD 7.0
  - Linux 2.6.24 (Ubuntu 8.04)
  - MSYS 1-11

Details on building issues are given in INSTALL.


4. FILES
--------

Source code directories are:

  src
      Source code for dvda-author:
	amg2.c                 creates AUDIO_TS.IFO
	ats.c                  creates AOB files
	atsi2.c                creates ATS_XX.0.IFO files 
	audio.c                core audio processing
	auxiliary.c            help and auxiliary functions
        command_line_parsing.c command-line parser
        dvda-author2.c         launches configuration file then command-line parsing
	file_input_parsing.c   parses audio input directories or disc (when extracting)
	include                header files
        launch_manager.c       sequentially launches sub-processes
        lexer.c                simple lexer for configuration files
	samg2.c                creates AUDIO_PP.IFO
	videoimport.c          imports VIDEO_TS directory and computes video links.

  libFLAC
      Source code for the FLAC 1.2.3 static library

  libFLAC/include/libogg
      Source code for the libogg 1.1.3 static library

  libutils
      Source code for the libc_utils static library

  libats2wav
      Source code for ats2wav, a DVD-Audio titleset extracter that converts .AOB
      files into .wav audio files.

  libsoxconvert
      Source code for launching SoX and SoX code in subdirectories

  fixwav
      Source code for a special library that checks and fixes .wav file headers

  images
      NSIS compiler images for Windows installers.

  glibc
      GNU libc code for function replacement (alternative to -liberty).

Important DATA-type files are:

  dvda-author.1
      Man(1) page
  dvda-author.html
      HTML version of the man page
  dvda-author.desktop
      KDE/gnome desktop configuration file
  dvda-author.conf
      configuration file (default command-line options)
  dvda-author.png or .ico
      images for desktop.
  dvda-author.nsi
      NSIS script for generating Windows installer.   




  
5. INSTALLATION 
---------------

See file INSTALL included in this distribution.
On *nix platforms, the GNU build system will automatically link to existing libFLAC
libraries, checking for the appropriate version (1.2.1 and later).
If your installed library is not compatible, or on Windows platforms, libFLAC will be
rebuilt from source code in directory libFLAC/

If you do not use the GNU build system, check that the configuration file dvda-author.conf
is in the same directory as the main executable (see INSTALL for other options).
By default, binaries will install under /usr/bin.

This version will use either libiberty.a if already installed on your platform
or source code for a few GNU libc functions located in glibc/ The list of functions
used depends on platforms.


6. CREDITS
----------

Thanks to:

  Bahman Negahban for useful hints on FLAC 1.2.1 integration
  Tomasz Belinea  for testing version 08.07.
  Lee Feldkamp for testing Windows executables.
  Lee and Tim Feldkamp for authoring multichannel support.

and all other authors (see file AUTHORS for details).

7. NEWS
-------

See file NEWS

8. MAILING LIST
---------------

  dvd-audio-devel@lists.sourceforge.net


