aegstate(5) File Formats Manual aegstate(5) NNAAMMEE aegstate - aegis global state file SSYYNNOOPPSSIISS /usr/local/com/aegis/state DDEESSCCRRIIPPTTIIOONN The aegis state file is used to store the pointers to project directo- ries. CCOONNTTEENNTTSS where = [{ ... }]; This field is a table relating project name to project direc- tory. 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 includ- ing 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 genera- tor, 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 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. AAUUTTHHOORR Peter Miller E-Mail: pmiller@opensource.org.au /\/\* WWW: http://miller.emu.id.au/pmiller/ Reference Manual Aegis aegstate(5)