From pali.gabor@googlemail.com  Sun Apr 27 21:23:29 2008
Return-Path: <pali.gabor@googlemail.com>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 7C7A81065670
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 27 Apr 2008 21:23:29 +0000 (UTC)
	(envelope-from pali.gabor@googlemail.com)
Received: from ug-out-1314.google.com (ug-out-1314.google.com [66.249.92.168])
	by mx1.freebsd.org (Postfix) with ESMTP id F01718FC14
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 27 Apr 2008 21:23:28 +0000 (UTC)
	(envelope-from pali.gabor@googlemail.com)
Received: by ug-out-1314.google.com with SMTP id y2so614926uge.37
        for <FreeBSD-gnats-submit@freebsd.org>; Sun, 27 Apr 2008 14:23:27 -0700 (PDT)
Received: by 10.67.16.13 with SMTP id t13mr3849450ugi.44.1209331407172;
        Sun, 27 Apr 2008 14:23:27 -0700 (PDT)
Received: from pgj@FreeBSD.org ( [80.98.116.90])
        by mx.google.com with ESMTPS id z33sm8220404ikz.0.2008.04.27.14.23.25
        (version=TLSv1/SSLv3 cipher=OTHER);
        Sun, 27 Apr 2008 14:23:26 -0700 (PDT)
Received: by pgj@FreeBSD.org (sSMTP sendmail emulation); Sun, 27 Apr 2008 23:23:21 +0200
Message-Id: <4814eece.2134440a.79a9.1421@mx.google.com>
Date: Sun, 27 Apr 2008 23:23:21 +0200
From: "Gabor PALI" <pgj@FreeBSD.org>
Sender: =?UTF-8?B?UMOBTEkgR8OhYm9yIErDoW5vcw==?= <pali.gabor@googlemail.com>
Reply-To: Gabor PALI <pgj@FreeBSD.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [patch] Add missing <replaceable> tags to Handbook Chapter 9
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         123150
>Category:       docs
>Synopsis:       [patch] Add missing <replaceable> tags to Handbook Chapter 9
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    blackend
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Apr 27 21:30:03 UTC 2008
>Closed-Date:    Tue Apr 29 19:11:59 UTC 2008
>Last-Modified:  Tue Apr 29 19:11:59 UTC 2008
>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@disznohal:/usr/obj/usr/src/sys/GENERIC_ i386

>Description:
	<replaceable> tags are missing from the FreeBSD Handbook, Chapter
	9 (Printing) in some cases. I think file names corrected by this
	patch are just examples, so they should be replaceable.

>How-To-Repeat:

>Fix:

	Apply this patch:

--- printing.patch.2.diff begins here ---
Index: chapter.sgml
===================================================================
RCS file: /doc/en_US.ISO8859-1/books/handbook/printing/chapter.sgml,v
retrieving revision 1.112
diff -u -r1.112 chapter.sgml
--- chapter.sgml	13 Apr 2008 15:13:45 -0000	1.112
+++ chapter.sgml	27 Apr 2008 21:06:32 -0000
@@ -1913,8 +1913,8 @@
             
         <programlisting>:if=/usr/local/libexec/ifhp:</programlisting>
 
-        <para>That is it.  You can type <command>lpr plain.text</command> and
-          <filename>lpr whatever.ps</filename> and both should print
+        <para>That is it.  You can type <command>lpr <replaceable>plain.text</replaceable></command> and
+          <filename>lpr <replaceable>whatever.ps</replaceable></filename> and both should print
           successfully.</para>
       </sect3>
       
@@ -1940,8 +1940,8 @@
             we convert the DVI file into &postscript;.  The command sequence
             goes like this:</para>
                 
-          <screen>&prompt.user; <userinput>dvips seaweed-analysis.dvi</userinput>
-&prompt.user; <userinput>lpr seaweed-analysis.ps</userinput></screen>
+          <screen>&prompt.user; <userinput>dvips <replaceable>seaweed-analysis.dvi</replaceable></userinput>
+&prompt.user; <userinput>lpr <replaceable>seaweed-analysis.ps</replaceable></userinput></screen>
                 
           <para>By installing a conversion filter for DVI files, we can skip
             the hand conversion step each time by having 
@@ -1949,7 +1949,7 @@
             Now, each time we get a DVI file, we are just one step away from
             printing it:</para>
               
-          <screen>&prompt.user; <userinput>lpr -d seaweed-analysis.dvi</userinput></screen>
+          <screen>&prompt.user; <userinput>lpr -d <replaceable>seaweed-analysis.dvi</replaceable></userinput></screen>
                 
           <para>We got <application>LPD</application> to do the DVI file 
 	    conversion for us by specifying
@@ -3076,7 +3076,7 @@
           <literal>rattan</literal> and <literal>bamboo</literal>.  If, for
           example, a user on <hostid>orchid</hostid> typed:</para>
               
-          <screen>&prompt.user; <userinput>lpr -P bamboo -d sushi-review.dvi</userinput></screen>
+          <screen>&prompt.user; <userinput>lpr -P bamboo -d <replaceable>sushi-review.dvi</replaceable></userinput></screen>
 
         <para>the <application>LPD</application> system on <hostid>orchid</hostid>
 	  would copy the job to the spooling
@@ -3248,7 +3248,7 @@
           multiple times, or from submitting the same file multiple times in
           one job like this:</para>
               
-        <screen>&prompt.user; <userinput>lpr forsale.sign forsale.sign forsale.sign forsale.sign forsale.sign</userinput></screen>
+        <screen>&prompt.user; <userinput>lpr <replaceable>forsale.sign forsale.sign forsale.sign forsale.sign forsale.sign</replaceable></userinput></screen>
               
         <para>There are many ways to prevent this abuse (including ignoring
           it) which you are free to explore.</para>
@@ -4014,7 +4014,7 @@
 	  available from other hosts. The following command sequence
 	  demonstrates this:</para>
 	      
-	<screen>&prompt.user; <userinput>lpr -P rattan myfile</userinput>
+	<screen>&prompt.user; <userinput>lpr -P rattan <replaceable>myfile</replaceable></userinput>
 &prompt.user; <userinput>rlogin orchid</userinput>
 &prompt.user; <userinput>lpq -P rattan</userinput>
 Rank   Owner	  Job  Files                          Total Size
@@ -4048,10 +4048,10 @@
 	    
         <indexterm><primary>&tex;</primary></indexterm>
 	<para>For example, the following command prints a DVI file (from the
-	  &tex; typesetting system) named <filename>fish-report.dvi</filename>
+	  &tex; typesetting system) named <filename><replaceable>fish-report.dvi</replaceable></filename>
 	  to the printer named <literal>bamboo</literal>:</para>
 	      
-	<screen>&prompt.user; <userinput>lpr -P bamboo -d fish-report.dvi</userinput></screen>
+	<screen>&prompt.user; <userinput>lpr -P bamboo -d <replaceable>fish-report.dvi</replaceable></userinput></screen>
 	      
 	<para>These options apply to every file in the job, so you cannot mix
 	  (say) DVI and ditroff files together in a job. Instead, submit the
--- printing.patch.2.diff ends here ---


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->blackend 
Responsible-Changed-By: blackend 
Responsible-Changed-When: Mon Apr 28 10:05:48 UTC 2008 
Responsible-Changed-Why:  
Over to me since I already have a patch for that and other issues that 
should be committed soon. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=123150 
State-Changed-From-To: open->closed 
State-Changed-By: blackend 
State-Changed-When: Tue Apr 29 19:11:44 UTC 2008 
State-Changed-Why:  
Fixed, thanks. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=123150 
>Unformatted:
