Bug 189833

Summary: 10.0 release notes reference deprecated atacontrol(8)
Product: Documentation Reporter: Paul J Murphy <paul>
Component: Books & ArticlesAssignee: Glen Barber <gjb>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
10relnotes.txt
none
file.dat none

Description Paul J Murphy 2014-05-15 12:00:00 UTC
The 10.0 release notes reference the deprecated atacontrol(8) command in section "2.2.5. Disks and Storage"

atacontrol does not exist on 10.0-RELEASE, and the link in the release notes (http://www.freebsd.org/cgi/man.cgi?query=atacontrol&sektion=8) results in "no data found".

http://www.freebsd.org/cgi/man.cgi?query=atacontrol&apropos=0&sektion=8&manpath=FreeBSD+9.1-stable&arch=default&format=html
(9.1-stable edition of the man page) says:

NOTES
     The atacontrol utility was	deprecated in FreeBSD 9.0.  When

        options ATA_CAM

     is	compiled into the kernel, then camcontrol(8) must be used instead.

Fix: 

Possibly refer to camcontrol(8) instead?
(note that camcontrol does not have the referenced "spindown" command, so perhaps "idle" or "sleep")
Comment 1 pluknet 2014-05-15 12:11:38 UTC
sigh
This is because 10.0's relnotes were mostly borrowed from 8.0's 
relnotes, and nobody cared to sit down and read the generated output 
just once.
Comment 2 Sevan Janiyan 2014-05-26 01:09:37 UTC
Attached diff removes the reference to atacontrol(8) & adds a newline to 
the end of the file (wasn't sure if it is required or not, it was added 
automatically by the diff procces hence why I left it in).
Comment 3 dfilter service freebsd_committer freebsd_triage 2014-05-26 01:18:24 UTC
Author: gjb
Date: Mon May 26 00:18:22 2014
New Revision: 44953
URL: http://svnweb.freebsd.org/changeset/doc/44953

Log:
  Remove reference to atacontrol(8).
  
  PR:		189833
  Submitted by:	Paul J Murphy <paul@inetstat.net>
  Patched by:	<venture37@geeklan.co.uk>
  Approved by:	re (implicit)
  Sponsored by:	The FreeBSD Foundation

Modified:
  head/en_US.ISO8859-1/htdocs/releases/10.0R/relnotes.html

Modified: head/en_US.ISO8859-1/htdocs/releases/10.0R/relnotes.html
==============================================================================
--- head/en_US.ISO8859-1/htdocs/releases/10.0R/relnotes.html	Sun May 25 20:55:35 2014	(r44952)
+++ head/en_US.ISO8859-1/htdocs/releases/10.0R/relnotes.html	Mon May 26 00:18:22 2014	(r44953)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /><title>FreeBSD 10.0-RELEASE Release Notes</title><link rel="stylesheet" type="text/css" href="docbook.css" /><link rev="made" href="doc@FreeBSD.org" /><meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /><meta name="description" content="The release no tes for FreeBSD 10.0-RELEASE contain a summary of the changes made to the FreeBSD base system on the 10.0-STABLE development line. This document lists applicable security advisories that were issued since the last release, as well as significant changes to the FreeBSD kernel and userland. Some brief remarks on upgrading are also presented." /></head><body><div class="article"><div xmlns="" class="titlepage"><div><div><h1 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="idp6
 1507280"></a>FreeBSD 10.0-RELEASE Release Notes</h1></div><div><div xmlns="http://www.w3.org/1999/xhtml" class="author"><h3 class="author"><span class="orgname">The FreeBSD Project</span></h3></div></div><div><p xmlns="http://www.w3.org/1999/xhtml" class="copyright">Copyright © 2013-2014 The FreeBSD Documentation
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /><title>FreeBSD 10.0-RELEASE Release Notes</title><link rel="stylesheet" type="text/css" href="docbook.css" /><link rev="made" href="doc@FreeBSD.org" /><meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /><meta name="description" content="The release no tes for FreeBSD 10.0-RELEASE contain a summary of the changes made to the FreeBSD base system on the 10.0-STABLE development line. This document lists applicable security advisories that were issued since the last release, as well as significant changes to the FreeBSD kernel and userland. Some brief remarks on upgrading are also presented." /></head><body><div class="article"><div xmlns="" class="titlepage"><div><div><h1 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="idp6
 1490720"></a>FreeBSD 10.0-RELEASE Release Notes</h1></div><div><div xmlns="http://www.w3.org/1999/xhtml" class="author"><h3 class="author"><span class="orgname">The FreeBSD Project</span></h3></div></div><div><p xmlns="http://www.w3.org/1999/xhtml" class="copyright">Copyright © 2013-2014 The FreeBSD Documentation
       Project</p></div><div><div xmlns="http://www.w3.org/1999/xhtml" class="legalnotice"><a id="trademarks"></a><p xmlns="http://www.w3.org/TR/xhtml1/transitional">FreeBSD is a registered trademark of
   the FreeBSD Foundation. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">IBM, AIX, OS/2,
   PowerPC, PS/2, S/390, and ThinkPad are
@@ -165,12 +165,7 @@ hv_vmbus_load="YES"</pre><p xmlns="http:
 	has been introduced. <a href="http://svn.freebsd.org/viewvc/base?view=revision&amp;revision=250700">[r250700]</a></p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">Support for setting/matching
 	differentiated services codepoints (DSCP) in IP header has
 	been added to <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=ipfw&amp;sektion=8"><span class="citerefentry"><span class="refentrytitle">ipfw</span>(8)</span></a>. <a href="http://svn.freebsd.org/viewvc/base?view=revision&amp;revision=248552">[r248552]</a></p></div><div class="sect3"><div xmlns="" class="titlepage"><div><div><h4 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="disks"></a>2.2.5. Disks and Storage</h4></div></div></div><p  xmlns="http://www.w3.org/TR/xhtml1/transitional">The <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=aac&amp;sektion=4"><span class="citerefentry"><span class="refentrytitle">aac</span>(4)</span></a> driver now supports volumes
-	larger than 2TB in size. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">The <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=ata&amp;sektion=4"><span class="citerefentry"><span class="refentrytitle">ata</span>(4)</span></a> driver now supports a spindown command for
-	disks; after a configurable amount of time, if no requests
-	have been received for a disk, the disk will be spun down
-	until the next request.  The <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=atacontrol&amp;sektion=8"><span class="citerefentry"><span class="refentrytitle">atacontrol</span>(8)</span></a> utility now
-	supports a <code xmlns="http://www.w3.org/1999/xhtml" class="command">spindown</code> command to configure
-	this feature. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">The <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=hptrr&amp;sektion=4"><span class="citerefentry"><span class="refentrytitle">hptrr</span>(4)</span></a> driver has been updated to
+	larger than 2TB in size. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional">The <a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=hptrr&amp;sektion=4"><span class="citerefentry"><span class="refentrytitle">hptrr</span>(4)</span></a> driver has been updated to
 	version 1.2 from Highpoint. </p><p xmlns="http://www.w3.org/TR/xhtml1/transitional"><a xmlns="http://www.w3.org/1999/xhtml" class="citerefentry" href="http://www.FreeBSD.org/cgi/man.cgi?query=nvme&amp;sektion=4"><span class="citerefentry"><span class="refentrytitle">nvme</span>(4)</span></a> has been added and provides
 	NVM Express support.  NVM Express is an optimized register
 	interface, command set and feature set of PCI Express
Comment 4 Glen Barber freebsd_committer freebsd_triage 2014-05-26 01:18:42 UTC
State Changed
From-To: open->closed

Fixed in the doc/ tree as r44953. 



Comment 5 Glen Barber freebsd_committer freebsd_triage 2014-05-26 01:18:42 UTC
Responsible Changed
From-To: freebsd-doc->gjb

Fixed in the doc/ tree as r44953.