Bug 187465

Summary: [handbook] [patch] mention patchlevels in explaining security advisories
Product: Documentation Reporter: Lowell Gilbert <freebsd-bugs-local>
Component: Books & ArticlesAssignee: Allan Jude <allanjude>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff
none
docs.security_corrected_fix.patch none

Description Lowell Gilbert 2014-03-12 00:20:00 UTC 
Someone asked for something like this.
Comment 1 Allan Jude 2014-03-19 22:21:20 UTC 
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
Comment 2 Allan Jude freebsd_committer freebsd_triage 2014-05-19 19:22:57 UTC 
Responsible Changed
From-To: freebsd-doc->allanjude

I have an improved patch for this outstanding
Comment 3 dfilter service freebsd_committer freebsd_triage 2014-05-21 04:03:42 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"
Comment 4 Allan Jude freebsd_committer freebsd_triage 2014-05-21 04:03:43 UTC 
State Changed
From-To: open->closed

commited improved version of patch