aesub(5)		      File Formats Manual		      aesub(5)


NNAAMMEE
	aesub -	aegis command substitutions

DDEESSCCRRIIPPTTIIOONN
	When other programs are	invoked	by the _a_e_g_i_s program, it is usually
	via a command string in	a configuration	file.  This section describes
	the format of these command strings.

GGEENNEERRAALL	FFOORRMM
	The command strings are	very similar to	shell variables.  An example
	will illustrate	this:
		build_command =
		    "cook project=${project} change=${change}";
	In this	command	definition, the	"${project}" part is a substitution:
	the name of the	project	will be	substituted in the command at this
	point.

	Substitutions may take several forms:

	$name
		This is	the same as saying "${name}".  The name	must start
		with an	alphabetic, and	be followed by zero or more alphanu-
		merics.

	${name}
		The name in this form may contain any non-blank	characters,
		and it may be subject to substitution.

	${name _a_r_g...}
		The name and the arguments in this form	may contain any	non-
		blank characters, and it may be	subject	to further substitu-
		tion.  Within the braces ({{ and	}}) pairs of single quote char-
		acters (''_b_l_a_h _b_l_a_h'') may be used to insulate spaces and	other
		special	characters, or you may use the back quote (\\) to
		escape a single	character.

	$$
		This is	replaced by a single $ character.  It avoid RCS	expan-
		sions, you can also use	${$}.

	%%
		This is	replaced by a single % character.  Percent (%%) fol-
		lowed by anything else is illegal.

	$#...\n	This is	a comment, usually found in template files read	in
		using the ${read_file} substitution.  It consumes all charac-
		ters up	to and including the next newline.  (See also ${com-
		ment}, below.)

	As another example, the	_d_i_r_n_a_m_e	substitution is	replaced by the	direc-
	tory name of the argument, rather like the _d_i_r_n_a_m_e(1) command.	In the
	command
		history_query_command =
		    "get -t -g ${Dirname $History}/s.${Basename	$History}";
	the _D_i_r_n_a_m_e and	_B_a_s_e_n_a_m_e substitutions are used	to construct a suit-
	able path to the SCCS file in the history directory.

AABBBBRREEVVIIAATTIIOONNSS
	The names of the various substitutions may be abbreviated.  In the
	above examples,	and in the lists which follow, the minimum abbrevia-
	tion is	the uppercase letters.	All substitution names are case	insen-
	sitive.

	The above example could	be abbreviated to
		history_query_command =
		    "get -t -g ${d $h}/s.${b $h}";

	Ambiguous abbreviations	will result in a fatal error message.

   NNoottee
	Subsitution abbreviations are best avoided: they make the commands
	hard to	read, and hard to maintain.

