Bug 30202

Summary: pointer to pointer to information
Product: Documentation Reporter: Michael W Lucas <mwlucas>
Component: Books & ArticlesAssignee: Bruce A. Mah <bmah>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff
none
freebsd.ent2
none
scsi-support2 none

Description Michael W Lucas 2001-08-29 22:00:04 UTC 
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.
Comment 1 dd freebsd_committer freebsd_triage 2001-08-30 08:37:03 UTC 
Responsible Changed
From-To: freebsd-doc->dd

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.
Comment 2 Michael W Lucas 2001-11-08 13:02:40 UTC 
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
Comment 3 dd freebsd_committer freebsd_triage 2001-11-24 17:08:55 UTC 
Responsible Changed
From-To: dd->bmah

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 :-).
Comment 4 Bruce A. Mah freebsd_committer freebsd_triage 2001-11-26 01:47:05 UTC 
State Changed
From-To: open->closed

Committed with minor modifications to make the entitification consistent 
with the way the Web site build does things.  Thanks!