--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README	Thu Aug 29 13:58:17 2013 +0200
@@ -0,0 +1,53 @@
+pdfconcat
+---------
+
+This program concatenates PDF files and optionally converts text
+within them into bitmaps. The concatenation is done with Ghostscript (gs);
+the detextification is done with a gs-conversion to tiff and tiff2pdf
+(package libtiff-tools) afterwards. Detextification is only in gray-scale.
+
+
+Contents:
+
+- bin/pdfconcat		shell script to concatenate PDF files
+- bin/pdfdetextify	shell script to convert text to images in PDF files
+- pdfconcat.php		web interface to invoke the scripts
+
+- log			log file of web interface invocations (writable)
+- bin/monthly		shell script to sum up the usage by month
+
+- upload/		directory to store the converted files (writable)
+- bin/cleanup.cron	helper script to remove old uploaded files
+
+- .user.ini		php config file to increase the max upload file size
+
+
+Installation:
+
+You need a Unix system. Ensure you have gs and tiff2pdf (in the package
+libtiff-tools) available.
+
+To use the bin/pdf* tools on the command line only, copy them to your $PATH
+and make them executable.
+
+To set up the program including the web interface, copy the files to a place
+below the webserver root. Make bin/pdf{concat,detextify} executable for
+www-data. Make the log and the upload directory writable by www-data. Install
+a cronjob to clean up the upload directory. Ensure that the max upload file
+size of PHP is large enough.
+
+
+More or less helpful information sources on the PDF conversion:
+
+	http://stackoverflow.com/questions/6002261/pdf-to-tiff-imagemagick-problem
+	http://www.asmail.be/msg0055376363.html
+	http://kvz.io/blog/2007/11/28/php-tiff2pdf/
+	http://phpdave.wordpress.com/tag/php-pdf-to-tiff/
+
+
+2013, markus schnalke <meillo@marmaro.de>
+Written at KIT-Library, Karlsruhe.
+
+This program is in the public domain. -- Dieses Programm hat nicht die
+notwendige Schoepfungshoehe um urheberrechtlich geschuetzt zu sein. If
+you though need a license, use it under the CC0 license.