What is it?
===========

This directory contains software and patches used in the Chapter 4
artice in Software Design (Gijutsu-Hyohron Co., Ltd.), December 2005.

All patches are distributed under the respective original source code
license.


Contents
========

|-- MD5SUM.txt
|-- README.txt.en
|-- README.txt.ja
|-- all.patch
|-- b2p.cgi
|-- barcode
|   |-- Makefile
|   |-- barcode.c
|   `-- barcode_player.c
|-- patch.tar.gz
|-- patch
|   |-- add-alsaplayer.patch
|   |-- add-asound2.patch
|   |-- add-ogg.patch
|   |-- add-snd-devices-a9.patch
|   |-- add-snd-devices-soundstation.patch
|   |-- add-tremor.patch
|   |-- add-vorbis.patch
|   `-- series
`-- source
    |-- alsa-lib-1.0.9.tar.bz2
    |-- alsaplayer-0.99.76.tar.bz2
    |-- libogg-1.1.2.tar.gz
    |-- libtremor.tar.gz
    `-- libvorbis-1.1.1.tar.gz

all.patch is a combined patch.  all patches under the patch directory
are combined into the all.patch.  if you are using all of the source
tarballs under the source directory, you can just apply this patch.

b2p.cgi is sample server-side cgi code.  you need to change the
DATA_LOCATION variable to suit your environment.  if you are adding
new barcodes to the code, add them in the case statement.

the barcode directory contains two sample code files to read data from
the barcode reader we used.  A makefile is also provided.  the
makefile is to be used for out of tree compiles with
atmark-dist. Change the first line of the makefile to suit your
environment.  Please refer Atmark Dist manual for more details.

the patch directory contains all patchs used to create all.patch.  if
you want to integrate some of the tarballs under the source directory,
it might be useful to use these patches. these patches are generated
with quilt. a series file is also provided for quilt users.

the source directory contains all tarballs used in the chapter.  all
tarballs except alsaplayer should be extracted to the lib directory
under Atmark Dist. alsaplayer-0.99.76.tar.bz2 should be extracted
under the user directory.  extracted directory names should be renamed
to match with the patches.

Under the lib directory:

    alsa-lib-1.0.9.tar.bz2     => alsa-lib
    libogg-1.1.2.tar.gz        => libogg
    libtremor.tar.gz           => libtremor
    libvorbis-1.1.1.tar.gz     => libvorbis

Under the user directory:

    alsaplayer-0.99.76.tar.bz2 => alsaplayer


Misc
====

if you encounter any problems, or have any questions, ideas and/or
enhancements in relation to these files, please contact the Armadillo
ML.  Hope to see you there.

    http://lists.atmark-techno.com/mailman/listinfo/armadillo