option "uid" u
#~~~~~~~~~~~~~
"user id(s) to take into account"
string typestr="uid_spec"
optional
multiple
details="
	An uid specifier may be a single number, or a range of uids.
	Example:

	--uid 42    # only consider uid 42
	--uid 42-   # only consider uids greater or equal than 42
	--uid 23-42 # only consider uids between 23 and 42, inclusively.

	This option may be given multiple times. An uid is taken into
	account if it satisfies at least one --uid option.
"

option "limit" L
#~~~~~~~~~~~~~~~
"Limit output"
int  typestr="num"
default="-1"
optional
details="
	Only print num lines of output. If negative (the default),
	print all lines.
"

option "no-headers" -
#~~~~~~~~~~~~~~~~~~~~
"supress descriptions for listings/tables"
flag off
details="
	This is mostly useful to feed the output of adu to scripts.
"

option "sort" s
#~~~~~~~~~~~~~~~
"how to sort the output"
enum typestr="<key>"
values="sizes","files","unsorted"
default="sizes"
optional
details="
	Sort by file size, file count or unsorted.
"

option "format" f
#~~~~~~~~~~~~~~~~~
"how to format the output"
string typestr="<format>"
optional
details="
	%(basedir) 	-- the path given to --base-dir during create
	%(dir)		-- the name of the directory
	%(dir_size)	-- the size of the sum of all regular files in this directory
	%(num_files)	-- the number of regular files in this directory
	%%		-- interpolates to %
	%xx		-- interpolates to the character with hex code xx
"

option "output" o
#~~~~~~~~~~~~~~~~
"file to write output to"
string typestr="<path>"
optional
default="-"
details="
	If empty, or not given, use stdout.
"