
	This software is provided without support and without any obligation
	on the part of Silicon Graphics, Inc. to assist in its use,
	correction, modification or enhancement.  There is no guarantee
	that this software will be included in future software releases.

	THIS SOFTWARE IS PROVIDED "AS IS" WITH NO WARRANTIES OF ANY KIND
	INCLUDING THE WARRANTIES OF DESIGN, MERCHANTIBILITY AND FITNESS FOR
	A PARTICULAR PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE OR
	TRADE PRACTICE.

        In no event will Silicon Graphics, Inc. be liable for any lost
        revenue or profits or other special, indirect and consequential
        damages, even if Silicon Graphics, Inc.  has been advised of the
        possibility of such damages.


Contents:

	ghost.tar
	    A tar archive containing the necessary images to install 
	    executable copies of ghostscript and ghostview on an SGI
	    workstation running IRIX 4.0+.


Description:

	Ghostscript and Ghostview together provide a simple X based means
	for previewing PostScript documents.
	
	Below are the respective author's overviews in a shar format.


Instructions:

	Copy ghost.tar to /usr/tmp.

	    % su
	    # mkdir /usr/local/dist
	    # cd /usr/local/dist
	    # tar xvf /usr/tmp/ghost.tar
	    # inst -f /usr/local/dist

	Then follow the instructions from inst.  To find out more about
	inst, consult the inst(1M) man page.


	The inst images of "ghost" in /usr/local/dist can be used by 
	networked machines to install from.  On the remote machine:

	    % su
	    # inst -f guest@"machine with images":/usr/local/dist

	Then follow the instructions from inst again.


...robert keller (rck@sgi.com)


#!/bin/sh
# This is a shell archive (shar 3.32)
# made 05/31/1993 19:22 UTC by rck@trabant
# Source directory /usr/local/fangio/src/gnu/ghost1.18
#
# existing files WILL be overwritten
#
# This shar contains:
# length  mode       name
# ------ ---------- ------------------------------------------
#  13660 -rw-r--r-- README.ghostscript
#   6717 -r--r--r-- README.ghostview
#
if touch 2>&1 | fgrep 'amc' > /dev/null
 then TOUCH=touch
 else TOUCH=true
