docs: update VartimeRistrettoPrecomputation documentation (#667)

AaronFeickert · web-flow · commit 485ffab769cf · 2025-01-11T23:07:09.000-05:00
diff --git a/curve25519-dalek/src/ristretto.rs b/curve25519-dalek/src/ristretto.rs
@@ -1007,6 +1007,9 @@ impl VartimeMultiscalarMul for RistrettoPoint {
 }
 
 /// Precomputation for variable-time multiscalar multiplication with `RistrettoPoint`s.
+///
+/// Note that for large numbers of `RistrettoPoint`s, this functionality may be less
+/// efficient than the corresponding `VartimeMultiscalarMul` implementation.
 // This wraps the inner implementation in a facade type so that we can
 // decouple stability of the inner type from the stability of the
 // outer type.

Original file line number	Diff line number	Diff line change
`@@ -1007,6 +1007,9 @@ impl VartimeMultiscalarMul for RistrettoPoint {`
`1007`	`1007`	`}`
`1008`	`1008`
`1009`	`1009`	/// Precomputation for variable-time multiscalar multiplication with `RistrettoPoint`s.
	`1010`	`+///`
	`1011`	+/// Note that for large numbers of `RistrettoPoint`s, this functionality may be less
	`1012`	+/// efficient than the corresponding `VartimeMultiscalarMul` implementation.
`1010`	`1013`	`// This wraps the inner implementation in a facade type so that we can`
`1011`	`1014`	`// decouple stability of the inner type from the stability of the`
`1012`	`1015`	`// outer type.`