aboutsummaryrefslogtreecommitdiff
path: root/en_US.ISO_8859-1/books/handbook/printing
diff options
context:
space:
mode:
authorNik Clayton <nik@FreeBSD.org>1998-11-05 23:28:48 +0000
committerNik Clayton <nik@FreeBSD.org>1998-11-05 23:28:48 +0000
commit6ff34ef8828899e752f225c6818879a9ded29cf4 (patch)
tree9b03e5114a5bfaef474939e018958ce801f791fb /en_US.ISO_8859-1/books/handbook/printing
parent93f20f938223644f50c4fb62bafb1ad6819a8b6e (diff)
downloaddoc-6ff34ef8828899e752f225c6818879a9ded29cf4.tar.gz
doc-6ff34ef8828899e752f225c6818879a9ded29cf4.zip
Replace
<xref linkend="target" remap="foo"> with <link linkend="target">foo</link> Internal links within the Handbook now do the right thing.
Notes
Notes: svn path=/head/; revision=3751
Diffstat (limited to 'en_US.ISO_8859-1/books/handbook/printing')
-rw-r--r--en_US.ISO_8859-1/books/handbook/printing/chapter.sgml337
1 files changed, 151 insertions, 186 deletions
diff --git a/en_US.ISO_8859-1/books/handbook/printing/chapter.sgml b/en_US.ISO_8859-1/books/handbook/printing/chapter.sgml
index ca9921cd6a..47309e11ae 100644
--- a/en_US.ISO_8859-1/books/handbook/printing/chapter.sgml
+++ b/en_US.ISO_8859-1/books/handbook/printing/chapter.sgml
@@ -11,9 +11,9 @@
simply called LPD.</para>
<para>If you are already familiar with LPD or another printer spooling
- system, you may wish to skip to section <xref
- linkend="printing-intro-setup" remap="Setting up the spooling
- system">.</para>
+ system, you may wish to skip to section <link
+ linkend="printing-intro-setup">Setting up the spooling
+ system</link>.</para>
<sect1 id="printing-intro-spooler">
@@ -124,15 +124,14 @@
<itemizedlist>
<listitem>
- <para>See section <xref linkend="printing-simple" remap="Simple
- Printer Setup"> to learn how to connect a printer, tell LPD
+ <para>See section <link linkend="printing-simple">Simple
+ Printer Setup</link> to learn how to connect a printer, tell LPD
how to communicate with it, and print plain text files to the
printer.</para>
</listitem>
<listitem>
- <para>See section <xref linkend="printing-advanced"
- remap="Advanced Printer Setup"> to find out how to print a
+ <para>See section <link linkend="printing-advanced">Advanced Printer Setup</link> to find out how to print a
variety of special file formats, to print header pages, to
print across a network, to control access to printers, and to
do printer accounting.</para>
@@ -153,14 +152,14 @@
<itemizedlist>
<listitem>
- <para>Section <xref linkend="printing-hardware" remap="Hardware
- Setup"> gives some hints on connecting the printer to a port
+ <para>Section <link linkend="printing-hardware">Hardware
+ Setup</link> gives some hints on connecting the printer to a port
on your computer.</para>
</listitem>
<listitem>
- <para>Section <xref linkend="printing-software" remap="Software
- Setup"> shows how to setup the LPD spooler configuration
+ <para>Section <link linkend="printing-software">Software
+ Setup</link> shows how to setup the LPD spooler configuration
file <filename>/etc/printcap</filename>.</para>
</listitem>
@@ -169,8 +168,8 @@
<para>If you are setting up a printer that uses a network protocol to
accept data to print instead of a serial or parallel interface, see
- <xref linkend="printing-advanced-network-net-if" remap="Printers
- With Networked Data Stream Interaces">.</para>
+ <link linkend="printing-advanced-network-net-if">Printers
+ With Networked Data Stream Interaces</link>.</para>
<para>Although this section is called &ldquo;Simple Printer Setup,&rdquo; it is
actually fairly complex. Getting the printer to work with your
@@ -189,8 +188,7 @@
<para>If you have already connected your printer and have
successfully printed with it under another operating system, you
- can probably skip to section <xref linkend="printing-software"
- remap="Software Setup">.</para>
+ can probably skip to section <link linkend="printing-software">Software Setup</link>.</para>
<sect3 id="printing-ports">
@@ -356,30 +354,29 @@
<step>
<para>Configure your kernel, if necessary, for the port you
- are using for the printer; section <xref
- linkend="printing-kernel" remap="Kernel Configuration">
+ are using for the printer; section <link
+ linkend="printing-kernel">Kernel Configuration</link>
tells you what you need to do.</para>
</step>
<step>
<para>Set the communications mode for the parallel port, if
- you are using a parallel port; section <xref
- linkend="printing-parallel-port-mode" remap="Setting the
- Communication Mode for the Parallel Port"> gives details.</para>
+ you are using a parallel port; section <link
+ linkend="printing-parallel-port-mode">Setting the
+ Communication Mode for the Parallel Port</link> gives details.</para>
</step>
<step>
<para>Test if the operating system can send data to the
- printer. Section <xref linkend="printing-testing"
- remap="Checking Printer Communications"> gives some
+ printer. Section <link linkend="printing-testing">Checking Printer Communications</link> gives some
suggestions on how to do this.</para>
</step>
<step>
<para>Set up LPD for the printer by modifying the file
- <filename>/etc/printcap</filename>. Section <xref
- linkend="printing-printcap" remap="The /etc/printcap
- File"> shows you how.</para>
+ <filename>/etc/printcap</filename>. Section <link
+ linkend="printing-printcap">The /etc/printcap
+ File</link> shows you how.</para>
</step>
</procedure>
@@ -566,8 +563,8 @@ device lpt0 at isa? port? tty vector lptintr</programlisting>
<step>
<para>Save the file. Then configure, build, and install
- the kernel, then reboot. See <xref
- linkend="kernelconfig" remap="kernel configuration">
+ the kernel, then reboot. See <link
+ linkend="kernelconfig">kernel configuration</link>
for more details.</para>
</step>
@@ -845,51 +842,48 @@ printer:dv=/dev/ttyd2:br#19200:pa=none</programlisting>
<step>
<para>Pick a name (and a few convenient aliases) for the
printer, and put them in the
- <filename>/etc/printcap</filename> file; see <xref
- linkend="printing-naming" remap="Naming the Printer">.</para>
+ <filename>/etc/printcap</filename> file; see <link
+ linkend="printing-naming">Naming the Printer</link>.</para>
</step>
<step>
<para>Turn off header pages (which are on by default) by
inserting the <literal>sh</literal> capability;
- see <xref linkend="printing-no-header-pages"
- remap="Suppressing Header Pages">.</para>
+ see <link linkend="printing-no-header-pages">Suppressing Header Pages</link>.</para>
</step>
<step>
<para>Make a spooling directory, and specify its location
with the <literal>sd</literal> capability; see
- <xref linkend="printing-spooldir"
- remap="Making the Spooling Directory">.</para>
+ <link linkend="printing-spooldir">Making the Spooling Directory</link>.</para>
</step>
<step>
<para>Set the <filename>/dev</filename> entry to use for the
printer, and note it in <filename>/etc/printcap</filename>
with the <literal>lp</literal> capability; see
- <xref
- linkend="printing-device" remap="Identifying the Printer
- Device">. Also, if the printer is on a serial port, set
+ <link
+ linkend="printing-device">Identifying the Printer
+ Device</link>. Also, if the printer is on a serial port, set
up the communication parameters with the
<literal>fs</literal>, <literal>fc</literal>,
- <literal>xs</literal>, and <literal>xc</literal> capabilities; see <xref
- linkend="printing-commparam" remap="Configuring Spooler
- Communications Parameters">.</para>
+ <literal>xs</literal>, and <literal>xc</literal> capabilities; see <link
+ linkend="printing-commparam">Configuring Spooler
+ Communications Parameters</link>.</para>
</step>
<step>
- <para>Install a plain text input filter; see <xref
- linkend="printing-textfilter" remap="Installing the Text
- Filter"></para>
+ <para>Install a plain text input filter; see <link
+ linkend="printing-textfilter">Installing the Text
+ Filter</link></para>
</step>
<step>
<para>Test the setup by printing something with the
<citerefentry>
<refentrytitle>lpr</refentrytitle></citerefentry>
- command; see <xref linkend="printing-trying" remap="Trying
- It Out"> and <xref linkend="printing-troubleshooting"
- remap="Troubleshooting">.</para>
+ command; see <link linkend="printing-trying">Trying
+ It Out</link> and <link linkend="printing-troubleshooting">Troubleshooting</link>.</para>
</step>
</procedure>
@@ -910,9 +904,9 @@ printer:dv=/dev/ttyd2:br#19200:pa=none</programlisting>
print plain text jobs, you are strongly urged to add an
additional step to the simple setup outlined above: install an
automatic plain-text-to-PostScript (or other printer language)
- conversion program. Section <xref
- linkend="printing-advanced-if-conversion" remap="Accommodating
- Plain Text Jobs on PostScript Printers"> tells how to do
+ conversion program. Section <link
+ linkend="printing-advanced-if-conversion">Accommodating
+ Plain Text Jobs on PostScript Printers</link> tells how to do
this.</para>
@@ -1079,8 +1073,7 @@ bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
<sect4 id="printing-device">
<title>Identifying the Printer Device</title>
- <para>In section <xref linkend="printing-dev-ports"
- remap="Adding /dev Entries for the Ports">, we identified
+ <para>In section <link linkend="printing-dev-ports">Adding /dev Entries for the Ports</link>, we identified
which entry in the <filename>/dev</filename> directory FreeBSD
will use to communicate with the printer. Now, we tell LPD
that information. When the spooling system has a job to
@@ -1116,9 +1109,9 @@ bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
FreeBSD.</para>
<para>If the printer you are installing is connected to a
- parallel port, skip to the section <xref
- linkend="printing-textfilter" remap="Installing the
- Text Filter">. Otherwise, be sure to follow the
+ parallel port, skip to the section <link
+ linkend="printing-textfilter">Installing the
+ Text Filter</link>. Otherwise, be sure to follow the
instructions in the next section.</para>
</sect4>
@@ -1239,9 +1232,8 @@ bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
to read the job from standard input, perform any necessary
translation for the printer, and write the results to standard
output, which will get printed. For more information on the
- text filter, see section <xref
- linkend="printing-advanced-filters"
- remap="Filters">.</para>
+ text filter, see section <link
+ linkend="printing-advanced-filters">Filters</link>.</para>
<para>For our simple printer setup, the text filter can be a
small shell script that just executes
@@ -1250,8 +1242,8 @@ bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
underlining for printers that might not deal with such
character streams well. And, of course, you can use any other
filter program you want. The filter <command>lpf</command> is described in detail in section
- <xref linkend="printing-advanced-lpf" remap="lpf: a
- Text Filter">.</para>
+ <link linkend="printing-advanced-lpf">lpf: a
+ Text Filter</link>.</para>
<para>First, let us make the shell script
<filename>/usr/local/libexec/if-simple</filename> be a simple
@@ -1309,8 +1301,7 @@ bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
<para>You can combine <citerefentry>
<refentrytitle>lpr</refentrytitle></citerefentry>
with the <citerefentry>
- <refentrytitle>lptest</refentrytitle></citerefentry> program, introduced in section <xref linkend="printing-testing"
- remap="Checking Printer Communications"> to generate some
+ <refentrytitle>lptest</refentrytitle></citerefentry> program, introduced in section <link linkend="printing-testing">Checking Printer Communications</link> to generate some
test text.</para>
<para><emphasis>To test the simple LPD
@@ -1347,9 +1338,8 @@ $%&amp;'()*+,-./01234567
programs (for language-based printers) or running <citerefentry>
<refentrytitle>lptest</refentrytitle></citerefentry> with different arguments. For example, <command>lptest 80 60</command> will produce 60 lines of 80 characters each.</para>
- <para>If the printer did not work, see the next section, <xref
- linkend="printing-troubleshooting"
- remap="Troubleshooting">.</para>
+ <para>If the printer did not work, see the next section, <link
+ linkend="printing-troubleshooting">Troubleshooting</link>.</para>
</sect4>
@@ -1701,9 +1691,8 @@ rattan|line|diablo|lp|Diablo 630 Line Printer:\
<para>There is also an administrative command, <citerefentry>
<refentrytitle>lpc</refentrytitle></citerefentry>,
- described in the section <xref linkend="printing-lpc"
- remap="Administrating the
- LPD Spooler">, used to control printers and their queues.</para>
+ described in the section <link linkend="printing-lpc">Administrating the
+ LPD Spooler</link>, used to control printers and their queues.</para>
<para>All three of the commands <citerefentry>
<refentrytitle>lpr</refentrytitle></citerefentry>, <citerefentry>
@@ -1768,9 +1757,8 @@ rattan|line|diablo|lp|Diablo 630 Line Printer:\
<refentrytitle>lpr</refentrytitle></citerefentry> command
can also accept a wide variety of options to control formatting,
apply file conversions, generate multiple copies, and so forth.
- For more information, see the section <xref
- linkend="printing-lpr-options"
- remap="Printing Options">.</para>
+ For more information, see the section <link
+ linkend="printing-lpr-options">Printing Options</link>.</para>
</sect2>
@@ -1811,7 +1799,7 @@ active kelly 9 /etc/host.conf, /etc/hosts.equiv 88 bytes
job for a printer gets a unique job number. Most of the time you
can ignore the job number, but you will need it if you want to
cancel the job; see section
- <xref linkend="printing-lprm" remap="Removing Jobs"> for
+ <link linkend="printing-lprm">Removing Jobs</link> for
details.</para>
<para>Job number nine consists of two files; multiple files given on
@@ -1993,9 +1981,9 @@ cfA013rose dequeued
<para>All of these options except <option>-p</option> and
<option>-T</option> require conversion filters installed for
the destination printer. For example, the <option>-d</option>
- option requires the DVI conversion filter. Section <xref
- linkend="printing-advanced-convfilters" remap="Conversion
- Filters"> gives details.</para>
+ option requires the DVI conversion filter. Section <link
+ linkend="printing-advanced-convfilters">Conversion
+ Filters</link> gives details.</para>
</note>
@@ -2141,9 +2129,8 @@ cfA013rose dequeued
<para>Produce a number of <replaceable>copies</replaceable> of each file in the job
instead of just one copy. An administrator may disable
this option to reduce printer wear-and-tear and
- encourage photocopier usage. See section <xref
- linkend="printing-advanced-restricting-copies"
- remap="Restricting Multiple Copies">.</para>
+ encourage photocopier usage. See section <link
+ linkend="printing-advanced-restricting-copies">Restricting Multiple Copies</link>.</para>
<para>This example prints three copies of
<filename>parser.c</filename> followed by three copies
@@ -2217,8 +2204,8 @@ cfA013rose dequeued
<refentrytitle>lpr</refentrytitle></citerefentry>
adjust the text that normally appears on a job's header page.
If header pages are suppressed for the destination printer,
- these options have no effect. See section <xref
- linkend="printing-advanced-header-pages" remap="Header Pages">
+ these options have no effect. See section <link
+ linkend="printing-advanced-header-pages">Header Pages</link>
for information about setting up header pages.</para>
@@ -2249,9 +2236,9 @@ cfA013rose dequeued
<note>
<para>At some sites, this option may have no effect due
- to the way header pages are generated. See <xref
- linkend="printing-advanced-header-pages" remap="Header
- Pages"> for details.</para>
+ to the way header pages are generated. See <link
+ linkend="printing-advanced-header-pages">Header
+ Pages</link> for details.</para>
</note>
</listitem>
</varlistentry>
@@ -2479,9 +2466,9 @@ cfA013rose dequeued
communicate with the printer and handle its device dependencies
and special requirements. In the simple printer setup, we
installed a plain text filter&mdash;an extremely simple one that
- should work with most printers (section <xref
- linkend="printing-textfilter" remap="Installing the
- Text Filter">).</para>
+ should work with most printers (section <link
+ linkend="printing-textfilter">Installing the
+ Text Filter</link>).</para>
<para>However, in order to take advantage of format conversion,
printer accounting, specific printer quirks, and so on, you should
@@ -2504,8 +2491,7 @@ cfA013rose dequeued
<itemizedlist>
<listitem>
- <para>Section <xref linkend="printing-advanced-filters"
- remap="How Filters Work">, tries to give an overview of a
+ <para>Section <link linkend="printing-advanced-filters">How Filters Work</link>, tries to give an overview of a
filter's role in the printing process. You should read this
section to get an understanding of what is happening &ldquo;under
the hood&rdquo; when LPD uses filters. This knowledge could help
@@ -2517,10 +2503,9 @@ cfA013rose dequeued
<para>LPD expects every printer to be able to print plain text
by default. This presents a problem for PostScript (or
other language-based printers) which cannot directly print
- plain text. Section <xref
- linkend="printing-advanced-if-conversion"
- remap="Accommodating Plain Text Jobs on PostScript
- Printers"> tells you what you should do to overcome this
+ plain text. Section <link
+ linkend="printing-advanced-if-conversion">Accommodating Plain Text Jobs on PostScript
+ Printers</link> tells you what you should do to overcome this
problem. I recommend reading this section if you have a
PostScript printer.</para>
</listitem>
@@ -2529,8 +2514,7 @@ cfA013rose dequeued
<para>PostScript is a popular output format for many programs.
Even some people (myself included) write PostScript code
directly. But PostScript printers are expensive. Section
- <xref linkend="printing-advanced-ps"
- remap="Simulating PostScript on Non-PostScript Printers">
+ <link linkend="printing-advanced-ps">Simulating PostScript on Non-PostScript Printers</link>
tells how you can further modify a printer's text filter to
accept and print PostScript data on a
<emphasis>non-PostScript</emphasis> printer. I recommend
@@ -2539,8 +2523,7 @@ cfA013rose dequeued
</listitem>
<listitem>
- <para>Section <xref linkend="printing-advanced-convfilters"
- remap="Conversion Filters"> tells about a way you can
+ <para>Section <link linkend="printing-advanced-convfilters">Conversion Filters</link> tells about a way you can
automate the conversion of specific file formats, such as
graphic or typesetting data, into formats your printer can
understand. After reading this section, you should be able
@@ -2552,18 +2535,15 @@ cfA013rose dequeued
</listitem>
<listitem>
- <para>Section <xref linkend="printing-advanced-of"
- remap="Output Filters"> tells all about a not often used
+ <para>Section <link linkend="printing-advanced-of">Output Filters</link> tells all about a not often used
feature of LPD: output filters. Unless you are printing
- header pages (see <xref
- linkend="printing-advanced-header-pages"
- remap="Header Pages">), you can probably skip that section
+ header pages (see <link
+ linkend="printing-advanced-header-pages">Header Pages</link>), you can probably skip that section
altogether.</para>
</listitem>
<listitem>
- <para>Section <xref linkend="printing-advanced-lpf"
- remap="lpf: a Text Filter"> describes <command>lpf</command>, a fairly complete if simple text
+ <para>Section <link linkend="printing-advanced-lpf">lpf: a Text Filter</link> describes <command>lpf</command>, a fairly complete if simple text
filter for line printers (and laser printers that act like
line printers) that comes with FreeBSD. If you need a quick
way to get printer accounting working for plain text, or if
@@ -2600,7 +2580,7 @@ cfA013rose dequeued
printer. If the user wanted to print plain text, it would start
the <literal>if</literal> filter (this is mostly
true:
- see <xref linkend="printing-advanced-of" remap="Output Filters">
+ see <link linkend="printing-advanced-of">Output Filters</link>
for details).</para>
<para>There are three kinds of filters you can specify in
@@ -2703,8 +2683,7 @@ cfA013rose dequeued
directly printed, but you can install a conversion filter
for ditroff files to convert the ditroff data into a form
the printer can digest and print. Section
- <xref linkend="printing-advanced-convfilters"
- remap="Conversion Filters"> tells all about them.
+ <link linkend="printing-advanced-convfilters">Conversion Filters</link> tells all about them.
Conversion filters also need to do accounting, if you need
printer accounting. Conversion filters are started with
the following arguments:
@@ -2728,8 +2707,8 @@ cfA013rose dequeued
<para>The <emphasis>output filter</emphasis> is used only if
there is no text filter, or if header pages are enabled.
In my experience, output filters are rarely used. Section
- <xref linkend="printing-advanced-of" remap="Output
- Filters"> describe them. There are only two arguments
+ <link linkend="printing-advanced-of">Output
+ Filters</link> describe them. There are only two arguments
to an output filter:
<cmdsynopsis>
@@ -2824,8 +2803,8 @@ cfA013rose dequeued
the printer.</para>
<para><command>lprps</command> is part of the FreeBSD
- ports collection (see <xref linkend="ports" remap="The Ports
- Collection">). You
+ ports collection (see <link linkend="ports">The Ports
+ Collection</link>). You
can fetch, build and install it yourself, of course. After
installing <command>lprps</command>, just specify the
pathname to the <command>psif</command> program that
@@ -2873,8 +2852,8 @@ fi</programlisting>
<para>In the above script, <command>textps</command> is a program we installed
separately to convert plain text to PostScript. You can use any
text-to-PostScript program you wish. The FreeBSD ports
- collection (see <xref linkend="ports" remap="The Ports
- Collection">) includes a full featured text-to-PostScript
+ collection (see <link linkend="ports">The Ports
+ Collection</link>) includes a full featured text-to-PostScript
program called <citerefentry>
<refentrytitle>a2ps</refentrytitle></citerefentry> that you might want to investigate.</para>
@@ -2960,8 +2939,8 @@ exit 2</programlisting>
<sect3 id="printing-advanced-convfilters">
<title>Conversion Filters</title>
- <para>After completing the simple setup described in <xref
- linkend="printing-simple" remap="Simple Printer Setup">, the
+ <para>After completing the simple setup described in <link
+ linkend="printing-simple">Simple Printer Setup</link>, the
first thing you will probably want to do is install conversion
filters for your favorite file formats (besides plain ASCII
text).</para>
@@ -2993,16 +2972,15 @@ exit 2</programlisting>
<para>We got LPD to do the DVI file conversion
for us by specifying the <option>-d</option> option. Section
- <xref
- linkend="printing-lpr-options-format" remap="Formatting and
- Conversion Options"> lists the conversion options.</para>
+ <link
+ linkend="printing-lpr-options-format">Formatting and
+ Conversion Options</link> lists the conversion options.</para>
<para>For each of the conversion options you want a printer to
support, install a <emphasis>conversion filter</emphasis> and
specify its pathname in <filename>/etc/printcap</filename>. A
conversion filter is like the text filter for the simple
- printer setup (see section <xref linkend="printing-textfilter"
- remap="Installing the Text Filter">) except that instead of
+ printer setup (see section <link linkend="printing-textfilter">Installing the Text Filter</link>) except that instead of
printing plain text, the filter converts the file into a
format the printer can understand.</para>
@@ -3150,9 +3128,8 @@ bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
exec /usr/local/bin/dvips -f | /usr/local/libexec/lprps "$@"</programlisting>
<para>This script runs <citerefentry>
- <refentrytitle>dvips</refentrytitle></citerefentry> in filter mode (the <option>-f</option> argument) on standard input, which is the job to print. It then starts the PostScript printer filter <command>lprps</command> (see section <xref linkend="printing-advanced-if-conversion"
- remap="Accommodating Plain Text Jobs on PostScript
- Printers">) with the arguments LPD passed to this script.
+ <refentrytitle>dvips</refentrytitle></citerefentry> in filter mode (the <option>-f</option> argument) on standard input, which is the job to print. It then starts the PostScript printer filter <command>lprps</command> (see section <link linkend="printing-advanced-if-conversion">Accommodating Plain Text Jobs on PostScript
+ Printers</link>) with the arguments LPD passed to this script.
<command>lprps</command> will use those arguments
to account for the pages printed.</para>
@@ -3260,8 +3237,8 @@ exit 2</programlisting>
<para>Now, for the hard part: making the filter. For that, we
need a DVI-to-LaserJet/PCL conversion program. The FreeBSD
- ports collection (see <xref linkend="ports" remap="The
- Ports Collection">) has one: <citerefentry>
+ ports collection (see <link linkend="ports">The
+ Ports Collection</link>) has one: <citerefentry>
<refentrytitle>dvi2xx</refentrytitle></citerefentry> is the
name of the package. Installing this package gives us the
program we need, <citerefentry>
@@ -3438,9 +3415,9 @@ exit 0</programlisting>
<para>Do not be seduced by an output filter's simplicity. If you
would like each file in a job to start on a different page an
output filter <emphasis>will not work</emphasis>. Use a text
- filter (also known as an input filter); see section <xref
- linkend="printing-textfilter" remap="Installing the Text
- Filter">. Furthermore, an output filter is actually
+ filter (also known as an input filter); see section <link
+ linkend="printing-textfilter">Installing the Text
+ Filter</link>. Furthermore, an output filter is actually
<emphasis>more complex</emphasis> in that it has to examine the
byte stream being sent to it for special flag characters and
must send signals to itself on behalf of LPD.</para>
@@ -3455,9 +3432,9 @@ exit 0</programlisting>
<para>On a single printer, LPD allows both an output filter and
text or other filters. In such cases, LPD will start the output
- filter to print the header page (see section <xref
- linkend="printing-advanced-header-pages" remap="Header
- Pages">) only. LPD then expects the output filter to
+ filter to print the header page (see section <link
+ linkend="printing-advanced-header-pages">Header
+ Pages</link>) only. LPD then expects the output filter to
<emphasis>stop itself</emphasis> by sending two bytes to the
filter: ASCII 031 followed by ASCII 001. When an output filter
sees these two bytes (031, 001), it should stop by sending
@@ -3504,9 +3481,9 @@ exit 0</programlisting>
<filename>/etc/printcap</filename> file. It uses these values
to determine how much text can fit on a page and how many pages
were in a user's job. For more information on printer
- accounting, see <xref
- linkend="printing-advanced-acct" remap="Accounting for Printer
- Usage">.</para>
+ accounting, see <link
+ linkend="printing-advanced-acct">Accounting for Printer
+ Usage</link>.</para>
</sect3>
</sect2>
@@ -3534,16 +3511,16 @@ exit 0</programlisting>
<para>The LPD system can provide header pages automatically for your
printouts <emphasis>if</emphasis> your printer can directly print
plain text. If you have a PostScript printer, you will need an
- external program to generate the header page; see <xref
- linkend="printing-advanced-header-pages-ps" remap="Header Pages
- on PostScript Printers">.</para>
+ external program to generate the header page; see <link
+ linkend="printing-advanced-header-pages-ps">Header Pages
+ on PostScript Printers</link>.</para>
<sect3 id="printing-advanced-header-pages-enabling">
<title>Enabling Header Pages</title>
- <para>In the <xref linkend="printing-simple" remap="Simple
- Printer Setup">, we turned off header pages by
+ <para>In the <link linkend="printing-simple">Simple
+ Printer Setup</link>, we turned off header pages by
specifying <literal>sh</literal> (meaning &ldquo;suppress
header&rdquo;) in the <filename>/etc/printcap</filename> file. To
enable header pages for a printer, just remove the <literal>sh</literal> capability.</para>
@@ -3565,9 +3542,8 @@ printf "\033&amp;k2G" || exit 2 exec
/usr/libexec/lpr/lpf</programlisting>
<para>Specify the path to the output filter in the
- <literal>of</literal> capability. See <xref
- linkend="printing-advanced-of"
- remap="Output Filters"> for more information.</para>
+ <literal>of</literal> capability. See <link
+ linkend="printing-advanced-of">Output Filters</link> for more information.</para>
<para>Here is an example <filename>/etc/printcap</filename> file
for the printer <literal>teak</literal> that we
@@ -3587,9 +3563,9 @@ teak|hp|laserjet|Hewlett Packard LaserJet 3Si:\
<para>Now, when users print jobs to <literal>teak</literal>, they get a header page with each
job. If users want to spend time searching for their printouts,
they can suppress header pages by submitting the job with
- <command>lpr -h</command>; see <xref
- linkend="printing-lpr-options-misc" remap="Header Page
- Options"> for more <citerefentry>
+ <command>lpr -h</command>; see <link
+ linkend="printing-lpr-options-misc">Header Page
+ Options</link> for more <citerefentry>
<refentrytitle>lpr</refentrytitle></citerefentry>
options.</para>
@@ -3719,8 +3695,7 @@ rose:kelly Job: outline Date: Sun Sep 17 11:07:51 1995</programlisting>
<listitem>
<para>Install an alternative to LPD, such as LPDng or PLP.
- Section <xref linkend="printing-lpd-alternatives"
- remap="Alternatives to the Standard Spooler"> tells
+ Section <link linkend="printing-lpd-alternatives">Alternatives to the Standard Spooler</link> tells
more about other spooling software you can substitute for
LPD.</para>
</listitem>
@@ -3896,8 +3871,7 @@ done
argument list in order to determine the user and host name. The
parsing for the other conversion filters is identical. The text
filter takes a slightly different set of arguments, though (see
- section <xref linkend="printing-advanced-filters"
- remap="How Filters Work">).</para>
+ section <link linkend="printing-advanced-filters">How Filters Work</link>).</para>
<para>As we have mentioned before, the above scheme, though fairly
simple, disables the &ldquo;suppress header page&rdquo; option (the
@@ -3908,8 +3882,7 @@ done
<para>To allow users to shut off header pages on a per-job basis,
you will need to use the trick introduced in section
- <xref linkend="printing-advanced-header-pages-accounting"
- remap="Accounting for Header Pages">: write an output filter
+ <link linkend="printing-advanced-header-pages-accounting">Accounting for Header Pages</link>: write an output filter
that parses the LPD-generated header page and produces a
PostScript version. If the user submits the job with
<command>lpr -h</command>, then LPD will not generate a header
@@ -3939,9 +3912,9 @@ done
install a printer that has a conventional serial or parallel
interface on one host. Then, you set up LPD to enable
access to the printer from other hosts on the network.
- Section <xref
- linkend="printing-advanced-network-rm" remap="Printers
- Installed on Remote Hosts"> tells how to do this.</para>
+ Section <link
+ linkend="printing-advanced-network-rm">Printers
+ Installed on Remote Hosts</link> tells how to do this.</para>
</listitem>
<listitem>
@@ -3956,9 +3929,8 @@ done
<para>It might understand the LPD protocol and can even
queue jobs from remote hosts. In this case, it acts
just like a regular host running LPD. Follow the same
- procedure in section <xref
- linkend="printing-advanced-network-rm"
- remap="Printers Installed on Remote Hosts"> to
+ procedure in section <link
+ linkend="printing-advanced-network-rm">Printers Installed on Remote Hosts</link> to
set up such a printer.</para>
</listitem>
@@ -3967,10 +3939,9 @@ done
In this case, you &ldquo;attach&rdquo; the printer to one host
on the network by making that host responsible for
spooling jobs and sending them to the printer.
- Section <xref
- linkend="printing-advanced-network-net-if"
- remap="Printers with Networked Data Stream
- Interfaces"> gives some suggestions on installing
+ Section <link
+ linkend="printing-advanced-network-net-if">Printers with Networked Data Stream
+ Interfaces</link> gives some suggestions on installing
such printers.</para>
</listitem>
@@ -3994,10 +3965,9 @@ done
<para>To enable this kind of remote printing, first install a
printer on one host, the <emphasis>printer host</emphasis>,
- using the simple printer setup described in <xref
- linkend="printing-simple" remap="Simple Printer Setup">. Do
- any advanced setup in <xref linkend="printing-advanced"
- remap="Advanced Printer Setup"> that you need. Make sure to
+ using the simple printer setup described in <link
+ linkend="printing-simple">Simple Printer Setup</link>. Do
+ any advanced setup in <link linkend="printing-advanced">Advanced Printer Setup</link> that you need. Make sure to
test the printer and see if it works with the features of LPD
you have enabled.</para>
@@ -4051,8 +4021,7 @@ done
orchid to print to those printers. Here is the
<filename>/etc/printcap</filename> file for <hostid>orchid</hostid> (back from
section
- <xref linkend="printing-advanced-header-pages-enabling"
- remap="Enabling Header Pages">). It already had the entry for
+ <link linkend="printing-advanced-header-pages-enabling">Enabling Header Pages</link>). It already had the entry for
the printer <literal>teak</literal>; we have added
entries for the two printers on the host rose:</para>
@@ -4116,9 +4085,9 @@ bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
expensive version), or one which just lets you send data to it
as if you were using a serial or parallel port (the cheaper
version). This section tells how to use the cheaper version.
- For the more expensive one, see the previous section <xref
- linkend="printing-advanced-network-rm" remap="Printers
- Installed on Remote Hosts">.</para>
+ For the more expensive one, see the previous section <link
+ linkend="printing-advanced-network-rm">Printers
+ Installed on Remote Hosts</link>.</para>
<para>The format of the <filename>/etc/printcap</filename> file
lets you specify what serial or parallel interface to use, and
@@ -4213,8 +4182,7 @@ exit 0;</programlisting>
</informalexample>
<para>Note that if you have set up access to a printer remotely
- (see section <xref linkend="printing-advanced-network-rm"
- remap="Printers Installed on Remote Hosts">), you need
+ (see section <link linkend="printing-advanced-network-rm">Printers Installed on Remote Hosts</link>), you need
the <literal>sc</literal> capability on the remote
<filename>/etc/printcap</filename> files as well, or else users
will still be able to submit multiple-copy jobs by using another
@@ -4299,8 +4267,7 @@ bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
<para>As with the <literal>sc</literal> (suppress
multiple copies) capability, you need to specify <literal>rg</literal> on remote hosts that also have access
to your printers, if you feel it is appropriate (see section
- <xref linkend="printing-advanced-network-rm"
- remap="Printers Installed on Remote Hosts">).</para>
+ <link linkend="printing-advanced-network-rm">Printers Installed on Remote Hosts</link>).</para>
<para>For example, we will let anyone access the printer
<literal>rattan</literal>, but only those in group
@@ -4393,15 +4360,14 @@ bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
remote users will not get those limits. You will need to
specify the <literal>mx</literal> capability in the
remote <filename>/etc/printcap</filename> files as well. See
- section <xref
- linkend="printing-advanced-network-rm" remap="Printers
- Installed on Remote Hosts"> for more information on
+ section <link
+ linkend="printing-advanced-network-rm">Printers
+ Installed on Remote Hosts</link> for more information on
remote printing.</para>
<para>There is another specialized way to limit job sizes from
- remote printers; see section <xref
- linkend="printing-advanced-restricting-remote"
- remap="Restricting Jobs from Remote Printers">.</para>
+ remote printers; see section <link
+ linkend="printing-advanced-restricting-remote">Restricting Jobs from Remote Printers</link>.</para>
</sect3>
@@ -4547,9 +4513,8 @@ bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
(to charge for other file formats), to count pages or query the
printer for pages printed. You cannot get away with using the
simple output filter, since it cannot do accounting. See section
- <xref
- linkend="printing-advanced-filter-intro"
- remap="Filters">.</para>
+ <link
+ linkend="printing-advanced-filter-intro">Filters</link>.</para>
<para>Generally, there are two ways to do accounting:</para>
<itemizedlist>
@@ -4597,14 +4562,14 @@ bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
<para>FreeBSD comes with two programs that can get you set up
with simple periodic accounting right away. They are the text
filter <command>lpf</command>, described in section
- <xref linkend="printing-advanced-lpf" remap="lpf: a Text
- Filter">, and <citerefentry>
+ <link linkend="printing-advanced-lpf">lpf: a Text
+ Filter</link>, and <citerefentry>
<refentrytitle>pac</refentrytitle></citerefentry>, a
program to gather and total entries from printer accounting
files.</para>
- <para>As mentioned in the section on filters (<xref
- linkend="printing-advanced-filters" remap="Filters">), LPD
+ <para>As mentioned in the section on filters (<link
+ linkend="printing-advanced-filters">Filters</link>), LPD
starts the text and the conversion filters with the name of the
accounting file to use on the filter command line. The filters
can use this argument to know where to write an accounting file
@@ -4791,8 +4756,8 @@ total 337.00 154 $ 6.74</screen>
physical lines.</para>
<para>The text filter <command>lpf</command>
- (introduced in <xref linkend="printing-advanced-lpf" remap="lpf:
- a Text Filter">) takes into account these things when it does
+ (introduced in <link linkend="printing-advanced-lpf">lpf:
+ a Text Filter</link>) takes into account these things when it does
accounting. If you are writing a text filter which needs to do
accounting, you might want to examine <command>lpf</command>'s source code.</para>