From b3efcbda59487101836bb0743878c18360d2dc35 Mon Sep 17 00:00:00 2001
From: =?utf8?q?Love=20H=C3=B6rnquist=20=C3=85strand?= <lha@kth.se>
Date: Sat, 15 Dec 2007 04:49:37 +0000
Subject: [PATCH] more documentation

git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@22327 ec53bebd-3082-4978-b11e-865c3cabbd6b
---
 lib/hx509/cert.c    |  2 ++
 lib/hx509/cms.c     |  2 ++
 lib/hx509/doxygen.c |  2 ++
 lib/hx509/keyset.c  | 10 +++++++---
 lib/hx509/lock.c    |  2 ++
 lib/hx509/name.c    |  2 ++
 6 files changed, 17 insertions(+), 3 deletions(-)

diff --git a/lib/hx509/cert.c b/lib/hx509/cert.c
index 5ca885e3a..db7adf001 100644
--- a/lib/hx509/cert.c
+++ b/lib/hx509/cert.c
@@ -47,6 +47,8 @@ RCSID("$Id$");
  * page_keyset), but its also possible to create a certificate
  * directly from a parsed object with hx509_cert_init() and
  * hx509_cert_init_data().
+ *
+ * See the library functions here: @ref hx509_cert
  */
 
 struct hx509_verify_ctx_data {
diff --git a/lib/hx509/cms.c b/lib/hx509/cms.c
index e13ad6521..42862129a 100644
--- a/lib/hx509/cms.c
+++ b/lib/hx509/cms.c
@@ -50,6 +50,8 @@ RCSID("$Id$");
  * - ContentInfo
  *   Wrapper structure including type and data.
  *
+ *
+ * See the library functions here: @ref hx509_cms
  */
 
 #define ALLOC(X, N) (X) = calloc((N), sizeof(*(X)))
diff --git a/lib/hx509/doxygen.c b/lib/hx509/doxygen.c
index f4a939afb..00604d719 100644
--- a/lib/hx509/doxygen.c
+++ b/lib/hx509/doxygen.c
@@ -69,3 +69,5 @@
 /** @defgroup hx509_revoke hx509 revokation checking functions
  * See the @ref page_revoke for description and examples. */
 /** @defgroup hx509_verify hx509 verification functions */
+/** @defgroup hx509_lock hx509 lock functions
+ * See the @ref page_lock for description and examples. */
diff --git a/lib/hx509/keyset.c b/lib/hx509/keyset.c
index 84dedd700..646215b9b 100644
--- a/lib/hx509/keyset.c
+++ b/lib/hx509/keyset.c
@@ -35,7 +35,7 @@
 RCSID("$Id$");
 
 /**
- * @page page_keyset certificates store operations
+ * @page page_keyset Certificate store operations
  *
  * Type of certificates store:
  * - MEMORY
@@ -52,6 +52,10 @@ RCSID("$Id$");
  * - PKCS11
  * - PKCS12
  * - DIR
+ * - KEYCHAIN
+ *   Apple Mac OS X KeyChain backed keychain object.
+ *
+ * See the library functions here: @ref hx509_keyset
  */
 
 struct hx509_certs_data {
@@ -97,8 +101,8 @@ _hx509_ks_register(hx509_context context, struct hx509_keyset_ops *ops)
  * if NULL is used the MEMORY store is used.
  * @param flags list of flags:
  * - HX509_CERTS_CREATE create a new keystore of the specific TYPE.
- * @param lock a @ref page_lock that unlocks the certificates store,
- * use NULL to select no password/certifictes/prompt lock.
+ * @param lock a lock that unlocks the certificates store, use NULL to
+ * select no password/certifictes/prompt lock (see @ref page_lock).
  * @param certs return pointer, free with hx509_certs_free().
  *
  * @ingroup hx509_keyset
diff --git a/lib/hx509/lock.c b/lib/hx509/lock.c
index 93aa20ed7..df1acea04 100644
--- a/lib/hx509/lock.c
+++ b/lib/hx509/lock.c
@@ -36,6 +36,8 @@ RCSID("$Id$");
 
 /**
  * @page page_lock Locking and unlocking certificates and encrypted data.
+ *
+ * See the library functions here: @ref hx509_lock
  */
 
 struct hx509_lock_data {
diff --git a/lib/hx509/name.c b/lib/hx509/name.c
index 0af65e091..791c54174 100644
--- a/lib/hx509/name.c
+++ b/lib/hx509/name.c
@@ -56,6 +56,8 @@ RCSID("$Id$");
  * make it back into string representation with hx509_name_to_string().
  *
  * Name string are defined rfc2253, rfc1779 and X.501.
+ *
+ * See the library functions here: @ref hx509_name
  */
 
 static const struct {
-- 
2.11.4.GIT