diff options
author | Nik Clayton <nik@FreeBSD.org> | 1998-11-05 23:28:48 +0000 |
---|---|---|
committer | Nik Clayton <nik@FreeBSD.org> | 1998-11-05 23:28:48 +0000 |
commit | 6ff34ef8828899e752f225c6818879a9ded29cf4 (patch) | |
tree | 9b03e5114a5bfaef474939e018958ce801f791fb /en_US.ISO_8859-1/books/handbook/printing | |
parent | 93f20f938223644f50c4fb62bafb1ad6819a8b6e (diff) | |
download | doc-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.sgml | 337 |
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 “Simple Printer Setup,” 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 @@ $%&'()*+,-./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—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 “under the hood” 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 “suppress header”) 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&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 “suppress header page” 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 “attach” 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> |