summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
Diffstat (limited to 'doc/Unix-lpr.htm')
-rw-r--r--doc/Unix-lpr.htm279
1 files changed, 0 insertions, 279 deletions
diff --git a/doc/Unix-lpr.htm b/doc/Unix-lpr.htm
deleted file mode 100644
index 063ed25a..00000000
--- a/doc/Unix-lpr.htm
+++ /dev/null
@@ -1,279 +0,0 @@
-<!doctype html>
-<html lang="en">
-<head>
- <meta http-equiv="content-type" content="text/html; charset=utf-8">
- <meta name="viewport" content="user-scalable=yes, initial-scale=1, width=device-width">
- <link href="https://fonts.googleapis.com/css?family=Source+Sans+Pro:200,200i,300,300i,400,400i,600,600i,700,700i,900,900i" rel="stylesheet">
- <link rel="shortcut icon" href="images/favicon.svg">
- <title>Setting Up a Unix 1pr Filter for Ghostscript</title>
- <link href="default.css" rel="stylesheet" type="text/css">
-</head>
-
-<body>
- <header><div class="title"><a href="index.html"><h1 aria-label="title">Ghostscript documentation</h1><h2 aria-label="version"></h2></a></div><a href="Search.htm" aria-label="Search" id="searchSite"><div class="search"></div></a></header>
- <main>
- <article>
- <div class="outer">
-
- <div class="inner">
-<!--START EDITING HERE-->
-
-<h1>Setting Up a Unix 1pr Filter for Ghostscript</h1>
-
-<h2><a name="toc"></a>Table of contents</h2>
-<ul class="toc">
- <li><a href="#Overview">Overview</a></li>
- <li><a href="#What_it_can_do">What it can do</a></li>
- <li><a href="#Setting_up">Setting it up</a></li>
- <li>
- <ul>
- <li><a href="#Editing_device_list">Editing the device list <code>DEVICES</code></a></li>
- <li>
- <ul>
- <li><a href="#Field_bpp">Field 1: bits per pixel</a></li>
- <li><a href="#Field_colours">Field 2: colours</a></li>
- <li><a href="#Field_dq">Field 3: dual queues</a></li>
- <li><a href="#Device_example">Example definition of <code>DEVICES</code></a></li>
- </ul>
- </li>
- <li><a href="#Editing_filter_list">Editing the filter list</a></li>
- <li><a href="#Editing_printer_port">Editing the printer port and type</a></li>
- <li><a href="#Modifying_printcap_insert">Modifying <code>printcap.insert</code></a></li>
- <li><a href="#Multiple_queues">Single or dual queues</a></li>
- </ul>
- </li>
- <li><a href="#Bugs">Bugs</a></li>
- <li><a href="#Authors">Authors</a></li>
-</ul>
-
-<!-- [1.2 end table of contents] =========================================== -->
-
-<!-- [1.3 begin hint] ====================================================== -->
-
-<p>For other information, see the <a href="Readme.htm">Ghostscript
-overview</a> and the <a href="Use.htm">usage documentation</a>.</p>
-
-<!-- [1.3 end hint] ======================================================== -->
-
-<hr>
-
-<!-- [1.0 end visible header] ============================================== -->
-
-<!-- [2.0 begin contents] ================================================== -->
-
-<h2><a name="Overview"></a>Overview</h2>
-
-<p>
-"How do I set up Ghostscript to provide PostScript queues in a standard lpr
-environment on Unix systems?" is a Frequently Asked Question amongst
-Ghostscript users. The two shell scripts described by this document are
-designed to make this task a little easier. They are</p>
-
-<blockquote><dl>
-<dt><code>unix-lpr.sh</code></dt>
-<dd>a flexible, multi-option print filter</dd>
-
-<dt><code>lprsetup.sh</code></dt>
-<dd>A shell script which sets up soft links and creates a template insert
-for the <code>printcap</code> file</dd>
-</dl></blockquote>
-
-<hr>
-
-<h2><a name="What_it_can_do"></a>What it can do</h2>
-
-<p>
-The print filter resides in the Ghostscript installation directory (often
-<code>/usr/local/share/ghostscript</code>, but may be something else at
-your installation), together with a dummy filter directory containing
-various soft links which point to the filter. It offers the following
-features:</p>
-
-<ul>
-<li>Multiple devices supported by a single filter</li>
-<li>Multiple bit-depths for the same device</li>
-<li>Multiple number of colours for the same device</li>
-<li>Direct (single-queue) and indirect (two-queue) setup</li>
-<li>Support for the standard preprocessing filters if you have the
-corresponding (whatever)-to-PostScript translators</li>
-<li>Redirection of diagnostic and programmed output to a logfile in
-the spooling directory</li>
-<li>Maintaining of printer accounting records of the numbers of pages
-printed by each user (compatible with the <code>pac</code> command)</li>
-<li>Straightforward editing for further customisation</li>
-</ul>
-
-<hr>
-
-<h2><a name="Setting_up"></a>Setting it up</h2>
-
-<p>
-The <code>lprsetup.sh</code> script needs to have two lines edited
-before running, to set the printer devices to use and the list of filters
-available. With this information, it</p>
-
-<ul>
-<li>creates a "<code>filt</code>" subdirectory under the
-Ghostscript installation directory</li>
-<li>creates the links in this directory which enable the filter to
-determine the parameters for running Ghostscript</li>
-<li>automatically generates <code>printcap</code> entries which should
-need only a little editing before adding to your system
-<code>printcap</code> file</li>
-</ul>
-
-<h3><a name="Editing_device_list"></a>Editing the device list <tt>DEVICES</tt></h3>
-
-<p>
-At the top of <code>lprsetup.sh</code> is a line of the form
-<code>DEVICES=</code><em>{list}</em>. Replace the example list with
-your own list of devices. Each entry is the name of a device, followed by
-three more optional fields, separated by dots "<code>.</code>".</p>
-
-<h4><a name="Field_bpp"></a>Field 1: bits per pixel</h4>
-
-<p>
-The first field is required only if the printer device understands the <a
-href="Devices.htm#deskjet_parameters"><code>-dBitsPerPixel=</code>
-switch</a>, which applies only to colour devices. For a particular number
-<b><em>N</em></b> of bits per pixel, add the suffix <b><em>.N</em></b> to
-the device name, for instance <code>cdj500.3</code>,
-<code>cdj500.24</code>, etc.</p>
-
-<h4><a name="Field_colours"></a>Field 2: colours</h4>
-
-<p>
-The second field is required only if the printer device understands the
-setting of the <code>Colors</code> device parameter (as in
-<code>-dColors=</code>), which applies only to colour devices (and at
-present is only supported by the <code>bjc</code>* family of drivers).
-For a particular number <b><em>N</em></b> of colours, suffix
-<b><em>.N</em></b> to the device name, such as <code>bjc600.24.3</code>,
-<code>bjc600.8.1</code> etc.</p>
-
-<h4><a name="Field_dq"></a>Field 3: dual queues</h4>
-
-<p>
-The third field is required in order to use two separate queues for the
-device, a "raw" queue and a PostScript queue (see
-"<a href="#Multiple_queues">Single or dual queues</a>" below). If you want
-dual queues, add the suffix <code>.dq</code> ("dual queue") to the name,
-whether or not a <a href="#Field_bpp">bits-per-pixel suffix</a> has already
-been added.</p>
-
-<h4><a name="Device_example"></a>Example definition of
-<tt>DEVICES</tt></h4>
-
-<p>
-Thus the following list supports a <code>cdj550</code> device at three
-different bit depths (24 bpp, 3 bpp and 1 bpp), with a dual queue (that is,
-a separate queue for the raw data); a monochrome <code>deskjet</code>
-device with a single queue; and a <code>djet500</code> device using a
-separate queue:</p>
-
-<blockquote><code>
-DEVICES="cdj550.24.dq&nbsp;cdj550.3.dq&nbsp;cdj550.1.dq&nbsp;deskjet&nbsp;djet500.dq"
-</code></blockquote>
-
-<h3><a name="Editing_filter_list"></a>Editing the filter list</h3>
-
-<p>
-The standard list contains only the generic "<code>if</code>" filter,
-but a commented-out list shows other filters which may be available. If
-you wish to use the support for these filters, you may need to edit the
-<code>bsd-if</code> file to add to the <code>PATH</code> the
-directories where the translators are stored, or to change the names of the
-filters if yours are different. The <code>bsd-if</code> script is
-supplied with an example setup using Transcript (a commercial package from
-Adobe), and PBMPLUS, a freeware package by Jef Poskanzer and others.</p>
-
-<h3><a name="Editing_printer_port"></a>Editing the printer port and
-type</h3>
-
-<p>
-You can set the port and port type (parallel or printer) for an attached
-printer, but for remote printers you'll have to modify the
-<tt>printcap.insert</tt> file yourself.</p>
-
-<h3><a name="Modifying_printcap_insert"></a>Modifying
-<tt>printcap.insert</tt></h3>
-
-<p>
-Running <code>lprsetup.sh</code> generates a file
-<code>printcap.insert</code> which has a template setup for your
-printer queues. It cannot guarantee to do the whole job, and you will
-probably need to consult your system documentation and edit this file
-before you add it to your <code>printcap</code> file. The file has good
-defaults for serial printers, as these often cause problems in getting
-binary data to the printer. However, you may need to change the baud rate,
-or the handshaking method. Only a small change is required in the
-<code>printcap</code> file to use a networked remote printer instead of
-an attached printer, and an example is given in
-<code>printcap.insert</code>.</p>
-
-<h3><a name="Multiple_queues"></a>Single or dual queues</h3>
-
-<p>
-If you wish to provide a PostScript-only queue (for example, so that all
-pages printed go through accounting), and the printer port is local to the
-host machine, a single queue is appropriate -- Ghostscript simply converts
-PostScript into the printer's native data format and sends it to the
-port. But if the printer is on a remote networked machine, or if you need to
-send raw printer data to the printer, you must use two queues. Simply
-specify the <a href="#Field_dq">"<code>.dq</code>" option</a> above.</p>
-
-<hr>
-
-<h2><a name="Bugs"></a>Bugs</h2>
-
-<p>
-You must have write access to the Ghostscript installation directory for
-<code>lprsetup.sh</code> to create the filter directory and soft links.</p>
-
-<p>
-If you have several different values of bits per pixel for the same device,
-you must list all instances of that device as adjacent items in the
-<a href="#Editing_device_list"><code>DEVICES</code></a> device
-list. If you do not, <code>printcap.insert</code> will contain multiple
-entries for the same device, which is not supported.</p>
-
-<hr>
-
-<h2><a name="Authors"></a>Authors</h2>
-
-<p>
-This material was contributed by George Cameron. Yves Arrouye
-&lt;<a href="mailto:yves.arrouye@usa.net">yves.arrouye@usa.net</a>&gt;
-is responsible for the number-of-colours part of the script.</p>
-
-<!-- [2.0 end contents] ==================================================== -->
-
-<!-- [3.0 begin visible trailer] =========================================== -->
-<hr>
-
-<p>
-<small>Copyright &copy; 2000-2022 Artifex Software, Inc. All rights reserved.</small>
-
-<p>
-This software is provided AS-IS with no warranty, either express or
-implied.
-
-This software is distributed under license and may not be copied, modified
-or distributed except as expressly authorized under the terms of that
-license. Refer to licensing information at <a href="https://www.artifex.com">https://www.artifex.com</a>
-or contact Artifex Software, Inc., 1305 Grant Avenue - Suite 200,
-Novato, CA 94945, U.S.A., +1(415)492-9861, for further information.
-
-<p>
-<small>Ghostscript version 9.56.1, 4 April 2022
-
-<!-- [3.0 end visible trailer] ============================================= -->
-
-<!--FINISH EDITING HERE-->
- </div><!-- close inner -->
- </div><!-- close outer -->
- </article>
- </main>
- <script src="site.js"></script>
-</body>
-</html>