linux-kernel - Re: [PATCH] README: make the README agnostic to version numbers

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Date:	Mon, 9 Mar 2015 11:34:50 -0500
From:	Josh Poimboeuf <jpoimboe@...hat.com>
To:	Yaowei Bai <bywxiaobai@....com>
Cc:	corbet@....net, trivial@...nel.org, linux-doc@...r.kernel.org,
	linux-kernel@...r.kernel.org
Subject: Re: [PATCH] README: make the README agnostic to version numbers

On Mon, Mar 09, 2015 at 11:39:02PM +0800, Yaowei Bai wrote:
> On Fri, Mar 06, 2015 at 09:59:38AM -0600, Josh Poimboeuf wrote:
> > On Tue, Mar 03, 2015 at 10:08:02PM +0800, Yaowei Bai wrote:
> > > As we have moved to 4.x, it should be reflected in README.
> > > 
> > > Signed-off-by: Yaowei Bai <bywxiaobai@....com>
> > > ---
> > >  README | 34 +++++++++++++++++-----------------
> > >  1 file changed, 17 insertions(+), 17 deletions(-)
> > 
> > Remove all references to Linux version numbers (except for the examples)
> > in the README so we won't have to update it again for Linux 5.0.
> 
> It sounds great, but i think that would be more easily comprehensible with version
> numbers in README, especially for the ones who are not familiar with Linux kernel
> very much. Meanwhile, does it make sense for a software without version number
> in release file?

Personally I don't think the "4.x" numbers add anything to the
understanding of the document.  And anyway, Linus doesn't update them to
4.0, 4.1, etc per release, so it's not a real release file.

> On the other hand, it only need *one* patch to update the version
> numbers in README every several years, i.e. about 8 years and 4 years
> for 3.x and 4.x, respectively.

True, changing this file every 4 years or so isn't a big deal.  But
Linux doesn't do _big_ changes any more, so whether its "3.x", "4.x", or
"x.y", the use cases and release notes are the same.

-- 
Josh
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/