
               jpeg2pdf - Convert a bunch of JPEG files to a PDF

   Version:
          0.12

   Date:
          2004-10-18

Description

   jpeg2pdf is a free program that converts a directory of JPEG files to
   a PDF file.

Features

   jpeg2pdf has the following features:
     * jpeg2pdf is fast. Unlike ImageMagick or other general image
       conversion tools, jpeg2pdf is specialized for its task an does
       this very efficiently.
     * jpeg2pdf generates compact PDF files. Unlike general image
       conversion tools, jpeg2pdf doesn`t do any processing/rescaling of
       the images, nor does it generate thumbnails of the pages in the
       PDF file.
     * jpeg2pdf is cross-platform. It works on any platform the Ruby
       programming environment runs on. This includes Windows
       95/98/NT/XP, GNU/Linux, Mac OS X, Solaris, AIX, OS/2 and DOS.
     * jpeg2pdf is a command-line program. So it can very easily be
       integrated in a shell script or a web server process to automate a
       conversion task.
     * jpeg2pdf is free. You can download it and use it for free.

Download

   The latest version of jpeg2pdf can be obtained in the following
   formats:

   ZIP
          http://koan.studentenweb.org/software/jpeg2pdf-0.12.zip (30
          kB)

   gzipped tar
          http://koan.studentenweb.org/software/jpeg2pdf-0.12.tgz (20
          kB)

   bzipped tar
          http://koan.studentenweb.org/software/jpeg2pdf-0.12.tar.bz2
          (18 kB)

Installation

   Unpack the downloaded package and install jpeg2pdf with the following
   command from its directory:
# ruby install.rb

   This command may require root privileges.

   This assumes you have Ruby installed. Ruby can be found at
   http://www.ruby-lang.org/en/20020102.html.

Usage

   jpeg2pdf is invoked from the command-line using:
% jpeg2pdf [options] <directory> <pdf>

   <directory> is the name of the directory containing the JPEG files
   which should be converted. <pdf> is the name of the PDF file which has
   to be generated.

   The options are:

   -r, --recursive
          Process directories recursively. Without this option, jpeg2pdf
          doesn`t process JPEG files in subdirectories of the specified
          directory.

   -a, --all
          Process all files, including hidden files (files whose name
          begins with a dot (".")). Without this option, jpeg2pdf doesn`t
          process hidden files.

   -v, --verbose
          Give more output. This shows the name of each processed image
          on the screen.

   -h, --help
          Give usage information.

   -V, --version
          Show the version number of jpeg2pdf.

   All files in <directory> will be checked, and if it`s a JPEG file, it
   will be added to the PDF. They will be added in the alphabetical order
   of the filenames. If the recursive option is used, directories will be
   processed and this will happen in alphabetical order, together with
   the files. E.g. with a file named "E.jpeg", a directory named "F" with
   files "A.jpeg" and "B.jpeg", and a file "G.jpeg", the files will be
   processed in this order: "E.jpeg", "F/A.jpeg", "F/B.jpeg" and
   "G.jpeg".

   Note: jpeg2pdf doesn't look at the file extension, such as .jpeg or
   .jpg, to find JPEG images. So, even a JPEG file without extension, or
   with a wrong extension, is recognized by jpeg2pdf.

Support

   The jpeg2pdf homepage is located at
   http://koan.studentenweb.org/software/jpeg2pdf.html. Feel free to
   submit feature requests or bug reports. You can email the author at
   koen.vervloesem@myrealbox.com.

Acknowledgments

   Thanks to:

   Filip Vervloesem
          who gave me the inspiration to write jpeg2pdf because he didn`t
          find any decent program for this task.

   Ewoud Nuyts
          for some bugfixes and his urge to make it able to handle
          thousands of JPEG files very efficiently.

License

   Copyright (c) 2004 Koen Vervloesem. All rights reserved.

   Permission is hereby granted, free of charge, to any person obtaining
   a copy of this software and associated documentation files (the
   "Software"), to deal in the Software without restriction, including
   without limitation the rights to use, copy, modify, merge, publish,
   distribute, and/or sell copies of the Software, and to permit persons
   to whom the Software is furnished to do so, provided that the above
   copyright notice(s) and this permission notice appear in all copies of
   the Software and that both the above copyright notice(s) and this
   permission notice appear in supporting documentation.

   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
   EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
   MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
   OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
   HOLDERS INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY
   SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER
   RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF
   CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
   CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

   Except as contained in this notice, the name of a copyright holder
   shall not be used in advertising or otherwise to promote the sale, use
   or other dealings in this Software without prior written authorization
   of the copyright holder.

  Adobe Intellectual Property

   This software is based on Adobe`s PDF Reference, Fourth Edition,
   describing the Adobe Portable Document Format, Version 1.5. There may
   be limitations on the use of this program based on intellectual
   property restrictions from Adobe.

Copyright

   Author:
          Koen Vervloesem <koen.vervloesem@myrealbox.com>

   Copyright:
          Copyright (c) 2004 Koen Vervloesem. All Rights Reserved.

   License:
          X11 License
