This is the README file for the deckmate package.
Information about the latest version is in the NEWS file.
This package contains a program to convert a legacy
program from an 80 column card deck to a PostScript file.
It can also print old program listings and even FORTRAN
output that uses line printer carriage controls on
80- or 132-column output.
Samples in the "examples" directory contain source files
for COBOL, FORTRAN IV, RPG, ISO-IR-68 encoded APL, IBM 370
assembler, and PDP-11 MACRO-11 assembler; see the AUTHORS
file for a description of these input sources. The PostScript
files in that directory, ending with ".ps", were all produced
by the deckmate program. They are compared with regenerated
PostScript files during a "make check" operation. The PDF
files, ending with ".pdf", were created with the ps2pdf(1)
utility; see examples/Makefile for the options that created
the output files.
QUICK START
-----------
To configure, compile, and install deckmate and its associated
man page, deckmate.1, execute the following commands:
./configure
make
make check
make install
make clean
The "make check" command is optional. It will run several
tests using the version of deckmate compiled on your system.
After running "make install" (which may have to be run in
sudo mode), the installed package can be checked against
the reference files in the "examples" directory with
make installcheck
The "make clean" command is also optional. It will remove
some intermediate files created during the build process.
For a more detailed discussion of build options, see the
INSTALL file.
LICENSE
--------
The license for all program files except the three font files
(src/font_cardpunch.c, src/font_dotwriter.c, and src/font_dotwriterapl.c)
is contained in the COPYING file. A summary of the license appears below.
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, see <http://www.gnu.org/licenses/>.
The license for the three font files (src/font_cardpunch.c,
src/font_dotwriter.c, and src/font_dotwriterapl.c) is contained
in the SIL/OFL.txt file in this source distribution package.