[ClusterLabs/libqb] 137b3d: API: introduce alternative, header-based versionin...

[Chrissie Caulfield]

  Branch: refs/heads/master
  Home:   https://github.com/ClusterLabs/libqb
  Commit: 137b3dea5bbe408f5e24220a5122c1dcb3d6cc5e
     
https://github.com/ClusterLabs/libqb/commit/137b3dea5bbe408f5e24220a5122c...
  Author: Jan Pokorný <jpokorny(a)redhat.com&gt;
  Date:   2016-04-01 (Fri, 01 Apr 2016)

  Changed paths:
    M configure.ac
    M include/qb/qbconfig.h.in
    M tests/.gitignore
    M tests/Makefile.am
    A tests/print_ver.c

  Log Message:
  -----------
  API: introduce alternative, header-based versioning

Mainly as a light-weight alternative to full-blown autoconf/pkg-config
machineries, whereby one can:

* workaround functionality not present in libqb up to 1.0 (inclusive)
  - note that this versioning schema is being introduced *after*
    1.0.0 release so one cannot tell that version from any older,
    but will be able to safely identify any later one (1.0.1+)
    and act accordingly
  - example:
  #if !defined(QB_VER_MAJOR) || ((QB_VER_MAJOR == 1) && (QB_VER_MINOR < 1))
  #warning "Feature X not supported"
  int do_foo(int arg) { };
  #else
  int
  do_foo(int arg)
  {
      /* use feature X of libqb */
  }
  #endif

* make its program report libqb API version it was built with by
  emitting QB_VER_STR symbolic string (see tests/print_ver.c for example)

Also added is a print_ver test program to:

* emit how original unparsed version is parsed to particular components
  defined in qbconfig.h (QB_VER_{MAJOR,MINOR,PATCH} symbolic integer
  constants and QB_VER_REST symbolic string) when being compiled

* emit mentioned QB_VER_STR symbolic string joining the components
  back to a single string, plus the components themselves

Resolves: https://github.com/ClusterLabs/libqb/issues/186


  Commit: bd31052e7d80e04c22865a3662a7e81ba909202d
     
https://github.com/ClusterLabs/libqb/commit/bd31052e7d80e04c22865a3662a7e...
  Author: Jan Pokorný <jpokorny(a)redhat.com&gt;
  Date:   2016-04-04 (Mon, 04 Apr 2016)

  Changed paths:
    M Makefile.am
    M configure.ac

  Log Message:
  -----------
  build: persuade git-version-gen vMAJOR.MINOR tags just miss .0

Recent "v1.0" discovered this discrepancy propagated all around
and also this is not very compatible with the logic of commit 26d3911.

Treat missing "patch" component of the version as an implicit zero
to make such oddity go away.

Adjust spec file generation accordingly.


  Commit: 15176fc360038dbcdae93d47fe5753853ebb32cd
     
https://github.com/ClusterLabs/libqb/commit/15176fc360038dbcdae93d47fe575...
  Author: Chrissie Caulfield <ccaulfie(a)redhat.com&gt;
  Date:   2016-04-07 (Thu, 07 Apr 2016)

  Changed paths:
    M Makefile.am
    M configure.ac
    M include/qb/qbconfig.h.in
    M tests/.gitignore
    M tests/Makefile.am
    A tests/print_ver.c

  Log Message:
  -----------
  Merge pull request #207 from jnpkrn/alternative-header-based-versioning

API: introduce alternative, header-based versioning


Compare: https://github.com/ClusterLabs/libqb/compare/67af307953e6...15176fc36003