From 04fc45a966db0866cdbc44555bca8fdd23ed3115 Mon Sep 17 00:00:00 2001 From: Jean-Paul Pelteret Date: Thu, 7 May 2020 19:19:16 +0200 Subject: [PATCH] Improve documentation of a BatchOptimizer function --- .../deal.II/differentiation/sd/symengine_optimizer.h | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/include/deal.II/differentiation/sd/symengine_optimizer.h b/include/deal.II/differentiation/sd/symengine_optimizer.h index e9e12dfa5f..2899f20a89 100644 --- a/include/deal.II/differentiation/sd/symengine_optimizer.h +++ b/include/deal.II/differentiation/sd/symengine_optimizer.h @@ -1834,6 +1834,18 @@ namespace Differentiation * * These values were computed by substituting a @p substitution_values map * during substitute() call. + * + * @note In contrast to the other variants of this function, the order of + * the returned entries is an internal implementation detail, and cannot + * be guarenteed under all conditions. The entries in the returned vector + * are, in general, identical to the order in which the dependent + * expressions are originally registered. However, when registering + * tensors and symmetric tensors of expressions, these are "unrolled" + * and their components are individually registered. If it is necessary to + * control the order in which results appear in the returned vector, then + * the register_function() method that takes a Tensor or a SymmetricTensor + * as an argument should be avoided. Instead, the individual entries of + * these types of data should be registered one by one. */ const std::vector & evaluate() const; -- 2.39.5