fi
# ============= README.ghostscript ==============
echo "x - extracting README.ghostscript (Text)"
sed 's/^X//' << 'SHAR_EOF' > README.ghostscript &&
X   Copyright (C) 1989, 1992, 1993 Aladdin Enterprises.  All rights reserved.
X
XThis file is part of Ghostscript.
X
XGhostscript is distributed in the hope that it will be useful, but
XWITHOUT ANY WARRANTY.  No author or distributor accepts responsibility
Xto anyone for the consequences of using it or for whether it serves any
Xparticular purpose or works at all, unless he says so in writing.  Refer
Xto the Ghostscript General Public License for full details.
X
XEveryone is granted permission to copy, modify and redistribute
XGhostscript, but only under the conditions described in the Ghostscript
XGeneral Public License.  A copy of this license is supposed to have been
Xgiven to you along with Ghostscript so you can know your rights and
Xresponsibilities.  It should be in a file named COPYING.  Among other
Xthings, the copyright notice and this notice must be preserved on all
Xcopies.
X
X- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
X
X*****************************************************
X* This file describes version 2.6.1 of Ghostscript. *
X*****************************************************
X
X********
X******** An overview of Ghostscript ********
X********
X
XGhostscript is the name of a set of software that provides:
X
X	- An interpreter for the PostScript (TM) language, and
X
X	- A set of C procedures (the Ghostscript library) that
Ximplement the graphics capabilities that appear as primitive
Xoperations in the PostScript language.
X
XThe primary contact for Ghostscript is:
X
X	Aladdin Enterprises
X	P.O. box 60264
X	Palo Alto, CA 94306
X	voice (415)322-0103
X	fax (415)322-1734
X	...{uunet,decwrl}!aladdin!ghost
X	ghost@aladdin.com
X
XL. Peter Deutsch, president of Aladdin Enterprises, was the original
Xcreator, and is the primary developer and maintainer, of Ghostscript.
XAladdin Enterprises owns the copyright in Ghostscript; Ghostscript is
Xdistributed with the GNU General Public License, and is also available for
Xcommercial licensing.
X
XThe Ghostscript language interpreter and library are written entirely
Xin C, with some assembly-language accelerators for MS-DOS platforms.
XCurrently, Ghostscript is known to run on the following platform
Xfamilies:
X
X	- IBM PC and compatibles with EGA, VGA, SuperVGA, or compatible
X	  graphics under MS-DOS 3.1, 3.3, or 5.0, with or without
X	  Microsoft Windows 3.0 or 3.1;
X
X	- IBM PC and compatibles under OS/2 2.0 and 2.1;
X
X	- A wide variety of Unix systems using X Windows version 11,
X	  release 3, 4, and 5, including Sun-3, Sun-4, Sun-386i,
X	  Sun SPARCStation 1 and 2; generic 80386 machines running 386/ix,
X	  ISC Unix, and SCO Unix; H-P 9000/300 and 9000/800;
X	  DECStation 2100 and 3100; VAX running Ultrix; Sequent Symmetry;
X	  Convex C1 and C2; Tektronix 4300; SGI Iris Indigo;
X
X	- Sun workstations (Sun-3, SPARC, Sun-386i) running SunView;
X
X	- VAX, VMS with X11R3/4/5 and gcc.  (Ghostscript currently is
X	not compatible with the DEC C compilers, because they
X	interpret the ANSI C standard in a way different from all
X	other known compilers.)
X
XIt is very likely that Ghostscript will run under other versions of
XMS-DOS, and other versions of Unix that support X11, but it has not
Xbeen tested in these environments.  Ghostscript does NOT run well on
XPC-compatibles with Hercules display cards: text and graphics output
Xinterfere with each other.
X
XOther platforms
X---------------
X
XGhostscript has also been ported a number of platforms by users, who
Xare willing to be contacted regarding problems on those specific
Xplatforms:
X
X	- For information on a port to the Apple Macintosh, contact
X	Martin Fong (mwfong@nisc.sri.com).  (Aladdin Enterprises will be
X	offering a Macintosh port in early 1993.)
X
X	- For information on a port to the Acorn Archimedes, contact
X	David Elworthy (David.Elworthy@cl.cam.ac.uk).
X
X	- For information on two different ports to Win-OS/2, contact
X	Gershon Elber (gershon@gr.cs.utah.edu) and/or Jim Yang
X	(jyang@daedalus.caltech.edu).
X
X	- For information on a port to the Atari ST, contact Tim
X	Gallivan (timg@landau.ph.utexas.edu).
X
X********
X******** Related work
X********
X
XThere are two freely available X Windows screen previewers based on
XGhostscript: Ghostview and GSPreview.  For information on Ghostview,
Xcontact Tim Theisen (ghostview@cs.wisc.edu).  For information on
XGSPreview, contact Richard Hesketh (rlh2@ukc.ac.uk).
X
XThere is a freely available MS Windows screen previewer based on
XGhostscript, called Ghostview for Windows.  For information on Ghostview
Xfor Windows, contact Russell Lang (rjl@monu1.cc.monash.edu.au).
X
XA set of patches and additions for Kanji capability for Ghostscript
Xversion 2.4.1 is available for anonymous FTP from
Xftp.cs.titech.ac.jp:GNU/gs241j11.tar.Z.  For more information, contact
XMr. Norio Katayama (katayama@nacsis.ac.jp).
X
XThomas Wolff (wolff@inf.fu-berlin.de) is working on extending the
XHershey fonts to include international characters.
X
X********
X******** Documentation overview ********
X********
X
XAll the file names mentioned in the documentation, except for README,
Xare in lower case, which is the usual convention for Unix systems.
XOn MS-DOS systems, all file names are actually upper-case.
X
XWhen you receive Ghostscript, you should start by reading:
X
X> README - this file.
X
X> readme.doc - information about problems and major changes new
Xfeatures in the current release.
X
XIf you have used a previous release of Ghostscript, you probably
Xshould also read any more recent sections of:
X
X> NEWS - a complete, detailed history of changes in the most recent
XGhostscript releases.
X
XEspecially for new users
X------------------------
X
XIf you are a new user of Ghostscript, you should read:
X
X> use.doc - information about to install and use Ghostscript.  This
Xinformation is also contained in gs.1 - a `man' page for Ghostscript.
X
X> devices.doc - more detailed information about specific devices that
XGhostscript knows about.
X
X> ps2epsi.doc, unix-lpr.doc - more detailed information about some of
Xthe shell scripts and batch files distributed with Ghostscript.
X
XIf you are going to compile Ghostscript, rather than just use an
Xexecutable you got from somewhere, you should read:
X
X> make.doc - how to install, compile and link Ghostscript.
X
XIf you run into any questions, or if you are going to be using
XGhostscript extensively, you should at least skim, and probably
Xeventually read:
X
X> fonts.doc - information about the fonts distributed with
XGhostscript, including how to add or replace fonts.
X
X> language.doc - A description of the Ghostscript language, and its
Xdifferences from the documented PostScript language.
X
X> psfiles.doc - information about the .ps files distributed with
XGhostscript (other than fonts).
X
XEspecially for developers
X-------------------------
X
XIf you are going to be writing a new driver for Ghostscript, you
Xshould read:
X
X> drivers.doc - the interface between Ghostscript and device drivers.
X
X> xfonts.doc - the interface between Ghostscript and platform-supplied
Xfonts.  (Read drivers.doc first.)
X
XIf you are considering distributing Ghostscript in conjunction with a
Xcommercial product, you should read the COPYING license carefully,
Xand you should also read:
X
X> commprod.doc - additional clarification of the circumstances under
Xwhich Ghostscript can be distributed with a commercial product.
X
XOther files
X-----------
X
X> ps2epsi.doc - documentation for the PostScript to EPSI conversion
Xutility.
X
X> helpers.doc - a note of thanks to all the people who have helped with
XGhostscript development.
X
X> hershey.doc - information about the Hershey fonts, which are the
Xbasis of some of the Ghostscript fonts.
X
X> history.doc - a history of changes in older Ghostscript release.
X
X> humor.doc - a humorous comment on Ghostscript contributed by a user.
X
X> lib.doc - information about the Ghostscript library.
X
X> unix-lpr.doc - information about how to integrate Ghostscript with
XUnix printer spooling.
X
X********
X******** Trouble reporting ********
X********
X
XAladdin Enterprises doesn't have the resources to respond to questions
Xfrom general users of Ghostscript.  If you have problems with Ghostscript,
Xand you have access to Usenet news, we suggest you post your question to
Xgnu.ghostscript.bug.  There are hundreds of Ghostscript user sites all
Xover the world, and often another user will be able to help you.  (If you
Xhave access to Internet mail, but not news, send e-mail to
Xbug-ghostscript@prep.ai.mit.edu.)  If you are having trouble with a
Xspecific device driver, look in the file devs.mak and see if it is a
Xuser-maintained driver.  If so, please contact the person listed there
Xdirectly; please do not contact Aladdin Enterprises regarding
Xuser-maintained drivers.
X
XAladdin Enterprises does want Ghostscript to be of high quality, so if you
Xhave been running Ghostscript and encounter a problem, we will consider
Xinvestigating it if you meet all the following criteria:
X
X	- You are using the most recent version of Ghostscript.
X
X	- You obtained Ghostscript directly from Aladdin Enterprises,
X	or from a GNU distribution site on the Internet (i.e., not from a
X	bulletin board system or a commercial system such as CompuServe or
X	GEnie).
X
X	- You have installed Ghostscript successfully, and used it
X	successfully on other input data.
X
X	- Your problem is reproducible, and you can send us the input
X	data that evokes it (by e-mail, anonymous FTP, or PC diskette).
X	(But please do not send anything unless we ask you for it.)
X
X	- Your bug report tells us what hardware, operating system,
X	window system, and C compiler you are using.
X
XBug reports that include suggested fixes are especially welcome.
X
XAs time permits, Aladdin Enterprises will also respond to e-mail from
Xthe following classes of users:
X
X	- Beta testers who have actually given us at least one report on
X	some beta version supplied to them.
X
X	- People developing drivers that are for, or applications that
X	are based on, Ghostscript and that will be made freely available.
X
X	- People who express serious interest in commercial licensing
X	of Ghostscript.
X
X	- Commercial licensees.
X
XGiven the choice between the Internet and the UUCP address, remember
Xthat the Internet is not to be used for general commercial traffic:
Xif you aren't sure whether you or your organization can use the
XInternet, use UUCP.
X
XAladdin Enterprises owns or has access to the following hardware and
Xsoftware:
X
X	80486 PC, MS-DOS 5.0, Microsoft Windows 3.1;
X	  Borland C++ 3.1 (and several older versions);
X	  color SuperVGA display; Epson-compatible printer
X	  (the printer also is compatible with the IBM Proprinter);
X	  various H-P printers; Canon BubbleJet.
X
X	SPARCstation, SunOS 4.1, cc and gcc, X11R5 and SunView;
X	  both monochrome and color displays.
X
X	DECstation, Ultrix.
X
XIf your problem turns out to be specific to some other hardware or
Xsoftware configuration, it may take longer to track down, since we
Xwill have to rely on other users to help.
X
XIf you call on the phone, you will usually be talking to an answering
Xmachine.  In this case, please leave a message with your name and
Xphone number and the best time for us to return the call.
X
X********
X******** Things you can do to help ********
X********
X
XThere are some projects that users could do that are somewhat
Xdecoupled from the main body of the code, and that would help improve
XGhostscript:
X
X	- Since Aladdin Enterprises doesn't have ready access to Unix
Xsystems, someone else is needed to take responsibility for texinfo and/or
Xman page documentation for Ghostscript.  What this would involve is
Xupdating this documentation during the beta test period for each release,
Xand sending it to Aladdin to be included in the final fileset.  (Aladdin
Xwould continue to supply the plain-text documentation as it currently
Xexists.)
X
X	- Ghostscript needs some good, free, Type 1 (outline) fonts.  Karl
XBerry is working on this, but it might go faster if he got some
Xknowledgeable assistance.  Contact karl@cs.umb.edu if you want to help
Xwith this.
X
X	- Adobe has donated the specification of the Display PostScript C
XAPI to the X distribution.  Implementing this API for Ghostscript might
Xmake Ghostscript a lot more useful, since it would then be "plug
Xcompatible" with Display PostScript in an important way.  Contact
Xghost@aladdin.com if you would like to help with this.
X
X	- On gray-scale displays, it might be worthwhile implementing
Xanti-aliased fonts.  To do this, one would modify the renderer so that it
Xcached a high-resolution bitmap, and then did the anti-aliasing as it
Xcopied the bitmap to the device.  This would allow simulating
Xfractional-pixel positioning, which is one of the great benefits of
Xanti-aliased fonts.  Contact ghost@aladdin.com if this is of interest to
Xyou.
X
X	- Ghostscript currently runs on Microsoft Windows 3.0 and 3.1 on
Xtop of MS-DOS, but does not yet run on Windows NT.  If you are interested
Xin helping port Ghostscript to run on Windows NT (presumably by getting it
Xto run using Win32/Win32s), please contact ghost@aladdin.com.
X
X********
X******** Authors ********
X********
X
XGhostscript was originally created, and is primarily developed and
Xmaintained, by L. Peter Deutsch, President of Aladdin Enterprises.
X
XSpecial thanks are due to Russell Lang, for the gsview (Ghostview for
XMicrosoft Windows) program and for contributing most of the code for the
XMicrosoft Windows environment, and to Tim Theisen, for the Ghostview
Xprogram for X Windows and for major contributions to the code for the X
XWindows environment.
X
XThe file helpers.doc contains a list of all the many other people who have
Xcontributed significantly to improving Ghostscript.
X
X- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
X
XPostScript is a trademark of Adobe Systems, Incorporated.
SHAR_EOF
$TOUCH -am 0531121793 README.ghostscript &&
chmod 0644 README.ghostscript ||
echo "restore of README.ghostscript failed"
set `wc -c README.ghostscript`;Wc_c=$1
if test "$Wc_c" != "13660"; then
	echo original size 13660, current size $Wc_c
fi
# ============= README.ghostview ==============
echo "x - extracting README.ghostview (Text)"
sed 's/^X//' << 'SHAR_EOF' > README.ghostview &&
X
X    Ghostview -- An X11 user interface for ghostscript.
X
XGhostview is full function user interface for ghostscript 2.4.
X
XBrief list of features:
X  - Ghostview parses any known version of Adobe's Document Structuring
X    Conventions.
X  - Page size is automatically determined from the Document Structuring
X    Comments.  The user is able to override the values from the comments.
X  - Window size is set to the bounding box for Encapsulated PostScript figures.
X  - Default page size is Letter and can be changed via Xresources or
X    application defaults file to A4 (or any other valid size) for our
X    European friends.
X  - Scrollbars appear when necessary.
X  - Page orientation is automatically determined from the Document Structuring
X    Comments.  The user is able to override the values from the comments.
X  - Ability to view at 4 orientations: Portrait, Landscape, Upside-down,
X    and Seascape (for those who rotate landscape the other direction).
X  - Ability to preview in any supported visual.  (Can preview in gray-scale 
X    or color on a Color monitor.)
X  - Ability to mark pages for printing, or saving.  (Good for people that
X    printed a 100 page document and lost page 59 due to a printer jam.)
X  - Can popup zoom windows at printer resolution
X    (1 display dot = 1 printer dot).
X
X    The Ghostview distribution includes a Ghostview Widget that people
X    are encouraged to use in other programs.
X
X    Ghostview-1.4 is available via anonymous ftp from:
X	prep.ai.mit.edu:/pub/gnu/ghostview-1.4.tar.Z
X	ftp.cs.wisc.edu:/pub/X/ghostview-1.4.tar.Z
X
X    This program is free software; you can redistribute it and/or modify
X    it under the terms of the GNU General Public License as published by
X    the Free Software Foundation; either version 2 of the License, or
X    (at your option) any later version.
X
X    This program is distributed in the hope that it will be useful,
X    but WITHOUT ANY WARRANTY; without even the implied warranty of
X    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
X    GNU General Public License for more details.
X
XBuilding ghostview:
X
X    If you have xmkmf, type "xmkmf", and then "make".
X    If not, manually edit the Makefile.
X
XFeedback
X
X    I welcome any feedback that you care to give.  Of course, I am interested
X    in your success stories.  I will also try to help you if you have problems.
X    However, I cannot make any promise of support.
X
X    Please send all feedback to ghostview@cs.wisc.edu.  This is a spare time
X    project and all the mail regarding ghostview must be directed to a
X    separate mail box otherwise your mail may very well get lost in the cracks.
X
XFrequently asked questions:
X
X    1.  Why does half the functionality of ghostview seem to be missing?
X	I cannot skip around in the document.  I cannot select pages to
X	print.  There are no page numbers in the table of contents.
X
X	The problem is that the document does not have the document
X	structuring comments.  Without them, ghostview cannot tell where
X	pages start and end.  Also, when reading from stdin there is no
X	capability to skip around.
X
X    2.  Whenever I ask ghostview to display a page, a separate ghostscript
X	window pops up and disappears when ghostscript is done rendering
X	the page.  How to I get ghostscript to write on the ghostview window?
X
X	You must be running ghostscript 2.4 or later for ghostview to work
X	properly.  You can pick up the current copy of ghostscript from
X	the same place you got ghostview.
X
X    3.  When I start ghostview, the information window pops up with:
X	"Warning: Could not allocate backing pixmap in main window."
X	What does this mean?
X
X	Ghostscript draws into a backing pixmap and copies from the
X	pixmap to the window.  Some X servers have limited resources for
X	pixmaps.  Creating the backing pixmap failed.  Ghostview will then 
X	request backing store on the window.  If the backing store request
X	is not honored, obscured portions of the window will be lost.
X
X	You might also request a smaller window by setting a smaller
X	magstep or setting a smaller resolution.
X
X    4.  When I start ghostview, sometimes I get this error:
X	"Error: SmeBSB Object: Left Bitmap of entry  "0" is not one bit deep.."
X	Other times it works.  What is going wrong?
X
X	The only time this problem occurs is when an OpenWindows X server
X	is the display.  It is likely a server problem.  I have placed a
X	work around in ghostview that turns off all use of bitmaps.  The
X	-openwindows option enables this work around.  However, with it
X	enabled the current magstep, orientation, and media cannot be
X	marked in the popup menus.
X
X    5.  Sometimes ghostview produces an endless stream of this message:
X	"Warning: Select failed; error code 9".
X
X	Users have reported that this occurs on machines with a SYSV
X	and BSD library.  The problem went away when they linked with the
X	BSD library rather than the default SYSV library.
X
X	This also occurs on some SPARCS running SunOS.  This does not happen
X	for me and must be due to some differences in libraries or environment.
X	I have placed a SPARC executable (compiled on SunOS 4.1 with X11R5pl10
X	libraries statically linked in) on ftp.cs.wisc.edu for people
X	in this situation.
X
X    6.  When using ncdwm, sometimes the window shrinks to an extremely
X	small size.
X
X	Either use the -ncdwm option to work around the problem, or apply
X	fix-10 to X11R5.
X
X    7.  Ghostview pops up the information window with the message
X	"Exec of gs failed".  It never displays anything in the main
X	viewport.  What went wrong?
X
X	Either ghostscript is not installed or it cannot be found in
X	your PATH.  Please pick up the latest copy of ghostcript from
X	the same place you got ghostview and install it.
X
XAcknowledgements
X
X    I really should put down the names of all the people who have given
X    me suggestions and encouragement.  (But I don't want to hold up the
X    release any longer. :-)
X
X    I do want to thank a few people.
X
X    - Karl Berry, for getting me into this mess :-) by soliciting for
X      volunteers.
X    - L. Peter Deutsch, for making ghostscript the good interpreter that
X      it is and for working with me to include modifications in support of
X      ghostview.
X    - Erik M. van der Poel, for writing a good publicly available file
X      selection widget that I was able incorporate into ghostview.
X    - Terry Poot, for porting ghostview to VMS.
X
XNOTE: PLEASE send all ghostview related mail to ghostview@cs.wisc.edu.
X
X          Tim Theisen           Systems Programmer
XInternet: tim@cs.wisc.edu       Department of Computer Sciences
X    UUCP: uwvax!tim             University of Wisconsin-Madison
X   Phone: (608)262-0438         1210 West Dayton Street
X     FAX: (608)262-9777         Madison, WI   53706
SHAR_EOF
$TOUCH -am 0531121793 README.ghostview &&
chmod 0444 README.ghostview ||
echo "restore of README.ghostview failed"
set `wc -c README.ghostview`;Wc_c=$1
if test "$Wc_c" != "6717"; then
	echo original size 6717, current size $Wc_c
fi
exit 0
