LEGAL STUFF
===========

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of the
License, or any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public
License along with this program; if not, write to the Free
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
USA.


REQUIREMENTS
============

You will need a C++ compiler for these programmes, the "make"
utility, and the "ar" utility. You will also need the PBM utility
header files and the libraries "libppm.a", "libpbm.a", "libpnm.a"
and "libpgm.a".  There is a very good chance that these will
already be on your UNIX system, as they are quite popular.
Some test mpeg files would also be useful!


INSTALLATION
============
The Makefile will probably need editing, but only to set where the PBM
header files are.  On my Linux system, this is "/usr/include/gr",
whereas on the Sun system I used, they were in "/usr/include/X11R5/X11".
Once you have set the path of the PBM header files, all you should need
to do is type make.  If the programmes fail to compile, try adding a
"-DNO_BOOL" to the CPPFLAGS line of the Makefile.  "-DNO_BOOL" will stop
one of the header files from defining the type bool, which may already be
defined in newer C++ compilers.

This programme was written under Linux v1.1.92 using gcc version 2.5.8

On one of the Sun systems that I tried this programme on, I got a large
number of warnings.  Some of these are from the mpeg decoder, which I didn't
write. Unfortunately, the majority are in parts that I have written!  They
are all warnings about sign changes, where I pass an unsigned value to a
function requiring a signed one, or visa-versa.  These warnings are not
important, and so you should not worry about them (in fact the Linux version
of gcc doesn't even report them as warnings, which is why I have not added
lots of type casts to cure these warnings!).

Once you have compiled the programme copy the mpeg_edit binary to a
directory that is in your path.

Now cd into the xuseless directory and type make.  Copy the xuseless binary
into the directory that contains the help files (e.g. cp xuseless ../help).

If you want to import anything other than YUV or PPM files, you will also
need a copy of the pbm utilities in your path.

Before running the programme, add the following lines to you .Xdefaults :

Mpeg Edit.helppath:             [directory where the source is]/help
Mpeg Edit.overlaypath:          [directory where the source
is]/help


For example, my .Xdefaults has the lines:

Mpeg Edit.helppath:             /home/milamber/mpegedit_v2.2/help
Mpeg Edit.overlaypath:          /home/milamber/mpegedit_v2.2/help


Then type
xrdb -load .Xdefaults
.... to make the changes take effect.  These two X resources are needed to
find the help files, xuseless, and the startup screen "title_page.dat".
If the programme segmentation faults at startup (as I have found on a
certain Sun system) try re-naming "title_page.dat" to "title_page.off",
which will stop the startup screen from being displayed, and may cure your
problems.