Short installation description:
-------------------------------

1. Read the license, by using this program you signal your acceptance
   of the terms as presented within.

2. Run 'linkAllFonts.sh' in the pstill_dist directory to generate
   the base font set, note that the 'PSFonts' directory must be writeable:

   sh linkAllFonts.sh

3. Run PStill (example):

   pstill64 -M defaultall -o output.pdf input.ps

   when calling from another location use either a full path

   /usr/local/pstill_dist/pstill64 ...

  or setup the environment variable PSTILL_PATH to the location of
  the pstill so the program knows where to find its resources.

  For more examples and option descriptions:

  pstill -H | more

  When running multiple instances in parallel be sure to supply the
  the option -T tmppath. Each instance needs a unique temp directory.

4. Entering the license key (commercial users needs to do so):

   pstill -key "yourlicensename-abcdefg123456789!ABCDEFG"

   Depending on your shell you may need to escape the '!' char by placing
   a '\' in front of it.


.....................................................................


Welcome to the public release of PStill (Command line version)

(c) by Frank Siegert, 1998-2024, see COPYRIGHT file for more info

See the pstill web page http://www.pstill.com
for more information and updates.

PStill is inexpensive shareware, please do not priate this software
or further development is not possible. Private and educational use
of this Linux Version is allowed without registration and costs.

Any commercial users must aquire a license, please see

	 http://www.pstill.com

to order one online or use the enclosed registration form.

You are using this software entirely at your own risk. The author
is not responsible for any damage its use or misuse might cause.
Especially he is not responsible for the accuracy or quality of
the produced PDF files. Having said that, I hope PStill will be
helpful to you, please drop me a note if you find it useful or
encourage others to try it.

PLEASE NOTE:

You need to purchase a license for every instance of PStill you
run in a commercial environment. An instance is a running program of
PStill regardless of working environment (client or server).

Please contact frank@wizards.de for more information about licensing
options and volume licenses.

Some FAQ points:

(See also http://www.wizards.de/~frank/pstill_qa.html)

- How do I create PDF/X:

  Use options:

  -m XPDFX="Output Intent Name"
  -m XPDFXVERSION=1A   (optional, default is PDF/X-3)
  -m XICCProfile=/path/to/profile.icc

- I need more fonts:

PStill accepts Type 1 fonts, usually font file with the postfix *.pfa
or *.pfb. PStill does not need any AFM (metric) files, it generate its
own metrics. Copy fonts to PSFonts and run 'pstill -v -I' in the work
directory of PStill.

PStill can also use TrueType fonts just copy them to PSFonts and run

  pstill64 -v -I PSFonts/YOURNEWFONT.ttf

PStill will use the 'Postscript font name' as embedded in the TTF source for
the generated font name.

- I want to autoreplace TeX dvips bitmap fonts:

Use option "-D" and be sure to install the TeX fonts, e.g. Computer Modern
in PSFonts as Type 1 versions. See e.g. http://www.ctan.org/tex-archive/fonts/

- I get too dark colors in the PDF output:

Use option -C to write colors as RGB. Some PDF readers show CMYK too dark
on screen or supply a ICC color profile for CMYK. PStill will then use it to
convert colors.

- What about temp space:

During its first phase (PS interpretation) PStill is writing to /tmp
and needs space to work. If no space is available it may fail during this
stage. Please provide at least 50 MByte scratch area. You may change the
default temporary directory using the '-T path' option.

ATTENTION: For every running instance of PStill you need to specify
a unique temp directory, otherwise they might interfere with undefined
results!

- A note about security:

PStill includes a full interpreter with file I/O capacities, so do not
run it as root as it is able to open/read/write files if told so in the
PostScript input. Running pstill in a closed environment or check the 
PostScript files with pscheck (inquire by email for more details) before is
usually a good idea if they come from suspicious sources. PStills write
mechanism is turned off by default - you can reactivate it using option -k


PStill must be registered if used for commercial purposes.

Please provide feedback to frank@wizards.de, Thanks!

Updates are available from http://www.pstill.com


