$version(5)

[Home] [Commands] [Variables] [Macro-Dev] [Glossary]

NAME

$version - MicroEmacs version date-code
$build - MicroEmacs build information

SYNOPSIS

$version "YYYYMMDD"
$build " <platform> <platform-mjr-ver> <arch> <bit-size> <toolset> <toolset-mjr-ver> "

DESCRIPTION

$version is a system variable which is defined as the MicroEmacs build date code. This value is fixed at compile time and cannot be changed. The variable may be used in macros to identify incompatibility issues.

$build is a MicroEmacs list variable detailing the platform, architecture and toolset (compiler) used to build the running version. This variable is used to locate compatible binary components such as upgrades or OpenSSL(1) dynamic libraries.

EXAMPLE

Given a macro that only operates with a MicroEmacs executable built on or after 1st August 2001 then this macro should check that $version is not less than 20010801. The check may be performed as follows:

!if &les $version "20010801" 
    ml-write "[Error: MicroEmacs executable is incompatible]" 
    !abort 
!endif

NOTES

The $version variable was introduced in 2001-08-01, evaluating this variable on an earlier version of MicroEmacs would return the string "ERROR" unless an environment variable $version has been defined. "ERROR" evaluates to 0 hence the test still operates correctly.

This variable is used in the macro file me.emf to check for any macro - executable incompatibility issues.

The $build variable was introduced in 2024-07-01 along with the find-file pseudo key which together can be used to download and install missing or out-of-date components.

Ref: $version(5) File: m5var083.5 Date: 2024/08/06