From 27d14326c700db52c1cbc2b61e1875165aac78d4 Mon Sep 17 00:00:00 2001 From: Michael Koch Date: Sun, 30 May 2004 13:31:33 +0000 Subject: [PATCH] MPN.java, Arc2D.java: Fixed javadocs all over. 2004-05-30 Michael Koch * gnu/java/math/MPN.java, java/awt/geom/Arc2D.java: Fixed javadocs all over. From-SVN: r82446 --- libjava/ChangeLog | 6 ++++++ libjava/gnu/java/math/MPN.java | 29 ++++++++++++++++------------- libjava/java/awt/geom/Arc2D.java | 8 ++++---- 3 files changed, 26 insertions(+), 17 deletions(-) diff --git a/libjava/ChangeLog b/libjava/ChangeLog index 46a472e549e..0a20670900e 100644 --- a/libjava/ChangeLog +++ b/libjava/ChangeLog @@ -1,3 +1,9 @@ +2004-05-30 Michael Koch + + * gnu/java/math/MPN.java, + java/awt/geom/Arc2D.java: + Fixed javadocs all over. + 2004-05-30 Michael Koch * java/awt/DefaultKeyboardFocusManager.java diff --git a/libjava/gnu/java/math/MPN.java b/libjava/gnu/java/math/MPN.java index 988c56f0719..34a7081701e 100644 --- a/libjava/gnu/java/math/MPN.java +++ b/libjava/gnu/java/math/MPN.java @@ -1,5 +1,5 @@ /* gnu.java.math.MPN - Copyright (C) 1999, 2000, 2001 Free Software Foundation, Inc. + Copyright (C) 1999, 2000, 2001, 2004 Free Software Foundation, Inc. This file is part of GNU Classpath. @@ -482,7 +482,7 @@ public class MPN } /** Compare x[0:size-1] with y[0:size-1], treating them as unsigned integers. - * @result -1, 0, or 1 depending on if xy. + * @result -1, 0, or 1 depending on if x<y, x==y, or x>y. * This is basically the same as gmp's mpn_cmp function. */ public static int cmp (int[] x, int[] y, int size) @@ -502,22 +502,24 @@ public class MPN return 0; } - /** Compare x[0:xlen-1] with y[0:ylen-1], treating them as unsigned integers. - * @result -1, 0, or 1 depending on if xy. + /** + * Compare x[0:xlen-1] with y[0:ylen-1], treating them as unsigned integers. + * + * @return -1, 0, or 1 depending on if x<y, x==y, or x>y. */ public static int cmp (int[] x, int xlen, int[] y, int ylen) { return xlen > ylen ? 1 : xlen < ylen ? -1 : cmp (x, y, xlen); } - /* Shift x[x_start:x_start+len-1] count bits to the "right" + /** + * Shift x[x_start:x_start+len-1] count bits to the "right" * (i.e. divide by 2**count). * Store the len least significant words of the result at dest. * The bits shifted out to the right are returned. * OK if dest==x. - * Assumes: 0 < count < 32 + * Assumes: 0 < count < 32 */ - public static int rshift (int[] dest, int[] x, int x_start, int len, int count) { @@ -535,11 +537,12 @@ public class MPN return retval; } - /* Shift x[x_start:x_start+len-1] count bits to the "right" + /** + * Shift x[x_start:x_start+len-1] count bits to the "right" * (i.e. divide by 2**count). * Store the len least significant words of the result at dest. * OK if dest==x. - * Assumes: 0 <= count < 32 + * Assumes: 0 <= count < 32 * Same as rshift, but handles count==0 (and has no return value). */ public static void rshift0 (int[] dest, int[] x, int x_start, @@ -556,7 +559,7 @@ public class MPN * @param x a two's-complement "bignum" * @param len the number of significant words in x * @param count the shift count - * @return (long)(x[0..len-1] >> count). + * @return (long)(x[0..len-1] >> count). */ public static long rshift_long (int[] x, int len, int count) { @@ -579,7 +582,7 @@ public class MPN /* Shift x[0:len-1] left by count bits, and store the len least * significant words of the result in dest[d_offset:d_offset+len-1]. * Return the bits shifted out from the most significant digit. - * Assumes 0 < count < 32. + * Assumes 0 < count < 32. * OK if dest==x. */ @@ -601,7 +604,7 @@ public class MPN return retval; } - /** Return least i such that word&(1< + * @author Eric Blake (ebb9@email.byu.edu) * @since 1.2 * @status updated to 1.4, but still missing functionality */ @@ -527,7 +527,7 @@ public abstract class Arc2D extends RectangularShape * This class is used to iterate over an arc. Since ellipses are a subclass * of arcs, this is used by Ellipse2D as well. * - * @author Eric Blake + * @author Eric Blake (ebb9@email.byu.edu) */ static final class ArcIterator implements PathIterator { @@ -766,7 +766,7 @@ public abstract class Arc2D extends RectangularShape /** * This class implements an arc in double precision. * - * @author Eric Blake