***************************************************************************

Copyright (C) 1995, Michael Hemy  (mhemy@cs.cmu.edu)

This file is part of ps2eps It is distributed in the hope that it will
be useful, but WITHOUT ANY WARRANTY.
No author or distributor accepts responsibility to anyone for the
consequences of using it or for whether it serves any particular purpose 
or works at all, unless he says so in writing.

Everyone is granted permission to copy, modify and redistribute
ps2eps, but only under the conditions described in the
GNU General Public License.  A copy of this license is supposed to have 
been given to you along with ps2eps so you can know your rights and
responsibilities.  It should be in a file named COPYING.  Among other
things, the copyright notice and this notice must be preserved on all
copies.

***************************************************************************


Introduction:
-------------- 
ps2eps was created based on ps2epsi. It generates an eps or epsi file from 
a ps file. ps2epsi is a script file but ps2eps was written in C to provide 
extended functionality. 

ps2eps in this incarnation provides enhanced capabilities:
	- cleans up msdos created ps files by removing escape sequences;
	- supports clipping the image to its real boundingbox boundaries;
          Note that clipping has to be inserted at the "right place".
          The "right place" is currently based on searching for special
          strings in the ps file. The default search strings are what
          I found from my experience. BUT it is possible to define up to 8
          additional search strings in the command line.
	- allows to process multiple ps files in one command;
	- allows to add borders around images; Default border is
	  currently set to 8 points on each side which at least for me
	  works better because ps2epsi.ps does not do such a good job
	  at evaluating the border and this puts it on the safe side.
	  If you want no borders use -b 0 on the command line.
	- allows specifying assymetrical borders. I added this capability
	  because framemaker 3.1 was truncating eps files on these sides.



Installing:
------------
Some minor modifications may be required in the Makefile.
$(install_prefix) should be set to where the ghostscript installation
resides (This should most likely be /usr/local or /usr).

Also if you change the default compiler to CC remove -Wall from CCFLAGS

If you do not have "install" in your computer you will need to copy
ps2eps to the appropriate place.

To make type:
	% make

If everything looks right you can proceed and type:
	% make install


Using:
-------
ps2eps takes the following arguments:

	-o epsfilename	(sets the name of the resulting eps(i) file)
	-c		(generate clipping around bounding box)
        -t tag          (add another search tag)
	-b points	(adds a border specified by points around the image)
	-u points       (adds a border to the top of the image)
	-d points       (adds a border to the bottom of the image)
	-l points       (adds a border to the left of the image)
	-r points       (adds a border to the right of the image)
	-i              (generate epsi file: with preview image)
	-v		(verbose: display info)
	-h       	(help)
	-V		(version information)


[1] In the simplest form to create foo.eps:
	% ps2eps foo.ps

[2] To create an output with a different name:
	% ps2eps -o bar.eps foo.ps

[3] To create an eps file that has clipping around the bounding box:
	% ps2eps -c foo.ps

[4] To convert multiple files
	% ps2eps *.ps
	% ps2eps -c *.ps
	% ps2eps -v foo.ps bar.ps

[5] To convert files with clipping inserted by searching other tags too:
	%ps2eps -c -t "%%EOF" -t "eof" *.ps


Comments / Bugs:
-----------------
If you find this utility useful or if you have any suggestions, please
email to mhemy@cs.cmu.edu
