added README, INSTALL.
This commit is contained in:
Eric Smith
18
INSTALL
Normal file
18
INSTALL
Normal file
@@ -0,0 +1,18 @@
|
||||
tumble: build a PDF file from image files
|
||||
Copyright 2003 Eric Smith <eric@brouhaha.com>
|
||||
$Id: INSTALL,v 1.1 2003/03/16 07:37:16 eric Exp $
|
||||
|
||||
Tumble requires libtiff, which in turn requires libjpeg and libz:
|
||||
|
||||
http://www.libtiff.org/
|
||||
http://www.???.org */
|
||||
|
||||
Building Tumble requires GNU Make, GCC, Bison, and Flex, all of which are
|
||||
free software provided by the Free Software Foundation. These are provided
|
||||
as part of most Linux distributions, and are also avaiable for many other
|
||||
operatng systems. See the FSF web site for more information
|
||||
|
||||
http://www.gnu.org/
|
||||
|
||||
The supplied Makefile should work on most systems with only minor
|
||||
modifications.
|
||||
8
Makefile
8
Makefile
@@ -1,6 +1,6 @@
|
||||
# tumble: build a PDF file from image files
|
||||
# Makefile
|
||||
# $Id: Makefile,v 1.32 2003/03/14 00:24:37 eric Exp $
|
||||
# $Id: Makefile,v 1.33 2003/03/16 07:37:16 eric Exp $
|
||||
# Copyright 2001, 2002, 2003 Eric Smith <eric@brouhaha.com>
|
||||
#
|
||||
# This program is free software; you can redistribute it and/or modify
|
||||
@@ -35,6 +35,8 @@ LDLIBS = -ltiff -ljpeg -lz -lm
|
||||
ifdef DEBUG
|
||||
CFLAGS := $(CFLAGS) -g
|
||||
LDFLAGS := $(LDFLAGS) -g
|
||||
else
|
||||
CFLAGS := $(CFLAGS) -O3
|
||||
endif
|
||||
|
||||
ifdef EFENCE
|
||||
@@ -55,7 +57,7 @@ YFLAGS = -d -v
|
||||
# let me know why so I can improve this Makefile.
|
||||
# -----------------------------------------------------------------------------
|
||||
|
||||
VERSION = 0.27
|
||||
VERSION = 0.28
|
||||
|
||||
PACKAGE = tumble
|
||||
|
||||
@@ -69,7 +71,7 @@ CSRCS = tumble.c semantics.c \
|
||||
OSRCS = scanner.l parser.y
|
||||
HDRS = tumble.h semantics.h bitblt.h bitblt_tables.h \
|
||||
pdf.h pdf_private.h pdf_util.h pdf_prim.h pdf_name_tree.h
|
||||
MISC = COPYING Makefile
|
||||
MISC = COPYING README INSTALL Makefile
|
||||
|
||||
DISTFILES = $(MISC) $(HDRS) $(CSRCS) $(OSRCS)
|
||||
DISTNAME = $(PACKAGE)-$(VERSION)
|
||||
|
||||
69
README
Normal file
69
README
Normal file
@@ -0,0 +1,69 @@
|
||||
tumble: build a PDF file from image files
|
||||
Copyright 2003 Eric Smith <eric@brouhaha.com>
|
||||
$Id: README,v 1.1 2003/03/16 07:37:16 eric Exp $
|
||||
|
||||
Tumble is a utility to construct PDF files from one or more image
|
||||
files. Currently the only input image format supported is black &
|
||||
white TIFF files, which may be either single- or multi-page files. In
|
||||
the future additional file formats will be supported, including gray
|
||||
scale and color. Black and white images will be encoded in the PDF
|
||||
output using lossless Group 4 fax compression (ITU-T recommendation
|
||||
T.6). This provides a very good compression ratio for text and line
|
||||
art.
|
||||
|
||||
The current version of Tumble will only work on little-endian systems,
|
||||
such as x86, VAX, and Alpha. The byte order dependencies will be fixed
|
||||
in a later release.
|
||||
|
||||
The input and output files can be specified on the command line.
|
||||
Alternatively, a control file, typically with a ".tum" suffix, may be
|
||||
used which allows for more control over the files and options.
|
||||
|
||||
The general command line syntax is:
|
||||
|
||||
tumble [options] <input.tif>... -o <output.pdf>
|
||||
|
||||
The options in this mode are:
|
||||
|
||||
-v verbose
|
||||
-b <fmt> create bookmarks
|
||||
|
||||
If the "-b" option is given, bookmarks will be created using the
|
||||
format string, which may contain arbitrary text and/or the following
|
||||
format specifiers:
|
||||
|
||||
%F file name, sans suffix e.g., "foo.tif" will just appear as "foo"
|
||||
%p page number of input file, useful for multipage TIFF files
|
||||
|
||||
There is currently no documentation for the control file syntax, as it
|
||||
is still being refined, and many of the options planned for use in
|
||||
control files are not yet fully implemented. Features that will be
|
||||
available in control files include:
|
||||
|
||||
image resolution specification - useful for input files with
|
||||
unspecified resolution, or to override
|
||||
image rotation, in units of 90 degrees
|
||||
image cropping
|
||||
grouping to allow different specifications for individual pages
|
||||
or groups of consecutive pages (e.g., chapters)
|
||||
ability to control operations independently on even and odd pages
|
||||
(e.g., different rotation or cropping)
|
||||
more flexible bookmark control
|
||||
page labels, so that the PDF file can present the actual document
|
||||
page numbers such as xvii or 3-27
|
||||
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License version 2 as
|
||||
published by the Free Software Foundation. Note that permission is
|
||||
not granted to redistribute this program under the terms of any other
|
||||
version of the General Public License.
|
||||
|
||||
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 USA
|
||||
Reference in New Issue
Block a user