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/

Reference Manual                                      Aegis                                          aegstate(5)