From ga9@buffy.york.ac.uk  Sat Sep 25 16:05:10 2004
Return-Path: <ga9@buffy.york.ac.uk>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 7519A16A4CF
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 25 Sep 2004 16:05:09 +0000 (GMT)
Received: from mail-gw0.york.ac.uk (mail-gw0.york.ac.uk [144.32.128.245])
	by mx1.FreeBSD.org (Postfix) with ESMTP id A88F643D55
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 25 Sep 2004 16:05:08 +0000 (GMT)
	(envelope-from ga9@buffy.york.ac.uk)
Received: from buffy.york.ac.uk (buffy.york.ac.uk [144.32.226.160])
	by mail-gw0.york.ac.uk (8.12.10/8.12.10) with ESMTP id i8PG56N9020471
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 25 Sep 2004 17:05:06 +0100 (BST)
Received: from buffy.york.ac.uk (localhost [127.0.0.1])
	by buffy.york.ac.uk (8.13.1/8.13.1) with ESMTP id i8PCRkAI011228
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 25 Sep 2004 13:27:46 +0100 (BST)
	(envelope-from ga9@buffy.york.ac.uk)
Received: (from ga9@localhost)
	by buffy.york.ac.uk (8.13.1/8.13.1/Submit) id i8PCRkIB011227;
	Sat, 25 Sep 2004 13:27:46 +0100 (BST)
	(envelope-from ga9)
Message-Id: <200409251227.i8PCRkIB011227@buffy.york.ac.uk>
Date: Sat, 25 Sep 2004 13:27:46 +0100 (BST)
From: Gavin Atkinson <gavin.atkinson@ury.york.ac.uk>
Reply-To: Gavin Atkinson <gavin.atkinson@ury.york.ac.uk>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: Updates to FAQ chapter 7
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         72081
>Category:       docs
>Synopsis:       [patch] Updates to FAQ chapter 7
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    ceri
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Sep 25 16:10:23 GMT 2004
>Closed-Date:    Mon Nov 08 20:51:45 GMT 2004
>Last-Modified:  Tue Mar 11 17:11:19 UTC 2008
>Originator:     Gavin Atkinson
>Release:        FreeBSD 5.3-BETA2 i386
>Organization:
>Environment:
System: FreeBSD buffy.york.ac.uk 5.3-BETA2 FreeBSD 5.3-BETA2 #9: Mon Sep 6 15:59:27 BST 2004 root@buffy.york.ac.uk:/usr/obj/usr/src/sys/GENERIC i386


	
>Description:
	A handful of updates to the User Applications section of the FAQ.
