From mwlucas@blackhelicopters.org  Wed Aug 29 13:59:26 2001
Return-Path: <mwlucas@blackhelicopters.org>
Received: from blackhelicopters.org (geburah.blackhelicopters.org [209.69.178.18])
	by hub.freebsd.org (Postfix) with ESMTP id 2687837B401
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 29 Aug 2001 13:59:26 -0700 (PDT)
	(envelope-from mwlucas@blackhelicopters.org)
Received: (from mwlucas@localhost)
	by blackhelicopters.org (8.9.3/8.9.3) id QAA04248;
	Wed, 29 Aug 2001 16:59:25 -0400 (EDT)
	(envelope-from mwlucas)
Message-Id: <200108292059.QAA04248@blackhelicopters.org>
Date: Wed, 29 Aug 2001 16:59:25 -0400 (EDT)
From: mwlucas@blackhelicopters.org
Reply-To: mwlucas@blackhelicopters.org
To: FreeBSD-gnats-submit@freebsd.org
Subject: "supported SCSI devices" section of FAQ inaccurate
X-Send-Pr-Version: 3.2

>Number:         30202
>Category:       docs
>Synopsis:       pointer to pointer to information
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    bmah
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Wed Aug 29 14:00:04 PDT 2001
>Closed-Date:    Sun Nov 25 17:47:05 PST 2001
>Last-Modified:  Sun Nov 25 17:47:59 PST 2001
>Originator:     Michael Lucas
>Release:        FreeBSD 3.5-STABLE i386
>Organization:
None
>Environment:

-doc tree, supped last night

>Description:

The FAQ says to check the Handbook for the supported SCSI device list.
The Handbook says to check the release notes.  Wouldn't it be simpler
to just point to the release notes?

>How-To-Repeat:

read the FAQ.  The fix below points to the www site containing links
to all the release notes.  It appears that's the only place where
truly "current" relnotes are available for all releases.

>Fix:

*** book.sgml-dist	Wed Aug 29 13:19:01 2001
--- book.sgml	Wed Aug 29 14:17:34 2001
***************
*** 2381,2387 ****
  
          <answer>
            <para>See the complete list in the <ulink
!             URL="../handbook/install.html#INSTALL-HW">Handbook</ulink>.</para>
          </answer>
        </qandaentry>
  
--- 2381,2390 ----
  
          <answer>
            <para>See the complete list in the <ulink
!             URL="http://www.freebsd.org/releases/index.html">Release
!             Notes</ulink> for the version of FreeBSD being
!             installed.</para>
! 
          </answer>
        </qandaentry>  
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->dd 
Responsible-Changed-By: dd 
Responsible-Changed-When: Thu Aug 30 00:37:03 PDT 2001 
Responsible-Changed-Why:  
This is a good change in theory, but I don't like the new URL.  The real 
release notes should be on the web site soon, and when that happens I'll 
fix the URL and commit this. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=30202 

From: Michael Lucas <mwlucas@blackhelicopters.org>
To: freebsd-gnats-submit@freebsd.org
Cc:  
Subject: re: docs/30202
Date: Thu, 8 Nov 2001 08:02:40 -0500

 --rwEMma7ioTxnRzrJ
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 
 This never made it onto the PR, but it did spark a bit of discussion
 on -doc.
 
 After some thought, it seems that the best way to solve this would be
 to entity-ize the release and hardware notes for the latest -stable
 release.  bmah seems to agree, based on the -doc discussion, and we
 could use this in several other FAQs.  Attached please find a patch
 that implements this, and a patch that uses this.
 
 This is my oldest open PR.  I'd like to close it and annoy you with
 new, exciting PRs instead of annoying you with old, boring PRs.
 
 ==ml
 
 -- 
 Michael Lucas
 mwlucas@blackhelicopters.org
 http://www.blackhelicopters.org/~mwlucas/
 Big Scary Daemons: http://www.oreillynet.com/pub/q/Big_Scary_Daemons
 
 --rwEMma7ioTxnRzrJ
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename="freebsd.ent2"
 
 *** share/sgml/freebsd.ent-dist	Mon Nov  5 14:17:03 2001
 --- share/sgml/freebsd.ent	Mon Nov  5 14:18:11 2001
 ***************
 *** 16,21 ****
 --- 16,23 ----
        it's really release time -->
   <!ENTITY rel.current CDATA "4.4">
   <!ENTITY rel.current.date CDATA "September, 2001">
 + <!ENTITY rel.current.notes "http://www.freebsd.org/releases/4.4R/notes.html"> 
 + <!ENTITY rel.current.hw "http://www.freebsd.org/releases/4.4R/hardware.html"> 
   
   <!-- Sections that we don't want to be published -->
   <!ENTITY % not.published 	"IGNORE">
 
 --rwEMma7ioTxnRzrJ
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename=scsi-support2
 
 *** en_US.ISO8859-1/books/faq/book.sgml-dist	Mon Nov  5 10:49:36 2001
 --- en_US.ISO8859-1/books/faq/book.sgml	Mon Nov  5 14:22:22 2001
 ***************
 *** 2429,2435 ****
   
           <answer>
             <para>See the complete list in the <ulink
 !             URL="../handbook/install.html#INSTALL-HW">Handbook</ulink>.</para>
           </answer>
         </qandaentry>
   
 --- 2429,2435 ----
   
           <answer>
             <para>See the complete list in the <ulink
 !             URL="&rel.current.hw;">current Hardware Notes</ulink>.</para>
           </answer>
         </qandaentry>
   
 
 --rwEMma7ioTxnRzrJ--
Responsible-Changed-From-To: dd->bmah 
Responsible-Changed-By: dd 
Responsible-Changed-When: Sat Nov 24 09:08:55 PST 2001 
Responsible-Changed-Why:  
I think the originator has a good idea, but I seem to recall some discussion 
about this on -doc, which I didn't follow.  Over to Mr. Relnotes, who 
should have followed the discussion, and consequently should know what 
to do :-). 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=30202 
State-Changed-From-To: open->closed 
State-Changed-By: bmah 
State-Changed-When: Sun Nov 25 17:47:05 PST 2001 
State-Changed-Why:  
Committed with minor modifications to make the entitification consistent 
with the way the Web site build does things.  Thanks! 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=30202 
>Unformatted:
