docs/86134: [patch] fix inconsistency in handbook section 9.4 regarding links to the ports collection

[Marc Fonvieille]

The following reply was made to PR docs/86134; it has been noted by GNATS.

From: Marc Fonvieille <blackend at FreeBSD.org>
To: Josh Paetzel <josh at tcbug.org>
Cc: FreeBSD gnats submit <FreeBSD-gnats-submit at FreeBSD.org>
Subject: Re: docs/86134: [patch] fix inconsistency in handbook section 9.4 regarding links to the ports collection
Date: Wed, 14 Sep 2005 21:51:24 +0200

 On Wed, Sep 14, 2005 at 02:28:22PM -0500, Josh Paetzel wrote:
 > 
 > >Description:
 > 
 > 
 > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/printing-advanced.html
 > 
 > Several ports from the port collection are mentioned in this section of the handbook.  In some places there is a link to: 
 > 
 > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports.html
 > 
 > In other places there is no link.  This patch makes everything consistent.
 >
 
 I don't think it's a good idea to repeat X times the same thing on the
 same page, once should be enough.  On the other hand a person configuring a
 printer should already know about Ports.
 
 
 > 
 > 
 > 
 > >How-To-Repeat:
 > 
 > 
 > Read http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/printing-advanced.html and look for the various ports that are mentioned in the document.
 > 
 > 
 > >Fix:
 > 
 > 
 > --- chapter.sgml.old    Wed Sep 14 13:57:57 2005
 > +++ chapter.sgml        Wed Sep 14 14:21:10 2005
 > @@ -1512,7 +1512,8 @@
 >          printers that can print plain text.  (It handles backspacing and tabs
 >          in the file, and does accounting, but that is about all it does.)
 >          There are also several filters and filter components in the FreeBSD
 > -        Ports Collection.</para>
 > +               Ports Collection.
 > +               (see <link linkend="ports">The Ports Collection</link>)</para>
 > 
 >        <para>Here is what you will find in this section:</para>
 > 
 > @@ -1930,8 +1931,10 @@
 >            special text filter for your printer, you can make your
 >            non &postscript; printer act like a real &postscript; printer.</para>
 > 
 > -        <para>Ghostscript is in the FreeBSD Ports Collection, if you
 > -          would like to install it from there.  You can fetch, build, and
 > +        <para>Ghostscript is in the FreeBSD Ports Collection,
 > +                 (see <link linkend="ports">The Ports Collection</link>)
 > +                 if you would like to install it from there.  You can
 > +                 fetch, build, and
 >            install it quite easily yourself, as well.</para>
 > 
 >          <para>To simulate &postscript;, we have the text filter detect if it is
 > @@ -2415,9 +2418,10 @@
 >              <tertiary>apsfilter</tertiary>
 >            </indexterm>
 >            <para>The FreeBSD Ports Collection has a text filter that performs
 > -            automatic conversion called <command>apsfilter</command>.  It can
 > -            detect plain text, &postscript;, and DVI files, run the proper
 > -            conversions, and print.</para>
 > +            automatic conversion called <command>apsfilter</command>.
 > +                       (see <link linkend="ports">The Ports Collection</link>)
 > +                       It can detect plain text, &postscript;, and DVI files,
 > +                       run the proper conversions, and print.</para>
 
 
 In fact I'd just s/<command>apsfilter</command>/<filename role="package">print/apsfilter</filename>/
 
 The same remark can be done for the previous changes.
 
 Marc
 
 PS: Your editor adds weird indentation and you should avoid to change
 7 lines just to add 1.