aels(1)								       aels(1)



NNAAMMEE
	aels - annotated directory listing

SSYYNNOOPPSSIISS
	aaeellss [ _o_p_t_i_o_n...  ][ _f_i_l_e_n_a_m_e...  ]
	aaeellss --HHeellpp
	aaeellss --VVEERRSSiioonn

DDEESSCCRRIIPPTTIIOONN
	The _a_e_l_s command is used to list information about the files and
	directories named on the command line.	If no files are	named, the
	current	directory is listed.

	The view presented is from Aegis' perspective.	It unifies the devel-
	opment directory with the baseline.

OOPPTTIIOONNSS
	The following options are understood:

	--RReeccuurrssiivvee

	--LLOOnngg	This option implies the	--SShhooww--MMooddee, --SShhooww--AAttttrriibbuutteess, --SShhooww--
		UUsseerr, --SShhooww--GGrroouupp, --SShhooww--SSiizzee and --SShhooww--WWhheenn options, unless
		explicitly overridden.

	--SShhooww--DDoott--FFiilleess
		This option may	be used	to show	files starting with a dot (.).

	--HHiiddee--DDoott--FFiilleess
		This option may	be used	to hide	files starting with a dot (.).
		This is	the default.

	--SShhooww--RReemmoovveedd--FFiilleess
		This option may	be used	to include removed files in the	list-
		ing.

	--HHiiddee--RReemmoovveedd--FFiilleess
		This option may	be used	to exclude removed files from the
		listing.  This is the default.

	--SShhooww--MMooddee
		This option may	be used	to include the mode column in the
		listing.  The mode column indicates the	file type and permis-
		sions.

	--HHiiddee--MMooddee
		This option may	be used	to exclude the mode column from	the
		listing.  This is the default.

	--SShhooww--AAttttrriibbuutteess
		This option may	be used	to include the attributes column in
		the listing.  The attributes column indicates whether the file
		is part	of the change, the project or neither; whether the
		file is	being created, modified	or removed; whether the	file
		is a source file, a test file, or neither.  This is the
		default.

	--HHiiddee--AAttttrriibbuutteess
		This option may	be used	to exclude the attributes column from
		the listing.

	--SShhooww--UUsseerr
		This option may	be used	to include file	owner information in
		the listing.

	--HHiiddee--UUsseerr
		This option may	be used	to exclude file	owner information from
		the listing.  This is the default.

	--SShhooww--GGrroouupp
		This option may	be used	to include file	group information in
		the listing.

	--HHiiddee--GGrroouupp
		This option may	be used	to exclude file	group information from
		the listing.  This is the default.

	--SShhooww--SSiizzee
		This option may	be used	to include file	size information in
		the listing.

	--HHiiddee--SSiizzee
		This option may	be used	to exclude file	size information from
		the listing.  This is the default.

	--SShhooww--WWhheenn
		This option may	be used	to include the file modification time
		in the listing.

	--HHiiddee--WWhheenn
		This option may	be used	to exclude the file modification time
		from the listing.  This	is the default.

	--HHeellpp
		This option may	be used	to obtain more information about how
		to use the _a_e_l_s	program.

	See also _a_e_g_i_s(1) for options common to	all aegis commands.

	All options may	be abbreviated;	the abbreviation is documented as the
	upper case letters, all	lower case letters and underscores (_) are
	optional.  You must use	consecutive sequences of optional letters.

	All options are	case insensitive, you may type them in upper case or
	lower case or a	combination of both, case is not important.

	For example: the arguments "-project", "-PROJ" and "-p"	are all	inter-
	preted to mean the --PPrroojjeecctt option.  The argument "-prj" will not be
	understood, because consecutive	optional characters were not supplied.

	Options	and other command line arguments may be	mixed arbitrarily on
	the command line, after	the function selectors.

	The GNU	long option names are understood.  Since all option names for
	_a_e_l_s are long, this means ignoring the extra leading '-'.  The
	"----_o_p_t_i_o_n==_v_a_l_u_e" convention is also understood.

EEXXIITT SSTTAATTUUSS
	The _a_e_l_s command will exit with	a status of 1 on any error.  The _a_e_l_s
	command	will only exit with a status of	0 if there are no errors.

EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS
	See _a_e_g_i_s(1) for a list	of environment variables which may affect this
	command.  See _a_e_p_c_o_n_f(5) for the project configuration file's
	_p_r_o_j_e_c_t___s_p_e_c_i_f_i_c field for how to set environment variables for	all
	commands executed by Aegis.

SSEEEE AALLSSOO
	_l_s(1)	list directory contents

	_a_e_f_i_n_d(1)
		search for files in directory hierarchy

	_a_e_l _c_f	List change files.

	_a_e_l _p_f	List project files.

CCOOPPYYRRIIGGHHTT
	aels version 4.25.D611
	Copyright (C) 1991, 1992, 1993,	1994, 1995, 1996, 1997,	1998, 1999,
	2000, 2001, 2002, 2003,	2004, 2005, 2006, 2007,	2008, 2009, 2010,
	2011, 2012, 2013, 2014 Peter Miller

	The aels program comes with ABSOLUTELY NO WARRANTY; for	details	use
	the '_a_e_l_s _-_V_E_R_S_i_o_n _L_i_c_e_n_s_e' command.  This is free software and	you
	are welcome to redistribute it under certain conditions; for details
	use the	'_a_e_l_s _-_V_E_R_S_i_o_n _L_i_c_e_n_s_e'	command.

AAUUTTHHOORR
	Peter Miller   E-Mail:	 pmiller@opensource.org.au
	/\/\*		  WWW:	 http://miller.emu.id.au/pmiller/



Reference Manual		     Aegis			       aels(1)