Update for .tbz packages, update for location of packages on ftp sites,
URL changes, and correct procedure for updating the ports collection
("ports upgrade kits" haven't existed for a long time...)

>How-To-Repeat:
	N/A
>Fix:

	(patch also at http://www.devrandom.co.uk/freebsd/faq7.diff)

--- faq7.diff begins here ---
Index: doc/en_US.ISO8859-1/books/faq/book.sgml
===================================================================
RCS file: /usr/cvs/doc/en_US.ISO8859-1/books/faq/book.sgml,v
retrieving revision 1.653
diff -u -r1.653 book.sgml
--- doc/en_US.ISO8859-1/books/faq/book.sgml	22 Sep 2004 19:38:51 -0000	1.653
+++ doc/en_US.ISO8859-1/books/faq/book.sgml	24 Sep 2004 13:49:12 -0000
@@ -4804,7 +4804,7 @@
             <filename>ports/</filename> directory.</para>
 
           <para>We also support the concept of a
-            <quote>package</quote>, essentially no more than a gzipped
+            <quote>package</quote>, essentially no more than a compressed
             binary distribution with a little extra intelligence
             embedded in it for doing whatever custom installation work
             is required. A package can be installed and uninstalled
@@ -4816,7 +4816,7 @@
             post-configuration menu item) or invoke the
             &man.pkg.add.1; command on the specific package files you
             are interested in installing. Package files can usually be
-            identified by their <filename>.tgz</filename> suffix and
+            identified by their <filename>.tgz</filename> or <filename>.tbz</filename> suffix and
             CDROM distribution people will have a
             <filename>packages/All</filename> directory on their CD
             which contains such files. They can also be downloaded
@@ -4835,11 +4835,21 @@
               </varlistentry>
 
               <varlistentry>
-                <term>for 5.X-CURRENT</term>
+                <term>for 5.X-RELEASE/5-STABLE</term>
                 <listitem>
                   <para><ulink
-                    url="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/packages-5-current/">
-                    ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/packages-5-current</ulink></para>
+                    url="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/packages-5-stable/">
+                    ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/packages-5-stable</ulink></para>
+                </listitem>
+              </varlistentry>
+            </variablelist>
+
+              <varlistentry>
+                <term>for 6.X-CURRENT</term>
+                <listitem>
+                  <para><ulink
+                    url="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/packages-6-current/">
+                    ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/packages-6-current</ulink></para>
                 </listitem>
               </varlistentry>
             </variablelist>
@@ -4886,7 +4896,7 @@
           <para>After installing the <filename
             role="package">news/inn</filename> package or port, an
             excellent place to start is <ulink
-            url="http://www.cis.ohio-state.edu/~barr/INN.html">Dave
+            url="http://www.visi.com/~barr/INN.html">Dave
             Barr's INN Page</ulink> where you will find the INN
             FAQ.</para>
         </answer>
@@ -4923,9 +4933,12 @@
 
         <answer>
           <para>If you are running a FreeBSD version that lags
-            significantly behind -CURRENT or -STABLE, you may need a ports
-            upgrade kit from <ulink url="&url.base;/ports/index.html">
-            http://www.FreeBSD.org/ports/</ulink>. If you are up to date,
+            significantly behind -CURRENT or -STABLE, you may need to update
+            your Ports Collection with &man.cvsup.1;
+            as described <ulink
+            url="&url.books.handbook;/ports-using.html#PORTS-TREE">in the
+            Handbook</ulink>.
+            If you are up to date,
             then someone might have committed a change to the port which
             works for -CURRENT but which broke the port for -STABLE. Please
             submit a bug report on this with the
--- faq7.diff ends here ---


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->analyzed 
State-Changed-By: ceri 
State-Changed-When: Sat Sep 25 17:12:15 GMT 2004 
State-Changed-Why:  
Pretty much spoton. 


Responsible-Changed-From-To: freebsd-doc->ceri 
Responsible-Changed-By: ceri 
Responsible-Changed-When: Sat Sep 25 17:12:15 GMT 2004 
Responsible-Changed-Why:  
Add to my pending queue. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=72081 

From: Mark Linimon <linimon@lonesome.com>
To: freebsd-gnats-submit@FreeBSD.org
Cc: ceri@FreeBSD.org, <gavin.atkinson@ury.york.ac.uk>
Subject: Re: docs/72081: Updates to FAQ chapter 7
Date: Mon, 8 Nov 2004 02:49:22 -0600 (CST)

 My most recent changes to the FAQ (coordinated with hrs@ before I
 knew of the existance of this PR) have rendered the second section of
 the patch obsolete.
 
 As for the fourth section of the patch, rather than introducing cvsup
 there, I would prefer to see a link to the Porter's Handbook section
 on "keeping up" which has several alternative ways to do it.  (In fact,
 there is a new one that needs to be documented there).  This would
 establish a single place for that documentation.
 
 That's at 
 http://lonesome/FreeBSD_doc/en_US.ISO8859-1/books/porters-handbook/keeping-up.html
 
 mcl
 
 
State-Changed-From-To: analyzed->closed 
State-Changed-By: ceri 
State-Changed-When: Mon Nov 8 20:51:22 GMT 2004 
State-Changed-Why:  
Committed with minor changes from both myself and linimon; thanks again. 

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