docs/123421: [patch] Fix lpr(1) Error Messages in Handbook Chapter 9

[Gabor PALI]

>Number:         123421
>Category:       docs
>Synopsis:       [patch] Fix lpr(1) Error Messages in Handbook Chapter 9
>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:   Mon May 05 18:00:01 UTC 2008
>Closed-Date:
>Last-Modified:
>Originator:     Gabor PALI
>Release:        FreeBSD 6.3-STABLE i386
>Organization:
>Environment:
System: FreeBSD disznohal 6.3-STABLE FreeBSD 6.3-STABLE #4: Fri Apr 4 23:29:43 CEST 2008 dezzy at disznohal:/usr/obj/usr/src/sys/GENERIC_ i386

>Description:
	I found a small inconsistency in the use markups of lpr(1)
	error messages in the FreeBSD Handbook, Chapter 9 (``Printing'').
	It is marked up as <errorname> and then marked up as a
	<screen> message. I think this should be settled and I created
	two different patches to choose from.

>How-To-Repeat:

>Fix:

	Solution #1: Replace <errorname> with <screen> (the preceding
	paragraph is adjusted).


--- printing.patch.3.diff begins here ---
Index: chapter.sgml
===================================================================
RCS file: /doc/en_US.ISO8859-1/books/handbook/printing/chapter.sgml,v
retrieving revision 1.113
diff -u -r1.113 chapter.sgml
--- chapter.sgml	29 Apr 2008 19:11:39 -0000	1.113
+++ chapter.sgml	5 May 2008 04:08:30 -0000
@@ -3263,12 +3263,11 @@
           to have access to a printer in a certain group, and then name that
           group in the <literal>rg</literal> capability.</para>
             
-        <para>Users outside the group (including <username>root</username>)
-	  will be greeted with
+        <para>If users outside the group (including <username>root</username>)
+	try to print to the controlled printer then they will be greeted with the
+	following message:</para>
           
-          <errorname>lpr: Not a member of the restricted group</errorname>
-          
-          if they try to print to the controlled printer.</para>
+        <screen>lpr: Not a member of the restricted group</screen>
 
         <para>As with the <literal>sc</literal> (suppress multiple copies)
           capability, you need to specify <literal>rg</literal> on remote
--- printing.patch.3.diff ends here ---

	Solution #2: Replace <screen> with <errorname>.


--- printing.patch.4.diff begins here ---
Index: chapter.sgml
===================================================================
RCS file: /doc/en_US.ISO8859-1/books/handbook/printing/chapter.sgml,v
retrieving revision 1.113
diff -u -r1.113 chapter.sgml
--- chapter.sgml	29 Apr 2008 19:11:39 -0000	1.113
+++ chapter.sgml	5 May 2008 04:14:39 -0000
@@ -3185,11 +3185,11 @@
         <para>If you feel multiple copies cause unnecessary wear and tear on
           your printers, you can disable the <option>-#</option> option to
             &man.lpr.1; by adding the <literal>sc</literal> capability to the
-          <filename>/etc/printcap</filename> file.  When users submit jobs
-          with the <option>-#</option> option, they will see:</para>
+          <filename>/etc/printcap</filename> file.  Users will see an
               
-        <screen>lpr: multiple copies are not allowed</screen>
+          <errorname>lpr: multiple copies are not allowed</errorname>
 
+          if they submit jobs with the <option>-#</option> option.</para>
 
         <para>Note that if you have set up access to a printer remotely (see
           section <link linkend="printing-advanced-network-rm">Printers
--- printing.patch.4.diff ends here ---


>Release-Note:
>Audit-Trail:
>Unformatted: