X-Git-Url: https://git.distorted.org.uk/u/mdw/catacomb/blobdiff_plain/3beded3716206d231f433c210e691159adbe7b66..80be023065ced106a4078a36371c135a60d2bd6c:/mpmont.h

diff --git a/mpmont.h b/mpmont.h
index 58b051b..44be367 100644
--- a/mpmont.h
+++ b/mpmont.h
@@ -1,6 +1,6 @@
 /* -*-c-*-
  *
- * $Id: mpmont.h,v 1.6 2002/01/13 13:49:25 mdw Exp $
+ * $Id$
  *
  * Montgomery reduction
  *
@@ -27,32 +27,6 @@
  * MA 02111-1307, USA.
  */
 
-/*----- Revision history --------------------------------------------------* 
- *
- * $Log: mpmont.h,v $
- * Revision 1.6  2002/01/13 13:49:25  mdw
- * Make @const@-correct.
- *
- * Revision 1.5  2001/06/16 13:00:04  mdw
- * Moved @mpmont_factor@ to <mp.h>.  Documented interface change to
- * @mpmont_expr@ and @mpmont_mexpr@ -- the arguments are now in Montgomery
- * form.
- *
- * Revision 1.4  1999/12/11 01:51:14  mdw
- * Use a Karatsuba-based reduction for large moduli.
- *
- * Revision 1.3  1999/12/10 23:29:48  mdw
- * Change header file guard names.
- *
- * Revision 1.2  1999/11/19 13:17:43  mdw
- * Add extra interface to exponentiation which returns a Montgomerized
- * result.  Add simultaneous exponentiation interface.
- *
- * Revision 1.1  1999/11/17 18:02:16  mdw
- * New multiprecision integer arithmetic suite.
- *
- */
-
 #ifndef CATACOMB_MPMONT_H
 #define CATACOMB_MPMONT_H
 
@@ -118,13 +92,13 @@ typedef struct mpmont {
  * Arguments:	@mpmont *mm@ = pointer to Montgomery reduction context
  *		@mp *m@ = modulus to use
  *
- * Returns:	---
+ * Returns:	Zero on success, nonzero on error.
  *
  * Use:		Initializes a Montgomery reduction context ready for use.
  *		The argument @m@ must be a positive odd integer.
  */
 
-extern void mpmont_create(mpmont */*mm*/, mp */*m*/);
+extern int mpmont_create(mpmont */*mm*/, mp */*m*/);
 
 /* --- @mpmont_destroy@ --- *
  *
@@ -189,7 +163,7 @@ extern mp *mpmont_exp(mpmont */*mm*/, mp */*d*/, mp */*a*/, mp */*e*/);
  *
  * Arguments:	@mpmont *mm@ = pointer to Montgomery reduction context
  *		@mp *d@ = fake destination
- *		@mp_expfactor *f@ = pointer to array of factors
+ *		@const mp_expfactor *f@ = pointer to array of factors
  *		@size_t n@ = number of factors supplied
  *
  * Returns:	If the bases are %$g_0, g_1, \ldots, g_{n-1}$% and the
@@ -203,7 +177,7 @@ extern mp *mpmont_exp(mpmont */*mm*/, mp */*d*/, mp */*a*/, mp */*e*/);
  */
 
 extern mp *mpmont_mexpr(mpmont */*mm*/, mp */*d*/,
-			mp_expfactor */*f*/, size_t /*n*/);
+			const mp_expfactor */*f*/, size_t /*n*/);
 
 /* --- @mpmont_mexp@ --- *
  *