Imported Upstream version 4.2.0

1 files changed, 129 insertions, 0 deletions

diff --git a/man/escputil.1.in b/man/escputil.1.in
new file mode 100644
index 0000000..f7d9d61
--- /dev/null
+++ b/man/escputil.1.in
@@ -0,0 +1,129 @@
+'\" t
+.\" $Id: escputil.1.in,v 1.4 2001/08/13 23:59:12 rlk Exp $
+.\" Copyright (C) 2000 Robert Krawitz <rlk@alum.mit.edu>
+.\"
+.\" This program 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 2, or (at your option)
+.\" any later version.
+.\"
+.\" This program 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, write to the Free Software
+.\" Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+.hy 0
+.TH ESCPUTIL 1 "@RELEASE_DATE@" "Version @GIMPPRINT_VERSION@" "GIMP Manual Pages"
+.SH NAME
+escputil - maintain Epson Stylus inkjet printers
+.SH SYNOPSIS
+.B escputil [\-P printer \| \-r device] [\-m model] [\-u]
+[\-c \| \-n | \-a \| \-i] [\-q]
+
+.SH DESCRIPTION
+.PP
+\fIescputil\fP is a command line utility to perform various
+maintenance tasks on Epson Stylus inkjet printers.  These tasks
+include head alignment, head cleaning, nozzle check, printer
+identification, and retrieval of ink level from the printer.
+
+.SH OPTIONS
+.l
+\fIescputil\fP accepts the following options:
+.TP 8
+.B \-P, \-\-printer-name \fI<printer>\fP
+Specify the name of the printer to operate on.
+Default is the default system printer.
+.TP 8
+.B \-r, \-\-raw-device \fI<device>\fP
+Specify the name of the device to write to directly
+rather than going through a printer queue. You must use this (rather
+than specifying a printer) when retrieving ink levels or identifying
+the printer, or if you wish to perform head alignment without
+specifying the printer model.
+.TP 8
+.B \-c, \-\-clean-head
+Clean the print head.  This can also be performed from the printer
+front panel.
+.TP 8
+.B \-n, \-\-nozzle-check
+Print a nozzle test pattern.  Dirty or clogged nozzles will show as
+gaps in the pattern.  If you see any gaps, you should run a
+head cleaning pass or two.
+.TP 8
+.B \-a, \-\-align-head
+Align the print head.  CAUTION: Misuse of this utility may result in
+poor print quality and/or damage to the printer.  You must either
+specify the printer model with the \-m option, or use the raw printer
+device to allow escputil to detect the printer model.
+.TP 8
+.B \-i, \-\-ink-level
+Obtain the ink level from the printer.  This requires
+read/write access to the raw printer device.
+.TP 8
+.B \-d, \-\-identify
+Query the printer for make and model information.
+This requires read/write access to the raw printer
+device.
+.TP 8
+.B \-u
+The printer is connected via USB.
+.TP 8
+.B  \-h, \-\-help
+Display a list of all commandline options.
+.TP 8
+.B \-q, \-\-quiet
+Suppress the banner.
+.TP 8
+.B \-m <model>
+Specify the precise printer model for head alignment.
+
+.SH COPYRIGHT
+Copyright \(co  2000 Robert Krawitz (rlk@alum.mit.edu)
+
+This program 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 2 of the License, or (at your option)
+any later version.
+
+.SH OTHER INFO
+
+The canonical place to find GIMP info is at http://www.gimp.org/.
+The homepage of the gimp-print project from which this utility was
+contributed is located at http://gimp-print.sourceforge.net/.
+
+.SH AUTHORS
+Robert Krawitz.
+
+.SH BUGS
+
+.PP
+USB-connected printers sometimes fail to identify or return ink
+levels.  You may have to repeat the command.  This is probably a
+timing issue in escputil, not a flaw in the printer.
+
+.PP
+Anything requiring bidirectional communication with the printer
+(identify, ink levels, or head alignment without specifying the
+printer model) requires read/write access to the printer port (for
+example /dev/lp0).  This may require these operations to be performed
+as root.
+
+.PP
+If the printer is performing self-test or head cleaning on power
+up, the identify and ink level commands will time out, although the
+printer successfully receives the command.  The command will need to
+be reissued when the printer is quiescent.
+
+.SH "SEE ALSO"
+.BR gimp (1)
+
+.\"#
+.\"# The following sets edit modes for GNU EMACS
+.\"# Local Variables:
+.\"# mode:nroff
+.\"# fill-column:79
+.\"# End: