/*D
   MPI_Group_excl - Produces a group by reordering an existing group and taking only unlisted members

Synopsis:
.vb
int MPI_Group_excl(MPI_Group group, int n, const int ranks[],
                   MPI_Group *newgroup)
.ve

Input Parameters:
+ group - group (handle)
. n - number of elements in array ranks (integer)
- ranks - array of integer ranks of processes in group not to appear in newgroup (integer)

Output Parameters:
. newgroup - new group derived from above, preserving the order defined by group (handle)

Note:
The MPI standard requires that each of the ranks to excluded must be
a valid rank in the group and all elements must be distinct or the
function is erroneous.

.N ThreadSafe

.N Fortran

.N Errors
.N MPI_SUCCESS
.N MPI_ERR_ARG
.N MPI_ERR_GROUP
.N MPI_ERR_OTHER

.seealso: MPI_Group_free
D*/

