aeuconf(5) File Formats Manual aeuconf(5) NNAAMMEE aeuconf - user configuration file SSYYNNOOPPSSIISS _$_A_E_G_I_S___F_L_A_G_S _$_H_O_M_E_/_._a_e_g_i_s_r_c _/_u_s_r_/_l_o_c_a_l_/_s_h_a_r_e_/_a_e_g_i_s_/_a_e_g_i_s_r_c _/_u_s_r_/_l_o_c_a_l_/_l_i_b_/_a_e_g_i_s_/_a_e_g_i_s_r_c DDEESSCCRRIIPPTTIIOONN A user configuration file is used to hold user defaults. This file is created and edited by the user. This file is only ever read by aegis, it is never written. The sources of user preferences are scanned in the order given above. Earlier sources have higher priority. AAEEGGIISS__FFLLAAGGSS This environment variable has the same format. It is read first, and over-rides the _._a_e_g_i_s_r_c file contents. This is intended to be used within the tests distributed with aegis, but can also be of use within some shell scripts. It contains session specific preferences. _$_H_O_M_E_/_._a_e_g_i_s_r_c This file contains user specific preferences. _/_u_s_r_/_l_o_c_a_l_/_s_h_a_r_e_/_a_e_g_i_s_/_a_e_g_i_s_r_c This file contains architecture-neutral preferences. _/_u_s_r_/_l_o_c_a_l_/_l_i_b_/_a_e_g_i_s_/_a_e_g_i_s_r_c This file contains architecture-specific preferences. CCOONNTTEENNTTSS The file contains the following fields: default_development_directory = string; The pathname of where to place new development directories. The pathname may be relative, in which case it is relative to _$_H_O_M_E. The default is the field of the same name in the project attributes, or _$_H_O_M_E neither is set. default_project_directory = string; The pathname of where to place new project directories. The pathname may be relative. If this path is relative, it is relative to _$_H_O_M_E. The default is _$_H_O_M_E. delete_file_preference = (no_keep, interactive, keep); All of the commands which delete files will consult this field to determine if the file should be deleted. Defaults to _n_o___k_e_e_p if not set. default_project_name = string; The name of a project. default_change_number = integer; The number of a change. Please note that the _d_e_f_a_u_l_t___p_r_o_j_e_c_t___n_a_m_e field and the _d_e_f_a_u_l_t___c_h_a_n_g_e___n_u_m_b_e_r field are unrelated. Specifying both does not mean that single change within that single project, they have nothing to do with each other. diff_preference = (automatic_merge, no_merge, only_merge); The _a_e_d_(_1_) command will consult this field to determine what to do: nnoo__mmeerrggee means only diff the files, even if some have out of date versions. oonnllyy__mmeerrggee means merge those files with out of date versions, and do not do anything else, even if they need to be diffed. aauuttoommaattiicc__mmeerrggee means to do _o_n_l_y___m_e_r_g_e if any source files require merging, otherwise do _n_o___m_e_r_g_e. It never combines merges and differences in the same pass. The corresponding command line options to the _a_e_d(1) command take precedence, this field is only consulted if you do not give a corresponding command line argument. Defaults to _a_u_t_o_- _m_a_t_i_c___m_e_r_g_e if not set. pager_preference = (foreground, never); This field is consulted for listings and help. The standard output is only piped to a pager if the command is run in the foreground and the standard output is directed at a terminal. foreground The standard output will be piped through the command given in the PAGER environment variable (or _m_o_r_e if not set). never The standard output will not be redirected. This field defaults to _f_o_r_e_g_r_o_u_n_d if not set. persevere_preference = (all, stop); This field is consulted by the _a_e_t(1) command, to determine if it should run all tests, or stop after the first failure. This field defaults to _a_l_l if not set. log_file_preference = (snuggle, append, replace, never); This field controls the behavior of the log file. It usually defaults to _s_n_u_g_g_l_e if not set, although some commands may default it to _a_p_p_e_n_d. When the log file is in use, the output continues to be sent to the screen if the process is in the foreground and the standard output is a terminal. never Do not redirect the output to a log file. replace Replace any log file that is present, create a new one if none already exists. append Append the log to the end of any existing log file, create a new one if none already exists. snuggle Append the log to the end of any existing log file if that log file was last modified less than 30 seconds ago, otherwise replace any existing log file; create a new one if none already exists. This option allows runs of aegis commands to produce a meaningful log file. lock_wait_preference = (always, background, never); This field is consulted by all commands which wait for locks. always The "always" setting says that all commands should always wait for locks. This is the default. background The "background" setting says that background commands should always wait for locks, and foreground commands will not. never The "never" setting says that no command should ever wait for locks. If the command would wait, it will exit with status 1. This user preference can be over-ridden by the --wwaaiitt and --nnoowwaaiitt command line options. symbolic_link_preference = (verify, assume); This field is consulted by _a_e_b(1) when the project configura- tion file specifies _c_r_e_a_t_e___s_y_m_b_o_l_i_c___l_i_n_k_s___b_e_f_o_r_e___b_u_i_l_d as true. The verification of the links can be quite time consum- ing; if you are confident that they are already correct (say, from a recent build run) you may wish to assume they are cor- rect and not verify them repeatedly. verify This setting says to always verify the symbolic links to the baseline. This is the default. assume This setting says to always assume the links are cor- rect, unless there has been a recent integration. This user preference can be over-ridden by the --VVeerriiffyy__SSyymm-- bboolliicc__LLiinnkkss and --AAssssuummee__SSyymmbboolliicc__LLiinnkkss command line options. relative_filename_preference = (current, base); This field is consulted by most commands which accept file- names on the command line. It controls whether relative file- names are relative to the current directory (this is the default), or relative to the base of the project source tree. current This setting says to interpret relative filenames against the current directory. base This setting says to interpret relative filenames against the base of the source tree. This user preference can be over-ridden by the --BBAAssee__RREEllaattiivvee and --CCUUrrrreenntt__RREEllaattiivvee command line options. email_address = string; This field may be used to set the preferred email address. If not set, defaults to `whoami`@`cat /etc/mailname` if not set, and if _/_e_t_c_/_m_a_i_l_n_a_m_e exists. Otherwise, defaults to `whoami`@`hostname` if not set, which is usually not what is required, particularly if you are behind a firewall. whiteout_preference = (always, never); All of the commands which cause a change to remove files will consult this field to determine if the file should be have a dummy "whiteout" file put in the development directory. Defaults to "always" if not set. editor_command = string; This command is used to edit a file, if the editing is being done in the background. Defaults to the EDITOR environment variable if not set, or "ed" if not set. visual_command = string; This command is used to edit a file, if the editing is being done in the foreground. Defaults to the VISUAL environment variable if not set, or to the EDITOR environment variable if not set, or "vi" if not set. pager_command = string; This is the command used to paginate report and listing out- put. Defaults to the PAGER environment variable if not set, or to "more" if not set. attribute = [ { ... } ]; This is a list of _(_n_a_m_e_,_v_a_l_u_e_) pairs, defining user specified attributes. name = string; The name of the attribute. By convention, names which start with an upper-case letter will appear in list- ings, and lower-case will not. Attribute names are case-insensitive. Arguably, most user attributes which may be altered by the user (and some that can't) should be of this form. Due to an accident of history, this is not the case. The attributes known to Aegis are: progress-preference boolean; true if _a_e_t(1) should emit progress messages, false if not. Can be overridden with the --pprrooggrreessss and --nnoo--pprrooggrreessss command line options. FIXME: there needs to be a _a_e_s_u_b(5) way to get at these values. value = string; The value of the attribute. SSEEEE AALLSSOO _a_e_g_i_s(5) aegis file format syntax _a_e_d(1) difference and merge files 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 aeuconf(5)