Improve the version computation for the release notes

The "make -C ReleaseNotes" used to produce a version descriptor like:

  X.Y (from X.Y-rcN-...)

when the ReleaseNotes-X.Y.txt wasn't changed in the vX.Y tagged commit.

For example, if we checked out the v2.10 and then built the
ReleaseNotes-2.10.txt the version string in the html file was:

  2.10 (from v2.10-rc2-...)

which wasn't really nice for a final release. I had to change the
generated html file manually.

Here is an overview of how this change improves the computation of the
version string for the ReleaseNotes-2.10.txt file:

Checked out | Version (before)         | Version (after)
------------+--------------------------+---------------------
v2.10-rc2   | 2.10 (from 2.10-rc1-...) | 2.10 (from v2.10-rc2)
v2.10       | 2.10 (from 2.10-rc2-...) | 2.10
master      | 2.10 (from 2.10-rc2-...) | 2.10

Only add the "(from N)" suffix if the ReleaseNotes-X.Y.txt is
different in HEAD and in the vX.Y. In the "(from N)" string compute the
N as "git describe HEAD" instead of describing the last commit where the
ReleaseNotes-X.Y was changed.

Change-Id: I66aff6cc57cfbd42a332ca19445dedbfbee0b088
(cherry picked from commit 25bd938158aead6583bc1f6c0b64d8b33a657ab1)
1 file changed