Updated Doxygen comments.

Description of no_wait_on_empty and total_time for mchain's receive()
and select() functions.

Author: eao197

dev/so_5/mchain.hpp

@@ -1791,7 +1791,7 @@ perform_receive(
  *
  * \par Handlers format examples:
  * \code
-	receive( ch, so_5::infinite_wait,
+	receive( from(ch).handle_n(1),
 		// Message instance by const reference.
 		[]( const std::string & v ) {...},
 		// Message instance by value (efficient for small types like int).
@@ -1808,6 +1808,17 @@ perform_receive(
 		[]( const so_5::mhood_t< yet_another_signal > & ) {...} );
  * \endcode
  *
+ * \note
+ * Since v.5.8.4 the value of empty_timeout (or no_wait_on_empty) is
+ * taken into account when `total_time` is specified. It means that
+ * in the following example the receive() returns immediately if
+ * the mchain is empty:
+ * \code
+ * receive(
+ * 	from(ch).handle_n(5).no_wait_on_empty().total_time(6s),
+ * 	[](const my_message & msg) {...});
+ * \endcode
+ *
  * \since v.5.5.13
  */
 template<
@@ -1957,6 +1968,19 @@ class prepared_receive_t
 			[]( const second_message_type & msg ) { ... }, ... );
  * \endcode
  *
+ * \note
+ * Since v.5.8.4 the value of empty_timeout (or no_wait_on_empty) is
+ * taken into account when `total_time` is specified. It means that
+ * in the following example the receive() returns immediately if
+ * the mchain is empty:
+ * \code
+ * auto prepared = prepare_receive(
+ * 	from(ch).handle_n(5).no_wait_on_empty().total_time(6s),
+ * 	[](const my_message & msg) {...});
+ * ...
+ * auto r = so_5::receive(prepared);
+ * \endcode
+ *
  * \since v.5.5.17
  */
 template<

dev/so_5/mchain_select.hpp

@@ -1670,6 +1670,18 @@ send_case(
 				... ) );
 	\endcode
  *
+ * \note
+ * Since v.5.8.4 the value of empty_timeout (or no_wait_on_empty) is
+ * taken into account when `total_time` is specified. It means that
+ * in the following example the select() returns immediately if
+ * all mchains are empty:
+ * \code
+ * select(
+ * 	from_all().handle_n(5).no_wait_on_empty().total_time(6s),
+ * 	receive_case( ch1, ...),
+ * 	receive_case( ch2, ...) );
+ * \endcode
+ *
  * \since v.5.5.16
  */
 template<
@@ -1853,6 +1865,20 @@ class prepared_select_t
 				... ) );
  * \endcode
  *
+ * \note
+ * Since v.5.8.4 the value of empty_timeout (or no_wait_on_empty) is
+ * taken into account when `total_time` is specified. It means that
+ * in the following example the select() returns immediately if
+ * all mchains are empty:
+ * \code
+ * auto prepared = prepare_select(
+ * 	from_all().handle_n(5).no_wait_on_empty().total_time(6s),
+ * 	receive_case( ch1, ...),
+ * 	receive_case( ch2, ...) );
+ * ...
+ * so_5::select(prepared);
+ * \endcode
+ *
  * \since v.5.5.17
  */
 template<
@@ -2059,6 +2085,23 @@ class extensible_select_t
  * 	receive_case(ch3, ...));
  * \endcode
  *
+ * \note
+ * Since v.5.8.4 the value of empty_timeout (or no_wait_on_empty) is
+ * taken into account when `total_time` is specified. It means that
+ * in the following example the select() returns immediately if
+ * all mchains are empty:
+ * \code
+ * // Creation of extensible-select instance with initial set of cases.
+ * auto sel = so_5::make_extensible_select(
+ * 	so_5::from_all().handle_n(10).no_wait_on_empty().total_time(6s),
+ * 	receive_case(ch1, ...),
+ * 	receive_case(ch2, ...));
+ * ...
+ * so_5::add_select_cases(sel, ...);
+ * ...
+ * auto r = select(sel);
+ * \endcode
+ *
  * \since v.5.6.1
  */
 template<