From bbe55b5ce9f5c43e1c9d5e7e326429175b207ba0 Mon Sep 17 00:00:00 2001 From: Dan McGee Date: Thu, 29 Mar 2007 00:40:49 -0400 Subject: Doxygen fixups for libalpm We haven't done a whole lot with Doxygen so far, so this updates some of the things that have changed a lot- namely, the now public exposure of alpm_list. All functions in this file have now been Doxygen commented, and a few other things in alpm.c were fixed as well. In addition, the Doxygen config file was updated. Signed-off-by: Dan McGee --- lib/libalpm/alpm_list.h | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) (limited to 'lib/libalpm/alpm_list.h') diff --git a/lib/libalpm/alpm_list.h b/lib/libalpm/alpm_list.h index 214deea4..838bd775 100644 --- a/lib/libalpm/alpm_list.h +++ b/lib/libalpm/alpm_list.h @@ -1,5 +1,5 @@ /* - * alpm_alpm_list.h + * alpm_list.h * * Copyright (c) 2002-2006 by Judd Vinet * @@ -21,12 +21,25 @@ #ifndef _ALPM_LIST_H #define _ALPM_LIST_H +#ifdef __cplusplus +extern "C" { +#endif + #include "alpm.h" -/* Chained list struct */ +/** + * @brief Linked list type used by libalpm. + * + * It is exposed so front ends can use it to prevent the need to reimplement + * lists of their own; however, it is not required that the front end uses + * it. + */ 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; }; @@ -67,6 +80,9 @@ int alpm_list_find(alpm_list_t *haystack, const void *needle); int alpm_list_find_str(alpm_list_t *haystack,const char *needle); alpm_list_t *alpm_list_diff(alpm_list_t *lhs, alpm_list_t *rhs, alpm_list_fn_cmp fn); +#ifdef __cplusplus +} +#endif #endif /* _ALPM_LIST_H */ /* vim: set ts=2 sw=2 noet: */ -- cgit v1.2.3-24-g4f1b