From owner-freebsd-doc Wed Aug 15 6:10:22 2001 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 75A6437B40E for ; Wed, 15 Aug 2001 06:10:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.4/8.11.4) id f7FDA1809845; Wed, 15 Aug 2001 06:10:01 -0700 (PDT) (envelope-from gnats) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 364D337B40A for ; Wed, 15 Aug 2001 06:05:42 -0700 (PDT) (envelope-from nobody@FreeBSD.org) Received: (from nobody@localhost) by freefall.freebsd.org (8.11.4/8.11.4) id f7FD5gb09499; Wed, 15 Aug 2001 06:05:42 -0700 (PDT) (envelope-from nobody) Message-Id: <200108151305.f7FD5gb09499@freefall.freebsd.org> Date: Wed, 15 Aug 2001 06:05:42 -0700 (PDT) From: John Murphy To: freebsd-gnats-submit@freebsd.org X-Send-Pr-Version: www-1.0 Subject: docs/29729: Handbook Chapter 11 (Printing) minor changes Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >Number: 29729 >Category: docs >Synopsis: Handbook Chapter 11 (Printing) minor changes >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Wed Aug 15 06:10:01 PDT 2001 >Closed-Date: >Last-Modified: >Originator: John Murphy >Release: 4.x Stable >Organization: >Environment: >Description: doc/en_US.ISO8859-1/books/handbook/printing/chapter.sgml Revision 1.44 Changed printer name tagging from to Added tags for hosts rose and orchid Changed (where necessary) job's --> job is queue's --> queue is printer's --> printer is bamboo's --> bamboo is She's --> She is Fixed some minor typos. >How-To-Repeat: >Fix: Apply the following diff to: doc/en_US.ISO8859-1/books/handbook/printing/chapter.sgml Revision 1.44 --- chapter Wed Aug 15 03:35:35 2001 +++ chapter.patched Wed Aug 15 03:35:35 2001 @@ -1116,8 +1116,8 @@ lp capability. In our running example, let us assume that - rattan is on the first parallel port, and - bamboo is on a sixth serial port; here are + rattan is on the first parallel port, and + bamboo is on a sixth serial port; here are the additions to /etc/printcap: # @@ -1563,7 +1563,7 @@ - appears if the job's submitted with lpr + appears if the job is submitted with lpr -l @@ -1884,7 +1884,7 @@ && exit 0 else # - # Plain text or HP/PCL, so just print it directly; print a form + # Plain text or HP/PCL, so just print it directly; print a form feed # at the end to eject the last page. # echo $first_line && cat && printf "\033&l0H" && @@ -2538,7 +2538,7 @@ By enabling header pages, LPD will produce a long header, a full page of large letters identifying the user, host, and job. Here is an example (kelly printed the job - named outline from host rose): + named outline from host rose): k ll ll k l l @@ -2972,13 +2972,14 @@ Here is an example. The host rose has two printers, bamboo and rattan. - We will enable users on the host orchid to print to those printers. + We will enable users on the host orchid to print + to those printers. Here is the /etc/printcap file for orchid (back from section Enabling Header Pages). It already had the entry for the printer teak; we have added entries for the two printers - on the host rose: + on the host rose: # # /etc/printcap for host orchid - added (remote) printers on rose @@ -3014,17 +3015,18 @@ Now, users on orchid can print to rattan and bamboo. If, for - example, a user on orchid typed + example, a user on orchid typed &prompt.user; lpr -P bamboo -d sushi-review.dvi - the LPD system on orchid would copy the job to the spooling - directory /var/spool/lpd/bamboo and note that - it was a DVI job. As soon as the host rose has room in its - bamboo spooling directory, the two LPDs would - transfer the file to rose. The file would wait in rose's queue - until it was finally printed. It would be converted from DVI to - PostScript (since bamboo is a PostScript printer) on rose. + the LPD system on orchid would copy the job to the spooling + directory /var/spool/lpd/bamboo and note that it was a + DVI job. As soon as the host rose has room in its + bamboo spooling directory, the two LPDs would transfer the + file to rose. The file would wait in rose's + queue until it was finally printed. It would be converted from DVI to + PostScript (since bamboo is a PostScript printer) on + rose. @@ -3138,7 +3140,7 @@ /etc/printcap file for the host rose. The printer rattan is quite hearty, so we will allow multiple copies, but the laser - printer bamboo's a bit more delicate, so we will + printer bamboo is a bit more delicate, so we will disable multiple copies by adding the sc capability: @@ -3376,9 +3378,9 @@ minfree file. For example, let us add a minfree - file for the printer bamboo. We examine + file for the printer bamboo. We examine /etc/printcap to find the spooling - directory for this printer; here is bamboo's + directory for this printer; here is bamboo's entry: bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\ @@ -3387,14 +3389,13 @@ :if=/usr/local/libexec/psif:\ :df=/usr/local/libexec/psdf: - The spooling directory is the given in the - sd capability. We will make three - megabytes (which is 6144 disk blocks) the amount of free disk - space that must exist on the filesystem for LPD to accept - remote jobs: + The spooling directory is given in the sd + capability. We will make three megabytes (which is 6144 disk blocks) + the amount of free disk space that must exist on the filesystem for + LPD to accept remote jobs: - &prompt.root; echo 6144 > /var/spool/lpd/bam -boo/minfree + &prompt.root; echo 6144 > /var/spool/lpd/bamboo/minfree + @@ -3417,7 +3418,7 @@ giving them accounts on your systems, they can use your printers from their own departmental systems. If you would rather allow them to use only your - printers and not your compute resources, you can give them + printers and not your computer resources, you can give them token accounts, with no home directory and a useless shell like /usr/bin/false. @@ -3524,8 +3525,8 @@ You should use a separate accounting file for each printer, as lpf has no file locking logic built into it, and two lpfs might corrupt each other's entries if - they were to write to the same file at the same time. A easy way to - insure a separate accounting file for each printer is to use + they were to write to the same file at the same time. An easy way + to insure a separate accounting file for each printer is to use af=acct in /etc/printcap. Then, each accounting file will be in the spooling directory for a printer, in a file named acct. @@ -3821,7 +3822,7 @@ &prompt.user; lpq -P bamboo - shows the queue for the printer named bamboo. Here + shows the queue for the printer named bamboo. Here is an example of the output of the lpq command: @@ -3845,7 +3846,7 @@ be currently printing that job. The second job consists of data passed as the standard input to the &man.lpr.1; command. The third job came from user mary; it is a much larger - job. The pathname of the files she's trying to print is too long to + job. The pathname of the file she is trying to print is too long to fit, so the &man.lpq.1; command just shows three dots. The very first line of the output from &man.lpq.1; is also useful: @@ -3883,7 +3884,7 @@ To remove the job from a specific printer, add the option. The following command removes job number - 10 from the queue for the printer bamboo: + 10 from the queue for the printer bamboo: &prompt.user; lprm -P bamboo 10 @@ -4277,7 +4278,7 @@ to get printer status and to restart a hung printer only. Here is a summary of the &man.lpc.8; commands. Most of the - commands takes a printer-name argument to + commands take a printer-name argument to tell on which printer to operate. You can use all for the printer-name to mean all printers listed in /etc/printcap. @@ -4289,7 +4290,7 @@ Cancel the current job and stop the printer. Users can - still submit jobs if the queue's enabled. + still submit jobs if the queue is enabled. @@ -4312,7 +4313,7 @@ printer-name - Disable queuing of new jobs. If the printer's started, it + Disable queuing of new jobs. If the printer is running, it will continue to print any jobs remaining in the queue. The superuser (root) can always submit jobs, even to a disabled queue. @@ -4608,9 +4609,9 @@ exit 2 Here is an example /etc/printcap - from a host called orchid. It has a single printer + from a host called orchid. It has a single printer attached to its first parallel port, a Hewlett Packard - LaserJet 3Si named teak. It is using the + LaserJet 3Si named teak. It is using the above script as its text filter: # >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message