Thanks. Now we just need to keep it up to date as we make changes, so I don't have to sift through hundreds of commit messages around the time of a release. :)
--Justin On Aug 8, 2011, at 9:37 AM, Ben Pfaff wrote: > OK, I pushed this change as detailed at the end of this email. > > On Sun, Aug 07, 2011 at 04:58:51PM -0700, Justin Pettit wrote: >> I suspect you may be over-thinking it, since I think most people just don't >> read documentation. :) However, if it saves even one question, it's worth >> it. In any case, it is probably a more appropriate title for what it >> includes. >> >> Thanks, >> >> --Justin >> >> >> On Aug 4, 2011, at 9:50 PM, Ben Pfaff wrote: >> >>> I've noticed that many users seem to miss changes that we clearly state >>> in ChangeLog. Some of this is probably due to users not reading any >>> documentation ever, but I wonder whether some of it is because users >>> expect ChangeLog to be akin to a commit log, because that's what GNU >>> software puts in ChangeLog. Users don't read GNU ChangeLogs, because >>> they don't contain information useful to users. >>> >>> GNU software puts what we have in ChangeLog in a file named NEWS. Some >>> users read it. Therefore: would you mind if we renamed ChangeLog to >>> NEWS? >>> >>> Thanks, >>> >>> Ben. >> > > --8<--------------------------cut here-------------------------->8-- > > From: Ben Pfaff <b...@nicira.com> > Date: Mon, 8 Aug 2011 09:35:01 -0700 > Subject: [PATCH] ChangeLog: Rename NEWS. > > Many users seem to miss changes that Open vSwitch clearly states in > ChangeLog. Some of this is probably due to users not reading any > documentation ever, but I wonder whether some of it is because users > expect ChangeLog to be akin to a commit log, because that's what GNU > software puts in ChangeLog. Users don't read GNU ChangeLogs, because > they don't contain information useful to users. > > GNU software puts what we have in ChangeLog in a file named NEWS. Some > users read it. Therefore, this commit renames ChangeLog to NEWS. > > Also, strip trailing whitespace for Ethan-compliance. > --- > ChangeLog => NEWS | 4 ++-- > 1 files changed, 2 insertions(+), 2 deletions(-) > rename ChangeLog => NEWS (99%) > > diff --git a/ChangeLog b/NEWS > similarity index 99% > rename from ChangeLog > rename to NEWS > index 6dab0b3..b31b127 100644 > --- a/ChangeLog > +++ b/NEWS > @@ -88,7 +88,7 @@ v1.1.0 - 05 Apr 2011 > bugs. New ovs-vlan-bug-workaround command for enabling and > disabling a workaround for these driver bugs. > - OpenFlow support: > - - "Resubmit" actions now update flow statistics. > + - "Resubmit" actions now update flow statistics. > - New "register" extension for use in matching and actions, via NXM. > - New "multipath" experimental action extension. > - New support for matching multicast Ethernet frames, via NXM. > @@ -167,7 +167,7 @@ v0.99.0 - 14 Jan 2010 > --------------------- > - User-space forwarding engine > - Bug fixes > - > + > v0.90.7 - 29 Nov 2009 > --------------------- > - Add support for NetFlow active timeouts > -- > 1.7.4.4 > _______________________________________________ dev mailing list dev@openvswitch.org http://openvswitch.org/mailman/listinfo/dev
