From paul@inetstat.net  Thu May 15 10:56:23 2014
Return-Path: <paul@inetstat.net>
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
	(using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by hub.freebsd.org (Postfix) with ESMTPS id BA823840
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 15 May 2014 10:56:23 +0000 (UTC)
Received: from srv00.inetstat.net (srv00.inetstat.net [IPv6:2001:41d0:1:dbae::1])
	(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
	(Client CN "srv00.inetstat.net", Issuer "srv00.inetstat.net" (not verified))
	by mx1.freebsd.org (Postfix) with ESMTPS id 7F0042A93
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 15 May 2014 10:56:23 +0000 (UTC)
Received: from srv00.inetstat.net (localhost [127.0.0.1])
	by srv00.inetstat.net (Postfix) with ESMTP id 2F622D788F
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 15 May 2014 10:56:21 +0000 (UTC)
Received: from srv00.inetstat.net ([127.0.0.1])
	by srv00.inetstat.net (srv00.inetstat.net [127.0.0.1]) (amavisd-new, port 10026)
	with ESMTP id YeSJ0F-5wc93; Thu, 15 May 2014 10:56:06 +0000 (UTC)
Received: by srv00.inetstat.net (Postfix, from userid 1001)
	id 5D120D788E; Thu, 15 May 2014 10:56:02 +0000 (UTC)
Message-Id: <20140515105602.5D120D788E@srv00.inetstat.net>
Date: Thu, 15 May 2014 10:56:02 +0000 (UTC)
From: Paul J Murphy <paul@inetstat.net>
Reply-To: Paul J Murphy <paul@inetstat.net>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: 10.0 release notes reference deprecated atacontrol(8)
X-Send-Pr-Version: 3.114
X-GNATS-Notify:

>Number:         189833
>Category:       docs
>Synopsis:       10.0 release notes reference deprecated atacontrol(8)
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    gjb
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu May 15 11:00:00 UTC 2014
>Closed-Date:    Mon May 26 00:19:34 UTC 2014
>Last-Modified:  Mon May 26 00:20:00 UTC 2014
>Originator:     Paul J Murphy
>Release:        FreeBSD 10.0-RELEASE
>Organization:
iNetStat.net
>Environment:
http://www.freebsd.org/releases/10.0R/relnotes.html
>Description:
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.
>How-To-Repeat:
>Fix:
Possibly refer to camcontrol(8) instead?
(note that camcontrol does not have the referenced "spindown" command, so perhaps "idle" or "sleep")
>Release-Note:
>Audit-Trail:

From: Sergey Kandaurov <pluknet@nginx.com>
To: bug-followup@FreeBSD.org, paul@inetstat.net
Cc:  
Subject: Re: docs/189833: 10.0 release notes reference deprecated atacontrol(8)
Date: Thu, 15 May 2014 15:11:38 +0400

 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.

From: venture37 <venture37@geeklan.co.uk>
To: bug-followup@FreeBSD.org, paul@inetstat.net
Cc:  
Subject: Re: docs/189833: 10.0 release notes reference deprecated atacontrol(8)
Date: Mon, 26 May 2014 01:09:37 +0100

 This is a multi-part message in MIME format.
 --------------090703060408090907030204
 Content-Type: text/plain; charset=ISO-8859-1; format=flowed
 Content-Transfer-Encoding: 7bit
 
 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).
 
 --------------090703060408090907030204
 Content-Type: text/plain; charset=UTF-8;
  name="10relnotes.txt"
 Content-Transfer-Encoding: 7bit
 Content-Disposition: attachment;
  filename="10relnotes.txt"
 
 Index: en_US.ISO8859-1/htdocs/releases/10.0R/relnotes.html
 ===================================================================
 --- en_US.ISO8859-1/htdocs/releases/10.0R/relnotes.html	(revision 44952)
 +++ en_US.ISO8859-1/htdocs/releases/10.0R/relnotes.html	(working copy)
 @@ -168,9 +168,8 @@
  	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
 +	until the next request.
 +	</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
 @@ -368,4 +367,4 @@
        contacting &lt;<a href="mailto:questions@FreeBSD.org">questions@FreeBSD.org</a>&gt;.</small></p><p xmlns="http://www.w3.org/TR/xhtml1/transitional" align="center"><small>All users of FreeBSD release should
        subscribe to the &lt;<a href="mailto:stable@FreeBSD.org">stable@FreeBSD.org</a>&gt;
        mailing list.</small></p><p xmlns="http://www.w3.org/TR/xhtml1/transitional" align="center"><small>For questions about this documentation,
 -      e-mail &lt;<a href="mailto:doc@FreeBSD.org">doc@FreeBSD.org</a>&gt;.</small></p></body></html>
 \ No newline at end of file
 +      e-mail &lt;<a href="mailto:doc@FreeBSD.org">doc@FreeBSD.org</a>&gt;.</small></p></body></html>
 
 --------------090703060408090907030204--
State-Changed-From-To: open->closed 
State-Changed-By: gjb 
State-Changed-When: Mon May 26 00:18:42 UTC 2014 
State-Changed-Why:  
Fixed in the doc/ tree as r44953. 



Responsible-Changed-From-To: freebsd-doc->gjb 
Responsible-Changed-By: gjb 
Responsible-Changed-When: Mon May 26 00:18:42 UTC 2014 
Responsible-Changed-Why:  
Fixed in the doc/ tree as r44953. 


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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/189833: commit references a PR
Date: Mon, 26 May 2014 00:18:24 +0000 (UTC)

 --===============4499425944704309564==
 Content-Type: text/plain; charset=UTF-8
 Content-Transfer-Encoding: 8bit
 
 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
 
 --===============4499425944704309564==
 Content-Type: text/plain; charset="us-ascii"
 MIME-Version: 1.0
 Content-Transfer-Encoding: 7bit
 Content-Disposition: inline
 
 _______________________________________________
 svn-doc-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-doc-all
 To unsubscribe, send any mail to "svn-doc-all-unsubscribe@freebsd.org"
 --===============4499425944704309564==--
 
>Unformatted:
