From 46048e451bfed9c542b43d5051bdf98d9e82aef8 Mon Sep 17 00:00:00 2001
From: Henry de Valence <hdevalence@hdevalence.ca>
Date: Tue, 27 Mar 2018 15:03:19 -0700
Subject: [PATCH] Clarify wording on canonical scalars

---
 src/ristretto.rs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/ristretto.rs b/src/ristretto.rs
index aac5e67..4f4a703 100644
--- a/src/ristretto.rs
+++ b/src/ristretto.rs
@@ -69,8 +69,10 @@
 //! ## Scalars
 //!
 //! Scalars are represented by the `Scalar` struct.  Each scalar has a
-//! canonical representative mod the group order; see
-//! `Scalar::from_canonical_bytes()` and `Scalar::is_canonical()`.
+//! canonical representative mod the group order.  To attempt to load
+//! a supposedly-canonical scalar, use
+//! `Scalar::from_canonical_bytes()`. To check whether a
+//! representative is canonical, use `Scalar::is_canonical()`.
 //!
 //! ## Scalar Multiplication
 //!