root/paper-tape-project/trunk/userspace-driver/README.txt

   The Paper Tape Project -- Userspace punch driver
   ================================================

   This is a linux ppdev driver for the FACIT 4070 Tape punch-75 CPS
   paper tape puncher (parallel port). The file puncher.c implements
   this driver.
   After connecting the puncher to the computer and before switching
   it on, you must run setoff-strobe[.c], otherwise it will directly
   start punching like an idiot.

   The usage of puncher[.c] is quite simple:

     $ cat files-to-punch | ./puncher

   of course you need the ppdev driver in your linux kernel. Make sure
   /dev/parport0 exists or search for ``#define PARPORT_DEVICE'' in
   the file puncher.c and fix it so it matches your parport device.

     # modprobe ppdev
     # chmod 777 /dev/parport0

   Call ./puncher -h to get some help about the usage. The setoff-strobe
   program does not accept any arguments. The usage of the puncher
   binary is not very comfortable -- but there's a very nice interactive
   perl frontend which is even capable of generating labels for your
   paper tapes:

     $ ./puncher-frontend.pl files-to-punch
     
   It will manage the call of the puncher binary and make it possible
   get nice progress output on stdout.

   Copyright (C) 2007, 2008 Sven Köppel

   The userspace driver 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 3 of the License, or (at
   your option) any later version.

   The driver 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/>.