summaryrefslogtreecommitdiff
path: root/lib
diff options
context:
space:
mode:
authorDan McGee <dan@archlinux.org>2007-10-14 17:29:32 -0500
committerDan McGee <dan@archlinux.org>2007-10-14 17:29:32 -0500
commit0adedc536fe372b4def5954f3b24ca63ff86aecf (patch)
treec3632a7559a0f59e8c782a517aa9c9c2bf72192f /lib
parent5adb8d4b5ac6928ba1a0736d96ca6c533d8cbc76 (diff)
Updates to fix Doxygen documentation generation
We had way too much going on with the Doxygen manpage generation. Clean it up quite a bit by removing directory manpages, using relative paths, not having a manpage for every single alpm function, and ensuring internal functions are not documented publicly. Signed-off-by: Dan McGee <dan@archlinux.org>
Diffstat (limited to 'lib')
-rw-r--r--lib/libalpm/alpm.h4
-rw-r--r--lib/libalpm/alpm_list.h6
-rw-r--r--lib/libalpm/md5.h6
3 files changed, 7 insertions, 9 deletions
diff --git a/lib/libalpm/alpm.h b/lib/libalpm/alpm.h
index b90ab896..6eda2106 100644
--- a/lib/libalpm/alpm.h
+++ b/lib/libalpm/alpm.h
@@ -31,6 +31,8 @@ extern "C" {
#include <time.h> /* for time_t */
#include <stdarg.h> /* for va_list */
+#include <alpm_list.h>
+
#define DEPRECATED __attribute__((deprecated))
/*
@@ -41,8 +43,6 @@ extern "C" {
* Structures
*/
-typedef struct __alpm_list_t alpm_list_t;
-
typedef struct __pmdb_t pmdb_t;
typedef struct __pmpkg_t pmpkg_t;
typedef struct __pmgrp_t pmgrp_t;
diff --git a/lib/libalpm/alpm_list.h b/lib/libalpm/alpm_list.h
index 10d01df2..a2a06f4c 100644
--- a/lib/libalpm/alpm_list.h
+++ b/lib/libalpm/alpm_list.h
@@ -25,8 +25,6 @@
extern "C" {
#endif
-#include "alpm.h"
-
/**
* @brief Linked list type used by libalpm.
*
@@ -34,14 +32,14 @@ extern "C" {
* lists of their own; however, it is not required that the front end uses
* it.
*/
-struct __alpm_list_t {
+typedef struct __alpm_list_t {
/** data held by the list node */
void *data;
/** pointer to the previous node */
struct __alpm_list_t *prev;
/** pointer to the next node */
struct __alpm_list_t *next;
-};
+} alpm_list_t;
#define FREELIST(p) do { alpm_list_free_inner(p, free); alpm_list_free(p); p = NULL; } while(0)
diff --git a/lib/libalpm/md5.h b/lib/libalpm/md5.h
index 4adc8a88..08dad1ec 100644
--- a/lib/libalpm/md5.h
+++ b/lib/libalpm/md5.h
@@ -18,9 +18,6 @@
* MA 02110-1301 USA
*/
-/**
- * \file md5.h
- */
#ifndef _MD5_H
#define _MD5_H
@@ -29,6 +26,7 @@ extern "C" {
#endif
/**
+ * \internal
* \brief MD5 context structure
*/
typedef struct
@@ -40,6 +38,7 @@ typedef struct
md5_context;
/**
+ * \internal
* \brief Output = MD5( input buffer )
*
* \param input buffer holding the data
@@ -50,6 +49,7 @@ void md5( unsigned char *input, int ilen,
unsigned char *output );
/**
+ * \internal
* \brief Output = MD5( file contents )
*
* \param path input file name