1 5/31/86  forum_request:  next_meeting, nm
 2 
 3 Syntax:  nm {-control_arg}
 4 
 5 
 6 Syntax as an active request:  [nm {-control_arg}]
 7 
 8 
 9 Function:  changes the current meeting to be the next meeting in the
10 list of changed meetings established by the check_meetings request.
11 As an active function, it returns the name of the next meeting on the
12 list. In either case, that meeting is removed from the list.
13 
14 
15 Control arguments:
16 -all, -a
17    Prints or returns a list of all of the meetings in the list of
18    changed meetings, including those already visited with this request.
19    If this control argument is used, neither the current meeting nor
20    the list will be changed.
21 -count, -ct
22    Prints the number of meetings remaining in the changed meeting list.
23    This control argument and it is incompatible with both the -all and
24    -list control arguments.
25 -list, -ls
26    Prints or returns a list of the remaining meetings in the list of
27    changed meetings.  If this control argument is used, neither the
28    current meeting nor the list will be changed.
29 
30 
31 Notes:  The check_meetings request must have already been used in this
32 process.  This request calls the request processor with the request
33 line:
34 
35     goto MEETING_NAME
36 
37 so a user-defined abbreviation for the goto request will be expanded.
38 
39 When -all or -list is used, the count of new transactions displayed is
40 the number of transactions that were new when the check_meetings
41 request was invoked.