1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
|
'\" t
.\" aegis - project change supervisor
.\" Copyright (C) 1991-1994, 1999, 2001 Peter Miller;
.\" All rights reserved.
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
.\"
.\" MANIFEST: manual entry for 'aegis -List' command
.\"
.so z_name.so
.TH "\*(n) -List" 1 \*(N) "Reference Manual"
.SH NAME
\*(n) -List \- list (possibly) interesting things
.XX "ael(1)" "list interesting things"
.SH SYNOPSIS
.B \*(n)
.B -List
[
.IR option ...
]
.I list-name
.br
.B \*(n)
.B -List
.B -List
[
.IR option ...
]
.br
.B \*(n)
.B -List
.B -Help
.SH DESCRIPTION
The
.I \*(n)
.I -List
command is used to
list information.
There are a number of possible
.IR list-name s,
as follows (abbreviations as for command line options):
.TP 8n
Administrators
.br
List the administrators of a project.
.TP 8n
Change_Details
.br
List full information about a change
in large format.
.TP 8n
Change_Files
.br
List all files in a change.
The verbose version includes details such as the action being taken,
the edit number of the file, and whether it's being moved.
The terse version only lists the files names (and omits removed files),
this is useful for shell scripts and interfacing with build tools.
.TP 8n
Change_File_History
.br
This listing shows the history of each file in the change. It includes
each delta number (so that you may reproduce it) and brief description,
of each change which affected each file.
.TP 8n
Change_History
.br
List the history of a change.
.TP 8n
Changes
.br
List the changes of a project.
The verbose version includes details such as the state of the change and
it's brief description. The terse version lists only the change numbers,
which is good for shell scripts.
.TP 8n
Default_Change
.br
List the default change for the current user.
.TP 8n
Default_Project
.br
List the default project for the current user.
.TP 8n
Developers
.br
List the developers of a project.
.TP 8n
Integrators
.br
List the integrators of a project.
.TP 8n
List_List
.br
List all lists available.
.TP 8n
Locks
.br
List all currently active locks.
.TP 8n
Outstanding_Changes
.br
List all changes not yet completed.
.TP 8n
All_Outstanding_Changes
.br
List all changes not yet completed, for all projects.
.TP 8n
Project_Files
.br
List all files in the baseline of a project.
The verbose version includes details such as the action being taken,
the edit number of the file.
The terse version only lists the files names (and omits removed files),
this is useful for shell scripts and interfacing with build tools.
If a change number is given, files included in the change are omitted from
the list (giving the change's perspective on what the project files are).
.TP 8n
Project_History
.br
List the integration history of a project.
.TP 8n
Projects
.br
List all projects.
.TP 8n
Project_Aliases
.br
List all project aliases.
.TP 8n
Reviewers
.br
List the reviewers of a project.
.TP 8n
State_File_Name
.br
Prints the absolute path of the project's or change's state file.
Useful for cookbooks and makefiles.
.TP 8n
Users_Changes
.br
List of changes owned by the current user.
.TP 8n
Version
.br
List version of a project or change.
This includes the major and minor version number,
and the previous version number if available.
The list of copyright years is also printed.
.PP
Most of these lists are available from other \*(n) functions.
Many \*(n) functions provide more specific lists.
.SH OPTIONS
The following options are understood:
.so o_change.so
.so o_help.so
.so o_list.so
.so o_page.so
.so o_project.so
.so o_terse.so
.so o_unforma.so
.so o_verbose.so
.so o__rules.so
.SH RECOMMENDED ALIAS
The recommended alias for this command is
.nf
.ta 8n 16n
csh% alias ael '\*(n) -l \e!* -v'
sh$ ael(){\*(n) -l "$@" -v}
.fi
.SH ERRORS
It is an error if
the list name given is unknown.
.so z_exit.so
.br
.ne 1i
.SH SEE ALSO
.TP 8n
.IR aedb (1)
begin development of a change (listing option)
.TP 8n
.IR aeib (1)
begin integration of a change (listing option)
.TP 8n
.IR aer (1)
report generator
.TP 8n
.IR aerpass (1)
pass review of a change (listing option)
.TP 8n
.IR aeuconf (5)
user configuration file format
.so z_cr.so
|
