[flashrom] Release numbering and branches

Antonio Ospite ao2 at ao2.it
Thu Aug 11 13:47:52 CEST 2016

On Wed, 10 Aug 2016 23:48:35 +0200
Nico Huber <nico.h at gmx.de> wrote:

> Hi folks,


I am just a user but (unfortunately?) I happen to have an opinion on
the matter, so here it is :)

> now that we have a git repository [1] ready (thanks Stefan!), I've
> visited again the flashrom development guidelines [2]. I stumbled
> there over a very long, exemplary version number: "". IMHO,
> two things are wrong here: 1st there are too many dots for my taste,
> and 2nd the former two numbers are meaningless.

Personally I wouldn't mind having a 0.9.10, or even a 0.10.0 as long as
they mean something, I am elaborating more below. And if you are
worried about breaking lexicographic order, "sort -V" is a viable
workaround on GNU systems, and git can sort versions too:
  git tag -l --sort="version:refname"

> To avert that, I call for naming the next release "1.0". If necessary
> it would get point releases "1.0.1", "1.0.2" etc, of course.

A fixed scheme is more manageable: use always the same number of fields.

> Regarding the naming of release tags and branches, I really like what
> the Linux people do. In their naming scheme the tag for "1.0" would
> be named `v1.0` and the branch `flashrom-1.0.y`. With different pre-
> fixes for tags/branches it's always obvious what is referred to, and
> with a wildcard (here the `y`) in the branch name the ongoing develop-
> ment is emphasized.
> Opinions? other proposals?

One thing that came to mind is: if flashrom will ever become a shared
library + a program using the library, it could be worth using
something like the "Semantic Versioning" scheme http://semver.org/

According to that scheme changing the fields in an a.b.c version number
mean this:

 a. MAJOR version when you make incompatible API changes,
 b. MINOR version when you add functionality in a backwards-compatible
    manner, and
 c. PATCH version when you make backwards-compatible bug fixes.

This way external users of the library can decide what version to
depend on, and packagers have a well-defined scheme for tracking
the soname.

Just my 2c.

As always thanks for flashrom, and congrats on the git repository.

Ciao ciao,

Antonio Ospite

A: Because it messes up the order in which people normally read text.
   See http://en.wikipedia.org/wiki/Posting_style
Q: Why is top-posting such a bad thing?

More information about the flashrom mailing list