Date: Wed, 14 Sep 2005 20:20:25 GMT From: Josh Paetzel <josh@tcbug.org> To: freebsd-doc@FreeBSD.org Subject: Re: docs/86134: [patch] fix inconsistency in handbook section 9.4 regarding links to the ports collection Message-ID: <200509142020.j8EKKPQ5078917@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/86134; it has been noted by GNATS. From: Josh Paetzel <josh@tcbug.org> To: Marc Fonvieille <blackend@freebsd.org> Cc: FreeBSD gnats submit <FreeBSD-gnats-submit@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 15:15:17 -0500 On Wednesday 14 September 2005 14:51, Marc Fonvieille wrote: > 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/printin > >g-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.h > >tml > > > > 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/printin > >g-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 That seems sane and reasonable....probably a better idea than my proposed changes. Here's the rundown: line 1515 Ports Collection with no link line 1861 Ports Collection with link line 1908 Ports Collection with link line 1933 Ports Collection with no link line 2291 Ports Collection with link line 2417 Ports Collection with no link I was aiming for consistancy, however you do have several valid points. Perhaps line 1515: There are also several filters and filter components in the FreeBSD Ports Collection. should have the link and the other 3 which currently have the link should have it removed? -- Thanks, Josh Paetzel
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200509142020.j8EKKPQ5078917>