aegis(5) aegis(5) NNAAMMEE aegis - file format DDEESSCCRRIIPPTTIIOONN The files used by the _a_e_g_i_s program all have the same format. Some of the files used by aegis are created and maintained by humans, and some are created an maintained by aegis itself. The various manual entries say which is which. LLEEXXIICCAALL CCOONNSSIIDDEERRAATTIIOONNSS Names are any C identifier. Comments are C-style comments. Numbers are decimal, octal or hexadecimal, as for C constants. Strings are C-style strings. Whitespace (spaces, tabs and newlines) are ignored except in strings or as they serve to separate tokens. GGRRAAMMMMAARR The format of all aegis files is described by a _y_a_c_c _(_1_) grammar. %% file : field_list ; A file contains a field list. field_list : /* empty */ | field_list field ; A field list is zero or more fields. field : NAME '=' value ';' ; A field is set by giving a name and a value. value : NAME | INTEGER | STRING | structure | list ; A value may be a member of an enumeration (NAME), or an integer constant, or a literal string. More complex values may be constructed from these simple values. structure : '{' field_list '}' ; A structure is a grouped list of fields. list : '[' list_body ']' ; list_body : /* empty */ | value_list | value_list ',' ; value_list : value | value_list ',' value A list is a sequential list of values separated by commas. It may be empty, or it may have a trailing comma. SSEEMMAANNTTIICCSS The types of the values must match those in the definition of the file. See the relevant man pages for more information. Files which are rewritten by aaeeggiiss will lose any comments placed in them. When time fields are emitted by aaeeggiiss they are usually followed by a human readable date in a comment. SSEEEE AALLSSOO _a_e_g_i_s(1) a project change supervisor _a_e_c_a_t_t_r(5) change attribute file format _a_e_c_s_t_a_t_e(5) change state file format _a_e_d_i_r(5) directory structures _a_e_g_s_t_a_t_e(5) aegis state file _a_e_p_a_t_t_r(5) project attribute file format _a_e_p_c_o_n_f(5) project configuration file format _a_e_p_s_t_a_t_e(5) project state file format _a_e_s_u_b(5) available command substitutions _a_e_u_c_o_n_f(5) user configuration file format _a_e_u_s_t_a_t_e(5) user state file format 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