ogg_afh.c: Kill tunetable()
[paraslash.git] / string.c
index 47c5417df576a56c1d710137c02182a3b7600fa5..0a55ed20c299144aeaf048a3c98db5dafdae4978 100644 (file)
--- a/string.c
+++ b/string.c
@@ -49,7 +49,8 @@ __must_check __malloc void *para_realloc(void *p, size_t size)
         * to realloc is equivalent to malloc(size)
         */
        if (!(p = realloc(p, size))) {
-               PARA_EMERG_LOG("%s", "realloc failed, aborting\n");
+               PARA_EMERG_LOG("realloc failed (size = %zu), aborting\n",
+                       size);
                exit(EXIT_FAILURE);
        }
        return p;
@@ -85,8 +86,8 @@ __must_check __malloc void *para_malloc(size_t size)
  *
  * A wrapper for calloc(3) which exits on errors.
  *
- * A pointer to the allocated and zeroed-out memory, which is suitably aligned
- * for any kind  of variable.
+ * \return A pointer to the allocated and zeroed-out memory, which is suitably
+ * aligned for any kind  of variable.
  *
  * \sa calloc(3)
  */
@@ -103,8 +104,8 @@ __must_check __malloc void *para_calloc(size_t size)
  *
  * \param s string to be duplicated
  *
- * A wrapper for strdup(3). It calls exit(EXIT_FAILURE) on errors, i.e. there
- * is no need to check the return value in the caller.
+ * A wrapper for strdup(3). It calls \p exit(EXIT_FAILURE) on errors, i.e.
+ * there is no need to check the return value in the caller.
  *
  * \return A pointer to the duplicated string. If \p s was the NULL pointer,
  * an pointer to an empty string is returned.
@@ -317,13 +318,13 @@ __must_check __malloc char *para_homedir(void)
  * \param argv_ptr  pointer to the list of substrings
  * \param delim delimiter
  *
- * This function modifies \p args by replacing each occurance of \p delim by
- * zero. A NULL-terminated array of pointers to char* is allocated dynamically
+ * This function modifies \a args by replacing each occurance of \a delim by
+ * zero. A \p NULL-terminated array of pointers to char* is allocated dynamically
  * and these pointers are initialized to point to the broken-up substrings
- * within \p args. A pointer to this array is returned via \p argv_ptr. It's OK
- * to call this function with \p args \p == \p NULL.
+ * within \a args. A pointer to this array is returned via \a argv_ptr. It's OK
+ * to call this function with \a args \a == \p NULL.
  *
- * \return The number of substrings found in \p args.
+ * \return The number of substrings found in \a args.
  */
 __must_check unsigned split_args(char *args, char ***argv_ptr, const char *delim)
 {