Doxygen documentation corrected and completed.
This commit is contained in:
38
src/obidms.c
38
src/obidms.c
@ -1,10 +1,15 @@
|
||||
/*
|
||||
* obidms.c
|
||||
*
|
||||
* @date 23 May 2015
|
||||
* @Author: coissac
|
||||
/********************************************************************
|
||||
* OBIDMS functions *
|
||||
********************************************************************/
|
||||
|
||||
/**
|
||||
* @file obidms.c
|
||||
* @author Eric Coissac (eric.coissac@metabarcoding.org)
|
||||
* @date 23 May 2015
|
||||
* @brief OBIDMS functions.
|
||||
*/
|
||||
|
||||
|
||||
#include <stdlib.h>
|
||||
#include <stdio.h>
|
||||
#include <string.h>
|
||||
@ -18,7 +23,7 @@
|
||||
#include "obidmscolumn.h"
|
||||
|
||||
|
||||
#define DEBUG_LEVEL 0
|
||||
#define DEBUG_LEVEL 0 // TODO has to be defined somewhere else (cython compil flag?)
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
@ -29,27 +34,22 @@
|
||||
|
||||
|
||||
/**
|
||||
* Internal function building the directory name from an OBIDMS name.
|
||||
* Internal function building the OBIDMS directory name from an OBIDMS name.
|
||||
*
|
||||
* The function builds the directory name corresponding to an OBIDMS.
|
||||
* It checks also that the name is not too long.
|
||||
* It also checks that the name is not too long.
|
||||
*
|
||||
* @warning The returned pointer has to be freed by the caller.
|
||||
*
|
||||
* @param dms_name the name of the OBIDMS
|
||||
* @param dms_name The name of the OBIDMS.
|
||||
*
|
||||
* @return a pointer to the directory name
|
||||
* @retvalue <directory_name> if everything is ok
|
||||
* @retvalue NULL if an error occurs
|
||||
*
|
||||
* ###Error values
|
||||
* - OBIDMS_MEMORY_ERROR : something wrong occurred during memory allocation.
|
||||
* - OBIDMS_LONG_NAME_ERROR : the database name exceeds the limit.
|
||||
* @returns A pointer to the directory name.
|
||||
* @retval NULL if an error occurred.
|
||||
*
|
||||
* @since May 2015
|
||||
* @author Eric Coissac (eric.coissac@metabarcoding.org)
|
||||
*/
|
||||
static char *build_directory_name(const char *dms_name);
|
||||
static char* build_directory_name(const char* dms_name);
|
||||
|
||||
|
||||
/************************************************************************
|
||||
@ -58,9 +58,9 @@ static char *build_directory_name(const char *dms_name);
|
||||
*
|
||||
************************************************************************/
|
||||
|
||||
static char *build_directory_name(const char *dms_name)
|
||||
static char* build_directory_name(const char* dms_name)
|
||||
{
|
||||
char *directory_name;
|
||||
char* directory_name;
|
||||
|
||||
// Build the database directory name
|
||||
if (asprintf(&directory_name, "%s.obidms", dms_name) < 0)
|
||||
|
Reference in New Issue
Block a user