Bug 27021

 On Tue, 1 May 2001, Dima Dorfman wrote:
 
 > Hi Dan,
 > 
 > The reply-to address you specified when you submitted PR 27004 (``add
 > example for using PS code'') is invalid as shown in the transcript
 > below (you spelled 'freebsddiary' as 'freebsdiary', with only one
 > 'd').  Also in the aforementioned transcript is my response to your
 > PR.
 
 Sorry about that....
 
 > dan@freebsddiary.org writes:
 > > >How-To-Repeat:
 > > 	see http://www.freebsd.org/handbook/printing-intro-setup.html
 > > 	under section 9.3.1.3.2. Checking Printer Communications
 > 
 > An excerpt from the Handbook:
 > 
 > - ---
 > 9.3.1.3.2.1. Checking a Parallel Printer
 > 
 >    This section tells you how to check if FreeBSD can communicate with a
 >    printer connected to a parallel port.
 > 
 >    To test a printer on a parallel port:
 >     1. Become root with su(1).
 >     2. Send data to the printer.
 >           + If the printer can print plain text, then use lptest(1).
 >             Type:
 >     # lptest > /dev/lptN
 >             Where N is the number of the parallel port, starting from
 >             zero.
 >           + If the printer understands PostScript or other printer
 >             language, then send a small program to the printer. Type:
 >     # cat > /dev/lptN
 >             Then, line by line, type the program carefully as you cannot
 >             edit a line once you have pressed RETURN or ENTER. When you
 >             have finished entering the program, press CONTROL+D, or
 >             whatever your end of file key is.
 >             Alternatively, you can put the program in a file and type:
 >     # cat file > /dev/lptN
 >             Where file is the name of the file containing the program you
 >             want to send to the printer.
 > - ---
 > 
 > Isn't this what you wanted?  Your fix looks just like the last two
 > paragraphs combined.  Perhaps the above could be changed to suggest
 > that the sample program above that text be used, but I don't think it
 > should be duplicated, much less be duplicated right above it!
 
 The problem is that the solution (cat file > /dev/lpt0) in the
 sub-section after the example is provided.  
 
 As for avoiding duplication:
 
 1 - it's good to have the instructions near the code.  People (like
 me) will then understand how to use it.
 
 2 - the instructions in "Checking a Parallel Printer" are already
 "duplicated" in 9.3.1.3.2.2.  But please don't use this fact as ammunition
 for avoiding more "duplication".
 
 It's not duplication. One section deals with parallel.  The next with
 serial.
 
 I still think it needs something next to the sample program.