Compilation environment fixes to make make install work correctly.

[crypto.git] / lib / silcasn1 / silcber.h

diff --git a/lib/silcasn1/silcber.h b/lib/silcasn1/silcber.h
index 244c856ce619579591f33b19c4c05864d278077e..511380119ba68e27da17717c43b66b55de0196eb 100644 (file)
--- a/lib/silcasn1/silcber.h
+++ b/lib/silcasn1/silcber.h
@@ -4,7 +4,7 @@
 
   Author: Pekka Riikonen <priikone@silcnet.org>
 
-  Copyright (C) 2003 - 2005 Pekka Riikonen
+  Copyright (C) 2003 - 2008 Pekka Riikonen
 
   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
@@ -27,6 +27,9 @@
  * to encode and decode DER blocks as well.  These routines does not
  * allocate any memory and have been optimized for general ASN.1 usage.
  *
+ * This is a low level interface and is not usually needed or used
+ * directly.
+ *
  * References: ITU-T X.690
  * http://www.itu.int/ITU-T/studygroups/com17/languages/X690_0702.pdf
  *
@@ -35,26 +38,53 @@
 #ifndef SILCBER_H
 #define SILCBER_H
 
+/****d* silcasn1/SilcBerClass
+ *
+ * NAME
+ *
+ *    typedef enum { ... } SilcBerClass;
+ *
+ * DESCRIPTION
+ *
+ *    Defines the BER classes.
+ *
+ * SOURCE
+ */
 typedef enum {
   SILC_BER_CLASS_UNIVERSAL       = 0x00,   /* Universal */
   SILC_BER_CLASS_APPLICATION     = 0x01,   /* Application */
   SILC_BER_CLASS_CONTEXT         = 0x02,   /* Context-specific */
   SILC_BER_CLASS_PRIVATE         = 0x03,   /* Private */
 } SilcBerClass;
+/***/
 
+/****d* silcasn1/SilcBerEncoding
+ *
+ * NAME
+ *
+ *    typedef enum { ... } SilcBerEncoding;
+ *
+ * DESCRIPTION
+ *
+ *    Defines the BER encoding type.
+ *
+ * SOURCE
+ */
 typedef enum {
   SILC_BER_ENC_PRIMITIVE         = 0x00,
   SILC_BER_ENC_CONSTRUCTED       = 0x01,
 } SilcBerEncoding;
+/***/
 
-/****f* silcasn1/SilcBerAPI/silc_ber_encode
+/****f* silcasn1/silc_ber_encode
  *
  * SYNOPSIS
  *
- *    SilcBool silc_ber_encode(SilcBuffer ber, SilcBerClass ber_class,
- *                         SilcBerEncoding encoding, SilcUInt32 tag,
- *                         const unsigned char *data, SilcUInt32 data_len,
- *                         SilcBool indefinite);
+ *    SilcBool
+ *    silc_ber_encode(SilcBuffer ber, SilcBerClass ber_class,
+ *                    SilcBerEncoding encoding, SilcUInt32 tag,
+ *                    const unsigned char *data, SilcUInt32 data_len,
+ *                    SilcBool indefinite);
  *
  * DESCRIPTION
  *
@@ -66,18 +96,19 @@ typedef enum {
  *
  ***/
 SilcBool silc_ber_encode(SilcBuffer ber, SilcBerClass ber_class,
-                    SilcBerEncoding encoding, SilcUInt32 tag,
-                    const unsigned char *data, SilcUInt32 data_len,
-                    SilcBool indefinite);
+                        SilcBerEncoding encoding, SilcUInt32 tag,
+                        const unsigned char *data, SilcUInt32 data_len,
+                        SilcBool indefinite);
 
-/****f* silcasn1/SilcBerAPI/silc_ber_decode
+/****f* silcasn1/silc_ber_decode
  *
  * SYNOPSIS
  *
- *    SilcBool silc_ber_decode(SilcBuffer ber, SilcBerClass *ber_class,
- *                         SilcBerEncoding *encoding, SilcUInt32 *tag,
- *                         const unsigned char **data, SilcUInt32 *data_len,
- *                         SilcBool *indefinite, SilcUInt32 *identifier_len);
+ *    SilcBool
+ *    silc_ber_decode(SilcBuffer ber, SilcBerClass *ber_class,
+ *                    SilcBerEncoding *encoding, SilcUInt32 *tag,
+ *                    const unsigned char **data, SilcUInt32 *data_len,
+ *                    SilcBool *indefinite, SilcUInt32 *identifier_len);
  *
  * DESCRIPTION
  *
@@ -93,11 +124,11 @@ SilcBool silc_ber_encode(SilcBuffer ber, SilcBerClass ber_class,
  *
  ***/
 SilcBool silc_ber_decode(SilcBuffer ber, SilcBerClass *ber_class,
-                    SilcBerEncoding *encoding, SilcUInt32 *tag,
-                    const unsigned char **data, SilcUInt32 *data_len,
-                    SilcBool *indefinite, SilcUInt32 *identifier_len);
+                        SilcBerEncoding *encoding, SilcUInt32 *tag,
+                        const unsigned char **data, SilcUInt32 *data_len,
+                        SilcBool *indefinite, SilcUInt32 *identifier_len);
 
-/****f* silcasn1/SilcBerAPI/silc_ber_encoded_len
+/****f* silcasn1/silc_ber_encoded_len
  *
  * SYNOPSIS
  *