Index of /knowledgemedia/MISC/MSDOS/PSCOVER

      Name                    Last modified       Size  Description

[DIR] Parent Directory 11-Jun-2003 14:48 - [TXT] CASS.C 11-Jun-2003 14:48 23k [TXT] DEFINE.C 11-Jun-2003 14:48 1k [TXT] DO_CMD.C 11-Jun-2003 14:48 9k [TXT] EMBED_PS.C 11-Jun-2003 14:48 5k [TXT] FIND_CMD.C 11-Jun-2003 14:48 3k [TXT] MAKEFILE 11-Jun-2003 14:48 1k [TXT] PSCASS.C 11-Jun-2003 14:48 3k [   ] PSCOVER.1 11-Jun-2003 14:48 12k [TXT] PSCOVER.C 11-Jun-2003 14:48 5k [TXT] PSCOVER.H 11-Jun-2003 14:48 4k [   ] PSCOVER.PS 11-Jun-2003 14:48 25k [TXT] SAMPLE1.DAT 11-Jun-2003 14:48 1k [   ] SAMPLE2.PS 11-Jun-2003 14:48 4k [TXT] SAMPLE3.DAT 11-Jun-2003 14:48 1k

				**** PSCOVER ****
				(c) 1992 Bill Pringle
				wrp@ivy.unisys.com

This file describes the package PSCOVER, which creates a postscript
file to print cassette covers.  The program reads an input data
file that defines cassette cover(s), and outputs postscript code.

Cassette covers can be created in one of two ways:

	1. The program pscass can read a postscript program containing
		function calls and prefixes it with the prologue

	2. The program pscover can read a command file and create
		the cover.

Copyright (C) 1992 by Bill Pringle

Permission is granted to use and/or modify these files for
personal, non-commercial use in accordance with the provisions of
the latest "Copyleft" agreement from the Free Software Foundation.

Bug reports, changes, compliments, etc. can be e-mailed to the above
address, or written on the back of a $20 bill and mailed to ... :^)

########################################################################

This package contains the following programs:

pscover		Parses input file and creates postscript
pscass		Prefixes a cover postscript file with a prologue
embed_ps	Creates a C subroutine to output a postscript file

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

				**** EXTRA FILES ****

This package contains the following ancillary files:

readme		This file, the one you are reading :^)

makefile	This file controls compilation of the programs

sample1.dat	sample data file that you can use with pscover
sample2.ps	sample postscript file that you canuse with pscass
sample3.dat	sample data file used for debugging

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

				**** PSCOVER ****

The pscover program contains the cass.c file (which was created
from cass.ps), a command parser, and routines to output the
necessary function calls to create a cassette cover.

Files:

pscover.c	the main program
pscover.h	header file, defining structures & functions
cass.ps		the postscript (master) version of the prologue
cass.c		generated from cass.ps to output the postscript prologue
define.c	defines external variables
do_cmd.c	contains functions to process the user commands
find_cmd.c	performs a table lookup to recognize a function
pscover.1	manual page for the pscover program
pscover.ps	a postscript version of the manual page
=========================================================================

				**** PSCASS ****

The pscass program will read a postscript file containing function
calls to create a cassette cover, and prefix it with the prologue.

Files:

pscass.c	The main program (must be linked with cass.c)

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

				**** EMBED_PS ****

The embed_ps.c program reads a postscript file and outputs a C
function to produce the same file.  The resulting source file
must be linked with a main program.  The default function name
is prologue_ps, which can be changed with the -n  option.  The
function takes one argument: a file pointer to the output file.

This program can be used as a standalone program not only with the
pscover package, but to convert any PostScript program to a C program. 

Files:

embed_ps.c	The complete (stand-alone) program


##########################################################################

Change History:

1.0		Original version (this history never appeared in it, though :^(

1.1		Changed PostScript program cass.ps
			Added DAT covers thanks for Brian Redman (ber@bellcore.com)
			Fixed minor bug in CenterLine, also thanks to ber@bellcore.com
		Changed pscover program:
			Added interactive mode (useful for running under windows)
			Added ability to specify an output file
		Changed embed_ps program:
			Added help option
			Added ability to specify C function name
				(not used, but allows you to define different sets of
				prologues for different options)
		Changed pscass program:
			Added support for output file