aegstate(5) aegstate(5) NNAAMMEE aegstate - aegis state file SSYYNNOOPPSSIISS /usr/local/com/aegis/state DDEESSCCRRIIPPTTIIOONN The aegis state file is used to store the pointers to project directories. CCOONNTTEENNTTSS where = [{ ... }]; This field is a table relating project name to project directory. The structure is as follows: project_name = string; The name of a project. directory = string; Absolute path of the project's directory. (Only set of _a_l_i_a_s___f_o_r is not set.) alias_for = string; This is the name of another project, possibly including branch numbers. It allows you to have shorter or more meaningful project names. (Only set if _d_i_r_e_c_t_o_r_y is not set.) WWRRIITTIINNGG RREEPPOORRTT SSCCRRIIPPTTSS When attempting to access these fields from within the report generator, you need a code fragment similar to the following: auto p; p = project[project_name()]; That is, the where field is represented by the project array variable, however, it does not mention the aliases, only the actual projects, similar to the ``_a_e_l _p_r_o_j_e_c_t_s'' command. (You can, however, index the projects array by an alias, or even by a project name with branches on the end.) In addition to the _p_r_o_j_e_c_t___n_a_m_e and _d_i_r_e_c_t_o_r_y fields specified above, the report generator insets a _s_t_a_t_e field, which gives you access to the project state fields (see _a_e_p_s_t_a_t_e(5) for more information). SSEEEE AALLSSOO _a_e_g_i_s(5) aegis file format syntax CCOOPPYYRRIIGGHHTT 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. AAUUTTHHOORR Peter Miller E-Mail: millerp@canb.auug.org.au /\/\* WWW: http://www.canb.auug.org.au/~millerp/ Reference Manual Aegis 1