DeckView - A browser for Postscript documents. Version 1.0, BETA 1 This file describes the DeckView document browser and details the process of installing it. Note that DeckView is BETA SOFTWARE and contains a number of known flaws. It may be redistributed and/or modified under the terms of the GNU General Public License from the Free Software Foundation; see the copyright notice at the end of this document for details. The license itself should be available in the file "COPYING". DeckView is distributed WITHOUT ANY WARRANTY, not even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for details. DeckView is BETA SOFTWARE. It has a number of known problems, and some input files may not work well. More importantly, DeckView can save bookmark and annotation information as comments in the document file itself. During this process, it maintains the original file as a backup. However, since DeckView has not been sufficiently tested on a wide range of documents, be sure to use it only with document copies, not irreplacable originals, in case problems arise. BUILDING DECKVIEW Several components are required for building and using DeckView: - X Window System (X11R5 or higher) development libraries, including libXmu.a. - The OSF/Motif toolkit, version 1.2 or higher. - Ghostscript, version 2.4 or later. - A C++ compiler with the iostream library. In particular, DeckView can be compiled with gcc 2.7/libg++, and probably with other C++ compilers as well. - The XPM library. This is included with the X11R6 distribution, and can be obtained via anonymous FTP from ftp.x.org/contrib. Ghostscript, gcc, and libg++ can be obtained via anonymous FTP from prep.ai.mit.edu:/pub/gnu or any GNU software mirror site. In addition, Ghostview 1.5 is recommended, as DeckView will launch it when it encounters a file that does not conform to Adobe's Document Structuring Conventions. In addition to the above, DeckView uses subsets of the NIH Class Library and Ghostview 1.5. These subsets are included in the directories ./nihcl and ./ghostview, and built as part of the DeckView make process. For most information, see the README files in these directories. To build DeckView, first edit the configuration section of the Makefile, which specifies paths to the various libraries and tools. Examine the files resources.h and fallback.h, which contain application resources, and change the defaults if necessary. This should only be required if Ghostscript and Ghostview (optional) are not installed in /usr/local/bin. Type "make depend" to add dependencies to the Makefiles (optional). Then type "make" to build DeckView. USING DECKVIEW This section will be expanded in future releases, perhaps as a separate document. For now, it provides only a general outline for getting started. DeckView is a browser for Postscript files that conform to Adobe's Document Structuring Conventions. This includes most text documents created within the last few years, but some older documents may not be designed accordingly. When loading a file that does not conform to the DSC, DeckView offers to view it with Ghostview; the usual interface is not available. For DSC-compliant documents, DeckView displays a window with two panes. The left side of the window contains three columns. Thumbnail images of the document pages are aligned vertically in the center column, and the other two are empty. The right side of the window displays a larger view of the current page. By clicking on or dragging through the thumbnail images, the user can quickly scan the document and jump to a particular page. Dragging with the middle button on a thumbnail image lifts a copy out of the center column; it can be dropped to either side column where it remains as a bookmark. Similarly, dragging with the middle button from the "Annotation" source at the bottom of the screen yields a new annotation icon that can be placed anywhere on the current page. When the icon is dropped, it creates a dialog box with fields for a name, annotation text, and hyperlink destination. Any and all of the fields are optional; thus the icons can be used to create markers, off-screen annotations, hyperlinks, or a combination of these. To create a hyperlink, either drag an existing icon from the document to the destination field, or drag from the destination field to the document, creating a new icon as the link destination. When the document is closed, DeckView offers to save the bookmarks in the left ("persistent") column and the document annotations. These are added to the document file as comments for future use (see the warning at the top of this file). ACKNOWLEDGEMENTS DeckView itself incorporates large components from two software works. In particular, I would like to thank: Keith Gorlen, developer of the NIH Class Library, which provides container classes for DeckView. Tim Theisen, author of Ghostview, whose Ghostview widget and DSC parser are included verbatin from the Ghostview 1.5 release. COPYRIGHT DeckView Version 1.0, BETA 1 Copyright (C) 1996 Adam Ginsburg Design by Adam Ginsburg, Joe Marks, and Stuart M. Shieber 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 Author: Adam Ginsburg Aiken G-20 33 Oxford Street Cambridge, MA 02138 USA Comments and bug reports to: deckview@eecs.harvard.edu