This is a port of Ogg Vorbis Library 1.3.7 to MSDOS/DJGPP.


Ogg Vorbis is a fully open, non-proprietary, patent-and-royalty-free, general-purpose compressed audio format for mid to high quality (8kHz-48.0kHz, 16+ bit, polyphonic) audio and music at fixed and variable bitrates from 16 to 128 kbps/channel. This places Vorbis in the same competitive class as audio representations such as MPEG-4 (AAC), and similar to, but higher performance than MPEG-1/2 audio layer 3, MPEG-4 audio (TwinVQ), WMA and PAC.
The code is publish under a BSD-style license.



DJGPP specific changes.
=======================

- To build and use this port the latest DJGPP port of libogg:
http://ftp.delorie.com/pub/djgpp/current/v2tk/logg135b.zip
must be installed.

- The reading/writing stream is switched into O_BINARY mode. If the
stream is connected to stdin/stdout/TTY, then Ctrl-C and Ctrl-Break
are re-enabled so the user can interrupt the program.

- Apart from those changes there are no other user visible ones. Only
some small changes have been done to get the library configured and
compiled.

- No one of the tests from the test suite shall fail.

- Because the name of the three libraries: libvorbisfile, libvorbisenc
and libvorbis map all to the same SFN, the original LFNs have been
renamed to SFNs like this:
libvorbis -> libvorbis
libvorbisenc -> libvbsenc
libvorbisfile -> libvbsfile
To avoid any inconveniences, a new version of libnames.tab with that
mapping has been included in this port. It is stored in the "djgpp"
directory and needs to be moved into the "lib" directory of the DJGPP
installation. With this new version of libnames.tab the linker will
know how to map the expected LFN to the corresponding SFN.

- To configure and compile this port at least the following version of
Bash, Make and pkg-config are required:
http://ftp.delorie.com/pub/djgpp/current/v2gnu/bsh4253b.zip
http://ftp.delorie.com/pub/djgpp/current/v2gnu/mak43br2.zip
http://ftp.delorie.com/pub/djgpp/current/v2tk/pkc023b.zip
No previous versions will work nor are supported. Any future version
should work.

- The port has been configured and compiled on WinXP SP3, Win98SE and
MSDOS 6.22 with DOSLFN v0.41f. There is no guarantee that this may
be possible with any other DOS-like OS. Due to the use of long file
names it will not be possible to configure and compile without LFN
support. The port has been compiled using gcc346 and bnu2351b.

As usual, all djgpp specific files (diffs, README files, etc.) are stored
in the "djgpp" directory. The sources have been configured to be build
in the "0build" directory. If for some reason it does not work for you,
delete its contents and configure from scratch again.

Please read the docs to become familiar with this product.


Here is an extract of the CHANGES file showing the user visible changes
from the last port (Ogg Vorbis Library 0.0.0) to this one:

-------------------------------------------------------------------------------

This is the first port. Read the documentation.


-------------------------------------------------------------------------------




The port consists of the usual two packages that have been produced using
djdev20X (CVS repository code) and can be downloaded from ftp.delorie.com
and mirrors as (time stamp 2022-10-23):


Ogg Vorbis Library 1.3.7 headers, library and html format documentation:
http://ftp.delorie.com/pub/djgpp/current/v2tk/lvbs137b.zip

Ogg Vorbis Library 1.3.7 source:
http://ftp.delorie.com/pub/djgpp/current/v2tk/lvbs137s.zip



Send Ogg Vorbis Library specific bug reports to
<https://lists.xiph.org/mailman/listinfo/vorbis-dev/>.
Send suggestions and bug reports concerning the DJGPP port
to comp.os.msdos.djgpp or <djgpp@delorie.com>.


Enjoy.

Guerrero, Juan Manuel <juan.guerrero@gmx.de>

--- SoupGate-Win32 v1.05
* Origin: fsxNet Usenet Gateway (21:1/5)