]> https://gitweb.dealii.org/ - dealii.git/commitdiff
Document usage of empty copiers in WorkStream 8925/head
authorDaniel Arndt <arndtd@ornl.gov>
Fri, 18 Oct 2019 15:08:17 +0000 (11:08 -0400)
committerDaniel Arndt <arndtd@ornl.gov>
Fri, 18 Oct 2019 15:08:17 +0000 (11:08 -0400)
include/deal.II/base/work_stream.h

index 1c7470f6c8bb51f5fdb8c1ad0c839b0ffe9f6d26..c2664c39e2a64710d5bb633fb03c444025911fb5 100644 (file)
@@ -927,6 +927,10 @@ namespace WorkStream
    * copies of the <tt>ScratchData</tt> object and
    * <tt>queue_length*chunk_size</tt> copies of the <tt>CopyData</tt> object
    * are generated.
+   *
+   * @note In case the copier does not do anything, pass
+   * <code>std::function<void(const CopyData&)>()</code> as @p copier to make sure
+   * a more efficient algorithm is used internally.
    */
   template <typename Worker,
             typename Copier,
@@ -976,6 +980,10 @@ namespace WorkStream
    * copies of the <tt>ScratchData</tt> object and
    * <tt>queue_length*chunk_size</tt> copies of the <tt>CopyData</tt> object
    * are generated.
+   *
+   * @note In case the copier does not do anything, pass
+   * <code>std::function<void(const CopyData&)>()</code> as @p copier to make sure
+   * a more efficient algorithm is used internally.
    */
   template <typename Worker,
             typename Copier,
@@ -1266,6 +1274,10 @@ namespace WorkStream
    * copies of the <tt>ScratchData</tt> object and
    * <tt>queue_length*chunk_size</tt> copies of the <tt>CopyData</tt> object
    * are generated.
+   *
+   * @note In case the copier does not do anything, pass
+   * <code>std::function<void(const CopyData&)>()</code> as @p copier to make sure
+   * a more efficient algorithm is used internally.
    */
   template <typename MainClass,
             typename Iterator,

In the beginning the Universe was created. This has made a lot of people very angry and has been widely regarded as a bad move.

Douglas Adams


Typeset in Trocchi and Trocchi Bold Sans Serif.