SSUUBBSSTTIITTUUTTIIOONNSS
	There are many substitutions which are always understood, and some
	which are specific to the command being	substituted.  Specific entries
	will be	defined	in the relevant	manual section.

	The following lists contains those substitutions which are always
	understood:

	Active_Directory
		The absolute path of the change's development directory, if
		the change is between the _b_e_i_n_g	_d_e_v_e_l_o_p_e_d and _a_w_a_i_t_i_n_g _i_n_t_e_-
		_g_r_a_t_i_o_n	states.	 The absolute path of the change's integration
		directory, if the change is in the _b_e_i_n_g _i_n_t_e_g_r_a_t_e_d state.
		Not available when the change is in the	_a_w_a_i_t_i_n_g _d_e_v_e_l_o_p_m_e_n_t
		or _c_o_m_p_l_e_t_e_d states.  This rather like the default behavior of
		the _a_e_c_d(1) command.

	Add_Path_Suffix
		This substitution may be used to add a suffix to each element
		of a colon-separated path list.	 The first argument is the
		suffix to use, the second and subsequent arguments are the
		colon-separated	paths to work on.  The result is a single
		colon separated	path.  Often used in combination with the
		${search_path} substitution, below.

	Administrator_List
		Space separated	list of	the project's administrators.  Takes
		an optional argument in	the same form as the _u_s_e_r substitu-
		tion.

	ARCHitecture
		This substitution is replaced by the architecture name appro-
		priate for the current execution environment.  Requires	no
		arguments.  See	the _a_r_c_h_i_t_e_c_t_u_r_e field of _a_e_p_c_o_n_f(5) for more
		information.  When used	in commands, you may need to surround
		this substitution with the _q_u_o_t_e substitution (see below), if
		any of your architecture names contain shell special charac-
		ters.

	BaseLine
		Absolute path of the the project's baseline.

	Basename
		This substitution takes	one argument, a	pathname.  The value
		of the substitution will be the	last element of	the pathname.
		This is	similar	to the _b_a_s_e_n_a_m_e(1) command.

	BAse_RElative
		This substitution takes	at least one pathname.	The value of
		the substitution is the	base-relative filenames, with any
		change-specific	or project baseline specific leading path
		removed.  The file does	not have to be a project source	file.
		(This is almost	the inverse of the $source substitution,
		below.)

	BINary_DIRectory
		The absolute path of Aegis' architecture-specific binary (exe-
		cutables) directory.  This corresponds to the "_._/_c_o_n_f_i_g_u_r_e
		_-_-_b_i_n_d_i_r" option when Aegis was	built.	This is	where most of
		the Aegis executable programs are installed.

	CAPitalize
		This substitution takes	at least one argument.	The value of
		the substitution will be the arguments with the	first letter
		of each	word forced to upper case and the rest forced to lower
		case.

	Change
		This substitution provides various information about the
		change,	based on the argument it is given.

		attribute
			This substitution takes	an additional argument,	the
			name of	a change attribute (see	_a_e_c_a(1)	and _a_e_c_a_t_t_r(5)
			for more information).	This returns the value listed
			in the change attributes, or the empty string if the
			change does not	have the named attribute.

		brief_description
			This returns the brief description of the change.
			(Only the first	line, and at most 80 characters.)

		cause	This returns the cause of the change.

		cstate-file
			The returns ther absolute path of the change's cstate
			file.  Use this	in your	DMT as a dependency of files
			generated from change set meta-data.

		completion_date
			synonym	for ${change date}

		date _f_o_r_m_a_t
			This returns the completion date of the	change.	 See
			_D_A_T_E section for additional arguments.

		debian-version
			This returns a Debian-esque version stamp for the
			change.

		delta	This returns the delta number of the change.  Only
			valid for completed changes.

		delta_uuid
			This returns the delta UUID of the change, assigned on
			integrate pass,	a globally unique identifier for the
			state of the project when this change was integrated
			(different for all repositories).  Only	valid for
			_b_e_i_n_g___i_n_t_e_g_r_a_t_e_d and _c_o_m_p_l_e_t_e_d _c_h_a_n_g_e_s_.

		_d_e_s_c_r_i_p_t_i_o_n
			This returns the brief description of the change.

		developer
			This returns the name of the developer of the change.

		development_directory
			This returns the development directory of the change.

		fstated-path
			This returns a colon-separated list of absolute	file
			names containing file meta-data	affecting the project.
			This can be used as dependency information in your
			DMT, to	keep meta-data generated by the	DMT from file
			meta-data. See also _a_e_l_s_f(1).

		integrator
			This returns the name of the integrator	of the change.

		integration_directory
			This returns the integration directory of the change.

		number	This returns the number	of the change.	(This is the
			default	if no argument is given.)

		reviewer
			This returns the name of the reviewer of the change.

		rpm-version
			This returns an	RPM-esque version stamp	for the
			change.

		state	This returns the state of the change.

		uuid	This returns the UUID of the change.

		version	This returns the version of the	change.

	Change_Attribute
		This substitution takes	exactly	one argument.  This argument
		is a name of a change attribute	(see _a_e_c_a(1) and _a_e_c_a_t_t_r(5)
		for more information).	This returns the value listed in the
		change attributes, or the empty	string if the change does not
		have the named attribute.

	Change_Files
		This is	replaced by a space separated list of change file
		names.	There are several qualifying arguments you can give to
		this substitution:

		_a_c_t_i_o_n	You may	give one or more file actions (e.g. _m_o_d_i_f_y).
			Only files with	one of the actions will	be returned.
			By default, all	file actions are returned.

		_t_y_p_e	You may	give one or more file types (e.g. _s_o_u_r_c_e).
			Only files with	one of the types will be returned.  By
			default, all file types	are returned.

		not	Inverts	the sense of operations.  For example
			_$_{_c_h_a_n_g_e___f_i_l_e_s _n_o_t _r_e_m_o_v_e_} will	return the names of
			all change files not being removed.

		quote	This does not affect which file	are selected, but it
			causes the file	names to be quoted if they contain
			shell meta-characters.

		If you specify both actions and	types, only files both quali-
		fiers will be returned.	 For example _$_{_c_h_a_n_g_e___f_i_l_e_s _m_o_d_i_f_y
		_t_e_s_t_} will return only the names of automatic test files which
		are being modified.

	Change_Developer_List
		Space separated	list of	all the	change's developers.  Note
		that this is different than the	Developer_List substitution.

	Change_Reviewer_List
		Space separated	list of	the change's reviewers since the last
		_d_e_v_e_l_o_p	_e_n_d.  Note that	this is	different than the Reviewer_-
		List substitution.  But	using the _r_e_v_i_e_w___p_o_l_i_c_y___c_o_m_m_a_n_d	field
		of the project configuration file this value can have more
		than one reviewer, because this	allows a project to require a
		change to need to be reviewed more than	once before it can be
		integrated.

	COMment
		Inserts	exactly	nothing; any and all arguments are ignored.
		Another	form of	comment	is "$#"	which extends to the end of
		the current line.

	Copyright_Years
		Inserts	a comma	separated list of copyright years from the
		project	attributes.  This list of years	is maintained by _a_e_g_i_s
		at integrate begin, and	so is only guaranteed to be up-to-date
		in the'_b_e_i_n_g _i_n_t_e_g_r_a_t_e_d' state.	 Do not	use this substitution
		in new file templates, it is not guaranteed to be up-to-date
		in the '_b_e_i_n_g _d_e_v_e_l_o_p_e_d' state;	use the	${date %Y} substitu-
		tion in	new file templates.

		This list contains spaces, so if you use it to build commands,
		you will probably need to quote, it as well.

	DATa_DIRectory
		The absolute path of Aegis' architecture-neutral library
		directory.  This corresponds to	the "_._/_c_o_n_f_i_g_u_r_e _-_-_d_a_t_a_d_i_r"
		option when Aegis was built.  This is where most of the
		scripts	included with Aegis are	installed.

	DAte
		With no	arguments, the output is the current date.  If there
		are arguments, they form a format string.  This	is similar to
		the _d_a_t_e(1) command on many UNIX systems.  For a description
		of the date formats, see the _D_A_T_E section, below.

	DELta
		The delta number of the	change.	 This is only available	when
		the change is in the _b_e_i_n_g _i_n_t_e_g_r_a_t_e_d state or the _c_o_m_p_l_e_t_e_d
		state.

	DEVeloper
		The name of the	developer.  Takes an optional argument in the
		same form as the _u_s_e_r substitution.

	DEVeloper_List
		Space separated	list of	the project's developers.  Takes an
		optional argument in the same form as the _u_s_e_r substitution.
		Note that this is different than the Change_DeveloperList sub-
		stitution.

	Development_Directory
		The absolute path of the change's development directory.  Only
		available when the change is between the _b_e_i_n_g _d_e_v_e_l_o_p_e_d state
		and the	_b_e_i_n_g _i_n_t_e_g_r_a_t_e_d state.

	DIFF
		The absolute path of the diff command, as discovered when
		Aegis was built.  It tries to locate GNU Diff at build time to
		provide	maximum	functionality.

	Dirname
		This substitution takes	at least one argument, a pathname.
		The value of the substitution will be everything but the last
		element	of the pathname.  This is similar to the _d_i_r_n_a_m_e(1)
		command.

	Dirname_RELative
		This substitution takes	at least one argument, a pathname.
		The value of the substitution will be everything but the last
		element	of the pathname.  This is similar to the _d_i_r_n_a_m_e sub-
		stitution, except that if there	are no directory components,
		it returns dot (".").

	DownCase
		This substitution takes	at least one argument.	The value of
		the substitution will be the argument with any upper case let-
		ters mapped to lower case.

	EMail_Address
		This substitution takes	one or more user names as arguments.
		It replaces them with email addresses.	(It is an error	if any
		user name is unknown.)

		This substitution takes	options.  You may specify one or more
		of them	immediately after the substitution name.

		--CCoommmmaa	This option may	be used	to specify that	the email
			addresses are to be separated by commas.

		--QQuuoottee	This option may	be used	to specify that	the email
			addresses are to be quoted to insulate shell special
			characters.

		See _a_e_u_c_o_n_f(5) for where this is set.

	ENVironment
		This substitution takes	at least one argument.	The value of
		the substitution is the	value of the corresponding environment
		variable, or empty of undefined.

	ERrno
		This substitution takes	no arguments.  The value of the	sub-
		stitution will be the value if the _e_r_r_n_o variable provided by
		the system, as mapped through the _s_t_r_e_r_r_o_r function.  Thus you
		may give the users informative system error messages.

	EXpression
		This substitution evaluates simple arithmetic expressions.
		Addition, subtraction, division, multiplication, modulo	and
		negation are understood.  The 6	basic comparison operators are
		available.  The	usual C	syntax and precedence are used.	 The
		arguments must constitute a valid expression, white space and
		word boundaries	are ignored.

	History_Directory
		This substitution takes	zero arguments.	 It is replaced	by the
		absolute path of the history directory of the project.

	History_Path
		This substitution takes	one argument, the name of a source
		file.  It is replaced by the absolute path of the history file
		for that source	file.  Note that you may need to massage the
		file name a little for you particular history tool, just as
		the history commands in	the _a_e_g_i_s_._c_o_n_f file do.
		This substitution takes	zero arguments.	 It is replaced	by the
		absolute path of the history directory of the project.

	IDentifier
		This substitution takes	at least one argument.	The value of
		the substitution will be the argument with all characters but
		alpha numerics mapped into an underscore (_), so as to form a
		legal C	identifier.

	INTegration_Directory
		The absolute path of the change's integration directory.  Only
		available when the change is in	the _b_e_i_n_g _i_n_t_e_g_r_a_t_e_d state.

	INTegrator
		The name of the	change's integrator.  Only available when the
		change is in the _b_e_i_n_g _i_n_t_e_g_r_a_t_e_d state	or the _c_o_m_p_l_e_t_e_d
		state.	Takes an optional argument in the same form as the
		_u_s_e_r substitution.

	INTegrator_List
		Space separated	list of	the project's integrators.  Takes an
		optional argument in the same form as the _u_s_e_r substitution.

	LEFt	This substitution extracts the left hand side of strings.  It
		takes two arguments: the first is the string, the second is
		the number of characters.

	LENgth	This substitution determines the length	of strings, the	result
		is a number.  It takes one argument: the string	to be mea-
		sured.

	LIBrary
		The absolute path of Aegis' library directory.	This corre-
		sponds to the "_._/_c_o_n_f_i_g_u_r_e _-_-_d_a_t_a_d_i_r" option when Aegis	was
		built.	This substitution is deprecated	- please use
		${datadir} instead.

	LIBrary_DIRectory
		The absolute path of Aegis' architecture-specific library
		directory.  This corresponds to	the "_._/_c_o_n_f_i_g_u_r_e _-_-_l_i_b_d_i_r"
		option when Aegis was built.

	Name_Maximum
		This substitution is used to get the maximum file name length
		within a file system.  It takes	at least one argument: the
		name of	a directory within the file system.  Frequently	used
		with ${left} to	crop filenames to the file system maximum.

	PAth_Reduce
		This function requires at least	one argument.  It is used to
		remove duplicates from a command search	path, such as may be
		found in the PATH environment variable.	 If more than one
		argument is given, all are included in the results, as if they
		were separated by colons.

	PERL	This function requires zero arguments.	It is replaced by the
		absolute path of a Perl	interpreter.

	PLural
		This function requires 2 or 3 arguments.  The first argument
		is evaluated as	a number, if it	is plural (not equal to	1) the
		second argument	is the result, otherwise the third argument is
		the result (or empty if	not given).  This is mostly used to
		pluralize sentences in Germainic error messages.

	PLural_Forms
		The _p_l_u_r_a_l___f_o_r_m_s substitution is similar to the	_$_{_p_l_u_r_a_l_} sub-
		stitution, except that it reads	and understands	the Plural-
		Forms: header in the message catalogue.	 This means that it
		understands a greater range of pluralization mechanisms	than
		the simple _$_{_p_l_u_r_a_l_} substitution.  (For a description of the
		Plural-Forms: header, see the GNU Gettext manual.)

		The first argument is the number.  Second is the singular form
		(corresponding to the Plural-Forms: expression evaluating to
		zero), the third and subsequent	arguments are the various plu-
		ral forms (corresponding to the	Plural-Forms: expression eval-
		uating to 1, 2,	3, _e_t_c.

		The Plural-Forms: expression is	required evaluate to less than
		nplurals.  If it does not, the second argument (the singular
		form) is used.	If there are too few arguments to this substi-
		tution,	the second argument (the singular form)	is again used.

		Note that in the default case (used for	English	and other Ger-
		manic languages), the arguments	are the	_r_e_v_e_r_s_e	of those
		expected by the	_$_{_p_l_u_r_a_l_} substitution.

	Project
		This substitution provides various information about the
		project, based on the argument it is given.

		name	This returns the name of the project.  (This is	the
			default	if no argument is given.)

		description
			This returns the description of	the project (the one
			which appears in the project listing).

		top_path
			This returns the absolute path of the top project
			directory, _i_._e_.	the directory above "baseline".

		trunk_name
			This returns the name of the trunk of the project
			(_i_._e_. no branch	numbers	included).

		trunk_description
			This returns the description of	the trunk of the
			project.

		trunk_top_path
			This returns the absolute path of the very top-most
			project	directory, _i_._e_.	the directory above all	the
			meta-data and history and baselines.

		version	This returns the version of the	project.

		version_long
			This returns the version of the	project, including the
			delta number.

	Project_Specific
		This substitution takes	exactly	one argument.  This argument
		is a name to be	found in the project configuration file's
		_p_r_o_j_e_c_t___s_p_e_c_i_f_i_c field (see _a_e_p_c_o_n_f(5) for more	information).
		This returns the value listed in the project configuration
		file.  Unknown attributes will be replaced with	the empty
		string.

	QUote
		This substitution may be used to quote shell special charac-
		ters.  If no quoting is	required, not quotes will be inserted.
		This is	used to	insulate shell special characters in filenames
		when forming commands.

	Read_File
		Read a file and	substitute the contents	of the file.  Requires
		exactly	one argument, the pathname of the file to be read.  If
		the pathname is	a project source file, you will	need to	use
		the _s_o_u_r_c_e substitution	to resolve the path.  It is a fatal
		error if the file does not exist, or is	not readable.  It is a
		fatal error if the pathname is not absolute (because the cur-
		rent directory is undefined).

	Read_File_Simple
		Read a file and	without	substituting the contents of the file.
		Requires exactly one argument, the pathname of the file	to be
		read.  If the pathname is a project source file, you will need
		to use the _s_o_u_r_c_e substitution to resolve the path.  It	is a
		fatal error if the file	does not exist,	or is not readable.
		It is a	fatal error if the pathname is not absolute (because
		the current directory is undefined).

	Reviewer
		The name of the	change's reviewer.  Only available when	the
		change is between the _a_w_a_i_t_i_n_g _i_n_t_e_g_r_a_t_i_o_n state and the _c_o_m_-
		_p_l_e_t_e_d state.  Takes an	optional argument in the same form as
		the _u_s_e_r substitution.

	Reviewer_List
		Space separated	list of	the project's reviewers.  Takes	an
		optional argument in the same form as the _u_s_e_r substitution.
		Note that this is different than the Change_Reviewer_List sub-
		stitution.

	RIght	This substitution extracts the right hand side of strings.  It
		takes two arguments: the first is the string, the second is
		the number of characters.

	Search_Path
		The Search_Path	substitution is	replaced by a colon separated
		list of	absolute paths to search when building a change, it
		will point from	a change to its	branch and so on up to the
		project	trunk.

	Search_Path_Executable
		The Search_Path_Executable substitution	is usually the same as
		the _s_e_a_r_c_h___P_a_t_h	substitution.  However,	during an "aegis -Test
		-BaseLine" command, it contains	the baseline as	the first ele-
		ment, rather then the development directory or the integration
		directory.  This is of most use	when looking for executables
		and executable support files while running tests.

	SHell
		The absolute path of a Bourne shell which understands func-
		tions.	Requires exactly zero arguments.

	Source
		Resolve	the argument filename into a pathname.	It is an error
		if the file is not a source file.  An optional second argument
		may be "Absolute" or "Relative", and may be abbreviated.  Rel-
		ative will attempt to provide a	development-directory-relative
		pathname whenever possible, absolute will always result	in an
		absolute path.	The default is "Relative".  (For the inverse
		mapping, see _$_{_B_A_s_e___R_E_l_a_t_i_v_e_}, above.)

	SPLit	This substitution may be used to split strings are specified
		separators.  The first argument	is the separator character to
		be used, subsequent arguments are strings to be	split.	The
		result is the collection is split strings of the second	a fol-
		lowing arguments, separated by spaces.

	STate
		The state the current change is	in.  It	is an error if the
		substitution does not refer to a change.

	SUBSTitute
		Regular	expression substitution.  The first argument is	the
		pattern	to match, the second argument is the replacement
		string.	 The third and subsequent arguments are	modified as
		specified by the first two arguments.  The search is not
		anchored, and the replacement will happen as many times	as
		possible.  Use "^" to match the	beginning, and "$" to match
		the end.

	SUBSTRing
		This substitution extracts a substring from the	middle of
		strings.  It takes three arguments: the	first is the string,
		the second is the star character (counting from	zero), the
		third is the number of characters.

	SWitch
		Select amongst a set of	values.	 The first argument is
		expected to be a number.  If the number	is zero, the second
		argument is used; if the number	is one,	the third argument is
		used; etc.  If the number is negative, or exceeds the avail-
		able arguments,	the last argument is used.

	Trim_DIRectory
		This substitution takes	one or two arguments.  If given	one
		argument, one directory	component (if present) is removed from
		the argument, which is assumed to be a file name.  If two
		arguments are present, the first is a directory	count; at most
		this many directory components (if present) will be removed.
		The base file name is always left.

	Trim_EXTension
		This substitution takes	one argument.  Any file	name extension
		(a dot characters and the characters following)	will be
		removed	from the final filename	section	of the argument.

	UNSplit	This substitution may be used to reverse the effects of	the
		_s_p_l_i_t substitution.  The first arguments is a separator	char-
		acter, the second and following	arguments are strings to be
		joined together	using the separator character.	The result is
		a single string.

	UpCase
		This substitution takes	at least one argument.	The value of
		the substitution will be the argument with any lower case let-
		ters mapped to upper case.

	USer
		This substitution provides various information about the user
		who executed the command, based	on the argument	it is given.

		login	The login name of the user.  (This is the default if
			no argument is given.)

		name	The full name of the user.

		email	The email address of the user.

		quoted_email
			The email address of the user, quoted to avoid shell
			special	characters.

		home	The home directory of the user.

	Version
		The version of the change.  If the change is in	the _b_e_i_n_g
		_i_n_t_e_g_r_a_t_e_d state or the	_c_o_m_p_l_e_t_e_d state, the version will be
		of the form "_a.._b..DD_d_d_d",	where "a" is the project's major ver-
		sion number, "b" is the	project's minor	version	number,	and
		"ddd" is the change's delta number.  If	the change is in any
		other state, the version will be of the	form "_a.._b..CC_c_c_c", where
		"ccc" is the change number.

		delta_uuid
			This variant gives the change's	delta-UUID assigned at
			integrate pass.	 Only valid for	_b_e_i_n_g___i_n_t_e_g_r_a_t_e_d and
			_c_o_m_p_l_e_t_e_d changes.

	Zero_Pad
		This substitution is used to zero pad a	string on the left.
		It takes two arguments:	the first is the string	to be padded,
		the second is the minimum string width.

DDAATTEE
	This section describes the format specifiers accepted by the date sub-
	stitution.  These are the same specifiers as defined by	the ANSI C
	standard for the strftime function.

	%%	The percent character (%)

	%a	the abbreviated	weekday	name

	%A	the full weekday name

	%b	the abbreviated	month name

	%B	the full month name

	%c	the date and time

	%d	the day	of the month, zero padded

	%H	the hour of the	24-hour	day

	%I	the hour of the	12-hour	day

	%j	the day	number of year,	zero padded, one based

	%m	the month of the year, zero padded, one	based

	%M	the minute of the hour,	zero padded

	%p	meridian indicator, AM or PM as	appropriate

	%S	the second of the minute

	%U	the Sunday week	of the year

	%w	the day	of the week, Sunday is 0

	%W	the Monday week	of the year

	%x	the date, as _m_m_m _d_d _y_y_y_y

	%X	the time, as _h_h_:_m_m_:_s_s

	%y	the year of the	century

	%Y	the year including the century

	%Z	time zone abbreviation

	Using an undefined format specifier will produce random	results,
	depending on the version of UNIX you are on.

SSEEEE AALLSSOO
	aaeessuubb(1)
		Substitute and print strings.

CCOOPPYYRRIIGGHHTT
	aegis version 4.25.D611
	Copyright (C) 1991, 1992, 1993,	1994, 1995, 1996, 1997,	1998, 1999,
	2000, 2001, 2002, 2003,	2004, 2005, 2006, 2007,	2008, 2009, 2010,
	2011, 2012, 2013, 2014 Peter Miller

	The aegis program comes	with ABSOLUTELY	NO WARRANTY; for details use
	the '_a_e_g_i_s _-_V_E_R_S_i_o_n _L_i_c_e_n_s_e' command.  This is free software and you
	are welcome to redistribute it under certain conditions; for details
	use the	'_a_e_g_i_s _-_V_E_R_S_i_o_n	_L_i_c_e_n_s_e' command.

AAUUTTHHOORR
	Peter Miller   E-Mail:	 pmiller@opensource.org.au
	/\/\*		  WWW:	 http://miller.emu.id.au/pmiller/


Reference Manual		     Aegis			      aesub(5)