Chapter 29. Common Variables

This is the first paragraph of Common Variables.

STANDARD VARIABLES:

name	default		info
$$	$		a single $
$#	#		a single #
$lt	<		a single <
$gt	>		a single >
$br	\n		a line break
$bar	|		a single |
$pipe	|		a single |
$empty			Empty.  Can be used to get leading white space with
			":print".

$AAPVERSION		version of A-A-P the recipe was written for, set by
			the user
$VERSIONSTR		version of A-A-P being used, e.g., "0.100".

$EXESUF			suffix for an executable file (".exe" for MS-Windows)
$OBJSUF			suffix for an object file (".o" for Unix, ".obj" for
			MS-Windows)
$LNKSUF			suffix for a (symbolic) link (empty)

$CC	cc		command to execute the compiler
$CFLAGS			arguments always used for $CC
$LDFLAGS		arguments for $CC when linking, before the object files
$LIBS			arguments for $CC when linking, after the object files
$CPPFLAGS		arguments for $CC when compiling sources (not when
			linking objects)

$GMTIME			GMT time in seconds since 1970 Jan 1
			(the time is set once, it remains equal while
			executing)
$DATESTR		Date as a string in the form "2002 Month 11"
$TIMESTR		Time as a string in the form "23:11:09" (GMT)
$OSTYPE			Type of operating system used:
				posix		Unix-like (Linux, BSD)
				mswin		MS-Windows (98, XP)
				msdos		MS-DOS (not MS-Windows)
				os2		OS/2
				mac		Macintosh
				java		Java OS
				riscos		Risc OS
				ce		MS-Windows CE

$TARGET			list of target files, usually the name of the
			resulting program
$SOURCE			list of source files

$CACHE			List of directories to search for cached downloaded
			files.  Default for Unix:
				/var/aap/cache  ~/.aap/cache  aap/cache
			For MS-Windows, OS/2:
				$HOME/aap/cache  aap/cache
			Directories that don't exist are skipped.
			When using a relative name, it is relative to the
			current recipe.  Thus the recipe specified with
			":child dir/main.aap" uses a different cache
			directory.
			See CACHE below.

			When this variable is set, currently cached files are
			flushed.  Otherwise this only happens when exiting.
			Thus this command can be used to flush the cache:
				CACHE = $CACHE

$cache_update		Timeout after which cached files may be downloaded
			again.  See CACHING below.

Variables set by A-A-P:

$targetarg		Target(s) specified on the command line.

$aapversion		Version number of A-A-P.  E.g., 31 (version 0.031) or
			1003 (version 1.003)