X-Git-Url: https://git.cryptolib.org/?p=avr-crypto-lib.git;a=blobdiff_plain;f=skipjack.h;h=9c670733f27224522c59f38a62970e9dfb7517be;hp=0db740d6791cf83e2dbce6e93971a1e8c8cb9f33;hb=6bd58d7909b89a3e05003a63cdc642638fa653e6;hpb=36101d05fdd3f660375301ca9f017d2e16c228b7

diff --git a/skipjack.h b/skipjack.h
index 0db740d..9c67073 100644
--- a/skipjack.h
+++ b/skipjack.h
@@ -19,18 +19,37 @@
 #ifndef SKIPJACK_H_
 #define SKIPJACK_H_
 
+/** 
+ * \file      skipjack.h
+ * \author    Daniel Otte
+ * \date      2006-11-01
+ * \license   GPLv3 or later
+ * \brief     Implementation of the serpent sbox function.
+ * 
+ */
+
+
 #include <stdint.h>
 
-/*****************************************************************************/
-/**
- * block is 64 bits (=8 bytes) in size, key is 80 bits (=10 bytes) in size.
+/** \fn void skipjack_enc(void* block, void* key)
+ * \brief skipjack encryption function
  * 
+ * This function encrypts a block of plaintext with the Skipjac encryption
+ * algorithm. The block is 64 bit (8 byte) long, the key is 80 bit (10 byte)
+ * long.
+ * \param block pointer to the 64 bit (8 byte) block to encrypt
+ * \param key   pointer to the 80 bit (10 byte) key 
  */
 void skipjack_enc(void* block, void* key);
-/*****************************************************************************/
-/**
- * block is 64 bits (=8 bytes) in size, key is 80 bits (=10 bytes) in size.
+
+/** \fn void skipjack_dec(void* block, void* key)
+ * \brief skipjack decryption function
  * 
+ * This function decrypts a block of ciphertext encrypted with the Skipjac
+ * encryption algorithm. 
+ * The block is 64 bit (8 byte) long, the key is 80 bit (10 byte) long.
+ * \param block pointer to the 64 bit (8 byte) block to decrypt
+ * \param key   pointer to the 80 bit (10 byte) key 
  */
 void skipjack_dec(void* block, void* key);