From 2aff81379522c5864b3aca068360059e75a1e0fd Mon Sep 17 00:00:00 2001 From: cpq Date: Sat, 15 Aug 2026 11:23:15 +0100 Subject: [PATCH] Fix dosctrings --- mongoose.h | 10 +++++----- src/fmt.h | 4 ++-- src/printf.h | 6 +++--- 3 files changed, 10 insertions(+), 10 deletions(-) diff --git a/mongoose.h b/mongoose.h index 01afdbc4..7f29dd4e 100644 --- a/mongoose.h +++ b/mongoose.h @@ -1671,8 +1671,8 @@ typedef size_t (*mg_pm_t)(mg_pfn_t fn, void *arg, va_list *); // - mg_print_base64 - prints a buffer as a base64-encoded string // - mg_print_esc - prints a JSON-escaped string // - mg_print_hex - prints a buffer as a hex string -// - mg_print_ip - prints an IP address in a struct mg_str -// - mg_print_ip_port - prints IP address and port in a struct mg_str +// - mg_print_ip - prints an IP address in a struct mg_addr +// - mg_print_ip_port - prints IP address and port in a struct mg_addr // - mg_print_ip4 - prints an IPv4 address // - mg_print_ip6 - prints an IPv6 address // - mg_print_mac - prints a MAC address @@ -1730,15 +1730,15 @@ char *mg_mprintf(const char *fmt, ...); size_t mg_queue_printf(struct mg_queue *, const char *fmt, ...); // Built-in %M/%m printer functions. Each reads its argument(s) from ap. -size_t mg_print_base64(mg_pfn_t, void *arg, va_list *ap); // expects: const void *buf, size_t len +size_t mg_print_base64(mg_pfn_t, void *arg, va_list *ap); // expects: int len, uint8_t *buf size_t mg_print_esc(mg_pfn_t, void *arg, va_list *ap); // expects: int len, const char *str -- use MG_ESC() -size_t mg_print_hex(mg_pfn_t, void *arg, va_list *ap); // expects: const void *buf, size_t len +size_t mg_print_hex(mg_pfn_t, void *arg, va_list *ap); // expects: int len, uint8_t *buf size_t mg_print_ip(mg_pfn_t, void *arg, va_list *ap); // expects: const struct mg_addr * size_t mg_print_ip_port(mg_pfn_t, void *arg, va_list *ap); // expects: const struct mg_addr * size_t mg_print_ip4(mg_pfn_t, void *arg, va_list *ap); // expects: uint32_t *ipv4 size_t mg_print_ip6(mg_pfn_t, void *arg, va_list *ap); // expects: uint8_t[16] ipv6 size_t mg_print_mac(mg_pfn_t, void *arg, va_list *ap); // expects: uint8_t[6] mac -size_t mg_print_ieee64(mg_pfn_t, void *arg, va_list *ap); // expects: uint64_t +size_t mg_print_ieee64(mg_pfn_t, void *arg, va_list *ap); // expects: uint8_t[8] ieee64 size_t mg_print_l2addr(mg_pfn_t, void *arg, va_list *ap); // expects: uint8_t l2, uint8_t[n] n-byte l2-dependent address size_t mg_print_html_esc(mg_pfn_t, void *arg, va_list *ap); // expects: int len, const char *str -- use MG_ESC() diff --git a/src/fmt.h b/src/fmt.h index 31d6a3f4..5fbb4dee 100644 --- a/src/fmt.h +++ b/src/fmt.h @@ -34,8 +34,8 @@ typedef size_t (*mg_pm_t)(mg_pfn_t fn, void *arg, va_list *); // - mg_print_base64 - prints a buffer as a base64-encoded string // - mg_print_esc - prints a JSON-escaped string // - mg_print_hex - prints a buffer as a hex string -// - mg_print_ip - prints an IP address in a struct mg_str -// - mg_print_ip_port - prints IP address and port in a struct mg_str +// - mg_print_ip - prints an IP address in a struct mg_addr +// - mg_print_ip_port - prints IP address and port in a struct mg_addr // - mg_print_ip4 - prints an IPv4 address // - mg_print_ip6 - prints an IPv6 address // - mg_print_mac - prints a MAC address diff --git a/src/printf.h b/src/printf.h index b6dade93..dba644b7 100644 --- a/src/printf.h +++ b/src/printf.h @@ -34,15 +34,15 @@ char *mg_mprintf(const char *fmt, ...); size_t mg_queue_printf(struct mg_queue *, const char *fmt, ...); // Built-in %M/%m printer functions. Each reads its argument(s) from ap. -size_t mg_print_base64(mg_pfn_t, void *arg, va_list *ap); // expects: const void *buf, size_t len +size_t mg_print_base64(mg_pfn_t, void *arg, va_list *ap); // expects: int len, uint8_t *buf size_t mg_print_esc(mg_pfn_t, void *arg, va_list *ap); // expects: int len, const char *str -- use MG_ESC() -size_t mg_print_hex(mg_pfn_t, void *arg, va_list *ap); // expects: const void *buf, size_t len +size_t mg_print_hex(mg_pfn_t, void *arg, va_list *ap); // expects: int len, uint8_t *buf size_t mg_print_ip(mg_pfn_t, void *arg, va_list *ap); // expects: const struct mg_addr * size_t mg_print_ip_port(mg_pfn_t, void *arg, va_list *ap); // expects: const struct mg_addr * size_t mg_print_ip4(mg_pfn_t, void *arg, va_list *ap); // expects: uint32_t *ipv4 size_t mg_print_ip6(mg_pfn_t, void *arg, va_list *ap); // expects: uint8_t[16] ipv6 size_t mg_print_mac(mg_pfn_t, void *arg, va_list *ap); // expects: uint8_t[6] mac -size_t mg_print_ieee64(mg_pfn_t, void *arg, va_list *ap); // expects: uint64_t +size_t mg_print_ieee64(mg_pfn_t, void *arg, va_list *ap); // expects: uint8_t[8] ieee64 size_t mg_print_l2addr(mg_pfn_t, void *arg, va_list *ap); // expects: uint8_t l2, uint8_t[n] n-byte l2-dependent address size_t mg_print_html_esc(mg_pfn_t, void *arg, va_list *ap); // expects: int len, const char *str -- use MG_ESC()