Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
aedir(5)		      File Formats Manual		      aedir(5)

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 be-
	low 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 de-
	scription in aepconf(5)	for more information.

	The contents of	the history contains the edit histories	of the base-
	line 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 meth-
	ods 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), 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) 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)	create a new change

	aenpr(1)
		create a new project

	aegis(5)
		aegis file format syntax

	aepconf(5)
		project	configuration file format

COPYRIGHT
	aegis version 4.25.D510
	Copyright (C) 1991, 1992, 1993,	1994, 1995, 1996, 1997,	1998, 1999,
	2000, 2001, 2002, 2003,	2004, 2005, 2006, 2007,	2008, 2009, 2010,
	2011, 2012 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:	 pmiller@opensource.org.au
	/\/\*		  WWW:	 http://miller.emu.id.au/pmiller/

Reference Manual		     Aegis			      aedir(5)

NAME | DESCRIPTION | SEE ALSO | COPYRIGHT | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=aedir&sektion=5&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help