README : Print Vhdl Source Code
+++++++++++++++++++++++++++++++++

PVSC 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(MVP). 

You have to "uudecode", "uncompress", and "untar" the complete posted file
to get all the source codes as well as a 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
(command> pvsc -uKF8Z -S"VHDL standard package" standard_p.vhd > standard.ps).

Here are some parts of the original README file of MVP 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 "pvsc" without any options to get
this small man page:

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
             PRINT TOOL FOR VHDL SOURCE CODE (PVSC)
                     By M. Gumm / Nov. 1994
                        Distribute freely

            Original Tool (MVP) by P.S. Elliot / 1993

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

pvsc -[ulKIF<int>DB<int>E<int>] -[S <subject>] [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>)
        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
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

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                           |
\______________________________________________________________________/

