From lowell@be-well.ilk.org  Wed Mar 12 00:11:55 2014
Return-Path: <lowell@be-well.ilk.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1])
	(using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by hub.freebsd.org (Postfix) with ESMTPS id 7C0D5230
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 12 Mar 2014 00:11:55 +0000 (UTC)
Received: from be-well.ilk.org (be-well.ilk.org [23.30.133.173])
	by mx1.freebsd.org (Postfix) with ESMTP id 5500F812
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 12 Mar 2014 00:11:55 +0000 (UTC)
Received: from lowell-desk.lan (lowell-desk.lan [172.30.250.41])
	by be-well.ilk.org (Postfix) with ESMTP id 4B33633C22
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 11 Mar 2014 20:11:44 -0400 (EDT)
Received: by lowell-desk.lan (Postfix, from userid 1147)
	id 230283983C; Tue, 11 Mar 2014 20:11:42 -0400 (EDT)
Message-Id: <20140312001143.230283983C@lowell-desk.lan>
Date: Tue, 11 Mar 2014 20:11:42 -0400 (EDT)
From: Lowell Gilbert <freebsd-bugs-local@be-well.ilk.org>
Reply-To: Lowell Gilbert <freebsd-bugs-local@be-well.ilk.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: mention patchlevels in explaining security advisories
X-Send-Pr-Version: 3.114
X-GNATS-Notify:

>Number:         187465
>Category:       docs
>Synopsis:       [handbook] [patch] mention patchlevels in explaining security advisories
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    allanjude
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Wed Mar 12 00:20:00 UTC 2014
>Closed-Date:    Wed May 21 03:03:58 UTC 2014
>Last-Modified:  Wed May 21 03:10:00 UTC 2014
>Originator:     Lowell Gilbert
>Release:        FreeBSD 9.2-STABLE amd64
>Organization:
The Ilk
>Environment:
System: FreeBSD lowell-desk.lan 9.2-STABLE FreeBSD 9.2-STABLE #35 r262621: Fri Feb 28 16:57:11 EST 2014 root@lowell-desk.lan:/usr/obj/usr/src/sys/LOWELL64 amd64


	
>Description:

Someone asked for something like this.

	
>How-To-Repeat:
	
>Fix:


Index: handbook/security/chapter.xml
===================================================================
--- handbook/security/chapter.xml       (revision 44213)
+++ handbook/security/chapter.xml       (working copy)
@@ -3284,7 +3284,10 @@
        <callout arearefs="co-corrected">
          <para>The <literal>Corrected</literal> field indicates the
            date, time, time offset, and release that was
-           corrected.</para>
+           corrected. The section in parentheses shows each release
+           for which a fix has been announced, with the branch from
+           which that release came and the release identifier itself,
+           including patchlevel if appropriate.</para>
        </callout>
 
        <callout arearefs="co-cve">

	


>Release-Note:
>Audit-Trail:

From: Allan Jude <freebsd@allanjude.com>
To: bug-followup@FreeBSD.org, freebsd-bugs-local@be-well.ilk.org
Cc:  
Subject: Re: docs/187465: mention patchlevels in explaining security advisories
Date: Wed, 19 Mar 2014 18:21:20 -0400

 This is a multi-part message in MIME format.
 --------------040705090909050100010306
 Content-Type: text/plain; charset=ISO-8859-1
 Content-Transfer-Encoding: 7bit
 
 Minor edits to the patch
 
 - Fix whitespace in patch it self
 - Add double space after periods
 - Improve explaination
 - Minor grammar changes
 
 Note: I noticed while editing this callouts appears to be broken. Filed
 a separate PR: http://www.freebsd.org/cgi/query-pr.cgi?pr=docs/187773
 
 
 -- 
 Allan Jude
 
 --------------040705090909050100010306
 Content-Type: text/plain; charset=windows-1252;
  name="docs.security_corrected_fix.patch"
 Content-Transfer-Encoding: 7bit
 Content-Disposition: attachment;
  filename="docs.security_corrected_fix.patch"
 
 Index: handbook/security/chapter.xml
 ===================================================================
 --- handbook/security/chapter.xml	(revision 44271)
 +++ handbook/security/chapter.xml	(working copy)
 @@ -3284,7 +3284,15 @@
  	<callout arearefs="co-corrected">
  	  <para>The <literal>Corrected</literal> field indicates the
  	    date, time, time offset, and release that was
 -	    corrected.</para>
 +	    corrected.  The section in parentheses shows each branch
 +	    to which the fix has been merged, and the version number
 +	    of the corresponding release from that branch.  The
 +	    release identifier itself, includes the version number
 +	    and, if appropriate, the patch level.  The patch level is
 +	    the letter <literal>p</literal> followed by a number,
 +	    indicating the sequence number of the patch, allowing
 +	    users to track which patches have already been applied to
 +	    the system.</para>
  	</callout>
  
  	<callout arearefs="co-cve">
 
 --------------040705090909050100010306--
Responsible-Changed-From-To: freebsd-doc->allanjude 
Responsible-Changed-By: allanjude 
Responsible-Changed-When: Mon May 19 18:22:57 UTC 2014 
Responsible-Changed-Why:  
I have an improved patch for this outstanding 


http://www.freebsd.org/cgi/query-pr.cgi?pr=187465 
State-Changed-From-To: open->closed 
State-Changed-By: allanjude 
State-Changed-When: Wed May 21 03:03:43 UTC 2014 
State-Changed-Why:  
commited improved version of patch 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/187465: commit references a PR
Date: Wed, 21 May 2014 03:03:42 +0000 (UTC)

 Author: allanjude
 Date: Wed May 21 03:03:39 2014
 New Revision: 44894
 URL: http://svnweb.freebsd.org/changeset/doc/44894
 
 Log:
   Better explain how patchlevels (9.2-RELEASE-p4) work in the security advisory
   section of the handbook
   
   PR:		docs/187465
   Submitted by:	Lowell Gilbert (original version)
   Approved by:	eadler (mentor)
 
 Modified:
   head/en_US.ISO8859-1/books/handbook/security/chapter.xml
 
 Modified: head/en_US.ISO8859-1/books/handbook/security/chapter.xml
 ==============================================================================
 --- head/en_US.ISO8859-1/books/handbook/security/chapter.xml	Wed May 21 02:59:51 2014	(r44893)
 +++ head/en_US.ISO8859-1/books/handbook/security/chapter.xml	Wed May 21 03:03:39 2014	(r44894)
 @@ -3383,7 +3383,15 @@ UWWemqWuz3lAZuORQ9KX
  	<listitem>
  	  <para>The <literal>Corrected</literal> field indicates the
  	    date, time, time offset, and releases that were
 -	    corrected.</para>
 +	    corrected.  The section in parentheses shows each branch
 +	    to which the fix has been merged, and the version number
 +	    of the corresponding release from that branch.  The
 +	    release identifier itself, includes the version number
 +	    and, if appropriate, the patch level.  The patch level is
 +	    the letter <literal>p</literal> followed by a number,
 +	    indicating the sequence number of the patch, allowing
 +	    users to track which patches have already been applied to
 +	    the system.</para>
  	</listitem>
  
  	<listitem>
 _______________________________________________
 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"
 
>Unformatted:
