Please see the info file for program documentation.

Installation hints:

  * You need the towitoko library version 2.0.2 or higher.
    If you have a CT-API for a different card reader, see below.

    If you have a Towitoko card reader, but don't have the library,
    then you can get it either at the maintainer's site:
    
	http://www.geocities.com/cprados/

    Or from my site, since I don't trust GeoCities' reliability. :-)

	http://www.lionking.org/~kianga/software/smartcard/

    The former site should be more up to date, of course.

  * If configure complains about a missing CT-API library or missing
    header files, check if these libraries are in the standard search
    path of your compiler and/or linker. Unfortunately, configure
    seems to ignore all CFLAGS when testing for libraries. I feel this
    is a bug, but whatever it is, you can fix the problem by
    temporarily linking ctapi.h and ctbcs.h to /usr/include. I know
    this is ugly, but at least it works. You can remove the links after
    compiling if you wish.

  * If you don't have the towitoko CT-API library but a CT-API for a
    different reader, you might have a chance to get smartcard to work
    if you replace the line in configure.in that says:

	AC_CHECK_LIB(towitoko, CT_init, [],

    with something that references your own library, like this:

	AC_CHECK_LIB(my-ctapi, CT_init, [],

    After this you must run ./reconf and ./configure again. The reason
    why I haven't implemented this with a option to the configure
    script is simple: I don't know how -- this is my first serious
    program using autoconf. Any suggestions would be very appreciated
    though. :)

    Good luck!

  * I do not have a lot of experience with smart card readers. I
    bought a Towitoko Smart Card Reader some time ago, and didn't
    find any usable software for it under Linux, so I wrote my own.

    I used two articles from the German c't Magazine as well as a
    few examples from existing programs (mostly the tester program
    that came with the towitoko library). Other than that, I found
    practically *no* documentation on the protocols used here. So
    don't expect too moch from this program -- it is still in a
    fairly experimental state. Any help or comments are highly
    appreciated.

    If you would like to help, please take a look at the TODO file.
