Date: Thu, 18 Aug 2011 23:54:12 -0400 (EDT) From: Benjamin Kaduk <kaduk@MIT.EDU> To: Alexander Best <arundel@freebsd.org> Cc: freebsd-doc@freebsd.org, freebsd-gnats-submit@freebsd.org Subject: Re: docs/159220: Strange sentence in /usr/src/UPDATING Message-ID: <alpine.GSO.1.10.1108182353130.7526@multics.mit.edu> In-Reply-To: <20110816224010.GA84231@freebsd.org> References: <201107262349.p6QNnKTa060909@red.freebsd.org> <alpine.GSO.1.10.1107261951450.7526@multics.mit.edu> <20110816224010.GA84231@freebsd.org>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --] On Tue, 16 Aug 2011, Alexander Best wrote: > On Tue Jul 26 11, Benjamin Kaduk wrote: >> On Tue, 26 Jul 2011, Alexander Best wrote: >> >>> 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. >> >> "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." > > 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 [-- Attachment #2 --] --- UPDATING.orig 2011-08-18 23:49:35.000000000 -0400 +++ UPDATING 2011-08-18 23:52:31.000000000 -0400 @@ -1456,9 +1456,10 @@ 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:help
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.GSO.1.10.1108182353130.7526>