revert the ill-considered part of the 2001-05-24 changes
[bpt/guile.git] / libguile / numbers.c
index a1491b8..8f08a74 100644 (file)
@@ -1,4 +1,4 @@
-/* Copyright (C) 1995,1996,1997,1998,1999,2000 Free Software Foundation, Inc.
+/* Copyright (C) 1995,1996,1997,1998,1999,2000,2001 Free Software Foundation, Inc.
  *
  * This program is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
@@ -44,7 +44,6 @@
 
 \f
 
-#include <stdio.h>
 #include <math.h>
 #include "libguile/_scm.h"
 #include "libguile/feature.h"
 
 #include "libguile/validate.h"
 #include "libguile/numbers.h"
+#include "libguile/deprecation.h"
 
 \f
 
-static SCM scm_divbigbig (SCM_BIGDIG *x, scm_sizet nx, SCM_BIGDIG *y, scm_sizet ny, int sgn, int modes);
+static SCM scm_divbigbig (SCM_BIGDIG *x, size_t nx, SCM_BIGDIG *y, size_t ny, int sgn, int modes);
 static SCM scm_divbigint (SCM x, long z, int sgn, int mode);
 
 
@@ -69,14 +69,10 @@ static SCM scm_divbigint (SCM x, long z, int sgn, int mode);
 #define SCM_SWAP(x,y) do { SCM __t = x; x = y; y = __t; } while (0)
 
 
-#if (SCM_DEBUG_DEPRECATED == 1)  /* not defined in header yet? */
-
-/* SCM_FLOBUFLEN is the maximum number of characters neccessary for the
+/* FLOBUFLEN is the maximum number of characters neccessary for the
  * printed or scm_string representation of an inexact number.
  */
-#define SCM_FLOBUFLEN (10+2*(sizeof(double)/sizeof(char)*SCM_CHAR_BIT*3+9)/10)
-
-#endif  /* SCM_DEBUG_DEPRECATED == 1 */
+#define FLOBUFLEN (10+2*(sizeof(double)/sizeof(char)*SCM_CHAR_BIT*3+9)/10)
 
 
 /* IS_INF tests its floating point number for infiniteness
@@ -96,10 +92,15 @@ static SCM scm_divbigint (SCM x, long z, int sgn, int mode);
 
 \f
 
+static SCM abs_most_negative_fixnum;
+
+\f
+
 
 SCM_DEFINE (scm_exact_p, "exact?", 1, 0, 0, 
             (SCM x),
-           "Return #t if X is an exact number, #f otherwise.")
+           "Return @code{#t} if @var{x} is an exact number, @code{#f}\n"
+           "otherwise.")
 #define FUNC_NAME s_scm_exact_p
 {
   if (SCM_INUMP (x)) {
@@ -115,7 +116,8 @@ SCM_DEFINE (scm_exact_p, "exact?", 1, 0, 0,
 
 SCM_DEFINE (scm_odd_p, "odd?", 1, 0, 0, 
             (SCM n),
-           "Return #t if N is an odd number, #f otherwise.")
+           "Return @code{#t} if @var{n} is an odd number, @code{#f}\n"
+           "otherwise.")
 #define FUNC_NAME s_scm_odd_p
 {
   if (SCM_INUMP (n)) {
@@ -131,7 +133,8 @@ SCM_DEFINE (scm_odd_p, "odd?", 1, 0, 0,
 
 SCM_DEFINE (scm_even_p, "even?", 1, 0, 0, 
             (SCM n),
-           "Return #t if N is an even number, #f otherwise.")
+           "Return @code{#t} if @var{n} is an even number, @code{#f}\n"
+           "otherwise.")
 #define FUNC_NAME s_scm_even_p
 {
   if (SCM_INUMP (n)) {
@@ -146,7 +149,8 @@ SCM_DEFINE (scm_even_p, "even?", 1, 0, 0,
 
 
 SCM_GPROC (s_abs, "abs", 1, 0, 0, scm_abs, g_abs);
-
+/* "Return the absolute value of @var{x}."
+ */
 SCM
 scm_abs (SCM x)
 {
@@ -158,7 +162,7 @@ scm_abs (SCM x)
       return SCM_MAKINUM (-xx);
     } else {
 #ifdef SCM_BIGDIG
-      return scm_long2big (-xx);
+      return scm_i_long2big (-xx);
 #else
       scm_num_overflow (s_abs);
 #endif
@@ -167,7 +171,7 @@ scm_abs (SCM x)
     if (!SCM_BIGSIGN (x)) {
       return x;
     } else {
-      return scm_copybig (x, 0);
+      return scm_i_copybig (x, 0);
     }
   } else if (SCM_REALP (x)) {
     return scm_make_real (fabs (SCM_REAL_VALUE (x)));
@@ -178,7 +182,8 @@ scm_abs (SCM x)
 
 
 SCM_GPROC (s_quotient, "quotient", 2, 0, 0, scm_quotient, g_quotient);
-
+/* "Return the quotient of the numbers @var{x} and @var{y}."
+ */
 SCM
 scm_quotient (SCM x, SCM y)
 {
@@ -194,14 +199,21 @@ scm_quotient (SCM x, SCM y)
          return SCM_MAKINUM (z);
        } else {
 #ifdef SCM_BIGDIG
-         return scm_long2big (z);
+         return scm_i_long2big (z);
 #else
          scm_num_overflow (s_quotient);
 #endif
        }
       }
     } else if (SCM_BIGP (y)) {
-      return SCM_INUM0;
+      if (SCM_INUM (x) == SCM_MOST_NEGATIVE_FIXNUM
+         && scm_bigcomp (abs_most_negative_fixnum, y) == 0)
+       {
+         /* Special case:  x == fixnum-min && y == abs (fixnum-min) */
+         return SCM_MAKINUM (-1);
+       }
+      else
+       return SCM_MAKINUM (0);
     } else {
       SCM_WTA_DISPATCH_2 (g_quotient, x, y, SCM_ARG2, s_quotient);
     }
@@ -216,9 +228,9 @@ scm_quotient (SCM x, SCM y)
        long z = yy < 0 ? -yy : yy;
        
        if (z < SCM_BIGRAD) {
-         SCM sw = scm_copybig (x, SCM_BIGSIGN (x) ? (yy > 0) : (yy < 0));
+         SCM sw = scm_i_copybig (x, SCM_BIGSIGN (x) ? (yy > 0) : (yy < 0));
          scm_divbigdig (SCM_BDIGITS (sw), SCM_NUMDIGS (sw), (SCM_BIGDIG) z);
-         return scm_normbig (sw);
+         return scm_i_normbig (sw);
        } else {
 #ifndef SCM_DIGSTOOBIG
          long w = scm_pseudolong (z);
@@ -248,7 +260,12 @@ scm_quotient (SCM x, SCM y)
 
 
 SCM_GPROC (s_remainder, "remainder", 2, 0, 0, scm_remainder, g_remainder);
-
+/* "Return the remainder of the numbers @var{x} and @var{y}.\n"
+ * "@lisp\n"
+ * "(remainder 13 4) @result{} 1\n"
+ * "(remainder -13 4) @result{} -1\n"
+ * "@end lisp"
+ */
 SCM
 scm_remainder (SCM x, SCM y)
 {
@@ -262,7 +279,14 @@ scm_remainder (SCM x, SCM y)
        return SCM_MAKINUM (z);
       }
     } else if (SCM_BIGP (y)) {
-      return x;
+      if (SCM_INUM (x) == SCM_MOST_NEGATIVE_FIXNUM
+         && scm_bigcomp (abs_most_negative_fixnum, y) == 0)
+       {
+         /* Special case:  x == fixnum-min && y == abs (fixnum-min) */
+         return SCM_MAKINUM (0);
+       }
+      else
+       return x;
     } else {
       SCM_WTA_DISPATCH_2 (g_remainder, x, y, SCM_ARG2, s_remainder);
     }
@@ -288,7 +312,12 @@ scm_remainder (SCM x, SCM y)
 
 
 SCM_GPROC (s_modulo, "modulo", 2, 0, 0, scm_modulo, g_modulo);
