rt/config

   1 /*
   2  * This is the project ``config'' file.  It controls many aspects of
   3  * how Aegis interacts with your project.
   4  *
   5  * There are several sections of this file, each dealing with a different
   6  * aspect of the interaction between Aegis and the tools used to manage
   7  * yout project.
   8  */
   9
  10 /*
  11  * -------------------------------------------------------------------------
  12  *
  13  * The build tool is delegated.
  14  */
  15
  16 /*
  17  * The build_command field of the config file is used to invoke the relevant
  18  * build command.  The following command tells cook where to find the recipes.
  19  * The ${s Howto.cook} expands to a path into the baseline during development
  20  * if the file is not in the change.  Look in aesub(5) for more information
  21  * about command substitutions.
  22  */
  23 build_command =
  24         "";
  25
  26 /*        cook -book ${s Howto.cook} search_path=$search_path \
  27 project=$p change=$c version=$v -star -no-log -action -notouch";
  28
  29 /*
  30  * The recipes in the User Guide will all remove their targets before
  31  * constructing them, which qualifies them to use the following entry in the
  32  * config file.  The targets MUST be removed first if this field is true,
  33  * otherwise the baseline would cease to be self-consistent.
  34  *
  35  * Fortunately, Cook has a nifty ``set unlink;'' statement which is
  36  * placed at the top of the cookbook.
  37  */
  38 link_integration_directory = true;
  39
  40
  41 /*
  42  * -------------------------------------------------------------------------
  43  *
  44  * The history tool is delegated.
  45  *
  46  * The fhist program was written by David I. Bell and is admirably
  47  * suited to providing a history mechanism with out the "cruft" that
  48  * SCCS and RCS impose.  The fhist program also comes with two other
  49  * utilities, fcomp and fmerge, which use the same minimal difference
  50  * algorithm.
  51  *
  52  * Please note that the [# edit #] feature needs to be avoided, or the
  53  * -Fored_Update (-fu) flag needs to be used in addition to the
  54  * -Conditional_Update (-cu) flag, otherwise updates will complain that
  55  * ``Input file "XXX" contains edit A instead of B for module "YYY"''
  56  *
  57  * The history_create_command and the history_put_command are
  58  * intentionally identical.  This minimizes problems when using
  59  * branches.
  60  *
  61  * The ${quote ...} construct is used to quote filesnames whicg contain
  62  * shell special characters.  A minimum of quoting is performed, so if
  63  * the filenames do not contail shell special characters, no quotes will
  64  * be used.
  65  */
  66
  67 /*
  68  * This command is used to create a new project history.  The command is
  69  * always executed as the project owner.  Note he the source is left in
  70  * the baseline.  The following substitutions are available:
  71  *
  72  * ${Input}
  73  *      absolute path of the source file
  74  * ${History}
  75  *      absolute path of the history file
  76  *
  77  * The history_create_command and the history_put_command are
  78  * intentionally identical.  This minimizes problems when using
  79  * branches.
  80  */
  81 history_create_command =
  82         "fhist ${quote ${basename $input}} -cr -cu -i ${quote $input} \
  83 -p ${quote ${dirname $history}} -r";
  84
  85 /*
  86  * This command is used to get a specific edit back from history.  The
  87  * command may be executed by developers.  The following substitutions
  88  * are available:
  89  *
  90  * ${History}
  91  *      absolute path of the history file
  92  * ${Edit}
  93  *      edit number, as given by history_query_command
  94  * ${Output}
  95  *      absolute path of the destination file
  96  *
  97  * Note that the destination filename will never look anything like the
  98  * history source filename, so the -p is essential.
  99  */
 100 history_get_command =
 101         "fhist ${quote ${basename $history}} -e ${quote $e} \
 102 -o ${quote $output} -p ${quote ${dirname $history}}";
 103
 104 /*
 105  * This command is used to add a new "top-most" entry to the history
 106  * file.  This command is always executed as the project owner.  Note
 107  * that the source file is left in the baseline.  The following
 108  * substitutions are available:
 109  *
 110  * ${Input}
 111  *      absolute path of source file
 112  * ${History}
 113  *      absolute path of history file
 114  *
 115  * The history_create_command and the history_put_command are
 116  * intentionally identical.  This minimizes problems when using
 117  * branches.
 118  */
 119 history_put_command =
 120         "fhist ${quote ${basename $input}} -cr -cu -i ${quote $input} \
 121 -p ${quote ${dirname $history}} -r";
 122
 123 /*
 124  * This command is used to query what the history mechanism calls the
 125  * "top-most" edit of a history file.  The result may be any arbitrary
 126  * string, it need not be anything like a number, just so long as it
 127  * uniquely identifies the edit for use by the history_get_command at a
 128  * later date.  The edit number is to be printed on the standard output.
 129  * This command may be executed by developers.  The following
 130  * substitutions are available:
 131  *
 132  * ${History}
 133  *      absolute path of the history file
 134  */
 135 history_query_command =
 136         "fhist ${quote ${basename $history}} -l 0 \
 137 -p ${quote ${dirname $history}} -q";
 138
 139 /*
 140  * -------------------------------------------------------------------------
 141  *
 142  * The difference and merge tools are delegated.
 143  */
 144
 145 /*
 146  * Compare two files using fcomp.  The -w option produces an output of
 147  * the entire file, with insertions an deletions marked by "change bars"
 148  * in the left margin.  This is superior to context difference, as it
 149  * shows the entire file as context.  The -s option could be added to
 150  * compare runs of white space as equal.
 151  *
 152  * This command is used by aed(1) to produce a difference listing when
 153  * file in the development directory was originally copied from the
 154  * current version in the baseline.
 155  *
 156  * All of the command substitutions described in aesub(5) are available.
 157  * In addition, the following substitutions are also available:
 158  *
 159  * ${ORiginal}
 160  *      The absolute path name of a file containing the version
 161  *      originally copied.  Usually in the baseline.
 162  * ${Input}
 163  *      The absolute path name of the edited version of the file.
 164  *      Usually in the development directory.
 165  * ${Output}
 166  *      The absolute path name of the file in which to write the
 167  *      difference listing.  Usually in the development directory.
 168  *
 169  * An exit status of 0 means successful, even of the files differ (and
 170  * they usually do).  An exit status which is non-zero means something
 171  * is wrong.
 172  *
 173  * The non-zero exit status may be used to overload this command with
 174  * extra tests, such as line length limits.  The difference files must
 175  * be produced in addition to these extra tests.
 176  */
 177 diff_command =
 178         "fcomp -w ${quote $original} ${quote $input} -o ${quote $output}";
 179
 180 /*
 181  * Compare three files using fmerge.  Conflicts are marked in the
 182  * output.
 183  *
 184  * This command is used by aed(1) to produce a difference listing when a
 185  * file in the development directory is out of date compared to the
 186  * current version in the baseline.
 187  *
 188  * All of the command substitutions described in aesub(5) are available.
 189  * In addition, the following substitutions are also available:
 190  *
 191  * ${ORiginal}
 192  *      The absolute path name of a file containing the common ancestor
 193  *      version of ${MostRecent} and {$Input}.  Usually the version
 194  *      originally copied into the change.  Usually in a temporary file.
 195  * ${Most_Recent}
 196  *      The absolute path name of a file containing the most recent
 197  *      version.  Usually in the baseline.
 198  * ${Input}
 199  *      The absolute path name of the edited version of the file.
 200  *      Usually in the development directory.
 201  * ${Output}
 202  *      The absolute path name of the file in which to write the
 203  *      difference listing.  Usually in the development directory.
 204  *
 205  * An exit status of 0 means successful, even of the files differ (and
 206  * they usually do).  An exit status which is non-zero means something
 207  * is wrong.
 208  */
 209 merge_command =
 210         "fmerge ${quote $original} ${quote $MostRecent} ${quote $input} \
 211 -o ${quote $output} -c /dev/null";
 212
 213 /*
 214  * -------------------------------------------------------------------------
 215  *
 216  * The new file templates are very handy.  They allow all sorts of things
 217  * to be se automatically.  You need to edit them to add your own name,
 218  * and copyright conditions.
 219  */
 220
 221 file_template =
 222 [
 223         {
 224                 pattern = [ "*" ];
 225                 body = "${read_file ${source etc/template/generic abs}}";
 226
 227         }
 228 ];
 229
 230 /* -------------------------------------------------------------------------
 231  *
 232  * The integrate_begin_exceptions are files which are not hard linked
 233  * from the baseline to the integration directory.  In this case, this
 234  * is done to ensure the version stmp is updated appropriately.
 235  */
 236
 237 integrate_begin_exceptions = [ ];
 238
 239
 240
 241
 242 /* -------------------------------------------------------------------------
 243  *
 244  * The trojan_horse_suspect field is a list of filename patterns which
 245  * indicate files which *could* host a Trojan horse attack.  It makes
 246  * aedist --receive more cautions.  It is NOT a silver bullet: just
 247  * about ANY file can host a Trojan, one way or the other.
 248  */
 249
 250 trojan_horse_suspect = [ ];
 251
 252 build_covers_all_architectures = true;
 253
 254 test_command = "make test";
 255
 256 build_time_adjust=dont_adjust;