Update docs

Author: benruijl

src/atom/core.rs

@@ -868,9 +868,9 @@ pub trait AtomCore: private::Sealed + Sized {
     }
 
     /// Create an efficient evaluator for a (nested) expression.
-    /// All free parameters must appear in `params` and all other variables
-    /// and user functions in the expression must occur in the function map.
-    /// The function map may have nested expressions.
+    /// All free parameters must appear in `params` and all nested functions
+    /// must be registered using [`EvaluatorBuilder::add_function`] or [`EvaluatorBuilder::add_function_with_map`].
+    /// All other functions, must have an evaluation hook.
     ///
     /// For the best performance, the evaluator should be JIT-compiled ([ExpressionEvaluator::jit_compile])
     /// or compiled to C++ with inline ASM using [ExpressionEvaluator::export_cpp].
@@ -920,23 +920,22 @@ pub trait AtomCore: private::Sealed + Sized {
         EvaluatorBuilder::new(self.as_atom_view(), params)
     }
 
-    /// Convert nested expressions to a tree suitable for repeated evaluations with
-    /// different values for `params`.
-    /// All variables and all user functions in the expression must occur in the map.
+    /// Create an efficient evaluator for (nested) expressions.
+    /// All free parameters must appear in `params` and all nested functions
+    /// must be registered using [`EvaluatorBuilder::add_function`] or [`EvaluatorBuilder::add_function_with_map`].
+    /// All other functions, must have an evaluation hook.
     ///
     /// # Example
     ///
     /// ```
     /// use symbolica::prelude::*;
     /// let expr1 = parse!("x + y");
     /// let expr2 = parse!("x - y");
-    /// let x = parse!("x");
-    /// let y = parse!("y");
-    /// let params = vec![x.clone(), y.clone()];
-    /// let evaluator = Atom::evaluator_multiple(&[expr1, expr2], &params)
+    /// let params = vec![parse!("x"), parse!("y")];
+    /// let mut evaluator = Atom::evaluator_multiple(&[expr1, expr2], &params)
     ///     .build()
-    ///     .unwrap();
-    /// let mut evaluator = evaluator.map_coeff(&|c| c.to_real().unwrap().to_f64());
+    ///     .unwrap()
+    ///     .map_coeff(&|c| c.to_real().unwrap().to_f64());
     /// let mut out = vec![0., 0.];
     /// evaluator.evaluate(&[1.0, 2.0], &mut out);
     /// assert_eq!(out, &[3.0, -1.0]);