-
+/* "Return the modulo of the numbers @var{x} and @var{y}.\n"
+ * "@lisp\n"
+ * "(modulo 13 4) @result{} 1\n"
+ * "(modulo -13 4) @result{} 3\n"
+ * "@end lisp"
+ */
 SCM
 scm_modulo (SCM x, SCM y)
 {
@@ -331,7 +360,9 @@ scm_modulo (SCM x, SCM y)
 
 
 SCM_GPROC1 (s_gcd, "gcd", scm_tc7_asubr, scm_gcd, g_gcd);
-
+/* "Return the greatest common divisor of all arguments.\n"
+ * "If called without arguments, 0 is returned."
+ */
 SCM
 scm_gcd (SCM x, SCM y)
 {
@@ -391,7 +422,7 @@ scm_gcd (SCM x, SCM y)
        return SCM_MAKINUM (result);
       } else {
 #ifdef SCM_BIGDIG
-       return scm_long2big (result);
+       return scm_i_long2big (result);
 #else
        scm_num_overflow (s_gcd);
 #endif
@@ -405,7 +436,7 @@ scm_gcd (SCM x, SCM y)
   } else if (SCM_BIGP (x)) {
   big_gcd:
     if (SCM_BIGSIGN (x))
-      x = scm_copybig (x, 0);
+      x = scm_i_copybig (x, 0);
   newy:
     if (SCM_INUMP (y)) {
       if (SCM_EQ_P (y, SCM_INUM0)) {
@@ -415,7 +446,7 @@ scm_gcd (SCM x, SCM y)
       }
     } else if (SCM_BIGP (y)) {
       if (SCM_BIGSIGN (y))
-       y = scm_copybig (y, 0);
+       y = scm_i_copybig (y, 0);
       switch (scm_bigcomp (x, y))
        {
        case -1:  /* x > y */
@@ -444,7 +475,9 @@ scm_gcd (SCM x, SCM y)
 
 
 SCM_GPROC1 (s_lcm, "lcm", scm_tc7_asubr, scm_lcm, g_lcm);
-
+/* "Return the least common multiple of the arguments.\n"
+ * "If called without arguments, 1 is returned."
+ */
 SCM
 scm_lcm (SCM n1, SCM n2)
 {
@@ -523,18 +556,18 @@ scm_lcm (SCM n1, SCM n2)
 #ifdef SCM_BIGDIG
 
 SCM scm_copy_big_dec(SCM b, int sign);
-SCM scm_copy_smaller(SCM_BIGDIG *x, scm_sizet nx, int zsgn);
-SCM scm_big_ior(SCM_BIGDIG *x, scm_sizet nx, int xsgn, SCM bigy);
-SCM scm_big_xor(SCM_BIGDIG *x, scm_sizet nx, int xsgn, SCM bigy);
-SCM scm_big_and(SCM_BIGDIG *x, scm_sizet nx, int xsgn, SCM bigy, int zsgn);
-SCM scm_big_test(SCM_BIGDIG *x, scm_sizet nx, int xsgn, SCM bigy);
+SCM scm_copy_smaller(SCM_BIGDIG *x, size_t nx, int zsgn);
+SCM scm_big_ior(SCM_BIGDIG *x, size_t nx, int xsgn, SCM bigy);
+SCM scm_big_xor(SCM_BIGDIG *x, size_t nx, int xsgn, SCM bigy);
+SCM scm_big_and(SCM_BIGDIG *x, size_t nx, int xsgn, SCM bigy, int zsgn);
+SCM scm_big_test(SCM_BIGDIG *x, size_t nx, int xsgn, SCM bigy);
 
 SCM scm_copy_big_dec(SCM b, int sign)
 {
   long num = -1;
-  scm_sizet nx = SCM_NUMDIGS(b);
-  scm_sizet i = 0;
-  SCM ans = scm_mkbig(nx, sign);
+  size_t nx = SCM_NUMDIGS(b);
+  size_t i = 0;
+  SCM ans = scm_i_mkbig(nx, sign);
   SCM_BIGDIG *src = SCM_BDIGITS(b), *dst = SCM_BDIGITS(ans);
   if SCM_BIGSIGN(b) do {
     num += src[i];
@@ -546,11 +579,11 @@ SCM scm_copy_big_dec(SCM b, int sign)
   return ans;
 }
 
-SCM scm_copy_smaller(SCM_BIGDIG *x, scm_sizet nx, int zsgn)
+SCM scm_copy_smaller(SCM_BIGDIG *x, size_t nx, int zsgn)
 {
   long num = -1;
-  scm_sizet i = 0;
-  SCM z = scm_mkbig(nx, zsgn);
+  size_t i = 0;
+  SCM z = scm_i_mkbig(nx, zsgn);
   SCM_BIGDIG *zds = SCM_BDIGITS(z);
   if (zsgn) do {
     num += x[i];
@@ -561,12 +594,12 @@ SCM scm_copy_smaller(SCM_BIGDIG *x, scm_sizet nx, int zsgn)
   return z;
 }
 
-SCM scm_big_ior(SCM_BIGDIG *x, scm_sizet nx, int xsgn, SCM bigy)
+SCM scm_big_ior(SCM_BIGDIG *x, size_t nx, int xsgn, SCM bigy)
 /* Assumes nx <= SCM_NUMDIGS(bigy) */
 /* Assumes xsgn equals either 0 or SCM_BIGSIGNFLAG */
 {
   long num = -1;
-  scm_sizet i = 0, ny = SCM_NUMDIGS(bigy);
+  size_t i = 0, ny = SCM_NUMDIGS(bigy);
   SCM z = scm_copy_big_dec (bigy, xsgn & SCM_BIGSIGN (bigy));
   SCM_BIGDIG *zds = SCM_BDIGITS(z);
   if (xsgn) {
@@ -583,7 +616,7 @@ SCM scm_big_ior(SCM_BIGDIG *x, scm_sizet nx, int xsgn, SCM bigy)
       num = SCM_BIGDN(num);
       if (!num) return z;
     }
-    scm_adjbig(z, 1 + ny);             /* OOPS, overflowed into next digit. */
+    scm_i_adjbig(z, 1 + ny);           /* OOPS, overflowed into next digit. */
     SCM_BDIGITS(z)[ny] = 1;
     return z;
   }
@@ -591,12 +624,12 @@ SCM scm_big_ior(SCM_BIGDIG *x, scm_sizet nx, int xsgn, SCM bigy)
   return z;
 }
 
-SCM scm_big_xor(SCM_BIGDIG *x, scm_sizet nx, int xsgn, SCM bigy)
+SCM scm_big_xor(SCM_BIGDIG *x, size_t nx, int xsgn, SCM bigy)
 /* Assumes nx <= SCM_NUMDIGS(bigy) */
 /* Assumes xsgn equals either 0 or SCM_BIGSIGNFLAG */
 {
   long num = -1;
-  scm_sizet i = 0, ny = SCM_NUMDIGS(bigy);
+  size_t i = 0, ny = SCM_NUMDIGS(bigy);
   SCM z = scm_copy_big_dec(bigy, xsgn ^ SCM_BIGSIGN(bigy));
   SCM_BIGDIG *zds = SCM_BDIGITS(z);
   if (xsgn) do {
@@ -615,19 +648,19 @@ SCM scm_big_xor(SCM_BIGDIG *x, scm_sizet nx, int xsgn, SCM bigy)
       num += zds[i];
       zds[i++] = SCM_BIGLO(num);
       num = SCM_BIGDN(num);
-      if (!num) return scm_normbig(z);
+      if (!num) return scm_i_normbig(z);
     }
   }
-  return scm_normbig(z);
+  return scm_i_normbig(z);
 }
 
-SCM scm_big_and(SCM_BIGDIG *x, scm_sizet nx, int xsgn, SCM bigy, int zsgn)
+SCM scm_big_and(SCM_BIGDIG *x, size_t nx, int xsgn, SCM bigy, int zsgn)
 /* Assumes nx <= SCM_NUMDIGS(bigy) */
 /* Assumes xsgn equals either 0 or SCM_BIGSIGNFLAG */
 /* return sign equals either 0 or SCM_BIGSIGNFLAG */
 {
   long num = -1;
-  scm_sizet i = 0;
+  size_t i = 0;
   SCM z;
   SCM_BIGDIG *zds;
   if (xsgn==zsgn) {
@@ -651,24 +684,26 @@ SCM scm_big_and(SCM_BIGDIG *x, scm_sizet nx, int xsgn, SCM bigy, int zsgn)
       num += zds[i];
       zds[i++] = SCM_BIGLO(num);
       num = SCM_BIGDN(num);
-      if (!num) return scm_normbig(z);
+      if (!num) return scm_i_normbig(z);
     }
   }
-  else if (xsgn) do {
-    num += x[i];
-    if (num < 0) {zds[i] &= num + SCM_BIGRAD; num = -1;}
-    else {zds[i] &= ~SCM_BIGLO(num); num = 0;}
-  } while (++i < nx);
-  else do zds[i] = zds[i] & x[i]; while (++i < nx);
-  return scm_normbig(z);
+  else if (xsgn) {
+    unsigned long int carry = 1;
+    do {
+      unsigned long int mask = (SCM_BIGDIG) ~x[i] + carry;
+      zds[i] = zds[i] & (SCM_BIGDIG) mask;
+      carry = (mask >= SCM_BIGRAD) ? 1 : 0;
+    } while (++i < nx);
+  } else do zds[i] = zds[i] & x[i]; while (++i < nx);
+  return scm_i_normbig(z);
 }
 
-SCM scm_big_test(SCM_BIGDIG *x, scm_sizet nx, int xsgn, SCM bigy)
+SCM scm_big_test(SCM_BIGDIG *x, size_t nx, int xsgn, SCM bigy)
 /* Assumes nx <= SCM_NUMDIGS(bigy) */
 /* Assumes xsgn equals either 0 or SCM_BIGSIGNFLAG */
 {
   SCM_BIGDIG *y;
-  scm_sizet i = 0;
+  size_t i = 0;
   long num = -1;
   if (SCM_BIGSIGN(bigy) & xsgn) return SCM_BOOL_T;
   if (SCM_NUMDIGS(bigy) != nx && xsgn) return SCM_BOOL_T;
@@ -708,13 +743,13 @@ SCM scm_big_test(SCM_BIGDIG *x, scm_sizet nx, int xsgn, SCM bigy)
 
 SCM_DEFINE1 (scm_logand, "logand", scm_tc7_asubr,
              (SCM n1, SCM n2),
-            "Returns the integer which is the bit-wise AND of the two integer\n"
-            "arguments.\n\n"
-            "Example:\n"
-            "@lisp\n"
-            "(number->string (logand #b1100 #b1010) 2)\n"
-            "   @result{} \"1000\"\n"
-            "@end lisp")
+           "Return the integer which is the bit-wise AND of the two integer\n"
+           "arguments.\n"
+           "\n"
+           "@lisp\n"
+           "(number->string (logand #b1100 #b1010) 2)\n"
+           "   @result{} \"1000\"\n"
+           "@end lisp")
 #define FUNC_NAME s_scm_logand
 {
   long int nn1;
@@ -795,13 +830,13 @@ SCM_DEFINE1 (scm_logand, "logand", scm_tc7_asubr,
 
 SCM_DEFINE1 (scm_logior, "logior", scm_tc7_asubr,
              (SCM n1, SCM n2),
-            "Returns the integer which is the bit-wise OR of the two integer\n"
-            "arguments.\n\n"
-            "Example:\n"
-            "@lisp\n"
-            "(number->string (logior #b1100 #b1010) 2)\n"
-            "   @result{} \"1110\"\n"
-            "@end lisp")
+           "Return the integer which is the bit-wise OR of the two integer\n"
+           "arguments.\n"
+           "\n"
+           "@lisp\n"
+           "(number->string (logior #b1100 #b1010) 2)\n"
+           "   @result{} \"1110\"\n"
+           "@end lisp")
 #define FUNC_NAME s_scm_logior
 {
   long int nn1;
@@ -839,7 +874,7 @@ SCM_DEFINE1 (scm_logior, "logior", scm_tc7_asubr,
                              (nn1 < 0) ? SCM_BIGSIGNFLAG : 0, n2, SCM_BIGSIGNFLAG);
        }
 # else
-       BIGDIG zdigs [DIGSPERLONG];
+       SCM_BIGDIG zdigs [SCM_DIGSPERLONG];
        scm_longdigs (nn1, zdigs);
        if ((!(nn1 < 0)) && !SCM_BIGSIGN (n2)) {
          return scm_big_ior (zdigs, SCM_DIGSPERLONG, 
@@ -881,13 +916,13 @@ SCM_DEFINE1 (scm_logior, "logior", scm_tc7_asubr,
 
 SCM_DEFINE1 (scm_logxor, "logxor", scm_tc7_asubr,
              (SCM n1, SCM n2),
-            "Returns the integer which is the bit-wise XOR of the two integer\n"
-            "arguments.\n\n"
-            "Example:\n"
-            "@lisp\n"
-            "(number->string (logxor #b1100 #b1010) 2)\n"
-            "   @result{} \"110\"\n"
-            "@end lisp")
+           "Return the integer which is the bit-wise XOR of the two integer\n"
+           "arguments.\n"
+           "\n"
+           "@lisp\n"
+           "(number->string (logxor #b1100 #b1010) 2)\n"
+           "   @result{} \"110\"\n"
+           "@end lisp")
 #define FUNC_NAME s_scm_logxor
 {
   long int nn1;
@@ -951,54 +986,54 @@ SCM_DEFINE1 (scm_logxor, "logxor", scm_tc7_asubr,
 
 
 SCM_DEFINE (scm_logtest, "logtest", 2, 0, 0,
-            (SCM n1, SCM n2),
-           "@example\n"
+            (SCM j, SCM k),
+           "@lisp\n"
            "(logtest j k) @equiv{} (not (zero? (logand j k)))\n\n"
            "(logtest #b0100 #b1011) @result{} #f\n"
            "(logtest #b0100 #b0111) @result{} #t\n"
-           "@end example")
+           "@end lisp")
 #define FUNC_NAME s_scm_logtest
 {
-  long int nn1;
+  long int nj;
 
-  if (SCM_INUMP (n1)) {
-    nn1 = SCM_INUM (n1);
-    if (SCM_INUMP (n2)) {
-      long nn2 = SCM_INUM (n2);
-      return SCM_BOOL (nn1 & nn2);
-    } else if (SCM_BIGP (n2)) {
+  if (SCM_INUMP (j)) {
+    nj = SCM_INUM (j);
+    if (SCM_INUMP (k)) {
+      long nk = SCM_INUM (k);
+      return SCM_BOOL (nj & nk);
+    } else if (SCM_BIGP (k)) {
     intbig: 
       {
 # ifndef SCM_DIGSTOOBIG
-       long z = scm_pseudolong (nn1);
+       long z = scm_pseudolong (nj);
        return scm_big_test ((SCM_BIGDIG *)&z, SCM_DIGSPERLONG, 
-                            (nn1 < 0) ? SCM_BIGSIGNFLAG : 0, n2);
+                            (nj < 0) ? SCM_BIGSIGNFLAG : 0, k);
 # else
        SCM_BIGDIG zdigs [SCM_DIGSPERLONG];
-       scm_longdigs (nn1, zdigs);
+       scm_longdigs (nj, zdigs);
        return scm_big_test (zdigs, SCM_DIGSPERLONG, 
-                            (nn1 < 0) ? SCM_BIGSIGNFLAG : 0, n2);
+                            (nj < 0) ? SCM_BIGSIGNFLAG : 0, k);
 # endif
       }
     } else {
-      SCM_WRONG_TYPE_ARG (SCM_ARG2, n2);
+      SCM_WRONG_TYPE_ARG (SCM_ARG2, k);
     }
-  } else if (SCM_BIGP (n1)) {
-    if (SCM_INUMP (n2)) {
-      SCM_SWAP (n1, n2);
-      nn1 = SCM_INUM (n1);
+  } else if (SCM_BIGP (j)) {
+    if (SCM_INUMP (k)) {
+      SCM_SWAP (j, k);
+      nj = SCM_INUM (j);
       goto intbig;
-    } else if (SCM_BIGP (n2)) {
-      if (SCM_NUMDIGS (n1) > SCM_NUMDIGS (n2)) {
-       SCM_SWAP (n1, n2);
+    } else if (SCM_BIGP (k)) {
+      if (SCM_NUMDIGS (j) > SCM_NUMDIGS (k)) {
+       SCM_SWAP (j, k);
       }
-      return scm_big_test (SCM_BDIGITS (n1), SCM_NUMDIGS (n1), 
-                          SCM_BIGSIGN (n1), n2);
+      return scm_big_test (SCM_BDIGITS (j), SCM_NUMDIGS (j), 
+                          SCM_BIGSIGN (j), k);
     } else {
-      SCM_WRONG_TYPE_ARG (SCM_ARG2, n2);
+      SCM_WRONG_TYPE_ARG (SCM_ARG2, k);
     }
   } else {
-    SCM_WRONG_TYPE_ARG (SCM_ARG1, n1);
+    SCM_WRONG_TYPE_ARG (SCM_ARG1, j);
   }
 }
 #undef FUNC_NAME
@@ -1006,14 +1041,14 @@ SCM_DEFINE (scm_logtest, "logtest", 2, 0, 0,
 
 SCM_DEFINE (scm_logbit_p, "logbit?", 2, 0, 0,
             (SCM index, SCM j),
-           "@example\n"
+           "@lisp\n"
            "(logbit? index j) @equiv{} (logtest (integer-expt 2 index) j)\n\n"
            "(logbit? 0 #b1101) @result{} #t\n"
            "(logbit? 1 #b1101) @result{} #f\n"
            "(logbit? 2 #b1101) @result{} #t\n"
            "(logbit? 3 #b1101) @result{} #t\n"
            "(logbit? 4 #b1101) @result{} #f\n"
-           "@end example")
+           "@end lisp")
 #define FUNC_NAME s_scm_logbit_p
 {
   unsigned long int iindex;
@@ -1028,9 +1063,9 @@ SCM_DEFINE (scm_logbit_p, "logbit?", 2, 0, 0,
       return SCM_BOOL_F;
     } else if (SCM_BIGSIGN (j)) {
       long num = -1;
-      scm_sizet i = 0;
+      size_t i = 0;
       SCM_BIGDIG * x = SCM_BDIGITS (j);
-      scm_sizet nx = iindex / SCM_BITSPERDIG;
+      size_t nx = iindex / SCM_BITSPERDIG;
       while (1) {
        num += x[i];
        if (nx == i++) {
@@ -1054,15 +1089,15 @@ SCM_DEFINE (scm_logbit_p, "logbit?", 2, 0, 0,
 
 SCM_DEFINE (scm_lognot, "lognot", 1, 0, 0, 
             (SCM n),
-           "Returns the integer which is the 2s-complement of the integer argument.\n\n"
-           "Example:\n"
+           "Return the integer which is the 2s-complement of the integer\n"
+           "argument.\n"
+           "\n"
            "@lisp\n"
            "(number->string (lognot #b10000000) 2)\n"
            "   @result{} \"-10000001\"\n"
            "(number->string (lognot #b0) 2)\n"
            "   @result{} \"-1\"\n"
-           "@end lisp\n"
-           "")
+           "@end lisp")
 #define FUNC_NAME s_scm_lognot
 {
   return scm_difference (SCM_MAKINUM (-1L), n);
@@ -1071,8 +1106,9 @@ SCM_DEFINE (scm_lognot, "lognot", 1, 0, 0,
 
 SCM_DEFINE (scm_integer_expt, "integer-expt", 2, 0, 0,
             (SCM n, SCM k),
-           "Returns @var{n} raised to the non-negative integer exponent @var{k}.\n\n"
-           "Example:\n"
+           "Return @var{n} raised to the non-negative integer exponent\n"
+           "@var{k}.\n"
+           "\n"
            "@lisp\n"
            "(integer-expt 2 5)\n"
            "   @result{} 32\n"
@@ -1111,20 +1147,20 @@ SCM_DEFINE (scm_integer_expt, "integer-expt", 2, 0, 0,
 
 SCM_DEFINE (scm_ash, "ash", 2, 0, 0,
             (SCM n, SCM cnt),
-           "The function ash performs an arithmetic shift left by CNT bits\n"
-           "(or shift right, if CNT is negative).  'Arithmetic' means, that\n"
-           "the function does not guarantee to keep the bit structure of N,\n"
-           "but rather guarantees that the result will always be rounded\n"
-           "towards minus infinity.  Therefore, the results of ash and a\n"
-           "corresponding bitwise shift will differ if N is negative.\n\n"
+           "The function ash performs an arithmetic shift left by @var{cnt}\n"
+           "bits (or shift right, if @var{cnt} is negative).  'Arithmetic'\n"
+           "means, that the function does not guarantee to keep the bit\n"
+           "structure of @var{n}, but rather guarantees that the result\n"
+           "will always be rounded towards minus infinity.  Therefore, the\n"
+           "results of ash and a corresponding bitwise shift will differ if\n"
+           "@var{n} is negative.\n"
+           "\n"
            "Formally, the function returns an integer equivalent to\n"
-           "@code{(inexact->exact (floor (* N (expt 2 CNT))))}.@refill\n\n"
-           "Example:\n"
+           "@code{(inexact->exact (floor (* @var{n} (expt 2 @var{cnt}))))}.\n"
+           "\n"
            "@lisp\n"
-           "(number->string (ash #b1 3) 2)\n"
-           "   @result{} \"1000\"\n"
-           "(number->string (ash #b1010 -1) 2)\n"
-           "   @result{} \"101\"\n"
+           "(number->string (ash #b1 3) 2)     @result{} \"1000\"\n"
+           "(number->string (ash #b1010 -1) 2) @result{} \"101\"\n"
            "@end lisp")
 #define FUNC_NAME s_scm_ash
 {
@@ -1169,10 +1205,10 @@ SCM_DEFINE (scm_ash, "ash", 2, 0, 0,
 
 SCM_DEFINE (scm_bit_extract, "bit-extract", 3, 0, 0,
             (SCM n, SCM start, SCM end),
-           "Returns the integer composed of the @var{start} (inclusive) through\n"
-           "@var{end} (exclusive) bits of @var{n}.  The @var{start}th bit becomes\n"
-           "the 0-th bit in the result.@refill\n\n"
-           "Example:\n"
+           "Return the integer composed of the @var{start} (inclusive)\n"
+           "through @var{end} (exclusive) bits of @var{n}.  The\n"
+           "@var{start}th bit becomes the 0-th bit in the result.\n"
+           "\n"
            "@lisp\n"
            "(number->string (bit-extract #b1101101010 0 4) 2)\n"
            "   @result{} \"1010\"\n"
@@ -1181,19 +1217,50 @@ SCM_DEFINE (scm_bit_extract, "bit-extract", 3, 0, 0,
            "@end lisp")
 #define FUNC_NAME s_scm_bit_extract
 {
-  int istart, iend;
+  unsigned long int istart, iend;
   SCM_VALIDATE_INUM_MIN_COPY (2,start,0,istart);
   SCM_VALIDATE_INUM_MIN_COPY (3, end, 0, iend);
   SCM_ASSERT_RANGE (3, end, (iend >= istart));
 
   if (SCM_INUMP (n)) {
-    return SCM_MAKINUM ((SCM_INUM (n) >> istart) & ((1L << (iend - istart)) - 1));
+    long int in = SCM_INUM (n);
+    unsigned long int bits = iend - istart;
+
+    if (in < 0 && bits >= SCM_I_FIXNUM_BIT)
+      {
+       /* Since we emulate two's complement encoded numbers, this special
+        * case requires us to produce a result that has more bits than can be
+        * stored in a fixnum.  Thus, we fall back to the more general
+        * algorithm that is used for bignums.  
+        */
+       goto generalcase;
+      }
+
+    if (istart < SCM_I_FIXNUM_BIT)
+      {
+       in = in >> istart;
+       if (bits < SCM_I_FIXNUM_BIT)
+         return SCM_MAKINUM (in & ((1L << bits) - 1));
+       else /* we know: in >= 0 */
+         return SCM_MAKINUM (in);
+      }
+    else if (in < 0)
+      {
+       return SCM_MAKINUM (-1L & ((1L << bits) - 1));
+      }
+    else
+      {
+       return SCM_MAKINUM (0);
+      }
   } else if (SCM_BIGP (n)) {
-    SCM num1 = SCM_MAKINUM (1L);
-    SCM num2 = SCM_MAKINUM (2L);
-    SCM bits = SCM_MAKINUM (iend - istart);
-    SCM mask  = scm_difference (scm_integer_expt (num2, bits), num1);
-    return scm_logand (mask, scm_ash (n, SCM_MAKINUM (-istart)));
+  generalcase:
+    {
+      SCM num1 = SCM_MAKINUM (1L);
+      SCM num2 = SCM_MAKINUM (2L);
+      SCM bits = SCM_MAKINUM (iend - istart);
+      SCM mask  = scm_difference (scm_integer_expt (num2, bits), num1);
+      return scm_logand (mask, scm_ash (n, SCM_MAKINUM (-istart)));
+    }
   } else {
     SCM_WRONG_TYPE_ARG (SCM_ARG1, n);
   }
@@ -1207,11 +1274,11 @@ static const char scm_logtab[] = {
 
 SCM_DEFINE (scm_logcount, "logcount", 1, 0, 0,
             (SCM n),
-           "Returns the number of bits in integer @var{n}.  If integer is positive,\n"
-           "the 1-bits in its binary representation are counted.  If negative, the\n"
-           "0-bits in its two's-complement binary representation are counted.  If 0,\n"
-           "0 is returned.\n\n"
-           "Example:\n"
+           "Return the number of bits in integer @var{n}.  If integer is\n"
+           "positive, the 1-bits in its binary representation are counted.\n"
+           "If negative, the 0-bits in its two's-complement binary\n"
+           "representation are counted.  If 0, 0 is returned.\n"
+           "\n"
            "@lisp\n"
            "(logcount #b10101010)\n"
            "   @result{} 4\n"
@@ -1238,7 +1305,7 @@ SCM_DEFINE (scm_logcount, "logcount", 1, 0, 0,
       return scm_logcount (scm_difference (SCM_MAKINUM (-1L), n));
     } else {
       unsigned long int c = 0;
-      scm_sizet i = SCM_NUMDIGS (n);
+      size_t i = SCM_NUMDIGS (n);
       SCM_BIGDIG * ds = SCM_BDIGITS (n);
       while (i--) {
        SCM_BIGDIG d;
@@ -1261,8 +1328,8 @@ static const char scm_ilentab[] = {
 
 SCM_DEFINE (scm_integer_length, "integer-length", 1, 0, 0,
             (SCM n),
-           "Returns the number of bits neccessary to represent @var{n}.\n\n"
-           "Example:\n"
+           "Return the number of bits neccessary to represent @var{n}.\n"
+           "\n"
            "@lisp\n"
            "(integer-length #b10101010)\n"
            "   @result{} 8\n"
@@ -1313,7 +1380,7 @@ SCM_DEFINE (scm_integer_length, "integer-length", 1, 0, 0,
 static const char s_bignum[] = "bignum";
 
 SCM
-scm_mkbig (scm_sizet nlen, int sign)
+scm_i_mkbig (size_t nlen, int sign)
 {
   SCM v;
   /* Cast to long int to avoid signed/unsigned comparison warnings.  */
@@ -1323,16 +1390,14 @@ scm_mkbig (scm_sizet nlen, int sign)
   
   SCM_NEWCELL (v);
   SCM_DEFER_INTS;
-  SCM_SETCHARS (v, scm_must_malloc ((long) (nlen * sizeof (SCM_BIGDIG)),
-                                   s_bignum));
+  SCM_SET_BIGNUM_BASE (v, scm_must_malloc (nlen * sizeof (SCM_BIGDIG), s_bignum));
   SCM_SETNUMDIGS (v, nlen, sign);
   SCM_ALLOW_INTS;
   return v;
 }
 
-
 SCM
-scm_big2inum (SCM b, scm_sizet l)
+scm_i_big2inum (SCM b, size_t l)
 {
   unsigned long num = 0;
   SCM_BIGDIG *tmp = SCM_BDIGITS (b);
@@ -1348,13 +1413,12 @@ scm_big2inum (SCM b, scm_sizet l)
   return b;
 }
 
-
-static const char s_adjbig[] = "scm_adjbig";
+static const char s_adjbig[] = "scm_i_adjbig";
 
 SCM
-scm_adjbig (SCM b, scm_sizet nlen)
+scm_i_adjbig (SCM b, size_t nlen)
 {
-  scm_sizet nsiz = nlen;
+  size_t nsiz = nlen;
   if (((nsiz << SCM_BIGSIZEFIELD) >> SCM_BIGSIZEFIELD) != nlen)
     scm_memory_error (s_adjbig);
 
@@ -1366,20 +1430,18 @@ scm_adjbig (SCM b, scm_sizet nlen)
                           (long) (SCM_NUMDIGS (b) * sizeof (SCM_BIGDIG)),
                           (long) (nsiz * sizeof (SCM_BIGDIG)), s_bignum));
 
-    SCM_SETCHARS (b, digits);
+    SCM_SET_BIGNUM_BASE (b, digits);
     SCM_SETNUMDIGS (b, nsiz, SCM_BIGSIGN (b));
   }
   SCM_ALLOW_INTS;
   return b;
 }
 
-
-
 SCM
-scm_normbig (SCM b)
+scm_i_normbig (SCM b)
 {
 #ifndef _UNICOS
-  scm_sizet nlen = SCM_NUMDIGS (b);
+  size_t nlen = SCM_NUMDIGS (b);
 #else
   int nlen = SCM_NUMDIGS (b); /* unsigned nlen breaks on Cray when nlen => 0 */
 #endif
@@ -1387,137 +1449,30 @@ scm_normbig (SCM b)
   while (nlen-- && !zds[nlen]);
   nlen++;
   if (nlen * SCM_BITSPERDIG / SCM_CHAR_BIT <= sizeof (SCM))
-    if (SCM_INUMP (b = scm_big2inum (b, (scm_sizet) nlen)))
+    if (SCM_INUMP (b = scm_i_big2inum (b, (size_t) nlen)))
       return b;
   if (SCM_NUMDIGS (b) == nlen)
     return b;
-  return scm_adjbig (b, (scm_sizet) nlen);
+  return scm_i_adjbig (b, (size_t) nlen);
 }
 
-
-
 SCM
-scm_copybig (SCM b, int sign)
+scm_i_copybig (SCM b, int sign)
 {
-  scm_sizet i = SCM_NUMDIGS (b);
-  SCM ans = scm_mkbig (i, sign);
+  size_t i = SCM_NUMDIGS (b);
+  SCM ans = scm_i_mkbig (i, sign);
   SCM_BIGDIG *src = SCM_BDIGITS (b), *dst = SCM_BDIGITS (ans);
   while (i--)
     dst[i] = src[i];
   return ans;
 }
 
-
-
-SCM
-scm_long2big (long n)
-{
-  scm_sizet i = 0;
-  SCM_BIGDIG *digits;
-  SCM ans = scm_mkbig (SCM_DIGSPERLONG, n < 0);
-  digits = SCM_BDIGITS (ans);
-  if (n < 0)
-    n = -n;
-  while (i < SCM_DIGSPERLONG)
-    {
-      digits[i++] = SCM_BIGLO (n);
-      n = SCM_BIGDN ((unsigned long) n);
-    }
-  return ans;
-}
-
-#ifdef HAVE_LONG_LONGS
-
-SCM
-scm_long_long2big (long_long n)
-{
-  scm_sizet i;
-  SCM_BIGDIG *digits;
-  SCM ans;
-  int n_digits;
-
-  {
-    long tn;
-    tn = (long) n;
-    if ((long long) tn == n)
-      return scm_long2big (tn);
-  }
-
-  {
-    long_long tn;
-
-    for (tn = n, n_digits = 0;
-        tn;
-        ++n_digits, tn = SCM_BIGDN ((ulong_long) tn))
-      ;
-  }
-
-  i = 0;
-  ans = scm_mkbig (n_digits, n < 0);
-  digits = SCM_BDIGITS (ans);
-  if (n < 0)
-    n = -n;
-  while (i < n_digits)
-    {
-      digits[i++] = SCM_BIGLO (n);
-      n = SCM_BIGDN ((ulong_long) n);
-    }
-  return ans;
-}
-#endif /* HAVE_LONG_LONGS */
-
-
-SCM
-scm_2ulong2big (unsigned long *np)
-{
-  unsigned long n;
-  scm_sizet i;
-  SCM_BIGDIG *digits;
-  SCM ans;
-
-  ans = scm_mkbig (2 * SCM_DIGSPERLONG, 0);
-  digits = SCM_BDIGITS (ans);
-
-  n = np[0];
-  for (i = 0; i < SCM_DIGSPERLONG; ++i)
-    {
-      digits[i] = SCM_BIGLO (n);
-      n = SCM_BIGDN ((unsigned long) n);
-    }
-  n = np[1];
-  for (i = 0; i < SCM_DIGSPERLONG; ++i)
-    {
-      digits[i + SCM_DIGSPERLONG] = SCM_BIGLO (n);
-      n = SCM_BIGDN ((unsigned long) n);
-    }
-  return ans;
-}
-
-
-
-SCM
-scm_ulong2big (unsigned long n)
-{
-  scm_sizet i = 0;
-  SCM_BIGDIG *digits;
-  SCM ans = scm_mkbig (SCM_DIGSPERLONG, 0);
-  digits = SCM_BDIGITS (ans);
-  while (i < SCM_DIGSPERLONG)
-    {
-      digits[i++] = SCM_BIGLO (n);
-      n = SCM_BIGDN (n);
-    }
-  return ans;
-}
-
-
-
 int
 scm_bigcomp (SCM x, SCM y)
 {
   int xsign = SCM_BIGSIGN (x);
   int ysign = SCM_BIGSIGN (y);
-  scm_sizet xlen, ylen;
+  size_t xlen, ylen;
 
   /* Look at the signs, first.  */
   if (ysign < xsign)
@@ -1562,7 +1517,7 @@ scm_pseudolong (long x)
     SCM_BIGDIG bd[SCM_DIGSPERLONG];
   }
   p;
-  scm_sizet i = 0;
+  size_t i = 0;
   if (x < 0)
     x = -x;
   while (i < SCM_DIGSPERLONG)
@@ -1580,7 +1535,7 @@ scm_pseudolong (long x)
 void
 scm_longdigs (long x, SCM_BIGDIG digs[])
 {
-  scm_sizet i = 0;
+  size_t i = 0;
   if (x < 0)
     x = -x;
   while (i < SCM_DIGSPERLONG)
@@ -1594,13 +1549,13 @@ scm_longdigs (long x, SCM_BIGDIG digs[])
 
 
 SCM
-scm_addbig (SCM_BIGDIG *x, scm_sizet nx, int xsgn, SCM bigy, int sgny)
+scm_addbig (SCM_BIGDIG *x, size_t nx, int xsgn, SCM bigy, int sgny)
 {
   /* Assumes nx <= SCM_NUMDIGS(bigy) */
   /* Assumes xsgn and sgny scm_equal either 0 or SCM_BIGSIGNFLAG */
   long num = 0;
-  scm_sizet i = 0, ny = SCM_NUMDIGS (bigy);
-  SCM z = scm_copybig (bigy, SCM_BIGSIGN (bigy) ^ sgny);
+  size_t i = 0, ny = SCM_NUMDIGS (bigy);
+  SCM z = scm_i_copybig (bigy, SCM_BIGSIGN (bigy) ^ sgny);
   SCM_BIGDIG *zds = SCM_BDIGITS (z);
   if (xsgn ^ SCM_BIGSIGN (z))
     {
@@ -1669,21 +1624,21 @@ scm_addbig (SCM_BIGDIG *x, scm_sizet nx, int xsgn, SCM bigy, int sgny)
        }
       if (num)
        {
-         z = scm_adjbig (z, ny + 1);
+         z = scm_i_adjbig (z, ny + 1);
          SCM_BDIGITS (z)[ny] = num;
          return z;
        }
     }
-  return scm_normbig (z);
+  return scm_i_normbig (z);
 }
 
 
 SCM
-scm_mulbig (SCM_BIGDIG *x, scm_sizet nx, SCM_BIGDIG *y, scm_sizet ny, int sgn)
+scm_mulbig (SCM_BIGDIG *x, size_t nx, SCM_BIGDIG *y, size_t ny, int sgn)
 {
-  scm_sizet i = 0, j = nx + ny;
+  size_t i = 0, j = nx + ny;
   unsigned long n = 0;
-  SCM z = scm_mkbig (j, sgn);
+  SCM z = scm_i_mkbig (j, sgn);
   SCM_BIGDIG *zds = SCM_BDIGITS (z);
   while (j--)
     zds[j] = 0;
@@ -1707,12 +1662,12 @@ scm_mulbig (SCM_BIGDIG *x, scm_sizet nx, SCM_BIGDIG *y, scm_sizet ny, int sgn)
        }
     }
   while (++i < nx);
-  return scm_normbig (z);
+  return scm_i_normbig (z);
 }
 
 
 unsigned int
-scm_divbigdig (SCM_BIGDIG * ds, scm_sizet h, SCM_BIGDIG div)
+scm_divbigdig (SCM_BIGDIG * ds, size_t h, SCM_BIGDIG div)
 {
   register unsigned long t2 = 0;
   while (h--)
@@ -1735,7 +1690,7 @@ scm_divbigint (SCM x, long z, int sgn, int mode)
     {
       register unsigned long t2 = 0;
       register SCM_BIGDIG *ds = SCM_BDIGITS (x);
-      scm_sizet nd = SCM_NUMDIGS (x);
+      size_t nd = SCM_NUMDIGS (x);
       while (nd--)
        t2 = (SCM_BIGUP (t2) + ds[nd]) % z;
       if (mode && t2)
@@ -1760,14 +1715,14 @@ scm_divbigint (SCM x, long z, int sgn, int mode)
 
 
 static SCM
-scm_divbigbig (SCM_BIGDIG *x, scm_sizet nx, SCM_BIGDIG *y, scm_sizet ny, int sgn, int modes)
+scm_divbigbig (SCM_BIGDIG *x, size_t nx, SCM_BIGDIG *y, size_t ny, int sgn, int modes)
 {
   /* modes description
      0  remainder
      1  scm_modulo
      2  quotient
      3  quotient but returns SCM_UNDEFINED if division is not exact. */
-  scm_sizet i = 0, j = 0;
+  size_t i = 0, j = 0;
   long num = 0;
   unsigned long t2 = 0;
   SCM z, newy;
@@ -1777,7 +1732,7 @@ scm_divbigbig (SCM_BIGDIG *x, scm_sizet nx, SCM_BIGDIG *y, scm_sizet ny, int sgn
     switch (modes)
       {
       case 0:                  /* remainder -- just return x */
-       z = scm_mkbig (nx, sgn);
+       z = scm_i_mkbig (nx, sgn);
        zds = SCM_BDIGITS (z);
        do
          {
@@ -1786,7 +1741,7 @@ scm_divbigbig (SCM_BIGDIG *x, scm_sizet nx, SCM_BIGDIG *y, scm_sizet ny, int sgn
        while (++i < nx);
        return z;
       case 1:                  /* scm_modulo -- return y-x */
-       z = scm_mkbig (ny, sgn);
+       z = scm_i_mkbig (ny, sgn);
        zds = SCM_BDIGITS (z);
        do
          {
@@ -1824,7 +1779,7 @@ scm_divbigbig (SCM_BIGDIG *x, scm_sizet nx, SCM_BIGDIG *y, scm_sizet ny, int sgn
        return SCM_UNDEFINED;   /* the division is not exact */
       }
 
-  z = scm_mkbig (nx == ny ? nx + 2 : nx + 1, sgn);
+  z = scm_i_mkbig (nx == ny ? nx + 2 : nx + 1, sgn);
   zds = SCM_BDIGITS (z);
   if (nx == ny)
     zds[nx + 1] = 0;
@@ -1833,7 +1788,7 @@ scm_divbigbig (SCM_BIGDIG *x, scm_sizet nx, SCM_BIGDIG *y, scm_sizet ny, int sgn
   if (y[ny - 1] < (SCM_BIGRAD >> 1))
     {                          /* normalize operands */
       d = SCM_BIGRAD / (y[ny - 1] + 1);
-      newy = scm_mkbig (ny, 0);
+      newy = scm_i_mkbig (ny, 0);
       yds = SCM_BDIGITS (newy);
       while (j < ny)
        {
@@ -1947,9 +1902,9 @@ scm_divbigbig (SCM_BIGDIG *x, scm_sizet nx, SCM_BIGDIG *y, scm_sizet ny, int sgn
  doadj:
   for (j = ny; j && !zds[j - 1]; --j);
   if (j * SCM_BITSPERDIG <= sizeof (SCM) * SCM_CHAR_BIT)
-    if (SCM_INUMP (z = scm_big2inum (z, j)))
+    if (SCM_INUMP (z = scm_i_big2inum (z, j)))
       return z;
-  return scm_adjbig (z, j);
+  return scm_i_adjbig (z, j);
 }
 #endif
 \f
@@ -1968,11 +1923,11 @@ static const double fx[] =
 
 
 
-static scm_sizet
+static size_t
 idbl2str (double f, char *a)
 {
   int efmt, dpt, d, i, wp = scm_dblprec;
-  scm_sizet ch = 0;
+  size_t ch = 0;
   int exp = 0;
 
   if (f == 0.0)
@@ -2108,10 +2063,10 @@ idbl2str (double f, char *a)
 }
 
 
-static scm_sizet
+static size_t
 iflo2str (SCM flt, char *str)
 {
-  scm_sizet i;
+  size_t i;
   if (SCM_SLOPPY_REALP (flt))
     i = idbl2str (SCM_REAL_VALUE (flt), str);
   else
@@ -2132,11 +2087,11 @@ iflo2str (SCM flt, char *str)
    characters in the result. 
    rad is output base
    p is destination: worst case (base 2) is SCM_INTBUFLEN  */
-scm_sizet
+size_t
 scm_iint2str (long num, int rad, char *p)
 {
-  scm_sizet j = 1;
-  scm_sizet i;
+  size_t j = 1;
+  size_t i;
   unsigned long n = (num < 0) ? -num : num;
 
   for (n /= rad; n > 0; n /= rad)
@@ -2167,16 +2122,16 @@ scm_iint2str (long num, int rad, char *p)
 static SCM
 big2str (SCM b, unsigned int radix)
 {
-  SCM t = scm_copybig (b, 0);  /* sign of temp doesn't matter */
+  SCM t = scm_i_copybig (b, 0);        /* sign of temp doesn't matter */
   register SCM_BIGDIG *ds = SCM_BDIGITS (t);
-  scm_sizet i = SCM_NUMDIGS (t);
-  scm_sizet j = radix == 16 ? (SCM_BITSPERDIG * i) / 4 + 2
+  size_t i = SCM_NUMDIGS (t);
+  size_t j = radix == 16 ? (SCM_BITSPERDIG * i) / 4 + 2
     : radix >= 10 ? (SCM_BITSPERDIG * i * 241L) / 800 + 2
     : (SCM_BITSPERDIG * i) + 2;
-  scm_sizet k = 0;
-  scm_sizet radct = 0;
+  size_t k = 0;
+  size_t radct = 0;
   SCM_BIGDIG radpow = 1, radmod = 0;
-  SCM ss = scm_makstr ((long) j, 0);
+  SCM ss = scm_allocate_string (j);
   char *s = SCM_STRING_CHARS (ss), c;
   while ((long) radpow * radix < SCM_BIGRAD)
     {
@@ -2216,8 +2171,8 @@ big2str (SCM b, unsigned int radix)
 SCM_DEFINE (scm_number_to_string, "number->string", 1, 1, 0,
             (SCM n, SCM radix),
            "Return a string holding the external representation of the\n"
-           "number N in the given RADIX.  If N is inexact, a radix of 10\n"
-           "will be used.")
+           "number @var{n} in the given @var{radix}.  If @var{n} is\n"
+           "inexact, a radix of 10 will be used.")
 #define FUNC_NAME s_scm_number_to_string
 {
   int base;
@@ -2232,12 +2187,12 @@ SCM_DEFINE (scm_number_to_string, "number->string", 1, 1, 0,
 
   if (SCM_INUMP (n)) {
     char num_buf [SCM_INTBUFLEN];
-    scm_sizet length = scm_iint2str (SCM_INUM (n), base, num_buf);
+    size_t length = scm_iint2str (SCM_INUM (n), base, num_buf);
     return scm_makfromstr (num_buf, length, 0);
   } else if (SCM_BIGP (n)) {
     return big2str (n, (unsigned int) base);
   } else if (SCM_INEXACTP (n)) {
-    char num_buf [SCM_FLOBUFLEN];
+    char num_buf [FLOBUFLEN];
     return scm_makfromstr (num_buf, iflo2str (n, num_buf), 0);
   } else {
     SCM_WRONG_TYPE_ARG (1, n);
@@ -2252,7 +2207,7 @@ SCM_DEFINE (scm_number_to_string, "number->string", 1, 1, 0,
 int
 scm_print_real (SCM sexp, SCM port, scm_print_state *pstate)
 {
-  char num_buf[SCM_FLOBUFLEN];
+  char num_buf[FLOBUFLEN];
   scm_lfwrite (num_buf, iflo2str (sexp, num_buf), port);
   return !0;
 }
@@ -2260,7 +2215,7 @@ scm_print_real (SCM sexp, SCM port, scm_print_state *pstate)
 int
 scm_print_complex (SCM sexp, SCM port, scm_print_state *pstate)
 {
-  char num_buf[SCM_FLOBUFLEN];
+  char num_buf[FLOBUFLEN];
   scm_lfwrite (num_buf, iflo2str (sexp, num_buf), port);
   return !0;
 }
@@ -2270,7 +2225,7 @@ scm_bigprint (SCM exp, SCM port, scm_print_state *pstate)
 {
 #ifdef SCM_BIGDIG
   exp = big2str (exp, (unsigned int) 10);
-  scm_lfwrite (SCM_STRING_CHARS (exp), (scm_sizet) SCM_STRING_LENGTH (exp), port);
+  scm_lfwrite (SCM_STRING_CHARS (exp), (size_t) SCM_STRING_LENGTH (exp), port);
 #else
   scm_ipruk ("bignum", exp, port);
 #endif
@@ -2347,9 +2302,9 @@ scm_small_istr2int (char *str, long len, long radix)
 SCM
 scm_istr2int (char *str, long len, long radix)
 {
-  scm_sizet j;
-  register scm_sizet k, blen = 1;
-  scm_sizet i = 0;
+  size_t j;
+  register size_t k, blen = 1;
+  size_t i = 0;
   int c;
   SCM res;
   register SCM_BIGDIG *ds;
@@ -2376,7 +2331,7 @@ scm_istr2int (char *str, long len, long radix)
       if (++i == (unsigned) len)
        return SCM_BOOL_F;      /* bad if lone `+' or `-' */
     }
-  res = scm_mkbig (j, '-' == str[0]);
+  res = scm_i_mkbig (j, '-' == str[0]);
   ds = SCM_BDIGITS (res);
   for (k = j; k--;)
     ds[k] = 0;
@@ -2429,11 +2384,11 @@ scm_istr2int (char *str, long len, long radix)
     }
   while (i < (unsigned) len);
   if (blen * SCM_BITSPERDIG / SCM_CHAR_BIT <= sizeof (SCM))
-    if (SCM_INUMP (res = scm_big2inum (res, blen)))
+    if (SCM_INUMP (res = scm_i_big2inum (res, blen)))
       return res;
   if (j == blen)
     return res;
-  return scm_adjbig (res, blen);
+  return scm_i_adjbig (res, blen);
 }
 
 SCM
@@ -2795,20 +2750,21 @@ scm_istring2number (char *str, long len, long radix)
 
 SCM_DEFINE (scm_string_to_number, "string->number", 1, 1, 0,
             (SCM string, SCM radix),
-           "Returns a number of the maximally precise representation\n"
-           "expressed by the given STRING. RADIX must be an exact integer,\n"
-           "either 2, 8, 10, or 16. If supplied, RADIX is a default radix\n"
-           "that may be overridden by an explicit radix prefix in STRING\n"
-           "(e.g. \"#o177\"). If RADIX is not supplied, then the default\n"
-           "radix is 10. If string is not a syntactically valid notation\n"
-           "for a number, then `string->number' returns #f.  (r5rs)") 
+           "Return a number of the maximally precise representation\n"
+           "expressed by the given @var{string}. @var{radix} must be an\n"
+           "exact integer, either 2, 8, 10, or 16. If supplied, @var{radix}\n"
+           "is a default radix that may be overridden by an explicit radix\n"
+           "prefix in @var{string} (e.g. \"#o177\"). If @var{radix} is not\n"
+           "supplied, then the default radix is 10. If string is not a\n"
+           "syntactically valid notation for a number, then\n"
+           "@code{string->number} returns @code{#f}.") 
 #define FUNC_NAME s_scm_string_to_number
 {
   SCM answer;
   int base;
   SCM_VALIDATE_STRING (1, string);
   SCM_VALIDATE_INUM_MIN_DEF_COPY (2,radix,2,10,base);
-  answer = scm_istring2number (SCM_ROCHARS (string),
+  answer = scm_istring2number (SCM_STRING_CHARS (string),
                               SCM_STRING_LENGTH (string),
                                base);
   return scm_return_first (answer, string);
@@ -2869,13 +2825,18 @@ scm_complex_equalp (SCM x, SCM y)
 
 
 SCM_REGISTER_PROC (s_number_p, "number?", 1, 0, 0, scm_number_p);
-
+/* "Return @code{#t} if @var{x} is a number, @code{#f}\n"
+ * "else.  Note that the sets of complex, real, rational and\n"
+ * "integer values form subsets of the set of numbers, i. e. the\n"
+ * "predicate will be fulfilled for any number."
+ */
 SCM_DEFINE (scm_number_p, "complex?", 1, 0, 0, 
             (SCM x),
-           "Return #t if X is a complex number, #f else.  Note that the\n"
-           "sets of real, rational and integer values form subsets of the\n"
-           "set of complex numbers, i. e. the predicate will also be\n"
-           "fulfilled if X is a real, rational or integer number.")
+           "Return @code{#t} if @var{x} is a complex number, @code{#f}\n"
+           "else.  Note that the sets of real, rational and integer\n"
+           "values form subsets of the set of complex numbers, i. e. the\n"
+           "predicate will also be fulfilled if @var{x} is a real,\n"
+           "rational or integer number.")
 #define FUNC_NAME s_scm_number_p
 {
   return SCM_BOOL (SCM_NUMBERP (x));
@@ -2884,13 +2845,19 @@ SCM_DEFINE (scm_number_p, "complex?", 1, 0, 0,
 
 
 SCM_REGISTER_PROC (s_real_p, "real?", 1, 0, 0, scm_real_p);
-
+/* "Return @code{#t} if @var{x} is a real number, @code{#f} else.\n"
+ * "Note that the sets of integer and rational values form a subset\n"
+ * "of the set of real numbers, i. e. the predicate will also\n"
+ * "be fulfilled if @var{x} is an integer or a rational number."
+ */
 SCM_DEFINE (scm_real_p, "rational?", 1, 0, 0, 
             (SCM x),
-           "Return #t if X is a rational number, #f else.  Note that the\n"
-           "set of integer values forms a subset of the set of rational\n"
-           "numbers, i. e. the predicate will also be fulfilled if X is an\n"
-           "integer number.")
+           "Return @code{#t} if @var{x} is a rational number, @code{#f}\n"
+           "else.  Note that the set of integer values forms a subset of\n"
+           "the set of rational numbers, i. e. the predicate will also be\n"
+           "fulfilled if @var{x} is an integer number.  Real numbers\n"
+           "will also satisfy this predicate, because of their limited\n"
+           "precision.")
 #define FUNC_NAME s_scm_real_p
 {
   if (SCM_INUMP (x)) {
@@ -2910,7 +2877,8 @@ SCM_DEFINE (scm_real_p, "rational?", 1, 0, 0,
 
 SCM_DEFINE (scm_integer_p, "integer?", 1, 0, 0, 
             (SCM x),
-           "Return #t if X is an integer number, #f else.")
+           "Return @code{#t} if @var{x} is an integer number, @code{#f}\n"
+           "else.")
 #define FUNC_NAME s_scm_integer_p
 {
   double r;
@@ -2934,7 +2902,8 @@ SCM_DEFINE (scm_integer_p, "integer?", 1, 0, 0,
 
 SCM_DEFINE (scm_inexact_p, "inexact?", 1, 0, 0, 
             (SCM x),
-           "Return #t if X is an inexact number, #f else.")
+           "Return @code{#t} if @var{x} is an inexact number, @code{#f}\n"
+           "else.")
 #define FUNC_NAME s_scm_inexact_p
 {
   return SCM_BOOL (SCM_INEXACTP (x));
@@ -2943,7 +2912,7 @@ SCM_DEFINE (scm_inexact_p, "inexact?", 1, 0, 0,
 
 
 SCM_GPROC1 (s_eq_p, "=", scm_tc7_rpsubr, scm_num_eq_p, g_eq_p);
-
+/* "Return @code{#t} if all parameters are numerically equal."  */
 SCM
 scm_num_eq_p (SCM x, SCM y)
 {
@@ -2968,9 +2937,9 @@ scm_num_eq_p (SCM x, SCM y)
     } else if (SCM_BIGP (y)) {
       return SCM_BOOL (0 == scm_bigcomp (x, y));
     } else if (SCM_REALP (y)) {
-      return SCM_BOOL (scm_big2dbl (x) == SCM_REAL_VALUE (y));
+      return SCM_BOOL (scm_i_big2dbl (x) == SCM_REAL_VALUE (y));
     } else if (SCM_COMPLEXP (y)) {
-      return SCM_BOOL ((scm_big2dbl (x) == SCM_COMPLEX_REAL (y))
+      return SCM_BOOL ((scm_i_big2dbl (x) == SCM_COMPLEX_REAL (y))
                       && (0.0 == SCM_COMPLEX_IMAG (y)));
     } else {
       SCM_WTA_DISPATCH_2 (g_eq_p, x, y, SCM_ARGn, s_eq_p);
@@ -2979,7 +2948,7 @@ scm_num_eq_p (SCM x, SCM y)
     if (SCM_INUMP (y)) {
       return SCM_BOOL (SCM_REAL_VALUE (x) == (double) SCM_INUM (y));
     } else if (SCM_BIGP (y)) {
-      return SCM_BOOL (SCM_REAL_VALUE (x) == scm_big2dbl (y));
+      return SCM_BOOL (SCM_REAL_VALUE (x) == scm_i_big2dbl (y));
     } else if (SCM_REALP (y)) {
       return SCM_BOOL (SCM_REAL_VALUE (x) == SCM_REAL_VALUE (y));
     } else if (SCM_COMPLEXP (y)) {
@@ -2993,7 +2962,7 @@ scm_num_eq_p (SCM x, SCM y)
       return SCM_BOOL ((SCM_COMPLEX_REAL (x) == (double) SCM_INUM (y))
                       && (SCM_COMPLEX_IMAG (x) == 0.0));
     } else if (SCM_BIGP (y)) {
-      return SCM_BOOL ((SCM_COMPLEX_REAL (x) == scm_big2dbl (y))
+      return SCM_BOOL ((SCM_COMPLEX_REAL (x) == scm_i_big2dbl (y))
                       && (SCM_COMPLEX_IMAG (x) == 0.0));
     } else if (SCM_REALP (y)) {
       return SCM_BOOL ((SCM_COMPLEX_REAL (x) == SCM_REAL_VALUE (y))
@@ -3011,7 +2980,9 @@ scm_num_eq_p (SCM x, SCM y)
 
 
 SCM_GPROC1 (s_less_p, "<", scm_tc7_rpsubr, scm_less_p, g_less_p);
-
+/* "Return @code{#t} if the list of parameters is monotonically\n"
+ * "increasing."
+ */
 SCM
 scm_less_p (SCM x, SCM y)
 {
@@ -3033,7 +3004,7 @@ scm_less_p (SCM x, SCM y)
     } else if (SCM_BIGP (y)) {
       return SCM_BOOL (1 == scm_bigcomp (x, y));
     } else if (SCM_REALP (y)) {
-      return SCM_BOOL (scm_big2dbl (x) < SCM_REAL_VALUE (y));
+      return SCM_BOOL (scm_i_big2dbl (x) < SCM_REAL_VALUE (y));
     } else {
       SCM_WTA_DISPATCH_2 (g_less_p, x, y, SCM_ARGn, s_less_p);
     }
@@ -3041,7 +3012,7 @@ scm_less_p (SCM x, SCM y)
     if (SCM_INUMP (y)) {
       return SCM_BOOL (SCM_REAL_VALUE (x) < (double) SCM_INUM (y));
     } else if (SCM_BIGP (y)) {
-      return SCM_BOOL (SCM_REAL_VALUE (x) < scm_big2dbl (y));
+      return SCM_BOOL (SCM_REAL_VALUE (x) < scm_i_big2dbl (y));
     } else if (SCM_REALP (y)) {
       return SCM_BOOL (SCM_REAL_VALUE (x) < SCM_REAL_VALUE (y));
     } else {
@@ -3054,8 +3025,8 @@ scm_less_p (SCM x, SCM y)
 
 
 SCM_GPROC1 (s_scm_gr_p, ">", scm_tc7_rpsubr, scm_gr_p, g_gr_p);
-/* "Return #t if the list of parameters is monotonically\n"
- *  "increasing."
+/* "Return @code{#t} if the list of parameters is monotonically\n"
+ * "decreasing."
  */
 #define FUNC_NAME s_scm_gr_p
 SCM
@@ -3072,7 +3043,7 @@ scm_gr_p (SCM x, SCM y)
 
 
 SCM_GPROC1 (s_scm_leq_p, "<=", scm_tc7_rpsubr, scm_leq_p, g_leq_p);
-/* "Return #t if the list of parameters is monotonically\n"
+/* "Return @code{#t} if the list of parameters is monotonically\n"
  * "non-decreasing."
  */
 #define FUNC_NAME s_scm_leq_p
@@ -3090,7 +3061,7 @@ scm_leq_p (SCM x, SCM y)
 
 
 SCM_GPROC1 (s_scm_geq_p, ">=", scm_tc7_rpsubr, scm_geq_p, g_geq_p);
-/* "Return #t if the list of parameters is monotonically\n"
+/* "Return @code{#t} if the list of parameters is monotonically\n"
  * "non-increasing."
  */
 #define FUNC_NAME s_scm_geq_p
@@ -3108,7 +3079,9 @@ scm_geq_p (SCM x, SCM y)
 
 
 SCM_GPROC (s_zero_p, "zero?", 1, 0, 0, scm_zero_p, g_zero_p);
-
+/* "Return @code{#t} if @var{z} is an exact or inexact number equal to\n"
+ * "zero."
+ */
 SCM
 scm_zero_p (SCM z)
 {
@@ -3128,7 +3101,9 @@ scm_zero_p (SCM z)
 
 
 SCM_GPROC (s_positive_p, "positive?", 1, 0, 0, scm_positive_p, g_positive_p);
-
+/* "Return @code{#t} if @var{x} is an exact or inexact number greater than\n"
+ * "zero."
+ */
 SCM
 scm_positive_p (SCM x)
 {
@@ -3145,7 +3120,9 @@ scm_positive_p (SCM x)
 
 
 SCM_GPROC (s_negative_p, "negative?", 1, 0, 0, scm_negative_p, g_negative_p);
-
+/* "Return @code{#t} if @var{x} is an exact or inexact number less than\n"
+ * "zero."
+ */
 SCM
 scm_negative_p (SCM x)
 {
@@ -3162,13 +3139,14 @@ scm_negative_p (SCM x)
 
 
 SCM_GPROC1 (s_max, "max", scm_tc7_asubr, scm_max, g_max);
-
+/* "Return the maximum of all parameter values."
+ */
 SCM
 scm_max (SCM x, SCM y)
 {
   if (SCM_UNBNDP (y)) {
     if (SCM_UNBNDP (x)) {
-      SCM_WTA_DISPATCH_0 (g_max, x, SCM_ARG1, s_max);
+      SCM_WTA_DISPATCH_0 (g_max, s_max);
     } else if (SCM_NUMBERP (x)) {
       return x;
     } else {
@@ -3195,7 +3173,7 @@ scm_max (SCM x, SCM y)
     } else if (SCM_BIGP (y)) {
       return (1 == scm_bigcomp (x, y)) ? y : x;
     } else if (SCM_REALP (y)) {
-      double z = scm_big2dbl (x);
+      double z = scm_i_big2dbl (x);
       return (z <= SCM_REAL_VALUE (y)) ? y : scm_make_real (z);
     } else {
       SCM_WTA_DISPATCH_2 (g_max, x, y, SCM_ARGn, s_max);
@@ -3205,7 +3183,7 @@ scm_max (SCM x, SCM y)
       double z = SCM_INUM (y);
       return (SCM_REAL_VALUE (x) < z) ? scm_make_real (z) : x;
     } else if (SCM_BIGP (y)) {
-      double z = scm_big2dbl (y);
+      double z = scm_i_big2dbl (y);
       return (SCM_REAL_VALUE (x) < z) ? scm_make_real (z) : x;
     } else if (SCM_REALP (y)) {
       return (SCM_REAL_VALUE (x) < SCM_REAL_VALUE (y)) ? y : x;
@@ -3219,13 +3197,14 @@ scm_max (SCM x, SCM y)
 
 
 SCM_GPROC1 (s_min, "min", scm_tc7_asubr, scm_min, g_min);
-
+/* "Return the minium of all parameter values."
+ */
 SCM
 scm_min (SCM x, SCM y)
 {
   if (SCM_UNBNDP (y)) {
     if (SCM_UNBNDP (x)) {
-      SCM_WTA_DISPATCH_0 (g_min, x, SCM_ARG1, s_min);
+      SCM_WTA_DISPATCH_0 (g_min, s_min);
     } else if (SCM_NUMBERP (x)) {
       return x;
     } else {
@@ -3252,7 +3231,7 @@ scm_min (SCM x, SCM y)
     } else if (SCM_BIGP (y)) {
       return (-1 == scm_bigcomp (x, y)) ? y : x;
     } else if (SCM_REALP (y)) {
-      double z = scm_big2dbl (x);
+      double z = scm_i_big2dbl (x);
       return (z < SCM_REAL_VALUE (y)) ? scm_make_real (z) : y;
     } else {
       SCM_WTA_DISPATCH_2 (g_min, x, y, SCM_ARGn, s_min);
@@ -3262,7 +3241,7 @@ scm_min (SCM x, SCM y)
       double z = SCM_INUM (y);
       return (SCM_REAL_VALUE (x) <= z) ? x : scm_make_real (z);
     } else if (SCM_BIGP (y)) {
-      double z = scm_big2dbl (y);
+      double z = scm_i_big2dbl (y);
       return (SCM_REAL_VALUE (x) <= z) ? x : scm_make_real (z);
     } else if (SCM_REALP (y)) {
       return (SCM_REAL_VALUE (x) < SCM_REAL_VALUE (y)) ? x : y;
@@ -3276,7 +3255,9 @@ scm_min (SCM x, SCM y)
 
 
 SCM_GPROC1 (s_sum, "+", scm_tc7_asubr, scm_sum, g_sum);
-
+/* "Return the sum of all parameter values.  Return 0 if called without\n"
+ * "any parameters." 
+ */
 SCM
 scm_sum (SCM x, SCM y)
 {
@@ -3299,7 +3280,7 @@ scm_sum (SCM x, SCM y)
        return SCM_MAKINUM (z);
       } else {
 #ifdef SCM_BIGDIG
-       return scm_long2big (z);
+       return scm_i_long2big (z);
 #else  /* SCM_BIGDIG */
        return scm_make_real ((double) z);
 #endif /* SCM_BIGDIG */ 
@@ -3338,9 +3319,9 @@ scm_sum (SCM x, SCM y)
       return scm_addbig (SCM_BDIGITS (x), SCM_NUMDIGS (x), 
                         SCM_BIGSIGN (x), y, 0);
     } else if (SCM_REALP (y)) {
-      return scm_make_real (scm_big2dbl (x) + SCM_REAL_VALUE (y));
+      return scm_make_real (scm_i_big2dbl (x) + SCM_REAL_VALUE (y));
     } else if (SCM_COMPLEXP (y)) {
-      return scm_make_complex (scm_big2dbl (x) + SCM_COMPLEX_REAL (y),
+      return scm_make_complex (scm_i_big2dbl (x) + SCM_COMPLEX_REAL (y),
                               SCM_COMPLEX_IMAG (y));
     } else {
       SCM_WTA_DISPATCH_2 (g_sum, x, y, SCM_ARGn, s_sum);
@@ -3349,7 +3330,7 @@ scm_sum (SCM x, SCM y)
     if (SCM_INUMP (y)) {
       return scm_make_real (SCM_REAL_VALUE (x) + SCM_INUM (y));
     } else if (SCM_BIGP (y)) {
-      return scm_make_real (SCM_REAL_VALUE (x) + scm_big2dbl (y));
+      return scm_make_real (SCM_REAL_VALUE (x) + scm_i_big2dbl (y));
     } else if (SCM_REALP (y)) {
       return scm_make_real (SCM_REAL_VALUE (x) + SCM_REAL_VALUE (y));
     } else if (SCM_COMPLEXP (y)) {
@@ -3363,7 +3344,7 @@ scm_sum (SCM x, SCM y)
       return scm_make_complex (SCM_COMPLEX_REAL (x) + SCM_INUM (y),
                               SCM_COMPLEX_IMAG (x));
     } else if (SCM_BIGP (y)) {
-      return scm_make_complex (SCM_COMPLEX_REAL (x) + scm_big2dbl (y),
+      return scm_make_complex (SCM_COMPLEX_REAL (x) + scm_i_big2dbl (y),
                               SCM_COMPLEX_IMAG (x));
     } else if (SCM_REALP (y)) {
       return scm_make_complex (SCM_COMPLEX_REAL (x) + SCM_REAL_VALUE (y),
@@ -3381,27 +3362,33 @@ scm_sum (SCM x, SCM y)
 
 
 SCM_GPROC1 (s_difference, "-", scm_tc7_asubr, scm_difference, g_difference);
-
+/* "If called without arguments, 0 is returned. Otherwise the sum of\n"
+ * "all but the first argument are subtracted from the first\n"
+ * "argument."
+ */
+#define FUNC_NAME s_difference
 SCM
 scm_difference (SCM x, SCM y)
 {
   if (SCM_UNBNDP (y)) {
-    if (SCM_INUMP (x)) {
+    if (SCM_UNBNDP (x)) {
+      SCM_WTA_DISPATCH_0 (g_difference, s_difference);
+    } else if (SCM_INUMP (x)) {
       long xx = -SCM_INUM (x);
       if (SCM_FIXABLE (xx)) {
        return SCM_MAKINUM (xx);
       } else {
 #ifdef SCM_BIGDIG
-       return scm_long2big (xx);
+       return scm_i_long2big (xx);
 #else
        return scm_make_real ((double) xx);
 #endif
       }
     } else if (SCM_BIGP (x)) {
-      SCM z = scm_copybig (x, !SCM_BIGSIGN (x));
+      SCM z = scm_i_copybig (x, !SCM_BIGSIGN (x));
       unsigned int digs = SCM_NUMDIGS (z);
       unsigned int size = digs * SCM_BITSPERDIG / SCM_CHAR_BIT;
-      return size <= sizeof (SCM) ? scm_big2inum (z, digs) : z;
+      return size <= sizeof (SCM) ? scm_i_big2inum (z, digs) : z;
     } else if (SCM_REALP (x)) {
       return scm_make_real (-SCM_REAL_VALUE (x));
     } else if (SCM_COMPLEXP (x)) {
@@ -3420,7 +3407,7 @@ scm_difference (SCM x, SCM y)
        return SCM_MAKINUM (z);
       } else {
 #ifdef SCM_BIGDIG
-       return scm_long2big (z);
+       return scm_i_long2big (z);
 #else
        return scm_make_real ((double) z);
 #endif
@@ -3464,9 +3451,9 @@ scm_difference (SCM x, SCM y)
        : scm_addbig (SCM_BDIGITS (y), SCM_NUMDIGS (y),
                      SCM_BIGSIGN (y) ^ SCM_BIGSIGNFLAG, x, 0);
     } else if (SCM_REALP (y)) {
-      return scm_make_real (scm_big2dbl (x) - SCM_REAL_VALUE (y));
+      return scm_make_real (scm_i_big2dbl (x) - SCM_REAL_VALUE (y));
     } else if (SCM_COMPLEXP (y)) {
-      return scm_make_complex (scm_big2dbl (x) - SCM_COMPLEX_REAL (y),
+      return scm_make_complex (scm_i_big2dbl (x) - SCM_COMPLEX_REAL (y),
                               - SCM_COMPLEX_IMAG (y));
     } else {
       SCM_WTA_DISPATCH_2 (g_difference, x, y, SCM_ARGn, s_difference);
@@ -3475,7 +3462,7 @@ scm_difference (SCM x, SCM y)
     if (SCM_INUMP (y)) {
       return scm_make_real (SCM_REAL_VALUE (x) - SCM_INUM (y));
     } else if (SCM_BIGP (y)) {
-      return scm_make_real (SCM_REAL_VALUE (x) - scm_big2dbl (y));
+      return scm_make_real (SCM_REAL_VALUE (x) - scm_i_big2dbl (y));
     } else if (SCM_REALP (y)) {
       return scm_make_real (SCM_REAL_VALUE (x) - SCM_REAL_VALUE (y));
     } else if (SCM_COMPLEXP (y)) {
@@ -3489,7 +3476,7 @@ scm_difference (SCM x, SCM y)
       return scm_make_complex (SCM_COMPLEX_REAL (x) - SCM_INUM (y),
                               SCM_COMPLEX_IMAG (x));
     } else if (SCM_BIGP (y)) {
-      return scm_make_complex (SCM_COMPLEX_REAL (x) - scm_big2dbl (y),
+      return scm_make_complex (SCM_COMPLEX_REAL (x) - scm_i_big2dbl (y),
                               SCM_COMPLEX_IMAG (x));
     } else if (SCM_REALP (y)) {
       return scm_make_complex (SCM_COMPLEX_REAL (x) - SCM_REAL_VALUE (y),
@@ -3504,10 +3491,12 @@ scm_difference (SCM x, SCM y)
     SCM_WTA_DISPATCH_2 (g_difference, x, y, SCM_ARG1, s_difference);
   }
 }
-
+#undef FUNC_NAME
 
 SCM_GPROC1 (s_product, "*", scm_tc7_asubr, scm_product, g_product);
-
+/* "Return the product of all arguments.  If called without arguments,\n"
+ * "1 is returned."
+ */
 SCM
 scm_product (SCM x, SCM y)
 {
@@ -3590,9 +3579,9 @@ scm_product (SCM x, SCM y)
                         SCM_BDIGITS (y), SCM_NUMDIGS (y),
                         SCM_BIGSIGN (x) ^ SCM_BIGSIGN (y));
     } else if (SCM_REALP (y)) {
-      return scm_make_real (scm_big2dbl (x) * SCM_REAL_VALUE (y));
+      return scm_make_real (scm_i_big2dbl (x) * SCM_REAL_VALUE (y));
     } else if (SCM_COMPLEXP (y)) {
-      double z = scm_big2dbl (x);
+      double z = scm_i_big2dbl (x);
       return scm_make_complex (z * SCM_COMPLEX_REAL (y),
                               z * SCM_COMPLEX_IMAG (y));
     } else {
@@ -3602,7 +3591,7 @@ scm_product (SCM x, SCM y)
     if (SCM_INUMP (y)) {
       return scm_make_real (SCM_INUM (y) * SCM_REAL_VALUE (x));
     } else if (SCM_BIGP (y)) {
-      return scm_make_real (scm_big2dbl (y) * SCM_REAL_VALUE (x));
+      return scm_make_real (scm_i_big2dbl (y) * SCM_REAL_VALUE (x));
     } else if (SCM_REALP (y)) {
       return scm_make_real (SCM_REAL_VALUE (x) * SCM_REAL_VALUE (y));
     } else if (SCM_COMPLEXP (y)) {
@@ -3616,7 +3605,7 @@ scm_product (SCM x, SCM y)
       return scm_make_complex (SCM_INUM (y) * SCM_COMPLEX_REAL (x),
                               SCM_INUM (y) * SCM_COMPLEX_IMAG (x));
     } else if (SCM_BIGP (y)) {
-      double z = scm_big2dbl (y);
+      double z = scm_i_big2dbl (y);
       return scm_make_complex (z * SCM_COMPLEX_REAL (x),
                               z * SCM_COMPLEX_IMAG (x));
     } else if (SCM_REALP (y)) {
@@ -3643,7 +3632,7 @@ scm_num2dbl (SCM a, const char *why)
   if (SCM_INUMP (a)) {
     return (double) SCM_INUM (a);
   } else if (SCM_BIGP (a)) {
-    return scm_big2dbl (a);
+    return scm_i_big2dbl (a);
   } else if (SCM_REALP (a)) {
     return (SCM_REAL_VALUE (a));
   } else {
@@ -3654,7 +3643,9 @@ scm_num2dbl (SCM a, const char *why)
 
 
 SCM_GPROC1 (s_divide, "/", scm_tc7_asubr, scm_divide, g_divide);
-
+/* "Divide the first argument by the product of the remaining arguments."
+ */
+#define FUNC_NAME s_divide
 SCM
 scm_divide (SCM x, SCM y)
 {
@@ -3662,7 +3653,7 @@ scm_divide (SCM x, SCM y)
 
   if (SCM_UNBNDP (y)) {
     if (SCM_UNBNDP (x)) {
-      SCM_WTA_DISPATCH_0 (g_divide, x, SCM_ARG1, s_divide);
+      SCM_WTA_DISPATCH_0 (g_divide, s_divide);
     } else if (SCM_INUMP (x)) {
       if (SCM_EQ_P (x, SCM_MAKINUM (1L)) || SCM_EQ_P (x, SCM_MAKINUM (-1L))) {
        return x;
@@ -3670,7 +3661,7 @@ scm_divide (SCM x, SCM y)
        return scm_make_real (1.0 / (double) SCM_INUM (x));
       }
     } else if (SCM_BIGP (x)) {
-      return scm_make_real (1.0 / scm_big2dbl (x));
+      return scm_make_real (1.0 / scm_i_big2dbl (x));
     } else if (SCM_REALP (x)) {
       return scm_make_real (1.0 / SCM_REAL_VALUE (x));
     } else if (SCM_COMPLEXP (x)) {
@@ -3697,14 +3688,14 @@ scm_divide (SCM x, SCM y)
          return SCM_MAKINUM (z);
        } else {
 #ifdef SCM_BIGDIG
-         return scm_long2big (z);
+         return scm_i_long2big (z);
 #else
          return scm_make_real ((double) xx / (double) yy);
 #endif
        }
       }
     } else if (SCM_BIGP (y)) {
-      return scm_make_real ((double) xx / scm_big2dbl (y));
+      return scm_make_real ((double) xx / scm_i_big2dbl (y));
     } else if (SCM_REALP (y)) {
       return scm_make_real ((double) xx / SCM_REAL_VALUE (y));
     } else if (SCM_COMPLEXP (y)) {
@@ -3729,11 +3720,11 @@ scm_divide (SCM x, SCM y)
       } else {
        long z = yy < 0 ? -yy : yy;
        if (z < SCM_BIGRAD) {
-         SCM w = scm_copybig (x, SCM_BIGSIGN (x) ? (yy > 0) : (yy < 0));
+         SCM w = scm_i_copybig (x, SCM_BIGSIGN (x) ? (yy > 0) : (yy < 0));
          return scm_divbigdig (SCM_BDIGITS (w), SCM_NUMDIGS (w),
                                (SCM_BIGDIG) z)
-           ? scm_make_real (scm_big2dbl (x) / (double) yy)
-           : scm_normbig (w);
+           ? scm_make_real (scm_i_big2dbl (x) / (double) yy)
+           : scm_i_normbig (w);
        } else {
          SCM w;
 #ifndef SCM_DIGSTOOBIG
@@ -3750,7 +3741,7 @@ scm_divide (SCM x, SCM y)
 #endif
          return (!SCM_UNBNDP (w)) 
            ? w 
-           : scm_make_real (scm_big2dbl (x) / (double) yy);
+           : scm_make_real (scm_i_big2dbl (x) / (double) yy);
        }
       }
     } else if (SCM_BIGP (y)) {
@@ -3759,11 +3750,11 @@ scm_divide (SCM x, SCM y)
                             SCM_BIGSIGN (x) ^ SCM_BIGSIGN (y), 3);
       return (!SCM_UNBNDP (w)) 
        ? w 
-       : scm_make_real (scm_big2dbl (x) / scm_big2dbl (y));
+       : scm_make_real (scm_i_big2dbl (x) / scm_i_big2dbl (y));
     } else if (SCM_REALP (y)) {
-      return scm_make_real (scm_big2dbl (x) / SCM_REAL_VALUE (y));
+      return scm_make_real (scm_i_big2dbl (x) / SCM_REAL_VALUE (y));
     } else if (SCM_COMPLEXP (y)) {
-      a = scm_big2dbl (x);
+      a = scm_i_big2dbl (x);
       goto complex_div;
     } else {
       SCM_WTA_DISPATCH_2 (g_divide, x, y, SCM_ARGn, s_divide);
@@ -3773,7 +3764,7 @@ scm_divide (SCM x, SCM y)
     if (SCM_INUMP (y)) {
       return scm_make_real (rx / (double) SCM_INUM (y));
     } else if (SCM_BIGP (y)) {
-      return scm_make_real (rx / scm_big2dbl (y));
+      return scm_make_real (rx / scm_i_big2dbl (y));
     } else if (SCM_REALP (y)) {
       return scm_make_real (rx / SCM_REAL_VALUE (y));
     } else if (SCM_COMPLEXP (y)) {
@@ -3789,7 +3780,7 @@ scm_divide (SCM x, SCM y)
       double d = SCM_INUM (y);
       return scm_make_complex (rx / d, ix / d);
     } else if (SCM_BIGP (y)) {
-      double d = scm_big2dbl (y);
+      double d = scm_i_big2dbl (y);
       return scm_make_complex (rx / d, ix / d);
     } else if (SCM_REALP (y)) {
       double d = SCM_REAL_VALUE (y);
@@ -3807,10 +3798,11 @@ scm_divide (SCM x, SCM y)
     SCM_WTA_DISPATCH_2 (g_divide, x, y, SCM_ARG1, s_divide);
   }
 }
-
+#undef FUNC_NAME
 
 SCM_GPROC1 (s_asinh, "$asinh", scm_tc7_cxr, (SCM (*)()) scm_asinh, g_asinh);
-
+/* "Return the inverse hyperbolic sine of @var{x}."
+ */
 double
 scm_asinh (double x)
 {
@@ -3821,7 +3813,8 @@ scm_asinh (double x)
 
 
 SCM_GPROC1 (s_acosh, "$acosh", scm_tc7_cxr, (SCM (*)()) scm_acosh, g_acosh);
-
+/* "Return the inverse hyperbolic cosine of @var{x}."
+ */
 double
 scm_acosh (double x)
 {
@@ -3832,7 +3825,8 @@ scm_acosh (double x)
 
 
 SCM_GPROC1 (s_atanh, "$atanh", scm_tc7_cxr, (SCM (*)()) scm_atanh, g_atanh);
-
+/* "Return the inverse hyperbolic tangent of @var{x}."
+ */
 double
 scm_atanh (double x)
 {
@@ -3843,7 +3837,8 @@ scm_atanh (double x)
 
 
 SCM_GPROC1 (s_truncate, "truncate", scm_tc7_cxr, (SCM (*)()) scm_truncate, g_truncate);
-
+/* "Round the inexact number @var{x} towards zero."
+ */
 double
 scm_truncate (double x)
 {
@@ -3855,7 +3850,9 @@ scm_truncate (double x)
 
 
 SCM_GPROC1 (s_round, "round", scm_tc7_cxr, (SCM (*)()) scm_round, g_round);
-
+/* "Round the inexact number @var{x}. If @var{x} is halfway between two\n"
+ * "numbers, round towards even."
+ */
 double
 scm_round (double x)
 {
@@ -3869,7 +3866,8 @@ scm_round (double x)
 
 
 SCM_GPROC1 (s_exact_to_inexact, "exact->inexact", scm_tc7_cxr, (SCM (*)()) scm_exact_to_inexact, g_exact_to_inexact);
-
+/* Convert the number @var{x} to its inexact representation.\n" 
+ */
 double
 scm_exact_to_inexact (double z)
 {
@@ -3878,75 +3876,110 @@ scm_exact_to_inexact (double z)
 
 
 SCM_GPROC1 (s_i_floor, "floor", scm_tc7_cxr, (SCM (*)()) floor, g_i_floor);
+/* "Round the number @var{x} towards minus infinity."
+ */
 SCM_GPROC1 (s_i_ceil, "ceiling", scm_tc7_cxr, (SCM (*)()) ceil, g_i_ceil);
+/* "Round the number @var{x} towards infinity."
+ */
 SCM_GPROC1 (s_i_sqrt, "$sqrt", scm_tc7_cxr, (SCM (*)()) sqrt, g_i_sqrt);
+/* "Return the square root of the real number @var{x}."
+ */
 SCM_GPROC1 (s_i_abs, "$abs", scm_tc7_cxr, (SCM (*)()) fabs, g_i_abs);
+/* "Return the absolute value of the real number @var{x}."
+ */
 SCM_GPROC1 (s_i_exp, "$exp", scm_tc7_cxr, (SCM (*)()) exp, g_i_exp);
+/* "Return the @var{x}th power of e."
+ */
 SCM_GPROC1 (s_i_log, "$log", scm_tc7_cxr, (SCM (*)()) log, g_i_log);
+/* "Return the natural logarithm of the real number @var{x}."
+ */
 SCM_GPROC1 (s_i_sin, "$sin", scm_tc7_cxr, (SCM (*)()) sin, g_i_sin);
+/* "Return the sine of the real number @var{x}."
+ */
 SCM_GPROC1 (s_i_cos, "$cos", scm_tc7_cxr, (SCM (*)()) cos, g_i_cos);
+/* "Return the cosine of the real number @var{x}."
+ */
 SCM_GPROC1 (s_i_tan, "$tan", scm_tc7_cxr, (SCM (*)()) tan, g_i_tan);
+/* "Return the tangent of the real number @var{x}."
+ */
 SCM_GPROC1 (s_i_asin, "$asin", scm_tc7_cxr, (SCM (*)()) asin, g_i_asin);
+/* "Return the arc sine of the real number @var{x}."
+ */
 SCM_GPROC1 (s_i_acos, "$acos", scm_tc7_cxr, (SCM (*)()) acos, g_i_acos);
+/* "Return the arc cosine of the real number @var{x}."
+ */
 SCM_GPROC1 (s_i_atan, "$atan", scm_tc7_cxr, (SCM (*)()) atan, g_i_atan);
+/* "Return the arc tangent of the real number @var{x}."
+ */
 SCM_GPROC1 (s_i_sinh, "$sinh", scm_tc7_cxr, (SCM (*)()) sinh, g_i_sinh);
+/* "Return the hyperbolic sine of the real number @var{x}."
+ */
 SCM_GPROC1 (s_i_cosh, "$cosh", scm_tc7_cxr, (SCM (*)()) cosh, g_i_cosh);
+/* "Return the hyperbolic cosine of the real number @var{x}."
+ */
 SCM_GPROC1 (s_i_tanh, "$tanh", scm_tc7_cxr, (SCM (*)()) tanh, g_i_tanh);
+/* "Return the hyperbolic tangent of the real number @var{x}."
+ */
 
 struct dpair
 {
   double x, y;
 };
 
-static void scm_two_doubles (SCM z1,
-                            SCM z2,
+static void scm_two_doubles (SCM x,
+                            SCM y,
                             const char *sstring,
                             struct dpair * xy);
 
 static void
-scm_two_doubles (SCM z1, SCM z2, const char *sstring, struct dpair *xy)
+scm_two_doubles (SCM x, SCM y, const char *sstring, struct dpair *xy)
 {
-  if (SCM_INUMP (z1)) {
-    xy->x = SCM_INUM (z1);
-  } else if (SCM_BIGP (z1)) {
-    xy->x = scm_big2dbl (z1);
-  } else if (SCM_REALP (z1)) {
-    xy->x = SCM_REAL_VALUE (z1);
+  if (SCM_INUMP (x)) {
+    xy->x = SCM_INUM (x);
+  } else if (SCM_BIGP (x)) {
+    xy->x = scm_i_big2dbl (x);
+  } else if (SCM_REALP (x)) {
+    xy->x = SCM_REAL_VALUE (x);
   } else {
-    scm_wrong_type_arg (sstring, SCM_ARG1, z1);
+    scm_wrong_type_arg (sstring, SCM_ARG1, x);
   }
 
-  if (SCM_INUMP (z2)) {
-    xy->y = SCM_INUM (z2);
-  } else if (SCM_BIGP (z2)) {
-    xy->y = scm_big2dbl (z2);
-  } else if (SCM_REALP (z2)) {
-    xy->y = SCM_REAL_VALUE (z2);
+  if (SCM_INUMP (y)) {
+    xy->y = SCM_INUM (y);
+  } else if (SCM_BIGP (y)) {
+    xy->y = scm_i_big2dbl (y);
+  } else if (SCM_REALP (y)) {
+    xy->y = SCM_REAL_VALUE (y);
   } else {
-    scm_wrong_type_arg (sstring, SCM_ARG2, z2);
+    scm_wrong_type_arg (sstring, SCM_ARG2, y);
   }
 }
 
 
 SCM_DEFINE (scm_sys_expt, "$expt", 2, 0, 0,
-            (SCM z1, SCM z2),
-           "") 
+            (SCM x, SCM y),
+           "Return @var{x} raised to the power of @var{y}. This\n"
+           "procedure does not accept complex arguments.") 
 #define FUNC_NAME s_scm_sys_expt
 {
   struct dpair xy;
-  scm_two_doubles (z1, z2, FUNC_NAME, &xy);
+  scm_two_doubles (x, y, FUNC_NAME, &xy);
   return scm_make_real (pow (xy.x, xy.y));
 }
 #undef FUNC_NAME
 
 
 SCM_DEFINE (scm_sys_atan2, "$atan2", 2, 0, 0,
-            (SCM z1, SCM z2),
-           "")
+            (SCM x, SCM y),
+           "Return the arc tangent of the two arguments @var{x} and\n"
+           "@var{y}. This is similar to calculating the arc tangent of\n"
+           "@var{x} / @var{y}, except that the signs of both arguments\n"
+           "are used to determine the quadrant of the result. This\n"
+           "procedure does not accept complex arguments.")
 #define FUNC_NAME s_scm_sys_atan2
 {
   struct dpair xy;
-  scm_two_doubles (z1, z2, FUNC_NAME, &xy);
+  scm_two_doubles (x, y, FUNC_NAME, &xy);
   return scm_make_real (atan2 (xy.x, xy.y));
 }
 #undef FUNC_NAME
@@ -3954,8 +3987,8 @@ SCM_DEFINE (scm_sys_atan2, "$atan2", 2, 0, 0,
 
 SCM_DEFINE (scm_make_rectangular, "make-rectangular", 2, 0, 0,
             (SCM real, SCM imaginary),
-           "Return a complex number constructed of the given REAL and\n"
-           "IMAGINARY parts.")
+           "Return a complex number constructed of the given @var{real} and\n"
+           "@var{imaginary} parts.")
 #define FUNC_NAME s_scm_make_rectangular
 {
   struct dpair xy;
@@ -3967,19 +4000,20 @@ SCM_DEFINE (scm_make_rectangular, "make-rectangular", 2, 0, 0,
 
 
 SCM_DEFINE (scm_make_polar, "make-polar", 2, 0, 0,
-            (SCM z1, SCM z2),
-           "Return the complex number Z1 * e^(i * Z2).")
+            (SCM x, SCM y),
+           "Return the complex number @var{x} * e^(i * @var{y}).")
 #define FUNC_NAME s_scm_make_polar
 {
   struct dpair xy;
-  scm_two_doubles (z1, z2, FUNC_NAME, &xy);
+  scm_two_doubles (x, y, FUNC_NAME, &xy);
   return scm_make_complex (xy.x * cos (xy.y), xy.x * sin (xy.y));
 }
 #undef FUNC_NAME
 
 
 SCM_GPROC (s_real_part, "real-part", 1, 0, 0, scm_real_part, g_real_part);
-
+/* "Return the real part of the number @var{z}."
+ */
 SCM
 scm_real_part (SCM z)
 {
@@ -3998,7 +4032,8 @@ scm_real_part (SCM z)
 
 
 SCM_GPROC (s_imag_part, "imag-part", 1, 0, 0, scm_imag_part, g_imag_part);
-
+/* "Return the imaginary part of the number @var{z}."
+ */
 SCM
 scm_imag_part (SCM z)
 {
@@ -4017,7 +4052,9 @@ scm_imag_part (SCM z)
 
 
 SCM_GPROC (s_magnitude, "magnitude", 1, 0, 0, scm_magnitude, g_magnitude);
-
+/* "Return the magnitude of the number @var{z}. This is the same as\n"
+ * "@code{abs} for real arguments, but also allows complex numbers."
+ */
 SCM
 scm_magnitude (SCM z)
 {
@@ -4029,7 +4066,7 @@ scm_magnitude (SCM z)
       return SCM_MAKINUM (-zz);
     } else {
 #ifdef SCM_BIGDIG
-      return scm_long2big (-zz);
+      return scm_i_long2big (-zz);
 #else
       scm_num_overflow (s_magnitude);
 #endif
@@ -4038,7 +4075,7 @@ scm_magnitude (SCM z)
     if (!SCM_BIGSIGN (z)) {
       return z;
     } else {
-      return scm_copybig (z, 0);
+      return scm_i_copybig (z, 0);
     }
   } else if (SCM_REALP (z)) {
     return scm_make_real (fabs (SCM_REAL_VALUE (z)));
@@ -4053,7 +4090,8 @@ scm_magnitude (SCM z)
 
 
 SCM_GPROC (s_angle, "angle", 1, 0, 0, scm_angle, g_angle);
-
+/* "Return the angle of the complex number @var{z}."
+ */
 SCM
 scm_angle (SCM z)
 {
@@ -4081,7 +4119,7 @@ scm_angle (SCM z)
 
 SCM_DEFINE (scm_inexact_to_exact, "inexact->exact", 1, 0, 0, 
             (SCM z),
-           "Returns an exact number that is numerically closest to Z.")
+           "Return an exact number that is numerically closest to @var{z}.")
 #define FUNC_NAME s_scm_inexact_to_exact
 {
   if (SCM_INUMP (z)) {
@@ -4095,7 +4133,7 @@ SCM_DEFINE (scm_inexact_to_exact, "inexact->exact", 1, 0, 0,
       return SCM_MAKINUM (lu);
 #ifdef SCM_BIGDIG
     } else if (isfinite (u)) {
-      return scm_dbl2big (u);
+      return scm_i_dbl2big (u);
 #endif
     } else {
       scm_num_overflow (s_scm_inexact_to_exact);
@@ -4111,9 +4149,9 @@ SCM_DEFINE (scm_inexact_to_exact, "inexact->exact", 1, 0, 0,
 /* d must be integer */
 
 SCM
-scm_dbl2big (double d)
+scm_i_dbl2big (double d)
 {
-  scm_sizet i = 0;
+  size_t i = 0;
   long c;
   SCM_BIGDIG *digits;
   SCM ans;
@@ -4123,7 +4161,7 @@ scm_dbl2big (double d)
       u /= SCM_BIGRAD;
       i++;
     }
-  ans = scm_mkbig (i, d < 0);
+  ans = scm_i_mkbig (i, d < 0);
   digits = SCM_BDIGITS (ans);
   while (i--)
     {
@@ -4139,13 +4177,11 @@ scm_dbl2big (double d)
   return ans;
 }
 
-
-
 double
-scm_big2dbl (SCM b)
+scm_i_big2dbl (SCM b)
 {
   double ans = 0.0;
-  scm_sizet i = SCM_NUMDIGS (b);
+  size_t i = SCM_NUMDIGS (b);
   SCM_BIGDIG *digits = SCM_BDIGITS (b);
   while (i--)
     ans = digits[i] + SCM_BIGRAD * ans;
@@ -4153,207 +4189,177 @@ scm_big2dbl (SCM b)
     return - ans;
   return ans;
 }
-#endif
-
 
-SCM
-scm_long2num (long sl)
-{
-  if (!SCM_FIXABLE (sl))
-    {
-#ifdef SCM_BIGDIG
-      return scm_long2big (sl);
-#else
-      return scm_make_real ((double) sl);
 #endif
-    }
-  return SCM_MAKINUM (sl);
-}
-
 
 #ifdef HAVE_LONG_LONGS
-
-SCM
-scm_long_long2num (long_long sl)
-{
-  if (!SCM_FIXABLE (sl))
-    {
-#ifdef SCM_BIGDIG
-      return scm_long_long2big (sl);
-#else
-      return scm_make_real ((double) sl);
+# ifndef LLONG_MAX
+#  define ULLONG_MAX ((unsigned long long) (-1))
+#  define LLONG_MAX ((long long) (ULLONG_MAX >> 1))
+#  define LLONG_MIN (~LLONG_MAX)
+# endif
 #endif
-    }
-  else
-    {
-      /* we know that sl fits into an inum */
-      return SCM_MAKINUM ((scm_bits_t) sl);
-    }
-}
 
-#endif /* HAVE_LONG_LONGS */
+#define SIZE_MAX ((size_t) (-1))
+/* the below is not really guaranteed to work (I think), but probably does: */
+#define PTRDIFF_MIN ((ptrdiff_t) ((ptrdiff_t)1 << (sizeof (ptrdiff_t) * 8 - 1)))
+#define PTRDIFF_MAX (~ PTRDIFF_MIN)
+
+#define NUM2INTEGRAL scm_num2short
+#define INTEGRAL2NUM scm_short2num
+#define INTEGRAL2BIG scm_i_short2big
+#define ITYPE short
+#define MIN_VALUE SHRT_MIN
+#define MAX_VALUE SHRT_MAX
+#include "libguile/num2integral.i.c"
+
+#define NUM2INTEGRAL scm_num2ushort
+#define INTEGRAL2NUM scm_ushort2num
+#define INTEGRAL2BIG scm_i_ushort2big
+#define UNSIGNED
+#define ITYPE unsigned short
+#define MAX_VALUE USHRT_MAX
+#include "libguile/num2integral.i.c"
+
+#define NUM2INTEGRAL scm_num2int
+#define INTEGRAL2NUM scm_int2num
+#define INTEGRAL2BIG scm_i_int2big
+#define ITYPE int
+#define MIN_VALUE INT_MIN
+#define MAX_VALUE INT_MAX
+#include "libguile/num2integral.i.c"
+
+#define NUM2INTEGRAL scm_num2uint
+#define INTEGRAL2NUM scm_uint2num
+#define INTEGRAL2BIG scm_i_uint2big
+#define UNSIGNED
+#define ITYPE unsigned int
+#define MAX_VALUE UINT_MAX
+#include "libguile/num2integral.i.c"
+
+#define NUM2INTEGRAL scm_num2long
+#define INTEGRAL2NUM scm_long2num
+#define INTEGRAL2BIG scm_i_long2big
+#define ITYPE long
+#define MIN_VALUE LONG_MIN
+#define MAX_VALUE LONG_MAX
+#include "libguile/num2integral.i.c"
+
+#define NUM2INTEGRAL scm_num2ulong
+#define INTEGRAL2NUM scm_ulong2num
+#define INTEGRAL2BIG scm_i_ulong2big
+#define UNSIGNED
+#define ITYPE unsigned long
+#define MAX_VALUE ULONG_MAX
+#include "libguile/num2integral.i.c"
+
+#define NUM2INTEGRAL scm_num2ptrdiff
+#define INTEGRAL2NUM scm_ptrdiff2num
+#define INTEGRAL2BIG scm_i_ptrdiff2big
+#define ITYPE ptrdiff_t
+#define MIN_VALUE PTRDIFF_MIN
+#define MAX_VALUE PTRDIFF_MAX
+#include "libguile/num2integral.i.c"
+
+#define NUM2INTEGRAL scm_num2size
+#define INTEGRAL2NUM scm_size2num
+#define INTEGRAL2BIG scm_i_size2big
+#define UNSIGNED
+#define ITYPE size_t
+#define MAX_VALUE SIZE_MAX
+#include "libguile/num2integral.i.c"
 
+#ifdef HAVE_LONG_LONGS
 
-SCM
-scm_ulong2num (unsigned long sl)
-{
-  if (!SCM_POSFIXABLE (sl))
-    {
-#ifdef SCM_BIGDIG
-      return scm_ulong2big (sl);
-#else
-      return scm_make_real ((double) sl);
+#ifndef ULONG_LONG_MAX
+#define ULONG_LONG_MAX (~0ULL)
 #endif
-    }
-  return SCM_MAKINUM (sl);
-}
 
+#define NUM2INTEGRAL scm_num2long_long
+#define INTEGRAL2NUM scm_long_long2num
+#define INTEGRAL2BIG scm_i_long_long2big
+#define ITYPE long long
+#define MIN_VALUE LLONG_MIN
+#define MAX_VALUE LLONG_MAX
+#include "libguile/num2integral.i.c"
+
+#define NUM2INTEGRAL scm_num2ulong_long
+#define INTEGRAL2NUM scm_ulong_long2num
+#define INTEGRAL2BIG scm_i_ulong_long2big
+#define UNSIGNED
+#define ITYPE unsigned long long
+#define MAX_VALUE ULLONG_MAX
+#include "libguile/num2integral.i.c"
 
-long
-scm_num2long (SCM num, char *pos, const char *s_caller)
-{
-  if (SCM_INUMP (num)) {
-    return SCM_INUM (num);
-  } else if (SCM_BIGP (num)) {
-    long int res;
-    /* can't use res directly in case num is -2^31.  */
-    unsigned long int pos_res = 0;
-    unsigned long int old_res = 0;
-    scm_sizet l;
-
-    for (l = SCM_NUMDIGS (num); l--;) {
-      pos_res = SCM_BIGUP (pos_res) + SCM_BDIGITS (num)[l];
-      if (pos_res >= old_res) {
-       old_res = pos_res;
-      } else {
-       /* overflow. */
-       scm_out_of_range (s_caller, num);
-      }
-    }
-    if (SCM_BIGSIGN (num)) {
-      res = -pos_res;
-      if (res <= 0) {
-       return res;
-      } else {
-       scm_out_of_range (s_caller, num);
-      }
-    } else {
-      res = pos_res;
-      if (res >= 0) {
-       return res;
-      } else {
-       scm_out_of_range (s_caller, num);
-      }
-    }
-  } else if (SCM_REALP (num)) {
-    double u = SCM_REAL_VALUE (num);
-    long int res = u;
-    if ((double) res == u) {
-      return res;
-    } else {
-      scm_out_of_range (s_caller, num);
-    }
-  } else {
-    scm_wrong_type_arg (s_caller, (int) pos, num);
-  }
-}
+#endif /* HAVE_LONG_LONGS */
 
+#ifdef GUILE_DEBUG
 
-#ifdef HAVE_LONG_LONGS
+#define CHECK(type, v) \
+  do { \
+    if ((v) != scm_num2##type (scm_##type##2num (v), 1, "check_sanity")) \
+      abort (); \
+  } while (0);
 
-long_long
-scm_num2long_long (SCM num, char *pos, const char *s_caller)
+static void
+check_sanity ()
 {
-  if (SCM_INUMP (num)) {
-    return SCM_INUM (num);
-  } else if (SCM_BIGP (num)) {
-    long long res;
-    /* can't use res directly in case num is -2^63.  */
-    unsigned long long int pos_res = 0;
-    unsigned long long int old_res = 0;
-    scm_sizet l;
-
-    for (l = SCM_NUMDIGS (num); l--;) {
-      pos_res = SCM_LONGLONGBIGUP (pos_res) + SCM_BDIGITS (num)[l];
-      if (pos_res >= old_res) {
-       old_res = pos_res;
-      } else {
-       /* overflow. */
-       scm_out_of_range (s_caller, num);
-      }
-    }
-    if (SCM_BIGSIGN (num)) {
-      res = -pos_res;
-      if (res <= 0) {
-       return res;
-      } else {
-       scm_out_of_range (s_caller, num);
-      }
-    } else {
-      res = pos_res;
-      if (res >= 0) {
-       return res;
-      } else {
-       scm_out_of_range (s_caller, num);
-      }
-    }
-  } else if (SCM_REALP (num)) {
-    double u = SCM_REAL_VALUE (num);
-    long long int res = u;
-    if ((double) res == u) {
-      return res;
-    } else {
-      scm_out_of_range (s_caller, num);
-    }
-  } else {
-    scm_wrong_type_arg (s_caller, (int) pos, num);
-  }
-}
+  CHECK (short, 0);
+  CHECK (ushort, 0U);
+  CHECK (int, 0);
+  CHECK (uint, 0U);
+  CHECK (long, 0L);
+  CHECK (ulong, 0UL);
+  CHECK (size, 0);
+  CHECK (ptrdiff, 0);
+
+  CHECK (short, -1);
+  CHECK (int, -1);
+  CHECK (long, -1L);
+  CHECK (ptrdiff, -1);
+
+  CHECK (short, SHRT_MAX);
+  CHECK (short, SHRT_MIN);
+  CHECK (ushort, USHRT_MAX);
+  CHECK (int, INT_MAX);
+  CHECK (int, INT_MIN);
+  CHECK (uint, UINT_MAX);
+  CHECK (long, LONG_MAX);
+  CHECK (long, LONG_MIN);
+  CHECK (ulong, ULONG_MAX);
+  CHECK (size, SIZE_MAX);
+  CHECK (ptrdiff, PTRDIFF_MAX);
+  CHECK (ptrdiff, PTRDIFF_MIN);
 
-#endif /* HAVE_LONG_LONGS */
+#ifdef HAVE_LONG_LONGS
+  CHECK (long_long, 0LL);
+  CHECK (ulong_long, 0ULL);
 
+  CHECK (long_long, -1LL);
 
-unsigned long
-scm_num2ulong (SCM num, char *pos, const char *s_caller)
-{
-  if (SCM_INUMP (num)) {
-    long nnum = SCM_INUM (num);
-    if (nnum >= 0) {
-      return nnum;
-    } else {
-      scm_out_of_range (s_caller, num);
-    }
-  } else if (SCM_BIGP (num)) {
-    unsigned long int res = 0;
-    unsigned long int old_res = 0;
-    scm_sizet l;
-    
-    for (l = SCM_NUMDIGS (num); l--;) {
-      res = SCM_BIGUP (res) + SCM_BDIGITS (num)[l];
-      if (res >= old_res) {
-       old_res = res;
-      } else {
-       scm_out_of_range (s_caller, num);
-      }
-    }
-    return res;
-  } else if (SCM_REALP (num)) {
-    double u = SCM_REAL_VALUE (num);
-    unsigned long int res = u;
-    if ((double) res == u) {
-      return res;
-    } else {
-      scm_out_of_range (s_caller, num);
-    }
-  } else {
-    scm_wrong_type_arg (s_caller, (int) pos, num);
-  }
+  CHECK (long_long, LLONG_MAX);
+  CHECK (long_long, LLONG_MIN);
+  CHECK (ulong_long, ULLONG_MAX);
+#endif
 }
 
+#endif
 
 void
 scm_init_numbers ()
 {
+  abs_most_negative_fixnum = scm_i_long2big (- SCM_MOST_NEGATIVE_FIXNUM);
+  scm_permanent_object (abs_most_negative_fixnum);
+
+  /* It may be possible to tune the performance of some algorithms by using
+   * the following constants to avoid the creation of bignums.  Please, before
+   * using these values, remember the two rules of program optimization:
+   * 1st Rule:  Don't do it.  2nd Rule (experts only):  Don't do it yet. */
+  scm_c_define ("most-positive-fixnum",
+               SCM_MAKINUM (SCM_MOST_POSITIVE_FIXNUM));
+  scm_c_define ("most-negative-fixnum",
+               SCM_MAKINUM (SCM_MOST_NEGATIVE_FIXNUM));
+
   scm_add_feature ("complex");
   scm_add_feature ("inexact");
   scm_flo0 = scm_make_real (0.0);
@@ -4374,9 +4380,104 @@ scm_init_numbers ()
     scm_dblprec = scm_dblprec - 1;
   }
 #endif /* DBL_DIG */
+
+#ifdef GUILE_DEBUG
+  check_sanity ();
+#endif
+  
+#ifndef SCM_MAGIC_SNARFER
 #include "libguile/numbers.x"
+#endif
 }
 
+#if (SCM_DEBUG_DEPRECATED == 0)
+
+SCM
+scm_mkbig (size_t len, int sign)
+{
+  scm_c_issue_deprecation_warning ("`scm_mkbig' is deprecated. "
+                                   "Use `scm_i_mkbig' instead.");
+  return scm_i_mkbig (len, sign);
+}
+
+SCM
+scm_big2inum (SCM b, size_t l)
+{
+  scm_c_issue_deprecation_warning ("`scm_big2inum' is deprecated. "
+                                   "Use `scm_i_big2num' instead.");
+  return scm_i_big2inum (b, l);
+}
+
+SCM
+scm_adjbig (SCM b, size_t nlen)
+{
+  scm_c_issue_deprecation_warning ("`scm_adjbig' is deprecated. "
+                                   "Use `scm_i_adjbig' instead.");
+  return scm_i_adjbig (b, nlen);
+}
+
+SCM
+scm_normbig (SCM b)
+{
+  scm_c_issue_deprecation_warning ("`scm_normbig' is deprecated. "
+                                   "Use `scm_i_normbig' instead.");
+  return scm_i_normbig (b);
+}
+
+SCM
+scm_copybig (SCM b, int sign)
+{
+  scm_c_issue_deprecation_warning ("`scm_copybig' is deprecated. "
+                                   "Use `scm_i_copybig' instead.");
+  return scm_i_copybig (b, sign);
+}
+
+SCM
+scm_2ulong2big (unsigned long *np)
+{
+  unsigned long n;
+  size_t i;
+  SCM_BIGDIG *digits;
+  SCM ans;
+
+  ans = scm_i_mkbig (2 * SCM_DIGSPERLONG, 0);
+  digits = SCM_BDIGITS (ans);
+
+  n = np[0];
+  for (i = 0; i < SCM_DIGSPERLONG; ++i)
+    {
+      digits[i] = SCM_BIGLO (n);
+      n = SCM_BIGDN ((unsigned long) n);
+    }
+  n = np[1];
+  for (i = 0; i < SCM_DIGSPERLONG; ++i)
+    {
+      digits[i + SCM_DIGSPERLONG] = SCM_BIGLO (n);
+      n = SCM_BIGDN ((unsigned long) n);
+    }
+  return ans;
+}
+
+SCM
+scm_dbl2big (double d)
+{
+  scm_c_issue_deprecation_warning ("`scm_dbl2big' is deprecated. "
+                                  "Use `scm_dbl2num' instead,"
+                                   "or `scm_i_dbl2big'.");
+  return scm_i_dbl2big (d);
+}
+
+double
+scm_big2dbl (SCM b)
+{
+  scm_c_issue_deprecation_warning ("`scm_big2dbl' is deprecated. "
+                                   "Use `scm_num2dbl' instead,"
+                                   "or `scm_i_big2dbl'.");
+  return scm_i_big2dbl (b);
+}
+
+#endif
+
 /*
   Local Variables:
   c-file-style: "gnu"