

aecattr(5)					       aecattr(5)


NNAAMMEE
       aecattr - aegis change attributes file

DDEESSCCRRIIPPTTIIOONN
       A change	attributes file	is used	to describe the
       modifiable portion of a change.

CCOONNTTEENNTTSS
       A change	attributes file	contains the following fields:

       description = string;
	       This field contains a detailed description of the
	       change.

       brief_description = string;
	       This field contains a brief description of the
	       change.

       cause = ( ... );
	       This field describes the	cause which motivated the
	       change.

	       external_bug
		       The change was created in response to a
		       bug report from outside the development
		       team.  This repairs existing
		       functionality.

	       external_enhancement
		       The change was created in response to an
		       enhancement request from	outside	the
		       development team.  This adds new
		       functionality.

	       external_improvement
		       The change was created in response to an
		       improvement request from	outside	the
		       development team.  This improves	existing
		       functionality.

	       internal_bug
		       The change was created in response to a
		       bug report from inside the development
		       team.  This repairs existing
		       functionality.

	       internal_enhancement
		       The change was created in response to an
		       enhancement request from	inside the
		       development team.  This adds new
		       functionality.

	       internal_improvement
		       The change was created in response to an
		       improvement request from	inside the
		       development team.  This improves	existing
		       functionality.

	       chain
		       This cause is where you have a fix to fix
		       a fix; tracking these is	an interesting
		       quality metric.

       test_exempt = boolean;
	       This field is true if it	is not necessary to test
	       the change.  It is, in general, desirable to test
	       all changes, whether new	functionality or a bug
	       fix.  This is, however, a project management
	       issue.

       test_baseline_exempt = boolean;
	       This field is true if it	is not necessary to test
	       the change against the baseline before it is
	       changed.	 The test of the baseline is required to
	       fail; this is to	establish that the test	has
	       isolated	the bug, and that the change has fixed
	       that isolated bug.

       regression_test_exempt =	boolean;
	       This field is true if it	is not necessary to
	       perform a full regression test on the change.  If
	       absent, defaults	to true	for all	causes except
	       improvements.

       architecture = [	string ];
	       This field is a list of names of	system and
	       machine architectures on	which the change must
	       successfully build and test.

       copyright_years = [ integer ];
	       This field details the years in which the change
	       was worked on.  This field is present in	trunk,
	       branch and leaf nodes.

	       As a change is edited, years in which the chnage
	       was worked on accumulate	in this	field
	       automatically.  Branches	accumulate years as
	       integrations occur.  You	may need to manually edit
	       this, though it should be rare.

       version_previous	= string;
	       This field records the "previous" version, mostly
	       to simplify patch generation.  It is only
	       meaningful for trunks and branches.  It is set
	       automatically when a branch is started or
	       integrated.

SSEEEE AALLSSOO
       _a_e_n_c(1) create a	new change

       _a_e_c_a(1) modify the attributes of	a change

       _a_e_g_i_s(5)
	       aegis file format syntax

       _a_e_c_s_t_a_t_e(5)
	       change state file format

       _a_e_p_a_t_t_r(5)
	       project attributes file format


CCOOPPYYRRIIGGHHTT
       aegis version .C001
       Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997,
       1998, 1999, 2000, 2001 Peter Miller; All	rights reserved.

       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:	millerp@canb.auug.org.au
       /\/\*		 WWW:	http://www.canb.auug.org.au/~millerp/


Reference Manual	      Aegis				1