diff options
Diffstat (limited to 'support/poster/README')
-rw-r--r-- | support/poster/README | 106 |
1 files changed, 106 insertions, 0 deletions
diff --git a/support/poster/README b/support/poster/README new file mode 100644 index 0000000000..95397ab8c9 --- /dev/null +++ b/support/poster/README @@ -0,0 +1,106 @@ +Poster - resize a postscript image to print on larger media and/or multiple sheets +Copyright (C) 1999 Jos T.J. van Eijndhoven + +This program is free software; you can redistribute it and/or +modify it under the terms of the GNU General Public License +as published by the Free Software Foundation; either version 2 +of the License, or (at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program; if not, write to the Free Software +Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA + +The full text of the GNU General Public License is included +with poster in the file LICENSE. +============================================================================= + +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) +Makefile (To compile `poster' in UNIX environments) +poster.c (The complete source code) +poster.1 (A troff-source manual page for online installation in UNIX) +manual.ps (A formatted version of poster.1 in postscript) + +Furthermore for your convenience: +poster.tar.gz (The compressed collection of the above 5 files) +getopt.c (you normally don't need to fetch 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 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 +Dept. of Elec. Eng. +Eindhoven Univ of Technology +The Netherlands +email: J.T.J.v.Eijndhoven@ele.tue.nl + |