/*D
   MPIX_Threadcomm_init - initialize a thread communicator (outside thread parallel regions)

Synopsis:
.vb
int MPIX_Threadcomm_init(MPI_Comm comm, int num_threads,
                         MPI_Comm *newthreadcomm)
.ve

Input Parameters:
+ comm - communicator (handle)
- num_threads - number of participating threads (non-negative integer)

Output Parameters:
. newthreadcomm - new thread communicator (handle)

.N ThreadSafe

.N Fortran

.N Errors
.N MPI_SUCCESS
.N MPI_ERR_ARG
.N MPI_ERR_COMM
.N MPI_ERR_OTHER

.seealso: MPIX_Threadcomm_start, MPIX_Threadcomm_finish, MPIX_Threadcomm_free
D*/

