net.c: Make host_and_port() static.

[paraslash.git] / string.h

diff --git a/string.h b/string.h
index 16f461081598c782879a53ffd7be235090601ebb..eb29b919c429da0a9ddb7024b785362bf9ba6623 100644 (file)
--- a/string.h
+++ b/string.h
@@ -6,9 +6,13 @@
 
 /** \file string.h exported sybmols from string.c */
 
+/** A string buffer used for para_printf(). */
 struct para_buffer {
+       /** The buffer. May be \p NULL. */
        char *buf;
+       /** The size of \a buf. */
        size_t size;
+       /** The next para_printf() will write at this offset. */
        size_t offset;
 };
 
@@ -29,10 +33,11 @@ __must_check unsigned split_args(char *args, char *** const argv_ptr, const char
 __malloc char *para_hostname(void);
 void valid_fd_012(void);
 __printf_2_3 int para_printf(struct para_buffer *b, const char *fmt, ...);
+/** Used for for_each_line() and for_each_line_ro(). */
 typedef int line_handler_t(char *, void *);
 int for_each_line(char *buf, size_t size, line_handler_t *line_handler,
        void *private_data);
-int for_each_line_ro(char *buf, size_t size, line_handler_t line_handler,
+int for_each_line_ro(char *buf, size_t size, line_handler_t *line_handler,
        void *private_data);
 int para_atoi64(const char *str, int64_t *result);
 int para_atoi32(const char *str, int32_t *value);