Bug 159220

Summary: [patch] Strange sentence in /usr/src/UPDATING
Product: Documentation Reporter: Alexander Best <arundel>
Component: Books & ArticlesAssignee: Glen Barber <gjb>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
UPDATING.diff.txt none

Description Alexander Best freebsd_committer freebsd_triage 2011-07-27 00:50:04 UTC
In /usr/src/UPDATING, almost at the very end of the file, there's the following sentence:

"This file contains a list, in reverse chronological order, of major
breakages in tracking -current.  Not all things will be listed here,
and it only starts on October 16, 2004.  Updating files can found in
previous releases if your system is older than this."

The last sentence seems quite broken. At least I haven't got a clue what it's supposed to mean.

How-To-Repeat: Read /usr/src/UPDATING!
Comment 1 Ben Kaduk 2011-07-27 00:52:41 UTC
On Tue, 26 Jul 2011, Alexander Best wrote:

> The last sentence seems quite broken. At least I haven't got a clue what it's supposed to mean.

"If you need to see entries from the UPDATING file which are older than 
2004/10/16, go get the UPDATING file from a previous &os; release, and it 
will have a better chance of including what you're looking for."

-Ben Kaduk
Comment 2 Alexander Best freebsd_committer freebsd_triage 2011-07-27 01:24:01 UTC
On Tue Jul 26 11, Benjamin Kaduk wrote:
> "If you need to see entries from the UPDATING file which are older than 
> 2004/10/16, go get the UPDATING file from a previous &os; release, and it 
> will have a better chance of including what you're looking for."

thanks. can we get this committed, please?

> 
> -Ben Kaduk
Comment 3 Glen Barber freebsd_committer freebsd_triage 2011-07-27 04:53:25 UTC
Responsible Changed
From-To: freebsd-doc->imp

Warner, any interest in adjusting the sentence with a variant of the 
proposed change?
Comment 4 Alexander Best freebsd_committer freebsd_triage 2011-08-16 23:40:11 UTC
On Tue Jul 26 11, Benjamin Kaduk wrote:
> will have a better chance of including what you're looking for."

could we please please please get this fixed before 9.0?

> 
> -Ben Kaduk
Comment 5 Ben Kaduk 2011-08-19 04:54:12 UTC
On Tue, 16 Aug 2011, Alexander Best wrote:

> could we please please please get this fixed before 9.0?

I seem to recall there was discussion of this on IRC around the time it 
was sent in, though I don't have records of it handy.
Anyway, here, have a more suitable wording in the form of a patch.

-Ben Kaduk
Comment 6 Glen Barber freebsd_committer freebsd_triage 2011-08-22 16:16:44 UTC
Responsible Changed
From-To: imp->gjb

Over to me.
Comment 7 dfilter service freebsd_committer freebsd_triage 2011-08-24 13:18:44 UTC
Author: gjb (doc committer)
Date: Wed Aug 24 12:18:29 2011
New Revision: 225142
URL: http://svn.freebsd.org/changeset/base/225142

Log:
  Reword sentence noting UPDATING entries prior to October 2007 are
  only available in older FreeBSD releases.
  
  PR:		159220
  Submitted by:	arundel
  Patch by:	Benjamin Kaduk (kaduk % mit ! edu)
  OK'd by:	imp (via -doc@)
  MFC after:	1 week
  Approved by:	re (kib)

Modified:
  head/UPDATING

Modified: head/UPDATING
==============================================================================
--- head/UPDATING	Wed Aug 24 09:54:21 2011	(r225141)
+++ head/UPDATING	Wed Aug 24 12:18:29 2011	(r225142)
@@ -1456,9 +1456,10 @@ COMMON ITEMS:
 FORMAT:
 
 This file contains a list, in reverse chronological order, of major
-breakages in tracking -current.  Not all things will be listed here,
-and it only starts on October 16, 2004.  Updating files can found in
-previous releases if your system is older than this.
+breakages in tracking -current.  It is not guaranteed to be a complete
+list of such breakages, and only contains entries since October 10, 2007.
+If you need to see UPDATING entries from before that date, you will need
+to fetch an UPDATING file from an older FreeBSD release.
 
 Copyright information:
 
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Comment 8 Glen Barber freebsd_committer freebsd_triage 2011-08-24 13:18:56 UTC
State Changed
From-To: open->patched

Patched in HEAD (r225142).  MFC in 1 week.
Comment 9 dfilter service freebsd_committer freebsd_triage 2011-08-31 02:18:04 UTC
Author: gjb (doc committer)
Date: Wed Aug 31 01:17:49 2011
New Revision: 225275
URL: http://svn.freebsd.org/changeset/base/225275

Log:
  MFC 225142:
  
  Reword sentence noting UPDATING entries prior to October 2007[1] are
  only available in older FreeBSD releases.
  
  PR:		159220
  
  [1] - October 2007 is specific to HEAD.  In stable/8 and stable/7,
  the correct year is 2004, so that change is reflected here as well.

Modified:
  stable/8/UPDATING   (contents, props changed)

Modified: stable/8/UPDATING
==============================================================================
--- stable/8/UPDATING	Tue Aug 30 23:55:45 2011	(r225274)
+++ stable/8/UPDATING	Wed Aug 31 01:17:49 2011	(r225275)
@@ -1768,9 +1768,10 @@ COMMON ITEMS:
 FORMAT:
 
 This file contains a list, in reverse chronological order, of major
-breakages in tracking -current.  Not all things will be listed here,
-and it only starts on October 16, 2004.  Updating files can found in
-previous releases if your system is older than this.
+breakages in tracking -current.  It is not guaranteed to be a complete
+list of such breakages, and only contains entries since October 16, 2004.
+If you need to see UPDATING entries from before that date, you will need
+to fetch an UPDATING file from an older FreeBSD release.
 
 Copyright information:
 
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Comment 10 dfilter service freebsd_committer freebsd_triage 2011-08-31 02:18:31 UTC
Author: gjb (doc committer)
Date: Wed Aug 31 01:18:23 2011
New Revision: 225276
URL: http://svn.freebsd.org/changeset/base/225276

Log:
  MFC 225142:
  
  Reword sentence noting UPDATING entries prior to October 2007[1] are
  only available in older FreeBSD releases.
  
  PR:		159220
  
  [1] - October 2007 is specific to HEAD.  In stable/8 and stable/7,
  the correct year is 2004, so that change is reflected here as well.

Modified:
  stable/7/UPDATING   (contents, props changed)

Modified: stable/7/UPDATING
==============================================================================
--- stable/7/UPDATING	Wed Aug 31 01:17:49 2011	(r225275)
+++ stable/7/UPDATING	Wed Aug 31 01:18:23 2011	(r225276)
@@ -1095,9 +1095,10 @@ COMMON ITEMS:
 FORMAT:
 
 This file contains a list, in reverse chronological order, of major
-breakages in tracking -current.  Not all things will be listed here,
-and it only starts on October 16, 2004.  Updating files can found in
-previous releases if your system is older than this.
+breakages in tracking -current.  It is not guaranteed to be a complete
+list of such breakages, and only contains entries since October 16, 2004.
+If you need to see UPDATING entries from before that date, you will need
+to fetch an UPDATING file from an older FreeBSD release.
 
 Copyright information:
 
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Comment 11 Glen Barber freebsd_committer freebsd_triage 2011-08-31 02:18:35 UTC
State Changed
From-To: patched->closed

MFC'd to 8-STABLE and 7-STABLE.