        README
                        2004.9.8     

                        Copyright (C) Hidetoshi Nakano
                        Last Modified: 2004-09-08
                        First Release: 2004-07-28
                        URL   :http://lpy.sourceforge.net/
                        E-mail:lpy@DesignAndCommunication.co.jp

About lpy
Lpy is a printing tool with GUI interface written in python.

Now many printers have a lot of functions(Duplex,Nup,Staple,Booklets,etc)
and is more smallsized,more inexpensive.
But in Linux(UNIX-like OS) these functions are hardly avaliable.
The aim of lpy is to make your Multifunction-Printer(a optional Finisher) avaliable.


1. independent of a spooler and a application software in user space.
    Any filter of a printing spooler isn't necessary. 
2. a frontend of GNU a2ps that converts a text-file to a PS-file.
3. a printing filter that uses a GS(Ghostscript)
4. written in Python and PyGTK for GUI(Graphical User Interface)
5. uses SNMP(PrinterMIB) if possible
    for getting printer informations(Errors and Status)
6. supports PJL commands if possible.
    Now some PJL commands are supported. 
7. available in UNIX-like OS(Linux,FreeBSD and Solaris,HP-UX,etc)
                   

Requirements
    1:Python 2.2 and above
    2:GTK and PyGTK
      PyGTK 2.0 and above
    3:GNU a2ps   
    4:file
    5:Ghostscript
    6:Psutils
    7:convert (ImageMagick)
    8:other
        LaTeX: texi2dvi,texi2dvi4a2ps,dvips
        nroff: grog,groff
 
Install
    tar xvf lpy-x.x.tar.gz  (x.x = Version-number)
    cd lpy-x.x
    python setup.py build
    sudo python setup.py install
    lpy      (Program start)

    Uninstall
        sudo python setup.py uninstall

Manual
    1:setup a printer in your system.
      It is very important not to use any filter in spooler !!   
      select "Raw Print Queue" or "Text Only Printer" in printer model.

    2:start lpy
        select "setup" Menu.
            select your printer model,duplex,optional device.

    3:Please enjoy to use lpy.

Usage
    lpy
    lpy filename
    lpy --help

    BSD prining system(Linux,FreeBSD)
      lpy -P myprinter filename
      lpy -P myprinter -#3 filename

    System V prining system(Solaris,HPUX)
      lpy -d myprinter filename

    Don't mix lpr and lp parameters.
        lpy -d myprinter -#3 filename (ERROR)


Troubleshooting
    A:lpstat command
        if a error of "lpstat" command occurs, wait timeout.

