summaryrefslogtreecommitdiff
path: root/support/ps2eps/doc/INSTALL.md
diff options
context:
space:
mode:
Diffstat (limited to 'support/ps2eps/doc/INSTALL.md')
-rw-r--r--support/ps2eps/doc/INSTALL.md75
1 files changed, 75 insertions, 0 deletions
diff --git a/support/ps2eps/doc/INSTALL.md b/support/ps2eps/doc/INSTALL.md
new file mode 100644
index 0000000000..c699dabbda
--- /dev/null
+++ b/support/ps2eps/doc/INSTALL.md
@@ -0,0 +1,75 @@
+# INSTALLATION
+
+## Prerequisites
+
+you need:
+
+* perl (an interpreter for the perl language, see
+ http://www.perl.com)
+
+* ghostscript (an interpreter/raster image processor for the
+ PostScript language, see
+ https://www.ghostscript.com/)
+
+* maybe an ANSI-C compiler if the provided binaries for bbox do not
+ work for you. Sorry for the inconvenience, but I tried to write a
+ bbox equivalent in perl and it was terribly slow. Therefore I stick
+ to C, because of much better performance. *Alternatively* you can
+ use ps2eps option -g, then no bbox binary is required.
+
+## How to install
+
+ Please check that you have working
+ <kbd>perl</kbd> and <kbd>ghostscript</kbd> packages.
+
+### Linux/UNIX-based platform
+
+1. install bbox
+
+ If a bbox binary is included for your platform you simply move it
+ into any directory of the system search path. Otherwise, you have
+ to compile bbox.c first by invoking
+
+ ```
+ cc -o bbox bbox.c.
+ ```
+
+ (sometimes "make bbox" also works).
+ Please make sure that bbox is executable (chmod a+x bbox).
+ If you already have a working perl and a working ghostscript, you're
+ finished here, else you have to install them first.
+
+2. install ps2eps
+
+ On Unix platforms you simply move the perl script ps2eps into a
+ directory which is included in the system or personal search path
+ (e.g., /usr/local/bin, $home/bin). Please make sure that ps2eps is
+ executable (chmod a+x ps2eps).
+
+### Windows-based platform
+
+Use the command line interpreter:
+Copy bbox.exe into a directory that is
+in your's or the system's search path for executables. Please try
+to invoke bbox -h afterwards.
+
+The best possibility is to use associated file types under
+Windows:
+
+1. rename ps2eps to ps2eps.pl and
+
+2. SET PATHEXT=.pl;%PATHEXT% or use the
+ settings -> control panel -> system -> "advanced" tab -> environment variables
+ and edit the PATHEXT entry accordingly.
+
+3. then simply typing ps2eps should invoke ps2eps correctly
+
+ Another option is to call perl directly:
+```
+ perl ps2eps ...
+```
+
+The script assumes that you have "gswin32c" as
+postscript interpreter in your path. Under Windows ps2eps
+can perform wildcard expansion on its own.
+