field: extend docstring of secp256k1_fe_normalize

bitcoin-core · Jan 16, 2020 · 305d46f · 305d46f
1 parent d135b07
commit 305d46f
Showing 1 changed file with 4 additions and 2 deletions.
diff --git a/src/field.h b/src/field.h
@@ -32,10 +32,12 @@
 
 #include "util.h"
 
-/** Normalize a field element. */
+/** Normalize a field element. This brings the field element to a canonical representation, reduces
+ *  its magnitude to 1, and reduces it modulo field size `p`.
+ */
 static void secp256k1_fe_normalize(secp256k1_fe *r);
 
-/** Weakly normalize a field element: reduce it magnitude to 1, but don't fully normalize. */
+/** Weakly normalize a field element: reduce its magnitude to 1, but don't fully normalize. */
 static void secp256k1_fe_normalize_weak(secp256k1_fe *r);
 
 /** Normalize a field element, without constant-time guarantee. */