trunk/.VERSION_DEFINITION

   1 #
   2 # Written by Martin Bartosch for the OpenXPKI project 2006
   3 # Copyright (c) 2006 by The OpenXPKI Project
   4 #
   5 ###########################################################################
   6 # Format definitions. The formats defined here can be used as symbolic
   7 # names for the --format option.
   8 #
   9 [FORMAT_DEFINITIONS]
  10 version: MAJOR.MINOR.RELEASESUFFIX
  11 daily_snapshot: %F-MAJOR.MINOR.RELEASESUFFIX
  12 git_commit: MAJOR.MINOR.RELEASE-GIT_ABBREVIATED_COMMIT_HASH
  13 git_tag: MAJOR.MINOR.GIT_TAG
  14
  15 ###########################################################################
  16 # Version number components
  17
  18 # built-in components (component names are 'magic'), but you can modify
  19 # the keyword(s).
  20 # Currently the following magic built-ins are defined:
  21 # 'revision'
  22 #     the global SVN revision number
  23 # 'last-changed-revision'
  24 #     obtains the highest "Last Changed Rev" below the current
  25 #     directory (recursively)
  26 # The following keywords are only expanded if Git is used:
  27 # 'git-commit-hash'
  28 #     commit hash
  29 # 'git-abbreviated-commit-hash'
  30 #     abbreviated commit hash (hint: git-show-ref -h -s --abbrev HEAD)
  31 # 'git-tag'
  32 #     tag name of the current checkout (empty string if no tag is defined,
  33 #     if more than one tags are set for the current head then only the first
  34 #     tag is reported)
  35
  36
  37 [revision]
  38 keyword:          SVN_REVISION
  39
  40 [last-changed-revision]
  41 keyword:          SVN_LAST_CHANGED_REVISION
  42
  43 [git-commit-hash]
  44 keyword:          GIT_COMMIT_HASH
  45
  46 [git-abbreviated-commit-hash]
  47 keyword:          GIT_ABBREVIATED_COMMIT_HASH
  48
  49 [git-tag]
  50 keyword:          GIT_TAG
  51 optional:         yes
  52
  53
  54 # Custom components
  55 # To create a custom version number component define the following keys:
  56 # filename:         File name to use. vergen searches upwards from  the
  57 #                   current directory until it finds the specified file.
  58 #                   The file contents will be assigned as the component
  59 #                   value.
  60 # keyword:          Symbolic name(s) describing the version component that
  61 #                   can be used to reference its value.
  62 #                   More than one keyword can be used for aliasing the
  63 #                   component. Only the first keyword defined is used
  64 #                   for --dump, though.
  65 # optional:         If set to 'yes' or 'true', this component is not mandatory
  66
  67 [major]
  68 filename:         .VERSION_MAJOR
  69 keyword:          MAJOR
  70
  71 [minor]
  72 filename:         .VERSION_MINOR
  73 keyword:          MINOR
  74
  75 [release]
  76 filename:         .VERSION_RELEASE
  77 keyword:          RELEASE
  78
  79 [suffix]
  80 filename:         .VERSION_SUFFIX
  81 keyword:          SUFFIX
  82 optional:         yes
  83