CanonUtil
---------

CanonUtil is a little maintenance tool for Canon BJC printers.

In order to build CanonUtil you need fltk 1.1.x, openMotif/Lesstif,
or Qt 3.1 and KDE.

This package may be on the CDROM/DVD for your favorite distribution,
you can also download fltk from http://www.fltk.org, openMotif
(my preferred toolkit) from http://www.openmotif.org  and
lesstif from http://www.lesstif.org.

The Qt toolkit and the KDE extention are expected to be the original as
supplied by Mandrake, RedHat or SuSE. For other distribution you
must probably modify the Makefile.

If you want the Motif version I recommand that you use openMotif
or a true Motif. Lesstif has a lot of little bugs and deficiencies.
I have modified the code in such an way that the application work
with lesstif but some features are not available.

I expect that the tool will work with Motif 1.2 and higher as
well as with old and newer versions of Lesstif.

Build CanonUtil
---------------

1) generate the file config.mk with
- sh ./configure
   On SuSE 8.2 "./configure" don't work I get bad interpreter: no rights
   For Mdk and RH no problems if I omit sh !
or
- sh ./configure -p /usr

2) compile
- make fltk
or
- make motif
or
- make qt
or
- make kde

3) install
This require that you are logged as root if you need reading
of the printer state.

- make install-fltk
or
- make install-motif
or
- make install-qt
or
- make install-kde

Remarks
-------

CanonUtil expect to send some commnads via the LP system. Installing
of CUPS is required for this.
Alternatelly, if CUPS is not installed, or no "printer" are configured,
CanonUtil will attempd to send the commands directly to the device file.

Getting the status from printer, require a bidirectional communication
and read/write access to the device file. This is not available on
all OS.

Use of the KDE supplement is not recommanded, the application
need more time for starting and don't present any advantage over
the QT version.

On SuSE 9.0 the fltk GUI may not be linked. This appear on one
system but not on an other. I order to remidy to this you may
mofify the file config.mk by changing the lines:

   GLDFLAGS = -lGLU -lGL -lfltk_gl
   GCFLAGS = -DHAVE_GL=1
to
   GLDFLAGS =
   GCFLAGS = -DHAVE_GL=0

Internatiolization:
-------------------

The textes printed on the GUI can be translated and printed out
in your prefered language.
The resource files are under the directory lib and there name
is CanonUtil_<ll>.res where <ll> is the first 2 characters from
the variable LANG.
The textes may consist of more as one line, the "\n" string tell
CanonUtil that a new line is to be inserted.
You may also write the textes on more as a line in the resource file.
"\" at the end of a line tell that the resource text will continue
on the next line.
If you use Motif, you may print out some part of the text in bold
with "<b>" and normal "<n>".
The "<b>" and "<n>" strings are removed during the installation process
if the choosed GUI is not Motif. This don't work with lesstif which is
very buggy.

DEC-28-2003

Jean-Jacques Sarton
jj.sarton@t-online.de
http://xwtools.automatix.de