---
name: "aedir"
section: "5"
platform: "linux"
package: "aegis"
version: "4.24.3-3"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/aedir"
---

# aedir(5)

aegis directory structures

## NAME

aedir - aegis directory structures

## DESCRIPTION

The project directory structure is dictated by *aegis* at the top level, but is completely under the project's control from various points below the top level.

The project directory has the following contents

```
project/
	baseline/
		aegis.conf
		...project specific...
		test/
			[0-9][0-9]/
				t[0-9][0-9][0-9][0-9]a.sh
				t[0-9][0-9][0-9][0-9]m.sh
	history/
		...echo of baseline...
	delta.[0-9][0-9][0-9]/
		...echo of baseline...
	info/
		state
		change/
			[0-9]/
				[0-9][0-9][0-9]
```

*The directory is structured in this way so that it is possible* *to pick an entire project up off the disk,* *and be confident that you got it all.*

*The location of the root of this tree is configurable,* *and may even be changed during the life of a project.*

*The contents of the* *baseline* *subdirectory,* *other than those given,* *are defined by the project,* *and not dictated by aegis.*

*The contents of the* *delta.NNN* *directory,* *when it exists,* *are an image of the* *baseline* *directory.* *It is frequently linked with the baseline,* *rather than a copy of it;* *see the* *link\_integration\_directory* *field description in* [*aepconf*(5)](/aepconf/5.md) *for more information.*

*The contents of the* *history* *contains the edit histories of the* *baseline* *directory,* *and is in all other ways an image of it.* *Note that* *baseline* *always contains the latest source;* *the* *history* *directory is just history.* *The actual files in the history directory tree* *will not always have names the same as those in the baseline;* *compare the methods used by SCCS and RCS.*

*The contents of the* *baseline/test* *directory are the tests which are created by changes.* *Test histories are also stored in the* *history* *subdirectory.* *Tests are treated as project source.*

*The edit histories are separated out to simplify* *the task of taking a "snapshot" of the source of a project,* *without airing all the dirty laundry.*

*The* *baseline* *directory always contains the latest source,* *and so the* *history* *directory need not be readily accessible,* *because the build mechanism* *(something like* [*make*(1)](/make/1.md), *but preferably better)* *does not need to know anything about it.* *Similarly for tests.*

*The* *baseline/aegis.conf* *file is used to tell aegis everything else it needs to know about a project.* *See* [*aepconf*(5)](/aepconf/5.md) *for more information.* *This file  is a source file of the project,* *and is treated in the same way as all source files.* *The name of this file is not mandatory.*

## SEE ALSO

- [*aenc*(1)](/aenc/1.md)

  *create a new change*

- [*aenpr*(1)](/aenpr/1.md)

  *create a new project*

- [*aegis*(5)](/aegis/5.md)

  *aegis file format syntax*

- [*aepconf*(5)](/aepconf/5.md)

  *project configuration file format*\

## 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/ |