From c85d155f3a789ce149ecfca5f9ef205e329bb675 Mon Sep 17 00:00:00 2001 From: Richard Pougnet Date: Sun, 24 Mar 2013 20:02:06 -0400 Subject: Improve documentation of libalpm interface functions Add details to the doxygen for the initialization and relase functions of the library. Signed-off-by: Richard Pougnet Signed-off-by: Allan McRae --- lib/libalpm/alpm.c | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) (limited to 'lib') diff --git a/lib/libalpm/alpm.c b/lib/libalpm/alpm.c index cd14adbb..878c38bd 100644 --- a/lib/libalpm/alpm.c +++ b/lib/libalpm/alpm.c @@ -37,8 +37,9 @@ * @{ */ -/** Initializes the library. This must be called before any other - * functions are called. +/** Initializes the library. + * Creates handle, connects to database and creates lockfile. + * This must be called before any other functions are called. * @param root the root path for all filesystem operations * @param dbpath the absolute path to the libalpm database * @param err an optional variable to hold any error return codes @@ -86,7 +87,9 @@ cleanup: return NULL; } -/** Release the library. This should be the last alpm call you make. +/** Release the library. + * Disconnects from the database, removes handle and lockfile + * This should be the last alpm call you make. * After this returns, handle should be considered invalid and cannot be reused * in any way. * @param myhandle the context handle -- cgit v1.2.3-70-g09d2