===========================================================================
            Make VHDL Pretty (MVP) Version 1.1 / Dez. 94
===========================================================================
This program is free software; you can redistribute it and/or modify
it for any NONCOMERCIAL use.

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. 
===========================================================================
Fixed Bugs: - Correct replacement of tabs in Postscript output
              march 95
            - Identifiers are not changed automatically to only uppercase/
              lowercase
              may 95
Known Bugs: - PostScript: no proper page breaking when VHDL-code line
              which is to be printed on the last line of one page produces
              a line break (because it's to long)
              Workaround : make this VHDL code line shorter             
===========================================================================
Last maintanance date : Nov. 17, 1995
===========================================================================

DESCRIPTION:

MVP is both an VHDL prettyfier (ASCII to ASCII) and a vhdl source code
lister. It generates either ascii or a PostScript file. The printout is
like the one generated by the unix tool >>mp<<. 

Thanks to P.S. Elliot (Paul.Elliott@def.bae.co.uk) who wrote the original
tool. 

You have to "uncompress", and "untar" the complete file "mvp_v1_1.tar.Z"
to get all the source codes as well as an allready compiled version (for
SUN 4). Additionally, the file "standard.ps" contains an example to quickly
get an idea how the print out is like
(mvp -uKF8Z -S"VHDL standard package" -N"Martin Gumm" standard_p.vhd > standard.ps).

Here are some parts of the original README file by P.S. Elliot:

>MVP was written using Sun ( K&R like ) C and FLEX, and has been successfully
>compiled on a Sun 4 workstation and PC using Microsoft Turbo C. As well as
>the source code the FLEX generated file 'scan.c' has been included in case
>you don't have the FLEX lexical analyser generator. This is widely available 
>via anonymous ftp.
>
>A makefile has been provided to build the binary for UNIX systems. Some
>modification will be required for IBM PCs.

The program is self explanatory, just type "mvp" without any options to get
this small man page:

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
                         MAKE VHDL PRETTY
                     (print tool for VHDL code)

              Original Version by P.S. Elliot / 1993

             Extended Version (V1.1) by M. Gumm / Dez. 1994

                  " mp " - Printout Style:
                Original version by Steve Holden

              Distribute freely for noncommercial use !
--------------------------------------------------------------------
Usage: 

mvp -[ulKIF<int>DB<int>E<int>] -[S <subject>] -[N <name>]
     [infile] [> outfile]

Otions in [] mean:

   ASCII processing:
        u       Upper case key words (default)
        l       Lower case key words

   PostScript processing (default: no PostScript output):
        K       Bold key words
        I       Bold identifiers
        F<int>  Font size (possible: 6, 8, 10 (default), 12, 14)
        D       HP Lj4 duplex output
        S       Bottom text for all pages (default: <infilename>)
        N       User name (max. 24 letters) in headline (default: none)
        B<int>  Begin output with page no. (default: 1)
        E<int>  End output with page no. (default: 1000)
        Z       Output with line numbering
   Files:
        infile  Name of input file; if omitted stdin is read
        outfile Dircet output from stdout to outfile
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

BUGS:

(see above)

SUPPORT:

Please feel free to modify and distribute this program. Report comments and
bugs to me. I would also be happy to get further improved versions if
there will be any. 

Have fun !

 ______________________________________________________________________
/   Martin Gumm                                                        \
|                                            __  ____   _   __  ____   |
|   Institut fuer Parallele und Verteilte   / / / __ \ | | / / / __ \  |
|   Hoechstleistungsrechner (IPVR)         / / / /_/ / | |/ / / /_/ /  |
|   Abt. Integrierter Systementwurf       / / / ____/  | | / / _  _/   |
|   Breitwiesenstrasse 20-22             /_/ /_/       |__/ /_/ \_\    |
|   D-70565 Stuttgart                                                  |
|----------------------------------------------------------------------|
|   Tel.  : ++49 (0)711 7816226                                        |
|   Fax   : ++49 (0)711 7816250                                        |
|   e-mail: gumm@informatik.uni-stuttgart.de                           |
\______________________________________________________________________/