ADF User's Guide - ADF File Version Control Numbering

(CGNS Documentation Home Page) (Steering Committee Charter) (Overview and Entry-Level Document) (A User's Guide to CGNS) (Mid-Level Library) (Standard Interface Data Structures) (SIDS File Mapping Manual) (CGIO Manual) (Parallel CGNS User's Guide) (ADF Implementation) (HDF5 Implementation) (Python Implementation) (CGNS Tools and Utilities)

(Introduction) (The ADF Software Library) (Glossary of Terms) (History of ADF Version Releases) (File System Architectures) (File Version Control Numbering) (Design Considerations) (Conventions and Implementations) (Error Messages) (Default Values and Limits) (Database-Level Routines) (Data Structure and Management Routines) (Data Query Routines) (Data I/O Routines) (Miscellaneous Routines) (Sample Fortran Program) (Sample C Program)

ADF File Version Control Numbering

The ADF file version control number scheme is described below. The format for the version number is a field of six digits or characters:

   AXXxxx

where:

	`A`		Major revision number. Major internal structure changes. This number is not expected to change very often, if at all, because the backward compatibility is only available by explicit policy decision. One alphabetic character. Range of values: `A-Z`, `a-z` In the unlikely event of reaching `z`, then use any other unused printable ASCII character, except the blank or symbols used by the "what" command @()#~>\
	`XX`		Minor revision number. New features, minor changes, and bug fixes. Backward but not forward compatible. Two-digit hexadecimal number (uppercase letters). Range of values: `00-FF` Reset to `00` with changes in major revision number.

	`xxx`		Incremental number. Incremented with every new version of the library (even if no changes are made to the file format). Files are forward and backward compatible. Three-digit hexadecimal number (lowercase letters). Range of values: `000-fff` Does not reset.

The following definitions are used:

Forward compatible Older versions of libraries can read and write to files created by newer versions of libraries.

Backward compatible Newer versions of libraries can read and write to files created by older versions of libraries.

	Forward compatible		Older versions of libraries can read and write to files created by newer versions of libraries.

	Backward compatible		Newer versions of libraries can read and write to files created by older versions of libraries.