Hello candidate `poster' user!

Here you have the new release of `poster', to scale postscript
images to a larger size, and print them on larger media and/or
tile them to print on multiple sheets.

With respect to the earlier release:
- support is added for foreign (Non European A*) media sizes.
- options for scaling became more flexible
- original restrictions on white margins in your drawing are removed.
For a complete explanation see the accompanying manual.

This distribution has the following files:
==========================================
README     (which you are reading now)
poster.1   (A troff-source manual page for online installation in UNIX)
manual.ps  (poster.1 in postscript)
manual.txt (poster.1 in ascii text)

poster.exe (a compiled DOS executable)
poster.c   (The complete source code)
Makefile   (To compile `poster' in UNIX environments)
getopt.c   (you normally don't need this, see below)


Here a few words on the installation of `poster':
==================================================

The complete program consists of really only one file: `poster.c'.
Before starting compilation you might want to take a look on
the C sources in `poster.c', where you can set a few options around line 30:
  Maybe you want to change the `DefaultMedia' and `DefaultImage' from "A4"
  to better reflect your local situation (such as "Letter").
  Media names can be chosen from the `mediatable' further down the code.
  (Maybe you even want to add new media sizes/names there,
   you can do that without requiring any other change elsewhere)

  The `Gv_gs_orientbug 1' disables a feature of this program to
  ask for landscape (horizontal) previewing of rotated images.
  Our currently installed combination of ghostview 1.5 with ghostscript 3.33
  cannot properly do a landscape viewing of the `poster' output.
  The problem does not exist in combination with an older ghostscript 2.x,
  and has the attention of the ghostview authors.
  If you have a different postscript previewing environment, you might
  want to remove or comment-out the `#define Gv_gs_orientbug 1' line.

You should be able to compile this with any ansi-C
compiler in a Posix or Xopen environment.
You can probably compile it with a command like:
     cc -O -o poster poster.c -lm
(i.e. compile with optimization, and link with the math library)

(Some environments miss the required 'getopt()' call,
 with the <unistd.h> include file,
 if your environment supports none of the SVID, XPG or POSIX standards.
 If you have this problem, you can comment out the '#include <unistd.h>'
 line in `poster.c', fetch `getopt.c' from the poster directory,
 and compile and link these two files together.)

(Note that this program might trigger a stupid bug in the HPUX 9.? C library,
 causing the sscanf() call to produce a core dump.
 For proper operation, DON'T give the `+ESlit' option to the HP cc,
 or use gcc WITH the `-fwritable-strings' option.)

The resulting executable is fully self-contained,
and doesn't require you to install other files at
`special' places in the OS.

(For DOS users without C compiler, an executable
 `poster.exe' is available)

For UNIX environments (the primary target for the program)
there is a man page available `poster.1', which you can copy
to /usr/local/man/man1/ to obtain online manual support for
the users.

The formatted version of this manual is available as a
postscript file `manual.ps', such that people who
don't know how to format unix man pages, still have
documentation to read and print.

Success!

Jos van Eijndhoven
Sept 20,  1995
