Skip to content
Snippets Groups Projects
Select Git revision
  • feature-field-statistics
  • develop protected
  • issue-3211-fan-jumpCyclic
  • pstream-topo-aware
  • feature-fvMatrix-setValues
  • master default protected
  • rpmbuild-2412
  • maintenance-v2406 protected
  • rpmbuild-2406
  • feature-fo-warning-messages
  • 3276-reconstructparmesh-does-not-reconstruct-finitearea
  • reworked-collated-handling
  • feature-inplace-FieldFunctions
  • maintenance-v2206 protected
  • rpmbuild-2206
  • maintenance-v2212 protected
  • rpmbuild-2212
  • maintenance-v2306 protected
  • rpmbuild-2306
  • maintenance-v2312 protected
  • OpenFOAM-v2412 protected
  • OpenFOAM-v2406 protected
  • OpenFOAM-v2312 protected
  • OpenFOAM-v2306 protected
  • OpenFOAM-v2212 protected
  • OpenFOAM-v2206 protected
  • OpenFOAM-v2112.220610 protected
  • OpenFOAM-v2112 protected
  • OpenFOAM-v2106.211215 protected
  • OpenFOAM-v2106 protected
  • OpenFOAM-v2012_210414 protected
  • OpenFOAM-v2012 protected
  • OpenFOAM-v2006 protected
  • OpenFOAM-v1912.200626 protected
  • OpenFOAM-v1912.200506 protected
  • OpenFOAM-v1912.200417 protected
  • OpenFOAM-v1812.200417 protected
  • OpenFOAM-v1906.200417 protected
  • OpenFOAM-v1912.200403 protected
  • OpenFOAM-v1812.200312 protected
40 results
Compare History
user avatar
Merge remote-tracking branch 'origin/master' into develop
Mark Olesen authored
21a84bdf
Name Last commit Last update
..
.gitignore
README.md
api-info
README.md

META-INFO

Meta-information is generally for OpenFOAM internal use only.

The format, content and meaning may be changed at anytime without prior notice. If any of these are changed, these are some of places that will need to be updated accordingly:

  • bin/foamEtcFile
  • bin/tools/foamConfigurePaths
  • bin/tools/foamPackRelease
  • etc/openfoam
  • wmake/scripts/wmake-build-info

api-info

This file and its contents are to be tracked by git.

  • File content (api) generated by wmake -build-info from the OPENFOAM define in wmake/rules/General/general
  • File content (patch) is manually generated content.

build-info

This file is never to be tracked by git, but may be present in shipped source archives.

  • File content (branch, build) generated by wmake -build-info from git information and cached from previous wmake (api)

Content types

api

Format: date +%y%m

  • 4-digit year-month (YYMM) integer corresponding to the major release or in unusual cases an intermediate release. Example, 2106 for the June-2021 release.

patch

Format: date +%y%m%d

  • 6-digit year-month-day (YYMMDD) integer corresponding to a patch-level for the given released API.
  • The first release can have a patch value of 0 or 1 which indicates that it is unpatched or just released. Alternatively it can have a patch value corresponding to the release date.

The patch value is only meaningful together with the api value. However, for development branches, the patch level should not be ascribed too much meaning, but will often correspond to the last merge with a maintenance (eg, master) branch.

Flow of information

Changes in the build information must be reflected in information available in the final binaries. Conversely, it is necessary for later distributions to have a record of the same information.

property source saved
api wmake/rules api-info
patch manual (api-info) build-info
branch git build-info
build git build-info

The command wmake -build-info -check is used to determine if the saved information needs synchronization. The command wmake -build-info -update performs the synchronization.

Notes

The saved information is split into two separate files. The api-info file contains more permanent information, whereas the build-info is more transient in nature.

2021-06-09