From d76f27cd489211258e6489c2dfbba5b18a37baec Mon Sep 17 00:00:00 2001 From: Nate Bosch Date: Thu, 5 Oct 2023 18:43:20 +0000 Subject: [PATCH] Slightly longer doc with justification --- lib/src/specs/expression/literal.dart | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/lib/src/specs/expression/literal.dart b/lib/src/specs/expression/literal.dart index 619f242..ced6cf9 100644 --- a/lib/src/specs/expression/literal.dart +++ b/lib/src/specs/expression/literal.dart @@ -6,8 +6,10 @@ part of '../expression.dart'; /// Converts a runtime Dart [literal] value into an [Expression]. /// -/// If the [literal] is already an [Expression] it is returned without change. /// Supported Dart types are translated into literal expressions. +/// If the [literal] is already an [Expression] it is returned without change to +/// allow operating on a collection of mixed simple literals and more complex +/// expressions. /// Unsupported inputs invoke the [onError] callback. Expression literal(Object? literal, {Expression Function(Object)? onError}) { if (literal is Expression) return literal;