Comments: clarify remaining return statements

datastruct/elasticarray.c

@@ -272,6 +272,7 @@ void *
 elasticarray_get(struct elasticarray * EA, size_t pos, size_t reclen)
 {
 
+	/* Calculate the pointer address. */
 	return ((uint8_t *)(EA->buf) + pos * reclen);
 }
 

datastruct/timerqueue.c

@@ -47,6 +47,7 @@ compar(void * cookie, const void * x, const void * y)
 
 	(void)cookie; /* UNUSED */
 
+	/* Compare the times. */
 	return (tvcmp(&_x->tv, &_y->tv));
 }
 

http/http.c

@@ -244,6 +244,7 @@ http_request(struct sock_addr * const * addrs, struct http_request * request,
     void * cookie)
 {
 
+	/* Call the real function (without SSL). */
 	return (http_request2(addrs, request, maxrlen, callback, cookie, NULL));
 }
 

netbuf/netbuf_read.c

@@ -50,6 +50,7 @@ struct netbuf_read *
 netbuf_read_init(int s)
 {
 
+	/* Call the real function (without SSL). */
 	return (netbuf_read_init2(s, NULL));
 }
 

netbuf/netbuf_write.c

@@ -160,6 +160,7 @@ struct netbuf_write *
 netbuf_write_init(int s, int (* fail_callback)(void *), void * fail_cookie)
 {
 
+	/* Call the real function (without SSL). */
 	return (netbuf_write_init2(s, NULL, fail_callback, fail_cookie));
 }
 

network_ssl/network_ssl_compat.c

@@ -70,6 +70,8 @@ network_ssl_compat_set1_host(SSL * ssl, const char * hostname)
 	X509_VERIFY_PARAM * param;
 
 	param = SSL_get0_param(ssl);
+
+	/* Use older OpenSSL function. */
 	return (X509_VERIFY_PARAM_set1_host(param, hostname, strlen(hostname)));
 }
 #endif

util/align_ptr.h

@@ -44,6 +44,8 @@ align_ptr(uint8_t * arr, size_t alignment)
 	 */
 	offset = (uintptr_t)(&arr[0]) % alignment;
 	offset = (alignment - offset) % alignment;
+
+	/* Return the aligned pointer. */
 	return ((void *)&arr[offset]);
 }
 

util/json.c

@@ -85,6 +85,8 @@ skip_number(const uint8_t * buf, const uint8_t * end)
 			break;
 		buf++;
 	}
+
+	/* Return our current position. */
 	return (buf);
 }