NAME
aegstate - aegis global state file
SYNOPSIS
/var/lib/aegis/state
DESCRIPTION
The aegis state file is used to store the pointers to project
directories.
CONTENTS
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
alias_for 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 directory is
not set.)
WRITING REPORT SCRIPTS
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 “ael projects” 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 project_name and directory fields specified above,
the report generator insets a state field, which gives you access to
the project state fields (see aepstate(5) for more information).
SEE ALSO
aegis(5)
aegis file format syntax
COPYRIGHT
aegis version 4.24.3.D001
Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 Peter
Miller
The aegis program comes with ABSOLUTELY NO WARRANTY; for details use
the ’aegis -VERSion License’ command. This is free software and you
are welcome to redistribute it under certain conditions; for details
use the ’aegis -VERSion License’ command.
AUTHOR
Peter Miller E-Mail: millerp@canb.auug.org.au
/\/\* WWW: http://www.canb.auug.org.au/~millerp/