JavaDoc additions

1 files changed, 3 insertions, 2 deletions

diff --git a/core/src/main/java/org/bouncycastle/crypto/SkippingCipher.java b/core/src/main/java/org/bouncycastle/crypto/SkippingCipher.java
index 8f137bd2..bf2595fd 100644
--- a/core/src/main/java/org/bouncycastle/crypto/SkippingCipher.java
+++ b/core/src/main/java/org/bouncycastle/crypto/SkippingCipher.java
@@ -1,16 +1,17 @@
 package org.bouncycastle.crypto;
 
 /**
- * Ciphers producing a keystream which can be moved around
+ * Ciphers producing a key stream which can be reset to particular points in the stream.
  */
 public interface SkippingCipher
 {
     /**
-     * Skip numberOfBlocks forwards, or backwards. If the cipher is a streamcipher a block
+     * Skip numberOfBlocks forwards, or backwards. If the cipher is a stream cipher a block
      * size of 1 is assumed.
      *
      * @param numberOfBlocks the number of blocks to skip (positive forward, negative backwards).
      * @return the number of blocks actually skipped.
+     * @throws java.lang.IllegalArgumentException if numberOfBlocks is an invalid value.
      */
     long skip(long numberOfBlocks);
 }