diff options
Diffstat (limited to 'support/hypertex/tanmoy/ghostview-1.5-hacked/README')
-rw-r--r-- | support/hypertex/tanmoy/ghostview-1.5-hacked/README | 177 |
1 files changed, 177 insertions, 0 deletions
diff --git a/support/hypertex/tanmoy/ghostview-1.5-hacked/README b/support/hypertex/tanmoy/ghostview-1.5-hacked/README new file mode 100644 index 0000000000..05c1deb63d --- /dev/null +++ b/support/hypertex/tanmoy/ghostview-1.5-hacked/README @@ -0,0 +1,177 @@ +/* This file is part of the hacked version of the ghostview package */ +/* which is distributed under the terms of the gnu license. The */ +/* modification referred to above is by Tanmoy Bhattacharya, */ +/* <tanmoy@qcd.lanl.gov> on Nov 17, 1994. Neither the modification, */ +/* nor the original program provides any warranty. */ + +/* Last Modification: Dec 1 1994, 10:47 */ + + Ghostview -- An X11 user interface for ghostscript. + +Ghostview is full function user interface for ghostscript 2.4 and +later. This distribution is modified to support the pdfmark operator. + +Brief list of features: + - Ghostview parses any known version of Adobe's Document Structuring + Conventions. + - Page size is automatically determined from the Document Structuring + Comments. The user is able to override the values from the comments. + - Window size is set to the bounding box for Encapsulated PostScript figures. + - Default page size is Letter and can be changed via Xresources or + application defaults file to A4 (or any other valid size) for our + European friends. + - Scrollbars appear when necessary. + - Page orientation is automatically determined from the Document Structuring + Comments. The user is able to override the values from the comments. + - Ability to view at 4 orientations: Portrait, Landscape, Upside-down, + and Seascape (for those who rotate landscape the other direction). + - Ability to restrict rendering to grayscale or monochrome. (Requires + ghostscript 2.6.1.) + - Ability to mark pages for printing, or saving. (Good for people that + printed a 100 page document and lost page 59 due to a printer jam.) + - Can popup zoom windows at printer resolution + (1 display dot = 1 printer dot). + - Handles pdfmark operator. (alpha release) + + The Ghostview distribution includes a Ghostview Widget that people + are encouraged to use in other programs. + + Original (without pdfmark support) Ghostview-1.5 is available via + anonymous ftp from: + prep.ai.mit.edu:/pub/gnu/ghostview-1.5.tar.gz + ftp.cs.wisc.edu:/pub/X/ghostview-1.5.tar.gz + Modified ghostview-1.5 (this release) available from + http://nqcd.lanl.gov/people/tanmoy/hypertex/ghostview-1.5-hacked.tar.gz + + 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. + +Building ghostview: + + Set the ghostscript inputs directory in Imakefile. + If you have xmkmf, type "xmkmf", and then "make". + If not, manually edit the Makefile. + + +The following is unchanged from what came with the original +Ghostview. Please notice that the pdfmark project has been spliced in +by tanmoy@qcd.lanl.gov. Please do not bother Tim Theisen about +problems relating to that. + +--------------- original --------------- +Feedback + + I welcome any feedback that you care to give. Of course, I am interested + in your success stories. I will also try to help you if you have problems. + However, I cannot make any promise of support. + + Please send all feedback to ghostview@cs.wisc.edu.<SEE MODS> This is a spare time + project and all the mail regarding ghostview must be directed to a + separate mail box otherwise your mail may very well get lost in the cracks. + +Frequently asked questions: + + 1. Why does half the functionality of ghostview seem to be missing? + I cannot skip around in the document. I cannot select pages to + print. There are no page numbers in the table of contents. + + The problem is that the document does not have the document + structuring comments. Without them, ghostview cannot tell where + pages start and end. Also, when reading from stdin there is no + capability to skip around. + + 2. Whenever I ask ghostview to display a page, a separate ghostscript + window pops up and disappears when ghostscript is done rendering + the page. How to I get ghostscript to write on the ghostview window? + + You must be running ghostscript 2.4 or later for ghostview to work + properly. You can pick up the current copy of ghostscript from + the same place you got ghostview. + + 3. When I start ghostview, the information window pops up with: + "Warning: Could not allocate backing pixmap in main window." + What does this mean? + + Ghostscript draws into a backing pixmap and copies from the + pixmap to the window. Some X servers have limited resources for + pixmaps. Creating the backing pixmap failed. Ghostview will then + request backing store on the window. If the backing store request + is not honored, obscured portions of the window will be lost. + + You might also request a smaller window by setting a smaller + magstep or setting a smaller resolution. + + 4. When I start ghostview, sometimes I get this error: + "Error: SmeBSB Object: Left Bitmap of entry "0" is not one bit deep.." + Other times it works. What is going wrong? + + The only time this problem occurs is when an OpenWindows X server + is the display. It is likely a server problem. I have placed a + work around in ghostview that turns off all use of bitmaps. The + -openwindows option enables this work around. However, with it + enabled the current magstep, orientation, and media cannot be + marked in the popup menus. + + 5. Sometimes ghostview produces an endless stream of this message: + "Warning: Select failed; error code 9". + + Users have reported that this occurs on machines with a SYSV + and BSD library. The problem went away when they linked with the + BSD library rather than the default SYSV library. + + This also occurs on some SPARCS running SunOS. This does not happen + for me and must be due to some differences in libraries or environment. + I have placed a SPARC executable (compiled on SunOS 4.1 with X11R5pl10 + libraries statically linked in) on ftp.cs.wisc.edu for people + in this situation. + + 6. When using ncdwm, sometimes the window shrinks to an extremely + small size. + + Either use the -ncdwm option to work around the problem, or apply + fix-10 to X11R5. + + 7. Ghostview pops up the information window with the message + "Exec of gs failed". It never displays anything in the main + viewport. What went wrong? + + Either ghostscript is not installed or it cannot be found in + your PATH. Please pick up the latest copy of ghostcript from + the same place you got ghostview and install it. + +Acknowledgements + + I really should put down the names of all the people who have given + me suggestions and encouragement. (But I don't want to hold up the + release any longer. :-) + + I do want to thank a few people. + + - Karl Berry, for getting me into this mess :-) by soliciting for + volunteers. + - L. Peter Deutsch, for making ghostscript the good interpreter that + it is and for working with me to include modifications in support of + ghostview. + - Erik M. van der Poel, for writing a good publicly available file + selection widget that I was able incorporate into ghostview. + - Terry Poot, for porting ghostview to VMS. + +NOTE: PLEASE send all ghostview related mail to ghostview@cs.wisc.edu.<SEE MODS> + +...Tim + + Tim Theisen Associate Researcher +Internet: ghostview@cs.wisc.edu Department of Computer Sciences + UUCP: uwvax!ghostview University of Wisconsin-Madison + Phone: (608)262-0438 1210 West Dayton Street + FAX: (608)262-9777 Madison, WI 53706-1685 +----------- + +Send mail about pdfmark support to tanmoy@qcd.lanl.gov. |