From 7132ba76cae5f154f4391d1038b960f84393e26a Mon Sep 17 00:00:00 2001 From: Wolfgang Bangerth Date: Wed, 2 Nov 2022 17:15:08 -0600 Subject: [PATCH] Document a restriction on ConsensusAlgorithms::serial(). --- include/deal.II/base/mpi_consensus_algorithms.h | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/include/deal.II/base/mpi_consensus_algorithms.h b/include/deal.II/base/mpi_consensus_algorithms.h index 88cedfae5c..26a651daa5 100644 --- a/include/deal.II/base/mpi_consensus_algorithms.h +++ b/include/deal.II/base/mpi_consensus_algorithms.h @@ -877,7 +877,10 @@ namespace Utilities * the caller of the consensus algorithm wants to do with the * received answer. * @param[in] comm The MPI communicator on which the whole algorithm - * is to be performed. + * is to be performed. Since this function is supposed to be run + * only for serial cases, the function throws an exception if + * the provided communicator denotes an MPI universe with more + * than one process. * * @tparam RequestType The type of the object to be sent. * @tparam AnswerType The type of the object to be received. @@ -915,7 +918,10 @@ namespace Utilities * rank of the process that has sent a request to us, along with * the message of the request, and processes that message. * @param[in] comm The MPI communicator on which the whole algorithm - * is to be performed. + * is to be performed. Since this function is supposed to be run + * only for serial cases, the function throws an exception if + * the provided communicator denotes an MPI universe with more + * than one process. * * @tparam RequestType The type of the object to be sent. */ -- 2.39.5