
==============================================================================

		    Kernel patches and Installation

	    for the PC Sound Speaker driver version 0.8

==============================================================================

Hi Linuxers,

Since kernel 1.2.1 came into my posession, I was looking out for the kernel
patches of the PC speaker device. I didn't find any, so I created some. I put
together this package, which includes some patches for older kernels, the
entire pcsnd-kit v0.8, and all the docs that came with the older versions.

This archive contains:
    doc/ - all the docs from previous versions, please CHECK THERE for
	complete documentation.
    src/ - sources for the pcsnd-kit itself (vplay, man pages, etc.)
    samples/ - a couple of sample .wav files, on which you can test the
	installation (or just run Doom ;-)
    kernel-patches/ - patches for the kernel tree.
I somewhat re-organized the files from the older pcsnd-kit archives and other
necessary packages, so that you have now all in one tar and under one
directory. I didn't leave out anything though.

To install follow these steps:

    (0) Install the contents of this archive relative to /usr/src. You should
    have already done that, since you're reading this documentation. That
    should yield /usr/src/pcsnd-kit and subdirs.

    (1) Install the kernel patches. Just do:
	    cd /usr/src
	    patch -p0 < pcsnd-kit/kernel-patches/linux-1.2.1.pcsp.diff
    That should patch some kernel files and create e.g.
    /usr/src/linux/drivers/pcsnd/ with the kernel-utilities. If your kernel is
    other than 1.2.1, see if there's a patch file for it, otherwise you're out
    of luck. You might try the nearest number (e.g. linux-1.2.1.pcsp.diff for
    a 1.2.2 kernel) and just hope that you get lucky.

    (2) Create all necessary devices and .h files. Just do:
	    cd /usr/src/pcsnd-kit/kernel-patches
	    ./pcspinstall
    Answer "y" in the "continue or abort" question.

    (3) Re-configure and re-build your kernel. Say "y" for the PC-sound
    selection.

    (4) Create the pcsnd-kit programs. Just do:
	    cd /usr/src/pcsnd-kit/src
	    make install
    That will install the programs as vplay to /usr/local/bin and manpages to
    /usr/man/man1.

    (5) Reboot with your new kernel and test it out. Just do:
	    cd /usr/src/pcsnd-kit/samples
	    vplay enterpri.raw

    (6) [Optional] Add doc/etc.magic.vplay to your /etc/magic. That way the
    "file" command will recognize sound files.

    (7) [Optional] The patch from section (1) creates a lot of .orig files.
    Now that you've tested things and it works, you might as well remove
    these:
	    cd /usr/src/linux
	    find . -name '*.orig' -exec rm {} \;

If anything fails, try to figure it out yourself. I am neither the author nor
the maintainer of pcsnd-kit, I just posted this. You can of course mail me,
but chances are that I won't be of any help at all.

Karel (karel@icce.rug.nl).

