-YAZ_EXPORT void *xrealloc_f (void *o, size_t size, const char *file, int line);
-YAZ_EXPORT void *xmalloc_f (size_t size, const char *file, int line);
-YAZ_EXPORT void *xcalloc_f (size_t nmemb, size_t size,
- const char *file, int line);
-YAZ_EXPORT char *xstrdup_f (const char *p, const char *file, int line);
+/** \brief realloc
+ \param o buffer to be reallocated
+ \param size size of buffer to be allocated
+ \param file fname location of use
+ \param line line location of use
+ \returns buffer
+
+ This function is invoked via macro xrealloc in which file and line are set
+ automatically.
+*/
+
+YAZ_EXPORT void *xrealloc_f(void *o, size_t size, const char *file, int line);
+/** \brief malloc
+ \param size size of buffer to be allocated
+ \param file fname location of use
+ \param line line location of use
+ \returns buffer
+
+ This function is invoked via macro xmalloc in which file and line are set
+ automatically.
+*/
+YAZ_EXPORT void *xmalloc_f(size_t size, const char *file, int line);
+
+/** \brief calloc
+ \param nmemb number of members
+ \param size size of member
+ \param file fname location of use
+ \param line line location of use
+ \returns buffer
+
+ This function is invoked via macro xcalloc in which file and line are set
+ automatically.
+*/
+YAZ_EXPORT void *xcalloc_f(size_t nmemb, size_t size,
+ const char *file, int line);
+/** \brief strdup
+ \param p string to be cloned
+ \param file fname location of use
+ \param line line location of use
+ \returns resulting string
+
+ This function is invoked via macro xstrdup in which file and line are set
+ automatically.
+*/
+YAZ_EXPORT char *xstrdup_f(const char *p, const char *file, int line);
+
+/** \brief strndup
+ \param p string to be cloned
+ \param n max size of resulting string (excluding 0)
+ \param file fname location of use
+ \param line line location of use
+ \returns resulting string
+
+ This function is invoked via macro xstrndup in which file and line are set
+ automatically.
+*/